Validator Guide (CLI)

·

The Proof of Stake (PoS) consensus mechanism is a cornerstone of modern blockchain networks, and staking plays a vital role in maintaining network security, decentralization, and efficiency. On the OKT Chain (OKTC), validators are responsible for producing blocks and securing the network by staking OKT tokens. This guide provides a comprehensive overview of how to manage validators using the Command Line Interface (CLI), including creating, updating, and decommissioning validator nodes.

Whether you're an experienced node operator or new to blockchain infrastructure, understanding the validator lifecycle and rotation mechanism is essential for participating effectively in the OKTC ecosystem.

How Validator Rotation Works

OKTC operates on a dynamic validator rotation system that ensures fairness and performance across the network. At regular intervals—known as cycles—the network re-evaluates which nodes will serve as block producers in the upcoming cycle.

Each cycle consists of 252 blocks, and the selection for the next cycle occurs at block 251 of the current cycle. The new validator set takes effect starting from the first block of the next cycle.

Only the top 21 nodes with the highest amount of staked OKT are selected to become active block producers. Validators outside this top 21 are automatically rotated out. During the comparison process, only whole numbers of OKT are considered—any decimal portions are truncated, not rounded.

This mechanism incentivizes validators to maintain high uptime, reliable performance, and competitive delegation offerings to attract stake from delegators.

👉 Discover how to become a top-performing validator on OKTC

Essential CLI Commands for Validator Management

Managing a validator on OKTC is done through a series of CLI commands that allow operators full control over their node’s configuration, commission rate, and lifecycle. Below is a breakdown of key commands every validator should know.

Create a Validator

To become an active participant in block production, you must first create a validator node using the create-validator command. This upgrades your node from a regular full node to a validator and registers it on the network.

Key parameters include:

Example:

exchaind tx staking create-validator \
  --pubkey=$(exchaind tendermint show-validator) \
  --moniker="my-validator" \
  --identity="abc123" \
  --website="https://myvalidator.com" \
  --details="Reliable, secure, and community-driven validator" \
  --from=operator-key \
  --gas-price=0.00000001okt

Ensure consistency if you've set a custom --home directory when starting your node.

Update a Validator

As your operation evolves, you may want to update your validator’s public information. Use the edit-validator command to modify:

This helps maintain trust with delegators by keeping your profile accurate and professional.

Command example:

exchaind tx staking edit-validator \
  --moniker="updated-name" \
  --details="Now supporting 99.9% uptime SLA" \
  --from=operator-key \
  --gas-price=0.00000001okt

Adjust Validator Commission Rate

Validators earn rewards from block production and share a portion with their delegators. The commission rate determines how much you retain before distributing rewards.

Use edit-validator-commission-rate to adjust this value:

Example:

exchaind tx staking edit-validator-commission-rate \
  --commission-rate=0.1 \
  --from=operator-key \
  --gas-price=0.00000001okt

👉 Learn how to optimize your commission strategy for maximum delegation

Decommission a Validator

If you wish to stop operating your validator, use the destroy-validator command to safely remove your node from the active set.

Important notes:

There is no immediate penalty for leaving, but frequent entry/exit may affect reputation among delegators.

Expanding Your Validator Toolkit

Beyond core management commands, OKTC supports additional CLI functions for advanced staking operations. These include:

You can also query critical data such as:

These tools empower validators to monitor performance, optimize earnings, and provide transparency to stakeholders.

Frequently Asked Questions

Q: How often does the validator set change?
A: Every 252 blocks (~every few minutes depending on block time), with updates decided at block 251 of each cycle.

Q: What happens if my validator drops out of the top 21?
A: You’ll be rotated out of the active set and won’t produce blocks until you re-enter via increased stake or others dropping below you.

Q: Can I change my commission rate anytime?
A: No. You can only adjust it once every 24 hours to prevent rapid manipulation and ensure stability for delegators.

Q: How long does it take to withdraw funds after destroying my validator?
A: There’s a mandatory 14-day unbonding period before your OKT becomes transferable again.

Q: Do decimals count when comparing staked OKT amounts?
A: No. Only whole numbers are used during rotation—fractions are truncated, not rounded.

Q: Where can I find more CLI commands and examples?
A: Refer to the official documentation for extended staking and delegation CLI references.

Final Thoughts

Running a validator on OKTC is both a technical and strategic endeavor. With the right setup, consistent operation, and transparent communication, you can build trust with delegators and secure a lasting position in the top 21 validator set.

By mastering the CLI tools outlined here—from creation to commission management—you gain full control over your node’s performance and profitability.

👉 Start building your high-performance validator node today