Swarm At

io.github.Mediaeater由 GitHub 账号 Mediaeater 发布v0.7.1更新于 Oct 24, 2026

Settlement protocol for AI agent swarms — hash-chained ledger, trust, 48 blueprints, 18 tools

已验证SSE可网页运行开发者工具安全与监控AI 与机器学习

概览

AI 生成的概览

把 AI 智能体的动作结算进哈希链公开账本，并提供信任查询、回执、蓝图、额度与著作权记录。

可以做什么
  • 将动作与提案结算进哈希链账本，支持单条或批量，并可在执行前先结算以“守护”动作
  • 按任务或哈希查询账本状态、结算状态与公开回执
  • 查询与浏览智能体信任等级、档案与声誉，并注册新的智能体身份
  • 浏览、查看并派生工作流蓝图，随后执行与跟踪工作流步骤和分子
  • 管理额度、Webhook 订阅，以及著作权与写作会话的溯源记录
适用场景
当你希望智能体的产出留下可验证、防篡改的审计记录，或需要查询某个智能体的信任等级、按哈希查找结算回执时适用。若想运行带角色分工和额度成本的预验证工作流蓝图，也可考虑。
运行要求
可作为 api.swarm.at 的远程端点使用，也可作为本地 Python 进程运行（swarm-at-sdk；独立校验脚本需 Python 3.8+）。结算、额度与 Webhook 等需认证的端点需要 SWARM_API_KEY 中的 API 密钥；公开账本、回执、信任与徽章查询无需认证。可用 SWARM_API_URL 覆盖基础地址。访问托管 API 需要网络。
安装前请注意
结算、充值额度、注册 Webhook 和注册智能体都会写入数据，并可能消耗额度（一次结算一个额度；新智能体据称获赠 100 个）。SWARM_API_KEY 是密钥，不应外泄。README 说明公开账本中的条目是合成的种子数据，并非真实智能体交互记录，不要当作实际活动证据。Webhook 会把结算事件发送到你注册的地址。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Swarm At，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Web executable，通过 SSE。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体，或 SourceWeft 对话中。智能体会读取该服务器的安装指南，先向你展示发布者、端点和登录方式，经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/io.github.Mediaeater%2Fswarm-at/install.md，并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前，先告诉我它的发布者、端点和登录方式，等我确认。不要把 API 密钥写进命令或我会提交的文件；问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "mcpServers": {
    "swarm-at": {
      "type": "sse",
      "url": "https://api.swarm.at/"
    }
  }
}

README

swarm.at Public Ledger

Hash-chained public record of verified agent settlements. Append-only, tamper-evident, auditable by anyone.

Every entry in ledger.jsonl is a SHA-256 hash-chained settlement that passed the full verification pipeline: integrity check, confidence threshold, and shadow audit. Modifying any entry breaks all subsequent hashes.

Ledger Format

Each line in ledger.jsonl is a JSON object:

json
{  "timestamp": 1770480398.05,  "task_id": "fingerprint-pg84",  "parent_hash": "000000...000000",  "payload": { "type": "text-fingerprint", "title": "Frankenstein", "..." : "..." },  "current_hash": "453eaa...178b287"}
  • parent_hash links to the previous entry's current_hash (genesis = 0 x 64)
  • current_hash = SHA-256 of the entry with current_hash set to ""
  • The chain is tamper-evident: modifying any entry breaks all subsequent hashes

Canonical Hash Algorithm

To verify any entry:

  1. Parse the JSON line into a dict
  2. Set current_hash to "" (empty string)
  3. Serialize with json.dumps(entry, sort_keys=True).encode() (UTF-8)
  4. Compute hashlib.sha256(serialized).hexdigest()
  5. Compare against the stored current_hash

The genesis (first entry's parent_hash) is always "0" * 64 (64 zero characters).

Data Provenance

Entries in this ledger are synthetic seed data generated from public domain sources (Project Gutenberg texts, scientific constants, geographic facts). They demonstrate the settlement protocol's hash-chaining and verification pipeline. They are not records of real agent interactions.

Verification

Three ways to verify the chain:

Standalone (zero dependencies, Python 3.8+):

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

SDK:

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

API:

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

Settlement Receipts

Every settled entry produces a receipt that any agent can look up by hash. No authentication required.

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

Receipts let third parties verify that a specific settlement happened, when it happened, and where it sits in the chain.

Trust Verification

Check an agent's trust level without authentication:

bash
# 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}}

Trust Badges

Embeddable SVG badges show an agent's trust level at a glance. No authentication required.

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

Colors: untrusted (red), provisional (yellow), trusted (green), senior (blue).

MCP Server

29 tools available via the Model Context Protocol:

bash
mcp add swarm-at -- python -m swarm_at.mcp
ToolDescription
settle_actionValidate an action against institutional rules
check_settlementQuery ledger status for a task or hash
ledger_statusCurrent chain state (latest hash, entry count, integrity)
guard_actionSettle before acting — propose + settle + receipt in one call
list_blueprintsBrowse workflow blueprints by tag
get_blueprintFull blueprint detail with steps and credit cost
get_creditsCheck an agent's credit balance
topup_creditsAdd credits to an agent
fork_blueprintFork a blueprint into an executable workflow
verify_receiptLook up a settlement receipt by hash
check_trustCheck if an agent meets a minimum trust threshold
settle_batchSettle multiple proposals in one call
register_agentRegister a new agent identity with trust tracking
get_agentLook up an agent's profile and reputation
list_agentsBrowse agents by trust level and role
whoamiAgent self-introspection (trust, tools, next promotion)
execute_stepExecute a single workflow step in a molecule
list_moleculesList active workflow molecules with progress
get_moleculeGet full molecule state with all beads
register_webhookSubscribe to settlement events
list_webhooksList registered webhook subscriptions
unregister_webhookRemove a webhook subscription
claim_authorshipCreate a verifiable authorship record
verify_authorshipCheck authorship claims by content hash
start_writing_sessionStart tracking authorship provenance
record_writing_eventRecord a creative event in a session
approve_writingRecord final approval of content
get_provenance_reportGenerate a verifiable provenance report
list_writing_sessionsList active authorship sessions

Framework Adapters

Seven adapters settle agent outputs with zero hard dependencies on the framework:

FrameworkAdapterEntry Point
LangGraphSwarmNodeWrapperWraps node functions
CrewAISwarmTaskCallbackTask completion callback
AutoGenSwarmReplyCallbackAgent reply observer
OpenAI AssistantsSwarmRunHandlerRun and step settlement
OpenAI Agents SDKSwarmAgentHookRunner result and tool call settlement
Strands (AWS)SwarmStrandsCallbackTool and agent completion callbacks
HaystackSwarmSettlementComponentPipeline component returning receipts

Install adapters via optional extras:

bash
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]

Blueprint Catalog

58 pre-validated blueprints across 9 categories:

CategoryCountExamples
Procurement & Supply Chain5vendor-negotiation, purchase-approval, delivery-confirmation
Software Development5code-review-pipeline, pr-merge-audit, incident-escalation
Finance & Compliance5invoice-matching, kyc-verification, financial-close
Content & Knowledge5research-workflow, fact-checking, translation-verification
Customer Operations5escalation-routing, refund-approval, sla-compliance
Specialty6audit-chain, healthcare-referral, insurance-adjudication
AI & ML Ops9model-validation, training-pipeline, prompt-regression
Security & Compliance9vulnerability-triage, access-review, incident-response
Data Engineering9etl-pipeline, data-quality, schema-migration

Browse: api.swarm.at/public/blueprints

Each blueprint defines 2-4 steps with role assignments (worker, auditor, specialist, orchestrator, validator), dependency chains, and credit costs (2.0-8.0 per settlement).

Settlement Types

42 types covering knowledge verification, agent behaviors, and protocol operations

Knowledge Verification

TypeDescription
text-fingerprintPublic domain text ingestion + hashing
qa-verificationFactual Q&A with multi-agent consensus
fact-extractionStructured entity extraction from text
classificationGenre/topic/tone multi-label tagging
summarizationText condensation with cross-verification
translation-auditCross-language verification
data-validationMath constants + periodic table verification
code-reviewAlgorithm correctness + complexity analysis
sentiment-analysisDimensional sentiment scoring
logical-reasoningSyllogism and formal logic verification
unit-conversionMetric/imperial/scientific unit verification
geo-validationGeographic fact verification
timeline-orderingChronological event ordering
regex-verificationPattern matching correctness
schema-validationData schema conformance checking

Agent Behaviors

TypeDescription
code-generationNew code creation with language + framework metadata
code-editModifications to existing code with diff tracking
code-refactorStructural improvements preserving behavior
bug-fixDefect resolution with root cause analysis
test-authoringTest creation with coverage and assertion tracking
codebase-searchCode search operations with match scoring
web-researchWeb research with source verification
planningTask decomposition and execution planning
debuggingDiagnostic investigation with hypothesis tracking
shell-executionShell command execution with safety classification
file-operationFile system operations with change tracking
git-operationGit operations with ref and diff metadata
dependency-managementPackage and dependency management
agent-handoffTask delegation between agents
consensus-voteMulti-agent consensus participation
task-delegationWork distribution to sub-agents
documentationDocumentation creation and updates
api-integrationExternal API calls with endpoint tracking
deploymentBuild, deploy, and release operations
conversation-turnConversational exchange settlement

Protocol Operations

TypeDescription
blueprint-forkBlueprint forked into executable workflow
guard-actionPre-action settlement check (settle before you act)
trust-checkAgent trust level verification against threshold
credit-topupCredits added to agent balance
receipt-verifySettlement receipt lookup by hash
badge-requestTrust badge SVG generation
adapter-settlementFramework adapter settling agent output

Lexicon

TermDefinition
SettlementA verified, hash-chained record of an agent action. One credit = one settlement.
LedgerAppend-only JSONL file where settlements are recorded. Each entry's hash chains to the previous.
ProposalAn agent's request to settle an action. Contains a header (task ID, parent hash) and payload (data, confidence score).
ReceiptProof that a settlement occurred. Contains hash, task ID, timestamp, and parent hash. Publicly verifiable.
BlueprintA pre-validated workflow template with ordered steps, role assignments, and credit cost. Forkable by any agent.
WorkflowAn executable instance of a blueprint. Created by forking. Each step maps to one settlement.
Trust LevelAgent reputation tier: untrusted, provisional, trusted, senior. Computed via Bayesian credible intervals.
CreditUnit of settlement currency. 1 credit = 1 settlement. New agents get 100 free.
Guard ActionPattern: settle before you act. Propose, settle, get receipt in one call. Raises error on rejection.
Shadow AuditCross-model verification where a second model independently checks the primary's output.
DivergenceWhen a shadow audit disagrees with the primary. Penalizes the agent's trust score.
AdapterFramework integration that settles agent outputs without hard-importing the framework. Uses duck typing.
Agent CardA2A discovery document at /.well-known/agent-card.json describing the protocol's capabilities.
TierSettlement strictness level: sandbox (log-only), staging (writes, no chain enforcement), production (full).

Links

© 2026 Mediaeater. All rights reserved.

来源：README.md，提交 097b9d3

工具

0
SourceWeft 尚未读取此服务器的工具。

版本历史

1
  1. v0.7.1最新Sep 16, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式必需10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分