CLI Reference

The Vexidus CLI (vexidus) provides 15 command groups with 79+ subcommands for interacting with the blockchain. All commands communicate with a running node via JSON-RPC.

Installation

The CLI binary is built alongside the node:

cargo build --release
# Binary at: target/release/vexidus

Configuration

By default, the CLI connects to https://testnet.vexidus.io. Override with --rpc:

vexidus --rpc https://testnet.vexidus.io balance get <address>

Command Groups

wallet -- Wallet Management

vexidus wallet generate              # Generate new Ed25519 keypair
vexidus wallet info --key <path>     # Show addresses (Vx0, 0x hex, EVM)
vexidus wallet balance <address>     # Check VXS balance

transfer -- Token Transfers

vexidus transfer send --from <addr> --to <addr> --token VXS --amount 100
vexidus transfer status <tx_hash>    # Check transfer status

token -- Token Operations (VSC-7)

vexidus token create --name "MyToken" --symbol MTK --decimals 9 --supply 1000000 --owner <addr>
vexidus token info <symbol_or_mint>
vexidus token list --limit 100
vexidus token update-metadata <mint> --image "https://..." --description "..."
vexidus token lock-metadata <mint>
vexidus token reputation <mint>

nft -- NFT Operations (VSC-21)

vexidus nft create-collection --name "My NFTs" --symbol MNFT --base-uri "ipfs://..." --max-supply 10000 --royalty 500
vexidus nft mint --collection <addr> --token-id 1 --metadata-uri "ipfs://..." --recipient <addr>
vexidus nft transfer --collection <addr> --token-id 1 --to <addr>
vexidus nft burn --collection <addr> --token-id 1
vexidus nft info --collection <addr> --token-id 1
vexidus nft list --owner <addr>
vexidus nft collection <addr>

multitoken -- Multi-Token Operations (VSC-55)

vexidus multitoken create-collection --name "Game Items" --symbol GAME
vexidus multitoken define-type --collection <addr> --type-id 1 --name "Gold" --fungible
vexidus multitoken mint --collection <addr> --type-id 1 --amount 1000 --recipient <addr>
vexidus multitoken transfer --collection <addr> --type-id 1 --amount 50 --to <addr>
vexidus multitoken balance --collection <addr> --type-id 1 --owner <addr>

dex -- DEX Operations (VexiDEX)

vexidus dex create-pool --token-a VXS --token-b USDC --amount-a 1000 --amount-b 5000
vexidus dex add-liquidity --token-a VXS --token-b USDC --amount-a 100 --amount-b 500
vexidus dex remove-liquidity --token-a VXS --token-b USDC --lp-amount 50
vexidus dex swap --from VXS --to USDC --amount 100 --min-out 490
vexidus dex quote --from VXS --to USDC --amount 100
vexidus dex pools --limit 100
vexidus dex pool --token-a VXS --token-b USDC

presale -- Presale Operations (VSC-LAUNCH)

vexidus presale create --token <mint> --price 100 --soft-cap 1000 --hard-cap 5000
vexidus presale contribute --presale <addr> --amount 100
vexidus presale finalize --presale <addr>
vexidus presale refund --presale <addr>
vexidus presale info <addr>
vexidus presale list --limit 50

bridge -- Bridge Operations

vexidus bridge deposit --chain ethereum --tx-hash 0x... --symbol USDC --amount 1000 --recipient <addr>
vexidus bridge withdraw --token <mint> --amount 1000 --chain ethereum --destination 0x...
vexidus bridge status --chain ethereum --tx-hash 0x...
vexidus bridge history --address <addr> --limit 50
vexidus bridge fees --chain ethereum

validator -- Validator Operations

vexidus validator stake --address <addr> --amount 1000 --pubkey <hex>
vexidus validator unstake --address <addr> --amount 1000
vexidus validator info --address <addr>
vexidus validator list --limit 100
vexidus validator staking-info
vexidus validator set-commission --address <addr> --rate 500
vexidus validator unjail --address <addr>
vexidus validator set-metadata --address <addr> --name "My Node" --description "..."
vexidus validator delegations --address <addr>
vexidus validator set-auto-compound --address <addr> --validator <validator_addr> --enable true
vexidus validator set-pool-config --address <addr> --pool-name "My Pool" --min-delegation 100 --auto-compound-default true

intent -- IntentVM Operations

vexidus intent submit "swap 100 VXS for USDC" --sender <addr>
vexidus intent plan "stake 1000 VXS"
vexidus intent status <bundle_hash>

upgrade -- VexVisor Upgrade Governance

vexidus upgrade schedule --name "v0.2.0" --height 100000 --url "https://..." --checksum "abc..."
vexidus upgrade vote --name "v0.2.0" --approve
vexidus upgrade cancel --name "v0.2.0"
vexidus upgrade plan
vexidus upgrade rollback

explorer -- Explorer Queries

vexidus explorer block <height>
vexidus explorer recent-blocks --limit 10
vexidus explorer recent-txs --limit 20
vexidus explorer stats
vexidus explorer search <query>
vexidus explorer address <addr>
vexidus explorer tx <hash>

vns -- Vexidus Name Service

vexidus vns register <name>         # Register a .vex name
vexidus vns resolve <name>          # Resolve name to address
vexidus vns reverse <address>       # Reverse lookup
vexidus vns info <name>             # Full name details

governance -- Protocol Governance (VSC-88)

vexidus governance create-proposal \
  --type param \                     # param | treasury | text
  --title "Reduce gas price" \
  --description "Lower from 10 to 5 nanoVXS" \
  --param-key gas_price \
  --param-value 5

vexidus governance vote --id 1 --approve     # Vote yes on proposal #1
vexidus governance vote --id 1 --reject      # Vote no on proposal #1
vexidus governance execute --id 1            # Execute an approved proposal
vexidus governance cancel --id 1             # Cancel (proposer only)
vexidus governance list                      # List all proposals
vexidus governance list --status voting      # Filter by status
vexidus governance show --id 1               # Show proposal details

multisig -- Multi-Sig Wallets (VSC-88)

vexidus multisig create \
  --signers Vx0Addr1...,Vx0Addr2...,Vx0Addr3... \
  --threshold 2 \
  --label "Team Treasury"

vexidus multisig propose \
  --account Vx0MultiSig... \
  --operations '[{"Transfer":{"to":"Vx0...","token_symbol":"VXS","amount":50000000000}}]' \
  --description "Monthly budget"

vexidus multisig approve --account Vx0MultiSig... --tx-id 0
vexidus multisig revoke --account Vx0MultiSig... --tx-id 0
vexidus multisig show --account Vx0MultiSig...
vexidus multisig list-txs --account Vx0MultiSig...

Global Options

Flag	Description
--rpc <URL>	RPC endpoint URL (default: https://testnet.vexidus.io)
--gas-price <N>	Gas price in nanoVXS (default: 10)
--json	Output in JSON format
-v, --verbose	Verbose output
-h, --help	Print help