SynapseDocumentation
Money Flows

Deposit USDC

Fund Synapse with USDC so bounded agent credentials can spend through Gateway.

Deposits are owner-controlled. The owner wallet moves USDC into SynapseCore, Gateway indexes the chain event, and the resulting balance becomes available for controlled agent spending.

Flow

  1. Owner wallet passes the app preflight: wallet USDC, native gas, network, and vault address are visible before any wallet prompt.
  2. Owner signs an exact-amount permit. This signature is gasless and does not move funds by itself.
  3. Owner submits the vault deposit transaction. This is on-chain and requires native gas.
  4. Gateway creates or finds the deposit intent and places funds in pending / syncing balance.
  5. Gateway indexes the deposit event and reconciles it against the intent.
  6. Confirmed funds move from pending / syncing into spendable credits.
  7. Agent credentials spend against spendable credits through discovery and invocation.

wallet preflight -> permit signature -> vault transaction -> pending balance -> spendable credits -> paid invocation

Balance buckets

  • Spendable credits: confirmed Gateway balance available to agent credentials.
  • Pending / syncing credits: submitted or indexed deposit amount waiting for Gateway confirmation.
  • Frozen / review credits: funds reserved by an active withdrawal, failed settlement review, or manual risk process.

Deposit UI and Billing history must keep those buckets separate. Completed means Gateway credited spendable balance, not only that the transaction appeared on-chain.

Agent boundary

Agents should never receive owner wallet credentials. They receive limited runtime credentials that can spend within policy, not sign chain transactions or withdraw funds.

On this page