Useful commands

Validator management

This section will guide you through how you can run your own validator. Validator operations may be done via the story consensus client detailed in the node setup section.

Validator key export

View your validator keys

story validator export

Export the derived EVM private key of your validator into the default data config directory.

story validator export --export-evm-key

You may add --evm-key-path to specify a different download location.

Validator creation

Create a new validator

story validator create --stake ${AMOUNT_TO_STAKE_IN_WEI}

This will create the validator corresponding to your validator key saved in priv_validator_key.json, providing the validator with {$AMOUNT_TO_STAKE_IN_WEI} IP to self-stake. Note that to participate in consensus, at least 1 IP must be staked (equivalent to 1000000000000000000 wei)!

Validator staking

Stake to an existing validator

story validator stake --validator-pubkey ${VALIDATOR_PUB_KEY_IN_BASE64} --stake ${AMOUNT_TO_STAKE_IN_WEI}

You must stake at least 1 024 IP worth (1,000,000,000,000,000,000 wei) for the transaction to be valid.

Validator unstaking

Unstake from the selected validator

story validator unstake --validator-pubkey ${VALIDATOR_PUB_KEY_IN_BASE64} --unstake ${AMOUNT_TO_UNSTAKE_IN_WEI}

Validator stake-on-behalf

Stake on behalf of another delegator. This will stake ${AMOUNT_TO_STAKE_IN_WEI} IP to the validator on behalf of the provided delegator.

story validator stake-on-behalf --delegator-pubkey ${DELEGATOR_PUB_KEY_IN_BASE64} --validator-pubkey ${VALIDATOR_PUB_KEY_IN_BASE64} --stake ${AMOUNT_TO_STAKE_IN_WEI}

Validator unstake-on-behalf

Unstake on behalf of another delegator as an operator

story validator unstake-on-behalf --delegator-pubkey ${DELEGATOR_PUB_KEY_IN_BASE64} --validator-pubkey ${VALIDATOR_PUB_KEY_IN_BASE64} --unstake ${AMOUNT_TO_STAKE_IN_WEI}

To unstake on behalf of delegators you must be registered as an authorized operator for that delegator.

Operator management

Delegators may add operators to unstake or redelegate on their behalf.

Add operator

story validator add-operator --operator ${OPERATOR_EVM_ADDRESS}

Remove operator

story validator remove-operator --operator ${OPERATOR_EVM_ADDRESS}