URL RPC da Base: acesso sem chave e exemplos em curl e viem

Comece com a URL RPC pública da Base mainnet abaixo para ler o Chain ID sem uma API key. Consulte os métodos suportados e os limites por IP na página da rede Base; use uma chave para métodos fora de public.methods permitidos pela rede.

curl -sS "https://api.blockvectra.com/v1/base_mainnet/public" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"eth_chainId","params":[]}'

Informações da rede e endpoints

Toda requisição para a Base identifica sua rede de destino explicitamente no caminho da URL usando o slug base_mainnet. O JSON-RPC oferece suporte tanto à autenticação de chave pelo caminho quanto por cabeçalho de requisição (x-api-key).

Exemplos diretos em curl e viem

Você pode fazer chamadas JSON-RPC diretamente usando curl ou bibliotecas de cliente web3 como viem. Defina sua API key na variável de ambiente BLOCKVECTRA_API_KEY:

curl -s "https://api.blockvectra.com/v1/base_mainnet" \
  -H "Content-Type: application/json" \
  -H "x-api-key: $BLOCKVECTRA_API_KEY" \
  -d '{"jsonrpc":"2.0","id":1,"method":"eth_chainId","params":[]}'

Estrutura de resposta

As respostas seguem a especificação JSON-RPC 2.0:

• Sucesso: retorna um objeto contendo jsonrpc: "2.0", o id inteiro correspondente e o result codificado em hexadecimal (eth_chainId retorna o Chain ID em hexadecimal; eth_blockNumber retorna a altura do bloco mais recente).
• Métodos não permitidos: solicitar um método fora dos métodos permitidos da rede retorna o código de erro JSON-RPC -32601 (method not available, sem cobrança).
• Consultas fora da janela: requisições de estado histórico anteriores à janela de retenção de estado retornam o código de erro JSON-RPC -32011 (sem cobrança).
• API key ausente: omitir a chave retorna HTTP 401 com o código de erro JSON-RPC -32024 (missing_api_key, sem cobrança).
• Parâmetros inválidos: parâmetros de requisição malformados retornam o código de erro JSON-RPC -32602 (sem cobrança).

Política de métodos e recursos

Valores em tempo real: GET /v1/chains (methods, max_logs_block_range, state_window_blocks).

Blockchain Data API

Valores em tempo real: GET /v1/chains (data).

Primeiros passos e API keys

• Console web: cadastre-se via assinatura de carteira Ethereum e gere uma API key no Console. Consulte o guia de Início rápido para detalhes de configuração.
• Cadastro programático: AI Agents autônomos, scripts automatizados e pipelines de CI podem fazer login e provisionar API keys usando assinaturas de carteira Ethereum (EIP-191) sem a necessidade de um navegador. Siga o guia de cadastro programático.
• AI Agents: AI Agents autônomos podem descobrir recursos da Base usando o servidor oficial do Model Context Protocol (MCP). Consulte Conectando AI Agents à BlockVectra.
• Aumento de limites: após a recarga, o limite de chamadas por segundo de toda a conta é removido; cada chave permanece sujeita aos limites de taxa e rajada de Compute Units (CU). Para tarifas e unidades de cobrança atuais, consulte a página de preços.

Guias e recursos relacionados

• Documentação para desenvolvedores da Base: para especificações de rede, mecânica de gas e contratos na Base, consulte a documentação oficial da Base.
• RPC personalizado na carteira: configure endpoints RPC personalizados para a Base no MetaMask e Rabby usando o guia de RPC personalizado na carteira.
• Simulação de transações: teste a execução de transações e avalie alterações de estado antes do envio usando eth_simulateV1 no guia de simulação de transações.

Próximos passos

• Explore o diretório de conjuntos de dados para ver todos os conjuntos de dados indexados pela BlockVectra.
• Consulte o plano gratuito e os preços para verificar o que sua conta inclui.
• Entre no console para criar uma API key.