Interfaces
CLI Reference
Referência completa da interface de linha de comando do Arc DevKit — dois entry points: arcdevkit (agrupado) e arc (flat completo).
O Arc DevKit instala dois executáveis de CLI:
| Comando | Entry point | Estilo |
|---|---|---|
arcdevkit | arc_devkit.cli.main:app | Subcomandos agrupados (copilot, agent, debug) |
arc | arc_devkit.cli.flat:app | Comandos diretos — set completo de funcionalidades |
arcdevkit — CLI agrupado
arcdevkit / arcdevkit --version
arcdevkit # exibe banner com versão instalada
arcdevkit --version # imprime somente a versão
arcdevkit -v # alias de --version
arcdevkit status
Verifica a conexão com o Arc testnet e exibe o bloco atual, chain ID e preço do gas.
arcdevkit status
arcdevkit copilot
Subcomando do assistente IA baseado no Dev Copilot.
arcdevkit copilot ask
arcdevkit copilot ask PROMPT [--stream] [--json]
| Opção | Alias | Descrição |
|---|---|---|
--stream | -s | Transmite a resposta token a token |
--json | — | Saída JSON com response e model |
Exemplos:
arcdevkit copilot ask "Como crio uma carteira na Arc?"
arcdevkit copilot ask "Gere um contrato ERC-20" --stream
arcdevkit copilot ask "O que é Malachite consensus?" --json
arcdevkit agent
Subcomando para gestão de carteiras e agentes econômicos.
arcdevkit agent create-wallet
Cria uma nova carteira EVM e exibe endereço e chave privada uma única vez.
arcdevkit agent create-wallet
✕Chave privada exibida apenas uma vez
Armazene a chave privada em local seguro imediatamente. Ela não é salva em nenhum arquivo.
arcdevkit agent balance
arcdevkit agent balance ADDRESS
Exibe o saldo da carteira especificada.
arcdevkit agent status
Exibe informações da rede Arc (bloco atual, chain ID, preço do gas).
arcdevkit agent status
arcdevkit agent pay
arcdevkit agent pay TO AMOUNT [--send] [--key KEY]
Prepara (e opcionalmente envia) um pagamento USDC na Arc.
| Argumento/Opção | Descrição |
|---|---|
TO | Endereço EVM do destinatário |
AMOUNT | Valor em USDC |
--send | Transmite a transação na rede (requer ARC_PRIVATE_KEY) |
--key KEY | Chave privada (substitui ARC_PRIVATE_KEY) |
Exemplos:
# Preparar (dry run — não envia)
arcdevkit agent pay 0xDest... 5.0
# Enviar de verdade
arcdevkit agent pay 0xDest... 5.0 --send
# Enviar com chave explícita
arcdevkit agent pay 0xDest... 5.0 --send --key 0xSUACHAVE...
arcdevkit agent monitor
arcdevkit agent monitor ADDRESS [--interval SECS] [--max N]
Monitora uma carteira Arc e exibe alertas quando o saldo muda.
| Opção | Alias | Padrão | Descrição |
|---|---|---|---|
--interval | -i | 15 | Intervalo de polling em segundos |
--max | — | 0 | Iterações máximas (0 = infinito) |
arcdevkit agent monitor 0xCarteira...
arcdevkit agent monitor 0xCarteira... --interval 5 --max 20
Pressione Ctrl+C para parar.
arcdevkit debug
Subcomando para análise e depuração de transações.
arcdevkit debug tx
arcdevkit debug tx TX_HASH [--json]
Analisa uma transação Arc e exibe diagnóstico completo com análise IA.
| Opção | Descrição |
|---|---|
--json | Saída como JSON bruto |
arcdevkit debug tx 0xabc123...
arcdevkit debug tx 0xabc123... --json
arcdevkit debug estimate
arcdevkit debug estimate TO AMOUNT [--from ADDR]
Estima o custo de gas para uma transferência na Arc.
| Argumento/Opção | Descrição |
|---|---|
TO | Endereço EVM do destinatário |
AMOUNT | Valor da transferência em USDC |
--from ADDR | Endereço do remetente (opcional) |
arcdevkit debug estimate 0xDest... 10.5
arcdevkit debug estimate 0xDest... 10.5 --from 0xRemetente...
arc — CLI flat (set completo)
O executável arc expõe o mesmo conjunto de funcionalidades em comandos diretos (sem grupos aninhados) e adiciona comandos exclusivos: init, codegen, gas, send, history, balance, debug-batch e portfolio.
arc init
Wizard interativo para criar o arquivo .env do zero.
arc init
Solicita interativamente:
ANTHROPIC_API_KEY(obrigatório)ARC_RPC_URL(padrão:https://arc-testnet.drpc.org)ARC_CHAIN_ID(padrão:5042002)ARC_PRIVATE_KEY(opcional)LOG_LEVEL(padrão:INFO)
arc status
arc status [--json] [-v]
Verifica conexão com Arc testnet. Com --json retorna connected, chain_id, block_number, gas_price_gwei.
| Opção | Alias | Descrição |
|---|---|---|
--json | — | Saída como JSON |
--verbose | -v | Ativa logs de debug |
arc ask
arc ask QUESTION [--raw] [--stream] [--json] [-v]
Consulta o DevCopilot — assistente IA especializado em desenvolvimento Arc.
| Opção | Alias | Descrição |
|---|---|---|
--raw | — | Imprime texto puro sem renderização Markdown |
--stream | -s | Transmite resposta token a token |
--json | — | Saída JSON com response e model |
--verbose | -v | Ativa logs de debug |
arc ask "Como faço deploy na Arc testnet?"
arc ask "Gere um contrato USDC vault" --stream
arc ask "O que é USDC ERC-20?" --json
arc ask "Explique o Malachite consensus" --raw
arc balance
arc balance ADDRESS [--json] [-v]
Exibe o saldo nativo ARC e o nonce de uma carteira.
| Opção | Alias | Descrição |
|---|---|---|
--json | — | Saída JSON com address, balance_arc, nonce |
--verbose | -v | Ativa logs de debug |
arc balance 0xSuaCarteira...
arc balance 0xSuaCarteira... --json
arc gas
arc gas TO AMOUNT [--from ADDR] [--json] [-v]
Estima o custo de gas para uma transferência USDC na Arc.
| Argumento/Opção | Alias | Descrição |
|---|---|---|
TO | — | Endereço EVM do destinatário |
AMOUNT | — | Valor em USDC |
--from ADDR | -f | Endereço do remetente (opcional) |
--json | — | Saída como JSON |
--verbose | -v | Ativa logs de debug |
arc gas 0xDest... 10.5
arc gas 0xDest... 10.5 --from 0xRemetente...
arc gas 0xDest... 10.5 --json
arc debug
arc debug TX_HASH [--abi PATH] [--json] [-v]
Analisa uma transação Arc com diagnóstico IA. Suporte opcional a ABI para decodificar input data.
| Opção | Alias | Descrição |
|---|---|---|
--abi PATH | -a | Caminho para arquivo ABI JSON (opcional) |
--json | — | Saída como JSON bruto |
--verbose | -v | Ativa logs de debug |
arc debug 0xTxHash...
arc debug 0xTxHash... --abi MeuContrato.json
arc debug 0xTxHash... --json
arc debug-batch
arc debug-batch HASHES_FILE [--abi PATH] [--json] [-v]
Analisa múltiplas transações em lote a partir de um arquivo.
| Argumento/Opção | Alias | Descrição |
|---|---|---|
HASHES_FILE | — | Arquivo com hashes (uma por linha ou array JSON) |
--abi PATH | -a | Arquivo ABI JSON para decodificar inputs |
--json | — | Saída como JSON |
--verbose | -v | Ativa logs de debug |
Formato do arquivo (uma hash por linha):
0xabc123...
0xdef456...
0xghi789...
Formato alternativo (JSON array):
["0xabc123...", "0xdef456...", "0xghi789..."]
arc debug-batch hashes.txt
arc debug-batch hashes.json --abi MeuContrato.json --json
arc codegen
arc codegen TOPIC [--save | --no-save] [--out DIR] [-v]
Gera um script Python a partir de uma descrição em linguagem natural. O script é exibido na tela e salvo em arquivo por padrão.
| Opção | Alias | Padrão | Descrição |
|---|---|---|---|
--save / --no-save | — | --save | Salva o script gerado em arquivo |
--out DIR | -o | . (diretório atual) | Diretório de destino do arquivo |
--verbose | -v | — | Ativa logs de debug |
arc codegen "agente que monitora saldo e envia alerta"
arc codegen "contrato ERC-20 simples" --no-save
arc codegen "script de batch payment" --out ./scripts
arc config
Lê e escreve variáveis no arquivo .env.
arc config get KEY # lê uma variável
arc config set KEY VALUE # define uma variável
arc config list # lista todas as variáveis
Exemplos:
arc config get ARC_RPC_URL
arc config set LOG_LEVEL DEBUG
arc config list
arc wallet
Subcomando para gestão básica de carteiras.
arc wallet create
arc wallet create [--json]
Cria uma nova carteira EVM e exibe endereço e chave privada uma única vez.
| Opção | Descrição |
|---|---|
--json | Saída JSON com address e private_key |
✕Chave privada exibida apenas uma vez
Copie e armazene a chave privada imediatamente. Ela não é salva em nenhum arquivo.
arc wallet balance
arc wallet balance ADDRESS [--json]
Exibe o saldo ARC nativo de uma carteira.
| Opção | Descrição |
|---|---|
--json | Saída JSON |
arc send
arc send TO AMOUNT [--token TOKEN] [--broadcast] [--json] [-v]
Constrói (e opcionalmente transmite) uma transação de pagamento na Arc. Requer ARC_PRIVATE_KEY configurado.
| Argumento/Opção | Alias | Padrão | Descrição |
|---|---|---|---|
TO | — | — | Endereço EVM do destinatário |
AMOUNT | — | — | Valor a transferir |
--token TOKEN | -t | native | native (ARC) ou usdc (ERC-20) |
--broadcast | -b | False | Transmite a transação (requer ARC_PRIVATE_KEY) |
--json | — | — | Saída como JSON |
--verbose | -v | — | Ativa logs de debug |
# Construir transação (dry run — não envia)
arc send 0xDest... 5.0 --token native
# Enviar transação ARC nativo
arc send 0xDest... 1.0 --token native --broadcast
# Enviar USDC ERC-20
arc send 0xDest... 10.0 --token usdc --broadcast
⚠ARC_PRIVATE_KEY obrigatório para --broadcast
Sem a variável de ambiente ARC_PRIVATE_KEY configurada, o comando encerra com erro. Use arc config set ARC_PRIVATE_KEY 0x... ou defina a variável no .env.
arc history
arc history [--limit N] [--json]
Lista análises recentes salvas em ~/.arc_devkit/history.json.
| Opção | Alias | Padrão | Descrição |
|---|---|---|---|
--limit | -n | 10 | Número de registros a exibir |
--json | — | — | Saída como JSON |
arc history
arc history --limit 50
arc history --json
arc portfolio
Análise de carteiras: saldo, histórico de transações e score de atividade.
arc portfolio analyze
arc portfolio analyze ADDRESS [--blocks N] [--no-ai] [--json] [-v]
Analisa uma carteira: saldos (nativo e USDC), transações recentes e insights de IA.
| Opção | Alias | Padrão | Descrição |
|---|---|---|---|
--blocks | -b | 100 | Número de blocos recentes a escanear |
--no-ai | — | — | Pula a análise IA (mais rápido) |
--json | — | — | Saída como JSON |
--verbose | -v | — | Ativa logs de debug |
arc portfolio analyze 0xSuaCarteira...
arc portfolio analyze 0xSuaCarteira... --blocks 500
arc portfolio analyze 0xSuaCarteira... --no-ai --json
O snapshot é salvo automaticamente para histórico.
arc portfolio history
arc portfolio history ADDRESS [--limit N] [--json]
Exibe o histórico de snapshots salvos para uma carteira.
| Opção | Alias | Padrão | Descrição |
|---|---|---|---|
--limit | -n | 10 | Número máximo de snapshots |
--json | — | — | Saída como JSON |
arc portfolio history 0xSuaCarteira...
arc portfolio history 0xSuaCarteira... --limit 30
arc portfolio report
arc portfolio report WALLETS_FILE [--blocks N] [--json] [-v]
Relatório consolidado para múltiplas carteiras a partir de um arquivo JSON.
| Argumento/Opção | Alias | Padrão | Descrição |
|---|---|---|---|
WALLETS_FILE | — | — | Arquivo JSON com lista de carteiras |
--blocks | -b | 100 | Blocos a escanear por carteira |
--json | — | — | Saída como JSON |
--verbose | -v | — | Ativa logs de debug |
Formato do arquivo (lista simples):
["0xWallet1...", "0xWallet2...", "0xWallet3..."]
Formato com rótulos:
[
{"address": "0xWallet1...", "label": "Treasury"},
{"address": "0xWallet2...", "label": "Operations"}
]
arc portfolio report carteiras.json
arc portfolio report carteiras.json --blocks 200 --json
Saída JSON
Todos os comandos que suportam --json retornam dados estruturados para integração com scripts e pipelines:
arc status --json
# {"connected": true, "network": "Arc Testnet", "chain_id": 5042002, "block_number": 4821903, "gas_price_gwei": "1.0"}
arc balance 0xSuaCarteira... --json
# {"address": "0x...", "balance_arc": "1.500000", "nonce": 42}
arc portfolio analyze 0xSuaCarteira... --no-ai --json
# {"address": "0x...", "native_balance": "1.5", "usdc_balance": "10.0", "nonce": 42, "activity_score": "medium", ...}
Ajuda
Qualquer comando aceita --help:
arcdevkit --help
arcdevkit copilot --help
arcdevkit agent --help
arcdevkit debug --help
arc --help
arc send --help
arc portfolio --help
arc debug-batch --help