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

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

Налаштовуйте блокчейн-RPC в ElizaOS, viem, wagmi або Coinbase AgentKit за допомогою наведених нижче рецептів. Розробники та AI-агенти можуть спочатку скористатися [docs MCP](https://docs.blockvectra.com/en/guides/ai-agents/#connecting-from-mcp-clients), щоб виявити методи та документацію, а потім виконати окремий [процес реєстрації через HTTP](https://docs.blockvectra.com/en/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/en/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 передавайте URL блокчейн-RPC від 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/en/guides/ai-agents/#connecting-from-mcp-clients) у посібнику з AI-агентів.

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

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