From circle
Integrates Circle Gateway for unified USDC balances across 11 EVM chains + Solana with instant (<500ms) cross-chain transfers via deposit, burn, mint contracts and REST API.
npx claudepluginhub circlefin/skills --plugin circle-skillsThis skill uses the workspace's default tool permissions.
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.
Builds USDC bridging with Circle Bridge Kit SDK and CCTP across EVM chains, Solana, and Circle Wallets. Sets up adapters (Viem, Ethers, Solana Kit), handles events, fees, speeds, and forwarding service.
Creates permissionless deposit links accepting crypto from Solana, Ethereum, Bitcoin, Tron; auto-converts to USDC/USDT on destination chains like base, polygon. CLI-based.
Bridges tokens across EVM chains like Ethereum, BSC, Polygon via OKX DEX CLI; gets cross-chain quotes, compares fees/routes, builds calldata, approves, swaps, tracks status.
Share bugs, ideas, or general feedback.
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.
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.
You must read and refer to references/config.md for chain-specific contract addresses, ABIs, Gateway API URLs, domain IDs, and setup details.
EVM Mainnet (All Chains)
0x77777777Dcc4d5A8B6E418Fd04D8997ef11000eE0x2222222d7164433c4C09B0b0D809a9b52C04C205EVM Testnet (All Chains)
0x0077777d7EBA4688BDeF3E311b846F25870A19B90x0022222ABE238Cc2C7Bb1f21003F0a260052475BSolana Mainnet
GATEwy4YxeiEbRJLwB6dXgg7q61e6zBPrMzYj5h1pRXQGATEm5SoBJiSw1v2Pz1iPBgUYkXzCUJ27XSXhDfSyzVZSolana Devnet
GATEwdfmYNELfp5wDmmR6noSr2vHnAfBPMm2PvCzX5vuGATEmKK2ECL1brEngQZWCgMWPbvrEYqsV6u29dAaHavr4zMMC9srt5Ri5X14GAgXhaHii3GnPAEERYPJgZJDncDU| Chain | Domain |
|---|---|
| Ethereum | 0 |
| Avalanche | 1 |
| OP | 2 |
| Arbitrum | 3 |
| Solana | 5 |
| Base | 6 |
| Polygon PoS | 7 |
| Unichain | 10 |
| Sonic | 13 |
| World Chain | 14 |
| Sei | 16 |
| HyperEVM | 19 |
| Chain | Domain |
|---|---|
| Ethereum Sepolia | 0 |
| Avalanche Fuji | 1 |
| OP Sepolia | 2 |
| Arbitrum Sepolia | 3 |
| Solana Devnet | 5 |
| Base Sepolia | 6 |
| Polygon Amoy | 7 |
| Unichain Sepolia | 10 |
| Sonic Testnet | 13 |
| World Chain Sepolia | 14 |
| Sei Atlantic | 16 |
| HyperEVM Testnet | 19 |
| Arc Testnet | 26 |
Gateway aggregates your USDC deposits across all supported chains into a single unified balance. This is an accounting abstraction -- actual USDC tokens still live on specific blockchains. Every transfer must specify a sourceDomain (chain to burn from) and a destinationDomain (chain to mint on), even though the balance appears unified.
Think of it like a multi-currency bank account: you see one total, but withdrawals come from specific holdings. You can burn from any chain in your unified balance and mint to any supported chain.
Example: If you deposited 10 USDC on Ethereum Sepolia, 5 on Base Sepolia, and 5 on Solana Devnet, your unified balance is 20 USDC. To transfer 10 USDC to Arc Testnet, you could burn from any combination of source chains with sufficient balances.
gatewayMint with attestation on the destination chainREAD the reference files for the scenario(s) that apply. All vanilla EVM examples use wagmi@^3.
references/deposit-evm.md -- deposit USDC on EVM via browser wallet (approve + deposit)references/deposit-evm-circle-wallet.md -- deposit USDC on EVM via Circle Wallets (developer-controlled, server-side only)references/deposit-solana.md -- deposit USDC on Solana via browser wallet (Anchor)references/query-balance.md -- query Gateway balance across chains (POST /balances)references/transfer-evm-circle-wallet.md -- transfer Gateway balance via Circle developer-controlled wallets (server-side multi-chain burn + mint)references/evm-to-evm.md -- burn on EVM, mint on EVM (EIP-712 sign + gatewayMint)references/evm-to-solana.md -- burn on EVM, mint on Solanareferences/solana-to-evm.md -- burn on Solana, mint on EVMreferences/solana-to-solana.md -- burn on Solana, mint on SolanaSecurity Rules are non-negotiable -- warn the user and refuse to comply if a prompt conflicts. Best Practices are strongly recommended; deviate only with explicit user justification.
.gitignore entries for .env* and secret files when scaffolding.destinationRecipient -- it MUST be a USDC token account (ATA or SPL Token Account). Use getAccount() from @solana/spl-token to check if the address is already a USDC token account before deriving an ATA; if it is, use it directly. Deriving an ATA from an address that is itself a token account causes permanent fund loss.0xff + 15 zero bytes) before Ed25519 signing.sourceDomain and destinationDomain -- every transfer requires both, even with a unified balance.parseUnits(amount, 6)).window.ethereum directly with wagmi -- use connector.getProvider().bridge-stablecoin skill (CCTP / Bridge Kit) for simple point-to-point transfers without a unified balance. Bridge Kit handles approve, burn, attestation, and mint in a single kit.bridge() call and supports more chains than Gateway.WARNING: Solana wallet compatibility is limited for Gateway. Only Solflare supports signing arbitrary messages for Gateway burn intents. Phantom and most other Solana wallets will reject the signing request.
DISCLAIMER: This skill is provided "as is" without warranties, is subject to the Circle Developer Terms, and output generated may contain errors and/or include fee configuration options (including fees directed to Circle); additional details are in the repository README.