Hive Auction

hive-mcp-auction

入站反向荷兰式拍卖 Agent — Hive Civilization

当 Hive shim 达到速率限制余量时，下一个请求会收到一个带有荷兰式降价封套的 402：起始价格为标准要价的 5 倍，每 30 秒降低 5%，直至有人认领或降至底价。第一个按当前价格完成结算的 Agent 赢得该时段。纯协议交互——没有私信，也没有垃圾信息。仅限入站。

理事会来源：临时提议，由用户于 2026-04-27 提升（Tier A 位置 2，与 HiveBarter 对称互补）。Barter 探索其他人愿意以什么价格出售；拍卖探索其他人愿意为我们的服务支付多少。

---

这是什么

hive-mcp-auction 是一个 Model Context Protocol 服务，负责处理 402 支付接口的入站部分。当 hivemorph 的速率限制器检测到某个 shim 当前的用量超过其余量（默认值为上限的 80%）时，它会签署一个内部 auction_open 请求。此服务随后发布降价曲线，而该 shim 上的下一个 402 封套会在标准 accepts[] 旁附带一个 auction 区块。不想参与的 Agent 按正常要价付款并排队；想立即获得该时段的 Agent 则按当前曲线价格认领。

• 协议： 通过 Streamable-HTTP / JSON-RPC 2.0 传输的 MCP 2024-11-05
• 传输： POST /mcp
• 发现： GET /.well-known/mcp.json
• 健康状态： GET /health
• 结算： Base L2 上的 USDC——真实支付渠道，不是模拟，也不是仿真
• 品牌金色： Pantone 1245 C / #C08D23

工具

工具	层级	描述
auction_open	内部	为稀缺 shim 时段开启新的荷兰式拍卖。仅限 hivemorph 速率限制器进行 HMAC 签名。此工具会公开以供发现；开启拍卖需通过 POST /v1/auction/open。
auction_subscribe	0（免费）	通过 SSE 订阅实时降价曲线。返回订阅 URL。
auction_book	0（免费）	当日汇总：开启次数、关闭次数、平均溢价百分比、累计收取的 USDC。

REST 端点

方法	路径	用途
POST	/v1/auction/open	开启新的荷兰式拍卖（HMAC 签名；仅限 hivemorph）。
GET	/v1/auction/current	获取进行中拍卖的当前价格（确定性）。
GET	/v1/auction/curve	获取完整降价曲线。支持 JSON 或 SSE（Accept: text/event-stream）。
POST	/v1/auction/claim	按当前价格认领。先认领者获胜，并可防止竞态。
GET	/v1/auction/history	已结束拍卖的账本。
GET	/v1/auction/today	当日汇总（Tier 0，免费）。
GET	/health	服务健康状态。

荷兰式降价计算

start_price = asking_usd * 5.0          (5x asking)
floor_price = asking_usd * 0.5          (50% of asking)
drop_pct    = 0.05                      (5% per tick)
interval_s  = 30                        (one tick per 30s)

current_price(t) = max(
  floor_price,
  start_price * (1 - drop_pct) ** floor((t - opened_at) / interval_s)
)

约经过 28 个刻度（约 14 分钟）后，拍卖将降至底价。如果届时无人认领，拍卖将过期，该时段将返回标准 402 流程。**此函数是纯函数。**相同参数会得到相同的分币级结果。没有 RNG、没有数据库读取，也不内置时钟偏差容差。仅凭公开封套即可证明拍卖公平。

402 封套扩展

标准 hivemorph 402 封套加上一个 auction 区块：

{
  "x402_version": 1,
  "ask": "0.05",
  "accepts": [...],
  "auction": {
    "id": "auct_abc123",
    "type": "dutch",
    "asking_usd": "0.05",
    "current_price_usd": "0.2375",
    "start_price_usd": "0.25",
    "floor_price_usd": "0.025",
    "drop_pct": 0.05,
    "interval_s": 30,
    "opened_at": "2026-04-27T20:30:00Z",
    "expires_at": "2026-04-27T20:44:00Z",
    "claim_url": "https://hive-mcp-auction.onrender.com/v1/auction/claim",
    "subscribe_url": "https://hive-mcp-auction.onrender.com/v1/auction/curve?id=auct_abc123",
    "policy": "first-claim-wins"
  }
}

标准 accepts[] 区块保持不变。不想参与的 Agent 按正常要价付款并排队。是否参与拍卖由 claim_url 决定。

认领流程（防竞态，先认领者获胜）

POST /v1/auction/claim
{
  "auction_id": "auct_abc123",
  "claim_at_price_usd": "0.2375",
  "idempotency_key": "{caller-uuid}",
  "tx_hash": "0x..."
}

→ 200 { winner: true, slot_token: "...", expires_in_s: 60 }
→ 409 { winner: false, reason: "already_claimed" }
→ 410 { winner: false, reason: "auction_expired" }
→ 422 { winner: false, reason: "price_mismatch", current_price_usd: "..." }

通过原子 SQLite 操作 UPDATE auctions SET state='claimed' WHERE id=? AND state='open' 强制保证竞态安全。第一个更新到行的 UPDATE 获胜。交易验证采用异步方式——先临时签发 slot_token，再通过 Base RPC 验证链上 Transfer 是否与该钱包匹配。

风险控制

上限	值
同时进行的拍卖数上限	50
相对要价的最大降幅	50%
起始价格最大倍数	10x
拍卖最长时长	14 分钟
每次价格变动后的认领窗口	5 秒
每个调用方的认领速率	10 次/分钟

所有上限均采用故障关闭策略。可通过 env 配置；缺失或无效的 env 始终回退到更严格的默认值。

配置

环境变量	必填	默认值	说明
PORT	否	3000
ENABLE_AUCTION	否	false	默认关闭。除非设为 true，否则 /v1/auction/open 会返回 503。运营方会在钱包验证通过并设置 HMAC 密钥后启用。
WALLET_ADDRESS	否	0x15184…436e	Base 上的 W1 MONROE。
USDC_BASE	否	0x833589…2913	Base 上的 USDC 合约。
BASE_RPC	否	https://mainnet.base.org
AUCTION_OPEN_HMAC_KEY	是（用于开启）	—	共享 HMAC 密钥。必须与 hivemorph 上的值一致。**切勿提交此密钥。**未设置此密钥时，所有 /v1/auction/open 请求都会返回 401。
MAX_CONCURRENT_AUCTIONS	否	50
MAX_DESCENT_PCT	否	0.50
MAX_START_MULT	否	10
AUCTION_MAX_DURATION_S	否	840	14 分钟。
AUCTION_INTERVAL_S	否	30	每 30 秒跳动一次。
AUCTION_DROP_PCT	否	0.05	每次跳动下降 5%。
PUBLIC_BASE_URL	否	https://hive-mcp-auction.onrender.com	用于在信封中构建 claim_url / subscribe_url。

HMAC 签名（供 hivemorph 使用）

Hivemorph 会为每个 /v1/auction/open 请求签名：

ts   = Date.now().toString()
body = JSON.stringify(payload)
sig  = HMAC_SHA256(AUCTION_OPEN_HMAC_KEY, `${ts}.${body}`)

Headers:
  Content-Type: application/json
  X-Hive-Timestamp: ${ts}
  X-Hive-Signature: ${sig.hex}

如果 |now - ts| > 5min 或签名不匹配，服务端会拒绝请求，并以恒定时间进行比较。两个适配层必须持有相同的 AUCTION_OPEN_HMAC_KEY。

本地运行

git clone https://github.com/srotzin/hive-mcp-auction.git
cd hive-mcp-auction
npm install
npm start
# server up on http://localhost:3000/mcp
curl http://localhost:3000/health
curl http://localhost:3000/.well-known/mcp.json
curl http://localhost:3000/v1/auction/today

从 MCP 客户端连接

Claude Desktop / Cursor / Manus — 添加到你的 mcp.json：

{
  "mcpServers": {
    "hive_mcp_auction": {
      "command": "npx",
      "args": ["-y", "mcp-remote@latest", "https://hive-mcp-auction.onrender.com/mcp"]
    }
  }
}

为什么选择荷兰式拍卖（而非维克里拍卖或英式拍卖）

• 荷兰式（形态 α — 本仓库）： 由时钟驱动的确定性价格，先申领者获胜，无需判断，也无法操纵临近截止时的出价；Agent 会通过申领时间表明紧迫程度。
• 维克里拍卖（形态 β）： 需要可信的出价窗口计时；必须防范临近截止时的攻击；Agent 必须相信我们会如实读取密封出价。
• 英式拍卖（形态 γ）： 每场拍卖的收入最高，但即使只有一名竞标者，也会在整个窗口期间占用该时段。适用于独特资产，不适用于可互换的算力。

只有荷兰式拍卖能仅凭公开信封证明其数学上的公平性。形态 β 和 γ 明确不在 v1 的范围内；待形态 α 产生清晰的遥测数据后再重新评估。

Hive Civilization

这是 Hive Civilization 的一部分 — 主权 DID、USDC 结算、Agent 对 Agent 的通道。配套适配层包括 hive-mcp-barter（对称的出站同级服务）、hive-mcp-evaluator、hive-mcp-compute-grid、hive-mcp-depin、hive-mcp-agent-storage、hive-mcp-agent-kyc 和 hive-mcp-trade。

许可证

MIT (c) 2026 Steve Rotzin / Hive Civilization

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