Discovery
Map the actor, payment surface, docs source, and human approval boundary before code.
- Arc MCP context
- Use-case thesis
- Source citations
- Non-goals
The complete toolkit for agentic commerce on Arc. Turn docs into reviewable agent plans, USDC payment flows, x402 boundaries, and local-first playgrounds — all with human approval at every step.
Four steps with explicit inputs, outputs, review checkpoints, and safety boundaries. Built for proof-of-work, not speculative spending.
Map the actor, payment surface, docs source, and human approval boundary before code.
Turn requirements into schemas, runtime constraints, and wallet-safe contracts.
Use local demos and prompts to produce reviewable outputs without side effects.
Check safety contracts, status helpers, and public documentation before next PR.
Static homepage links into local-only playgrounds. No LLM calls, no wallet requests, no private keys, no transaction broadcast from this page.
# Install from PyPI pip install arc-builder-kit # List available templates arc-builder templates # Scaffold a new project arc-builder scaffold payment-intent-starter my-agent # Run diagnostics arc-builder doctor --include-circle-wallet # Generate release packet arc-builder release-packet --force
# Start MCP server (stdio) arc-builder-mcp-server # Example: tools/list request {"jsonrpc":"2.0","id":1,"method":"tools/list"} # Example: tools/call for scaffold {"jsonrpc":"2.0","id":2,"method":"tools/call","params":{ "name":"scaffold_project", "arguments":{"template":"payment-intent-starter","output_dir":"./my-agent"} }}
# templates/payment-intent-starter/server.py from http.server import HTTPServer, BaseHTTPRequestHandler import json class PaymentHandler(BaseHTTPRequestHandler): def do_GET(self): self.send_response(200) self.send_header("Content-Type", "application/json") self.end_headers() self.wfile.write(json.dumps({ "status": "ready", "chain": "ARC-TESTNET", "token": "USDC" }).encode()) # Run: python3 server.py
# arc_builder_kit/circle_wallet_sdk.py from arc_builder_kit import CircleWalletClient # Read-only balance check client = CircleWalletClient() balance = client.get_balance( address="0x0cd9...ea401", chain="ARC-TESTNET" ) print(balance["data"]["balances"]) # Gas estimate (no cost, no side effects) estimate = client.estimate_transfer( to="0x...", amount="1.00", token="USDC" )
Python stdlib only. Zero external dependencies. Install from PyPI or run directly from the repo. Fail-closed design for CI/CD pipelines.
Templates, scaffold, validate, facts, manifest, release-packet, doctor. All subcommands return non-zero on error for CI fail-closed behavior.
stdio JSON-RPC 2.0 server with 14 tools: list_templates, scaffold_project, validate_repo, arc_builder_doctor, get_arc_testnet_facts, x402_manifest, generate_release_packet, wallet_status, wallet_balance, wallet_prepare_send, and more.
Static HTML+JS or dependency-free Python servers. Each includes README with safety notes and usage instructions. No wallet or signing required.
Optional integration via Circle CLI subprocess. Read-only balance checks, transaction history, gas estimates. Real transfers disabled by default (REAL_TRANSFER=0).
pip install arc-builder-kit — wheel and sdist available. Entry points: arc-builder and arc-builder-mcp-server.
Python 3.10–3.12 matrix, ruff lint, script tests, package distribution checks, and PyPI trusted publishing via OIDC.
Automatic failover across primary Arc Testnet RPC and user-specified endpoints via ARC_RPC_FALLBACKS env var. No single point of failure.
Challenge-only 402 flow with swappable verifier. Local demo verifier accepts deterministic proofs; RpcVerifier checks on-chain USDC Transfer events.
The homepage reports actual surfaces shipped in the repo: docs, demos, prompts, validators, MCP tools, and safety runbooks.
Docs, prompts, examples, templates, validation scripts, MCP tools, CI workflows, and community files.
No custody, no private keys, no app backend/custody calls, no mainnet, no broadcast by default, no secrets in repo.
Each recipe opens a real doc or local playground — no dead buttons, no placeholders. From payment intents to x402 boundaries to Circle wallet integration.
Prepare a payment request, freeze reviewed fields, preview unsigned calldata, and keep final approval manual.
Open playground →Dependency-free arc-builder CLI with 8 subcommands and stdio MCP server with 14 tools. Scaffold projects, validate repos, run diagnostics.
Connect AI coding tools to Arc docs through the MCP surface. Verify retrieved context and configure your editor.
Open setup guide →Challenge-only 402 flow with a swappable verifier boundary for future paid API settlement work.
Open recipe →Walk through ERC-8183-style job posting, simulated funding, agent submission, and human-approved payout.
Open simulator →Live USDC balance, on-chain gas estimates, and tx history via Circle CLI. Optional real transfers with explicit confirmation.
Open demo →Connect local x402 revenue to bounded compute budgets, replay protection, verification loops, and an auditable treasury ledger.
Open treasury labCheck hash state and compare expected Arc Testnet USDC recipient/amount fields without wallet connection, signing, broadcast, or settlement claims.
Check status →Inspect Arc Testnet receipt status, gas used, raw logs, and pinned USDC Transfer events through read-only RPC only.
View receipt →Compare a payment intent JSON with an Arc Testnet transaction receipt and check whether the onchain USDC Transfer matches recipient, token, and amount.
Match intent → Agent Commerce Live Real USDC transactions on Arc Testnet via Circle agent wallet — 6 verified on-chain payments. Circle Wallet Lab Circle agent wallet bootstrap on Arc Testnet: login, faucet, transfer, CCTP bridge.Review a pinned USDC payload and keep the injected-wallet request disabled until every explicit human gate passes.
Inspect guarded labReview chain ID, recipient, amount, asset, intent hash, expiry, and transaction hash shape from local JSON.
Verify receipt →Turn the build into Russian Telegram copy, X drafts, Discord updates, thumbnails, and a demo storyboard.
Open pack →Every public entry routes to the styled docs viewer, local playground, repository, or community file. No placeholder # links.
Unified CLI, stdio MCP server, starter templates, and safe project scaffolding.
Read tooling →Connect AI coding tools to Arc docs through the MCP surface and verify retrieved context.
Read setup →Network config, contracts, agent primitives, tutorials, tools, and recommended build path.
Open map →Copy-ready prompts for docs-aware coding, payment intents, agent identity, escrow, and reviews.
Use prompts →Live Circle wallet integration: balance checks, gas estimates, transaction history. Optional real transfers with explicit confirmation.
Read demo docs →Bootstrap Circle agent wallet on Arc Testnet: login, faucet, transfer, CCTP bridge.
Read lab docs →Real on-chain USDC transactions via Circle agent wallet — 6 verified payments with evidence.
Read evidence →Scope verdict, local evidence commands, future-extension boundaries, and safe public wording.
Read report →Measurable acceptance criteria, canonical verification, explicit non-goals, and reviewer wording.
Review contract →Evidence contract for the separate disabled-by-default Arc Testnet browser-wallet send lab.
Review gate →Operator sequence, stop conditions, rollback, and verification boundary for the isolated Arc Testnet send lab.
Open guarded runbookWhy custody needs a separate backend and why Arc mainnet stays blocked until official configuration and review exist.
Review gatesManual review steps, stop conditions, and evidence records for the guarded send lab.
Open runbook →Strict Arc Testnet review record with fail-closed validation and disabled live-send controls.
Review schema →Read-only Arc Testnet receipt lookup with USDC Transfer log highlighting and no wallet path.
Review receipt flow →Compare a payment intent with an Arc Testnet receipt's USDC Transfer logs and emit a match/mismatch evidence verdict.
Review matcher flow →Operate coding agents through scoped edits, deterministic checks, event triggers, and human approval gates.
Review loop →Human-review Telegram, X, Discord/Arc House drafts, submission checklist, links, and claims to avoid.
Prepare launch →Pre-submit gates for docs grounding, payment safety, UX states, repo quality, and public proof.
Check gates →What shipped, what was verified, current safety boundaries, and optional future extensions.
Read changelog →Secret handling, report path, non-custodial defaults, and safe demo boundaries.
Security page →The static builder kit is complete for sharing. Local-only surfaces stay wallet-free. The isolated Arc Testnet send lab remains disabled until every explicit review gate passes.
Landing page, docs viewer, 49 docs, 18 examples, 6 prompt packs, PyPI package, Circle Wallet SDK, RPC fallback chain, x402 verifier, CLI with 8 subcommands, MCP server with 14 tools, and 6 starter templates — shipped and green.
The safe-scope completion contract and dependency-free completion check keep the readiness claim reproducible. CI runs Python 3.10–3.12 matrix with ruff lint and script tests.
Local-only demos remain wallet-free. The payment intent demo connects to Circle CLI for real balance/estimate data but stays estimate-only by default (REAL_TRANSFER=0).
Automatic fallback chain: primary Arc Testnet RPC → user-specified endpoints via ARC_RPC_FALLBACKS env var. No single point of failure.
One capped 1.00 USDC Arc Testnet transfer is possible only after explicit enablement, typed confirmation, and final human click.
PyPI installable with entry points: arc-builder CLI and arc-builder-mcp-server. Zero external dependencies — Python stdlib only.
Honest build log. No vaporware promises. Every item links to real code, real docs, or an explicit non-goal.
arc-builder-kit with CLI + MCP serverShort answers. No marketing fluff. If the answer is "it depends," we say why and link to the docs.
No. Independent builder kit maintained by Anstrays. Not endorsed by Arc, Circle, or any foundation. Built for the Arc Testnet builder community.
No. All playgrounds are static HTML+JS, wallet-free, and run locally in your browser. For CLI/MCP tooling: pip install arc-builder-kit.
Not yet. Current scope is Arc Testnet only. Mainnet evaluation requires a separate security review, custody assessment, and explicit human approval. See extension boundaries.
By default, no. Balance checks and gas estimates are read-only. A guarded send path exists but requires REAL_TRANSFER=1, typed confirmation, and a final human click. Max 1.00 USDC on Testnet.
The arc-builder-mcp-server exposes 14 tools (scaffold, validate, doctor, facts, manifest, wallet status, etc.) over stdio JSON-RPC 2.0. Connect it to Claude Code, Cursor, or any MCP-compatible IDE for docs-aware coding.
Zero. Python stdlib only. The PyPI package is self-contained. Templates are static HTML or dependency-free Python servers. No requirements.txt to audit.
Open an issue or PR on GitHub. The repo has pre-commit guards, CI (Python 3.10–3.12), and a completion contract. Read CONTRIBUTING first.
x402 is an HTTP 402 payment-required flow. The kit includes a challenge-only boundary with swappable verifier (local demo + RpcVerifier for on-chain USDC Transfer events). No payment is created automatically.
Every version ships with a completion contract check. No "minor fixes" without substance.
arc-builder-kit livearc-builder CLI with 8 subcommandsarc-builder-mcp-server with 14 tools