关于 blackwall-x402-guardrail
blackwall-x402-guardrail 是托管式远程 MCP 服务,为 x402 支付提供签名前风险判断。它返回 GO、HOLD 或 STOP、相关信号及可由第三方验证的签名回执。
主要功能
- 01提供 GO、HOLD 或 STOP 判断
- 02检查收款方结算声誉
- 03检测报价与收款方中位数的偏差
- 04检查 OFAC 制裁信号
- 05生成 Ed25519 签名回执
适用场景
- 01在签署 x402 支付前评估风险
- 02查看支付判断的原因与信号
- 03让第三方验证已签名的回执
MCP 相关
该远程 MCP 服务通过 Streamable HTTP 提供 forecast_payment 工具,并将请求转发至 x402 oracle。发生错误或未返回有效判断时,工具返回错误而非 GO。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://mcp.blackwalltier.comclaude mcp add --transport http com-blackwalltier-blackwall-x402-guardrail https://mcp.blackwalltier.com{"mcpServers":{"com-blackwalltier-blackwall-x402-guardrail":{"type":"http","url":"https://mcp.blackwalltier.com"}}}在 Cursor 中打开{"servers":{"com-blackwalltier-blackwall-x402-guardrail":{"type":"http","url":"https://mcp.blackwalltier.com"}}}在 VS Code 中打开{"mcpServers":{"com-blackwalltier-blackwall-x402-guardrail":{"type":"http","url":"https://mcp.blackwalltier.com"}}}{"mcpServers":{"com-blackwalltier-blackwall-x402-guardrail":{"serverUrl":"https://mcp.blackwalltier.com"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
1| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| asset | string | 是 | 例如 USDC |
| chain | string | 是 | e.g. base |
| payer | string | 否 | Agent 的 EVM 钱包(可选;用于绑定结算) |
| amount | string | 是 | 金额,以十进制字符串表示,例如 "0.09" |
| context | object | 否 | {quoted_price_history, expected_recipient} |
| agent_id | string | 否 | 调用方 DID/身份标识 |
| resource | string | 否 | 付款对象 |
| counterparty | string | 是 | 402 响应中的收款方钱包 |
详细介绍
Black_Wall 远程 MCP
托管的远程 MCP(基于 HTTP 的模型上下文协议),可为任何支持 MCP 的 Agent 提供签名前的支付风险判定——无需安装或注册。添加一个 URL,Agent 就能在签署 x402 支付前询问 “我该支付吗?”,并获得放行 / 暂缓 / 拒绝的判定,依据包括交易对手的结算信誉、价格异常(报价与收款方自身的中位数相比)和 OFAC 制裁信息——以及一份可由第三方验证的 Ed25519 签名回执。
添加
将 MCP 客户端指向:
https://mcp.blackwalltier.com
传输方式:Streamable HTTP。无需 API 密钥。风险金额低于 $10 时,判定免费;达到或超过该金额时,工具会返回 x402 支付质询,由 Agent 使用自己的钱包完成结算(将已结算的支付作为 X-PAYMENT 标头传回,然后重试)。
工具:forecast_payment
| 字段 | ||
|---|---|---|
counterparty | 字符串,必填 | 来自 402 的收款方钱包 |
amount | 字符串,必填 | 十进制字符串,例如 "0.09" |
asset | 字符串,必填 | 例如 USDC |
chain | 字符串,必填 | 例如 base |
payer / resource / agent_id / context | 可选 | 绑定结算 / 上下文 |
返回判定(GO/HOLD/STOP)+ 原因 + 信号,以及任何人都可以使用已发布的密钥验证的 signed_receipt:
https://agent-egress-proxy.onrender.com/.well-known/blackwall-receipt-key.json
(使用任何 RFC 8032 Ed25519 库验证)——整个过程无需 Black_Wall 介入。
工作原理
此 Worker 是一个轻量级传输层 + 代理:它支持最精简的 MCP JSON-RPC
(initialize / tools/list / tools/call / ping),并将
forecast_payment 调用转发给 Black_Wall x402 预言机。所有判定逻辑和回执均原样来自该预言机。
**设计上默认拒绝:**如果预言机出错、无法访问或返回非判定结果,工具就会返回错误——绝不会返回虚假的 GO。无法连接后端的支付防护工具绝不能暗示“支付安全”。
注册表
已发布到官方 MCP 注册表,名称为
com.blackwalltier/blackwall-x402-guardrail。
开发
node test.mjs # unit tests (mocked oracle)
npx wrangler dev # run locally
npx wrangler deploy # deploy (Cloudflare Workers)
由 BlueTier 提供。仅提供判定——绝不托管资金,也不参与结算流程。 没有证据不代表可信。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。