Dev Hub › CLI Reference

CLI Reference

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

Installation

Install with cargo install moltchain-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

$ molt --rpc-url https://testnet-rpc.moltchain.io balance
$ molt --version
molt-cli 0.9.2 (moltchain)

Wallet Commands

Multi-wallet management — create, import, inspect, and remove wallets. Wallet keypairs are stored in ~/.moltchain/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

$ molt wallet create my-agent

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

 Done! Fund with: molt 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

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

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

`molt wallet list`

List all wallets stored locally with their addresses.

Shell

molt wallet list

Shell

$ molt 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

$ molt wallet show my-agent

 Wallet: my-agent
 Address:  Mo1tABcDeFgH1jK2LmNoPqRsTuVwXyZ3456789ab
 Keypair:  ~/.moltchain/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

$ molt wallet balance my-agent

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

`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

$ molt 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 ~/.moltchain/keypairs/id.json by default.

`molt identity new`

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

Shell

molt identity new [--output <path>]

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

Shell

$ molt identity new

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

 Get test tokens: molt airdrop 100

Keypair Encryption

Set the MOLTCHAIN_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 MoltChain identity — public key, EVM address, and keypair file location.

Shell

molt identity show [--keypair <path>]

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

Shell

$ molt identity show

 Your MoltChain Identity
 Pubkey:      Mo1tABcDeFgH1jK2LmNoPqRsTuVwXyZ3456789ab
 EVM Address: 0x7a3b...9f2e
 Keypair:     ~/.moltchain/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

$ molt validator info Mo1tVa1iDatoR12345abcdef

 Validator Information
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 Pubkey:          Mo1tVa1iDatoR12345abcdef
 Stake:           50000.0000 MOLT
 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

$ molt 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

$ molt validator list

 Active Validators
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
#1 Mo1tVa1iDatoR12345abcdef
   Stake: 50000.0 MOLT
   Reputation: 98

#2 Mo1tVa1iDatoR67890ghijkl
   Stake: 25000.0 MOLT
   Reputation: 95

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Total: 2 validators, 75000.0 MOLT staked

Staking Commands

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

`molt stake add`

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

Shell

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

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

Shell

$ molt stake add 10000000000000

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

`molt stake remove`

Unstake MOLT 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 shells to unstake
`--keypair, -k`	path	`~/.moltchain/keypairs/id.json`	Keypair file

Shell

$ molt stake remove 5000000000000

 Unstaking 5000.0 MOLT...
 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	`~/.moltchain/keypairs/id.json`	Keypair file (used if no address given)

Shell

$ molt stake status

 Staking Status
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 Account:   Mo1tABcDeFgH1jK2LmNoPqRsTuVw...
 Staked:    10000.0000 MOLT
 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	`~/.moltchain/keypairs/id.json`	Keypair file

Shell

$ molt stake rewards

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

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 MOLT (CONTRACT_DEPLOY_FEE).

Shell

molt deploy <contract.wasm> [--keypair <path>]

Flag / Arg	Type	Default	Description
`contract`	path	required	Path to the compiled WASM file
`--keypair, -k`	path	`~/.moltchain/keypairs/id.json`	Deployer keypair

Shell

$ molt deploy target/wasm32-unknown-unknown/release/my_contract.wasm

 Deploying contract...

  Program ID:  Mo1tProg1D12345abcdefghijklmnop
  Size:        14,832 bytes
  Deploy tx:   9kR7...sWmN
  Fee:         0.014832000 MOLT
  Status:      Finalized

 Contract deployed successfully!

`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	`~/.moltchain/keypairs/id.json`	Caller keypair

Shell

$ molt call Mo1tProg1D12345abcdefghijklmnop set_greeting \
    --args '["Hello, MoltChain!"]'

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

`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

$ molt 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

$ molt contract logs Mo1tProg1D12345abcdefghijklmnop --limit 5

 Contract Logs (last 5)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
[slot 482917] GreetingSet("Hello, MoltChain!")
[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

$ molt contract list

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

Query Commands

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

`molt balance`

Check the MOLT 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	`~/.moltchain/keypairs/id.json`	Keypair to derive address from (if no address given)

Shell

$ molt balance

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

`molt transfer`

Send MOLT 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 MOLT
`--keypair, -k`	path	`~/.moltchain/keypairs/id.json`	Sender keypair

Shell

$ molt transfer Mo1tRecipientAddress123456789abcdefghijk 1.5

 Transferring 1.5 MOLT (1500000000 shells)
 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 MOLT to request
`--pubkey, -p`	Base58	your identity	Recipient address
`--keypair, -k`	path	`~/.moltchain/keypairs/id.json`	Keypair to derive address from

Shell

$ molt airdrop 50

 Requesting 50 MOLT airdrop...

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

 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

$ molt 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

$ molt 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

$ molt slot
 Current slot: 483201

`molt blockhash`

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

Shell

molt blockhash

Shell

$ molt blockhash
 Recent blockhash: f2a1b3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f9a0

`molt burned`

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

Shell

molt burned

Shell

$ molt burned

 Total MOLT Burned
 1,247.832000000 MOLT (1247832000000 shells)

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

$ molt validators

 Active Validators
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
#1 Mo1tVa1iDatoR12345abcdef
   Stake: 50000.0 MOLT    Reputation: 98

#2 Mo1tVa1iDatoR67890ghijkl
   Stake: 25000.0 MOLT    Reputation: 95
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Total: 2 validators, 75000.0 MOLT staked

`molt status`

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

Shell

molt status

Shell

$ molt status

 MoltChain 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

$ molt 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

$ molt account info Mo1tABcDeFgH1jK2LmNoPqRsTuVwXyZ3456789ab

 Account Details
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 Address:     Mo1tABcDeFgH1jK2LmNoPqRsTuVwXyZ3456789ab
 Balance:     100.0000 MOLT
 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

$ molt account history Mo1tABcDeFgH1jK2LmNoPqRsTuVwXyZ3456789ab --limit 3

 Transaction History (last 3)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
[slot 482917] Transfer  -1.5000 MOLT → Mo1tRecip...
[slot 482800] Airdrop  +50.0000 MOLT
[slot 482750] Stake    -10.0000 MOLT (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

$ molt 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

$ molt 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

$ molt network info

 Network Information
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 Network ID:  moltchain-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 MoltChain.

`molt token create`

Create a new fungible token with a name, symbol, initial supply, and decimal precision.

Shell

molt token create <name> <symbol> [--supply <n>] [--decimals <n>] [--keypair <path>]

Flag / Arg	Type	Default	Description
`name`	string	required	Token display name
`symbol`	string	required	Token symbol (3-5 characters)
`--supply, -s`	u64	`1000000`	Initial supply (in whole tokens)
`--decimals, -d`	u8	`9`	Decimal precision
`--keypair, -k`	path	`~/.moltchain/keypairs/id.json`	Token owner keypair

Shell

$ molt token create "Reef Token" REEF --supply 500000 --decimals 6

 Creating token...
  Name:     Reef Token
  Symbol:   REEF
  Supply:   500,000
  Decimals: 6
  Address:  Mo1tToken1234567890abcdefghijk
 Token created!

`molt token info`

Show metadata and supply information for a token.

Shell

molt token info <token>

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

Shell

$ molt token info REEF

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

`molt token mint`

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

Shell

molt 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	`~/.moltchain/keypairs/id.json`	Token owner keypair

Shell

$ molt token mint Mo1tToken1234567890abcdefghijk 10000

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

`molt token send`

Transfer custom tokens to another address.

Shell

molt 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	`~/.moltchain/keypairs/id.json`	Sender keypair

Shell

$ molt token send Mo1tToken1234567890abcdefghijk Mo1tRecipient... 500

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

`molt token balance`

Query the token balance for a given account.

Shell

molt 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	`~/.moltchain/keypairs/id.json`	Keypair (used if no address)

Shell

$ molt token balance Mo1tToken1234567890abcdefghijk

 Token Balance
   REEF: 499,500

`molt token list`

List all registered tokens on the network.

Shell

molt token list

Shell

$ molt 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	`~/.moltchain/keypairs/id.json`	Proposer keypair

Shell

$ molt 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	`~/.moltchain/keypairs/id.json`	Voter keypair

Shell

$ molt 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

$ molt 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

$ molt 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	`~/.moltchain/keypairs/id.json`	Executor keypair

Shell

$ molt 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	`~/.moltchain/keypairs/id.json`	Authority keypair

Shell

$ molt 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 MoltChain network.

Smart Contracts

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

GitHub

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