Skip to content

Latest commit

Β 

History

History
266 lines (169 loc) Β· 9.33 KB

File metadata and controls

266 lines (169 loc) Β· 9.33 KB

Understanding Checkpoints: How Your Staking History is Tracked

What Are Checkpoints?

Think of checkpoints as automatic "snapshots" that the staking system takes every time something important happens. It's like having a detailed photo album of your staking journey, with each photo showing exactly how much you had staked at specific moments in time.

Why Should You Care?

Checkpoints are the foundation that will make the reward system incredibly fair and accurate. They ensure that:

  • You get credit for every moment your tokens are staked
  • Rewards are calculated precisely based on your actual contribution
  • No one can game the system or claim rewards they didn't earn
  • Historical data is always available for transparency

How Checkpoints Work in Simple Terms

The Automatic Camera

Imagine the staking system has an automatic camera that takes a picture every time someone stakes or unstakes tokens. Each picture captures:

  1. Who made the change (which user)
  2. What the change was (how many tokens)
  3. When it happened (exact timestamp)
  4. Total state of the entire system at that moment

Real-World Example

Let's follow Alice through her staking journey:

Day 1: Alice's First Stake

  • Action: Alice stakes 1,000 tokens with a 30-day lock
  • Checkpoint Created: πŸ“Έ Snapshot taken
    • Alice: 1,000 tokens staked
    • Total system: 50,000 tokens staked (including other users)
    • Timestamp: Day 1, 10:00 AM

Day 10: Alice Stakes More

  • Action: Alice stakes another 500 tokens
  • Checkpoint Created: πŸ“Έ Snapshot taken
    • Alice: 1,500 tokens staked (1,000 + 500)
    • Total system: 75,000 tokens staked
    • Timestamp: Day 10, 2:30 PM

Day 35: Alice Unstakes Part

  • Action: Alice unstakes her first stake (1,000 tokens)
  • Checkpoint Created: πŸ“Έ Snapshot taken
    • Alice: 500 tokens staked (remaining stake)
    • Total system: 60,000 tokens staked
    • Timestamp: Day 35, 11:15 AM

What This Means for Rewards

When the reward system launches, it can look back at these snapshots and calculate:

  • Exact Duration: How long did Alice have 1,000 tokens staked? (From Day 1 to Day 35 = 34 days)
  • Exact Duration: How long has she had 500 tokens staked? (From Day 10 onwards)
  • Her Share: What percentage of the total staking pool did she represent at any time?
  • Fair Rewards: Precisely how much she should earn based on her actual contribution

Why Checkpoints Are Better Than Alternatives

The Old Way (Manual Tracking)

  • Users had to remember when they staked
  • Systems couldn't verify historical data
  • Rewards were often approximated or unfair
  • Disputes were common and hard to resolve

The Checkpoint Way (Automatic & Precise)

  • βœ… Every change is automatically recorded
  • βœ… Historical data is mathematically verifiable
  • βœ… Rewards are calculated with precision
  • βœ… Complete transparency and accountability

What Gets Tracked in Checkpoints

Individual User Data

For each user, checkpoints track:

  • Total amount staked at any point in time
  • Individual stake details (amounts, time locks, start dates, unstake timestamps)
  • Complete staking history showing all changes over time - stake records are preserved
  • Precise duration calculations using actual unstake timestamps for reward eligibility
  • Historical preservation allowing retroactive reward calculations

Global System Data

For the entire network, checkpoints track:

  • Total tokens staked across all users
  • Network participation over time
  • System growth and adoption metrics
  • Pool distribution for reward calculations

How to Think About Your Staking Strategy

Understanding checkpoints can help you make better staking decisions:

Time Matters

  • Longer stakes = more snapshots showing your commitment
  • Consistent staking builds a strong history for rewards
  • Strategic timing can optimize your reward potential

Amount Matters

  • Larger stakes appear in more snapshots
  • Multiple stakes give you flexibility while maintaining history
  • Your share of the total pool affects your reward potential

Lock Periods Matter

  • Longer locks show stronger commitment in snapshots
  • Lock combinations can create optimal reward scenarios
  • Historical locks will be considered for bonus calculations

Practical Examples

Example 1: The Consistent Staker

Sarah's Strategy: Stakes 1,000 tokens for 6 months, never unstakes

Checkpoint History:

  • Day 1: 1,000 tokens staked
  • Day 180: Still 1,000 tokens staked

Reward Advantage: Clean, consistent history shows strong commitment

Example 2: The Growing Staker

Mike's Strategy: Starts small, adds more over time

Checkpoint History:

  • Month 1: 500 tokens staked
  • Month 2: 1,000 tokens staked (added 500)
  • Month 3: 1,500 tokens staked (added 500)

Reward Advantage: Growing commitment is visible in snapshots

Example 3: The Strategic Staker

Emma's Strategy: Multiple stakes with different time locks

Checkpoint History:

  • Day 1: 500 tokens (30-day lock)
  • Day 1: 500 tokens (90-day lock)
  • Day 31: Unstakes first, immediately restakes with 90-day lock

Reward Advantage: Maintains strong position while optimizing for lock bonuses

How to View Your Checkpoint History

Current Capabilities (Available Now)

While you can't see raw checkpoint data directly, you can verify it through:

  • Stake queries: Check your current active stakes
  • Amount queries: Verify your total staked amounts
  • Transaction history: Review all your staking transactions on the blockchain

Future Capabilities (Coming with Rewards)

When the reward system launches, you'll have access to:

  • Historical dashboard: See your complete staking timeline
  • Reward calculations: Understand exactly how your rewards are computed
  • Checkpoint viewer: Browse your snapshots and verify calculations
  • Projection tools: Estimate future rewards based on your history

Technical Benefits for Advanced Users

Gas Efficiency

  • Batch calculations: Checkpoints enable efficient reward distribution
  • Reduced queries: Historical data doesn't require expensive blockchain calls
  • Optimized storage: Smart data structure minimizes costs

Accuracy & Trust

  • Mathematically verifiable: All calculations can be independently verified
  • Immutable history: Once created, checkpoints cannot be altered
  • Transparent operations: Anyone can audit the system's calculations

Scalability

  • Efficient queries: Finding historical data is fast and cheap
  • Parallel processing: Multiple reward calculations can run simultaneously
  • Future-proof: System can handle millions of users and stakes

Common Questions

Does every small action create a checkpoint?

Yes, but this is good! It means you get credit for every change, no matter how small.

Can I see my checkpoint history?

Currently, the data exists but isn't directly viewable. When the reward system launches, you'll have full access to your history.

Do checkpoints cost me gas?

No! Checkpoint creation is built into the staking operations you're already paying for.

What if I stake and unstake frequently?

Each action creates a checkpoint, so you get credit for every period you were staked, even short ones.

Are my checkpoints private?

Checkpoint data is on the blockchain, so amounts and timestamps are public, but they're not easily browsable without specialized tools.

Can checkpoints be deleted or modified?

No! Once created, checkpoints are permanent and immutable, ensuring your staking history is always preserved.

Preparing for Rewards

What You Can Do Now

  1. Start staking to begin building your checkpoint history
  2. Consider time locks that align with your goals
  3. Track your stakes using the current viewing functions
  4. Plan your strategy based on your reward expectations

What to Expect When Rewards Launch

  1. Retroactive calculation: Your existing checkpoints will count toward rewards
  2. Full transparency: Complete visibility into how your rewards are calculated
  3. Historical verification: Ability to verify every aspect of your reward calculation
  4. Optimized claiming: Efficient reward distribution based on checkpoint data

Key Takeaways

For Your Understanding

  • βœ… Checkpoints automatically track your complete staking history
  • βœ… They enable fair and precise reward calculations
  • βœ… Every stake and unstake creates a permanent record
  • βœ… Your historical data will be used for reward calculations

For Your Strategy

  • 🎯 Consistent staking builds strong checkpoint history
  • 🎯 Longer commitments create more valuable snapshots
  • 🎯 Multiple stakes give flexibility while maintaining records
  • 🎯 Your checkpoint history directly impacts future rewards

For Your Confidence

  • πŸ”’ Your staking history is permanently and accurately recorded
  • πŸ”’ Reward calculations will be transparent and verifiable
  • πŸ”’ No one can manipulate or erase your contribution history
  • πŸ”’ The system is designed for fairness and mathematical precision

Remember: Every moment your tokens are staked, the checkpoint system is working behind the scenes to ensure you get full credit for your contribution. This foundation makes the Token staking system one of the most advanced and fair staking platforms available.