ProofGate

ProofGate 是面向自主智能体的执行前防火墙。它付费调用实时 Telegraph URL_SCAN 推理，将所选 Miner 的结果归一化为 ALLOW、WARN 或 BLOCK 决策，并且仅在策略返回 ALLOW 时才执行所请求的网络操作。

每条决策都会追加到 SHA-256 哈希链审计账本中。本地开发使用 JSONL；无服务器部署使用原子 Redis 列表。相同的控制能力可通过 Web 控制台、HTTP API 和 MCP stdio 服务器使用。

为什么这不是又一个 URL 扫描器

扫描器报告一个分数。ProofGate 强制执行一个边界：

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 还暴露了自己的 URL_SCAN Miner。该 Miner 在不访问所提交目标 URL 的情况下，结合 URL 结构、DNS、RDAP 和已配置的信誉提供方进行分析。

Related MCP server: actiongate

当前行为

• 发现实时 Telegraph URL_SCAN Miner 池。

• 从 Telegraph 实时 URL_SCAN 目录中选择兼容的 Miner，并通过 x402 向其调度端点付费。

• 在签名前按网络和最大金额过滤 x402 要求。

• 将恶意证据视为 BLOCK，将不确定证据视为 WARN。

• 仅在 ALLOW 后执行公共 HTTP(S) 目标。

• 支持受限的 GET 和 HEAD；不跟随重定向。

• 将扫描、结算和操作证据存储在仅追加的哈希链中。

• 付费生产路由需要操作者 Bearer 认证。

• 在本地以及配置 Redis 时强制执行作用域限流。

• 将不可用的信誉提供方报告为不可用，绝不报告为干净。

• 通过稳定的 MCP v2 stdio SDK 暴露四个 MCP 工具。

要求

• Node.js 20 或更高版本

• npm

• 一个有限的 Base Sepolia 一次性钱包，用于付费 Telegraph 调用

• 如果要走付费应用路径，需要 Base Sepolia USDC

免费的网络发现、本地 Miner、UI、审计读取器和 MCP 握手不需要钱包。

本地设置

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

打开 http://localhost:3000。

直接在 .env.local 中配置密钥。切勿将私钥粘贴到 issue、聊天、截图或客户端环境变量中。

配置

原子 USDC 使用六位小数。默认值将 Telegraph 调用上限设为 $0.10，将目标源 x402 支付上限设为每次请求 $0.05。

HTTP API

本地 Miner 请求示例：

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

受保护操作请求体示例：

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

如果没有 TELEGRAPH_EVM_PRIVATE_KEY，/api/guard 会明确返回 503 payment_not_configured。它不会用模拟证据替代。

在生产环境中，向 /api/guard 和 /api/audit 发送 Authorization: Bearer <PROOFGATE_API_KEY>。Web 控制台仅在组件内存中保留操作者密钥。除非配置了 Upstash Redis 变量，否则 Vercel 部署也会在支付前失败。

Vercel 部署

1. 将公共 GitHub 仓库导入 Vercel，或在项目根目录运行 vercel。

2. 通过 Vercel 的加密环境变量 UI 添加所有必需变量。切勿提交 .env.local。

3. 附加 Upstash Redis 集成并暴露其 REST URL 和令牌。

4. 生成唯一操作者密钥并配置 PROOFGATE_API_KEY。

5. 部署一次，将 PROOFGATE_PUBLIC_URL 设置为分配的 HTTPS 源，然后重新部署，使 /miner.yaml 包含其规范公共 URL。

6. 在准备好全新的、未暴露的一次性钱包之前，保持 TELEGRAPH_EVM_PRIVATE_KEY 未设置。

MCP 服务器

构建并验证 stdio 服务器：

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

冒烟客户端启动捆绑的服务器，执行 MCP 初始化握手，列出其工具，调用免费实时 Telegraph 发现，然后关闭子进程。已提交的 .vscode/mcp.json 将 VS Code 指向 dist/mcp/server.js；在 MCP 主机中启用之前，请先构建一次服务器。

可用工具：

• proofgate_network_status：免费的就绪状态和实时 Miner 发现

• proofgate_scan：付费 Telegraph 扫描，不执行目标

• proofgate_guarded_fetch：付费扫描后跟策略门控的 GET 或 HEAD

• proofgate_audit_tail：带链验证的近期本地决策

服务器从其工作目录加载 .env.local 和 .env。stdout 保留给 MCP JSON-RPC；诊断信息输出到 stderr。

Telegraph Miner 发布

1. 在稳定的公共 HTTPS 源部署 Next.js 服务。

2. 至少配置计划用于生产的信誉提供方。

3. 设置 PROOFGATE_PUBLIC_URL、PROOFGATE_REPOSITORY_URL 以及通过 Telegraph 集成流程分配的注册 ID。

4. 验证 https://your-host.example/miner.yaml 和 https://your-host.example/api/miner/scan 可公开访问。

5. 通过 Telegraph 集成门户验证并提交生成的 YAML。

6. 在宣布可用之前，确认注册并在 Explorer 中测试一次付费请求。

ProofGate 包含基于官方 Telegraph 示例和当前 Base Sepolia Diamond 的 dry-run-first 链上注册工具：

$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

检查步骤获取托管字节的确切内容，验证描述符，计算其 SHA-256，验证钱包 ETH/USDC，并且不发送任何内容。提交步骤重复这些检查，模拟 registerMiner，等待确认，解析 MinerRegistered，并读回记录。已知在聊天中暴露的一次性地址被硬阻止注册。

该仓库不声称 Miner 已注册或已部署。这些步骤需要公共源、门户访问和私有凭据。

验证

& "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

2026-08-19 记录的实时 Base Sepolia 证明：

• Telegraph 目录为 URL_SCAN 选择了 URL Sentinel（Miner 5001）。

• 该 Miner 返回 safe，置信度 0.90；策略返回 ALLOW。

• x402 在交易 0xfb8e...6585中向 Telegraph Diamond 精确结算了 0.01 USDC。

• 受保护的、DNS 固定的请求随后从 https://example.com/ 返回 HTTP 200，包含 559 字节，ProofGate 追加了一条 ACTION 审计记录。

信任边界和残余风险请参阅 SECURITY.md。

诚实的局限性

• Telegraph 上游可用性可能阻止本应有效的付费调用。

• 信誉覆盖范围取决于配置了哪些提供方密钥。

• 干净的结果是证据，而不是目标无害的保证。

• 审计链是防篡改的，但不是加密的，也没有外部见证。

• 重定向会被报告，但有意不跟随。

• Miner 注册和黑客松提交仍然是外部操作者步骤。