tercet

Das Hauptbuch für Maschinenzahlungen. Jeder Agentenkauf wird in dem Moment aufgezeichnet, in dem er passiert (Anfrage → Angebot → signierte Autorisierung), anschließend mit der On-Chain-Abwicklung abgeglichen, und jede Abweichung bekommt einen Namen — geliefert-aber-nicht-eingelöst, bezahlt-ohne-Lieferung, Replay, Chain-Orphan. tercet fasst niemals Schlüssel, Kontostände oder den Zahlungsweg an: Es beobachtet und erzeugt Beweise.

Ein Terzett ist eine Strophe aus drei zusammengehörigen Zeilen — hier ist jeder Kauf eines: die Anfrage, die Autorisierung, die Abwicklung. Dante verkettete seine Terzette so, dass keines herausgelöst werden konnte, ohne das Gedicht zu zerbrechen; dieses Hauptbuch verkettet seine Einträge auf dieselbe Weise.

Das Python-Paket heißt noch mesa (Arbeitstitel); mit der ersten PyPI-Veröffentlichung wird es zu tercet umbenannt. Die Projektdokumentation unter docs/ ist auf Portugiesisch geschrieben — sie besteht aus dem Aufbau-Tagebuch und den phasenweisen Designrichtgruppen; Code, Schemas und diese README sind auf Englisch.

Grundformat — das Hauptbuch, live, in sechs Ansichten

uv run mesa-app        # -> http://127.0.0.1:8400

01 blotter (was Ihre Agents- einkauft haben, mit abgeleitetem Zustand und der Ereigniskette jedes Kaufs) · 02 tca (Verschwendung, Entdoppelung über mehrere Agents, Kosten pro ausgeliefertem Ergebnis · 03 risk (Budget pro Task-Baum, menschliche Freigaben, der Payer-Pass) · 04 lab (Point-in-Time-Backtest der Ausgabenpolitik mit ehrlichen Konfidenzintervallen) · 05 Rall (Drei-Wege-Abgleich, versiegelte Perioden mit zwei Zeitstempeln tritte Partei, Opfern-Details-Parallel, BR-Steueransicht) · 06 operations (als abgehörten Engines direkt am Bildschirm selbst — Demo, Sammler, Exporte — nur Testnet).

Die App ist strukturell schreibgeschützt: Ihre Postgres-Sitzung wird mit default_transaction_read_only=on geöffnet, kann also selbst dann nicht in das Hauptbuch schreiben , wenn sie es vorst — und tests/test_app.py beweist es. Immer echte Daten; Testnet- und synthetische Zeilen werden auf dem Bildschirm direkt gekennzeichnet. „Durch Klick auf eine beliebige Pill wird ihre Legende angezeigt.

Related MCP server: swarm-at

Der MCP-Server — das Hauptbuch als Werkzeuge für Agents

claude mcp add tercet -- uv run mesa-mcp    # then ask: "how much did my agents spend?"

Sieben READ-Werkzeuge (geschlossene Liste, durch Tests belegt): status_do_livro, gasto, compras (filtert), compra (ein Kauf + seine Ereigniskette), vereditos, passaportes, fiscal. Die gleiche Garantie wie in der App: die Sitzung ist strukturell schreibgeschützt — der MCP-Server hat keinen Schreibpfad; das beweist tests/test_mcp_livro.py. Transport: stdio, lokal.

Die Exporte — universelle Buchhaltung + OECD-CARF-Ansicht

uv run python scripts/fase13/contabil_build.py   # -> contabil/<yyyy-mm>/  (universal CSV, QuickBooks, Xero + per-tx audit detail)
uv run python scripts/fase13/carf_build.py       # -> fiscal/carf/<year>/  (OECD CARF view, born as OECD11 test data)

Ein Journal der doppelten Buchhaltung pro Zeitraum (Soll == Haben wird bewiesen; Mikrozahlungen werden sauber aggregiert, mit einer auditierbaren 6-Dezimal-Brücke, die jeden Cent an einen Tx-Hash bindet, und der CARF-Varianten — was ein meldepflichtiger Chip-Handler unter der OECD-Framework (offizieller Leitfaden, Juli 2025) über diese Transaktionen melden müsste — als Demo gekennzeichnet, synthetisch identifikation, echte Zahlen. Details einschätzen und Hinweise: docs/fase13-export.md.

Von null — allein mithilfe dieser README

Voraussetzungen, uv, Porz 3.11+.

# 1. dependencies + database (Postgres 17 on 127.0.0.1:5433 — your machine only)
uv sync
docker run -d --name mesa-pg -e POSTGRES_USER=mesa -e POSTGRES_PASSWORD=mesa `
  -e POSTGRES_DB=mesa -p 127.0.0.1:5433:5432 `
  -v mesa-pgdata:/var/lib/postgresql/data postgres:17
uv run python scripts/check_db.py            # migrations + hash-chain genesis, idempotent

# 2. TEST wallets (written to a local .env; never committed) + faucet USDC
uv run python scripts/setup_wallets.py
#    -> paste the buyer address into https://faucet.circle.com (USDC / Base Sepolia)
uv run python scripts/check_balance.py       # balance read on-chain

# 3. a toy seller + 10 REAL x402 payments on testnet
uv run uvicorn mesa.http.seller:app --port 8402     # terminal 1
uv run python scripts/fase1/buyer.py 10             # terminal 2 (writes the ledger)

# 4. the chain is the source of truth: collect and reconcile
uv run python -m mesa.collector              # matches (authorizer, nonce) with the ledger
uv run python -m mesa.cli                    # the verdict table, orphans in red

# 5. the product
uv run mesa-app                              # -> http://127.0.0.1:8400

Das kostet neutral null echtes Geld: USDC aus dem Wasserhahn und unter dem exact-Schema trägt der Facilitator „Drei“.

gas.

• „Was passiert ist, was er beweis wurde, was als Nächstes kommt: docs/DIARIO.md (Portugiesisch) — das Aufbau-Tagebuch pro Task; phasenweise Design-Dokumente liegen in docs/faseN.md.

• Secrets-Platzhalter (die privaten Schlüssel, die setup_wallets.py generiert) kommmen in eine lokate .env (gitignored, niemals committet). Wenn sie woanders gespeichert werden sollen, setzen Sie MESA_ENV_FILE auf eine Datei — und nicht in synchronisiert Ordner (OneDrive/Dropbox) legen: Ein Schlüssel darin ist auch in der Wolke.

Repo-Übersicht

Umgebung

uv sync
docker run -d --name mesa-pg -e POSTGRES_USER=mesa -e POSTGRES_PASSWORD=mesa `
  -e POSTGRES_DB=mesa -p 127.0.0.1:5433:5432 `
  -v mesa-pgdata:/var/lib/postgresql/data postgres:17
# 127.0.0.1 is mandatory: without it the ledger is open to any machine on the same
# Wi-Fi (docs/seguranca.md, hole #1). scripts/saude.py checks this, always.
uv run python scripts/setup_wallets.py   # generates the EOAs -> .env (NEVER committed)
uv run python scripts/check_db.py        # Postgres up + migrations + genesis
uv run python scripts/check_balance.py   # USDC balance read on-chain
uv run python scripts/saude.py           # ONE command: ruff+mypy+pytest+verifier+ports+secret scan
uv run python scripts/backup_db.py       # ledger dump -> backups/ (routine, ~5s)

Faucet: https://faucet.circle.com → USDC → Basis Sepolia (20 USDC / 20). Anthropic-Schlüssel (nur für Agenten-Demo der Invoice-Rail): ANTHROPIC_API_KEY=... in deiner Secret-Env-Datei.

Beweisen für jedes Phase ausführen

# Phase 1 — the ledger closes on dirty data
uv run uvicorn mesa.http.seller:app --port 8402     # terminal 1: HTTP seller
uv run python scripts/fase1/chaos_run.py            # terminal 2: chaos + reconciliation + asserts

# Phase 2 — x402 over MCP
uv run python -m mesa.mcp.seller                    # terminal 1: MCP seller (port 8403)
uv run python scripts/fase2/mcp_once.py             # terminal 2: 1 paid tool call + ledger

# Phase 10 — the payer passport (emits, verifies, gates a seller)
uv run python scripts/fase10/gate10_demo.py

# Any time: sweep the chain and reconcile
uv run python -m mesa.collector                      # testnet (seller payTo)
uv run python -m mesa.collector --pagador            # mainnet (payer-side)
uv run python -m mesa.cli

Qualität („fertig“ hat eine Definition)

uv run python scripts/saude.py    # ONE command: ruff+mypy+pytest+verifier+ports+secret scan

Gefährdungsmodell und was außerhalb der Rahmen nonepossible ist — namentlich ausgeführt: docs/seguranca.md.