ERPC

TRON RPC endpoint documentatie | ERPC

TRON RPC endpoint documentatie

Gebruik ERPC als uw TRON RPC endpoint voor HTTP JSON-RPC-verzoeken en de TRON HTTP API. TRON RPC maakt deel uit van de RPC APIs van ERPC binnen onze Global Edge Blockchain Infrastructure, en de API key kan worden beheerd via het ERPC Web Dashboard.
U kunt dezelfde RPC key als Solana, Ethereum en Avalanche gebruiken.
Geef uw API key mee in de queryparameter api-key, of stuur hem mee als Authorization: Bearer <YOUR_API_KEY>. Als beide aanwezig zijn, wordt de queryparameter gebruikt.

Endpoints

Verstuur JSON-RPC 2.0-verzoeken als HTTP POST naar:
text
https://edge.erpc.global/tron?api-key=<YOUR_API_KEY>
of naar de dedicated host:
text
https://tron.erpc.global?api-key=<YOUR_API_KEY>
Op de dedicated host bereiken / en /jsonrpc hetzelfde JSON-RPC-endpoint, en de TRON HTTP API wordt bediend onder /wallet/<name> en /walletsolidity/<name>. Op edge.erpc.global volgen dezelfde paden het voorvoegsel /tron: /tron, /tron/jsonrpc, /tron/wallet/<name> en /tron/walletsolidity/<name>. De POST-body van de TRON HTTP API moet een JSON-object zijn. Andere paden worden beantwoord met HTTP 400.

Voorbeelden

Hier is een HTTP-verzoekvoorbeeld met de API key in de queryparameter.
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"
}'
Hier is hetzelfde verzoek met de API key in de Authorization-header.
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"
}'
Hier is een voorbeeld van de TRON HTTP API.
bash
curl 'https://edge.erpc.global/tron/wallet/getnowblock?api-key=<YOUR_API_KEY>' --header 'Content-Type: application/json' --data '{}'
U kunt uw API key verkrijgen en controleren in het ERPC Web Dashboard: ERPC Web Dashboard

Batch-verzoeken

JSON-RPC-batches van 1 tot 100 aanroepen per HTTP-verzoek worden ondersteund. Elke aanroep heeft een eigen id nodig, en id-waarden mogen binnen een batch niet herhaald worden. Elke aanroep in een batch wordt gemeten als een eigen aanroep. De request body mag maximaal 1 MiB groot zijn. Batches worden naar /jsonrpc verstuurd. Een verzoek aan de TRON HTTP API bevat één aanroep en wordt gemeten als één aanroep.

Tokengebruik

Het gebruik wordt gemeten in tokens, en het tokentarief kan per methode verschillen. Elke aanroep in een HTTP-batch wordt afzonderlijk gemeten. Elk verzoek aan de TRON HTTP API wordt gemeten als één aanroep.

Limieten van het Free-abonnement

Bij het Free-abonnement kan uw account één verzoek per 10 seconden versturen. De limiet wordt per account geteld, niet per endpoint, dus een verzoek naar een andere chain kan ook meetellen. Een verzoek dat sneller wordt verstuurd, wordt beantwoord met HTTP 429, en de retry-after-header geeft de wachttijd in seconden aan.
Bij het Free-abonnement wordt een verzoek met twee of meer JSON-RPC-aanroepen beantwoord met HTTP 429, en wordt geen van de aanroepen verzonden: elke aanroep krijgt een JSON-RPC-fout met code -32041. Verstuur deze aanroepen in plaats daarvan één voor één.

Ondersteunde methodes

Het endpoint bedient deze 38 methodes. De methodes eth_*, net_* en web3_* zijn JSON-RPC-aanroepen naar / of /jsonrpc. De items /wallet/* en /walletsolidity/* zijn paden van de TRON HTTP API, die worden aangeroepen met een JSON-object als POST-body.
  • 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
Een methode of pad dat niet in de lijst staat, wordt beantwoord met HTTP 400.

Antwoordstatuscodes

HTTP-statusBetekenis
200Upstream JSON-RPC-respons. Ook een JSON-RPC-fout wordt met HTTP 200 geretourneerd: de id van het verzoek en de error.code blijven behouden, de error.message is ERPC upstream error, en error.data wordt niet geretourneerd.
400Een methode of pad buiten de lijst met ondersteunde methodes, een ongeldig JSON-RPC-verzoek, een lege batch of een batch van meer dan 100 aanroepen, een dubbele id in een batch, of een body groter dan 1 MiB.
401Ontbrekende of ongeldige API key, of er wordt niet voldaan aan een IP- of Origin-beperking op de key.
405Een andere requestmethode dan POST.
426Er is een WebSocket Upgrade aangevraagd. Het endpoint ondersteunt alleen HTTP.
429Rate-limited, inclusief de hierboven genoemde limieten van het Free-abonnement: meer dan één verzoek per 10 seconden, of twee of meer aanroepen in één verzoek. Als er een retry-after-header aanwezig is, wacht dan het aangegeven aantal seconden.
502Het upstream-verzoek kon niet worden voltooid: een mislukte upstream-respons, een respons groter dan 8 MiB, of geen antwoord binnen 30 seconden. Een respons van de TRON HTTP API die een fout meldt, wordt ook met 502 beantwoord.
503De service is tijdelijk niet beschikbaar.

TRON RPC-methoden en documentatie

Voor de volledige lijst van standaardmethoden, parameters en specificaties verwijzen wij u naar de officiële documentatie.
https://developers.tron.network/reference/full-node-api-overview

Vorige

TRON RPC - Snelstart

Volgende

ERPC AI