ERPC

Documentação do TRON RPC endpoint | ERPC

Documentação do TRON RPC endpoint

Use a ERPC como seu TRON RPC endpoint para requisições HTTP JSON-RPC e para a API HTTP da TRON. O TRON 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, do Ethereum e da Avalanche.
Passe sua API key no parâmetro de query api-key ou envie-a como Authorization: Bearer <YOUR_API_KEY>. Quando os dois estão presentes, o parâmetro de query é usado.

Endpoints

Envie requisições JSON-RPC 2.0 como HTTP POST para:
text
https://edge.erpc.global/tron?api-key=<YOUR_API_KEY>
ou para o host dedicado:
text
https://tron.erpc.global?api-key=<YOUR_API_KEY>
No host dedicado, / e /jsonrpc levam ao mesmo endpoint JSON-RPC, e a API HTTP da TRON é servida em /wallet/<name> e /walletsolidity/<name>. Em edge.erpc.global, os mesmos caminhos seguem o prefixo /tron: /tron, /tron/jsonrpc, /tron/wallet/<name> e /tron/walletsolidity/<name>. O corpo do POST da API HTTP da TRON deve ser um objeto JSON. Outros caminhos são respondidos com HTTP 400.

Exemplos

Aqui está um exemplo de requisição HTTP com a API key no parâmetro de query.
bash
curl 'https://edge.erpc.global/tron?api-key=<YOUR_API_KEY>' --header 'Content-Type: application/json' --data '{
  "jsonrpc":"2.0","id":1,
  "method":"eth_blockNumber"
}'
Aqui está a mesma requisição com a API key no cabeçalho Authorization.
bash
curl 'https://edge.erpc.global/tron' --header 'Content-Type: application/json' --header 'Authorization: Bearer <YOUR_API_KEY>' --data '{
  "jsonrpc":"2.0","id":1,
  "method":"eth_blockNumber"
}'
Aqui está um exemplo da API HTTP da TRON.
bash
curl 'https://edge.erpc.global/tron/wallet/getnowblock?api-key=<YOUR_API_KEY>' --header 'Content-Type: application/json' --data '{}'
Você pode obter e verificar sua API key no ERPC Web Dashboard: ERPC Web Dashboard

Requisições em lote

Lotes de JSON-RPC com 1 a 100 chamadas por requisição HTTP são suportados. Cada chamada precisa do seu próprio id, e os valores de id não podem se repetir dentro de um lote. Cada chamada em um lote é medida como uma chamada individual. O corpo da requisição pode ter até 1 MiB. Os lotes são enviados para /jsonrpc. Uma requisição à API HTTP da TRON leva uma chamada e é medida como uma chamada.

Medição de uso

O uso é medido em tokens, e a taxa de tokens pode variar conforme o método. Cada chamada em um lote HTTP é medida separadamente. Cada requisição à API HTTP da TRON é medida como uma chamada.

Limites do Plano Free

No Plano Free, sua conta pode enviar uma requisição a cada 10 segundos. O limite é contado por conta, e não por endpoint, então uma requisição a outra chain também pode contar para ele. Uma requisição enviada antes disso é respondida com HTTP 429, e o cabeçalho retry-after informa a espera em segundos.
No Plano Free, uma requisição que contém duas ou mais chamadas JSON-RPC é respondida com HTTP 429, e nenhuma de suas chamadas é enviada: cada chamada recebe um erro JSON-RPC com o código -32041. Envie essas chamadas uma de cada vez.

Métodos suportados

O endpoint atende estes 38 métodos. Os métodos eth_*, net_* e web3_* são chamadas JSON-RPC enviadas para / ou /jsonrpc. As entradas /wallet/* e /walletsolidity/* são caminhos da API HTTP da TRON, chamados com um objeto JSON como corpo do POST.
  • eth_* (19): eth_blockNumber, eth_call, eth_chainId, eth_estimateGas, eth_gasPrice, eth_getBalance, eth_getBlockByHash, eth_getBlockByNumber, eth_getBlockReceipts, eth_getBlockTransactionCountByHash, eth_getBlockTransactionCountByNumber, eth_getCode, eth_getLogs, eth_getStorageAt, eth_getTransactionByBlockHashAndIndex, eth_getTransactionByBlockNumberAndIndex, eth_getTransactionByHash, eth_getTransactionReceipt, eth_syncing
  • net_* (3): net_listening, net_peerCount, net_version
  • web3_* (2): web3_clientVersion, web3_sha3
  • /wallet/* (9): /wallet/broadcasthex, /wallet/broadcasttransaction, /wallet/estimateenergy, /wallet/getaccount, /wallet/getblockbynum, /wallet/getnowblock, /wallet/gettransactionbyid, /wallet/gettransactioninfobyid, /wallet/triggerconstantcontract
  • /walletsolidity/* (5): /walletsolidity/getaccount, /walletsolidity/getblockbynum, /walletsolidity/getnowblock, /walletsolidity/gettransactionbyid, /walletsolidity/gettransactioninfobyid
Um método ou caminho que não esteja listado é respondido com HTTP 400.

Códigos de status de resposta

HTTP statusSignificado
200Resposta JSON-RPC do upstream. Um erro JSON-RPC também é retornado com HTTP 200: ele mantém o id da requisição e o error.code, seu error.message é ERPC upstream error, e error.data não é retornado.
400Um método ou caminho fora da lista de métodos suportados, uma requisição JSON-RPC inválida, um lote vazio ou com mais de 100 chamadas, um id duplicado em um lote, ou um corpo acima de 1 MiB.
401API key ausente ou inválida, ou uma restrição de IP ou de Origin definida na key não foi atendida.
405Um método de requisição diferente de POST.
426Foi solicitado um WebSocket Upgrade. O endpoint atende apenas HTTP.
429Limitado por taxa, incluindo os limites do Plano Free acima: mais de uma requisição a cada 10 segundos, ou duas ou mais chamadas em uma requisição. Se houver um cabeçalho retry-after, aguarde o número de segundos indicado.
502A requisição upstream não pôde ser concluída: uma resposta upstream com falha, uma resposta acima de 8 MiB, ou nenhuma resposta em até 30 segundos. Uma resposta da API HTTP da TRON que reporte falha também é respondida com 502.
503O serviço está temporariamente indisponível.

Métodos e Documentação TRON RPC

Para a lista completa de métodos padrão, parâmetros e especificações, consulte a documentação oficial.
https://developers.tron.network/reference/full-node-api-overview

Anterior

TRON RPC Quickstart | ERPC

Próximo

ERPC AI