Skip to main content

Staking Commands

Manage GHOST token staking using the ghost staking command group (alias: ghost stake).
GHOST Token: Native utility token for GhostSpeak protocol. Stake for unlimited verifications, revenue share, and governance rights.

Quick Reference

CommandShorthandDescription
ghost staking stakeghost stake sStake GHOST tokens
ghost staking unstakeghost stake uUnstake tokens (14-day unbonding)
ghost staking claimghost stake cClaim staking rewards
ghost staking statusghost stake stView staking status
ghost staking rewardsghost stake rCheck pending rewards
ghost staking compound-Auto-compound rewards

ghost staking stake

Stake GHOST tokens to earn rewards and unlock benefits.

Interactive Staking

ghost staking stake
Prompts:
💰 Stake GHOST Tokens

Your Balance: 1,000 GHOST
Currently Staked: 0 GHOST

Staking Tiers:
  🥉 Bronze:   100+ GHOST   (5% APY)
  🥈 Silver:   500+ GHOST   (8% APY)
  🥇 Gold:     2,500+ GHOST (12% APY)
  💎 Platinum: 10,000+ GHOST (18% APY)

? Amount to stake: 500

✅ You will reach: Silver tier
📊 Estimated APY: 8%
💵 Annual Rewards: ~40 GHOST

Benefits:
  • Unlimited credential verifications
  • 8% APY on staked tokens
  • Priority support
  • Governance voting power: 500 votes
  • Revenue share: 0.05% of protocol fees

? Confirm stake? Yes

Staking 500 GHOST...

✅ Stake successful!

╔════════════════════════════════════════════════════════╗
║                Staking Confirmed                       ║
╠════════════════════════════════════════════════════════╣
║  Amount Staked:     500 GHOST                         ║
║  Tier:              Silver                             ║
║  APY:               8%                                 ║
║  Est. Annual:       ~40 GHOST                         ║
║  Voting Power:      500 votes                         ║
║  Unbonding Period:  14 days                           ║
║  Tx Signature:      7Nx9...kL3m                       ║
╚════════════════════════════════════════════════════════╝

Next steps:
  • Check status: ghost staking status
  • Claim rewards: ghost staking claim (available after 1 day)
  • View governance: ghost governance proposals

Command-Line Staking

ghost staking stake --amount 500

Staking Tiers

Entry TierRequirement: 100 GHOSTBenefits:
  • 5% APY
  • 10 free verifications/month
  • Governance voting (1 token = 1 vote)
  • Basic support
Example:
ghost staking stake --amount 100
Annual return: ~5 GHOST

Options

FlagTypeDescription
--amountnumberGHOST tokens to stake
--allbooleanStake all available GHOST
--auto-compoundbooleanAuto-compound rewards
--yesbooleanSkip confirmation
--agent-idstringAssociate stake with specific agent

Staking Calculation

# See rewards projection before staking
ghost staking simulate --amount 500
Output:
=== Staking Simulation ===

Amount: 500 GHOST
Tier: Silver

Rewards Projection:
  1 Month:    ~3.33 GHOST
  3 Months:   ~10 GHOST
  6 Months:   ~20 GHOST
  1 Year:     ~40 GHOST (8% APY)
  3 Years:    ~129 GHOST (compound 8% APY)

Revenue Share (estimated):
  Monthly:    ~0.25 GHOST (0.05% of fees)
  Annual:     ~3 GHOST

Total 1-Year: ~43 GHOST

ghost staking unstake

Unstake tokens to return them to your wallet (14-day unbonding period).
Unbonding Period: Unstaked tokens take 14 days to become available. No rewards during unbonding.

Interactive Unstaking

ghost staking unstake
Prompts:
⏸️  Unstake GHOST Tokens

Currently Staked: 500 GHOST (Silver tier)
Pending Rewards: 3.42 GHOST

⚠️  Warning: Unstaking triggers 14-day unbonding period.
During unbonding:
  • No staking rewards earned
  • No staking benefits (verifications, voting, revenue share)
  • Tier benefits lost immediately

? Amount to unstake: 200

? Claim pending rewards first? Yes

Claiming 3.42 GHOST rewards...
✅ Rewards claimed!

Unstaking 200 GHOST...

✅ Unstake initiated!

╔════════════════════════════════════════════════════════╗
║              Unstaking Initiated                       ║
╠════════════════════════════════════════════════════════╣
║  Amount Unstaking:  200 GHOST                         ║
║  Remaining Staked:  300 GHOST                         ║
║  New Tier:          Bronze (was Silver)               ║
║  Available On:      Jan 14, 2026 (14 days)           ║
║  Tx Signature:      8Qx4...pM2n                       ║
╚════════════════════════════════════════════════════════╝

💡 Tip: Cancel unstaking anytime with:
   ghost staking cancel-unstake

Command-Line Unstaking

ghost staking unstake --amount 200

Cancel Unstaking

Changed your mind during unbonding period?
ghost staking cancel-unstake
Output:
✅ Unstaking cancelled!

200 GHOST returned to staked balance
Tier restored: Silver
Benefits restored

View Unbonding Status

ghost staking status --unbonding
Output:
=== Unbonding Tokens ===

Amount:        200 GHOST
Started:       Dec 31, 2025
Available:     Jan 14, 2026
Days Remaining: 14

Progress: [░░░░░░░░░░░░░░] 0% (14 days left)

ghost staking claim

Claim accumulated staking rewards.

Claim Rewards

ghost staking claim
Output:
💰 Claim Staking Rewards

Pending Rewards: 3.42 GHOST
Last Claimed: Dec 24, 2025 (7 days ago)

Claiming 3.42 GHOST...

✅ Rewards claimed successfully!

╔════════════════════════════════════════════════════════╗
║              Rewards Claimed                           ║
╠════════════════════════════════════════════════════════╣
║  Amount:         3.42 GHOST                           ║
║  Period:         Dec 24 - Dec 31 (7 days)            ║
║  Daily Rate:     ~0.49 GHOST/day                     ║
║  Annual Rate:    ~178 GHOST (8% APY)                 ║
║  New Balance:    1,003.42 GHOST                      ║
║  Tx Signature:   9Rx5...nL4m                         ║
╚════════════════════════════════════════════════════════╝

💡 Tip: Enable auto-compound to maximize returns:
   ghost staking compound --enable

Auto-Claim

Set up automatic claiming at intervals:
ghost staking claim --auto --interval 7d
Output:
✅ Auto-claim enabled!

Frequency: Every 7 days
Next Claim: Jan 7, 2026

Claim with Compound

Automatically restake rewards:
ghost staking claim --compound
Output:
✅ Claimed and compounded!

Rewards: 3.42 GHOST
Action: Added to staked balance
New Stake: 503.42 GHOST

ghost staking status

View comprehensive staking information.

Full Status

ghost staking status
Output:
╔════════════════════════════════════════════════════════════════════════╗
║                       Staking Status                                   ║
╠════════════════════════════════════════════════════════════════════════╣

Current Stake:
  Amount:           500 GHOST
  Tier:             Silver
  APY:              8%
  Staked Since:     Nov 15, 2025 (46 days)

Rewards:
  Pending:          3.42 GHOST
  Lifetime Earned:  24.68 GHOST
  Last Claimed:     Dec 24, 2025
  Next Claim:       Available now

Benefits:
  ✅ Unlimited verifications
  ✅ Governance voting (500 votes)
  ✅ Priority support
  ✅ Revenue share (0.05%)
  ✅ 8% APY

Performance:
  Daily Rewards:    ~0.11 GHOST/day
  Monthly:          ~3.33 GHOST/month
  Projected Annual: ~40 GHOST

Unbonding:
  In Progress:      None
  Available:        -

Next Tier: Gold (2,500 GHOST)
  Progress: [███░░░░░░░░░░░░] 20%
  Need: +2,000 GHOST

╚════════════════════════════════════════════════════════════════════════╝

Compact Status

ghost staking status --compact
Output:
Staked: 500 GHOST (Silver) | 8% APY | Pending: 3.42 GHOST | Voting: 500

JSON Output

ghost staking status --json
{
  "stakedAmount": 500,
  "tier": "Silver",
  "apy": 8,
  "stakedSince": "2025-11-15T10:30:45Z",
  "pendingRewards": 3.42,
  "lifetimeEarned": 24.68,
  "lastClaimed": "2025-12-24T14:20:10Z",
  "votingPower": 500,
  "unbondingAmount": 0,
  "unbondingAvailableAt": null,
  "dailyRewards": 0.11,
  "monthlyRewards": 3.33,
  "projectedAnnualRewards": 40
}

ghost staking rewards

Check detailed rewards information.

Rewards Summary

ghost staking rewards
Output:
=== 💰 Staking Rewards ===

Pending Rewards: 3.42 GHOST

Breakdown:
  Base Staking:     3.20 GHOST (8% APY on 500)
  Revenue Share:    0.22 GHOST (0.05% of fees)

Rewards History (Last 30 Days):
  Dec 2025:         12.45 GHOST
  Nov 2025:         10.23 GHOST
  Total Claimed:    22.68 GHOST

Lifetime Statistics:
  Total Earned:     26.10 GHOST (pending + claimed)
  Effective APY:    8.12% (including revenue share)
  Avg Daily:        ~0.57 GHOST

Revenue Share Details:
  Your Share:       0.05% of protocol fees
  This Month:       0.22 GHOST
  Last Month:       0.18 GHOST
  Protocol Volume:  $125,000 (Dec 2025)

Rewards History

ghost staking rewards --history
Output:
╔═══════════════════════════════════════════════════════╗
║            Rewards Claim History                      ║
╠═══════════════════════════════════════════════════════╣
║ Date         Amount      Type          Tx (short)    ║
╟───────────────────────────────────────────────────────╢
║ Dec 24, 2025 3.42 GHOST  Claimed       9Rx5...nL4m   ║
║ Dec 17, 2025 3.38 GHOST  Claimed       8Qx3...mK2p   ║
║ Dec 10, 2025 3.35 GHOST  Claimed       7Px2...lJ9n   ║
║ Dec 03, 2025 3.32 GHOST  Auto-Compound 6Ox1...kI8m   ║
║ ...                                                   ║
╚═══════════════════════════════════════════════════════╝

Projected Rewards

ghost staking rewards --projection
Output:
=== 📊 Rewards Projection ===

Based on current stake: 500 GHOST @ 8% APY

Future Rewards (with auto-compound):
  1 Month:    3.33 GHOST  (Total: 503.33)
  3 Months:   10.13 GHOST (Total: 510.13)
  6 Months:   20.53 GHOST (Total: 520.53)
  1 Year:     41.60 GHOST (Total: 541.60)
  2 Years:    87.03 GHOST (Total: 587.03)
  5 Years:    248.59 GHOST (Total: 748.59)

With Revenue Share (estimated):
  1 Year Total: ~45 GHOST (41.60 staking + 3.40 revenue)
  5 Year Total: ~280 GHOST (248.59 staking + 31.41 revenue)

💡 Tip: Actual returns depend on protocol fee volume

ghost staking compound

Enable or manage auto-compounding of rewards.

Enable Auto-Compound

ghost staking compound --enable
Output:
✅ Auto-compound enabled!

Settings:
  Frequency: Daily
  Minimum:   1 GHOST (accumulate before compounding)

How it works:
  • Daily check for pending rewards ≥1 GHOST
  • Automatically restake rewards
  • Increases your staked balance
  • Maximizes compound interest

Example:
  Without: 500 GHOST → 540 GHOST (1 year @ 8%)
  With:    500 GHOST → 542 GHOST (1 year @ 8.32% effective)

Next compound: Tomorrow at 00:00 UTC

Configure Compound Settings

ghost staking compound \
  --enable \
  --frequency daily \
  --minimum 1

Disable Auto-Compound

ghost staking compound --disable

View Compound Status

ghost staking compound --status
Output:
Auto-Compound: Enabled ✅

Configuration:
  Frequency:      Daily
  Minimum:        1 GHOST
  Last Compound:  Dec 30, 2025 (1.2 GHOST)
  Next Compound:  Dec 31, 2025 (expected: 0.11 GHOST)

Historical Impact:
  Total Compounded:    12.45 GHOST
  Extra Earnings:      0.42 GHOST (vs. manual claiming)
  Effective APY Boost: +0.32% (8% → 8.32%)

Governance Benefits

Staked GHOST grants governance voting power.

View Voting Power

ghost staking status --voting
Output:
Governance Voting Power: 500 votes

Based on:
  Staked Amount: 500 GHOST (1 token = 1 vote)

Participation:
  Total Proposals: 12
  Voted On:        8 (66.7%)
  Voting Weight:   0.05% of total

Active Proposals: 3
  → View: ghost governance proposals

Vote on Proposals

ghost governance vote --proposal 5 --choice for
See Governance Documentation for full voting details.

Troubleshooting

You need GHOST tokens to stake.On Devnet:
ghost airdrop --amount 1000
On Mainnet:
  1. Buy GHOST on exchange (Raydium, Orca, etc.)
  2. Transfer to your CLI wallet
  3. Verify balance: ghost wallet balance
Common causes:
  • Insufficient SOL for transaction fees
  • Amount below minimum tier (100 GHOST)
  • Network congestion
Fix:
# Check SOL balance
ghost wallet balance

# Get SOL (devnet)
ghost faucet

# Retry with lower amount
ghost staking stake --amount 100
Rewards accrue daily starting 24 hours after staking.Check:
# View staking start time
ghost staking status

# If >24 hours, force refresh
ghost staking rewards --refresh
If still 0 after 48 hours:
ghost config diagnose
You can’t unstake more than your staked amount minus pending unbonding.Check status:
ghost staking status

# View unbonding
ghost staking status --unbonding
Example:
  • Staked: 500 GHOST
  • Unbonding: 200 GHOST
  • Available to unstake: 300 GHOST
Expected: Tier benefits are immediately lost when stake drops below threshold.Example:
  • Had 500 GHOST (Silver tier)
  • Unstaked 250 GHOST
  • Now 250 GHOST (Bronze tier)
  • Silver benefits (unlimited verifications, 8% APY) → Lost
To restore:
# Cancel unstaking if within 14 days
ghost staking cancel-unstake

# Or stake more
ghost staking stake --amount 250
Revenue share depends on protocol fee volume.Low Volume (Devnet/Early Mainnet):
  • Few transactions = low fees = low revenue share
  • Revenue share may be <0.01 GHOST initially
Check volume:
ghost staking rewards --revenue-details
Revenue share grows with:
  • More agents using protocol
  • Higher transaction volume
  • More x402 marketplace activity

Staking Economics

Staking rewards are funded by:
  1. Inflation (70%):
    • 3% annual token inflation
    • Distributed to stakers proportionally
    • Decreases over time (halving every 4 years)
  2. Protocol Fees (30%):
    • Transaction fees (1-2% per transaction)
    • x402 marketplace fees (2.5%)
    • Credential issuance fees
    • 30% of fees go to stakers as revenue share
Example (Mainnet, Year 1):
  • Total Staked: 10M GHOST
  • Your Stake: 500 GHOST (0.005%)
  • Annual Inflation: 300K GHOST
  • Your Share: 15 GHOST (0.005% × 300K)
  • Protocol Fees: $500K
  • Revenue Pool: $150K (30%)
  • Your Share: $75 ≈ 25 GHOST
Total Rewards: 15 + 25 = 40 GHOST (8% APY)

Equivalent SDK Method

ghost staking stake --amount 500
ghost staking claim

Next Steps

Maximize Returns: Stake 500+ GHOST with auto-compound enabled for best APY and compounding benefits.