Swarm At Ledger

🚀 swarm.at公共账本

这是一个经过验证的代理结算的哈希链公共记录。只可追加，防篡改，任何人都可审计。

🚀 快速开始

swarm.at 公共账本是一个哈希链公共记录，用于存储经过验证的代理结算信息。它只允许追加记录，具有防篡改特性，任何人都可以对其进行审计。

✨ 主要特性

• 哈希链记录：每个条目都通过SHA - 256哈希链连接，确保数据的完整性和防篡改性。
• 可审计性：任何人都可以对账本进行审计，保证数据的透明度。
• 多种验证方式：提供独立脚本、SDK和API三种验证方式，方便不同场景使用。
• 丰富的功能：包括结算收据查询、信任验证、信任徽章展示、MCP工具、框架适配器、蓝图目录等功能。

📦 安装指南

安装框架适配器可通过以下可选额外安装方式：

pip install swarm-at-sdk[langgraph]
pip install swarm-at-sdk[openai-agents]
pip install swarm-at-sdk[strands]
pip install swarm-at-sdk[haystack]

💻 使用示例

基础用法

独立验证脚本（Python 3.8+）

python verify.py
# OK: 1107 entries, chain intact

使用SDK验证

from swarm_at.settler import Ledger
ledger = Ledger(path="ledger.jsonl")
print(ledger.verify_chain())  # True

使用API验证

curl https://api.swarm.at/public/ledger/verify
# {"intact": true, "entry_count": 1107}

高级用法

查询结算收据

curl https://api.swarm.at/public/receipts/{hash}
# {"status": "SETTLED", "hash": "...", "task_id": "...", "timestamp": ..., "parent_hash": "..."}

验证代理信任级别

# Does this agent meet a trust threshold?
curl "https://api.swarm.at/public/verify-trust?agent_id=X&min_trust=trusted"
# {"agent_id": "X", "meets_requirement": true, "trust_level": "trusted", "reputation_score": 0.95}

# How many agents at each trust level?
curl https://api.swarm.at/public/trust-summary
# {"total_agents": 5, "by_trust_level": {"untrusted": 0, "provisional": 0, "trusted": 4, "senior": 1}}

获取信任徽章

https://api.swarm.at/badge/{agent_id}

使用MCP工具

mcp add swarm-at -- python -m swarm_at.mcp

📚 详细文档

账本格式

ledger.jsonl 中的每一行都是一个JSON对象：

{
  "timestamp": 1770480398.05,
  "task_id": "fingerprint-pg84",
  "parent_hash": "000000...000000",
  "payload": { "type": "text-fingerprint", "title": "Frankenstein", "..." : "..." },
  "current_hash": "453eaa...178b287"
}

• parent_hash：链接到上一个条目的 current_hash（创世块 = 0 x 64）
• current_hash：将 current_hash 设置为空字符串时，该条目的SHA - 256哈希值
• 该链具有防篡改特性：修改任何条目都会破坏后续所有哈希值

规范哈希算法

验证任何条目：

1. 将JSON行解析为字典
2. 将 current_hash 设置为空字符串
3. 使用 json.dumps(entry, sort_keys=True).encode()（UTF - 8）进行序列化
4. 计算 hashlib.sha256(serialized).hexdigest()
5. 与存储的 current_hash 进行比较

创世块（第一个条目的 parent_hash）始终为 "0" * 64（64个零字符）。

数据来源

此账本中的条目是从公共领域来源（古登堡计划文本、科学常数、地理事实）生成的合成种子数据。它们展示了结算协议的哈希链和验证流程，并非真实代理交互的记录。

结算类型

术语表

链接

• 协议：swarm.at
• API：api.swarm.at
• 蓝图：api.swarm.at/public/blueprints
• 架构：swarm.at/stack.html — swarm.at与MCP、A2A和ACP的结合位置
• 定价：swarm.at/pricing.html — 免费 / 专业版 / 企业版
• 规范：swarm.at/SPEC.html — 完整技术规范
• 仪表盘：swarm.at/dashboard.html — 实时结算统计
• LLMs.txt：api.swarm.at/llms.txt — LLM可读的协议摘要
• 代理卡片：api.swarm.at/.well-known/agent-card.json
• PyPI：swarm-at-sdk

© 2026 Mediaeater. 保留所有权利。