NullClear Protocol MCP

npx add-mcp 'https://nullclear.dev/mcp'

NullClear (nullclear.dev / nullclear.com)

Protocolo Autônomo de Compensação e Reputação sem Custódia para Agentes de IA x402

O NullClear elimina o risco de pagamento no comércio Agente-para-Agente (A2A). Em fluxos HTTP 402 Payment Required padrão, os compradores são forçados a pagar antes de ver se um agente upstream alucina, falha ou retorna dados malformados. O NullClear introduz escrow de esquema sem custódia com liquidação diferida: o comprador assina uma autorização EIP-3009 TransferWithAuthorization, o árbitro valida criptograficamente a saída do agente upstream contra o contrato de esquema do comprador, e só liquida o pagamento após 100% de verificação. Se o vendedor alucinar ou falhar, a autorização é anulada e $0 é gasto.

---

Visão Geral da Arquitetura

                      ┌──────────────────────────────────────────┐
                      │              BUYER AGENT                 │
                      │  (@nullclear/x402-arbiter client/fetch)   │
                      └─────────────────────┬────────────────────┘
                                            │
                          1. Target request │ (Intercepted 402)
                          2. EIP-3009 signed│ & Schema defined
                                            ▼
                      ┌──────────────────────────────────────────┐
                      │          NULLCLEAR ARBITER               │
                      │     (Cloudflare Worker + Hono)           │
                      │  - Sybil & Wash-Trade Engine             │
                      │  - Deterministic JSON Schema Validator   │
                      │  - EIP-712 Receipt Attestation           │
                      └─────────────┬──────────────┬─────────────┘
                                    │              │
                   3. Proxy Request │              │ 4. If Valid: Settle
                      with Escrow   │              │    If Invalid: VOID ($0)
                                    ▼              ▼
                     ┌──────────────────┐    ┌───────────────────┐
                     │   SELLER AGENT   │    │  EIP-3009 SETTLE  │
                     │  (HTTP 402 API)  │    │  (USDC on Base)   │
                     └──────────────────┘    └───────────────────┘

---

Pacotes do Monorepo

Pacote	Caminho	Descrição
@nullclear/shared	packages/shared	Constantes principais (Base Mainnet 8453, Sepolia 84532), ABIs ERC-8004, tipos x402 V2, esquemas EIP-3009 e KYA EIP-712.
@nullclear/worker-arbiter	packages/worker-arbiter	Aplicativo Hono do Cloudflare Worker que lida com compensação de escrow diferido (/v1/clear), pontuações de confiança resistentes a Sybil (/v1/score), mandatos KYA (/v1/kya) e honeypots de descoberta de máquinas (/llms.txt, /.well-known/*, /openapi.json).
@nullclear/x402-arbiter	packages/x402-arbiter	SDK de agente que fornece createNullClearFetch com interceptação automática de HTTP 402, assinatura de autorização EIP-3009 e proteção de esquema Zod/JSON.
@nullclear/mcp	packages/mcp-server	Servidor do Model Context Protocol que expõe ferramentas nullclear_check_reputation, nullclear_escrow_x402_call e nullclear_verify_kya_mandate para agentes autônomos.
@nullclear/e2e-simulator	packages/e2e-simulator	Simulador local autocontido que valida vendedores honestos, anulações por alucinação, anulações por falha 500 e detecção de wash-trade Sybil.

---

Garantias do Protocolo

1. Liquidação Diferida sem Custódia: Autorizações do comprador são mantidas em escrow pelo árbitro e só executadas via EIP-3009 se o vendedor cumprir o contrato de esquema. Se o vendedor retornar esquema inválido ou códigos de erro, a liquidação é descartada.
2. Detecção de Sybil e Wash-Trade: Analisa o grafo de concentração de contrapartes. Se $>60%$ do volume de transações vier de um único endereço de comprador em $\ge 3$ transações, uma penalidade de wash-trading é aplicada e o flag HIGH_COUNTERPARTY_CONCENTRATION_WASH_RISK é levantado.
3. Mandatos de Responsabilidade Corporativa KYA (Know Your Agent): Vincula criptograficamente uma carteira de agente on-chain a uma entidade corporativa legalmente registrada com cobertura de responsabilidade definida e limites por transação.
4. Descoberta de Máquinas e Agentes Autodescritivos: Especificações completas de llms.txt, /.well-known/agent.json, /.well-known/x402.json, /.well-known/mcp.json e OpenAPI 3.1.0.

---

Novidades na v1.1.0

• 🛡️ Invariantes de Valor Determinístico Profundo: Estende a validação básica de esquema JSON com invariantes semânticos em nível de campo (gt, gte, lt, lte, eq, neq, minLength, maxLength, pattern, notContains e maxStalenessSeconds). Dados desatualizados ou desvio numérico acionam anulação instantânea da autorização ($0 cobrado).
• 🛑 Guarda Canônica de Recusa de LLM: Inspeciona automaticamente respostas de texto e JSON em busca de frases comuns de recusa de LLM ("as an ai language model", "i cannot fulfill this request", "i am unable to assist", limites de taxa e strings de erro de servidor), tratando recusa como não entrega.
• 🔀 Roteamento Autônomo de Failover Multi-Vendedor: Chamadores podem fornecer candidatos de fallback ordenados (fallbacks: [{ targetUrl, sellerAgentId, paymentSignatureHeader }]). Se o vendedor primário falhar ou não passar na validação, o Árbitro anula a autorização primária e roteia automaticamente para o candidato secundário sem retornar ao agente cliente.
• 🔒 Firewall de Gastos de Saída e Guardas Anti-Abuso: Protege carteiras de agentes compradores com limites por chamada (maxPerCallAtomic) e políticas de gastos diários contínuos (maxDailyWalletAtomic). Rejeita wash-loops de auto-compensação (endereço do comprador === endereço do vendedor) e impõe pisos mínimos de liquidação on-chain.

---

Início Rápido

Pré-requisitos

• Node.js $\ge 20$
• pnpm $\ge 9$

Instalar Dependências

pnpm install

Compilar Todos os Pacotes

pnpm build

Verificação de Tipos

pnpm typecheck

Executar Testes

pnpm test

Executar Simulador E2E Autônomo ao Vivo

pnpm demo