Agent 框架接入区块链 RPC 与文档 MCP

为LangChain、ElizaOS、AgentKit等AI Agent与开发框架配置区块链RPC:在.env文件写入端点与钱包私钥,用viem的http()传输层建立连接,免key端点只能读取各链的公开方法,带key后才可访问其余方法与数据集。 包含在 Robinhood Chain 上使用带 API key 的 URL 配置 AgentOS RPC_ROBINHOOD_URL 的方法。

按下方配方为 LangChain、ElizaOS、viem、wagmi 或 Coinbase AgentKit 配置区块链 RPC;LangChain、ElizaOS 与 Coinbase AgentKit 各有独立页面和可运行代码。开发者与 AI Agent 可先通过文档 MCP发现方法与文档,再按独立的 HTTP 开户流程创建 API key。用 key 发起 RPC 与 Data API 请求,或在 MCP 客户端的 x-api-key 请求头中配置 key 后调用带 key 工具;免 key RPC 访问限于各链的 public.methods。

通过 SDK 读取文档

首次查阅文档无需模型、钱包或 BlockVectra API key。先获取独立示例并固定到此版本:

git clone https://github.com/blockvectra/agent-quickstart.git
cd agent-quickstart
git checkout --detach c4c0d5c81c5518add7f0f204a77f42934d183588

Python / OpenAI Agents SDK

准备 Python 3.12+ 和 uv,在仓库根目录运行:

uv run examples/openai_agents_docs.py

示例固定 openai-agents==0.24.0 与 mcp==2.3.0,直接调用 SDK 管理的 MCP server,不运行 Agent 或 Runner;tracing 已关闭。

Node.js / mcp-use

准备 Node.js 22.22.2+,从仓库根目录开始运行:

cd examples/mcp-use-docs
npm ci --ignore-scripts
npm start

独立示例固定 @mcp-use/client 2.4.5,包含依赖锁文件,并在加载客户端前关闭 SDK 匿名遥测。

两个示例均连接 https://docs.blockvectra.com/mcp/docs,列出两个文档工具,用英语搜索 quickstart,然后打印搜索返回的页面。工具报错或结果为空时停止。读取页面不会执行其中的 RPC 或账号步骤。示例启动前需要联网安装依赖。

LangChain

LangChain Agent 可以用一个 @tool 函数向 https://api.blockvectra.com/v1/eth_mainnet/public 发送 JSON-RPC,也可以用 MCPAdapter 连接 https://docs.blockvectra.com/mcp。指南中有 Python 与 TypeScript 代码、带 key 的写法与错误表。

ElizaOS

ElizaOS 通过 @elizaos/plugin-evm 访问 EVM 链。在 .env 中用 EVM_PROVIDER_URL 设置以太坊主网,用 ETHEREUM_PROVIDER_<CHAIN_NAME> 设置其他链,并加入 @elizaos/plugin-mcp 使用文档 MCP 服务。指南中有完整的 .env、角色与 MCP 配置。

AgentOS

在 Robinhood Chain 上使用 AgentOS 时,通过 RPC_ROBINHOOD_URL 设置私有 RPC URL。使用 BlockVectra 的路径带 key 入口即可,无需修改 AgentOS 或增加代理。请先通过私密方式为 AgentOS 进程环境提供 BLOCKVECTRA_API_KEY,再设置:

# robinhood_mainnet:预期 chain ID 4663;移除冲突的 "4663"/"robinhood" URL 覆盖。
export RPC_ROBINHOOD_URL="https://api.blockvectra.com/v1/robinhood_mainnet/${BLOCKVECTRA_API_KEY:?Set BLOCKVECTRA_API_KEY privately first}"

从该环境沿用平时的命令启动 AgentOS。若 [trading.rpc_urls] 已按 chain ID 或别名配置该网络,它会优先于环境变量:移除该覆盖项,或私密地改为相同的路径带 key URL。变量由 shell 展开,TOML 不会执行此 shell 展开。参见 AgentOS URL 选择源码。

完整 URL 是机密,不要提交版本库、放进共享日志、截图或浏览器代码,设置时不要开启 shell 跟踪(set -x)。AgentOS 的 LP 路径还可能使用独立公开日志回退;设置此 URL 不代表所有外部请求都经 BlockVectra,也不验证交易/LP 工作流。快速上手示例记录了离线检查与范围。

viem

在 viem 中,通过 http() 或 webSocket() 配置客户端传输层。

携带 API key 的 HTTP 传输

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

免 key 的公开端点 HTTP 传输

在允许的公开只读方法上免 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(...))用于 GET /v1/chains 中声明 ws: true 的链,例如 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 中,将 BlockVectra RPC 地址传入 createConfig 的 transports 映射中。

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

免 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 通过钱包 Provider(Wallet Provider)执行链上动作,ViemWalletProvider 包装 viem WalletClient,其传输层可以指向 BlockVectra 端点。

使用 ViemWalletProvider 配置

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

const client = createWalletClient({
  account: privateKeyToAccount(process.env.WALLET_PRIVATE_KEY as `0x${string}`),
  chain: base,
  transport: http("https://api.blockvectra.com/v1/base_mainnet/public"),
});

export const agentKit = await AgentKit.from({ walletProvider: new ViemWalletProvider(client) });

对于不在该链 public.methods 中的方法,用模板字符串把带 key 的地址 https://api.blockvectra.com/v1/base_mainnet/${process.env.BLOCKVECTRA_API_KEY} 传给 http()。指南涵盖 LangChain 工具接入、MCP 与错误处理。

远程 MCP

如果你的 Agent 通过模型上下文协议(Model Context Protocol,Streamable HTTP MCP)接入,可以直接连接 BlockVectra MCP 服务端点:

https://docs.blockvectra.com/mcp

针对 Claude Code、Cursor、VS Code、Codex、Gemini CLI、OpenAI Responses API 及 Windsurf 等客户端的配置说明,请参阅 BlockVectra MCP 服务页的「在各客户端中接入」。

下一步

最后更新:

本页目录