Command Reference

Axiom CLI

axiom is the TruthLinked command-line tool for network configuration, post-quantum keys, account inspection, transfers, .tl names, Axiom Cell deployment/calls, compute escrow, and validator staking.

axiom 0.1.0Config fileRPC awareTransaction signer

01 Global Options

OptionPurpose
--network, -nSelect a configured network preset.
--rpcOverride the RPC endpoint for a command.
TRUTHLINKED_RPCEnvironment-level RPC override.
TRUTHLINKED_EXPLOREREnvironment-level explorer URL override.
axiom --rpc https://rpc.truthlinked.org status
TRUTHLINKED_RPC=https://rpc.truthlinked.org axiom status

02 Configuration

CommandUse
config showShow resolved network, RPC, explorer, keypair, and config.
config set-network <network>Set active network.
config set-keypair <path>Set default keypair.
config set-rpc <url>Set custom RPC endpoint.
config set-explorer <url>Set custom explorer URL.
config resetReset config to defaults.
axiom config set-rpc https://rpc.truthlinked.org
axiom config set-keypair ~/.truthlinked/default.keys
axiom config show

03 Keys, Accounts, Balances

axiom keygen --output ~/.truthlinked/default.keys
axiom account-id --from ~/.truthlinked/default.keys
axiom balance <account_id_or_pubkey_hex>
axiom balance <account_id_or_pubkey_hex> --full
axiom status --from ~/.truthlinked/default.keys

--full requests a broader account view including TRTH, compute escrow, and staking details when available.

04 Transfers And Names

axiom transfer --from ~/.truthlinked/default.keys --to <account_id> --amount 10
axiom transfer --from ~/.truthlinked/default.keys --to-name alice.tl --amount 1
axiom propose-name --from ~/.truthlinked/default.keys --name alice.tl --target <id> --owner <owner_id>
axiom transfer-name --from ~/.truthlinked/default.keys --name alice.tl --new-owner <owner_id>

Names must be lowercase ASCII .tl names. They resolve to account or cell IDs.

05 Axiom Cells

CommandPurpose
compileCompile a .cell source file into .axiom bytecode and manifest output.
deployDeploy bytecode and manifest as a cell.
callCall a deployed cell method.
call --simulateDry-run a cell call through simulation.
upgradeUpgrade owned cell bytecode and manifest metadata.
axiom compile ./counter.cell --output ./counter.axiom
axiom deploy --from ~/.truthlinked/default.keys --bytecode ./counter.axiom --manifest ./counter.manifest.json
axiom call --from ~/.truthlinked/default.keys --cell <cell_id> --method increment --gas 500000
axiom upgrade --from ~/.truthlinked/default.keys --cell <cell_id> --bytecode ./counter_v2.axiom

The CLI does not currently expose a dedicated --accord-format flag. Accord response formats are selected by cell code. For USD price feeds, append accord_format=price_usd to the requested URL; the node strips that query marker before fetching the upstream API.

let req_id = accord::request("https://api.example.com/btc.json?accord_format=price_usd", "GET", "");

06 Compute Escrow And Validators

axiom deposit-compute --from ~/.truthlinked/default.keys --amount 5
axiom withdraw-compute --from ~/.truthlinked/default.keys --amount 2
axiom validator stake --from ~/.truthlinked/default.keys --amount 100
axiom validator unstake --from ~/.truthlinked/default.keys --amount 25
axiom validator withdraw --from ~/.truthlinked/default.keys
axiom validator unjail --from ~/.truthlinked/default.keys
axiom validator info --from ~/.truthlinked/default.keys