💎Staking

Our Staking tool allows you to create a rewards pool for your token, enabling your community to earn passive income by locking up their tokens. This can help increase token utility, reward long-term holders, and promote network stability.

This guide is divided into two parts:

  • For Project Creators: How to set up and manage your staking pool.

  • For Token Holders: How to stake tokens and claim rewards.

For Project Creators (Admin Guide)

Part 1: Setting Up Your Staking Pool

A staking pool is automatically created for your project when you allocate tokens to "Staking Rewards" during the Vesting Configuration step.

Step 1: Create Your Project

If you haven't already, you must first create your project and token.

➡️ Follow the Project Creation Guide to get started.

Step 2: Configure Vesting & Allocate Rewards

After creating your project, you'll be prompted to configure vesting. This is where you activate your staking pool.

  1. From your project dashboard, click Setup Vesting.

  2. In the Special Allocations section, enter a percentage of your total supply into the Staking Rewards (%) field. This amount will become the total rewards distributed from the staking pool.

  3. Set the Staking Pool Duration. This determines the period over which the rewards will be distributed. The interface will automatically calculate the daily rewards based on your inputs.

Note: A message will appear confirming that a staking pool will be automatically created with your specified allocation.

Special Allocations section with Staking Rewards configuration
  1. Complete the rest of the vesting schedule setup as needed and click Configure Vesting, then confirm the transaction in your wallet.

  2. Once the transaction is confirmed, the staking pool is live and active. You will see the "Staking" card on your project dashboard is now active.

Part 2: Managing Your Staking Pool

After setup, you can manage your pool, add more rewards, and pause the contract if needed.

Step 1: Access the Staking Management Panel

  1. From the project dashboard, locate the Staking card.

  2. Click the three-dot menu icon (⋮) on the card and select Manage.

Staking card with Manage option

Step 2: Understanding the Admin Dashboard

The management panel gives you a complete overview of your pool:

  • Pool Statistics: Shows the real-time APY, total tokens staked by users, and daily reward distribution.

  • Admin Overview: Displays your current rewards balance in the pool and the operational status (e.g., Active, Paused).

  • Pool Controls: Allows you to pause and unpause staking and unstaking functions.

  • Add Reward Tokens: A dedicated section to deposit more tokens into the rewards pool.

Manage Staking Pool admin panel

Step 3: Adding More Reward Tokens

You can increase the rewards in the pool at any time. This extends the duration of the rewards or increases the APY.

  1. In the Add Reward Tokens section, enter the amount of tokens you wish to add.

  2. The interface will show an Impact Preview, calculating the new total rewards and how many days of rewards you are adding.

  3. Click Add Reward Tokens and confirm the transaction in your wallet.

Add Reward Tokens section with Impact Preview

Step 4: Pausing & Unpausing the Pool

The pause function is a security feature that allows you to temporarily halt all staking and unstaking activity.

  • To Pause: Click the Pause Pool button and confirm the transaction. This is useful during emergencies or contract maintenance.

  • To Unpause: When the pool is paused, the button will change to Unpause Pool. Click it and confirm the transaction to resume normal activity.

Pause Pool confirmation dialog

For Token Holders (User Guide)

Step 1: Staking Your Tokens

  1. Navigate to the public staking page for the token.

  2. In the Stake Tokens card, enter the amount you wish to stake. Your available token balance is displayed.

  3. The interface will show your Estimated Daily Rewards based on the amount you enter.

  4. Click Stake Tokens and confirm the transaction in your wallet.

User staking interface and wallet confirmation

Step 2: Viewing Your Staked Position

Once your transaction is successful, your view will update to show:

  • My Position: This card displays your total staked tokens, any pending rewards you've earned, and the lock status of your stake.

  • Unstake Locked: A timer shows when your tokens will be unlocked and available for withdrawal. Tokens are locked for 30 days after staking to ensure pool stability.

User dashboard showing My Position and Unstake Locked timer

Step 3: Unstaking Your Tokens

Once the 30-day timelock has passed, you can withdraw your tokens.

  1. In the Unstake Tokens card, enter the amount you wish to withdraw.

  2. Click Unstake Tokens and confirm the transaction.

  3. Your original staked tokens, plus any earned rewards, will be sent to your wallet.

Best Practices

For Project Creators

Pool Configuration

  • Adequate Rewards: Ensure you allocate sufficient tokens to maintain attractive APY rates for stakers.

  • Duration Planning: Choose a pool duration that aligns with your project's roadmap and tokenomics.

  • Monitor APY: Regularly check the APY and add rewards if it drops below competitive rates.

Security

  • Pause Function: Use the pause function only when necessary (security issues, contract maintenance).

  • Transparent Communication: Always inform your community before pausing the pool.

  • Regular Monitoring: Check pool statistics regularly to ensure healthy operation.

For Token Holders

Staking Strategy

  • Long-term Commitment: Remember the 30-day lock period when planning your staking strategy.

  • APY Comparison: Compare APY rates across different pools before committing.

  • Reward Timing: Consider the daily reward rate and total duration when deciding how much to stake.

Security

  • Verify Contracts: Always verify you're interacting with the official staking contract.

  • Wallet Security: Use secure wallets and never share your private keys.

  • Transaction Review: Carefully review all transaction details before confirming.

Troubleshooting

Common Issues

For Project Creators

Pool APY Too Low

  • Add more reward tokens to increase the APY

  • Consider extending the pool duration

  • Review total staked amount vs. rewards balance

Cannot Pause Pool

  • Ensure you're connected with the project owner wallet

  • Check that you have sufficient HTR for transaction fees

  • Verify the pool is not already paused

For Token Holders

Cannot Stake Tokens

  • Verify you have sufficient token balance

  • Ensure you have HTR for transaction fees

  • Check that the pool is not paused

  • Confirm you've approved the staking contract to spend your tokens

Unstake Button Disabled

  • Check if the 30-day lock period has ended

  • Verify you have tokens staked in the pool

  • Ensure the pool is not paused

Rewards Not Showing

  • Wait for at least one day after staking for rewards to accumulate

  • Refresh the page to update the display

  • Check that the pool still has reward tokens available

Getting Help

If you encounter issues:

  1. Contact support at [email protected]

Security Considerations

Smart Contract Security

  • All staking contracts are audited before deployment

  • Contracts include emergency pause functionality

  • Rewards distribution is handled automatically on-chain

Risk Factors

For Project Creators

  • Reward Depletion: Monitor reward balance to prevent pool depletion

  • Economic Security: Ensure sufficient rewards to maintain staker interest

  • Operational Security: Maintain secure access to admin functions

For Token Holders

  • Lock Period: Tokens are locked for 30 days after staking

  • Smart Contract Risk: Understand the risks associated with smart contracts

  • Market Risk: Token prices may fluctuate during the staking period


Next Steps

For Project Creators

After setting up your staking pool:

  1. Announce to Community: Let your community know about the staking opportunity

  2. Monitor Performance: Regularly check pool statistics and APY

  3. Plan Rewards: Consider when to add more rewards based on pool performance

  4. Gather Feedback: Listen to staker feedback and adjust parameters if needed

For Token Holders

After staking your tokens:

  1. Track Rewards: Monitor your daily rewards accumulation

  2. Plan Exit Strategy: Remember the 30-day unlock period when planning withdrawals

  3. Stay Informed: Follow project updates for any changes to the staking pool

  4. Consider Compounding: Evaluate if restaking rewards makes sense for your strategy

For more information about token vesting and distribution, see our Vesting Configuration Guide.

Last updated

Was this helpful?