Documentação do Ethereum RPC endpoint | ERPC
Documentação do Ethereum RPC endpoint
Use a ERPC como seu endpoint RPC do Ethereum para requisições HTTP JSON-RPC e assinaturas WebSocket. O Ethereum RPC faz parte das RPC APIs da ERPC dentro da nossa Global Edge Blockchain Infrastructure, e a API key pode ser gerenciada no ERPC Web Dashboard.
Você pode usar a mesma RPC key da Solana.
Adicione sua API key ao parâmetro 'api-key'.
Endpoints
Envie requisições JSON-RPC 2.0 como HTTP POST para:
text
https://edge.erpc.global/eth?api-key=<YOUR_API_KEY>https://edge.erpc.global/eth?api-key=<YOUR_API_KEY>Para assinaturas, conecte-se via WebSocket a:
text
wss://edge.erpc.global/eth?api-key=<YOUR_API_KEY>wss://edge.erpc.global/eth?api-key=<YOUR_API_KEY>Exemplos
Aqui está um exemplo de requisição HTTP.
bash
curl https://edge.erpc.global/eth?api-key=<YOUR_API_KEY> --header 'Content-Type: application/json' --data '{
"jsonrpc":"2.0","id":1,
"method":"eth_blockNumber"
}'curl https://edge.erpc.global/eth?api-key=<YOUR_API_KEY> --header 'Content-Type: application/json' --data '{
"jsonrpc":"2.0","id":1,
"method":"eth_blockNumber"
}'Aqui está um exemplo de assinatura WebSocket.
bash
wscat -c "wss://edge.erpc.global/eth?api-key=<YOUR_API_KEY>"
# After connected, send:
{"jsonrpc":"2.0","id":1,"method":"eth_subscribe","params":["newHeads"]}wscat -c "wss://edge.erpc.global/eth?api-key=<YOUR_API_KEY>"
# After connected, send:
{"jsonrpc":"2.0","id":1,"method":"eth_subscribe","params":["newHeads"]}Você pode obter e verificar sua API key no ERPC Web Dashboard: ERPC Web Dashboard
Requisições em lote
Lotes de JSON-RPC com até 256 chamadas por requisição HTTP são suportados, e notificações JSON-RPC também são aceitas. Cada chamada em um lote é medida como uma chamada individual.
Medição de uso
O uso é medido em tokens a uma taxa fixa por chamada JSON-RPC — a mesma taxa para todos os métodos do Ethereum RPC. Cada entrada em um lote HTTP e cada chamada JSON-RPC enviada por uma conexão WebSocket é medida separadamente. Você pode verificar a taxa atual de tokens por chamada na Referência da API Ethereum RPC.
Métodos suportados
O endpoint cobre as famílias padrão de métodos JSON-RPC do Ethereum —
eth_*, net_*, txpool_* e web3_* — incluindo leituras de contas e blocos (eth_getBalance, eth_getBlockByNumber, eth_getLogs), fluxo de transações (eth_sendRawTransaction, eth_getTransactionReceipt), dados de taxa (eth_feeHistory, eth_maxPriorityFeePerGas), simulação de chamadas (eth_call, eth_callMany, eth_simulateV1), provas de estado (eth_getProof), filtros (eth_newFilter, eth_getFilterChanges), inspeção do txpool (txpool_status, txpool_content), e assinaturas WebSocket (eth_subscribe, eth_unsubscribe).Para a lista completa de métodos com os formatos de requisição e resposta, consulte a Referência da API Ethereum RPC.
Códigos de status de resposta
| HTTP status | Significado |
|---|---|
| 200 | Resposta JSON-RPC do upstream. |
| 400 | Requisição JSON-RPC inválida. |
| 401 | API key ausente ou não autorizada. |
| 429 | Limitado por taxa pela política do RPC downstream. |
| 502 | Proxy indisponível. |
| 503 | Serviço RPC downstream indisponível. |
Conexões WebSocket usam
101 (atualização de protocolo aceita) e 426 (um handshake de WebSocket Upgrade é necessário) além dos códigos acima.Métodos e Documentação Ethereum RPC
Para a lista completa de métodos padrão, parâmetros e especificações de assinatura, consulte a documentação oficial. Ela cobre tanto o uso HTTP quanto WebSocket.