`fluxsim ship`

Run the fidelity gate over every emit that declares a fidelity block, and only if none is withheld, pack the bundle and the run into one evidence archive with its in-toto statements.

Synopsis

fluxsim ship [options] <bundle>

Examples

# pack the evidence archive
fluxsim ship ./bundle --run-id de72fa4b22711c52 -o ./out

# a bundle that declares a fidelity block needs the slice it is measured against
fluxsim ship ./bundle --run-id de72fa4b22711c52 -o ./out \
    --committed-slice payment_recovery_moment=file:///data/slice.ndjson

Arguments

Argument	Description
`bundle`	path to the FLUX bundle directory

Options

Option	Value	Description
`--run-id`	`RUN_ID`	the run id to act on (as reported by `fluxsim plan`/`fluxsim run`) (required)
`-o, --out-dir`	`OUT_DIR`	directory the evidence archive and its statements are written to (required)
`--committed-slice`	`EXPOSE_ID=file://PATH`	the committed real-data slice one expose's fidelity check is measured against, as EXPOSE_ID=file://PATH; repeatable, once per expose; the file holds one JSON object per line, keyed by the expose's contract column names (e.g. {"subscriber_id": "s-1", "amount": "12.50"})
`--signing-key`	`SIGNING_KEY`	file holding a 32-byte ed25519 seed (raw or hex) to sign fidelity records with; without it the record is signed by a per-invocation key and says so
`--trust-key`	`PATH`	file holding the 32-byte raw ed25519 PUBLIC key (raw or hex -- the `publicKey` a fidelity record prints) the gate checks the record's signature against; without it the record is checked against the public half of the key that signed it and says it is self-attested
`--state-dir`	`STATE_DIR`	run-state directory (default: ./.flux)
`-j, --json`		emit machine-readable JSON

All commands