Balances and transfers by asset
Gateway tracks a separate balance for each asset. When you deposit EURC, Gateway credits a EURC balance, and a cirBTC deposit credits a cirBTC balance. Gateway never converts between assets. A transfer burns an asset on the source blockchain and mints the same asset on the destination blockchain, so both blockchains must support the asset.Supported blockchains by asset
Each asset is available on a subset of the Gateway blockchains. cirBTC is not available on Solana.
EURC is also issued on Cronos and Stellar, but Gateway is not offered on those
blockchains. For token addresses, see
EURC contract addresses and
cirBTC contract addresses. For the USDC
matrix, see
Gateway supported blockchains.
The Gateway Wallet and Gateway Minter contracts are the same as for USDC. For
their addresses, see
Gateway contract addresses.
Asset selection in API requests
The/v1/balances and /v1/deposits requests select the asset with a token
field. The accepted values are USDC, EURC, and cirBTC. The casing must
match exactly, so the API rejects CIRBTC. When token is omitted, Gateway
uses USDC.
The following example queries a EURC balance on Arc Testnet (domain 26):
/v1/transfer and /v1/estimate requests identify the asset through token
contract addresses instead. Each burn intent carries a sourceToken and a
destinationToken, which hold the address of the asset on the source and
destination blockchains. On Solana, destinationRecipient must be the token
account for the asset you transfer.
Decimals
Each asset uses its own number of decimal places. Amounts, fees, and gas values are all expressed in the asset’s atomic units.Fees
Gateway charges fees and gas in the token you transfer. A cirBTC transfer pays its fees in cirBTC, andmaxFee is in that token’s atomic units.
The /v1/estimate response is the authoritative fee for a transfer. For the fee
model, see
EURC and cirBTC fees.
Forwarding Service
The Forwarding Service supports USDC, EURC, and cirBTC. For details, see Forwarding Service.Nanopayments
Nanopayments extends to EURC and cirBTC on EVM blockchains only. Non-USDC assets require EIP-3009 version 2 authorizations.
For the version 2 signing details, see
EIP-3009 signing. The
/x402/supported endpoint returns the live list of supported assets for each
network.