Блокчейн-RPC та docs MCP для фреймворків агентів

Налаштовуйте блокчейн-RPC в ElizaOS, viem, wagmi або Coinbase AgentKit за допомогою наведених нижче рецептів. Розробники та AI-агенти можуть спочатку скористатися docs MCP, щоб виявити методи та документацію, а потім виконати окремий процес реєстрації через HTTP, щоб створити API key. Використовуйте цей ключ у запитах до RPC та Data API або в заголовку x-api-key клієнта MCP для інструментів, що вимагають авторизації; доступ до RPC без ключа обмежений списком public.methods для кожної мережі.

ElizaOS

• Офіційна документація: elizaOS Documentation
• Офіційний репозиторій: elizaos/eliza

В elizaOS взаємодія з EVM обробляється плагіном @elizaos/plugin-evm. Плагін зчитує ендпоінти RPC-провайдерів зі змінних середовища за шаблоном ETHEREUM_PROVIDER_<NETWORK> або резервної змінної EVM_PROVIDER_URL.

Налаштуйте ваш файл .env, вказавши приватний ключ гаманця та ендпоінти RPC:

# EVM wallet private key for signing transactions
export EVM_PRIVATE_KEY=0x...

# Dedicated endpoints with API key
export ETHEREUM_PROVIDER_ETHEREUM=https://api.blockvectra.com/v1/eth_mainnet/${BLOCKVECTRA_API_KEY}
export ETHEREUM_PROVIDER_BASE=https://api.blockvectra.com/v1/base_mainnet/${BLOCKVECTRA_API_KEY}

# Keyless public RPC endpoint
# export ETHEREUM_PROVIDER_ETHEREUM=https://api.blockvectra.com/v1/eth_mainnet/public

Додайте @elizaos/plugin-evm до конфігурації персонажа вашого агента:

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

viem

• Офіційна документація: viem Documentation
• Довідник з транспортів: viem HTTP Transport та viem WebSocket Transport
• Офіційний репозиторій: wevm/viem

У viem налаштовуйте транспорти клієнта за допомогою http() або webSocket().

HTTP-транспорт з API key

import { createPublicClient, http } from "viem";
import { mainnet } from "viem/chains";

export const client = createPublicClient({
  chain: mainnet,
  transport: http(`https://api.blockvectra.com/v1/eth_mainnet/${process.env.BLOCKVECTRA_API_KEY}`),
});

HTTP-транспорт із публічним ендпоінтом без ключа

Для запитів на читання за дозволеними публічними методами без API key:

import { createPublicClient, http } from "viem";
import { mainnet } from "viem/chains";

export const publicClient = createPublicClient({
  chain: mainnet,
  transport: http("https://api.blockvectra.com/v1/eth_mainnet/public"),
});

WebSocket-транспорт

WebSocket-транспорт (webSocket(...)) підтримується на мережах із ws: true у GET /v1/chains, наприклад у Robinhood Chain (robinhood_mainnet):

import { createPublicClient, webSocket } from "viem";

export const wsClient = createPublicClient({
  transport: webSocket(`wss://api.blockvectra.com/v1/robinhood_mainnet/${process.env.BLOCKVECTRA_API_KEY}`),
});

Параметри підключення та типи підписок див. у посібнику з WebSocket-підписок.

wagmi

• Офіційна документація: wagmi createConfig та wagmi HTTP Transport
• Офіційний репозиторій: wevm/wagmi

У wagmi передавайте URL блокчейн-RPC від BlockVectra до мапи transports всередині createConfig.

Конфігурація з API key

import { createConfig, http } from "wagmi";
import { mainnet } from "wagmi/chains";

export const config = createConfig({
  chains: [mainnet],
  transports: {
    [mainnet.id]: http(`https://api.blockvectra.com/v1/eth_mainnet/${process.env.BLOCKVECTRA_API_KEY}`),
  },
});

Конфігурація з публічним ендпоінтом без ключа

import { createConfig, http } from "wagmi";
import { mainnet } from "wagmi/chains";

export const config = createConfig({
  chains: [mainnet],
  transports: {
    [mainnet.id]: http("https://api.blockvectra.com/v1/eth_mainnet/public"),
  },
});

Coinbase AgentKit

• Офіційна документація: Coinbase AgentKit Documentation
• Офіційний репозиторій: coinbase/agentkit

Coinbase AgentKit використовує провайдери гаманців для виконання ончейн-дій. У TypeScript ViemWalletProvider із @coinbase/agentkit огортає стандартний WalletClient із viem, дозволяючи вам маршрутизувати виконання транзакцій та RPC-запити через ендпоінти BlockVectra.

Конфігурація з ViemWalletProvider

import { AgentKit, ViemWalletProvider } from "@coinbase/agentkit";
import { createWalletClient, http } from "viem";
import { privateKeyToAccount } from "viem/accounts";
import { mainnet } from "viem/chains";

const account = privateKeyToAccount(process.env.WALLET_PRIVATE_KEY as `0x${string}`);

const client = createWalletClient({
  account,
  chain: mainnet,
  transport: http(`https://api.blockvectra.com/v1/eth_mainnet/${process.env.BLOCKVECTRA_API_KEY}`),
});

const walletProvider = new ViemWalletProvider(client);

export const agentKit = await AgentKit.from({
  walletProvider,
});

Для операцій читання за дозволеними методами налаштуйте http("https://api.blockvectra.com/v1/eth_mainnet/public").

Віддалений MCP

Якщо ваш агент підключається через Model Context Protocol (Streamable HTTP MCP), підключіться до ендпоінта MCP-сервера BlockVectra:

https://docs.blockvectra.com/mcp

Інструкції з налаштування клієнтів для Claude Code, Cursor, VS Code, Codex, Gemini CLI, OpenAI Responses API та Windsurf див. у розділі Підключення з MCP-клієнтів у посібнику з AI-агентів.

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

• Підключіть AI-агента, щоб виявляти ендпоінти за допомогою MCP, llms.txt та OpenAPI.
• Дотримуйтесь посібника з програмної реєстрації, щоб зареєструватися та створити API key за допомогою підпису гаманця, або увійдіть до консолі, щоб створити ключ.
• Правила білінгу, щоб ознайомитися з обліком Compute Units (CU), лімітами швидкості та помилками, що не тарифікуються.