use-gateway

Integrate Circle Gateway for unified crosschain USDC balances and instant transfers.

1|Updated Jul 20, 2026
One-click install
npx skills add https://github.com/Lightupwrld/Cycuxio --skill use-gateway-lightupwrld
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: use-gateway
Source: https://github.com/Lightupwrld/Cycuxio/tree/main/.agents/skills/use-gateway
Command: npx skills add https://github.com/Lightupwrld/Cycuxio --skill use-gateway-lightupwrld

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires viem, @circle-fin/developer-controlled-wallets, @coral-xyz/anchor, @solana/web3.js, @solana/spl-token, @solana/buffer-layout, bs58, bn.js, and includes references (resource) components.

What problem does it solve? Moving USDC between blockchains normally requires waiting for source-chain finality and managing separate balances per chain. This Skill guides you through Circle Gateway integration so users hold one unified USDC balance across 11 EVM chains plus Solana and Arc, and transfer funds in under 500 milliseconds via deposit, burn intent, attestation, and mint workflows. ## Core Features & Use Cases - Unified Balance Deposits: Deposit USDC into Gateway Wallet contracts on EVM (viem, browser wallets, or Circle Developer-Controlled Wallets) and Solana (Anchor) to build a chain-agnostic balance. - Instant Crosschain Transfers: Sign EIP-712 burn intents on EVM or prefixed Ed25519 payloads on Solana, submit them to the Gateway REST API, and mint on the destination chain with gatewayMint. - Balance Queries: Query unified balances across chains via the Gateway /balances endpoint. - Use Case: A payments app pools user USDC deposited on Ethereum and Base, then lets users spend instantly on Arc Testnet without bridging delays or per-chain balance management. ## Quick Start Ask the assistant to transfer 5 USDC from your Arc Testnet Gateway balance to Base Sepolia using the use-gateway skill.

Frequently Asked Questions about use-gateway

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I transfer USDC across chains with Circle Gateway?

Deposit USDC into the Gateway Wallet contract on any supported chain, then create and sign a burn intent specifying source and destination domains. Submit it to the Gateway /transfer API to receive an attestation, then call gatewayMint on the destination chain to receive the funds.

How do I deposit USDC into a Gateway unified balance?

Approve the Gateway Wallet contract to spend your USDC, then call its deposit(address,uint256) method. Never send USDC via a plain ERC-20 transfer, as those funds will not be credited to your unified balance.

Which blockchains does Circle Gateway support?

Gateway supports 11 EVM chains including Ethereum, Arbitrum, Base, and Polygon, plus Solana, on both mainnet and testnet, and additionally Arc testnet. Each chain is identified by a numeric domain ID used in burn intents.

Can I use Phantom wallet to sign Solana Gateway burn intents?

No. Only Solflare currently supports signing the arbitrary messages required for Solana Gateway burn intents. Phantom and most other Solana wallets reject the signing request.

When should I use CCTP instead of Circle Gateway?

Use CCTP or Bridge Kit for simple point-to-point transfers without a unified balance, especially infrequent or ad-hoc transfers. Gateway is better when you need instant sub-500ms transfers, pooled capital across chains, or a consolidated balance model.

Why must Solana recipients be token accounts in Gateway transfers?

The destinationRecipient on Solana must be a USDC token account (ATA or SPL token account), not a raw wallet address. Deriving an ATA from an address that is itself a token account causes permanent fund loss, so verify with getAccount() first.