Staking Pools
Create staking pools with reward distribution for your token holders.
Overview
ChainPortal lets you create staking pools where token holders can stake their tokens to earn rewards. This incentivizes holding and reduces selling pressure.
How Staking Works
Create a Staking Pool
Set up the pool with a reward token and reward rate (APY). Fund it with reward tokens.
Users Stake Tokens
Token holders deposit their tokens into the pool and start accumulating rewards immediately.
Rewards Accrue
Rewards are distributed continuously based on each staker's share of the pool and the configured reward rate.
Claim and Unstake
Users can claim rewards at any time and unstake whenever the pool has no lock period (or once their lock has ended).
Creating a Staking Pool
Navigate to Staking
Go to Staking > Create Pool from the sidebar.
Select stake token
Choose which token users will stake.
Select reward token
Choose which token to distribute as rewards (can be the same token).
Set reward rate
Configure the reward distribution rate (tokens per second/block).
Fund the pool
Deposit reward tokens into the pool to fund distributions.
Deploy
Create the staking pool contract.
Pool Management
After creation, you can:
- Add rewards -- Deposit more reward tokens. On the new contracts this is a top-up that extends the pool's end time (see below)
- View stakers -- See who is staking and how much
- Check statistics -- Total staked, total rewards distributed, APY
Emergency Withdraw, Forfeited Rewards and Closing a Pool
These rules apply to staking pools on contracts deployed from the current ("Wave 1") build, on every supported chain. Pools on older deployments may behave differently, and the app only shows an action when the pool's contract supports it. On SUI and Aptos the actions appear under Emergency withdraw and pool management once you enter a pool ID.
- Emergency withdraw (stakers): returns all your staked tokens at any time. Every unclaimed reward you have in that pool is forfeited to the pool creator, including rewards accrued since your last action. This cannot be undone. Forfeited rewards do not go to the other stakers. On every chain except EVM it also works with nothing staked, if you want to leave unclaimed rewards behind and remove your stake record (on EVM a position with nothing staked has no rewards to forfeit).
- Recovering forfeited rewards (creator): on EVM, SUI and Aptos the creator can use Withdraw forfeited rewards at any time (on EVM only the part not needed to back rewards still owed to stakers). On Solana, NEAR and Cosmos, forfeited rewards become unallocated rewards: the creator recovers them after the pool ends with the unallocated (unused) rewards withdrawal, or when closing the pool.
- Close pool (creator): possible only after the pool ends and once no staked tokens are left (on chains with per-staker records, no stake records either). Every remaining reward token goes back to the creator. A closed SUI pool object is deleted, a closed NEAR pool is removed and a closed Solana pool's accounts are closed (rent back to the creator); on EVM, Aptos and Cosmos the pool is marked closed and rejects further actions.
- Force-close a stake record (creator): from 180 days after the pool ends, the creator can close a staker's record that holds no staked tokens, so one inactive staker cannot keep the pool open forever. That record's unclaimed rewards are forfeited to the creator. Available on Solana, SUI, Aptos, NEAR and Cosmos; not needed on EVM, where a position with nothing staked never holds rewards. On Solana the record's rent goes back to the staker who paid it.
Staked tokens (principal) can never be moved by anyone but the staker.
| Action | EVM | Solana | SUI | Aptos | NEAR | Cosmos |
|---|---|---|---|---|---|---|
| Emergency withdraw forfeits rewards to creator | Yes | Yes | Yes | Yes | Yes | Yes |
| Forfeit-only exit with nothing staked | No (not needed) | Yes | Yes | Yes | Yes | Yes |
| Withdraw forfeited rewards at any time | Yes | No (after end) | Yes | Yes | No (after end) | No (after end) |
| Close pool after end, nothing staked | Yes | Yes | Yes | Yes | Yes | Yes |
| Force-close idle stake after end + 180 days | Not applicable | Yes | Yes | Yes | Yes | Yes |
Pool Options, Top-Up and Compound (new contracts)
Shown only after the new staking contract is deployed on that chain. The options below appear only when the app has confirmed the chain's staking contract is the new build. Pools on an older contract keep working exactly as before. On EVM, lock period and minimum / maximum stake were already available.
Options when creating a pool
| Option | Rule |
|---|---|
| Lock period | After each stake (and each compound) your tokens are locked for this long. It can be at most the pool's duration. Emergency withdraw ignores the lock |
| Minimum stake | A stake that would leave your position below this amount is refused. A partial unstake may go below it |
| Maximum stake | Your position can never go above this amount, also after compounding |
| Pool duration | At most 10 years from start to end |
While your stake is locked, the pool card shows when it unlocks and the unstake button is disabled.
Top-up (extends the pool)
Anyone can add reward tokens to a running pool, not only its creator. The reward rate does not change. Instead the pool runs longer:
- added time = top-up amount ÷ reward rate (rounded down)
- the leftover that does not buy a whole time unit (a second; a millisecond on SUI, a nanosecond on NEAR) is unallocated surplus, which the creator can reclaim after the pool ends
Before you sign, the app shows the new end time, the time added and any surplus. It refuses a top-up the contract would reject: an ended or closed pool, an amount too small to add any time, or an end time that would go past the 10-year limit. Tokens sent as a top-up cannot be taken back by the sender.
On Solana, if the pool was not fully funded for its current end time, a top-up first covers that shortfall and only extends the end time with what is left. The preview takes this into account.
Compound
If the pool's stake token and reward token are the same, Compound adds your earned rewards to your stake without withdrawing them. Compounding restarts the lock period and must stay within the maximum stake.
Supported Ecosystems
All 6 ecosystems support staking pools with the same core functionality.
Fund the pool before announcing it. If the reward pool is empty, stakers earn nothing and will unstake immediately. Deposit enough reward tokens to cover at least several weeks of distribution before making the pool public.
Related
- Create a token — Create the token to stake
- Referral program — Earn from referrals too