ERPC

TRON RPC Endpoint mit ERPC - Dokumentation

TRON RPC Endpoint Dokumentation

Nutzen Sie ERPC als Ihren TRON RPC Endpoint für HTTP JSON-RPC-Anfragen und die TRON HTTP API. TRON RPC ist Teil der RPC APIs von ERPC innerhalb unserer Global Edge Blockchain Infrastructure, und der API key kann über das ERPC Web Dashboard verwaltet werden.
Sie können denselben RPC key wie bei Solana, Ethereum und Avalanche verwenden.
Übergeben Sie Ihren API key im Query-Parameter api-key oder senden Sie ihn als Authorization: Bearer <YOUR_API_KEY>. Sind beide vorhanden, wird der Query-Parameter verwendet.

Endpoints

Senden Sie JSON-RPC 2.0-Anfragen als HTTP POST an:
text
https://edge.erpc.global/tron?api-key=<YOUR_API_KEY>
oder an den dedizierten Host:
text
https://tron.erpc.global?api-key=<YOUR_API_KEY>
Auf dem dedizierten Host erreichen / und /jsonrpc denselben JSON-RPC-Endpoint, und die TRON HTTP API wird unter /wallet/<name> und /walletsolidity/<name> bereitgestellt. Auf edge.erpc.global folgen dieselben Pfade dem Präfix /tron: /tron, /tron/jsonrpc, /tron/wallet/<name> und /tron/walletsolidity/<name>. Der POST-Body der TRON HTTP API muss ein JSON-Objekt sein. Andere Pfade werden mit HTTP 400 beantwortet.

Beispiele

Hier ist ein Beispiel für eine HTTP-Anfrage mit dem API key im Query-Parameter.
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 ist dieselbe Anfrage mit dem API key im 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 ist ein Beispiel für die TRON HTTP API.
bash
curl 'https://edge.erpc.global/tron/wallet/getnowblock?api-key=<YOUR_API_KEY>' --header 'Content-Type: application/json' --data '{}'
Sie können Ihren API key im ERPC Web Dashboard abrufen und prüfen: ERPC Web Dashboard

Batch-Anfragen

JSON-RPC-Batches mit 1 bis 100 Aufrufen pro HTTP-Anfrage werden unterstützt. Jeder Aufruf braucht eine eigene id, und id-Werte dürfen sich innerhalb eines Batches nicht wiederholen. Jeder Aufruf in einem Batch wird als eigener Aufruf gemessen. Der Request-Body darf bis zu 1 MiB groß sein. Batches werden an /jsonrpc gesendet. Eine Anfrage an die TRON HTTP API enthält einen Aufruf und wird als ein Aufruf gemessen.

Token-Nutzung

Die Nutzung wird in Token gemessen, und der Token-Satz kann je nach Methode unterschiedlich sein. Jeder Aufruf in einem HTTP-Batch wird separat gemessen. Jede Anfrage an die TRON HTTP API wird als ein Aufruf gemessen.

Limits des Free-Plans

Beim Free-Plan kann Ihr Konto eine Anfrage pro 10 Sekunden senden. Das Limit wird pro Konto gezählt, nicht pro Endpoint, sodass auch eine Anfrage an eine andere Chain darauf angerechnet werden kann. Eine Anfrage, die früher gesendet wird, wird mit HTTP 429 beantwortet, und der retry-after-Header gibt die Wartezeit in Sekunden an.
Beim Free-Plan wird eine Anfrage, die zwei oder mehr JSON-RPC-Aufrufe enthält, mit HTTP 429 beantwortet, und keiner ihrer Aufrufe wird gesendet: Jeder Aufruf erhält einen JSON-RPC-Fehler mit dem Code -32041. Senden Sie diese Aufrufe stattdessen einzeln.

Unterstützte Methoden

Der Endpoint bedient diese 38 Methoden. Die Methoden eth_*, net_* und web3_* sind JSON-RPC-Aufrufe an / oder /jsonrpc. Die Einträge /wallet/* und /walletsolidity/* sind Pfade der TRON HTTP API, die mit einem JSON-Objekt als POST-Body aufgerufen werden.
  • 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
Eine nicht aufgeführte Methode oder ein nicht aufgeführter Pfad wird mit HTTP 400 beantwortet.

Antwort-Statuscodes

HTTP-StatusBedeutung
200Upstream JSON-RPC-Antwort. Auch ein JSON-RPC-Fehler wird mit HTTP 200 zurückgegeben: Er behält die id der Anfrage und den error.code, seine error.message lautet ERPC upstream error, und error.data wird nicht zurückgegeben.
400Eine Methode oder ein Pfad außerhalb der Liste der unterstützten Methoden, eine ungültige JSON-RPC-Anfrage, ein leerer Batch oder ein Batch mit mehr als 100 Aufrufen, eine doppelte id in einem Batch oder ein Body über 1 MiB.
401Fehlender oder ungültiger API key, oder eine IP- oder Origin-Beschränkung des Keys ist nicht erfüllt.
405Eine andere Request-Methode als POST.
426Ein WebSocket-Upgrade wurde angefordert. Der Endpoint unterstützt nur HTTP.
429Rate-limitiert, einschließlich der oben genannten Limits des Free-Plans: mehr als eine Anfrage pro 10 Sekunden oder zwei oder mehr Aufrufe in einer Anfrage. Wenn ein retry-after-Header vorhanden ist, warten Sie so viele Sekunden, wie dort angegeben.
502Die Upstream-Anfrage konnte nicht abgeschlossen werden: eine fehlgeschlagene Upstream-Antwort, eine Antwort über 8 MiB oder keine Antwort innerhalb von 30 Sekunden. Eine Antwort der TRON HTTP API, die einen Fehler meldet, wird ebenfalls mit 502 beantwortet.
503Der Dienst ist vorübergehend nicht verfügbar.

TRON RPC Methoden und Dokumentation

Die vollständige Liste der Standardmethoden, Parameter und Spezifikationen finden Sie in der offiziellen Dokumentation.
https://developers.tron.network/reference/full-node-api-overview

Zurück

TRON RPC - Schnellstart

Weiter

ERPC AI