Hive Sla Monitor

hive-mcp-sla-monitor

A2A 网络的 SLA 观测代理。Agent 注册公开的健康端点，并设定目标运行时间和 p95 延迟；shim 按 60s 的计划周期对端点进行探测（只读 HTTP，超时设为 8s）并记录结果。当滚动窗口内未达到目标时，会写入一条违约记录。读取违约记录需付费。仅限入站。默认情况下，ENABLE=true。

品牌颜色：#C08D23（Pantone 1245 C，Hive Civilization 金色）。

仅供观测

Hive 不承保或结算 SLA 索赔。这里只提供观测数据。shim 不托管资金、不支付索赔，也不对交易对手提供赔偿。每条付费响应和每条违约记录都会附带免责声明。

接口

层	端点	描述
MCP	POST /mcp	JSON-RPC 2.0，Streamable-HTTP，协议版本 2024-11-05。
发现	GET /.well-known/mcp.json	工具列表和传输元数据。
REST	POST /v1/sla/register	注册端点。无付款凭证时返回 402。
REST	GET /v1/sla/status/{id}	读取观测到的运行时间和 p95。无付款凭证时返回 402。
REST	GET /v1/sla/breaches?monitor_id=…	读取近期违约记录。无付款凭证时返回 402。
REST	GET /v1/sla/today	UTC 当日账本快照。免费。
健康检查	GET /health	存活状态、定价和收款地址。
根路径	GET /	面向浏览器的 HTML，面向 Agent 的 JSON（通过 Accept 请求头识别）。

工具

名称	层级	费用	描述
sla_register	1	$0.01/次探测	注册公开端点以供探测。
sla_status	1	$0.01	读取滚动窗口内观测到的运行时间和 p95。
sla_breach_history	2	$0.10	读取近期违约记录。每条记录都会附带免责声明。
sla_unregister	0	免费	停用监控项。

探测语义

调度器每隔 60 秒扫描活跃监控项，并发送带有 8 秒超时的 GET 请求。2xx 和 3xx 视为正常；5xx 和超时视为异常。探测记录与监控项记录及所有违约记录一起存储在 /tmp/sla.db 中。

每次探测后都会运行违约评估器。它会检查滚动窗口（默认 60 分钟），计算观测到的运行时间和 p95 延迟；如果任一指标未达到目标，就会记录违约。同一窗口时长的一半内发生的重复违约会经过防抖处理，避免单个异常窗口产生大量记录。

为确保探测扇出行为可预测，服务将活跃监控项数量限制为 100（SLA_MAX_MONITORS）。

x402 信封

每个付费端点在首次访问时都会返回一个 402 信封：

{
  "error": "payment_required",
  "x402_version": 1,
  "disclaimer": "Hive does not underwrite or settle SLA claims. This is observational data only.",
  "payment": {
    "nonce": "…",
    "amount_usd": 0.01,
    "accept_min_usd": 0.007,
    "accepts": [{
      "chain": "base",
      "asset": "USDC",
      "contract": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
      "decimals": 6,
      "recipient": "0x15184bf50b3d3f52b60434f8942b7d52f2eb436e",
      "scheme": "exact"
    }],
    "tier": 1,
    "product": "sla_register",
    "floor_pct": 0.7
  }
}

重试时通过 X-Payment 请求头内联提交付款凭证，或将其 POST 以获取用于 X-Hive-Access 的访问令牌。

定价采用 hivemorph 的易货底价模式：信封会同时公布 amount_usd（要价）和 accept_min_usd（底价）。客户端可以提交链上实付金额处于 [floor, asking] 范围内的付款凭证，shim 会予以接受。

结算

将 USDC 转入上述收款地址，使用 Base L2（0x833589fcd6edb6e08f4c7c32d4f71b54bda02913）。验证时会根据配置的 Base RPC，检查收据中的 Transfer 日志。读取的是真实链上数据，不使用模拟数据。单个 tx_hash 只能兑换一次。

环境

变量	默认值	说明
PORT	3000	HTTP 端口。
ENABLE	true	为 false 时，仅 /health 和 / 会响应。
WALLET_ADDRESS	0x1518…436e	USDC 接收方。
SLA_REGISTER_PRICE_USDC	0.01	每次注册的费用。
SLA_BREACH_PRICE_USDC	0.10	每次读取违约历史的费用。
SLA_STATUS_PRICE_USDC	0.01	每次读取状态的费用。
SLA_PROBE_INTERVAL_MS	60000	探测循环间隔。
SLA_PROBE_TIMEOUT_MS	8000	每次探测的 HTTP 超时时间。
SLA_MAX_MONITORS	100	活跃监控项上限。
BASE_RPC_URL	https://mainnet.base.org	Base L2 JSON-RPC。
SLA_DB_PATH	/tmp/sla.db	SQLite 路径。

运行

npm install
npm start
# → http://localhost:3000/health

许可证

MIT。作者：Steve Rotzin [email protected]。

Hive Civilization Directory

属于 Hive Civilization——面向 Agent 的金融基础设施。

• 端点目录：https://thehiveryiq.com
• 实时排行榜：https://hive-a2amev.onrender.com/leaderboard
• 收入仪表板：https://hivemine-dashboard.onrender.com
• 其他 MCP 服务：https://github.com/srotzin?tab=repositories&q=hive-mcp

品牌色：#C08D23