Блокчейн-RPC в агентах ElizaOS з BlockVectra

Агенти ElizaOS працюють з EVM-мережами через @elizaos/plugin-evm, який читає свої RPC URL зі змінних середовища. Задайте EVM_PROVIDER_URL як https://api.blockvectra.com/v1/eth_mainnet/public, і плагін використовуватиме BlockVectra для Ethereum mainnet без API key. Безкоштовний план додає методи з ключем: 30,000,000 CU на 30-денне вікно. Перевірено 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"] } }
}

Встановіть плагін через bun add @elizaos/plugin-evm. Ethereum mainnet увімкнено за замовчуванням; кожна інша мережа в settings.chains.evm має називатися так, як її експортує viem/chains, а змінна з її URL — ETHEREUM_PROVIDER_<CHAIN_NAME> у верхньому регістрі, як описано в README плагіна на npm.

Використання API key

Публічні ендпоінти покривають лише методи з public.methods кожної мережі. Для решти вкажіть ключ у шляху URL (/v1/{chain}/{api_key}). Плагін приймає лише URL, тому це єдине місце, де ключ передається в шляху. Експортуйте змінні в оболонці, яка запускає агента, щоб ключ не потрапив у файл, який ви комітите:

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 можуть потрапляти в журнали, проксі та повідомлення про помилки, тож використовуйте для агента окремий ключ з низьким cu_cap і відкличте його в консолі, якщо він витече.

Щоб створити ключ без браузера, виконайте чотири кроки з посібника з програмної реєстрації: challenge, підпис, вхід, потім POST /keys. Розробники також можуть створити ключ у консолі. Той самий ключ працює в кожній мережі, тож один ключ обслуговує всі змінні ETHEREUM_PROVIDER_*.

Додайте docs MCP-сервер

@elizaos/plugin-mcp дає персонажу змогу використовувати віддалені MCP-сервери через Streamable HTTP. Встановіть його через bun add @elizaos/plugin-mcp, а потім зареєструйте docs-сервер BlockVectra в налаштуваннях персонажа:

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

Тоді агент може без ключа викликати list_chains, get_status, rpc_call, read_doc та інші інструменти зі сторінки MCP-сервера. Задокументовані HTTP-параметри плагіна: type, url і timeout; параметра для заголовків у документації немає, тому інструменти MCP з ключем із такої конфігурації недосяжні. Читання з ключем залишайте в plugin-evm, як описано вище.

Помилки, які ви можете побачити

Кожна помилка BlockVectra містить data.reason і docs_url; повний список — на сторінці помилок.

Офіційна документація

• Документація ElizaOS
• elizaos/eliza на GitHub
• @elizaos/plugin-evm на npm
• @elizaos/plugin-mcp на npm

Поширені запитання

Чи застосовується EVM_PROVIDER_URL до Base? Ні. Він задає лише Ethereum mainnet; інші мережі використовують ETHEREUM_PROVIDER_<CHAIN_NAME>.

Чи може агент підписувати й надсилати транзакції через публічний ендпоінт? eth_sendRawTransaction входить до public.methods для мереж, які його вказують, з окремим нижчим лімітом швидкості на IP у public.send_raw_rate_limit в GET /v1/chains. Перш ніж на нього спиратися, прочитайте цей ліміт там.

Чи потрібен ключ для MCP-сервера? Ні. Підключення та інструменти документації, мереж і цін працюють без ключа.

Наступні кроки

• Огляд фреймворків агентів для LangChain, viem, wagmi і Coinbase AgentKit.
• Підключення AI-агента для виявлення ендпоінтів через MCP, llms.txt і OpenAPI.
• Правила тарифікації щодо обліку CU, лімітів швидкості та помилок, що не тарифікуються.