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-cli version

Prints the CLI version.

keys

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

keys generate

platform-cli 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-cli 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-cli keys list [--show-addresses]

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

keys export

platform-cli keys export --name <name> --output-file <path>
platform-cli 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-cli keys delete --name <name> [--force]

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

keys default

platform-cli keys default [--name <name>]

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

wallet

wallet balance

platform-cli wallet balance

Displays P-Chain address and AVAX balance.

wallet address

platform-cli wallet address

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

transfer

transfer send

platform-cli 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-cli 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-cli transfer c-to-p --amount <avax>

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

transfer export

platform-cli 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-cli 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-permissionless

platform-cli validator add-permissionless --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`). Ignored post-Durango; validation starts at tx acceptance	`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 add-permissionless-delegator

platform-cli validator add-permissionless-delegator --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`). Ignored post-Durango; validation starts at tx acceptance	`now`
`--reward-address`	Reward address	own address

validator add-auto-renewed

platform-cli validator add-auto-renewed --node-id <id> --stake <avax>

Adds an auto-renewed validator (AddAutoRenewedValidatorTx, ACP-236) that restakes each cycle.

Flag	Description	Default
`--node-id`	Node ID to validate (required)
`--stake`	Stake in AVAX (network minimum applies)
`--period`	Auto-renewal cycle duration	`336h`
`--auto-compound`	Fraction of rewards to auto-compound (0.3 = 30%, 1 = 100%)	`1`
`--delegation-fee`	Fee percentage (0.02 = 2%)	`0.02`
`--owner-address`	Address authorized to update the auto-renew config	own address
`--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 set-auto-renewed-config

platform-cli validator set-auto-renewed-config --tx-id <id> --period <dur> --auto-compound <frac>

Updates the next-cycle config of an auto-renewed validator (SetAutoRenewedValidatorConfigTx). Must be signed by the owner address set at add time.

Flag	Description
`--tx-id`	Original `AddAutoRenewedValidatorTx` ID (required)
`--period`	Next cycle duration, or `0` to exit after the current cycle (required)
`--auto-compound`	Fraction of rewards to auto-compound (required)
`--node-id`	Validator node ID to narrow the authority lookup (optional, recommended)

subnet

subnet create

platform-cli subnet create

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

subnet transfer-ownership

platform-cli 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-to-l1

platform-cli subnet convert-to-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`

subnet add-validator

platform-cli subnet add-validator --subnet-id <id> --node-id <id> --weight <uint>

Adds a validator to a permissioned subnet (AddSubnetValidatorTx). The node must already be a primary network validator.

Flag	Description	Default
`--subnet-id`	Subnet ID (required)
`--node-id`	Validator node ID, must already validate the primary network (required)
`--weight`	Validator sampling weight on the subnet (required, > 0)
`--start`	Start time (RFC3339 or `now`). Ignored post-Durango; validation starts at tx acceptance	`now`
`--duration`	Validation duration (must fall within the node's primary network validation period)	`336h`

l1

l1 register-validator

platform-cli 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-validator-weight

platform-cli l1 set-validator-weight --message <hex>

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

l1 increase-validator-balance

platform-cli l1 increase-validator-balance --validation-id <id> --balance <avax>

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

l1 disable-validator

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

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

chain

chain create

platform-cli 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-cli 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