Staking Rewards Manual (CLI)

Welcome to the comprehensive guide on earning staking rewards using the command-line interface (CLI) on OKTC. Whether you're a validator or a delegator, this manual walks you through the essential steps, commands, and best practices to maximize your staking returns securely and efficiently.

OKTC operates on a BFT-DPoS (Byzantine Fault Tolerant - Delegated Proof of Stake) consensus mechanism powered by Tendermint. This enables users to stake OKT tokens, participate in network governance, and earn rewards by delegating to trusted validators.

What Is Staking?

Staking refers to the process of locking up OKT tokens to support network security and consensus. By staking, users gain voting power and can delegate their stake to validator nodes. In return, they receive staking rewards proportional to their contribution and the validator’s performance.

Validators are responsible for validating transactions and maintaining the blockchain. Delegators, on the other hand, contribute their OKT to validators and earn a share of the block rewards—minus any commission set by the validator.

💡 Pro Tip: Before diving into CLI commands, we recommend reviewing the Delegator's Guide (CLI) for foundational knowledge.

How to Stake as an Ordinary User

For users new to staking, the process involves two main steps:

1. Stake OKT tokens to gain voting rights.
2. Delegate your voting power to one or more validators to start earning rewards.

Validators may set a commission rate on rewards, so it's wise to evaluate performance, uptime, and fee structure before delegating.

👉 Learn how to maximize your staking rewards with advanced CLI strategies.

Key CLI Commands for Delegators

Below are essential command-line operations every delegator should know. Append -h or --help to any command for detailed usage instructions.

Staking OKT

To begin staking, use the following command:

exchaincli tx staking delegate [validator-address] [amount] --from [your-key-name]

Replace [validator-address] with the target validator and [amount] with the OKT amount (e.g., 10000000okt).

Voting via Delegation

Delegating automatically casts your vote for a validator. The more stake a validator has, the higher their chance of being selected to propose blocks.

🔍 Note: Voting weight is calculated based on staked amount and delegation duration. Learn more in the Staking Rewards Algorithm.

Withdraw Staked OKT

To unbond your tokens:

exchaincli tx staking unbond [validator-address] [amount] --from [your-key-name]

Unbonding takes 21 days due to the slashing protection period.

Query Staking Information

Check your current staking status:

exchaincli query staking delegations [your-address]

This shows all active delegations and bonded amounts.

Check Staking Rewards

View pending rewards from all validators:

exchaincli query distr rewards [your-address]

Withdraw Rewards from a Single Validator

To claim rewards from one validator:

exchaincli tx distr withdraw-rewards [validator-address] --from [your-key-name]

Withdraw All Staking Rewards

Claim rewards from all validators at once:

exchaincli tx distr withdraw-all-rewards --from [your-key-name]

Frequently Asked Questions (FAQ)

Q: How often are staking rewards distributed?
A: Rewards are accrued continuously and can be withdrawn at any time using CLI commands.

Q: Is there a minimum amount of OKT required to stake?
A: Yes, there is a small minimum delegation amount (typically 1 OKT), but higher stakes improve reward efficiency.

Q: Can I lose my staked OKT?
A: Yes—validators who misbehave may be "slashed," resulting in partial loss of staked tokens. Choose reliable validators to minimize risk.

Q: How long does unbonding take?
A: The unbonding period is 21 days to ensure network security.

Q: Do I earn rewards while unbonding?
A: No. Once unbonding starts, you stop accruing rewards from that stake.

CLI Operations for Validators

Validators play a crucial role in securing the OKTC network. They propose blocks and earn commissions on rewards generated by their delegators.

Before setting up as a validator, review the Validator’s Guide (CLI) for full setup instructions.

Set Validator Commission Rate

When creating or updating your validator, define your commission:

exchaincli tx staking edit-validator --commission-rate [rate] --from [key-name]

Example: --commission-rate 0.1 sets a 10% commission.

Query Commission Rate

Check your current commission:

exchaincli query staking validator [validator-address]

Check Commission Rewards

View accumulated commission:

exchaincli query distr validator-outstanding-rewards [validator-address]

Withdraw Commission Rewards

Claim your commission earnings:

exchaincli tx distr withdraw-rewards [validator-address] --from [key-name]

👉 Discover how top validators optimize reward distribution using CLI tools.

General CLI Query Commands

The exchaincli tool allows users and validators to access real-time blockchain data.

Query Account Info

exchaincli query account [address]

Displays balance, sequence number, and account type.

Check Transaction Results

exchaincli query tx [tx-hash]

Verify if a transaction was successful.

List All Validators

exchaincli query staking validators

Returns all active and inactive validators.

View Validator Details

exchaincli query staking validator [validator-address]

Includes status, commission, and uptime info.

Query Voting Details

exchaincli query staking delegations-to [validator-address]

Shows all delegators to a specific validator.

Check Staking Module Parameters

exchaincli query staking params

Reveals global staking settings like bond denomination and max validators.

Check Reward Module Parameters

exchaincli query distr params

Displays community tax, base proposer reward, etc.

Manage Reward Withdrawal Address

Set a separate address for receiving rewards:

exchaincli tx distr set-withdraw-addr [withdrawal-address] --from [key-name]

Query current withdrawal address:

exchaincli query distr withdraw-addr [delegator-address]

Proxy Delegation Management

Advanced users can act as proxies, managing delegations for others.

• Register as Proxy: exchaincli tx proxy register --from [key]
• Unregister Proxy: exchaincli tx proxy unregister --from [key]
• Bind Delegator: exchaincli tx proxy bind [delegator-address] --from [proxy-key]
• Unbind Delegator: exchaincli tx proxy unbind [delegator-address] --from [proxy-key]
• List Delegators via Proxy: exchaincli query proxy delegators [proxy-address]

Query Network-Wide Data

Monitor overall network health with these commands:

• Staking Pool: exchaincli query staking pool
  Shows bonded vs. not-bonded token supply.
• Validator Voting Power: Use delegations-to and validator queries to assess influence distribution.

Final Tips for Maximizing Staking Returns

• Diversify delegations across multiple high-performing validators.
• Reinvest rewards regularly to compound gains.
• Monitor validator uptime and avoid those with frequent downtime.
• Use withdrawal batching to reduce transaction fees.

👉 Start optimizing your staking strategy today with powerful CLI tools.

Core Keywords:

staking rewards, CLI staking, OKT staking, validator commission, delegator guide, exchaincli commands, withdraw staking rewards, BFT-DPoS

By mastering these CLI operations, both delegators and validators can actively participate in the OKTC ecosystem, enhance network decentralization, and generate consistent passive income. Always ensure secure key management and stay updated with official documentation for protocol changes.