nexwave-gateway

# 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...

# nexwave-gateway 🌐

**Unified Crosschain USDC for OpenClaw Agents — Powered by Circle Gateway**

> The only OpenClaw skill that gives agents a single USDC balance accessible on any chain in <500ms. No bridging. No liquidity pools. No waiting.

## What It Does

`nexwave-gateway` enables OpenClaw agents to use [Circle Gateway](https://www.circle.com/gateway) for instant crosschain USDC operations. Instead of managing separate USDC balances on Ethereum, Base, Avalanche, etc., your agent deposits USDC into Gateway on any chain and can instantly access it on any other supported chain.

### The Flow

```
1. Deposit USDC on Chain A → Gateway credits unified balance
2. Sign burn intent → Gateway returns attestation (<500ms)
3. Submit attestation on Chain B → USDC minted for you
```

### Why This Matters for Agents

- **Capital efficiency**: No pre-positioning USDC across chains
- **Speed**: <500ms crosschain transfers vs. 15-20 minute bridge waits
- **Simplicity**: One balance, accessible everywhere
- **Non-custodial**: Funds only move with your signature

## Quick Start

### 1. Install

```bash
clawhub install nexwave-gateway
# or manually:
git clone <repo-url> ~/.openclaw/skills/nexwave-gateway
```

### 2. Configure

Install the Circle Wallet skill and set your credentials:

```bash
clawhub install eltontay/circle-wallet

# Set Circle Wallet credentials (from https://console.circle.com)
export CIRCLE_API_KEY=your_api_key
export CIRCLE_ENTITY_SECRET=your_entity_secret
export CIRCLE_WALLET_SET_ID=your_wallet_set_id
```

No raw private keys needed — uses Circle's MPC-secured developer-controlled wallets.

### 3. Setup & Run

```bash
cd ~/.openclaw/skills/nexwave-gateway
bash setup.sh
cd gateway-app
node check-balance.js   # See your unified balance
node deposit.js         # Deposit USDC into Gateway
node transfer.js        # Transfer crosschain to Base
```

### 4. Get Testnet USDC

Visit [faucet.circle.com](https://faucet.circle.com) — 20 USDC per address per chain, every...