> ## Documentation Index
> Fetch the complete documentation index at: https://blank.build/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Staking

> How staking works on Blank, including lock periods, weighted rewards, creator-configurable staking share, and protocol rules.

# Staking

<Info>
  Staking lets holders lock tokens and earn SOL rewards from real trading fees.
  Staking is available when the token creator enables it, either during launch
  or later.
</Info>

<Card title="Project staking rewards" icon="calculator" href="/docs/start-here/fee-calculator">
  Use the Fee Calculator to estimate staking rewards from a target market cap,
  volume assumption, and staking allocation.
</Card>

## How it works

<Steps>
  <Step title="Creator enables staking">
    The creator chooses a staking share from 1% to 100% of creator fee revenue
    while stake is active. The default is 20%. This share uses the same
    creator-side allocation budget as Auto Buyback and Burn, Liquidity
    Compounding, and Price Prediction.
  </Step>

  <Step title="Holders choose a lock period">
    Token holders stake with a lock period from 7 to 180 days. They can also
    fund a gift stake where another wallet becomes the stake owner.
  </Step>

  <Step title="Fees route through Blank">
    Trading fees flow through Blank fee-splitter. When stake is active, the
    staking share goes into the rewards pool.
  </Step>

  <Step title="Rewards split by weighted stake">
    Rewards are distributed to stakers by weighted stake: amount times
    lock-period multiplier.
  </Step>
</Steps>

If nobody is staking, the staking share routes to the creator for that period. It does not accumulate for a future staker.

## Lock periods

| Lock period | Duration | Multiplier |
| ----------- | -------: | ---------: |
| Week        |   7 days |       1.0x |
| Month       |  30 days |      1.25x |
| Quarter     |  90 days |      1.75x |
| Half year   | 180 days |       2.5x |

Multipliers change weighted stake, not the total reward pool.

```
Share = (tokens x multiplier) / total weighted stake
```

Example: 1,000 tokens staked for 90 days at 1.75x equals 1,750 weighted stake. A half-year staker earns 2.5x the share of a week staker with the same token amount.

## Fee distribution examples

| Scenario           | Platform | Creator | Stakers |
| ------------------ | -------: | ------: | ------: |
| No staking         |      25% |     75% |       - |
| 20% staking share  |      25% |     60% |     15% |
| 50% staking share  |      25% |   37.5% |   37.5% |
| 100% staking share |      25% |      0% |     75% |

These percentages describe the Blank-controlled fee after any upstream protocol fee.

## Fair reward rules

* Rewards are time-earned. New positions only earn from fees generated after they are active.
* Gift stakes are recipient-owned: the funding wallet supplies the tokens, while the recipient wallet claims rewards and unstakes after unlock.
* If nobody is staking, rewards do not wait for the next staker.
* Rewards can be claimed before token unlock once they cross the claim threshold.
* The lock applies to staked tokens, not to SOL rewards already earned.
* APR is an estimate based on recent trading volume, token price, and total staked.

## Example

Alice stakes 100 tokens. Ten hours later, Bob stakes 150 tokens.

If 1 SOL of staking rewards was earned before Bob joined, Alice gets that full 1 SOL because she was the only active staker during that period. Rewards earned after both are staking split by stake size and lock multiplier. With equal multipliers and 100 tokens versus 150 tokens, Alice gets 40% and Bob gets 60%.

<Check>
  If Alice waits a few days before claiming, she does not lose her share. Her
  rewards keep accumulating for her position until she decides to claim them.
</Check>

## Protocol rules

* A user can have multiple stake positions per token.
* A funded recipient owns the gift stake principal and rewards; the funding wallet cannot claw it back through staking.
* Each position has its own lock period.
* Tokens are locked for the full chosen period, then can be fully or partially unstaked.
* The creator can increase staking share but cannot decrease it.
* Staking, buyback, liquidity-compounding, and Price Prediction shares cannot exceed 100% of the creator-side fee allocation combined.
* Rewards are real yield from trading fees, not inflationary token emissions.
* Staking rewards progress through staking claim wrappers; stakers do not need to wait for creator fee claims.
* Minimum stake and unstake amount is 1 token.
* Production staking rewards must reach 0.01 SOL before claim.