blvm-node 0.1.54

Bitcoin Commons BLVM: Minimal Bitcoin node implementation using blvm-protocol and blvm-consensus
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38

# IBD ops examples (lab / rematch)

Lab and soak helpers for parallel IBD checkpoints and body trees.

**Destructive** examples require the `ibd-dev` feature (not in default production
builds). Read-only helpers stay on `production,heed3` only.

```bash
# Destructive (strip / copy / clear / recover / watermark)
cargo run -p blvm-node --example strip_bodies_above --features production,heed3,ibd-dev -- $DATADIR HEIGHT

# Read-only
cargo run -p blvm-node --example probe_ckpt_utxo --features production,heed3 -- $DATADIR TXID:VOUT
```

**Hard rule:** never wipe archives, GOLDEN pins, or `blvm.a31-frontier` unless
explicitly ordered in the current session.

## Rematch-safe

| Example | Role |
|---------|------|
| `strip_bodies_above` | Tip90 / TRUE-WAN: strip bodies above export height (`STRIP=` in `wan-bench-archive-tip90.sh`) |
| `inspect_local_block` | Opt-in local body inspection (tip90 can call) |

## Lab / destructive

| Example | Role |
|---------|------|
| `copy_ibd_ckpt` | Copy active IBD UTXO ckpt tree between data dirs |
| `clear_ckpt_slot` | Wipe one ping-pong ckpt slot |
| `fill_empty_ckpt_slot` | Copy SRC active ckpt into an empty DST slot |
| `recover_ckpt_slot` | Recover a ckpt slot from salvage paths |
| `probe_ckpt_utxo` | Probe ckpt UTXO (synth-wan helper) |
| `set_ibd_watermark` | Set IBD watermark metadata |
| `backfill_engine_export_muhash` | Backfill engine export muhash |

Doc-comment paths use `$DATADIR` placeholders. Binary names are stable for harness scripts.