ENTITY Documentation Portal
Developer reference · ENTITY v3.4.3

CLI Reference

Version boundary: use ENTITY v3.4.3 for current runtime verification. The BTDU component invoked by this CLI remains 3.4.2 unchanged, so BTDU command semantics may legitimately retain 3.4.2 component identifiers inside a v3.4.3 checkout.

Current release verification

git clone https://github.com/blackmore-technology-group/ENTITY.git
cd ENTITY
git checkout v3.4.3
python -m pip install -r requirements.txt
python -m compileall -q src sdk protocol
python -m unittest discover -s tests -v

The signed v3.4.3 tag resolves to release commit 528b70aabd05b1e930b77e4933f157731e47274f. For an immutable automation target, pin that tag or exact commit rather than moving main.

BTDU CLI

python tools/entity_btdu_cli.py \
  --entity-state STATE \
  --btdu-state BTDU_STATE \
  --adam-root ADAM_ROOT \
  --git-bin git \
  COMMAND
CommandPurpose
initMaterialize primitive-byte universe and deep-verify BTDU state.
statusVerify/report current BTDU state without mutation.
ingest-repo PATH --provenance REFIngest a Git repository under an ENTITY-signed BTDU_WRITE authorization receipt and return a repository manifest.
context OBJECT_REFProject bounded context for a governed BTDU object.
reconstruct OBJECT_REF OUTPUTReconstruct exact object bytes and report SHA-256.
mirror-genesisMirror 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. Operators should explicitly understand which Entity identity authorizes mutation.

Historical reproduction

Use git checkout v3.4.2 only when reproducing a specifically sealed v3.4.2 campaign or artifact. Do not use that historical checkout as the general current-runtime instruction.

Exit discipline

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