@txfence/cli

Command-line interface for txfence. Install globally or use via npx.

npm install -g @txfence/cli
# or: npx txfence <command>

txfence init

Generates a txfence.config.ts in the current directory with sensible defaults.

txfence init [--chain ethereum|arbitrum|solana|cosmoshub]

Output: txfence.config.ts with a base policy configured for the specified chain.

txfence simulate

Runs simulation for an action defined in a config or inline JSON.

txfence simulate \
  --action '{"kind":"transfer","chain":"ethereum","token":{"token":"ETH","amount":"100000000000000000","decimals":18},"to":"0x..."}' \
  --config ./txfence.config.ts

Output: Simulation result with gas estimate, coverage level, caveats, and whether it would revert.

txfence check-policy

Evaluates an action against the policy without any RPC calls.

txfence check-policy \
  --action '{"kind":"transfer",...}' \
  --config ./txfence.config.ts

Output: Pass/fail with the specific check that failed and rejection reason if applicable.

txfence submit

Runs the full pipeline. Defaults to dry-run — add --execute to broadcast on-chain.

txfence submit \
  --action '{"kind":"transfer",...}' \
  --config ./txfence.config.ts \
  [--execute]

Without --execute: Runs policy check + simulation + prints what would happen.

With --execute: Runs the full pipeline including signing and broadcasting. Requires PRIVATE_KEY in env.

txfence receipt

Fetches a stored receipt by transaction hash.

txfence receipt --tx 0x1234...abcd --config ./txfence.config.ts

Output: Full receipt JSON including action, evaluation, simulation result, and block confirmation.

txfence diff

Computes the blast radius of a policy change.

txfence diff --before ./policy-v1.ts --after ./policy-v2.ts

Output: Field-by-field diff with whether each change is more or less restrictive. Use this in CI to require review for policy changes.

Environment variables