NullClear Protocol MCP

Escrow autónomo de esquema diferido, puntuación de reputación ERC-8004 y verificador de mandato de responsabilidad corporativa KYA para pagos de agentes de IA x402 en Base.

GitHub

Servidor MCP alojado

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

Se instala en Claude Code, Codex, Cursor y más

Documentación

NullClear (`nullclear.dev` / `nullclear.com`)

Protocolo Autónomo de Compensación y Reputación sin Custodia para Agentes de IA x402

NullClear elimina el riesgo de pago en el comercio Agente-a-Agente (A2A). En los flujos estándar de 402 Payment Required HTTP, los compradores se ven obligados a pagar antes de ver si un agente upstream alucina, falla o devuelve datos malformados. NullClear introduce depósito en garantía de esquema diferido sin custodia: el comprador firma una TransferWithAuthorization EIP-3009, el árbitro valida criptográficamente la salida del agente upstream contra el contrato de esquema del comprador, y solo liquida el pago tras una verificación del 100%. Si el vendedor alucina o falla, la autorización se anula y se gastan $0.

Descripción General de la Arquitectura

                      ┌──────────────────────────────────────────┐
                      │              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)   │
                     └──────────────────┘    └───────────────────┘

Paquetes del Monorepo

Paquete	Ruta	Descripción
`@nullclear/shared`	`packages/shared`	Constantes principales (Base Mainnet 8453, Sepolia 84532), ABIs ERC-8004, tipos x402 V2, esquemas EIP-712 de EIP-3009 y KYA.
`@nullclear/worker-arbiter`	`packages/worker-arbiter`	Aplicación Hono de Cloudflare Worker que gestiona la compensación de depósito diferido (`/v1/clear`), puntuaciones de confianza resistentes a Sybil (`/v1/score`), mandatos KYA (`/v1/kya`) y honeypots de descubrimiento de máquinas (`/llms.txt`, `/.well-known/*`, `/openapi.json`).
`@nullclear/x402-arbiter`	`packages/x402-arbiter`	SDK de agente que proporciona `createNullClearFetch` con interceptación automática de HTTP 402, firma de autorización EIP-3009 y protección de esquema Zod/JSON.
`@nullclear/mcp`	`packages/mcp-server`	Servidor del Protocolo de Contexto de Modelo que expone herramientas `nullclear_check_reputation`, `nullclear_escrow_x402_call` y `nullclear_verify_kya_mandate` a agentes autónomos.
`@nullclear/e2e-simulator`	`packages/e2e-simulator`	Simulador local autocontenido que valida vendedores honestos, anulaciones por alucinación, anulaciones por fallos 500 y detección de operaciones simuladas Sybil.

Garantías del Protocolo

Liquidación Diferida sin Custodia: Las autorizaciones del comprador se mantienen en depósito por el árbitro y solo se ejecutan mediante EIP-3009 si el vendedor cumple el contrato de esquema. Si el vendedor devuelve un esquema inválido o códigos de error, la liquidación se descarta.
Detección de Sybil y Operaciones Simuladas: Analiza el gráfico de concentración de contrapartes. Si $>60%$ del volumen de transacciones proviene de una única dirección de comprador en $\ge 3$ transacciones, se aplica una penalización por operaciones simuladas y se eleva el indicador HIGH_COUNTERPARTY_CONCENTRATION_WASH_RISK.
Mandatos de Responsabilidad Corporativa KYA (Conozca a su Agente): Vincula criptográficamente una billetera de agente en cadena a una entidad corporativa registrada legalmente con cobertura de responsabilidad definida y límites por transacción.
Descubrimiento de Máquinas y Agentes Autodescriptivos: Especificaciones completas de llms.txt, /.well-known/agent.json, /.well-known/x402.json, /.well-known/mcp.json y OpenAPI 3.1.0.

Novedades en v1.1.0

🛡️ Invariantes de Valor Deterministas Profundos: Extiende la validación básica de esquema JSON con invariantes semánticas a nivel de campo (gt, gte, lt, lte, eq, neq, minLength, maxLength, pattern, notContains y maxStalenessSeconds). Los datos obsoletos o la deriva numérica activan la anulación instantánea de la autorización (se cobran $0).
🛑 Guardia Canónica de Rechazo de LLM: Inspecciona automáticamente las respuestas de texto y JSON en busca de plantillas comunes de rechazo de LLM ("as an ai language model", "i cannot fulfill this request", "i am unable to assist", límites de velocidad y cadenas de error del servidor), tratando el rechazo como no entrega.
🔀 Enrutamiento Autónomo de Conmutación por Error Multi-Vendedor: Los llamadores pueden proporcionar candidatos de respaldo ordenados (fallbacks: [{ targetUrl, sellerAgentId, paymentSignatureHeader }]). Si el vendedor principal falla o no supera la validación, el Árbitro anula la autorización principal y enruta automáticamente al candidato secundario sin volver al agente cliente.
🔒 Cortafuegos de Gasto Saliente y Guardias Anti-Abuso: Protege las billeteras de los agentes compradores con límites por llamada (maxPerCallAtomic) y políticas de gasto renovables diarias (maxDailyWalletAtomic). Rechaza bucles de compensación automática (dirección del comprador === dirección del vendedor) y aplica pisos mínimos de liquidación en cadena.

Inicio Rápido

Requisitos Previos

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

Instalar Dependencias

pnpm install

Compilar Todos los Paquetes

pnpm build

Verificación de Tipos

pnpm typecheck

Ejecutar Pruebas

pnpm test

Ejecutar Simulador E2E Autónomo en Vivo

pnpm demo