nano-empire-tollbooth 0.1.0

Paper-mode protocol tollbooth for A2A agent swarms

nano-empire-tollbooth

Paper-mode protocol tollbooth for A2A agent swarms.

The package meters routed agent messages, writes a JSONL settlement ledger, and exposes a fail-closed live-mode verifier hook. It is designed as a developer-facing wedge for A2A Gateway pilots, not as autonomous payment capture.

Install

pip install nano-empire-tollbooth

Quick Start

import asyncio
from nano_empire_tollbooth import Tollbooth, TollboothConfig

booth = Tollbooth(TollboothConfig(paper_mode=True))

async def main() -> None:
    record = await booth.charge(
        task_id="task-123",
        source_agent="agent-alpha",
        target_agent="agent-beta",
    )
    print(record.status.value, record.amount_usd)

asyncio.run(main())

Safety Defaults

• paper_mode=True by default.
• TOLLBOOTH_PAPER_MODE=true forces paper mode.
• Live mode with require_payment_before_route=True returns pending unless wallet, signature, and verifier are present.
• Live mode with an invalid verifier result returns failed.
• Ledger records are append-only JSONL entries.

Revenue Path

Use the SDK as a proof asset for:

• $299 Diagram-to-Agent Workflow Audit
• $999 A2A Gateway Pilot
• enterprise private mesh integration

Publishing, live payment activation, and external outreach remain human-approved actions.