Dùng RPC blockchain trong Agent Coinbase AgentKit với BlockVectra

Coinbase AgentKit gửi các hành động onchain qua một wallet provider, và ViemWalletProvider chấp nhận bất kỳ viem WalletClient nào. Cấp cho client đó https://api.blockvectra.com/v1/base_mainnet/public làm transport và lưu lượng RPC của AgentKit sẽ dùng BlockVectra mà không cần API key. API key bổ sung phần còn lại; Gói miễn phí cung cấp 30,000,000 CU cho mỗi cửa sổ 30 ngày. Kiểm tra ngày 2026-10-11.

import { AgentKit, ViemWalletProvider } from "@coinbase/agentkit";
import { getLangChainTools } from "@coinbase/agentkit-langchain";
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"),
});

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

Cài đặt bằng npm install @coinbase/agentkit @coinbase/agentkit-langchain viem. tools là danh sách mà tích hợp LangChain của AgentKit truyền cho createAgent({ model, tools }); khóa ví nằm trong môi trường của bạn.

Dùng API key

Endpoint công khai chỉ phục vụ các phương thức trong public.methods của từng chuỗi. Với các phương thức khác, gửi key trong header x-api-key và giữ key trong biến môi trường để nó không bao giờ xuất hiện trong URL:

const transport = http("https://api.blockvectra.com/v1/base_mainnet", {
  fetchOptions: { headers: { "x-api-key": process.env.BLOCKVECTRA_API_KEY! } },
});

Nếu client không thể đặt header, có thể đặt key vào đường dẫn URL (/v1/{chain}/{api_key}); URL có thể nằm lại trong log truy cập, nên ưu tiên dùng header.

Tạo key mà không cần trình duyệt bằng bốn bước trong hướng dẫn đăng ký bằng chương trình: challenge, chữ ký, đăng nhập, rồi POST /keys. Nhà phát triển cũng có thể tạo key trong console. Một key dùng được trên mọi chuỗi, nên khi chuyển Agent sang mạng khác chỉ cần đổi chain slug và đối tượng chain của viem.

Kết hợp hành động AgentKit với máy chủ MCP tài liệu

Gói TypeScript của AgentKit cung cấp các hành động của nó dưới dạng công cụ LangChain, nên công cụ MCP từ adapter của LangChain được đưa vào cùng mảng tools. Làm theo hướng dẫn LangChain để nạp https://docs.blockvectra.com/mcp, rồi gộp lại:

const agent = createAgent({ model: "claude-sonnet-5", tools: [...tools, ...(await adapter.listTools())] });

Agent nhận các hành động ví của AgentKit cùng list_chains, get_status, rpc_call và read_doc của BlockVectra, được liệt kê trên trang máy chủ MCP. Kết nối không cần key.

Các lỗi bạn có thể gặp

Mỗi lỗi của BlockVectra có data.reason và docs_url; danh sách đầy đủ nằm trên trang lỗi.

Tài liệu chính thức

• coinbase/agentkit trên GitHub
• viem HTTP transport

Câu hỏi thường gặp

BlockVectra có thấy khóa riêng tư của ví không? Không. Tài khoản viem ký cục bộ; endpoint chỉ nhận các lệnh đọc và giao dịch thô đã ký.

Agent có thể đọc log qua endpoint công khai không? Không. eth_getLogs và Data API cần API key.

Key có nằm trong tham số của công cụ MCP không? Không. Giữ key trong biến môi trường hoặc header của MCP client.

Bước tiếp theo

• Tổng quan framework Agent cho LangChain, ElizaOS, viem và wagmi.
• Kết nối AI Agent để khám phá endpoint bằng MCP, llms.txt và OpenAPI.
• Quy tắc thanh toán về đo lường CU, giới hạn tốc độ và các lỗi không bị tính phí.