Gunakan RPC blockchain di Agent ElizaOS dengan BlockVectra

Agent ElizaOS terhubung ke chain EVM melalui @elizaos/plugin-evm, yang membaca URL RPC-nya dari lingkungan. Atur EVM_PROVIDER_URL ke https://api.blockvectra.com/v1/eth_mainnet/public dan plugin akan memakai BlockVectra untuk Ethereum mainnet tanpa API key. Paket Gratis menambahkan metode yang memerlukan API key dengan 30,000,000 CU per jendela 30 hari. Diperiksa pada 2026-10-11.

# .env (the plugin also needs the wallet key; keep it in your secret store)
EVM_PRIVATE_KEY=your-wallet-private-key
EVM_PROVIDER_URL=https://api.blockvectra.com/v1/eth_mainnet/public
ETHEREUM_PROVIDER_BASE=https://api.blockvectra.com/v1/base_mainnet/public

{
  "name": "DeFiAgent",
  "plugins": ["@elizaos/plugin-evm"],
  "settings": { "chains": { "evm": ["base"] } }
}

Instal plugin dengan bun add @elizaos/plugin-evm. Ethereum mainnet aktif secara default; setiap chain lain yang Anda cantumkan di settings.chains.evm harus memakai nama ekspor viem/chains-nya, dan variabel URL-nya adalah ETHEREUM_PROVIDER_<CHAIN_NAME> dalam huruf kapital, seperti di README plugin di npm.

Gunakan API key

Endpoint publik hanya mencakup metode dalam public.methods setiap chain. Untuk metode lainnya, letakkan API key di path URL (/v1/{chain}/{api_key}). Plugin hanya menerima URL, sehingga ini satu-satunya tempat API key dikirim lewat path. Ekspor variabel di shell yang memulai Agent agar API key tidak pernah masuk ke file yang Anda commit:

export EVM_PROVIDER_URL=https://api.blockvectra.com/v1/eth_mainnet/${BLOCKVECTRA_API_KEY}
export ETHEREUM_PROVIDER_BASE=https://api.blockvectra.com/v1/base_mainnet/${BLOCKVECTRA_API_KEY}

URL dapat muncul di log, proxy, dan pesan error, jadi gunakan API key terpisah dengan cu_cap rendah untuk Agent, dan cabut di konsol jika bocor.

Untuk membuat API key tanpa browser, ikuti empat langkah dalam panduan pendaftaran terprogram: challenge, tanda tangan, login, lalu POST /keys. Pengembang juga dapat membuat API key di konsol. API key yang sama berlaku di semua chain, sehingga satu API key melayani setiap variabel ETHEREUM_PROVIDER_*.

Tambahkan server MCP dokumentasi

@elizaos/plugin-mcp memungkinkan karakter memakai server MCP jarak jauh melalui Streamable HTTP. Instal dengan bun add @elizaos/plugin-mcp, lalu daftarkan server dokumentasi BlockVectra di pengaturan karakter:

{
  "plugins": ["@elizaos/plugin-evm", "@elizaos/plugin-mcp"],
  "settings": {
    "mcp": {
      "servers": {
        "blockvectra": { "type": "streamable-http", "url": "https://docs.blockvectra.com/mcp" }
      }
    }
  }
}

Agent kemudian dapat memanggil list_chains, get_status, rpc_call, read_doc, dan alat lain yang tercantum di halaman server MCP, tanpa API key. Opsi HTTP yang didokumentasikan plugin adalah type, url, dan timeout; plugin tidak mendokumentasikan opsi header, sehingga alat MCP yang memerlukan API key tidak dapat dijangkau dari konfigurasi ini. Tetap lakukan pembacaan yang memerlukan API key di plugin-evm seperti di atas.

Error yang mungkin Anda lihat

Setiap error BlockVectra memuat data.reason dan docs_url; daftar lengkapnya ada di halaman error.

Dokumentasi resmi

• Dokumentasi ElizaOS
• elizaos/eliza di GitHub
• @elizaos/plugin-evm di npm
• @elizaos/plugin-mcp di npm

Pertanyaan umum

Apakah EVM_PROVIDER_URL berlaku untuk Base? Tidak. Variabel ini hanya mengatur Ethereum mainnet; chain lain memakai ETHEREUM_PROVIDER_<CHAIN_NAME>.

Dapatkah Agent menandatangani dan mengirim transaksi melalui endpoint publik? eth_sendRawTransaction ada di public.methods untuk chain yang mencantumkannya, dengan batas laju per IP sendiri yang lebih rendah di public.send_raw_rate_limit dalam GET /v1/chains. Baca batasnya di sana sebelum membangun di atasnya.

Apakah saya memerlukan API key untuk server MCP? Tidak. Terhubung serta alat dokumentasi, chain, dan harga tidak memerlukan API key.

Langkah selanjutnya

• Ikhtisar framework Agent untuk LangChain, viem, wagmi, dan Coinbase AgentKit.
• Hubungkan AI Agent untuk menemukan endpoint dengan MCP, llms.txt, dan OpenAPI.
• Aturan penagihan untuk pengukuran CU, batas laju, dan error yang tidak ditagih.