vaultsovereign/vm-ledger
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: update vm-ledger references

Browse Source
This commit is contained in:
Vault Sovereign
2025-12-27 02:07:24 +00:00
parent 833c408a30
commit 657a5b5642
2 changed files with 9 additions and 9 deletions
Download Patch File Download Diff File Expand all files Collapse all files

12
FORMAT.md
View File

@@ -1,6 +1,6 @@
# Format Specification (v0) # Format Specification (v0)
This document freezes the v0 formats used by `civilization-ledger`. This document freezes the v0 formats used by `vm-ledger`.
Key idea: **signing and verification do not depend on CBOR serialization details**. The canonical signing bytes are defined below and locked by golden-vector tests. Key idea: **signing and verification do not depend on CBOR serialization details**. The canonical signing bytes are defined below and locked by golden-vector tests.
@@ -32,7 +32,7 @@ Key idea: **signing and verification do not depend on CBOR serialization details
6. `payload_hash = BLAKE3(payload_cbor)` (32 bytes) 6. `payload_hash = BLAKE3(payload_cbor)` (32 bytes)
7. `author_pubkey` (32 bytes) 7. `author_pubkey` (32 bytes)
This is implemented in `civilization-ledger/crates/ledger-core/src/entry.rs:32` and locked by `civilization-ledger/crates/ledger-core/tests/golden_vectors.rs:10`. This is implemented in `vm-ledger/crates/ledger-core/src/entry.rs:32` and locked by `vm-ledger/crates/ledger-core/tests/golden_vectors.rs:10`.
### Entry hash (v0) ### Entry hash (v0)
@@ -100,8 +100,8 @@ or `CheckpointAttestationV1`, distinguished by the `format` field.
5. `checkpoint_head_hash` (32 bytes) 5. `checkpoint_head_hash` (32 bytes)
6. `ts_seen_ms` as little-endian `u64` (8 bytes) 6. `ts_seen_ms` as little-endian `u64` (8 bytes)
This is implemented in `civilization-ledger/crates/ledger-core/src/attestation.rs` and locked by This is implemented in `vm-ledger/crates/ledger-core/src/attestation.rs` and locked by
`civilization-ledger/crates/ledger-core/tests/attestation_vectors.rs`. `vm-ledger/crates/ledger-core/tests/attestation_vectors.rs`.
### Checkpoint Attestation (v1) ### Checkpoint Attestation (v1)
@@ -149,7 +149,7 @@ Verification:
- if `sibling_side == "right"`: `current = BLAKE3("CL-merkle-node-v0" || current || sibling)` - if `sibling_side == "right"`: `current = BLAKE3("CL-merkle-node-v0" || current || sibling)`
3. Accept iff `current == checkpoint_merkle_root` 3. Accept iff `current == checkpoint_merkle_root`
This is implemented in `civilization-ledger/crates/ledger-core/src/proof.rs`. This is implemented in `vm-ledger/crates/ledger-core/src/proof.rs`.
## Receipt (v0) ## Receipt (v0)
@@ -170,7 +170,7 @@ Verification:
3. If witness is required: verify at least one included checkpoint attestation (v0 or v1) and 3. If witness is required: verify at least one included checkpoint attestation (v0 or v1) and
require it matches `read_proof.entry_count` + `read_proof.checkpoint_merkle_root_hex`. require it matches `read_proof.entry_count` + `read_proof.checkpoint_merkle_root_hex`.
This is implemented in `civilization-ledger/crates/ledger-core/src/receipt.rs`. This is implemented in `vm-ledger/crates/ledger-core/src/receipt.rs`.
## Payload Type: `file_anchor.v0` ## Payload Type: `file_anchor.v0`

6
README.md
View File

@@ -2,7 +2,7 @@
Not a game. Not a game.
`civilization-ledger` is a cryptographic, append-only, tamper-evident ledger for governance/law/memory/AI accountability. `vm-ledger` is a cryptographic, append-only, tamper-evident ledger for governance/law/memory/AI accountability.
## Properties (v0) ## Properties (v0)
@@ -16,7 +16,7 @@ Not a game.
```bash ```bash
# from this repo root # from this repo root
cd civilization-ledger cd vm-ledger
cargo run -p ledger-cli -- keygen --out ~/.config/civ-ledger/keys/operator.json cargo run -p ledger-cli -- keygen --out ~/.config/civ-ledger/keys/operator.json
cargo run -p ledger-cli -- init --dir ./my-ledger cargo run -p ledger-cli -- init --dir ./my-ledger
@@ -47,4 +47,4 @@ cargo run -p ledger-cli -- verify --dir ./my-ledger --format json
## Spec ## Spec
See `civilization-ledger/FORMAT.md`. See `vm-ledger/FORMAT.md`.