Command Reference

Global Flags

Available on all commands:

Flag	Short	Description	Default
`--network`	`-n`	Network: `fuji` or `mainnet`	`fuji`
`--key-name`		Load key from keystore by name
`--ledger`		Use Ledger hardware wallet	`false`
`--ledger-index`		Ledger BIP44 address index	`0`
`--rpc-url`		Custom RPC URL (overrides `--network`)
`--network-id`		Network ID for custom RPC	auto-detect
`--allow-insecure-http`		Allow plain HTTP for non-local endpoints (unsafe)	`false`
`--private-key`	`-k`	Private key (deprecated, prefer `--key-name`)

version

platform version

Prints the CLI version.

keys

Manage persistent keys stored in ~/.platform/keys/.

keys generate

platform keys generate --name <name> [--encrypt=false]

Flag	Description	Default
`--name`	Key name (required, 1-64 chars: `[a-zA-Z0-9._-]`, starts with alphanumeric)
`--encrypt`	Encrypt with password (AES-256-GCM + Argon2id)	`true`

keys import

platform keys import --name <name> [--private-key <key>] [--encrypt=false]

Flag	Description	Default
`--name`	Key name (required)
`--private-key`	Private key string (prompted if omitted)
`--encrypt`	Encrypt with password	`true`

keys list

platform keys list [--show-addresses]

Flag	Description
`--show-addresses`	Show P-Chain and EVM addresses

keys export

platform keys export --name <name> --output-file <path>
platform keys export --name <name> --unsafe-stdout

Flag	Description	Default
`--name`	Key name (required)
`--format`	Output format: `cb58` or `hex`	`cb58`
`--output-file`	Write key to file (permissions forced to 0600)
`--unsafe-stdout`	Print private key to stdout (unsafe, required if no `--output-file`)	`false`

keys delete

platform keys delete --name <name> [--force]

Flag	Description
`--name`	Key name (required)
`--force`	Skip confirmation prompt

keys default

platform keys default [--name <name>]

Shows current default if --name is omitted. Sets default if --name is provided.

wallet

wallet balance

platform wallet balance

Displays P-Chain address and AVAX balance.

wallet address

platform wallet address

Displays P-Chain and EVM addresses derived from the key.

transfer

transfer send

platform transfer send --to <address> --amount <avax>

Flag	Description
`--to`	Destination P-Chain address (required)
`--amount`	Amount in AVAX
`--amount-navax`	Amount in nAVAX (mutually exclusive with `--amount`)

transfer p-to-c

platform transfer p-to-c --amount <avax>

One-step P-Chain to C-Chain transfer (export + import).

Flag	Description
`--amount`	Amount in AVAX
`--amount-navax`	Amount in nAVAX

transfer c-to-p

platform transfer c-to-p --amount <avax>

One-step C-Chain to P-Chain transfer (export + import).

transfer export

platform transfer export --from <chain> --to <chain> --amount <avax>

Manual export step for two-step transfers.

Flag	Description
`--from`	Source chain: `p` or `c` (required)
`--to`	Destination chain: `p` or `c` (required)
`--amount`	Amount in AVAX
`--amount-navax`	Amount in nAVAX

transfer import

platform transfer import --from <chain> --to <chain>

Manual import step for two-step transfers.

Flag	Description
`--from`	Source chain: `p` or `c` (required)
`--to`	Destination chain: `p` or `c` (required)

validator

validator add

platform validator add --node-id <id> --stake <avax>

Flag	Description	Default
`--node-id`	Node ID (required)
`--stake`	Stake in AVAX (required)
`--duration`	Validation duration	`336h`
`--start`	Start time (RFC3339 or `now`)	`now`
`--delegation-fee`	Fee percentage (0.02 = 2%)	`0.02`
`--reward-address`	Reward address	own address
`--bls-public-key`	BLS public key hex (recommended)
`--bls-pop`	BLS proof of possession hex (recommended)
`--node-endpoint`	Node endpoint to auto-fetch BLS

validator delegate

platform validator delegate --node-id <id> --stake <avax>

Flag	Description	Default
`--node-id`	Node ID to delegate to (required)
`--stake`	Stake in AVAX (required)
`--duration`	Delegation duration	`336h`
`--start`	Start time (RFC3339 or `now`)	`now`
`--reward-address`	Reward address	own address

subnet

subnet create

platform subnet create

Creates a new subnet owned by the wallet address. No additional flags required.

subnet transfer-ownership

platform subnet transfer-ownership --subnet-id <id> --new-owner <address>

Flag	Description
`--subnet-id`	Subnet ID (required)
`--new-owner`	New owner P-Chain address (required)

subnet convert-l1

platform subnet convert-l1 --subnet-id <id> --chain-id <id>

Flag	Description	Default
`--subnet-id`	Subnet ID to convert (required)
`--chain-id`	Chain ID for validator manager (required)
`--manager`	Validator manager contract address (hex)
`--contract-address`	Alias for `--manager`
`--validators`	Comma-separated node addresses (auto-discovery mode)
`--validator-node-ids`	Manual mode: comma-separated NodeIDs
`--validator-bls-public-keys`	Manual mode: comma-separated BLS public keys
`--validator-bls-pops`	Manual mode: comma-separated BLS PoPs
`--validator-balance`	Balance per validator in AVAX	`1.0`
`--mock-validator`	Use mock validator for testing	`false`

l1

l1 register-validator

platform l1 register-validator --balance <avax> --pop <hex> --message <hex>

Flag	Description
`--balance`	Initial balance in AVAX (required)
`--pop`	BLS proof of possession hex (required)
`--message`	Warp message hex (required)

l1 set-weight

platform l1 set-weight --message <hex>

Flag	Description
`--message`	Warp message authorizing weight change (required)

l1 add-balance

platform l1 add-balance --validation-id <id> --balance <avax>

Flag	Description
`--validation-id`	Validation ID (required)
`--balance`	AVAX to add (required)

l1 disable-validator

platform l1 disable-validator --validation-id <id>

Flag	Description
`--validation-id`	Validation ID to disable (required)

chain

chain create

platform chain create --subnet-id <id> --genesis <file>

Flag	Description	Default
`--subnet-id`	Subnet ID (required)
`--genesis`	Genesis JSON file path (required, max 1 MB)
`--name`	Chain name	`mychain`
`--vm-id`	VM ID	Subnet-EVM

node

node info

platform node info --ip <address>

Flag	Description
`--ip`	Node IP address or hostname (required)

Returns Node ID, BLS Public Key, and BLS Proof of Possession.

On this page