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

> Source: https://docs.blockvectra.com/ru/guides/agent-frameworks/

Настройте блокчейн RPC в ElizaOS, viem, wagmi или Coinbase AgentKit с помощью приведенных ниже примеров. Разработчики и AI Agent могут сначала использовать [MCP документации](https://docs.blockvectra.com/ru/guides/ai-agents/#connecting-from-mcp-clients) для обнаружения методов и документации, а затем выполнить отдельную [процедуру регистрации по HTTP](https://docs.blockvectra.com/ru/guides/programmatic-signup/) для создания API key. Используйте этот ключ в запросах к RPC и Data API или в заголовке `x-api-key` MCP-клиента для инструментов, требующих ключ; доступ к RPC без ключа ограничен `public.methods` каждой сети.

## ElizaOS

* Официальная документация: [elizaOS Documentation](https://elizaos.github.io/eliza/)
* Официальный репозиторий: [elizaos/eliza](https://github.com/elizaos/eliza)

В elizaOS взаимодействие с EVM обрабатывается плагином `@elizaos/plugin-evm`. Плагин считывает эндпоинты RPC-провайдеров из переменных окружения с шаблоном имени `ETHEREUM_PROVIDER_<NETWORK>` или резервной переменной `EVM_PROVIDER_URL`.

Настройте файл `.env`, указав приватный ключ кошелька и эндпоинты RPC:

```bash
# 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` в конфигурацию персонажа агента:

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

## viem

* Официальная документация: [viem Documentation](https://viem.sh/docs/clients/public.html)
* Справочник по транспортам: [viem HTTP Transport](https://viem.sh/docs/clients/transports/http.html) и [viem WebSocket Transport](https://viem.sh/docs/clients/transports/websocket.html)
* Официальный репозиторий: [wevm/viem](https://github.com/wevm/viem)

В viem транспорты клиента настраиваются с помощью `http()` или `webSocket()`.

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

```typescript
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:

```typescript
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`):

```typescript
import { createPublicClient, webSocket } from "viem";

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

Параметры подключения и типы подписок описаны в [руководстве по WebSocket-подпискам](https://docs.blockvectra.com/ru/guides/websocket-subscriptions/).

## wagmi

* Официальная документация: [wagmi createConfig](https://wagmi.sh/core/api/createConfig) и [wagmi HTTP Transport](https://wagmi.sh/core/api/transports/http)
* Официальный репозиторий: [wevm/wagmi](https://github.com/wevm/wagmi)

В wagmi передайте RPC URL BlockVectra в карту `transports` внутри `createConfig`.

### Конфигурация с API key

```typescript
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}`),
  },
});
```

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

```typescript
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](https://docs.cdp.coinbase.com/agentkit/docs/welcome)
* Официальный репозиторий: [coinbase/agentkit](https://github.com/coinbase/agentkit)

Coinbase AgentKit использует провайдеры кошельков для выполнения ончейн-действий. В TypeScript `ViemWalletProvider` из `@coinbase/agentkit` оборачивает стандартный `WalletClient` viem, позволяя направлять выполнение транзакций и RPC-запросы через эндпоинты BlockVectra.

### Конфигурация с ViemWalletProvider

```typescript
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-клиентов](https://docs.blockvectra.com/ru/guides/ai-agents/#connecting-from-mcp-clients) руководства по ИИ-агентам.

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

* [Подключите ИИ-агента](https://docs.blockvectra.com/ru/guides/ai-agents/) для обнаружения эндпоинтов с помощью MCP, llms.txt и OpenAPI.
* [Следуйте руководству по программной регистрации](https://docs.blockvectra.com/ru/guides/programmatic-signup/), чтобы зарегистрироваться и создать API key с помощью подписи кошелька, или [войдите в консоль](https://console.blockvectra.com/login/?next=%2Fkeys%2F) для создания ключа.
* [Правила тарификации](https://docs.blockvectra.com/ru/guides/billing-rules/) для ознакомления с учетом Compute Units (CU), лимитами запросов и нетарифицируемыми ошибками.