URL RPC Base: akses tanpa API key serta contoh curl dan viem

Mulailah dengan URL RPC publik mainnet Base di bawah untuk membaca chain ID tanpa API key. Periksa metode yang didukung dan batas per IP di halaman rantai Base; gunakan API key untuk metode di luar public.methods yang diizinkan rantai tersebut.

curl -sS "https://api.blockvectra.com/v1/base_mainnet/public" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"eth_chainId","params":[]}'

Informasi jaringan dan endpoint

Setiap permintaan ke Base secara eksplisit mengidentifikasi jaringan tujuannya pada path URL menggunakan slug base_mainnet. JSON-RPC mendukung autentikasi API key berbasis path maupun autentikasi melalui header permintaan (x-api-key).

Contoh langsung curl dan viem

Anda dapat melakukan panggilan JSON-RPC langsung menggunakan curl atau pustaka klien web3 seperti viem. Atur API key Anda dalam variabel lingkungan BLOCKVECTRA_API_KEY:

curl -s "https://api.blockvectra.com/v1/base_mainnet" \
  -H "Content-Type: application/json" \
  -H "x-api-key: $BLOCKVECTRA_API_KEY" \
  -d '{"jsonrpc":"2.0","id":1,"method":"eth_chainId","params":[]}'

Struktur respons

Respons mengikuti spesifikasi JSON-RPC 2.0:

• Berhasil: Mengembalikan objek berisi jsonrpc: "2.0", integer id yang sesuai, dan result dalam encoding heksadesimal (eth_chainId mengembalikan chain ID dalam encoding heksadesimal; eth_blockNumber mengembalikan tinggi blok terbaru).
• Metode tidak diizinkan: Meminta metode di luar metode yang diizinkan jaringan mengembalikan kode error JSON-RPC -32601 (method not available, tidak ditagih).
• Kueri di luar jendela: Permintaan state historis yang lebih awal dari jendela retensi state mengembalikan kode error JSON-RPC -32011 (tidak ditagih).
• API key tidak disertakan: Tidak menyertakan API key mengembalikan HTTP 401 dengan kode error JSON-RPC -32024 (missing_api_key, tidak ditagih).
• Parameter tidak valid: Parameter permintaan dengan format yang salah mengembalikan kode error JSON-RPC -32602 (tidak ditagih).

Kapabilitas dan kebijakan metode

Nilai terkini: GET /v1/chains (methods, max_logs_block_range, state_window_blocks).

Blockchain Data API

Nilai terkini: GET /v1/chains (data).

Memulai dan API key

• Konsol web: Daftar melalui tanda tangan dompet Ethereum, lalu buat API key di Konsol. Lihat panduan mulai cepat untuk detail penyiapan.
• Pendaftaran terprogram: AI Agent otonom, skrip otomatis, dan pipeline CI dapat masuk dan membuat API key menggunakan tanda tangan dompet Ethereum (EIP-191) tanpa browser. Ikuti panduan pendaftaran terprogram.
• AI Agent: AI Agent otonom dapat menemukan kapabilitas Base menggunakan server Model Context Protocol (MCP) resmi. Lihat Menghubungkan AI Agent ke BlockVectra.
• Meningkatkan batas: Setelah top up, batas panggilan per detik di seluruh akun dihapus; setiap API key tetap tunduk pada batas laju dan burst Compute Unit (CU). Untuk tarif dan unit penagihan terkini, lihat halaman Harga.

Panduan dan sumber daya terkait

• Dokumentasi pengembang Base: Untuk spesifikasi jaringan, mekanisme gas, dan kontrak di Base, lihat dokumentasi Base resmi.
• RPC kustom dompet: Konfigurasikan endpoint RPC kustom untuk Base di MetaMask dan Rabby menggunakan panduan RPC kustom dompet.
• Simulasi transaksi: Uji eksekusi transaksi dan evaluasi perubahan state sebelum menyiarkannya menggunakan eth_simulateV1 dalam panduan simulasi transaksi.

Langkah selanjutnya

• Telusuri direktori dataset untuk melihat setiap dataset yang diindeks oleh BlockVectra.
• Lihat paket gratis dan harga untuk memeriksa apa yang termasuk dalam akun Anda.
• Masuk ke konsol untuk membuat API key.