Use RPC de blockchain em agentes Coinbase AgentKit com a BlockVectra

O Coinbase AgentKit envia suas ações on-chain por meio de um provedor de carteira, e o ViemWalletProvider aceita qualquer WalletClient do viem. Dê a esse cliente https://api.blockvectra.com/v1/base_mainnet/public como transporte e o tráfego RPC do AgentKit passa a usar a BlockVectra sem API key. Uma chave libera o restante; o Plano Gratuito oferece 30,000,000 CU por janela de 30 dias. Verificado em 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);

Instale com npm install @coinbase/agentkit @coinbase/agentkit-langchain viem. tools é a lista que a integração com LangChain do AgentKit passa para createAgent({ model, tools }); a chave da carteira permanece no seu ambiente.

Use uma API key

O endpoint público serve apenas os métodos em public.methods de cada rede. Para os demais, envie a chave no cabeçalho x-api-key e mantenha-a no ambiente, para que nunca apareça na URL:

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

Se um cliente não puder definir cabeçalhos, a chave pode ir no caminho da URL (/v1/{chain}/{api_key}); URLs podem acabar em logs de acesso, então prefira o cabeçalho.

Crie a chave sem navegador com as quatro etapas do guia de cadastro programático: desafio, assinatura, login e, depois, POST /keys. Desenvolvedores também podem criar uma chave no console. Uma só chave funciona em todas as redes, então trocar o agente para outra rede muda apenas o slug da rede e o objeto de rede do viem.

Combine as ações do AgentKit com o servidor MCP de documentação

O pacote TypeScript do AgentKit expõe suas ações como tools do LangChain, de modo que as ferramentas MCP do adaptador do LangChain entram no mesmo array tools. Siga o guia do LangChain para carregar https://docs.blockvectra.com/mcp e, depois, mescle:

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

O agente recebe as ações de carteira do AgentKit mais list_chains, get_status, rpc_call e read_doc da BlockVectra, listadas na página do servidor MCP. Conectar não exige chave.

Erros que você pode ver

Cada erro da BlockVectra inclui data.reason e um docs_url; a lista completa está na página de erros.

Documentação oficial

• coinbase/agentkit no GitHub
• Transporte HTTP do viem

Perguntas frequentes

A BlockVectra vê a chave privada da carteira? Não. A conta viem assina localmente; o endpoint recebe leituras e transações brutas já assinadas.

O agente pode ler logs pelo endpoint público? Não. eth_getLogs e a Data API precisam de uma API key.

A chave vai nos argumentos das ferramentas MCP? Não. Mantenha-a no ambiente ou nos cabeçalhos do cliente MCP.

Próximos passos

• Visão geral dos frameworks de agentes para LangChain, ElizaOS, viem e wagmi.
• Conecte um agente de IA para descobrir endpoints com MCP, llms.txt e OpenAPI.
• Regras de cobrança para a medição de CU, limites de taxa e erros não cobrados.