Skip to main content

Network Commands (modal net / modal network)

Query and interact with Modality networks.

Network Info

modal net info [OPTIONS]

Display information about a Modality network.

Options:

OptionDescription
--network <NAME>Network name (mainnet/testnet)
--peer <ADDR>Query specific peer

Example output:

NETWORK: mainnet
Chain height: 1,234,567
Active validators: 42
Active miners: 128
Contracts: 5,432

BOOTSTRAP PEERS:
/ip4/boot1.modality.network/tcp/9000/p2p/12D3Koo...
/ip4/boot2.modality.network/tcp/9000/p2p/12D3Koo...

Network Storage

modal net storage [OPTIONS]

Inspect network datastore and show statistics.

Options:

OptionDescription
--node <PATH>Node directory
--verboseShow detailed breakdown

Mining Commands

Sync Mining Data

modal net mining sync [OPTIONS]

Sync miner blocks from a specified node.

Options:

OptionDescription
--from <PEER>Source peer address
--node <PATH>Local node directory

Local Development

List Local Nodes

modal local nodes

Find all running modal node processes.

Kill All Nodes

modal local killall-nodes
modal killall # shortcut

Kill all running modal node processes.

Chain Commands

Validate Chain

modal chain validate [OPTIONS]

Validate the local chain for consistency.

Options:

OptionDescription
--node <PATH>Node directory
--from <HEIGHT>Start height
--to <HEIGHT>End height
--verboseShow validation details

Heal Chain

modal chain heal [OPTIONS]

Attempt to repair chain inconsistencies.

Options:

OptionDescription
--node <PATH>Node directory
--backupCreate backup before healing
--dry-runShow what would be done

Quick Run Commands

Shortcuts for running different node types:

# Run a miner
modal run miner --path ./my-node

# Run a validator
modal run validator --path ./my-node

# Run an observer
modal run observer --path ./my-node

These are equivalent to modal node run-miner, modal node run-validator, etc.