# Formát ledgeru

> Tvar záznamu, hash řetězec, podpisy a offline ověření.

Reading time: 9 min. Source: https://www.voidagent.tech/cs/docs/ledger

Ledger je pouze pro přidávání, propojený hashi a podepsaný pro každý workspace. Je zároveň zásobníkem pro vrácení a záznamem pro compliance, a v tom je celá pointa: zásobník, kterému nikdo nevěří, není záznam, a záznam, který nelze provést, není zásobník pro vrácení.

## Záznam

```entry.json
{
  "sequence": 1042,
  "workspace": "acme",
  "agent": "billing-ops",
  "timestamp": "2026-08-21T09:14:11.204Z",
  "intent": "issue_refund",
  "tool": "stripe.refunds.create",
  "payload_digest": "sha256:7d19..c4b2",
  "blast_radius": { "systems": ["payments", "ledger", "mail"], "records": 3 },
  "class": "R3",
  "policy": { "decision": "hold", "rule": "irreversible transfer" },
  "approved_by": "dana@acme.example",
  "result": { "status": "ok", "external_id": "re_3P9k" },
  "snapshot": null,
  "compensation": null,
  "budget_entry": "r3:2026-08-21:1of2",
  "prev_hash": "0x9f3c..77d1",
  "hash": "0xa10e..3b08",
  "signature": "ed25519:5f21..ee90"
}
```

## Řetězec

hash = sha256(canonical_json(entry without hash and signature) || prev_hash). Podpis pokrývá hash. Odebrání záznamu rozbije každý hash za ním a vyrazení náhradního řetězce vyžaduje klíč workspace.

## Ověření

```shell
$ void verify ./export.jsonl --key pk.pem
  + 18 422 záznamů, řetězec neporušen
  + 18 422 podpisů v pořádku
  + 0 mezer
  + head 0xa10e..3b08 odpovídá manifestu
```

> Ověření je záměrně offline. Auditor potřebuje exportní soubor, veřejný klíč a binárku ověřovače. Není potřeba žádný přístup k síti VOID.

## Kompenzační záznamy

Replay zapisuje vlastní záznamy, takže je zpětný posun sám o sobě auditovatelný. Kompenzační záznam odkazuje na pořadové číslo, které vrací.

```compensation.json
{
  "sequence": 1103,
  "kind": "compensation",
  "reverses": 1039,
  "class": "R0",
  "action": "restore(sha256:4c2e..91af)",
  "result": { "status": "ok", "digest_match": true },
  "operator": "dana@acme.example",
  "prev_hash": "0xbb41..09c2",
  "hash": "0xcc77..1d40",
  "signature": "ed25519:9a03..7fb1"
}
```

## Cíle

| sink | trvanlivost | použití |
| --- | --- | --- |
| file:// | lokální disk | vývoj a stínový režim |
| s3:// or gs:// | objektové úložiště s object lock | produkce, doporučeno |
| postgres:// | tabulka pouze pro přidávání s triggerem | když už provozujete Postgres a chcete přístup přes SQL |
| stdout | žádná | přesměrování do vlastního pipeline |

---

This document is the markdown form of https://www.voidagent.tech/cs/docs/ledger, published for agents that read
text rather than a rendered page. It is generated from the same data the page
renders, so the two cannot disagree.