Files
vm-skills/merkle-forest/SKILL.md
Vault Sovereign eac77ef7b4 Initial commit: VaultMesh Skills collection
Collection of operational skills for VaultMesh infrastructure including:
- backup-sovereign: Backup and recovery operations
- btc-anchor: Bitcoin anchoring
- cloudflare-tunnel-manager: Cloudflare tunnel management
- container-registry: Container registry operations
- disaster-recovery: Disaster recovery procedures
- dns-sovereign: DNS management
- eth-anchor: Ethereum anchoring
- gitea-bootstrap: Gitea setup and configuration
- hetzner-bootstrap: Hetzner server provisioning
- merkle-forest: Merkle tree operations
- node-hardening: Node security hardening
- operator-bootstrap: Operator initialization
- proof-verifier: Cryptographic proof verification
- rfc3161-anchor: RFC3161 timestamping
- secrets-vault: Secrets management

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2025-12-27 00:25:00 +00:00

1.7 KiB

name, description, version
name description version
merkle-forest Build deterministic Merkle roots over files using BLAKE3, emit ROOT.txt and PROOF.json, with plan/apply/rollback, verification, and audit report. Designed to feed rfc3161-anchor, eth-anchor, and btc-anchor. Triggers: 'merkle root', 'build merkle tree', 'root.txt', 'proof receipt', 'hash artifacts'. 1.0.0

Merkle Forest (BLAKE3)

Computes:

  • Leaf hashes: BLAKE3(file bytes)
  • Merkle root: BLAKE3(left_hex || right_hex) up levels (duplicate last if odd)
  • ROOT.txt + PROOF.json receipts

Quick Start

cd ~/.claude/skills/merkle-forest

export INPUT_DIR="$HOME/infrastructure"   # or INPUT_FILES="a,b,c"
export LABEL="infra-snapshot"
export NODE_NAME="node-a"

./scripts/00_preflight.sh
./scripts/10_plan.sh

export DRY_RUN=0
./scripts/11_apply.sh

./scripts/90_verify.sh
./scripts/99_report.sh

Inputs

Parameter Required Default Description
INPUT_DIR No (empty) Directory to hash recursively
INPUT_FILES No (empty) Comma-separated file paths
EXCLUDES No .git,node_modules,target,dist,outputs Exclude patterns
LABEL No snapshot Run label
NODE_NAME No node-a Node id
OUTPUT_DIR No outputs Outputs base
DRY_RUN No 1 Apply refuses unless DRY_RUN=0
REQUIRE_CONFIRM No 1 Require confirmation phrase
CONFIRM_PHRASE No I UNDERSTAND THIS WILL HASH FILES AND EMIT A ROOT Safety phrase

Outputs

outputs/runs/<node>_<label>_<timestamp>/

  • files.txt, leaf_hashes.txt, levels/, ROOT.txt, PROOF.json, status_matrix.json, audit_report.md

EU Compliance

EU (Ireland - Dublin), Irish jurisdiction. Local-first proof artifacts.