Блокчейн RPC и MCP документации для фреймворков агентов

Настройте блокчейн RPC в ElizaOS, viem, wagmi или Coinbase AgentKit с помощью приведенных ниже примеров. Разработчики и AI Agent могут сначала использовать 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 передайте RPC URL 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-клиентов руководства по ИИ-агентам.

Следующие шаги

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