ChainPortalChainPortal Docs
Features
Features

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

1

Create a Staking Pool

Set up the pool with a reward token and reward rate (APY). Fund it with reward tokens.

2

Users Stake Tokens

Token holders deposit their tokens into the pool and start accumulating rewards immediately.

3

Rewards Accrue

Rewards are distributed continuously based on each staker's share of the pool and the configured reward rate.

4

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

1

Navigate to Staking

Go to Staking > Create Pool from the sidebar.

2

Select stake token

Choose which token users will stake.

3

Select reward token

Choose which token to distribute as rewards (can be the same token).

4

Set reward rate

Configure the reward distribution rate (tokens per second/block).

5

Fund the pool

Deposit reward tokens into the pool to fund distributions.

6

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.

ActionEVMSolanaSUIAptosNEARCosmos
Emergency withdraw forfeits rewards to creatorYesYesYesYesYesYes
Forfeit-only exit with nothing stakedNo (not needed)YesYesYesYesYes
Withdraw forfeited rewards at any timeYesNo (after end)YesYesNo (after end)No (after end)
Close pool after end, nothing stakedYesYesYesYesYesYes
Force-close idle stake after end + 180 daysNot applicableYesYesYesYesYes

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

OptionRule
Lock periodAfter 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 stakeA stake that would leave your position below this amount is refused. A partial unstake may go below it
Maximum stakeYour position can never go above this amount, also after compounding
Pool durationAt 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.

On this page