ERPC

ERPC TRON RPC エンドポイント ドキュメント

TRON RPC エンドポイント ドキュメント

ERPC を TRON RPC エンドポイントとして、HTTP JSON-RPC リクエストと TRON HTTP API にご利用いただけます。TRON RPC は、Global Edge Blockchain Infrastructure における ERPC の RPC APIs の一部であり、API key は ERPC Web Dashboard から管理できます。
Solana、Ethereum、Avalanche と同じ RPC キーを利用できます。
API key は api-key クエリパラメータで渡すか、Authorization: Bearer <YOUR_API_KEY> として送信してください。両方が指定された場合は、クエリパラメータが使われます。

エンドポイント

JSON-RPC 2.0 リクエストは、次の URL に対して HTTP POST で送信します。
text
https://edge.erpc.global/tron?api-key=<YOUR_API_KEY>
または、次の専用ホストに送信します。
text
https://tron.erpc.global?api-key=<YOUR_API_KEY>
専用ホストでは、/ と /jsonrpc は同じ JSON-RPC エンドポイントにつながり、TRON HTTP API は /wallet/<name> と /walletsolidity/<name> の下で提供されます。edge.erpc.global では、同じパスに /tron プレフィックスが付きます: /tron、/tron/jsonrpc、/tron/wallet/<name>、/tron/walletsolidity/<name>。TRON HTTP API の POST のボディは JSON オブジェクトである必要があります。それ以外のパスには HTTP 400 が返されます。

使用例

API key をクエリパラメータで指定した HTTP リクエストの例です。
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"
}'
API key を 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"
}'
TRON HTTP API の例です。
bash
curl 'https://edge.erpc.global/tron/wallet/getnowblock?api-key=<YOUR_API_KEY>' --header 'Content-Type: application/json' --data '{}'
API key は ERPC Web Dashboard 上にて取得、確認いただけます: ERPC Web Dashboard

バッチリクエスト

1 回の HTTP リクエストにつき 1〜100 件の呼び出しを含む JSON-RPC バッチに対応しています。各呼び出しにはそれぞれ id が必要で、バッチ内で id の値を重複させることはできません。バッチ内の各呼び出しは、それぞれ個別の呼び出しとして計測されます。リクエストボディの上限は 1 MiB です。バッチは /jsonrpc に送信します。TRON HTTP API リクエストは 1 件につき呼び出し 1 回分で、1 回の呼び出しとして計測されます。

利用量の計測

利用量は token として計測され、token レートはメソッドによって異なる場合があります。HTTP バッチ内の各呼び出しは、それぞれ個別に計測されます。TRON HTTP API リクエストは 1 件ごとに 1 回の呼び出しとして計測されます。

Free プランの制限

Free プランでは、お使いのアカウントから送信できるのは 10 秒に 1 リクエストまでです。この制限はエンドポイントごとではなくアカウントごとに数えられるため、別のチェーンへのリクエストも数えられることがあります。それより早く送ったリクエストには HTTP 429 が返され、retry-after ヘッダーに待機する秒数が示されます。
Free プランでは、2 件以上の JSON-RPC 呼び出しを含むリクエストには HTTP 429 が返され、そのリクエストの呼び出しはどれも送信されません。それぞれの呼び出しには、コード -32041 の JSON-RPC エラーが返されます。代わりに、これらの呼び出しを 1 件ずつ送信してください。

対応メソッド

本エンドポイントは、次の 38 個のメソッドを提供します。eth_*、net_*、web3_* のメソッドは、/ または /jsonrpc に送る JSON-RPC 呼び出しです。/wallet/* と /walletsolidity/* の項目は TRON HTTP API のパスで、POST のボディに JSON オブジェクトを指定して呼び出します。
  • 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
一覧にないメソッドまたはパスには HTTP 400 が返されます。

レスポンスステータスコード

HTTP ステータス意味
200アップストリームの JSON-RPC レスポンス。JSON-RPC エラーも HTTP 200 で返されます。リクエストの id と error.code はそのまま保たれ、error.message は ERPC upstream error になり、error.data は返されません
400「対応メソッド」にないメソッドまたはパス、無効な JSON-RPC リクエスト、空のバッチまたは 100 件を超えるバッチ、バッチ内の重複した id、1 MiB を超えるリクエストボディ
401API key が未指定または無効、もしくはキーに設定された IP・Origin の制限を満たしていません
405POST 以外のリクエストメソッド
426WebSocket Upgrade が要求されました。このエンドポイントは HTTP 専用です
429レート制限。上記の Free プランの制限（10 秒に 1 リクエストを超える送信、または 1 回のリクエストに 2 件以上の呼び出し）も対象です。retry-after ヘッダーがある場合は、示された秒数だけ待機してください
502アップストリームへのリクエストを完了できませんでした（アップストリームの応答が失敗した、応答が 8 MiB を超えた、または 30 秒以内に応答がなかった）。TRON HTTP API のレスポンスが失敗を示している場合も 502 が返されます
503サービスが一時的に利用できません

TRON RPC メソッドとドキュメント

標準メソッド、パラメータ、仕様の全一覧については、公式ドキュメントをご参照ください。
https://developers.tron.network/reference/full-node-api-overview

前へ

ERPC TRON RPC クイックスタート

次へ

ERPC AI