Dokumentasi Polygon RPC Endpoint | ERPC
Dokumentasi Polygon RPC Endpoint
Gunakan ERPC sebagai endpoint RPC Polygon Anda untuk HTTP JSON-RPC request. Polygon 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/polygon?api-key=<YOUR_API_KEY>https://edge.erpc.global/polygon?api-key=<YOUR_API_KEY>atau ke host khusus:
text
https://polygon.erpc.global?api-key=<YOUR_API_KEY>https://polygon.erpc.global?api-key=<YOUR_API_KEY>Request hanya diterima di
/.Contoh
Berikut adalah contoh HTTP request dengan API key di query parameter.
bash
curl 'https://edge.erpc.global/polygon?api-key=<YOUR_API_KEY>' --header 'Content-Type: application/json' --data '{
"jsonrpc":"2.0","id":1,
"method":"eth_blockNumber"
}'curl 'https://edge.erpc.global/polygon?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/polygon' --header 'Content-Type: application/json' --header 'Authorization: Bearer <YOUR_API_KEY>' --data '{
"jsonrpc":"2.0","id":1,
"method":"eth_blockNumber"
}'curl 'https://edge.erpc.global/polygon' --header 'Content-Type: application/json' --header 'Authorization: Bearer <YOUR_API_KEY>' --data '{
"jsonrpc":"2.0","id":1,
"method":"eth_blockNumber"
}'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.Pengukuran Penggunaan
Penggunaan diukur dalam token, dan tarif token dapat berbeda per method. Setiap panggilan dalam satu HTTP batch diukur secara terpisah.
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, dikelompokkan per namespace.
eth_*(24):eth_blockNumber,eth_call,eth_chainId,eth_estimateGas,eth_feeHistory,eth_gasPrice,eth_getBalance,eth_getBlockByHash,eth_getBlockByNumber,eth_getBlockReceipts,eth_getBlockTransactionCountByHash,eth_getBlockTransactionCountByNumber,eth_getCode,eth_getLogs,eth_getProof,eth_getStorageAt,eth_getTransactionByBlockHashAndIndex,eth_getTransactionByBlockNumberAndIndex,eth_getTransactionByHash,eth_getTransactionCount,eth_getTransactionReceipt,eth_maxPriorityFeePerGas,eth_sendRawTransaction,eth_syncingnet_*(3):net_listening,net_peerCount,net_versionweb3_*(2):web3_clientVersion,web3_sha3txpool_*(3):txpool_content,txpool_inspect,txpool_statusdebug_*(4):debug_traceBlockByHash,debug_traceBlockByNumber,debug_traceCall,debug_traceTransactiontrace_*(2):trace_block,trace_transaction
Method atau path yang tidak tercantum dijawab dengan HTTP
400.Kode Status Response
| HTTP status | Arti |
|---|---|
| 200 | Response 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. |
| 400 | Method 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. |
| 401 | API key tidak ada atau tidak valid, atau pembatasan IP atau Origin pada key tidak terpenuhi. |
| 405 | Request dengan method HTTP selain POST. |
| 426 | WebSocket Upgrade diminta. Endpoint ini hanya mendukung HTTP. |
| 429 | Dibatasi 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. |
| 502 | Request upstream tidak dapat diselesaikan: response upstream gagal, response lebih dari 8 MiB, atau tidak ada jawaban dalam 30 detik. |
| 503 | Layanan tidak tersedia sementara. |
Metode dan Dokumentasi Polygon RPC
Untuk daftar lengkap metode standar, parameter, dan spesifikasi, lihat dokumentasi resmi.