🍱 Canteen Builder Bento Box
Everything you need to build, running on Arc testnet.
Powered by the arc-canteen CLI.
§key links·1 install·2 you get·3 try it·4 repos·5 builders
arc-canteen is how you build on
Arc (Circle’s L1 where gas is USDC)
with Canteen: a community of
builders on Arc, building with awesome tooling, infra, and data to make their
visions come true. Install, log in, and you have a wallet funded with $5 USDC, an
RPC endpoint on our node, and the Arc + Circle docs bundled for your coding
agent. We keep an eye on what gets built so we can support great builders and products.
Key links #
.-----. | ^_^ | '--=--'
The gallery of what Canteen builders have shipped on Arc so far. Every project links its repo, so you can fork or extend any of them into your next project or business.
.-----. | o_o | '--=--'
Built something on Arc? Submit your repo here to get it into the showcase for other builders to run with.
.-----. | O_O | '--=--'
The Canteen-run Arc testnet node behind your rpc-url:
network details, keys, and agent context.
Step 1 · Install & set up #
uv tool install arc-canteensource · ARC-cli context repo · context-arc
Then sign in with GitHub — it provisions everything in step 2:
.------------------------------------------.
| 🔴 🟡 🟢 arc-canteen login |
|------------------------------------------|
| $ arc-canteen login |
'------------------------------------------'Step 2 · What you get #
2a: What you get > A wallet on Arc, funded with $5 USDC #
Yours right after login, with $5 of testnet USDC in it. Bring it back
any time with
arc-canteen wallet; look it up on
testnet.arcscan.app:
.--------------------------------------------------------------------------.
| 🔴 🟡 🟢 arc-canteen wallet |
|--------------------------------------------------------------------------|
| $ arc-canteen wallet |
| ╭──────────────────────── Your testnet wallet ─────────────────────────╮ |
| │ Address 0x5AFEd37ee536a65F14167e765aB6318eF17b53c3 │ |
| │ Private key 0x••••••••••••• (yours — shown in your terminal) │ |
| │ Chain testnet — chain ID 5042002 (native gas token is USDC) │ |
| │ Explorer https://testnet.arcscan.app/address/0x5AFE…53c3 │ |
| ╰──────────────────────────────────────────────────────────────────────╯ |
'--------------------------------------------------------------------------'2b: What you get > Access to our testnet RPC #
Your own tokenized endpoint on the Canteen-run Arc node
(details). Print it with
arc-canteen rpc-url, export it as $RPC with
arc-canteen shell-init, or make calls straight from the CLI:
.------------------------------------------.
| 🔴 🟡 🟢 arc-canteen rpc |
|------------------------------------------|
| $ arc-canteen rpc eth_blockNumber |
| 0x316fb99 |
| $ arc-canteen rpc eth_chainId |
| 0x4cef52 # 5042002 |
'------------------------------------------'2c: What you get > Context for your coding agent #
arc-canteen context prints an AGENTS.md plus paths
to the Arc and Circle developer docs and a set of runnable sample codebases
(synced from
the-canteen-dev/context-arc).
Hand it to whatever agent you use. A slice of what’s in there:
.-----------------------------------------------------------------------.
| 🔴 🟡 🟢 arc-canteen context |
|-----------------------------------------------------------------------|
| $ arc-canteen context |
| docs/docs.arc.network/app-kit/unified-balance.md |
| docs/docs.arc.network/app-kit.md |
| docs/docs.arc.network/arc/concepts/deterministic-finality.md |
| docs/docs.arc.network/arc/concepts/opt-in-privacy.md |
| docs/docs.arc.network/arc/concepts/post-quantum-security.md |
| docs/docs.arc.network/arc/concepts/running-a-node.md |
| docs/docs.arc.network/arc/concepts/stable-fee-design.md |
| docs/docs.arc.network/arc/concepts/system-overview.md |
| docs/docs.arc.network/arc/references/connect-to-arc.md |
| docs/docs.arc.network/arc/references/contract-addresses.md |
| docs/docs.arc.network/arc/references/evm-compatibility.md |
| docs/docs.arc.network/arc/references/gas-and-fees.md |
| docs/docs.arc.network/arc/references/sample-applications.md |
| docs/docs.arc.network/arc/tools/account-abstraction.md |
| docs/docs.arc.network/arc/tools/compliance-vendors.md |
| docs/docs.arc.network/arc/tools/data-indexers.md |
| docs/docs.arc.network/arc/tools/node-providers.md |
| docs/docs.arc.network/arc/tools/oracles.md |
| docs/docs.arc.network/arc/tutorials/create-your-first-erc-8183-job.md |
| docs/docs.arc.network/arc/tutorials/deploy-contracts.md |
| docs/docs.arc.network/arc/tutorials/deploy-on-arc.md |
| docs/docs.arc.network/arc/tutorials/interact-with-contracts.md |
| docs/docs.arc.network/arc/tutorials/monitor-contract-events.md |
| docs/docs.arc.network/arc/tutorials/register-your-first-ai-agent.md |
| docs/docs.arc.network/arc/tutorials/run-an-arc-node.md |
| docs/docs.arc.network/arc-chain.md |
| docs/docs.arc.network/build/agentic-economy.md |
| docs/docs.arc.network/build.md |
| docs/docs.arc.network/integrate/connect-to-arc.md |
| docs/docs.arc.network/integrate/deploy-on-arc.md |
| docs/docs.arc.network/integrate.md |
| docs/docs.arc.network/llms.txt |
| samples/arc-commerce/ |
| samples/arc-escrow/ |
| samples/arc-fintech/ |
| samples/arc-multichain-wallet/ |
| samples/arc-nanopayments/ |
| samples/arc-p2p-payments/ |
| samples/arc-prediction-markets/ |
| samples/arc-stablecoin-fx/ |
'-----------------------------------------------------------------------'…and a lot more: the
developers.circle.com mirror
(CCTP, gateway, paymaster, wallets, x402), Circle SKILL.md files
(from circlefin/skills), and
OpenAPI specs. arc-canteen context sync clones the whole bundle
into ~/.arc-canteen/context/; re-run it to pull the latest.
Step 3 · Three things to try right now #
3a: Things to try > Deploy a fun mint contract on Arc #
Feed the context bundle to your agent and let it deploy with your arc-canteen wallet. Here we use pi, our recent favorite coding harness, but Claude Code, Gemini CLI, or Codex work just as well:
.-----------------------------------------------------------------------.
| 🔴 🟡 🟢 first deploy |
|-----------------------------------------------------------------------|
| $ pi "$(arc-canteen context)" "Make a Canteen215-USDC token on Arc. \ |
| Use arc-canteen wallet to deploy." |
'-----------------------------------------------------------------------'3b: Things to try > Play with x402 batched payments #
Run the-canteen-dev/circle-agent
and follow the payment lifecycle walkthrough on http://localhost:3000
(the README
has the details):
.-------------------------------------------------------------.
| 🔴 🟡 🟢 x402 payments |
|-------------------------------------------------------------|
| $ git clone https://github.com/the-canteen-dev/circle-agent |
| $ cd circle-agent |
| $ npm start |
'-------------------------------------------------------------'3c: Things to try > Set up an agent wallet on Arc testnet #
Paste this prompt from agents.circle.com into your agent:
Run curl -sL https://agents.circle.com/skills/setup.md, and use the
returned setup instructions to set up my agent wallet on Arc testnet.Step 4 · Third-party repos doing something cool #
Community codebases from the ticker, each with an entry on the Arc Showcase:
App Kit plugins for Eliza, OpenClaw, and Hermes agents.
Arc OSS starter kit for policy-controlled USDC agent mirroring, receipts, source identity, and decision attestation.
Forkable, MIT-licensed perpetual-futures DEX reference implementation for Arc testnet — Solidity contracts on-chain, Rust keeper/SDK/indexer/matcher off-chain.
Chess against a rule-based AI for a private USDC wager on Arc testnet — dynamic purse plus Unlink shielding. Live at chess-unlink.thecanteenapp.com.
Step 5 · What other builders have made #
Posts from Canteen builders that did numbers on X. A random slice on every refresh (or ).