CLI Arguments Reference

Complete reference for all svmgov CLI command-line arguments and configuration.

Global Arguments (All Commands)

Resolution order: explicit flags → env vars → config file → built-in defaults

--squads accepts the vault address shown in the Squads app. The CLI looks up its multisig on the selected RPC and verifies the vault derivation before loading the signer. Vault lookup requires an RPC that supports getProgramAccounts; it can take several seconds on mainnet. Existing multisig state addresses skip the lookup. For a sub-account, also supply its index with --squads-vault-index.

Ledger

Pass a Solana Ledger URI to --keypair (or --staker-keypair):

svmgov update-global-config \
  --max-support-epochs 10 --discussion-epochs 10 --voting-epochs 4 \
  --keypair 'usb://ledger?key=0/0' \
  --squads "$SQUADS" --rpc-url "$MAINNET_RPC"

Use the derivation path for your account: ?key=0/0 selects m/44'/501'/0'/0'; omitting ?key= uses Solana’s default m/44'/501'. A device can be selected with usb://ledger/<PUBKEY>?key=0/0, where <PUBKEY> is its default-path public key. Unlock the Ledger, open the Solana app, and enable blind signing for governance and Squads instructions. Approve each transaction on the device. In Squads mode, the Ledger signs the proposal creation transaction as a multisig member and fee payer.

Ledger URIs also work in SVMGOV_KEY and the existing keypair config values. Building from source on Debian/Ubuntu additionally requires libudev-dev.

Configuration File

Path: ~/.svmgov/config.toml

user_type = "Validator"               # or "Staker"
identity_keypair_path = "/path/to/validator.json"
network = "mainnet"
rpc_url = "https://api.mainnet-beta.solana.com"
operator_api_url = "https://ncn-governance.solana.com"

The default operator_api_url is the main NCN router.

Config Commands

svmgov config show                              # Show entire config
svmgov config get <key>                         # Get one value
svmgov config set <key> <value>                 # Set one value

Settable Keys

Basis Points

All vote allocations use basis points (bp):

When voting, for_votes + against_votes + abstain_votes must equal exactly 10,000.

Validator Command Arguments

create-proposal

support-proposal

cast-vote / modify-vote

finalize-proposal

list-proposals

proposal

Staker Command Arguments

cast-vote-override / modify-vote-override

Admin Command Arguments

init-global-config

update-global-config

Same fields as init-global-config, but every field is optional and only supplied values are changed.

nominate-admin / accept-admin