Developer reference

CLI Reference

Reference verification

git checkout v3.4.2
python -m pip install -r requirements.txt
python -m compileall -q src sdk protocol
python -m unittest discover -s tests -v

BTDU CLI

python tools/entity_btdu_cli.py \
  --entity-state STATE \
  --btdu-state BTDU_STATE \
  --adam-root ADAM_ROOT \
  --git-bin git \
  COMMAND

Command	Purpose
`init`	Materialize primitive-byte universe and deep-verify BTDU state.
`status`	Verify/report current BTDU state without mutation.
`ingest-repo PATH --provenance REF`	Ingest a Git repository under an ENTITY-signed BTDU_WRITE authorization receipt and return a repository manifest.
`context OBJECT_REF`	Project bounded context for a governed BTDU object.
`reconstruct OBJECT_REF OUTPUT`	Reconstruct exact object bytes and report SHA-256.
`mirror-genesis`	Mirror the Genesis market lineage into BTDU without creating ownership/entitlement.

Required arguments

--entity-state must contain the sovereign Entity manifest/key state used for authorization. --btdu-state is mutable BTDU/ADAM state. --adam-root points to the ADAM runtime. The default owner Entity is the configured canonical owner in the CLI but operators should understand and control the identity they are using.

Exit discipline

Treat authorization, signature, reconstruction or root mismatch as a failed operation. Do not “work around” a failed verifier during qualification.