Command Reference

Root Command

kaleido [global options] <command> [subcommand] [args]

Global options

Option	Meaning
`--json`	Emit raw JSON
`--agent`	Disable prompts for non-interactive use
`--node-url`	Override the configured node URL
`--api-url`	Override the configured API URL
`--install-completion`	Install shell completion
`--show-completion`	Print shell completion

Top-Level Commands

Command	Summary
`setup`	First-run configuration and optional local node creation
`node`	Docker-backed RLN environment lifecycle and wallet access
`wallet`	BTC wallet operations
`asset`	RGB asset management and issuance
`channel`	Channel management and LSP order flows
`peer`	Peer connectivity
`payment`	Lightning and RGB+LN payments
`market`	Market discovery, quotes, and routes
`swap`	Maker-backed atomic swap flows
`config`	Stored CLI configuration

`setup`

Command	Notes
`kaleido setup`	Non-interactive default: creates and starts one local mutinynet node with defaults
`kaleido setup signetcustom`	Same flow on an explicit network (positional argument, default `mutinynet`)
`kaleido setup mutinynet --env-name taker-1`	Custom environment name
`kaleido setup --mode market --defaults`	Market-only setup
`kaleido setup --mode local --create-node --defaults`	Local node setup

Key flags: --mode, --defaults, --api-url, --node-url, --create-node, --spawn-dir, --env-name, --node-count, --start

`node`

Command	Summary
`kaleido node create [name]`	Create a named environment
`kaleido node list`	List environments and node URLs
`kaleido node use <name> [--node N]`	Select the active node
`kaleido node up <name>`	Start containers
`kaleido node stop <name>`	Stop containers
`kaleido node down <name>`	Remove containers and networks
`kaleido node ps <name>`	Show container status
`kaleido node logs <name>`	Stream logs (`--no-follow` prints existing logs and exits)
`kaleido node clean <name>`	Delete volumes (`--yes` skips the confirmation prompt)
`kaleido node info`	Show node details
`kaleido node network`	Show network information
`kaleido node init`	Initialize the wallet
`kaleido node unlock`	Unlock the wallet
`kaleido node lock`	Lock the wallet
`kaleido node shutdown`	Gracefully shut down the node

`node swap`

Command	Summary
`kaleido node swap pubkey`	Print the taker public key
`kaleido node swap init`	Start a local maker-init swap flow (`--from-asset`, `--qty-from`, `--to-asset`, `--qty-to`, `--timeout`)
`kaleido node swap whitelist --swapstring '<swapstring>'`	Whitelist a swap on the taker side
`kaleido node swap execute`	Execute a local node swap
`kaleido node swap status <payment-hash>`	Check local node swap status (`--taker` or `--maker`)
`kaleido node swap list`	List swaps known to the node

`wallet`

Command	Summary
`kaleido wallet address`	New BTC deposit address
`kaleido wallet balance`	BTC balance
`kaleido wallet send <amount> <address>`	Send BTC
`kaleido wallet utxos`	List UTXOs
`kaleido wallet create-utxos`	Create UTXOs for RGB usage (`--up-to`, `--fee-rate`, `--skip-sync`)
`kaleido wallet transactions`	Transaction history
`kaleido wallet backup <path>`	Backup wallet data
`kaleido wallet restore <path>`	Restore wallet data
`kaleido wallet change-password`	Change wallet password
`kaleido wallet estimate-fee`	Estimate fee rate (`--blocks/-b`, default 6)

`asset`

Command	Summary
`kaleido asset list`	List assets
`kaleido asset balance <asset-id>`	Asset balance
`kaleido asset metadata <asset-id>`	Asset metadata
`kaleido asset invoice <asset-id>`	Create an RGB invoice
`kaleido asset send <asset-id> <amount> <invoice>`	Send RGB assets
`kaleido asset send-batch`	Send to many recipients
`kaleido asset transfers <asset-id>`	Transfer history
`kaleido asset refresh`	Refresh pending transfers
`kaleido asset sync`	Sync RGB wallet
`kaleido asset fail-transfers`	Mark pending transfers as failed
`kaleido asset media`	Fetch asset media

`asset issue`

Command	Summary
`kaleido asset issue nia`	Issue a fixed-supply fungible asset
`kaleido asset issue cfa`	Issue a collectible fungible asset
`kaleido asset issue uda`	Issue a unique digital asset

All issue subcommands accept --precision for the number of decimal places.

`channel`

Command	Summary
`kaleido channel list`	List channels
`kaleido channel open <peer>`	Open a channel
`kaleido channel close <channel-id>`	Close a channel (requires `--peer <pubkey>`)

`channel order`

Command	Summary
`kaleido channel order create [client-pubkey]`	Create an LSP channel order (pubkey defaults to the local node; `--yes` accepts the fetched RFQ price)
`kaleido channel order get <order-id>`	Fetch order status (`--access-token`)
`kaleido channel order pay <order-id>`	Pay for a channel order (`--access-token`; non-interactively pass `--onchain` or `--offchain`, plus `--fee-rate` and `--yes`)
`kaleido channel order decide <order-id>`	Submit a rate decision (`--accept` or `--reject`, `--access-token`)
`kaleido channel order estimate-fees`	Estimate channel-order fees

`channel lsp`

Command	Summary
`kaleido channel lsp info`	LSP metadata and options
`kaleido channel lsp network-info`	LSP network information

`peer`

Command	Summary
`kaleido peer list`	List peers
`kaleido peer connect <peer>`	Connect to a peer
`kaleido peer disconnect <pubkey>`	Disconnect from a peer

`payment`

Command	Summary
`kaleido payment invoice`	Create a BOLT11 or RGB+LN invoice (`--expiry`, default 3600)
`kaleido payment send <invoice>`	Pay an invoice
`kaleido payment list`	List payments
`kaleido payment status <payment-hash>`	Payment status
`kaleido payment decode <invoice>`	Decode an invoice
`kaleido payment invoice-status <invoice>`	Invoice status
`kaleido payment keysend <dest-pubkey> <amt-msat>`	Spontaneous Lightning payment (`--asset-id`/`--asset-amount` for RGB)

`market`

Command	Summary
`kaleido market assets`	List assets
`kaleido market pairs`	List pairs
`kaleido market quote <pair>`	Request a quote
`kaleido market info`	Maker node information
`kaleido market routes <pair>`	Available routes

`swap`

`swap atomic`

Command	Summary
`kaleido swap atomic init <pair>`	Initialize an atomic swap
`kaleido swap atomic execute`	Execute the swap (`--swapstring`, `--taker-pubkey`, `--payment-hash`, prompted if omitted; `--auto-whitelist` whitelists on the local node first)
`kaleido swap atomic status <payment-hash>`	Atomic swap status
`kaleido swap atomic run <pair>`	Run the full atomic flow

`config`

Command	Summary
`kaleido config show`	Print current config
`kaleido config set <key> <value>`	Update one config key
`kaleido config reset`	Reset config to defaults
`kaleido config path`	Print config file path

Valid config keys: node-url, api-url, network, spawn-dir

Machine-Readable Mode

Every command group can be combined with --json:

kaleido --json wallet balance
kaleido --json market quote BTC/USDT --from-amount 0.001

Introduction

Local Node Operations

Trading & Channels

Reference

Root Command

Global options

Top-Level Commands

`setup`

`node`

`node swap`

`wallet`

`asset`

`asset issue`

`channel`

`channel order`

`channel lsp`

`peer`

`payment`

`market`

`swap`

`swap atomic`

`config`

Machine-Readable Mode

​Root Command

​Global options

​Top-Level Commands

​setup

​node

​node swap

​wallet

​asset

​asset issue

​channel

​channel order

​channel lsp

​peer

​payment

​market

​swap

​swap atomic

​config

​Machine-Readable Mode

Root Command

Global options

Top-Level Commands

`setup`

`node`

`node swap`

`wallet`

`asset`

`asset issue`

`channel`

`channel order`

`channel lsp`

`peer`

`payment`

`market`

`swap`

`swap atomic`

`config`

Machine-Readable Mode