BlockVectra ile ElizaOS agent'larında blokzincir RPC kullanın

ElizaOS agent'ları EVM zincirlerine, RPC URL'lerini ortamdan okuyan @elizaos/plugin-evm ile ulaşır. EVM_PROVIDER_URL değerini https://api.blockvectra.com/v1/eth_mainnet/public olarak ayarlayın; eklenti Ethereum mainnet için API key olmadan BlockVectra'yı kullanır. Ücretsiz Plan, 30 günlük pencere başına 30,000,000 CU ile anahtar gerektiren yöntemleri ekler. Kontrol tarihi 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"] } }
}

Eklentiyi bun add @elizaos/plugin-evm ile kurun. Ethereum mainnet varsayılan olarak etkindir; settings.chains.evm içinde listelediğiniz diğer her zincir viem/chains dışa aktarım adını kullanmalıdır ve URL değişkeni, eklentinin npm üzerindeki README dosyasında olduğu gibi büyük harfle ETHEREUM_PROVIDER_<CHAIN_NAME> biçimindedir.

Bir API key kullanın

Genel uç noktalar yalnızca her zincirin public.methods listesindeki yöntemleri kapsar. Gerisi için anahtarı URL yoluna koyun (/v1/{chain}/{api_key}). Eklenti yalnızca bir URL aldığı için, anahtarın yolda taşındığı tek yer burasıdır. Anahtarın commit ettiğiniz bir dosyaya düşmemesi için değişkenleri agent'ı başlatan kabukta dışa aktarın:

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'ler günlüklerde, proxy'lerde ve hata mesajlarında görünebilir; bu yüzden agent için düşük cu_cap değerli ayrı bir anahtar kullanın ve sızarsa konsoldan iptal edin.

Anahtarı tarayıcı olmadan oluşturmak için programatik kayıt rehberindeki dört adımı izleyin: challenge, imza, oturum açma, ardından POST /keys. Geliştiriciler ayrıca konsolda bir anahtar oluşturabilir. Aynı anahtar her zincirde çalışır; bu nedenle tek bir anahtar her ETHEREUM_PROVIDER_* değişkenine hizmet eder.

Belge MCP sunucusunu ekleyin

@elizaos/plugin-mcp, bir karakterin Streamable HTTP üzerinden uzak MCP sunucularını kullanmasını sağlar. bun add @elizaos/plugin-mcp ile kurun, ardından BlockVectra belge sunucusunu karakter ayarlarına kaydedin:

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

Agent artık anahtarsız olarak list_chains, get_status, rpc_call, read_doc ve MCP sunucusu sayfasında listelenen diğer araçları çağırabilir. Eklentinin belgelenmiş HTTP seçenekleri type, url ve timeout değerleridir; bir başlık seçeneği belgelenmediği için anahtar gerektiren MCP araçlarına bu yapılandırmadan ulaşılamaz. Anahtarlı okumaları yukarıdaki gibi plugin-evm içinde tutun.

Görebileceğiniz hatalar

Her BlockVectra hatası data.reason ve bir docs_url içerir; tam liste hatalar sayfasındadır.

Resmî belgeler

• ElizaOS belgeleri
• GitHub'da elizaos/eliza
• npm üzerinde @elizaos/plugin-evm
• npm üzerinde @elizaos/plugin-mcp

Sık sorulan sorular

EVM_PROVIDER_URL Base için de geçerli mi? Hayır. Yalnızca Ethereum mainnet'i ayarlar; diğer zincirler ETHEREUM_PROVIDER_<CHAIN_NAME> kullanır.

Bir agent genel uç nokta üzerinden işlem imzalayıp gönderebilir mi? eth_sendRawTransaction, onu listeleyen zincirlerde public.methods içindedir ve GET /v1/chains içindeki public.send_raw_rate_limit altında, IP başına daha düşük kendi hız sınırına sahiptir. Üzerine bir şey kurmadan önce sınırı oradan okuyun.

MCP sunucusu için anahtar gerekir mi? Hayır. Bağlanmak ile belge, zincir ve fiyatlandırma araçları anahtarsızdır.

Sonraki adımlar

• LangChain, viem, wagmi ve Coinbase AgentKit için Agent çerçevesi genel bakışı.
• MCP, llms.txt ve OpenAPI ile uç noktaları keşfetmek için bir AI Agent'ı bağlayın.
• CU ölçümü, hız sınırları ve faturalandırılmayan hatalar için faturalandırma kuralları.