Staking Rewards Manual (CLI)

Staking is a powerful way to earn passive income in the blockchain ecosystem, and with OKTC’s robust infrastructure, users can seamlessly participate using the command-line interface (CLI). This guide walks you through everything you need to know about earning staking rewards as either a delegator or validator on the OKTC network. Whether you're new to staking or an experienced validator, this manual provides clear, actionable steps to help you maximize your returns.

OKTC operates on a Byzantine Fault Tolerant Delegated Proof-of-Stake (BFT-DPoS) consensus mechanism powered by Tendermint. This allows users to stake OKT tokens, gain voting power, and delegate their stake to trusted validators in exchange for rewards. All operations can be performed efficiently via the CLI tool exchaincli, giving users full control over their participation.

What Is Staking?

Staking involves locking up OKT tokens to support network security and governance. By staking, users gain voting rights proportional to their stake and can choose to delegate those rights to validator nodes. In return, they earn a share of the block rewards—distributed as staking dividends—based on the validator’s performance and commission rate.

Validators play a crucial role in maintaining network integrity by proposing and validating blocks. Delegators contribute to this process by supporting validators with their staked tokens, thereby increasing the validator’s influence and earning rewards passively.

👉 Discover how to start earning rewards through secure staking today.

How Ordinary Users Can Stake

For regular users, participating in staking is straightforward:

1. Stake OKT to acquire voting power.
2. Delegate your stake to one or more validators.
3. Earn rewards based on the validator’s uptime, performance, and commission structure.

The amount of reward depends on your voting weight, which is calculated based on the size and duration of your stake. For technical details, refer to the Voting Weight Calculation documentation.

Key Actions for Delegators

Delegators can perform several core functions via the CLI:

• Stake OKT: Commit tokens to the network.
• Vote: Delegate stakes to chosen validators.
• Withdraw Stake: Unbond tokens when exiting staking.
• Query Staking Info: Check current delegation status.
• Check Rewards: View accumulated staking dividends.
• Withdraw Rewards: Claim earnings from individual or all validators.

Each command supports -h or --help for real-time assistance, ensuring users can navigate without confusion.

Common CLI Commands for Delegators

Below are essential commands every delegator should know:

Stake OKT

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

Vote for a Validator

Same as staking—delegation equals voting.

Withdraw Staked OKT

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

Query Staking Information

exchaincli query staking delegation [delegator-address] [validator-address]

Check Accumulated Rewards

exchaincli query distr rewards [delegator-address]

Withdraw Rewards from One Validator

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

Withdraw All Staking Rewards

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

These tools give delegators full transparency and control over their assets and earnings.

Validator Operations Overview

Validators have additional responsibilities and privileges, including setting commission rates and withdrawing earned fees. They must run reliable nodes and maintain high uptime to avoid penalties.

Before diving into validator-specific commands, it's recommended to review the full Validator Guide (CLI).

Core Validator Management Commands

• create-validator: Initialize a new validator node.
• edit-validator: Update validator metadata (e.g., name, website).
• edit-validator-commission-rate: Adjust the commission percentage taken from delegator rewards.
• destroy-validator: Decommission a validator (use with caution).

Validators also handle financial operations related to rewards:

Set Commission Rate

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

Query Commission Rate

exchaincli query staking validator [validator-address]

Check Commission Earnings

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

Withdraw Commission Rewards

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

Maintaining accurate records and timely withdrawals ensures optimal revenue flow.

General CLI Utility Commands

The exchaincli tool offers comprehensive querying capabilities across multiple modules. Use these commands to monitor your position and network activity.

Account & Balance Inquiry

exchaincli query account [address]

Transaction Status Check

exchaincli query tx [tx-hash]

Validator Discovery

exchaincli query staking validators

Lists all active validators.

Detailed Validator Info

exchaincli query staking validator [validator-address]

View Voting Distribution

exchaincli query staking delegations-to [validator-address]

Module Parameter Checks

exchaincli query staking params        # Staking rules
exchaincli query distr params          # Reward distribution settings

Manage Reward Withdrawal Address

You can redirect rewards to a different address:

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

And verify it with:

exchaincli query distr withdraw-addr [delegator-address]

Proxy Functionality

Users can act as proxies to manage delegations for others:

• Register as Proxy: tx proxy register
• Unregister: tx proxy unregister
• Bind Delegator: tx proxy bind
• Unbind: tx proxy unbind
• Query Delegators: query proxy delegators [proxy-address]

This feature enables institutional or managed staking services.

👉 Learn how advanced staking tools can boost your yield strategy.

Frequently Asked Questions (FAQ)

Q: Can I lose money while staking?
A: Yes, if a validator misbehaves (e.g., double-signing), both the validator and its delegators may face slashing penalties. Choose reliable validators with strong track records.

Q: How often are staking rewards distributed?
A: Rewards accrue continuously and can be withdrawn at any time via CLI commands. There’s no fixed payout schedule—users claim rewards manually.

Q: Is there a lock-up period for staked OKT?
A: Yes, unbonding takes approximately 21 days. During this time, tokens are illiquid and do not earn rewards.

Q: Can I change my validator after delegating?
A: You cannot redelegate immediately. Use the begin-redelegate command to switch, but note that each redelegation resets the unbonding period for that portion.

Q: What happens if I don’t withdraw my rewards?
A: Undistributed rewards remain accrued on-chain and continue to count toward your balance—they don’t expire or generate compound interest automatically.

Q: Are staking rewards taxable?
A: Tax treatment varies by jurisdiction. In many regions, staking rewards are considered income at the time of receipt. Consult a tax professional for personalized advice.

👉 Maximize your crypto earnings with secure, high-yield staking options.

Core Keywords

• Staking rewards
• CLI staking
• OKT staking
• Delegator guide
• Validator commands
• Earn passive income crypto
• Blockchain staking tutorial
• exchaincli commands

By mastering these CLI tools and understanding the mechanics behind OKTC’s staking system, both individuals and operators can confidently engage with the network, contribute to its security, and earn consistent returns. Whether you're delegating your first OKT or running a full validator node, this guide equips you with the knowledge needed for success.