nexwave-gateway

name	nexwave-gateway
description	Unified crosschain USDC balance via Circle Gateway + Circle Programmable Wallets. Deposit USDC on any supported chain, check your unified balance, and instantly mint USDC on any destination chain in <500ms — no bridging, no raw private keys.
version	1.1.0
tags	["usdc","circle","gateway","crosschain","defi","payments","agent-commerce","circle-wallet","arc"]
author	nexwave
requiredEnv	["CIRCLE_API_KEY","CIRCLE_ENTITY_SECRET","CIRCLE_WALLET_SET_ID"]
dependencies	["eltontay/circle-wallet"]

Nexwave Gateway — Unified Crosschain USDC for OpenClaw Agents

What This Skill Does

Circle Gateway gives you a single unified USDC balance that is instantly accessible on any supported chain in under 500 milliseconds. Instead of holding separate USDC balances on Ethereum, Base, Avalanche, etc., you deposit USDC into Gateway on any chain and can mint it out on any other chain — instantly.

This is fundamentally different from bridging. There are no liquidity pools, no bridge operators, no 15-minute waits. Gateway uses a deposit → sign burn intent → receive attestation → mint flow that executes in <500ms.

Supported Chains (Testnet)

Chain	Domain ID	USDC Address
Ethereum Sepolia	0	0x1c7D4B196Cb0C7B01d743Fbc6116a902379C7238
Base Sepolia	6	0x036CbD53842c5426634e7929541eC2318f3dCF7e
Arc Testnet	26	0x3600000000000000000000000000000000000000

Note: Arc is Circle's purpose-built L1 blockchain where USDC is the native gas token. No separate gas token needed — USDC covers everything. Arc has the fastest Gateway finality at ~0.5 seconds.

Gateway Contracts (same address on all EVM chains):

• Gateway Wallet: 0x0077777d7EBA4688BDeF3E311b846F25870A19B9
• Gateway Minter: 0x0022222ABE238Cc2C7Bb1f21003F0a260052475B

Gateway API (testnet): https://gateway-api-testnet.circle.com/v1

Prerequisites

1. Circle Developer Account with API key and entity secret (https://console.circle.com)
2. The circle-wallet skill installed (clawhub install eltontay/circle-wallet) with a wallet set containing wallets on ETH-SEPOLIA, BASE-SEPOLIA, and ARC-TESTNET
3. Testnet USDC from https://faucet.circle.com (20 USDC per address per chain, every 2 hours)
4. Testnet ETH for gas on Sepolia/Base Sepolia (use Google's Sepolia faucet). On Arc, USDC is the native gas token — same faucet covers everything.
5. Node.js installed with the viem, dotenv, and @circle-fin/developer-controlled-wallets packages

How To Use This Skill

Step 1: Setup the Project

Run the setup script to initialize the project with all dependencies:

cd /path/to/nexwave-gateway && bash setup.sh

This creates a gateway-app/ directory with all necessary files pre-configured.

Step 2: Check Gateway Info and Your Balance

cd gateway-app && node check-balance.js

This queries the Gateway API for supported chains and shows your unified USDC balance across all chains.

Step 3: Deposit USDC into Gateway

node deposit.js

This deposits USDC into the Gateway Wallet contract on Ethereum Sepolia and Arc Testnet. After deposit and chain finality, your unified balance is credited. Arc finalizes in ~0.5 seconds; Ethereum may take up to 20 minutes.

Step 4: Transfer USDC Crosschain Instantly

node transfer.js

This creates burn intents, signs them via Circle Programmable Wallets (MPC — no raw private keys), submits them to the Gateway API for attestation, and mints USDC on Base Sepolia. The attestation response typically arrives in <500ms.

Key Concepts

Unified Balance: After depositing USDC into Gateway on any chain, the Gateway system credits your address with a unified balance. This balance is not locked to any specific chain — it can be accessed on any supported chain.

Burn Intent: To withdraw from your unified balance to a specific chain, you sign a "burn intent" — an EIP-712 typed data structure specifying the source chain, destination chain, amount, and recipient. Signing is done securely via Circle's MPC Programmable Wallets (no raw private keys). Gateway verifies your balance is sufficient and returns a signed attestation.

Circle Programmable Wallets: Instead of raw private keys in .env files, this skill uses Circle's developer-controlled wallets backed by multi-party computation (MPC). The private key is never exposed — signing happens server-side via Circle's API. This makes the skill safe for agent use without risk of key exfiltration.

Attestation: The Gateway API's signed proof that authorizes minting on the destination chain. You submit this attestation to the Gateway Minter contract on the destination chain to receive USDC.

Fees: 0.5 basis points (0.005%) during the early access period (through June 30, 2026). Plus base gas fees for on-chain transactions.

Flow Diagram

Agent deposits USDC on Chain A
        │
        ▼
Gateway Wallet Contract (approve + deposit)
        │
        ▼
Wait for chain finality → Unified balance credited
        │
        ▼
Agent signs burn intent (EIP-712 via Circle MPC Wallets)
        │
        ▼
Submit to Gateway API ──► Attestation returned (<500ms)
        │
        ▼
Submit attestation to Gateway Minter on Chain B
        │
        ▼
USDC minted on Chain B for recipient

Agent Use Cases

• Multi-chain arbitrage: Access USDC on any chain instantly to capture price differences
• Cross-chain payments: Pay for services on any chain from a single balance
• Treasury management: Consolidate USDC from multiple chains into one balance
• Agent-to-agent commerce: Accept payment on one chain, spend on another without delays
• Capital efficiency: No need to pre-position USDC across chains

Troubleshooting

• "Insufficient balance": Wait for chain finality after depositing. Ethereum takes ~20 min, Arc is ~0.5 seconds.
• "Gateway deposit not yet picked up": The Gateway API waits for block confirmations. Be patient on Ethereum.
• Gas errors: On Ethereum/Base you need testnet ETH for gas. On Arc, USDC is the gas token — same faucet covers everything.
• Faucet limits: You can get 20 USDC per address per chain every 2 hours from faucet.circle.com.

References

• Circle Gateway Docs: https://developers.circle.com/gateway
• Circle Programmable Wallets: https://developers.circle.com/wallets
• Circle Wallet Skill (ClawHub): https://clawhub.ai/eltontay/circle-wallet
• Arc Testnet Docs: https://docs.arc.network
• Gateway Quickstart: https://developers.circle.com/gateway/quickstarts/unified-balance-evm
• Full Quickstart Code: https://github.com/circlefin/evm-gateway-contracts/tree/master/quickstart
• Circle Faucet: https://faucet.circle.com
• Gateway API Reference: https://gateway-api-testnet.circle.com/v1/info