Dokumentasi Base RPC Endpoint | ERPC

Dokumentasi Base RPC Endpoint

Gunakan ERPC sebagai endpoint RPC Base Anda untuk HTTP JSON-RPC request dan WebSocket subscription. Base 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.
Tambahkan API key Anda ke parameter api-key.

Endpoint

Kirim request JSON-RPC 2.0 sebagai HTTP POST ke:
text
https://base.erpc.global?api-key=<YOUR_API_KEY>
Untuk subscription, hubungkan melalui WebSocket ke:
text
wss://base.erpc.global?api-key=<YOUR_API_KEY>
Request hanya diterima di /.

Contoh

Berikut adalah contoh HTTP request.
bash
curl 'https://base.erpc.global?api-key=<YOUR_API_KEY>' --header 'Content-Type: application/json' --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 hingga 256 panggilan per HTTP request didukung. Setiap panggilan dalam satu batch diukur sebagai panggilan tersendiri.

Pengukuran Penggunaan

Penggunaan diukur dalam token per panggilan JSON-RPC. Setiap entri dalam satu HTTP batch dan setiap panggilan JSON-RPC yang dikirim melalui koneksi WebSocket 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.
Pada Paket Free, koneksi WebSocket tidak tersedia dan dijawab dengan HTTP 403.

Method yang Didukung

Base kompatibel dengan EVM dan menggunakan method JSON-RPC yang sama dengan Ethereum. ERPC tidak menerapkan allowlist method yang tetap pada endpoint Base. Untuk keluarga method Ethereum, lihat Dokumentasi Ethereum RPC Endpoint.

Kode Status Response

HTTP statusArti
200Response JSON-RPC dari upstream.
400Missing API key, Invalid JSON-RPC request, atau JSON-RPC batch exceeds 256 calls.
401Unauthorized API KEY.
403Koneksi WebSocket pada Paket Free.
404Path selain /.
429Dibatasi rate, termasuk batas Paket Free di atas: lebih dari satu request per 10 detik, atau dua panggilan atau lebih dalam satu request. Header retry-after menunjukkan waktu tunggu dalam detik.
502Request RPC upstream tidak dapat diselesaikan.
503Layanan tidak tersedia sementara.
Koneksi WebSocket menggunakan 101 (peningkatan protokol diterima) selain kode di atas.

Metode dan Dokumentasi Base RPC

Untuk daftar lengkap metode standar, parameter, dan spesifikasi, lihat dokumentasi resmi.