Execução de Pagamento de Agente (x402)

Permita que agentes de IA realizem pagamentos com políticas definidas e controles de gastos integrados. Utiliza o protocolo de pagamento HTTP x402 e ferramentas MCP para que os agentes possam pagar por serviços externos, APIs ou outros agentes sem risco de custódia.

Quando Usar

Use quando: seu agente precisar pagar por uma chamada de API, comprar um serviço, liquidar com outro agente, impor limites de gastos por tarefa ou gerenciar uma carteira não custodial. Combina naturalmente com as habilidades cost-aware-llm-pipeline e security-review.

Árvore de Decisão

Escolha o caminho de integração com base se seu agente está comprando acesso a uma API paga ou cobrando outros por uma:

Redes Suportadas

• agentwallet-sdk: use a documentação do pacote para confirmar a cobertura de rede atual antes da produção. Base Sepolia é o padrão de desenvolvimento mais seguro; Base mainnet é o caminho de produção destacado pela habilidade original.
• OKX Payments / X Layer: a documentação atual do vendedor visa X Layer (eip155:196) e liquidação USDT0. Obtenha a documentação atual do SDK antes de gerar código de produção, pois os pacotes de pagamento e o comportamento do facilitador podem mudar rapidamente.
• Pacotes upstream x402: multi-rede por design — uma rota pode anunciar Base e Solana simultaneamente e deixar o comprador escolher. Os pacotes usam o facilitador x402.org por padrão, que é apenas para testnet (Base Sepolia eip155:84532, Solana devnet solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1, além de testnets Stellar, Aptos, Hedera e XRPL) e não se destina a rotas mainnet. Para mainnet (solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp para Solana), facilite você mesmo, execute seu próprio facilitador ou escolha um hospedado na lista de facilitadores upstream — veja a comparação de facilitadores na Opção C. Confirme a cobertura ao vivo no endpoint /supported do facilitador antes da produção, em vez de codificá-lo aqui.

Como Funciona

Protocolo x402

x402 estende o HTTP 402 (Pagamento Necessário) para um fluxo negociável por máquina. Quando um servidor retorna 402, a ferramenta de pagamento do agente negocia o preço, verifica o orçamento, assina uma transação e tenta novamente apenas dentro da política e do limite de confirmação definidos pelo orquestrador.

Controles de Gastos

Cada chamada da ferramenta de pagamento impõe uma SpendingPolicy:

• Orçamento por tarefa — gasto máximo para uma única ação do agente
• Orçamento por sessão — limite cumulativo em toda uma sessão
• Destinatários permitidos — restringe quais endereços/serviços o agente pode pagar
• Limites de taxa — transações máximas por minuto/hora

Carteiras Não Custodiais

Os agentes mantêm suas próprias chaves por meio de contas inteligentes ERC-4337. O orquestrador define a política antes da delegação; o agente só pode gastar dentro dos limites. Sem fundos agrupados, sem risco de custódia.

Integração MCP

A camada de pagamento expõe ferramentas MCP padrão que se encaixam em qualquer configuração Claude Code ou agent harness.

Nota de segurança: Sempre fixe a versão do pacote. Esta ferramenta gerencia chaves privadas — instalações de npx sem fixação introduzem risco de cadeia de suprimentos.

Opção A: agentwallet-sdk (Base / multi-chain)

{
  "mcpServers": {
    "agentpay": {
      "command": "npx",

…