ProofGate

ProofGate es un cortafuegos de preejecución para agentes autónomos. Paga una inferencia en vivo de URL_SCAN de Telegraph, normaliza el resultado del minero seleccionado en una decisión ALLOW, WARN o BLOCK, y solo realiza la acción de red solicitada cuando la política devuelve ALLOW.

Cada decisión se añade a un libro de auditoría encadenado con hash SHA-256. El desarrollo local usa JSONL; los despliegues serverless usan una lista atómica de Redis. Los mismos controles están disponibles a través de la consola web, la API HTTP y el servidor MCP stdio.

Por qué esto no es otro escáner de URL

Un escáner informa de una puntuación. ProofGate aplica un límite:

flowchart LR
  A[Agent action] --> G[ProofGate]
  G -->|x402 payment| T[Telegraph URL_SCAN]
  T --> M[Compatible Miner]
  M --> P{Local policy}
  P -->|ALLOW| E[DNS-pinned GET or HEAD]
  P -->|WARN or BLOCK| W[Withhold action]
  P --> L[Hash-chained audit ledger]
  E --> L
  W --> L

ProofGate también expone su propio minero URL_SCAN. Ese minero combina la estructura de la URL, DNS, RDAP y proveedores de reputación configurados sin visitar la URL de destino enviada.

Related MCP server: actiongate

Comportamiento actual

• Descubre el grupo de mineros URL_SCAN en vivo de Telegraph.

• Selecciona un minero compatible del catálogo URL_SCAN en vivo de Telegraph y paga su endpoint de despacho a través de x402.

• Filtra los requisitos de x402 por red y cantidad máxima antes de firmar.

• Trata la evidencia maliciosa como BLOCK y la evidencia incierta como WARN.

• Ejecuta solo destinos HTTP(S) públicos después de ALLOW.

• Admite GET y HEAD acotados; no se siguen las redirecciones.

• Almacena el escaneo, la liquidación y la evidencia de la acción en una cadena de hash de solo añadidura.

• Requiere autenticación de portador del operador para las rutas de producción de pago.

• Aplica límites de solicitud acotados localmente y a través de Redis cuando está configurado.

• Informa de los proveedores de reputación no disponibles como no disponibles, nunca como limpios.

• Expone cuatro herramientas MCP a través del SDK estable de MCP v2 stdio.

Requisitos

• Node.js 20 o superior

• npm

• Una cartera desechable limitada de Base Sepolia para llamadas de pago a Telegraph

• USDC de Base Sepolia si se va a ejercitar la ruta de aplicación de pago

El descubrimiento de red gratuito, el minero local, la interfaz de usuario, el lector de auditoría y el protocolo de enlace MCP no requieren cartera.

Configuración local

Set-Location C:\dev\proofgate
& "C:\Program Files\nodejs\npm.cmd" install
Copy-Item .env.example .env.local
& "C:\Program Files\nodejs\npm.cmd" run dev

Abre http://localhost:3000.

Configura los secretos directamente en .env.local. No pegues una clave privada en un issue, chat, captura de pantalla o variable de entorno del lado del cliente.

Configuración

El USDC atómico usa seis decimales. Los valores predeterminados limitan Telegraph a $0.10 y un pago x402 de origen de destino a $0.05 por solicitud.

API HTTP

Ejemplo de solicitud de minero local:

Invoke-RestMethod -Method Post `
  -Uri http://localhost:3000/api/miner/scan `
  -ContentType application/json `
  -Body '{"url":"https://example.com"}'

Ejemplo de cuerpo de acción protegida:

{
  "url": "https://example.com",
  "execute": true,
  "method": "GET"
}

Sin TELEGRAPH_EVM_PRIVATE_KEY, /api/guard devuelve deliberadamente 503 payment_not_configured. No sustituye evidencia simulada.

En producción, envía Authorization: Bearer <PROOFGATE_API_KEY> a /api/guard y /api/audit. La consola web mantiene la clave del operador solo en la memoria del componente. Los despliegues de Vercel también fallan antes del pago a menos que ambas variables de Upstash Redis estén configuradas.

Despliegue en Vercel

1. Importa el repositorio público de GitHub en Vercel o ejecuta vercel desde la raíz del proyecto.

2. Añade cada variable requerida a través de la interfaz de variables de entorno cifradas de Vercel. Nunca hagas commit de .env.local.

3. Adjunta una integración de Upstash Redis y expón su URL REST y token.

4. Genera una clave de operador única y configura PROOFGATE_API_KEY.

5. Despliega una vez, establece PROOFGATE_PUBLIC_URL al origen HTTPS asignado y vuelve a desplegar para que /miner.yaml contenga su URL pública canónica.

6. Mantén TELEGRAPH_EVM_PRIVATE_KEY sin definir hasta que una cartera desechable nueva y no expuesta esté lista.

Servidor MCP

Compila y verifica el servidor stdio:

& "C:\Program Files\nodejs\npm.cmd" run mcp:build
& "C:\Program Files\nodejs\npm.cmd" run mcp:smoke

El cliente de prueba inicia el servidor empaquetado, realiza el protocolo de enlace de inicialización MCP, lista sus herramientas, llama a la detección gratuita en vivo de Telegraph y cierra el proceso hijo. El archivo .vscode/mcp.json incluido apunta VS Code a dist/mcp/server.js; compila el servidor una vez antes de habilitarlo en un host MCP.

Herramientas disponibles:

• proofgate_network_status: preparación gratuita y descubrimiento de mineros en vivo

• proofgate_scan: escaneo de pago de Telegraph sin ejecución de destino

• proofgate_guarded_fetch: escaneo de pago seguido de GET o HEAD sujeto a política

• proofgate_audit_tail: decisiones locales recientes con verificación de cadena

El servidor carga .env.local y .env desde su directorio de trabajo. stdout está reservado para MCP JSON-RPC; los diagnósticos van a stderr.

Publicación de minero de Telegraph

1. Despliega el servicio Next.js en un origen HTTPS público estable.

2. Configura al menos los proveedores de reputación previstos para producción.

3. Establece PROOFGATE_PUBLIC_URL, PROOFGATE_REPOSITORY_URL y el ID de registro asignado a través del flujo de integración de Telegraph.

4. Verifica que https://your-host.example/miner.yaml y https://your-host.example/api/miner/scan sean accesibles públicamente.

5. Valida y envía el YAML generado a través del portal de integración de Telegraph.

6. Confirma el registro y prueba una solicitud de pago en el Explorador antes de anunciar la disponibilidad.

ProofGate incluye herramientas de registro en cadena con simulación previa basadas en el ejemplo oficial de Telegraph y el Diamond actual de Base Sepolia:

$env:PROOFGATE_MINER_YAML_URL="https://proofgate-six.vercel.app/miner.yaml"
& "C:\Program Files\nodejs\npm.cmd" run registration:check
& "C:\Program Files\nodejs\npm.cmd" run registration:submit

La comprobación obtiene los bytes exactos alojados, valida el descriptor, calcula su SHA-256, verifica el ETH/USDC de la cartera y no envía nada. El envío repite esas comprobaciones, simula registerMiner, espera la confirmación, analiza MinerRegistered y lee el registro de vuelta. La dirección de cartera desechable conocida expuesta en el chat está bloqueada de forma permanente para el registro.

El repositorio no afirma que un minero esté registrado o desplegado. Esos pasos requieren un origen público, acceso al portal y credenciales privadas.

Verificación

& "C:\Program Files\nodejs\npm.cmd" run typecheck
& "C:\Program Files\nodejs\npm.cmd" run lint
& "C:\Program Files\nodejs\npm.cmd" test
& "C:\Program Files\nodejs\npm.cmd" run build
& "C:\Program Files\nodejs\npm.cmd" run mcp:build
& "C:\Program Files\nodejs\npm.cmd" run mcp:smoke
& "C:\Program Files\nodejs\npm.cmd" audit

Prueba en vivo de Base Sepolia registrada el 2026-08-19:

• El catálogo de Telegraph seleccionó URL Sentinel (minero 5001) para URL_SCAN.

• El minero devolvió safe con una confianza de 0.90; la política devolvió ALLOW.

• x402 liquidó exactamente 0.01 USDC al Diamond de Telegraph en la transacción 0xfb8e...6585.

• La solicitud protegida y fijada por DNS devolvió entonces HTTP 200 con 559 bytes de https://example.com/, y ProofGate añadió un registro de auditoría ACTION.

Consulta SECURITY.md para conocer los límites de confianza y los riesgos residuales.

Limitaciones honestas

• La disponibilidad del proveedor de Telegraph puede impedir una llamada de pago por lo demás válida.

• La cobertura de reputación depende de qué claves de proveedor estén configuradas.

• Un resultado limpio es evidencia, no una garantía de que un destino sea inofensivo.

• La cadena de auditoría es a prueba de manipulaciones, no está cifrada ni es atestiguada externamente.

• Las redirecciones se notifican pero deliberadamente no se siguen.

• El registro del minero y el envío del hackathon siguen siendo pasos operativos externos.