Warppay402

npx add-mcp 'https://api.warppay402.com/mcp?v=2'

docs.warppay402.com

Documentação para Desenvolvedores WarpPay402

Servidor de monetização x402 não custodial e gateway multi-chain de ferramentas para agentes de IA autônomos.

Bem-vindo à documentação para desenvolvedores do WarpPay402. O WarpPay402 permite que agentes de IA, scripts e desenvolvedores acessem web scraping de alto valor, parsing de PDF, verificações de contratos inteligentes, execução de rendimentos Aerodrome e transferências cross-chain via Circle CCTP sem gerenciar chaves de API ou contas de assinatura.

• Visão Geral
• Autenticação (Micropagamentos x402)
• Início Rápido: Python
• Início Rápido: TypeScript
• Integração MCP & Claude
• Referência Completa da API (21 Ferramentas)
• Paymaster Sem Gás (v0.8)
• Suporte & Assistência
• Endpoints de Descoberta para Servidor MCP e Agentes de IA

VISÃO GERAL

APIs SaaS tradicionais exigem registro, cartões de crédito, geração manual de chaves de API e gerenciamento de tokens. O WarpPay402 usa o protocolo x402 para eliminar completamente esse atrito.

Sem Chaves de API ou Cadastros: Agentes interagem diretamente com endpoints monetizados.

Micropagamentos Pay-Per-Use: Requisições custam frações de centavo ($0,0001 a $5,00 USDC) assinadas via autorizações criptográficas on-chain (EIP-712 / EIP-3009).

Multi-Chain Nativo: Suporta Base Mainnet, Solana Mainnet, Arbitrum One e Arc Mainnet.

Autenticação (Micropagamentos x402)

O WarpPay402 não usa tokens Bearer ou cabeçalhos estáticos. Em vez disso, a autenticação usa um fluxo automatizado de requisições HTTP em 2 etapas:

[ Agente de IA / Script ] [ Gateway WarpPay402 ]

│ │

│────── 1. POST /api/v1/tools/web-scraper ─────────►│ (Não pago)

│ │

│◄───── 2. HTTP 402 Payment Required ───────────────│ (Retorna Desafio x402)

│ (Cabeçalho: PAYMENT-REQUIRED) │

│ │

│────── 3. POST /api/v1/tools/web-scraper ─────────►│ (Pago)

│ (Cabeçalho: PAYMENT-SIGNATURE) │

│ │

│◄───── 4. HTTP 200 OK + Saída da Ferramenta ───────│

Redes de Pagamento Suportadas

Rede ID CAIP-2 Token Nativo / Ativo

Base Mainnet eip155:8453 USDC (0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913)

Solana Mainnet solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp SPL USDC (EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v)

Arc Mainnet eip155:5042 USDC Nativo (0x0000000000000000000000000000000000000000)

Arbitrum One eip155:42161 USDC (0xaf88d065e77c8cC2239327C5EDb3A432268e5831)

Início Rápido: Python

(1) Instale o SDK oficial de Python do PyPI:

Bash

pip install warppay402-mcp

(2) Exemplo de Código:

from warppay402 import WarpPayClient

# Inicializa o cliente com a chave privada da sua carteira

client = WarpPayClient(

private_key="0x_YOUR_AGENT_PRIVATE_KEY",

gateway_url="https://api.warppay402.com"

)

# Executa o Web Scraper de Markdown ($0,001 USDC)

result = client.call_tool(

"web_scraper",

payload={"url": "https://news.ycombinator.com"}

)

print(f"Título: {result['title']}")

print(f"Prévia do Markdown:\n{result['markdown'][:500]}")

Início Rápido: TypeScript

(1) Instale o pacote oficial do cliente Node.js:

Bash

npm install @warppay402/sdk

(2) Exemplo de Código

import { WarpPayClient } from "@warppay402/sdk";

const client = new WarpPayClient({

privateKey: process.env.AGENT_PRIVATE_KEY!,

baseUrl: "https://api.warppay402.com"

});

async function run() {

// Consulta análises de carteira Base ($0,002 USDC)

const analytics = await client.execute("base_analytics", {

address: "0x556c77792642E8ff95eC930FFb8D46a76579126E"

});

console.log("Saldo Base ETH:", analytics.ethBalance);

console.log("Nonce da Conta:", analytics.nonce);

}

run();

Integração MCP & Claude

Conecte as ferramentas do WarpPay402 diretamente ao Claude Desktop, Cursor ou Glama AI usando o Model Context Protocol (MCP).

Adicione o seguinte bloco ao seu claude_desktop_config.json:

{

"mcpServers": {

"warppay402": {

"command": "npx",

"args": [

"-y",

"@warppay402/mcp-server",

"--gateway",

"https://api.warppay402.com/mcp?v=2"

]

}

}

}

Referência Completa da API (21 Ferramentas)

-public_data_feed

Método & Caminho: GET /public_data_feed/:file

Preço (USDC): $0,0001

Descrição: Busca registros JSON de atestação pública assinados.

-data_feeds

Método & Caminho: GET /api/v1/feeds/:feedId

Preço (USDC): $0,0010

Descrição: Feeds de inteligência de mercado e rendimentos pré-extraídos.

-web_scraper

Método & Caminho: POST /api/v1/tools/web-scraper

Preço (USDC): $0,0010

Descrição: Converte páginas web públicas em Markdown limpo para contextos de LLM.

-browser_scraper

Método & Caminho: POST /api/v1/tools/browser-scraper

Preço (USDC): $0,0050

Descrição: Scraper headless Chromium apoiado por trabalhadores de proxy residencial.

-base_analytics

Método & Caminho: POST /api/v1/tools/base-analytics

Preço (USDC): $0,0020

Descrição: Retorna saldo ETH, nonce de transação e detalhes da carteira na Base.

-arc_analytics

Método & Caminho: POST /api/v1/tools/arc-analytics

Preço (USDC): $0,0010

Descrição: Busca altura de bloco ao vivo, preços de gás e status RPC na Arc Mainnet.

-arc_network_oracle_query

Método & Caminho: POST /api/v1/tools/arc-network-query

Preço (USDC): $0,1000

Descrição: Telemetria Arc pré-voo: latência RPC (ms), tendências de gás e saldo.

-arc_dex_oracle

Método & Caminho: POST /api/v1/tools/arc-dex-oracle

Preço (USDC): $0,0010

Descrição: Resolvedor de preço spot ETH/USDC em tempo real para pools da Arc Mainnet.

-pdf_extractor

Método & Caminho: POST /api/v1/tools/pdf-extractor

Preço (USDC): $0,0050

Descrição: Baixa e analisa documentos PDF públicos em texto simples.

-render_screenshot

Método & Caminho: POST /api/v1/tools/render-screenshot

Preço (USDC): $0,0100

Descrição: Captura dados de imagem de screenshot renderizada de página inteira.

-extract_json

Método & Caminho: POST /api/v1/tools/extract-json

Preço (USDC): $0,0100

Descrição: Extrai dados de esquema JSON estruturado de páginas web HTML.

-smart_contract_verifier

Método & Caminho: POST /api/v1/tools/smart-contract-verifier

Preço (USDC): $0,0200

Descrição: Análise de código-fonte Basescan, validação de bytecode e busca de ABI.

-get_aerodrome_yields

Método & Caminho: GET /api/v1/tools/aerodrome-yields

Preço (USDC): $0,0030

Descrição: Oportunidades de rendimento DEX Aerodrome em tempo real, APYs de pools e TVL.

-aerodrome_swap

Método & Caminho: POST /api/v1/tools/aerodrome-swap

Preço (USDC): $0,0100

Descrição: Trocas de tokens programáticas executadas via Aerodrome Finance Router.

-aerodrome_clamm

Método & Caminho: POST /api/v1/tools/aerodrome-clamm

Preço (USDC): $0,0100

Descrição: Gerenciamento de posições de liquidez concentrada (Slipstream).

-aerodrome_veaero

Método & Caminho: POST /api/v1/tools/aerodrome-veaero

Preço (USDC): $0,0100

Descrição: Automatiza bloqueio de $AERO, votação de gauge de época e coleta de subornos.

-deploy_contract

Método & Caminho: POST /api/v1/tools/deploy-contract

Preço (USDC): $5,0000

Descrição: Implanta contratos personalizados de Escrow, Bounty ou Agent na Base.

-deploy_solana_contract

Método & Caminho: POST /api/v1/tools/deploy-solana-contract

Preço (USDC): $5,0000

Descrição: Inicializa programaticamente Escrows SPL ou Vaults Raydium na Solana.

-deploy_arc_contract

Método & Caminho: POST /api/v1/tools/deploy-arc-contract

Preço (USDC): $5,0000

Descrição: Implanta contratos de Escrow, Bounty ou Agent diretamente na Arc Mainnet.

-arc_cctp_bridge

Método & Caminho: POST /api/v1/tools/arc-cctp-bridge

Preço (USDC): $0,2500

Descrição: Transferências USDC cross-chain da Arc Mainnet via Circle CCTP V2.

-x402_telemetry_feed

Método & Caminho: GET /api/v1/telemetry/settlements

Preço (USDC): Grátis

Descrição: Telemetria pública de liquidações, endpoints ativos e provas on-chain.

Paymaster Sem Gás (ERC-4337 / ERC-7677 v0.8)

O WarpPay402 hospeda um Paymaster v0.8 integrado na Base Mainnet. Contas Inteligentes que possuem USDC podem executar pacotes de transações sem gás usando cobrança com margem em USDC.

Endpoint RPC do Paymaster: [https://api.warppay402.com/api/v1/paymaster/rpc\](https://api.warppay402.com/api/v1/paymaster/rpc)

Endpoint de Cotação: [https://api.warppay402.com/api/v1/paymaster/quote\](https://api.warppay402.com/api/v1/paymaster/quote)

Suporte & Contato Empresarial

Para assistência técnica, limites de taxa mais altos, nós dedicados de proxy worker ou integrações de ferramentas personalizadas:

E-mail: [email protected]

Endpoints de Descoberta para Servidor MCP e Agentes de IA

Conecte o WarpPay402 diretamente ao Claude Desktop, Cursor, Glama AI ou runtimes personalizados de agentes de IA usando nossos manifestos públicos de descoberta.

Endpoint do Model Context Protocol (MCP):

https://api.warppay402.com/mcp?v=2

Manifesto de Contexto para Agente de IA / LLM (llms.txt):

https://api.warppay402.com/llms.txt

Manifesto de Descoberta de Agente x402:

https://api.warppay402.com/.well-known/x402-manifest.json

Manifesto do Conector MCP:

https://api.warppay402.com/.well-known/mcp.json

Página atualizada

Google Sites

Reportar abuso