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

> Source: https://docs.blockvectra.com/tr/guides/elizaos/

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.

```bash
# .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
```

```json
{
  "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](https://www.npmjs.com/package/@elizaos/plugin-evm) 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:

```bash
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](https://docs.blockvectra.com/tr/guides/programmatic-signup/?ref=docs-elizaos) dört adımı izleyin: challenge, imza, oturum açma, ardından `POST /keys`. Geliştiriciler ayrıca [konsolda bir anahtar oluşturabilir](https://console.blockvectra.com/login/?next=%2Fkeys%2F\&ref=docs-elizaos). 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:

```json
{
  "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](https://docs.blockvectra.com/tr/guides/mcp-server/) 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

| Yanıt                                 | Anlamı                                                                | Ne yapmalı                                                                          |
| ------------------------------------- | --------------------------------------------------------------------- | ----------------------------------------------------------------------------------- |
| HTTP 401, `-32024`, `missing_api_key` | Anahtar gerektiren URL anahtarsız çağrıldı                            | Anahtarı yola veya `x-api-key` başlığına koyun                                      |
| HTTP 401, `-32024`, `invalid_api_key` | Anahtar bilinmiyor, devre dışı veya iptal edilmiş                     | Anahtarı konsolda kontrol edin; yeni bir anahtarın etkinleşmesi birkaç saniye sürer |
| `-32601`, `method_not_public`         | Yöntem zincirin `public.methods` listesinde değil                     | O zincirin URL'sini `/public` biçiminden anahtarlı biçime geçirin                   |
| Chain not recognised                  | `settings.chains.evm` içindeki ad bir `viem/chains` adıyla eşleşmiyor | Tam `viem/chains` adını kullanın                                                    |

Her BlockVectra hatası `data.reason` ve bir `docs_url` içerir; tam liste [hatalar sayfasındadır](https://docs.blockvectra.com/tr/errors/).

## Resmî belgeler

* [ElizaOS belgeleri](https://elizaos.github.io/eliza/)
* [GitHub'da elizaos/eliza](https://github.com/elizaos/eliza)
* [npm üzerinde `@elizaos/plugin-evm`](https://www.npmjs.com/package/@elizaos/plugin-evm)
* [npm üzerinde `@elizaos/plugin-mcp`](https://www.npmjs.com/package/@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ışı](https://docs.blockvectra.com/tr/guides/agent-frameworks/).
* MCP, llms.txt ve OpenAPI ile uç noktaları keşfetmek için [bir AI Agent'ı bağlayın](https://docs.blockvectra.com/tr/guides/ai-agents/).
* CU ölçümü, hız sınırları ve faturalandırılmayan hatalar için [faturalandırma kuralları](https://docs.blockvectra.com/tr/guides/billing-rules/).