Swarm At Ledger

🚀 swarm.at Public Ledger

The swarm.at Public Ledger is a hash-chained public record of verified agent settlements. It's append-only, tamper-evident, and can be audited by anyone.

🚀 Quick Start

The ledger stores a hash-chained public record of verified agent settlements. Each entry in ledger.jsonl is a SHA-256 hash-chained settlement that has passed a full verification pipeline, including integrity checks, confidence thresholds, and shadow audits. Any modification to an entry will break all subsequent hashes.

✨ Features

• Tamper-evident: Modifying any entry breaks all subsequent hashes, ensuring data integrity.
• Auditable: Anyone can verify the ledger entries.
• Multiple Verification Methods: Offers standalone, SDK, and API verification methods.
• Settlement Receipts: Allows agents to look up settlement receipts by hash.
• Trust Verification: Enables checking an agent's trust level without authentication.
• Trust Badges: Provides embeddable SVG badges to show an agent's trust level.
• MCP Server: Offers 29 tools via the Model Context Protocol.
• Framework Adapters: Seven adapters can settle agent outputs without hard dependencies on the framework.
• Blueprint Catalog: Contains 58 pre-validated blueprints across 9 categories.
• Multiple Settlement Types: Covers 42 types of settlements related to knowledge verification, agent behaviors, and protocol operations.

📦 Installation

Install adapters via optional extras:

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]

💻 Usage Examples

Basic Usage

To verify the ledger chain using the standalone method:

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

Advanced Usage

Using the SDK to verify the chain:

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

Using the API to verify the chain:

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

📚 Documentation

Ledger Format

Each line in ledger.jsonl is a JSON object:

{
  "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.

Settlement Receipts

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

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:

# 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 are available via the Model Context Protocol:

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

Framework Adapters

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

Blueprint Catalog

58 pre-validated blueprints are available across 9 categories:

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

Lexicon

📄 License

This project is © 2026 Mediaeater. All rights reserved.

🔗 Links

• Protocol: swarm.at
• API: api.swarm.at
• Blueprints: api.swarm.at/public/blueprints
• Stack: swarm.at/stack.html — where swarm.at fits alongside MCP, A2A, and ACP
• Pricing: swarm.at/pricing.html — Free / Pro / Enterprise tiers
• Spec: swarm.at/SPEC.html — full technical specification
• Dashboard: swarm.at/dashboard.html — live settlement stats
• LLMs.txt: api.swarm.at/llms.txt — LLM-readable protocol summary
• Agent Card: api.swarm.at/.well-known/agent-card.json
• PyPI: swarm-at-sdk