Arcade Documentation

1. Overview

Arcade runs on Arc, Circle's EVM L1, where the native gas token is USDC — no ETH round-trip before you can transact. Gas, swaps, liquidity, and launch fees all denominate in USDC. Wallets are standard Ethereum (secp256k1); chainId is 5042002.

What you can do:

• Swap across every DEX on Arc through one aggregated quote, often in a single signature.
• Bridge USDC in/out via Circle CCTP (EVM chains) and Circle App Kit (Solana).
• Provide liquidity in concentrated V3 pools and auto-compound fees gaslessly.
• Place limit orders that live fully on-chain.
• Launch a token via a USDC bonding curve or a locked single-sided pool, and earn fees forever.

2. Swap & route aggregator

The Swap card fans one quote request out to every DEX on Arc in parallel, sorts the results, and auto-picks the best route. You never choose a venue — Arcade compares them for you and shows the top routes with the price gap.

• A provider that has no pool (or reverts) is dropped — one DEX's outage never blocks the others.
• The auto-pick is impact-aware: it probes depth at 1% of your size and prefers the highest-output route with price impact ≤ 30%, not blind max-output.
• Slippage presets 0.1% / 0.5% / 1% (default 0.1%), custom up to 50%. A minimum-received amount is always enforced on-chain.
• Anti-sniper tax on fresh launches is read into the quote, so the number you see is what the router actually executes (a banner shows the active tax %).
• Partial fill: if your amount would exhaust a pool's active liquidity, Arcade quotes the largest swappable amount instead of failing, and tells you the difference.

3. One-signature swaps

On Arc, Arcade folds the ERC-20 approve and the swap into a single signature using Arc's native batch primitive (Multicall3From), which preserves your wallet as the sender via the callFrom precompile. The first swap of a new token = one popup instead of two; later swaps of that token go direct.

Applies to Arcade's own routes (V2 / V3 / migrated). Permit2 routes (Synthra) already settle in one transaction with an off-chain signature, so they don't need it.

4. Multi-token swap

The Multi Token Swap tab consolidates up to 5 input tokens into one output token in a single transaction — handy for sweeping dust or several positions into USDC. Every needed approval plus the swap settle in one signature via the same batch primitive.

Each leg is routed individually; a token with no liquidity pool on Arc can't be routed and the swap will revert — pick tokens that have a pool.

5. Limit orders

The Limit tab places a fully on-chain order through the Orbs TWAP/dLIMIT contracts — no backend, no off-chain order book. Pick a pair, an amount, and a trigger price; the order sits on-chain until it fills or you cancel. 0% Arcade fees, no hidden spread, cancel anytime. Expiry presets 1 day / 1 week (default) / 1 month, hard cap 90 days.

6. Bridge (CCTP + Solana)

EVM ⇄ Arc — Circle CCTP V2

Native USDC is burned on the source chain and minted on the destination — no wrapped tokens. The flow is Send → Attestation → Claim: you sign the burn, Arcade polls Circle's attestation service, then you sign the mint on the destination. Supported source chains:

• Standard transfer is free (waits for full finality). Fast Transfer settles in ~10-30s with a tiny Circle fee; minimum 0.5 USDC.
• Fee preview: 0.05% Arcade + up to 0.01% Circle on Fast only. (The Arcade fee is preview-only on testnet — not charged on-chain yet.)
• Bridge to a different recipient address, resume an interrupted bridge after refresh, and retry failed ones from history.

Solana ⇄ Arc — Circle App Kit

Select Solana Devnet in the chain picker (it forces Arc on the other side) to bridge USDC to/from Solana via Circle's App Kit, using a Phantom wallet for the Solana side. The audited EVM/CCTP path is untouched.

7. Liquidity & positions

Provide concentrated (Uniswap V3) liquidity from /positions, which lists both wallet-owned and auto-managed positions in one grid with live in/out-of-range status and unclaimed fees.

• Add with two tokens, or use the Single-Asset Zap (deposit one token, Arcade swaps half and mints a max-range position). Range presets Max / Passive / Wide / Narrow / Aggressive.
• Remove (decrease → collect → burn) in one flow.
• Claim all fees: select several positions and collect them in a single signature (batched via Multicall3From).

APR / 24h volume / TVL show "—" until the indexer ships (Mainnet); fees themselves are computed exactly on-chain.

8. Auto-compounder

Deposit a V3 LP position into the Auto-Compounder and a keeper maintains it for you — you never pay gas after the deposit. Two active modes:

• A scheduled keeper runs every 5 minutes (off-chain operator pays the gas) and acts once a position clears its fee threshold + 5-min cooldown.
• The keeper bundles all due positions into one transaction (Multicall3 batching) — one base fee instead of N.
• Protocol fee on collected fees: 1% (hard-capped on-chain at 5%). Your position card shows a live Total earned (lifetime claimed + currently pending).
• Change mode or withdraw your NFT anytime — both are user-signed and take effect on the next keeper tick.

The same gasless-keeper model powers Twitter escrow auto-claim (see §10): the operator delivers your USDC + tokens without you paying claim gas, also batched.

9. Launchpad & fees

Anyone can issue a token. Three launch flavors live under one launchpad contract:

Clanker pool types

Chosen at launch — sets starting market cap and how supply is split across V3 ranges.

Trading, migration & anti-sniper

• Curve → AMM: Pump/Arcade trades route through the launchpad while on the curve. At 20,000 USDC raised the contract takes a 2,500 USDC migration fee, seeds a fresh V2 pair with the rest (17,500 USDC + 200M tokens), and burns the LP to the dead address.
• Clanker: trades go through the V3 router against the locked position; fees accrue forever and are claimable by anyone calling collectFees, distributed per the creator's recipient bps.
• Anti-sniper tax: a Clanker creator can set a starting tax (max 50%) that decays linearly to 0. It's skimmed at the router on buys during the window and sent to the treasury. The creator's own opening buy is not taxed.
• Team vault: carve up to 90% of supply into a vault with a lockup + linear vesting; vaulted supply is excluded from the LP.

Creator earnings

Clanker creators see and claim their LP-fee share from /my-tokens (all-time claimed + pending) and per token. Claiming calls collectFees on the locker — user-signed. Fee split is 80% creator / 20% platform on Clanker V3 (and on the migrated V2 slot); Pump curve fees are 0.5%/0.5% with LP burned at migration.

10. Twitter attribution & gasless claims

A Clanker fee slot can be attributed to a Twitter @handleinstead of an address — perfect for launching on behalf of a creator who isn't on Arcade yet. Fees for that slot accumulate in an escrow contract until the handle owner claims them.

1. At launch, toggle Twitter on a recipient row and type the @handle; the slot pays into ArcadeTwitterEscrow.
2. The handle owner lands on the token page, connects any wallet (no gas needed), and clicks Claim → Twitter OAuth verifies they own the handle.
3. The backend signs an EIP-712 authorization (30-min deadline). After a 1-hour veto timelock, the claim sweeps the full balance and redirects future fees to their wallet.
4. Gasless delivery: once authorized, a keeper fires the claim for them — they never pay claim gas. The escrow can only ever pay the registered recipient.

11. Creator identity

Creators can mint a portable ERC-8004 reputation NFT on Arc's native identity registry, gated by how many of their launches have graduated (crossed the bonding curve into a real pool):

• Only curve-graduated (Pump/Arcade) and V4-hook graduations count — CLANKER_V3 launches are excluded (they skip the curve and pay only the 3 USDC creation fee, so they can't farm a free tier).
• Metadata is written on-chain at mint. When you climb a tier, a burn + re-mint refresh updates the badge.
• Other Arc dapps can read the NFT to gate leaderboards / VIP features.

12. Arc primitives

• USDC is gas. It's the native token (6-dec for transfers/display) so every action — gas, swaps, launch fees — is in USDC. 0x3600…0000.
• One-signature batching. Arc's Multicall3From bundles calls into one tx while keeping your wallet as the sender — what powers single-signature swaps, claim-all-fees, and managed position removal.
• Keeper batching. The gasless keepers bundle many positions/claims into one Multicall3 transaction, so cost barely grows with scale.
• Standard Multicall3, Permit2, and a canonical RPC stack (dedicated provider → public Arc RPC → thirdweb fallback) are all wired.

13. Contracts & security

Live Arc-testnet addresses are in /deployments.json. Core contracts:

Trust model

• Locker principal is unwithdrawable — only fee collection is possible. Recipient bps are immutable post-launch.
• Curve migration burns LP to the dead address; the migration fee + an anti-donation skim block initial-price warping.
• Keepers are convenience, not custody: they can only call permissionless functions (compound, claim-after-authorize). Your funds always go to you.
• The Twitter escrow uses a single backend signer today; mainnet migrates it to a multisig + a 1-hour veto timelock (already enforced on-chain).

Security

The V2/V3 stack went through multiple internal multi-agent audit passes; HIGH/MEDIUM findings were fixed pre-mainnet, with the remainder scoped to the multisig migration and V4 rollout. An external audit and the multisig migration are scheduled before mainnet. Past on-chain history (Arc explorer) and the immutable contracts are the source of truth.

14. FAQ

Why is USDC the gas token?

Arc is Circle's EVM L1, built so the only asset you need is USDC. Gas, swaps, and launch fees all denominate in USDC — no ETH bridging first.

Why was my swap one signature instead of two?

Arc's batch primitive lets Arcade fold the token approval and the swap into a single transaction. The first swap of a token batches; later ones go direct.

My limit order isn't filling.

On testnet no keeper bot runs, so on-chain orders sit Open until expiry. Filling ships with mainnet.

Do I pay gas for auto-compounding or a Twitter claim?

No — those are keeper-driven. An off-chain operator pays the gas; you only sign the initial deposit (compounder) or authorization (Twitter claim).

What's a Clanker?

A launch mode where the full supply is locked in a single-sided V3 position at creation — no curve, tradeable immediately, with 80% of perpetual LP fees routing to the creator's slots forever. The principal can never be withdrawn.

Why does migration trigger at $20k?

The curve uses virtual reserves (5,000 USDC + 1B token) so the math fills exactly at 20,000 USDC raised. 2,500 USDC goes to treasury, the rest seeds a V2 pool, and the LP is burned.

Can I cancel a launch?

No. Once created, the ERC-20 exists forever on-chain. You can stop interacting with it, but it can't be deleted.