Dev Hub › CLI Reference

CLI Reference

Complete reference for the molt command-line interface. The CLI is the primary tool for interacting with the Lichen network — managing wallets, deploying contracts, querying state, and operating validators.

Installation

Install with cargo install lichen-cli or build from source. See the Getting Started guide for full setup instructions.

Global Options

These flags apply to every molt command.

Flag	Type	Default	Description
`--rpc-url`	string	`http://localhost:8899`	RPC server URL to connect to
`--help`	flag	—	Print help information
`--version`	flag	—	Print version information

Shell

$ licn --rpc-url https://testnet-rpc.moltchain.network balance
$ licn --version
lichen-cli 0.9.2 (lichen)

Wallet Commands

Multi-wallet management — create, import, inspect, and remove wallets. Wallet keypairs are stored in ~/.lichen/wallets/.

`molt wallet create`

Create a new wallet with a fresh Ed25519 keypair. If no name is given, an auto-incrementing name (wallet-1, wallet-2, …) is used.

Shell

molt wallet create [name]

Argument	Type	Default	Description
`name`	string	auto	Optional wallet name (must be unique)

Shell

$ licn wallet create my-agent

 Created wallet 'my-agent'
 Address:  Mo1tABcDeFgH1jK2LmNoPqRsTuVwXyZ3456789ab
 Keypair:  ~/.lichen/wallets/my-agent.json

 Done! Fund with: licn airdrop 100

`molt wallet import`

Import an existing keypair file as a named wallet.

Shell

molt wallet import <name> --keypair <path>

Flag / Arg	Type	Default	Description
`name`	string	required	Wallet name to assign
`--keypair, -k`	path	required	Path to the keypair JSON file

Shell

$ licn wallet import treasury --keypair ~/keys/treasury.json

 Imported wallet 'treasury'
 Address: Mo1tTreasury12345abcdefghijklmnopqrs
 Stored in: ~/.lichen/wallets/treasury.json

`molt wallet list`

List all wallets stored locally with their addresses.

Shell

molt wallet list

Shell

$ licn wallet list

 Wallets
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  my-agent    Mo1tABcDeFgH1jK2LmNoPqRsTuVwXyZ...
  treasury    Mo1tTreasury12345abcdefghijklmno...
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  Total: 2 wallets

`molt wallet show`

Display detailed information for a specific wallet, including its full address and keypair file path.

Shell

molt wallet show <name>

Argument	Type	Default	Description
`name`	string	required	Wallet name

Shell

$ licn wallet show my-agent

 Wallet: my-agent
 Address:  Mo1tABcDeFgH1jK2LmNoPqRsTuVwXyZ3456789ab
 Keypair:  ~/.lichen/wallets/my-agent.json
 Created:  2026-02-10 14:32:01 UTC

`molt wallet balance`

Query the on-chain balance for a named wallet, broken down by spendable, staked, and locked amounts.

Shell

molt wallet balance <name>

Argument	Type	Default	Description
`name`	string	required	Wallet name

Shell

$ licn wallet balance my-agent

 Wallet: my-agent
 Address: Mo1tABcDeFgH1jK2LmNoPqRsTuVwXyZ3456789ab
─────────────────────────────────────────────────────────
 Total:       100.0000 LICN
   Spendable:   90.0000 LICN
   Staked:       10.0000 LICN
   Locked:        0.0000 LICN
─────────────────────────────────────────────────────────

`molt wallet remove`

Remove a wallet from local storage. This deletes the keypair file — make sure you have a backup.

Shell

molt wallet remove <name>

Warning

This permanently deletes the local keypair. If you don't have the mnemonic or a separate backup, the funds in this wallet will be unrecoverable.

Shell

$ licn wallet remove old-wallet

  Removing wallet 'old-wallet' — this cannot be undone.
 Wallet removed.

Identity Commands

Manage your on-chain identity. Your identity is based on an Ed25519 keypair stored at ~/.lichen/keypairs/id.json by default.

`molt identity new`

Generate a new identity keypair. This creates your public key (Lichen address) and a corresponding EVM-compatible address.

Shell

molt identity new [--output <path>]

Flag	Type	Default	Description
`--output, -o`	path	`~/.lichen/keypairs/id.json`	Output file for the keypair

Shell

$ licn identity new

 Generated new identity!
 Pubkey:      Mo1tABcDeFgH1jK2LmNoPqRsTuVwXyZ3456789ab
 EVM Address: 0x7a3b...9f2e
 Saved to:    ~/.lichen/keypairs/id.json

 Get test tokens: licn airdrop 100

Keypair Encryption

Set the LICHEN_KEYPAIR_PASSWORD environment variable before generating to encrypt the keypair file at rest with AES-256-GCM authenticated encryption (12-byte random nonce, password-derived key). Legacy keypairs (v1) are auto-detected and upgraded on next use.

`molt identity show`

Display your Lichen identity — public key, EVM address, and keypair file location.

Shell

molt identity show [--keypair <path>]

Flag	Type	Default	Description
`--keypair, -k`	path	`~/.lichen/keypairs/id.json`	Keypair file to read

Shell

$ licn identity show

 Your Lichen Identity
 Pubkey:      Mo1tABcDeFgH1jK2LmNoPqRsTuVwXyZ3456789ab
 EVM Address: 0x7a3b...9f2e
 Keypair:     ~/.lichen/keypairs/id.json

Validator Commands

Inspect validator status, performance, and the active validator set.

`molt validator info`

Show detailed information for a specific validator: stake, reputation, activity status, and blocks produced.

Shell

molt validator info <address>

Argument	Type	Default	Description
`address`	Base58	required	Validator public key

Shell

$ licn validator info Mo1tVa1iDatoR12345abcdef

 Validator Information
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 Pubkey:          Mo1tVa1iDatoR12345abcdef
 Stake:           50000.0000 LICN
 Reputation:      98
 Status:          Active
 Blocks produced: 12,847

`molt validator performance`

Show epoch-level performance metrics for a validator: block production rate, average block time, and uptime.

Shell

molt validator performance <address>

Argument	Type	Default	Description
`address`	Base58	required	Validator public key

Shell

$ licn validator performance Mo1tVa1iDatoR12345abcdef

 Validator Performance
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 Validator: Mo1tVa1iDatoR12345abcdef

 Epoch Performance:
   Blocks produced: 432
   Blocks expected: 440
   Success rate:    98.18%
   Average block time: 412ms

 Uptime: 99.87%

`molt validator list`

List all active validators with their stake and reputation scores.

Shell

molt validator list

Shell

$ licn validator list

 Active Validators
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
#1 Mo1tVa1iDatoR12345abcdef
    Stake: 125000.0 LICN
   Reputation: 98

#2 Mo1tVa1iDatoR67890ghijkl
    Stake: 80000.0 LICN
   Reputation: 95

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Total: 2 validators, 205000.0 LICN staked

Staking Commands

Stake and unstake LICN to participate in consensus. Staked tokens are locked and earn rewards each epoch.

`molt stake add`

Stake LICN to register as a validator or increase your existing stake. Amount is in spores (1 LICN = 1,000,000,000 spores).

Shell

molt stake add <amount> [--keypair <path>]

Flag / Arg	Type	Default	Description
`amount`	u64	required	Amount in spores to stake
`--keypair, -k`	path	`~/.lichen/keypairs/id.json`	Keypair file for the staking account

Shell

$ licn stake add 10000000000000

 Staking LICN
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 Amount:    10000.0 LICN
 Validator: Mo1tABcDeFgH1jK2LmNoPqRsTuVw...
 Stake transaction confirmed!

`molt stake remove`

Unstake LICN from your validator. Unstaked tokens become spendable after a cooldown period.

Shell

molt stake remove <amount> [--keypair <path>]

Flag / Arg	Type	Default	Description
`amount`	u64	required	Amount in spores to unstake
`--keypair, -k`	path	`~/.lichen/keypairs/id.json`	Keypair file

Shell

$ licn stake remove 5000000000000

 Unstaking 5000.0 LICN...
 Unstake transaction confirmed!
 Cooldown: tokens will be spendable in ~2 epochs

`molt stake status`

Show current staking status for an account — how much is staked and current validator standing.

Shell

molt stake status [--address <addr>] [--keypair <path>]

Flag	Type	Default	Description
`--address, -a`	Base58	your identity	Account to query
`--keypair, -k`	path	`~/.lichen/keypairs/id.json`	Keypair file (used if no address given)

Shell

$ licn stake status

 Staking Status
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 Account:   Mo1tABcDeFgH1jK2LmNoPqRsTuVw...
 Staked:    100000.0000 LICN
 Status:    Active Validator
 Reputation: 98

`molt stake rewards`

Show accumulated staking rewards for an account.

Shell

molt stake rewards [--address <addr>] [--keypair <path>]

Flag	Type	Default	Description
`--address, -a`	Base58	your identity	Account to query
`--keypair, -k`	path	`~/.lichen/keypairs/id.json`	Keypair file

Shell

$ licn stake rewards

 Staking Rewards
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 Account:        Mo1tABcDeFgH1jK2LmNoPqRsTuVw...
 Total earned:   42.7500 LICN
 Current epoch:  127
 This epoch:     0.3200 LICN

Contract Commands

Deploy WASM smart contracts and interact with on-chain programs.

`molt deploy`

Deploy a compiled WASM contract binary to the chain. Cost is a flat fee of 25 LICN (CONTRACT_DEPLOY_FEE). Optionally register the contract in the symbol registry by providing --symbol.

Shell

molt deploy <contract.wasm> [--symbol <SYM>] [--name <name>] [--template <type>] [--decimals <n>] [--supply <amount>] [--metadata <json>] [--keypair <path>]

Flag / Arg	Type	Default	Description
`contract`	path	required	Path to the compiled WASM file
`--symbol`	string	—	Symbol to register in symbol registry (e.g. VYRN)
`--name`	string	—	Display name for registry (e.g. "VYRN Token")
`--template`	string	—	Category: token, nft, defi, dex, governance, wrapped, bridge, oracle, lending, marketplace, auction, identity, launchpad, vault, payments
`--decimals`	u8	—	Decimal precision (for tokens)
`--supply`	u64	—	Initial total supply in whole tokens (auto-converted to spores via decimals)
`--metadata`	JSON string	—	Custom metadata JSON attached to the registry entry. Recognized fields: `description`, `website`, `logo_url`, `twitter`, `telegram`, `discord`, `mintable`, `burnable`. Any additional keys are stored as-is.
`--keypair, -k`	path	`~/.lichen/keypairs/id.json`	Deployer keypair

Shell

$ licn deploy target/wasm32-unknown-unknown/release/my_contract.wasm \
    --symbol MYTK --name "My Token" --template token --decimals 9 \
    --supply 1000000 \
    --metadata '{"description":"Community token","website":"https://mytoken.io","logo_url":"https://mytoken.io/logo.png","twitter":"https://x.com/mytoken","telegram":"https://t.me/mytoken","discord":"https://discord.gg/mytoken","mintable":true,"burnable":false}'

 Deploying contract...

  Program ID:  Mo1tProg1D12345abcdefghijklmnop
  Symbol:      MYTK
  Template:    token
  Size:        14,832 bytes
  Deploy tx:   9kR7...sWmN
  Fee:         25.001000000 LICN
  Status:      Finalized

 Contract deployed and verified on-chain!

After submitting the deploy transaction, the CLI automatically polls getAccountInfo to verify the contract is live on-chain. You’ll see a green check once confirmed, or a warning if verification times out.

`molt call`

Invoke a function on a deployed smart contract. Arguments are passed as a JSON array.

Shell

molt call <contract> <function> [--args <json>] [--keypair <path>]

Flag / Arg	Type	Default	Description
`contract`	Base58	required	Contract address
`function`	string	required	Function name to call
`--args, -a`	JSON	`[]`	Arguments as a JSON array
`--keypair, -k`	path	`~/.lichen/keypairs/id.json`	Caller keypair

Shell

$ licn call Mo1tProg1D12345abcdefghijklmnop set_greeting \
    --args '["Hello, Lichen!"]'

 Calling set_greeting on Mo1tProg1D...
 Tx: 4xK9...mNpQ
 Success — 1 event emitted
   Event: GreetingSet("Hello, Lichen!")

`molt contract info`

Show on-chain metadata for a deployed contract: owner, size, and deployment details.

Shell

molt contract info <address>

Argument	Type	Default	Description
`address`	Base58	required	Contract address

Shell

$ licn contract info Mo1tProg1D12345abcdefghijklmnop

 Contract Information
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 Address:  Mo1tProg1D12345abcdefghijklmnop
 Owner:    Mo1tABcDeFgH1jK2LmNoPqRsTuVw...
 Size:     14,832 bytes
 Deployed: slot 482,100

`molt contract logs`

Retrieve recent log entries (events) emitted by a contract.

Shell

molt contract logs <address> [--limit <n>]

Flag / Arg	Type	Default	Description
`address`	Base58	required	Contract address
`--limit, -l`	integer	`20`	Number of log entries to show

Shell

$ licn contract logs Mo1tProg1D12345abcdefghijklmnop --limit 5

 Contract Logs (last 5)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
[slot 482917] GreetingSet("Hello, Lichen!")
[slot 482850] GreetingSet("Testing 1-2-3")
[slot 482790] GreetingSet("First message")

`molt contract list`

List all contracts deployed on the connected network.

Shell

molt contract list

Shell

$ licn contract list

 Deployed Contracts
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
#1 Mo1tProg1D12345abcdefghijklmnop  (14,832 bytes)
#2 Mo1tTokenFact0ry9876zyxwvuts     (22,104 bytes)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Total: 2 contracts

`molt contract register`

Retroactively register an already-deployed contract in the symbol registry. Use this when a contract was deployed without --symbol. Costs 0.001 LICN (base fee only).

Shell

molt contract register <address> --symbol <SYM> [--name <name>] [--template <type>] [--decimals <n>] [--keypair <path>]

Flag / Arg	Type	Default	Description
`address`	Base58	required	Contract address to register
`--symbol`	string	required	Symbol (e.g. VYRN)
`--name`	string	—	Display name
`--template`	string	—	Category: token, nft, defi, dex, governance, wrapped, bridge, oracle, lending, marketplace, auction, identity, launchpad, vault, payments
`--decimals`	u8	—	Decimal precision (for tokens)
`--keypair, -k`	path	`~/.lichen/keypairs/id.json`	Must be the contract owner

Shell

$ licn contract register 5A19vK1LMPsFAk1Q7t6AHpBXAkyWiFxbat39GF9RxBWL \
    --symbol VYRN --name "VYRN Token" --template token --decimals 9

 Symbol registered: VYRN → 5A19vK...9RxBWL

Query Commands

Read-only commands for querying chain state — balances, blocks, accounts, and network health.

`molt balance`

Check the LICN balance for any address. Shows total, spendable, staked, and locked breakdowns.

Shell

molt balance [address] [--keypair <path>]

Flag / Arg	Type	Default	Description
`address`	Base58	your identity	Account address to query (optional)
`--keypair, -k`	path	`~/.lichen/keypairs/id.json`	Keypair to derive address from (if no address given)

Shell

$ licn balance

 Balance for Mo1tABcDeFgH1jK2LmNoPqRsTuVwXyZ3456789ab
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 Total:       100.0000 LICN (100000000000 spores)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
   Spendable:    90.0000 LICN (available for transfers)
   Staked:        10.0000 LICN (locked in validation)
   Locked:         0.0000 LICN (locked in contracts)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

`molt transfer`

Send LICN to another address. The fee is deducted from the sender's spendable balance (40% of the fee is burned).

Shell

molt transfer <to> <amount> [--keypair <path>]

Flag / Arg	Type	Default	Description
`to`	Base58	required	Destination address
`amount`	f64	required	Amount in LICN
`--keypair, -k`	path	`~/.lichen/keypairs/id.json`	Sender keypair

Shell

$ licn transfer Mo1tRecipientAddress123456789abcdefghijk 1.5

 Transferring 1.5 LICN (1500000000 spores)
 From: Mo1tABcDeFgH1jK2LmNoPqRsTuVwXyZ3456789ab
 To:   Mo1tRecipientAddress123456789abcdefghijk
 Transaction sent!
 Signature: 7zQ3...bRtW

`molt airdrop`

Request free test tokens from the faucet. Only available on testnet and local networks.

Shell

molt airdrop [amount] [--pubkey <addr>] [--keypair <path>]

Flag / Arg	Type	Default	Description
`amount`	f64	`100.0`	Amount in LICN to request
`--pubkey, -p`	Base58	your identity	Recipient address
`--keypair, -k`	path	`~/.lichen/keypairs/id.json`	Keypair to derive address from

Shell

$ licn airdrop 50

 Requesting 50 LICN airdrop...

  Transaction: 4xK9...mNpQ
  New balance: 50.000000000 LICN

 Airdrop successful!

`molt block`

Retrieve block information by slot number — hash, parent, state root, validator, timestamp, and transaction count.

Shell

molt block <slot>

Argument	Type	Default	Description
`slot`	u64	required	Block slot number

Shell

$ licn block 482917

 Block #482917
 Hash:         a3f8...7b2c
⬅️  Parent:       d1e9...4a5f
 State Root:   8c7d...3e1a
 Validator:    Mo1tVa1iDatoR12345abcdef
 Timestamp:    2026-02-10T14:32:01Z
 Transactions: 12

`molt latest`

Get the most recent finalized block.

Shell

molt latest

Shell

$ licn latest

 Latest Block #483201
 Hash:         f2a1...8d4e
⬅️  Parent:       a3f8...7b2c
 State Root:   9b3e...1f7c
 Validator:    Mo1tVa1iDatoR67890ghijkl
 Timestamp:    2026-02-10T14:35:22Z
 Transactions: 8

`molt slot`

Print the current slot number.

Shell

molt slot

Shell

$ licn slot
 Current slot: 483201

`molt blockhash`

Retrieve the most recent blockhash. Useful for constructing transactions client-side.

Shell

molt blockhash

Shell

$ licn blockhash
 Recent blockhash: f2a1b3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f9a0

`molt burned`

Show the total amount of LICN permanently burned via the deflationary fee mechanism (40% of all transaction fees).

Shell

molt burned

Shell

$ licn burned

 Total LICN Burned
 1,247.832000000 LICN (1247832000000 spores)

Deflationary mechanism: 40% of all transaction fees are burned forever!

`molt validators`

List all active validators on the network (shorthand for molt validator list).

Shell

molt validators

Shell

$ licn validators

 Active Validators
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
#1 Mo1tVa1iDatoR12345abcdef
    Stake: 125000.0 LICN    Reputation: 98

#2 Mo1tVa1iDatoR67890ghijkl
    Stake: 80000.0 LICN    Reputation: 95
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Total: 2 validators, 205000.0 LICN staked

`molt status`

Show a comprehensive overview of the chain: current slot, validator count, TPS, block and transaction totals.

Shell

molt status

Shell

$ licn status

 Lichen Status
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 Current slot:        483,201
 Active validators:   2
 TPS:                 1,247
 Total blocks:        483,201
 Total transactions:  2,491,832
 Network is healthy

`molt metrics`

Display real-time performance metrics for the connected node.

Shell

molt metrics

Shell

$ licn metrics

 Performance Metrics
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 TPS:                 1,247
 Total blocks:        483,201
 Total transactions:  2,491,832
  Avg block time:      412ms

`molt account info`

Show detailed account information for any on-chain address.

Shell

molt account info <address>

Argument	Type	Default	Description
`address`	Base58	required	Account address

Shell

$ licn account info Mo1tABcDeFgH1jK2LmNoPqRsTuVwXyZ3456789ab

 Account Details
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 Address:     Mo1tABcDeFgH1jK2LmNoPqRsTuVwXyZ3456789ab
 Balance:     100.0000 LICN
 Nonce:       47
  Type:        User Account

`molt account history`

Show recent transaction history for an account.

Shell

molt account history <address> [--limit <n>]

Flag / Arg	Type	Default	Description
`address`	Base58	required	Account address
`--limit, -l`	integer	`10`	Number of transactions to show

Shell

$ licn account history Mo1tABcDeFgH1jK2LmNoPqRsTuVwXyZ3456789ab --limit 3

 Transaction History (last 3)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
[slot 482917] Transfer  -1.5000 LICN → Mo1tRecip...
[slot 482800] Airdrop  +50.0000 LICN
[slot 482750] Stake    -10.0000 LICN (staked)

Network Commands

Inspect network health, connected peers, and chain metadata.

`molt network status`

Show overall network health — current slot, validator count, TPS, and block/transaction totals.

Shell

molt network status

Shell

$ licn network status

 Network Status
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 Current slot:        483,201
 Active validators:   2
 TPS:                 1,247
 Total blocks:        483,201
 Total transactions:  2,491,832

 Network is healthy

`molt network peers`

List all connected P2P peers on the local node.

Shell

molt network peers

Shell

$ licn network peers

 Connected Peers
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
#1 12D3Koo...abc (Connected)
   Address: /ip4/192.168.1.10/tcp/8001

#2 12D3Koo...def (Connected)
   Address: /ip4/192.168.1.11/tcp/8001

Total: 2 peers

`molt network info`

Display network metadata — network ID, chain ID, RPC endpoint, and basic statistics.

Shell

molt network info

Shell

$ licn network info

 Network Information
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 Network ID:  lichen-mainnet-1
  Chain ID:    1337
 RPC Endpoint: http://localhost:8899

 Statistics:
   Current slot: 483,201
   Validators:   2
   TPS:          1,247

Token Commands

Create custom tokens, mint, transfer, and query token balances on Lichen.

`licn token create`

Deploy a WASM token contract and automatically register it in the symbol registry with template="token". Requires a compiled WASM binary. Cost is 25.001 LICN (same as molt deploy).

Shell

licn token create <name> <symbol> --wasm <path> [--decimals <n>] [--keypair <path>]

Flag / Arg	Type	Default	Description
`name`	string	required	Token display name
`symbol`	string	required	Token symbol (e.g. VYRN)
`--wasm, -w`	path	required	Path to compiled WASM token contract
`--decimals, -d`	u8	`9`	Decimal precision
`--keypair, -k`	path	`~/.lichen/keypairs/id.json`	Token owner keypair

Shell

$ licn token create "VYRN Token" VYRN --wasm target/wasm32-unknown-unknown/release/vyrn_token.wasm --decimals 9

 Deploying token contract...
  Name:     VYRN Token
  Symbol:   VYRN
  Decimals: 9
  Address:  5A19vK1LMPsFAk1Q7t6AHpBXAkyWiFxbat39GF9RxBWL
  Fee:      25.001000000 LICN
 Token created!

`licn token info`

Show metadata and supply information for a token.

Shell

licn token info <token>

Argument	Type	Default	Description
`token`	string	required	Token address or symbol

Shell

$ licn token info REEF

 Token: Reef Token (REEF)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 Address:   Mo1tToken1234567890abcdefghijk
 Owner:     Mo1tABcDeFgH1jK2LmNoPqRsTuVw...
 Supply:    500,000 REEF
 Decimals:  6

`licn token mint`

Mint additional tokens (owner only). Tokens are sent to yourself unless --to is specified.

Shell

licn token mint <token> <amount> [--to <address>] [--keypair <path>]

Flag / Arg	Type	Default	Description
`token`	string	required	Token address
`amount`	u64	required	Amount to mint (whole tokens)
`--to`	Base58	self	Recipient address
`--keypair, -k`	path	`~/.lichen/keypairs/id.json`	Token owner keypair

Shell

$ licn token mint Mo1tToken1234567890abcdefghijk 10000

 Minting 10,000 REEF...
 Minted! New supply: 510,000 REEF

`licn token send`

Transfer custom tokens to another address.

Shell

licn token send <token> <to> <amount> [--keypair <path>]

Flag / Arg	Type	Default	Description
`token`	string	required	Token address
`to`	Base58	required	Recipient address
`amount`	u64	required	Amount to send (whole tokens)
`--keypair, -k`	path	`~/.lichen/keypairs/id.json`	Sender keypair

Shell

$ licn token send Mo1tToken1234567890abcdefghijk Mo1tRecipient... 500

 Sending 500 REEF → Mo1tRecipient...
 Transfer confirmed!
 Tx: 8bN2...kLm4

`licn token balance`

Query the token balance for a given account.

Shell

licn token balance <token> [--address <addr>] [--keypair <path>]

Flag / Arg	Type	Default	Description
`token`	string	required	Token address
`--address, -a`	Base58	your identity	Account to query
`--keypair, -k`	path	`~/.lichen/keypairs/id.json`	Keypair (used if no address)

Shell

$ licn token balance Mo1tToken1234567890abcdefghijk

 Token Balance
   REEF: 499,500

`licn token list`

List all registered tokens on the network.

Shell

licn token list

Shell

$ licn token list

 Registered Tokens
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  REEF    Reef Token      Supply: 510,000
  CLAW    Claw Credits    Supply: 1,000,000
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  Total: 2 tokens

Governance Commands

On-chain governance — create proposals, vote, and execute passed governance actions.

`molt gov propose`

Submit a new governance proposal. Proposal types: fast-track, standard, constitutional.

Shell

molt gov propose <title> <description> [--proposal-type <type>] [--keypair <path>]

Flag / Arg	Type	Default	Description
`title`	string	required	Proposal title
`description`	string	required	Proposal description
`--proposal-type, -t`	string	`standard`	Proposal type: fast-track, standard, constitutional
`--keypair, -k`	path	`~/.lichen/keypairs/id.json`	Proposer keypair

Shell

$ licn gov propose "Increase block size" "Raise max block size to 2MB" \
    --proposal-type standard

 Governance Proposal Created
  ID:    7
  Title: Increase block size
  Type:  standard
  Status: Voting (ends epoch 135)
 Proposal submitted!

`molt gov vote`

Cast a vote on an active proposal. Vote options: yes, no, abstain.

Shell

molt gov vote <proposal_id> <vote> [--keypair <path>]

Flag / Arg	Type	Default	Description
`proposal_id`	u64	required	Proposal ID
`vote`	string	required	Vote: yes, no, or abstain
`--keypair, -k`	path	`~/.lichen/keypairs/id.json`	Voter keypair

Shell

$ licn gov vote 7 yes

 Vote Cast
  Proposal: #7 — Increase block size
  Vote:     YES
 Vote recorded!

`molt gov list`

List governance proposals. By default shows only active proposals; use --all to include executed and cancelled.

Shell

molt gov list [--all]

Flag	Type	Default	Description
`--all, -a`	flag	`false`	Include executed and cancelled proposals

Shell

$ licn gov list

 Active Proposals
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
#7  Increase block size      [Voting]    yes: 3  no: 1
#6  Add token burn events    [Timelock]  yes: 5  no: 0
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Total: 2 active proposals

`molt gov info`

Show full details for a governance proposal.

Shell

molt gov info <proposal_id>

Argument	Type	Default	Description
`proposal_id`	u64	required	Proposal ID

Shell

$ licn gov info 7

 Proposal #7
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  Title:       Increase block size
  Description: Raise max block size to 2MB
  Type:        standard
  Status:      Voting
  Proposer:    Mo1tABcDeFgH1jK2LmNoPqRsTuVw...
  Votes:       yes: 3  no: 1  abstain: 0
  Ends:        epoch 135

`molt gov execute`

Execute a proposal that has passed voting and completed its time-lock period.

Shell

molt gov execute <proposal_id> [--keypair <path>]

Flag / Arg	Type	Default	Description
`proposal_id`	u64	required	Proposal ID
`--keypair, -k`	path	`~/.lichen/keypairs/id.json`	Executor keypair

Shell

$ licn gov execute 6

 Executing Proposal #6 — Add token burn events
 Proposal executed successfully!
 Tx: 3mK8...qWn2

`molt gov veto`

Veto a proposal during its time-lock period (requires sufficient stake or governance authority).

Shell

molt gov veto <proposal_id> [--keypair <path>]

Flag / Arg	Type	Default	Description
`proposal_id`	u64	required	Proposal ID
`--keypair, -k`	path	`~/.lichen/keypairs/id.json`	Authority keypair

Shell

$ licn gov veto 7

 Vetoing Proposal #7 — Increase block size
 Proposal vetoed!
 Tx: 5nR1...pTx7

Getting Started

Walkthrough: install CLI, create wallet, send a transfer, deploy your first contract.

RPC API Reference

Full JSON-RPC endpoint docs for programmatic access to the Lichen network.

Smart Contracts

Write, test, and deploy WASM contracts on Lichen with the Rust SDK.

GitHub

Source code, issues, and contributions — lichen-cli, validator, SDK, and contracts.