Get started

How it works

Three ideas carry the whole system: an allowance the assistant can't exceed, receipts for everything it does, and settlement that ties the rollup back to Solana.

Allowances

Each assistant gets its own USDC vault on Solana, held by the neuron_allowance program. The assistant signs with a session key that can only move money through the program, and only inside the owner's rules:

The owner setsEnforced on chain as
"Spend up to $20 a week"A period limit; the period resets on the same weekday, even after idle weeks
"Ask me before anything over $10"An ask-first threshold; bigger payments become spend requests
"Only buy from these stores"An allowlist of payee wallets
The Pause buttonBlocks every assistant action until unpaused

Ask-first requests

A payment outside the rules isn't refused outright. It becomes a spend request the owner reviews ("Found a $274 flight. Book it?"):

  1. The assistant calls request_spend. It records the destination, the wallet that owns it, the amount and a memo.
  2. The owner approves or cancels. On approval the program pays the exact destination requested, and only if it still belongs to the same wallet and the assistant's key hasn't been replaced since.
  3. Approved payments don't use up the weekly allowance: the allowance is what the assistant may spend without asking.

At most 16 requests can be open at once, so a looping assistant can't bury the owner in them.

Receipts

Every model call, tool call and payment becomes a receipt: a small JSON record with the provider and model, the tool, the amounts and the timing, plus commitments to the content.

The verified checkmark

When an assistant pays for a tool, the payment's on-chain memo is the hash of its payment receipt. A feed line like "Paid search tool, $0.02 ✓" is verified by:

  1. reading the Spent event from the payment transaction,
  2. finding the receipt whose hash equals the memo in the published batch file,
  3. checking its Merkle proof against the root in the receipt log.

Settlement and the rollup

The Neuron rollup runs agent actions fast and cheaply, and adds sol_infer for on-chain inference. Its sequencer posts checkpoints (slot, blockhash, state root) to neuron_settlement on Solana: