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. 保留所有權利。