Staking Rewards Manual (CLI)

·

Staking is a powerful way to participate in blockchain networks, earn passive income, and contribute to network security. On the OKTC blockchain—powered by Tendermint’s Byzantine Fault Tolerant Delegated Proof of Stake (BFT-DPoS) consensus—users can stake OKT tokens to gain voting rights and earn rewards through delegation or by operating as a validator. This guide provides a comprehensive walkthrough of how to use the command-line interface (CLI) to manage staking activities, claim rewards, and monitor performance.

Whether you're a delegator looking to maximize returns or a validator managing commission rates and operations, this manual equips you with essential CLI commands and insights for seamless interaction with the OKTC network.

👉 Unlock your staking potential with powerful tools and real-time data.


What Is Staking?

Staking involves locking up cryptocurrency tokens—OKT in this case—to support the operations of a blockchain network. By staking OKT on OKTC, users gain voting power proportional to their stake and can delegate their voting rights to validator nodes. Validators are responsible for proposing and validating blocks, and in return, both validators and delegators receive staking rewards.

These rewards are distributed based on each participant's share of the total staked amount and the validator’s commission rate. The system incentivizes honest behavior and long-term participation, enhancing decentralization and network resilience.

For deeper technical details, refer to the Staking Rewards Algorithm documentation.


How to Stake for Regular Users

Participating as a delegator is straightforward and accessible to all OKT holders. Follow these two key steps:

  1. Stake OKT to obtain voting rights.
  2. Delegate your stake to one or more validators. If the validator charges a commission and distributes rewards, you’ll earn a portion of the block rewards based on your contribution.
💡 Tip: Your voting weight is determined by the amount of OKT staked and the duration of delegation. Learn more in the Voting Weight Calculation section.

Key Actions:

All actions are executed via the exchaincli command-line tool, which allows direct interaction with the OKTC blockchain.


Common CLI Commands for Delegators

The exchaincli tool enables users to perform all staking-related operations. Below are essential commands every delegator should know.

Stake OKT

To begin staking, use:

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

Replace placeholders with your target validator address, amount (e.g., 100okt), and wallet key name.

Vote for a Validator

Delegation automatically counts as a vote. Use the same delegate command above to assign your stake.

Withdraw Staked OKT

To unbond part or all of your stake:

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

Note: Unbonding takes 21 days before funds are released.

Query Staking Information

Check your current staking status:

exchaincli query staking delegations [delegator-address]

View Pending Staking Rewards

See accumulated rewards before withdrawal:

exchaincli query distr rewards [delegator-address]

Withdraw Rewards from One Validator

Claim earnings from a specific validator:

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

Withdraw All Staking Rewards

To collect rewards from all validators at once:

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

👉 Access advanced staking features and optimize your yield effortlessly.


Common CLI Commands for Validators

Validators play a critical role in securing the network. They must manage their node configuration, commission rates, and reward distribution efficiently.

Before proceeding, validators should review the Validator Guide (CLI) for setup instructions including creating, editing, and destroying validator nodes.

Set Commission Rate

When creating or updating a validator, set the commission rate:

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

Example: 0.1 sets a 10% commission.

Query Commission Rate

Check your current rate:

exchaincli query staking validator [validator-address]

Check Commission Rewards

View accrued commission earnings:

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

View Outstanding Rewards

See total unredeemed rewards:

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

Withdraw Commission Rewards

Claim your commission:

exchaincli tx distr withdraw-validator-commission --from [key-name]

General Operational Commands

Use these utility commands to monitor account activity, validator stats, and module parameters.

Query Account Info

Get balance and transaction details:

exchaincli query account [address]

Check Transaction Results

Retrieve status of past transactions:

exchaincli query tx [tx-hash]

List All Validators

See active validators on the network:

exchaincli query staking validators --status=BOND_STATUS_BONDED

View Validator Details

Inspect individual validator metadata:

exchaincli query staking validator [validator-address]

Review Voting Distribution

Analyze delegation patterns across validators:

exchaincli query staking delegations-to [validator-address]

Query Staking Module Parameters

Understand network-wide staking rules:

exchaincli query staking params

Query Reward Module Parameters

Review reward distribution settings:

exchaincli query distr params

Set Reward Withdrawal Address

Redirect rewards to a different address:

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

Query Current Withdrawal Address

Verify where rewards are sent:

exchaincli query distr withdraw-addr [delegator-address]

Become a Proxy

Register as a proxy to manage delegations on behalf of others:

exchaincli tx staking create-proxy --from [key-name]

Unregister as Proxy

Remove proxy status:

exchaincli tx staking remove-proxy --from [key-name]

Bind Proxy Relationship

Link a delegator to your proxy:

exchaincli tx staking bind-proxy [delegator-address] --from [proxy-key]

Unbind Proxy Relationship

Terminate a proxy-delegator link:

exchaincli tx staking unbind-proxy [delegator-address] --from [proxy-key]

Query Delegators via Proxy

List all delegators managed by your proxy:

exchaincli query staking proxy-delegators [proxy-address]

Check Staking Pool Statistics

Monitor total bonded and not-bonded tokens:

exchaincli query staking pool

Frequently Asked Questions

Q: How long does it take to withdraw staked OKT?
A: The unbonding period on OKTC is 21 days. After initiating an unbond transaction, your tokens will be unlocked and transferable after this period.

Q: Can I change my validator after delegating?
A: Yes. You can redelegate to another validator without waiting for the unbonding period using the redelegate command.

Q: Are staking rewards compounded automatically?
A: No. Rewards must be manually withdrawn and then restaked to compound earnings.

Q: What happens if a validator misbehaves?
A: Malicious validators may be slashed, resulting in partial loss of staked OKT for both themselves and their delegators.

Q: Is there a minimum amount required to stake?
A: There is no strict minimum, but transaction fees apply to all operations. It's advisable to stake meaningful amounts to justify costs.

Q: How often are rewards distributed?
A: Rewards accumulate continuously and can be claimed at any time using the withdrawal commands.


Final Thoughts

Mastering the CLI tools for staking on OKTC empowers users to take full control of their digital assets, whether participating as delegators or validators. With transparent reward mechanisms, robust security, and flexible delegation options, OKTC offers a compelling environment for blockchain engagement.

By leveraging the commands outlined in this guide, users can optimize their participation, monitor performance in real time, and maximize returns—all through simple, secure CLI interactions.

👉 Start staking today and take control of your crypto future with confidence.


Core Keywords: staking rewards, CLI commands, OKTC blockchain, delegator guide, validator operations, earn passive income, command-line interface, blockchain security