Introdução

Arc DevKit é um toolkit Python open source para construir, depurar e integrar aplicações na Arc Mainnet — a Layer 1 EVM-compatível da Circle, onde USDC é o token de gas e a finalidade de blocos é sub-segundo graças ao consenso Malachite. A Arc Testnet continua totalmente suportada para desenvolvimento.

O que é Arc?

Arc é uma L1 blockchain criada pela Circle (criadores do USDC), projetada especificamente para pagamentos programáveis e agentes econômicos autônomos. A mainnet foi lançada em 16/09/2026.

Por que Arc DevKit?

Construir na Arc expõe você a uma série de fricções práticas que o Arc DevKit resolve:

• Sem configuração manual de rede: chain ID, RPC, explorer e endereços de contrato (USDC, EURC, CCTP, Gateway) já vêm pré-configurados e com fonte verificada para mainnet e testnet — veja Networks
• Gas em USDC: diferente de outras EVMs, USDC é ao mesmo tempo o token de gas nativo (18 decimais) e um ERC-20 (6 decimais) — o DevKit modela os dois corretamente e nunca os confunde
• PoA Middleware: a Arc roda um modelo de validadores permissionado nas duas redes e exige ExtraDataToPOAMiddleware no web3.py
• Segurança em mainnet: o CLI avisa e pede confirmação antes de fazer broadcast de transações com fundos reais em mainnet
• Agentes econômicos: a Arc foi projetada para agentes IA — o DevKit oferece base classes prontas
• Debugging complexo: transações revertidas na EVM têm mensagens de erro codificadas; o DevKit decodifica e explica em linguagem natural via IA

Módulos

arc_devkit/
├── copilot/         Dev Copilot — IA com contexto Arc embutido
├── agents/          Payment Agent, Monitor Agent, Async Monitor,
│                    identity.py + jobs.py (economia agêntica ERC-8004/8183)
├── debugger/        Tx Debugger — decodifica e analisa transações
├── analytics/       Portfolio Analyzer — saldo, histórico, score
├── stablecoins/     StablecoinToken — USDC e EURC (usdc/ mantido como shim)
├── client.py        Fachada Arc — Arc.mainnet()/Arc.testnet(), ponto de entrada único
├── health.py        Health check de rede compartilhado (`arc doctor`)
├── networks.py      Perfis de rede mainnet/testnet (chain ID, RPC, contratos)
├── paymaster/       Detecção de paymaster + helpers ERC-4337
├── bridge/          CCTP — bridge cross-chain de USDC
├── oracle/          Cliente de price feeds (Chainlink-compatível)
├── privacy/         Criptografia view-key + transferências confidenciais
├── contracts/       Utilitários para contratos EVM
├── events/          Event Listener — polling de logs on-chain
├── deploy/          Contract Deployer
├── api/             FastAPI server com SSE e WebSocket
├── mcp_server.py    Servidor MCP próprio — `arcdevkit mcp serve`
└── cli/             CLI `arc` e `arcdevkit`

Requisitos

• Python 3.11+
• Uma chave de provedor de IA para o Dev Copilot — Anthropic (padrão), ou Google Gemini / OpenAI / um servidor Ollama local (veja Dev Copilot)
• Nenhuma URL de RPC é necessária para começar — tanto a Arc Mainnet (https://rpc.mainnet.arc.io) quanto a Arc Testnet (https://rpc.testnet.arc.io) já vêm com defaults oficiais; defina ARC_RPC_URL apenas para usar seu próprio provedor