Topups

Topups buy AI credit, not an NFT. Each $1 paid grants $1 credit for Chat and API requests.

Amounts

Choose a positive USD amount with up to six decimal places. The smallest amount is $0.000001. There is no product maximum. Shortcuts are $5, $10, $25, $50, and $100. Wallet balances and EVM integer capacity still apply.

The amount field and receipt preview update together. Select an asset to see its quote and use Refresh quote if the price is stale. BNB's preview is a maximum payment; a successful receipt shows the amount actually paid.

Payment assets

• USDT: one 18-decimal BSC USDT is treated as $1. Approve the required amount for the topup contract if your existing allowance is insufficient.
• BNB: the contract converts USD using its current BNB/USD oracle. The UI allows a 1% ceiling for price movement; unused BNB is refunded in the same transaction.

Gas is paid separately in BNB. Payments go directly to treasury. A failed transfer, failed refund, or invalid quote reverts the payment.

An insufficient nonzero USDT allowance is reset to zero before an exact approval. These approval transactions can cost gas and do not add credit. The payment transaction follows approval.

The treasury wallet cannot top up with USDT because a transfer to itself does not increase its token balance. Choose BNB or use a different wallet with an Agent ID. The app checks this before requesting USDT approval. InexactTransfer() (0xee20c618) means the treasury did not receive the exact required USDT amount.

Credit arrival

The indexer requires RPC finality and at least 15 blocks after the payment block. It validates the receipt and records credit once per event. The UI distinguishes a submitted payment, an on-chain confirmation, and a database-credited payment.

Only a ToppedUp event from the configured contract authorizes credit. Sending tokens directly to treasury or the contract does not top up your balance.

Recover a pending payment

The app saves the submitted transaction hash in this browser, scoped to your wallet, chain, and payment contract. Return to Top up with the same wallet after a refresh to check that receipt. A timeout means the status is unknown, not that the payment failed.

The Wallet, On-chain, and AI credit stages show progress. Sign in with the paying wallet to let the app match the transaction against credited history. Credit received means the payment is recorded in the application ledger. Make another topup resets the form; Open Chat takes you to the shared credit balance.

If the receipt succeeded but credit is delayed, check the transaction link and Overview. Finality, RPC, indexer, or database delays can postpone settlement. Do not repeat a successful payment merely because credit has not appeared. See FAQ for common failures.

Identity and expiry

A .ai Agent ID is required on each payment and when using AI. New topup credit never expires. Existing credit keeps its original balance and expiry terms.

Topups create no reward weight or airdrop allocation. Historical claims remain at Legacy claims.