ERPC

Dokumentasi TRON RPC Endpoint | ERPC

Dokumentasi TRON RPC Endpoint

Gunakan ERPC sebagai endpoint RPC TRON Anda untuk HTTP JSON-RPC request dan TRON HTTP API. TRON RPC adalah bagian dari RPC APIs ERPC di dalam Global Edge Blockchain Infrastructure kami, dan API key dapat dikelola dari ERPC Web Dashboard.
Anda dapat menggunakan RPC key yang sama dengan Solana, Ethereum, dan Avalanche.
Kirim API key Anda di query parameter api-key, atau kirim sebagai Authorization: Bearer <YOUR_API_KEY>. Jika keduanya ada, yang digunakan adalah query parameter.

Endpoint

Kirim request JSON-RPC 2.0 sebagai HTTP POST ke:
text
https://edge.erpc.global/tron?api-key=<YOUR_API_KEY>
atau ke host khusus:
text
https://tron.erpc.global?api-key=<YOUR_API_KEY>
Pada host khusus, / dan /jsonrpc mengarah ke endpoint JSON-RPC yang sama, dan TRON HTTP API dilayani di bawah /wallet/<name> dan /walletsolidity/<name>. Pada edge.erpc.global, path yang sama mengikuti prefix /tron: /tron, /tron/jsonrpc, /tron/wallet/<name>, dan /tron/walletsolidity/<name>. Body POST TRON HTTP API harus berupa object JSON. Path lain dijawab dengan HTTP 400.

Contoh

Berikut adalah contoh HTTP request dengan API key di 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"
}'
Berikut adalah request yang sama dengan API key di header 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"
}'
Berikut adalah contoh TRON HTTP API.
bash
curl 'https://edge.erpc.global/tron/wallet/getnowblock?api-key=<YOUR_API_KEY>' --header 'Content-Type: application/json' --data '{}'
Anda dapat membuat dan memeriksa API key Anda di ERPC Web Dashboard: ERPC Web Dashboard

Batch Request

JSON-RPC batch berisi 1 hingga 100 panggilan per HTTP request didukung. Setiap panggilan memerlukan id sendiri, dan nilai id tidak boleh berulang dalam satu batch. Setiap panggilan dalam satu batch diukur sebagai panggilan tersendiri. Body request maksimal 1 MiB. Batch dikirim ke /jsonrpc. Request TRON HTTP API membawa satu panggilan dan diukur sebagai satu panggilan.

Pengukuran Penggunaan

Penggunaan diukur dalam token, dan tarif token dapat berbeda per method. Setiap panggilan dalam satu HTTP batch diukur secara terpisah. Setiap request TRON HTTP API diukur sebagai satu panggilan.

Batas Paket Free

Pada Paket Free, akun Anda dapat mengirim satu request per 10 detik. Batas ini dihitung per akun, bukan per endpoint, sehingga request ke chain lain juga dapat dihitung ke dalam batas tersebut. Request yang dikirim lebih cepat dijawab dengan HTTP 429, dan header retry-after memberikan waktu tunggu dalam detik.
Pada Paket Free, request yang membawa dua panggilan JSON-RPC atau lebih dijawab dengan HTTP 429, dan tidak ada satu pun panggilannya yang dikirim: setiap panggilan mendapat error JSON-RPC dengan kode -32041. Kirim panggilan-panggilan ini satu per satu.

Method yang Didukung

Endpoint ini melayani 38 method berikut. Method eth_*, net_*, dan web3_* adalah panggilan JSON-RPC yang dikirim ke / atau /jsonrpc. Entri /wallet/* dan /walletsolidity/* adalah path TRON HTTP API, yang dipanggil dengan object JSON sebagai body 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
Method atau path yang tidak tercantum dijawab dengan HTTP 400.

Kode Status Response

HTTP statusArti
200Response JSON-RPC dari upstream. Error JSON-RPC juga dikembalikan dengan HTTP 200: id request dan error.code tetap dipertahankan, error.message berisi ERPC upstream error, dan error.data tidak dikembalikan.
400Method atau path di luar daftar Method yang Didukung, request JSON-RPC tidak valid, batch kosong atau batch lebih dari 100 panggilan, id duplikat dalam satu batch, atau body lebih dari 1 MiB.
401API key tidak ada atau tidak valid, atau pembatasan IP atau Origin pada key tidak terpenuhi.
405Request dengan method HTTP selain POST.
426WebSocket Upgrade diminta. Endpoint ini hanya mendukung HTTP.
429Dibatasi rate, termasuk batas Paket Free di atas: lebih dari satu request per 10 detik, atau dua panggilan atau lebih dalam satu request. Jika ada header retry-after, tunggu selama jumlah detik yang disebutkan.
502Request upstream tidak dapat diselesaikan: response upstream gagal, response lebih dari 8 MiB, atau tidak ada jawaban dalam 30 detik. Response TRON HTTP API yang melaporkan kegagalan juga dijawab dengan 502.
503Layanan tidak tersedia sementara.

Metode dan Dokumentasi TRON RPC

Untuk daftar lengkap metode standar, parameter, dan spesifikasi, lihat dokumentasi resmi.
https://developers.tron.network/reference/full-node-api-overview

Sebelumnya

TRON RPC Quickstart | ERPC

Berikutnya

ERPC AI