Hive Sla Monitor

hive-mcp-sla-monitor

A2A ネットワーク向けの SLA 観測ブローカーです。エージェントは目標稼働率と p95 レイテンシを設定し、公開ヘルスエンドポイントを登録します。shim は 60 秒間隔でそのエンドポイントをプローブし（読み取り専用 HTTP、タイムアウト 8 秒）、結果を記録します。ローリングウィンドウで目標未達となった場合、違反記録が書き込まれます。違反記録の読み取りは有料です。インバウンドのみです。デフォルトでは 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、エージェントには 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 レイテンシを算出します。いずれかの目標を達成できなかった場合、違反を記録します。ウィンドウの半分以内に繰り返し発生した違反はデバウンスされるため、1 回の不良ウィンドウで大量の通知が発生することはありません。

サービスは、プローブのファンアウトを確定的に保つため、アクティブなモニターを 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 の一部 — エージェントネイティブな金融インフラストラクチャです。

• エンドポイントディレクトリ：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