use-gateway

Overview

Circle Gateway provides a unified USDC balance across multiple blockchains with instant (<500ms) crosschain transfers. Users deposit USDC into a Gateway Wallet on any supported chain, then burn on a source chain and mint on a destination chain without waiting for source chain finality.

Prerequisites / Setup

Gateway is a contract-level integration -- there is no SDK to install. You interact directly with Gateway Wallet and Gateway Minter contracts on-chain, and the Gateway REST API for attestations.

Chain Configuration

Do not load a separate config file by default. Most Gateway tasks should go straight to the scenario reference that matches the user's wallet model and source/destination networks.

Use the scenario reference first and only do additional verification when you need to confirm:

• Gateway REST base URL
  • testnet: https://gateway-api-testnet.circle.com/v1/
  • mainnet: https://gateway-api.circle.com/v1/
• chain-specific USDC addresses: https://developers.circle.com/stablecoins/usdc-contract-addresses.md
• Circle Wallet blockchain identifiers: https://developers.circle.com/wallets/supported-blockchains.md