CLI reference

sigil-cli is the canonical command-line interface to the Sigil chain. It compiles from node/sigil-cli and exposes node operations, transaction submission, queries, and full coverage for every native primitive (NFT, DEX, Nova, labor, Crucible, storage, compute). Install the latest release:

cargo install sigil-cli --locked
sigil --version

Global flags

Every subcommand inherits these flags.

Flag	Default	Meaning
`--rpc-url <URL>`	`http://localhost:12618`	RPC endpoint to talk to. Set to a public node for non-local work.
`--chain-id <ID>`	`sigil-mainnet-1`	Chain id baked into every signed transaction. Set to `sigil-testnet-1` for testnet, `evolve-canary-1` for the canary.

Recommended environment setup:

export SIGIL_RPC_URL=https://testnet-rpc.sigil.ml/rpc
export SIGIL_CHAIN_ID=sigil-testnet-1
alias sigil='sigil --rpc-url "$SIGIL_RPC_URL" --chain-id "$SIGIL_CHAIN_ID"'

Top-level groups

Group	Purpose
`status`	One-shot node health check
`init`	Initialise a node data directory
`node`	Start, inspect, and peer the node
`genesis`	Generate, validate, and inspect genesis files
`validator`	Register, key-manage, and inspect a validator
`stake`	Deposit, withdraw, delegate, undelegate, claim rewards
`gov`	Submit and vote on governance proposals
`query`	Read chain state (blocks, transactions, accounts, validators)
`nft`	NFT collection and token operations
`dex`	DEX pools, swaps, liquidity
`nova`	Nova worlds, parcels, avatars, buildings
`labor`	Labor market jobs, bids, escrow, milestones, disputes
`crucible`	Distributed training run coordination
`storage`	Storage pinning marketplace
`compute`	Compute marketplace (gated on `--features compute`)

status

sigil status

Calls sigil_getNodeInfo and prints chain id, protocol version, sync status, and peer count.

init

sigil init [--init-chain-id <ID>] [--genesis <PATH>] [--data-dir <DIR>] [--validator-did <DID>]

Initialise a node data directory. The --init-chain-id flag overrides the global --chain-id for the init step (defaults to sigil-testnet-1). Example:

sigil init --init-chain-id sigil-testnet-1 --genesis ./genesis.json --data-dir ./data

node

`node start`

sigil node start [--config <PATH>] [--mode <MODE>] [--data-dir <DIR>] [--p2p-addr <ADDR>] [--rpc-addr <ADDR>] [--validator-did <DID>]

Flag	Default	Meaning
`--config`	`config.toml`	TOML config file
`--mode`	`validator`	`validator`, `producer`, `archive`, or `light`
`--data-dir`	`./data`	Data directory
`--p2p-addr`	`0.0.0.0:26656`	P2P listen address
`--rpc-addr`	`0.0.0.0:12618`	RPC listen address
`--validator-did`	—	Required for `validator` and `producer` modes

Example:

sigil node start --config /etc/sigil/config.toml --mode validator \
  --validator-did did:oas:sigil:agent:my-validator-1

`node status`

Print sync status (current height, highest known, synced).

`node info`

Print chain id, version, and mode.

`node peers`

List connected peers.

genesis

`genesis generate`

sigil genesis generate [--validators N] [--genesis-time UNIX] [--output PATH]

Generate a testnet genesis file with N validators.

`genesis validate`

sigil genesis validate [--genesis PATH]

Verify the integrity of an existing genesis file.

`genesis show`

sigil genesis show [--genesis PATH]

Pretty-print the genesis summary: chain id, validator count, initial allocations.

validator

`validator register`

sigil validator register --did <DID> --stake <AMOUNT> [--mode <MODE>] --human-root <HMR-DID>

Register as a validator. --mode is validator (default) or producer. --stake is in micro-MINT (the smallest divisible unit; one MINT = 10⁶ micro-MINT). Example:

sigil validator register \
  --did did:oas:sigil:agent:val-001 \
  --stake 10000000000 \
  --mode validator \
  --human-root did:oas:sigil:hmr:my-name

`validator show-keys`

sigil validator show-keys [--data-dir DIR]

Print this node’s validator public keys.

`validator generate-keys`

sigil validator generate-keys --did <DID> [--data-dir DIR]

Generate a new consensus keypair and persist it to --data-dir.

stake

`stake deposit`

sigil stake deposit <AMOUNT> --mode <producer|validator>

`stake withdraw`

sigil stake withdraw <AMOUNT>

Begins the unbonding cooldown.

`stake delegate`

sigil stake delegate <VALIDATOR-DID> <AMOUNT>

`stake undelegate`

sigil stake undelegate <VALIDATOR-DID> <AMOUNT>

`stake rewards`

Show accumulated rewards.

gov

`gov propose`

sigil gov propose <TITLE> --description <TEXT>

`gov vote`

sigil gov vote <PROPOSAL-ID> <yes|no|abstain|no_with_veto>

`gov list-proposals`

`gov show-proposal <PROPOSAL-ID>`

query

`query block [--height H]`

Block by height (default: latest).

`query tx <HASH>`

Transaction by hash.

`query state <PARTITION> <KEY>`

Generic state-partition lookup. Useful partitions: identity, stakes, validators, nft, dex, mail, sns.

`query validator <DID>`

Validator info by DID.

nft

Command	Purpose
`nft create-collection`	Open a new collection
`nft mint`	Mint a token into a collection
`nft transfer`	Transfer a token (standard kind only)
`nft burn`	Burn a token
`nft set-metadata`	Update the metadata URI / hash (ERC-4906 style)
`nft verify-identity`	Advance the verification level on an identity NFT
`nft get-collection`	Fetch a collection record
`nft get-token`	Fetch a single token
`nft owner`	List all NFTs owned by a DID
`nft did`	Fetch the DID-identity index for a subject DID
`nft events`	List lifecycle events

Example:

sigil nft create-collection \
  --collection-id col:demo:badges \
  --name "Demo Badges" --symbol DBB \
  --kind standard \
  --issuer-did did:oas:sigil:agent:alice \
  --controller-did did:oas:sigil:agent:alice

dex

Command	Purpose
`dex create-pool`	Constant-product pool with initial liquidity
`dex quote`	Quote a swap without submitting a transaction
`dex swap-exact-in`	Swap an exact input amount
`dex add-liquidity`	Proportional add to an existing pool
`dex remove-liquidity`	Burn LP shares to redeem reserves
`dex position`	Inspect an LP position

nova

Command	Purpose
`nova world`	Inspect a Nova world (or list worlds if no id)
`nova claim-parcel`	Claim a parcel in a world
`nova transfer-parcel`	Transfer a parcel to another DID
`nova register-building`	Register a building placement on a parcel
`nova register-avatar`	Register an avatar profile
`nova auction-inspect`	Inspect a parcel auction record

labor

Sigil’s labor market exposes both classical RFP-style jobs and bounty-style offers with bonded claims.

Command	Purpose
`labor post-job`	Post a job
`labor submit-bid`	Submit a bid for a job
`labor accept-bid`	Accept a bid
`labor fund-escrow`	Fund a contract escrow
`labor open-offer`	Open a bounty-style offer
`labor submit-claim`	Submit a bonded claim against an offer
`labor attest-claim`	Attest a claim
`labor cancel-offer`	Cancel an open offer
`labor submit-milestone`	Submit a milestone deliverable
`labor approve-milestone`	Attest/approve a milestone
`labor release-milestone`	Release payment for an approved milestone
`labor open-dispute`	Open a dispute
`labor resolve-dispute`	Resolve a dispute
`labor inspect`	Inspect live labor state

crucible

Command	Purpose
`crucible open`	Open a training run and escrow rewards
`crucible commit-rollout`	Commit a rollout batch root and reward budget
`crucible attest-rewards`	Submit a reward attestation
`crucible publish-weights`	Publish a weight root and artifact commitment
`crucible slash`	Record slash evidence and apply a slash
`crucible close`	Close or cancel a training run
`crucible inspect`	Inspect live Crucible state

See Cookbook: Submit a Crucible rollout for a runnable example.

storage

Command	Purpose
`storage register-provider`	Register as a Weave/Weft storage provider
`storage update-provider`	Update capacity, pricing, regions, or signing key
`storage exit-provider`	Begin provider exit
`storage request-pin`	Request replicated pinning
`storage accept-pin`	Accept a pin request as a registered provider
`storage settle-receipt`	Settle a provider’s signed pin receipt
`storage challenge`	Open a proof-of-possession challenge
`storage resolve-challenge`	Resolve a challenge with chunk proofs
`storage list-providers`	List storage providers
`storage provider`	Inspect a single provider
`storage pin-request`	Inspect a pin request
`storage contract`	Inspect a pin contract
`storage receipt`	Inspect a pin receipt
`storage challenge-status`	Inspect a challenge

compute

Available only on builds compiled with --features compute.

Command	Purpose
`compute register-provider`	Register as a compute provider
`compute list-providers`	List providers
`compute select-provider`	Select a provider for a model and verification tier
`compute create-job`	Create a job via the canonical `dispatch_compute` flow
`compute fund-escrow`	Fund compute escrow
`compute withdraw-escrow`	Withdraw available escrow
`compute escrow`	Inspect compute escrow
`compute receipt {submit\|get\|proof}`	Receipt operations
`compute challenge {open\|resolve\|get\|list}`	Challenge operations
`compute maca {epoch\|epochs\|quorum-proof\|quorum-proofs}`	Inspect MACA epochs and quorum proofs
`compute earnings`	Accumulated compute earnings
`compute attest-hardware`	Attest local hardware for the marketplace

Get started

Concepts

Primitives

​Global flags

​Top-level groups

​status

​init

​node

​node start

​node status

​node info

​node peers

​genesis

​genesis generate

​genesis validate

​genesis show

​validator

​validator register

​validator show-keys

​validator generate-keys

​stake

​stake deposit

​stake withdraw

​stake delegate

​stake undelegate

​stake rewards

​gov

​gov propose

​gov vote

​gov list-proposals

​gov show-proposal <PROPOSAL-ID>

​query

​query block [--height H]

​query tx <HASH>

​query state <PARTITION> <KEY>

​query validator <DID>

​nft

​dex

​nova

​labor

​crucible

​storage

​compute

​See also