Skip to content
locallocal
Documentation menu

Funding

Balances are funded with USDC on Solana. Your balance is denominated in USD and lives in our ledger.

How a deposit works

  1. Create a deposit intent for an amount. The intent carries the USDC mint, our treasury token account, a unique Solana Pay reference key and an expiry.
  2. Your wallet signs a USDC transfer to the treasury account with the reference attached.
  3. We verify the transaction on-chain: success, correct network and mint, the treasury account credited, the reference present, and the required finality. The deposit is then recorded and credited in one database transaction.

The funding page drives this for you and shows each state: Prepare → Await signature → Submitted → Confirming → Credited. A detected transfer is not spendable until it is credited.

Network

Each deployment runs on exactly one Solana network (devnet or mainnet-beta) with the official USDC mint for that network. The funding page shows a network badge. Transfers on another network or with another token are ignored — they cannot be credited.

Send only USDC on the shown network

Sending another token, or sending to the treasury without going through an intent, can leave funds unattributed. If that happens, contact support with the signature; unattributed deposits are reviewed by an operator.

Limits and timing

  • Minimum and maximum deposit amounts are configured per deployment and shown on the funding page.
  • An intent expires after a fixed window. Create a new one if it expires before you sign.
  • Deposits become spendable at the configured finality (typically “finalized”, usually under a minute).

API

Keys with deposits:manage can drive funding programmatically:

text
POST /v1/deposits/intents            { "amount_usd": "25" }           → DepositIntentRecord
GET  /v1/deposits/intents/{id}                                      → DepositIntentRecord (status: pending | detected | confirming | credited | expired | underpaid | overpaid | failed)
POST /v1/deposits/verify             { "signature": "<tx signature>" } → DepositIntentRecord

DepositIntentRecord.solana_pay_url is a solana: URL for wallets that support Solana Pay.