Hive Backup

hive-mcp-backup

A2A 网络的快照与备份服务。采用内容寻址的 Blob，并通过 SHA-256 确保完整性；提供指定时间点的列表端点，并通过 x402 按存储费用 $0.01/GB-month、每次恢复费用 $0.05 计量收费。仅限入站。

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

功能

• 存储 每个对象最大 10 MB 的 Agent 负载，并将其作为内容寻址的 Blob 保存到磁盘。
• 验证 每次读取时，均在返回字节前使用 SHA-256 进行校验。
• 列出 指定时间点的快照，可选使用 agent_did 和 since/until 筛选。
• 计量收费 通过 x402 收费：存储费用为 $0.01/GB-month，根据每个 agent_did 每晚计算；每次恢复操作收费 $0.05。

MCP 工具

工具	用途
backup_create	保存最大 10 MB 的负载。返回 ID 和 SHA-256 摘要。
backup_list	列出指定时间点的快照，可按 agent_did 和 created_at 时间范围筛选。
backup_restore	按 ID 恢复并验证 SHA-256。Tier 2；通过 x402 收取 $0.05。

REST 端点

方法	路径	说明
POST	/v1/backup/create	JSON、最大 10 MB 的 multipart，或原始 application/octet-stream。
GET	/v1/backup/list	按 agent_did、since、until、limit、offset 筛选。
GET	/v1/backup/{id}	下载。验证 SHA-256。计量收费。
POST	/v1/backup/restore	返回包含 base64 正文的 JSON。计量收费。
GET	/v1/backup/today	每日计数器和存储费用汇总。
GET	/health	服务运行状况、存储统计信息和定价。
POST	/mcp	通过 Streamable-HTTP / JSON-RPC 2.0 提供 MCP 2024-11-05。

x402

项目	价格	说明
存储	$0.01 / GB-month	根据每个 agent_did 的实时字节总量每日计算。
恢复	$0.05 / 次	在 /v1/backup/{id} 和 /v1/backup/restore 上收费。
预付套餐	$1.00 USDC	购买访问令牌；恢复费用从预付余额中扣除，直至余额耗尽。

结算：Base L2 上的 USDC。

快速参考

# Create
curl -X POST $HOST/v1/backup/create \
  -H 'content-type: application/json' \
  -d '{"agent_did":"did:hive:agent-42","name":"state.json","body":{"v":1}}'

# List
curl -i "$HOST/v1/backup/list?agent_did=did:hive:agent-42"

# Pay, then restore
curl -X POST $HOST/v1/x402/proof/submit \
  -H 'content-type: application/json' \
  -d '{"nonce":"...","payer":"0x...","chain":"base","tx_hash":"0x..."}'

curl -i "$HOST/v1/backup/<id>" -H "X-Hive-Access: hive_..."

配置

变量	默认值
PORT	3000
ENABLE	true
WALLET_ADDRESS	0x15184bf50b3d3f52b60434f8942b7d52f2eb436e
BACKUP_PRICE_PER_GB_MONTH_USD	0.01
BACKUP_PRICE_PER_RESTORE_USD	0.05
BACKUP_PREPAY_BUNDLE_USD	1.0
BACKUP_MAX_OBJECT_BYTES	10485760
BACKUP_DB_PATH	/tmp/backup.db
BACKUP_BLOB_DIR	/tmp/backup_blobs

许可证

MIT。

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