Hive Flag

hive-mcp-flag

A2A 网络的功能标志服务 — Hive Civilization。 基于 DID 的定向投放、百分比渐进发布，以及在 Base L2 上通过 x402 结算 USDC。MCP 2024-11-05。仅支持入站。

无需重新部署 Agent，即可禁用失控行为、在 DID 前缀金丝雀中启用新工具，或将配置更改逐步推广至 25% 的 Agent。采用类似 LaunchDarkly 的语义和原生支持 Agent 的基础构件。

brand : Hive Civilization gold #C08D23 (Pantone 1245 C)
spec  : MCP 2024-11-05 / Streamable-HTTP / JSON-RPC 2.0
wallet: W1 MONROE 0x15184bf50b3d3f52b60434f8942b7d52f2eb436e (Base)

快速开始

git clone https://github.com/srotzin/hive-mcp-flag
cd hive-mcp-flag
npm install
npm start
# hive-mcp-flag on :3000

托管端点：https://hive-mcp-flag.onrender.com/mcp

工具和定价

工具	美元 / 次调用	说明
flag_eval	$0.0005	为某个 DID 评估标志；返回解析后的值和匹配的规则。
flag_list	免费	列出某个 DID 拥有的标志。
flag_describe	免费	标志的完整定义和近期评估记录。
flag_create	$0.001	创建带默认值和定向规则的标志。
flag_update	$0.0005	更新默认值或定向规则。仅限所有者。
flag_delete	$0.001	将标志标记为已删除。仅限所有者。

所有付款均为入站付款。在请求正文或 x402-tx-hash 标头中提交 Base USDC tx_hash（调用方 → W1）。shim 会从 Base RPC 读取交易收据，解码 USDC Transfer 日志，并在提供服务前验证接收方和金额。

定向规则

规则按声明顺序评估。匹配第一条规则后即停止。如果都不匹配，则返回标志的 default_value。

[
  { "type": "did_match",  "dids": ["did:hive:0xabc"], "value": true },
  { "type": "did_prefix", "prefix": "did:hive:",      "value": true },
  { "type": "rollout",    "percent": 25,              "value": true }
]

rollout 使用 SHA256(did + flag_key) mod 100，因此相同的 (did, flag_key) 配对始终落入同一分桶——变体分配保持稳定，无需额外存储。

REST API

POST   /v1/flag/eval                # body: { flag_key, evaluating_did, tx_hash }
GET    /v1/flag/list?owner_did=...
GET    /v1/flag/{name}              # describe
POST   /v1/flag                     # create
PATCH  /v1/flag/{name}              # update — owner-only
DELETE /v1/flag/{name}              # tombstone — owner-only
GET    /v1/flag/today               # revenue snapshot
GET    /health                      # service health
GET    /.well-known/mcp.json        # MCP discovery
POST   /mcp                         # JSON-RPC 2.0

MCP 示例

{
  "jsonrpc": "2.0", "id": 1, "method": "tools/call",
  "params": {
    "name": "flag_eval",
    "arguments": {
      "flag_key": "new_routing_v2",
      "evaluating_did": "did:hive:0xabc",
      "tx_hash": "0xBASE_TX_PAYING_$0.0005_USDC_TO_W1"
    }
  }
}

实际使用的基础设施

领域	库	行为
持久化	better-sqlite3	在 /tmp/flag.db 中使用 SQLite、WAL 模式，并以事务方式执行创建和更新。
签名验证	ethers.verifyMessage	恢复消息签名者，并与声称的地址进行比对。
付款验证	ethers.JsonRpcProvider	从 Base RPC 读取交易收据，解码 USDC Transfer 日志，并断言 to == W1 且 amount >= asking_usd。

仅在本地开发或测试时设置 VERIFY_ONCHAIN=false——默认配置和生产部署都会进行链上验证。

环境变量

变量	默认值	用途
PORT	3000	HTTP 端口
ENABLE	true	总开关（设为 false 可进入降级状态）
WALLET_ADDRESS	W1	Base L2 接收方
BASE_RPC_URL	https://mainnet.base.org	用于读取交易收据的 RPC
VERIFY_ONCHAIN	true	在提供付费调用前读取 Base 上的交易收据
MAX_FLAGS_PER_DID	500	每位所有者的上限
DB_PATH	/tmp/flag.db	SQLite 文件

限制

• MAX_FLAGS_PER_DID = 500
• 每个标志最多 50 条定向规则
• 请求正文上限：256 KB

暂不支持（v1.1+）

标志前置条件（B 依赖 A）、自动渐进发布、推送通知和变更 Webhook、多环境命名空间、控制面板 UI。

永久拒绝支持：基于标志状态的金融工具、预测或衍生品。

---

Hive Civilization · MIT · github.com/srotzin/hive-mcp-flag

Hive Civilization 目录

属于 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