Kingdomly Docs
  • The Kingdomly Realm
  • 🛠️Creator
    • Getting started with NFT Creator
  • 🛠️Creator Admin
    • Facilitate your mint with our Creator Admin
      • Overview Page
      • Mint Groups
      • Airdrops
      • Customize Mint Page
  • 🍃MINT
    • Getting Started with Kingdomly Mint
    • Step-by-Step Guide
      • Step 1: Select Collection
      • Step 2: Exploring the Mint Page
      • Step 3: Mint!
    • Developers
  • 🏪MARKETPLACE
    • Getting started with Marketplace
  • BRIDGE
    • Getting started with Kingdomly Bridge
  • STAKING
    • Getting started with NFT Staking
    • Create your NFT staking pool
      • Troubleshooting
    • NFT Staking lifecycle
    • Manage your NFT staking pool
Powered by GitBook
On this page
  • 1. Create Your Pool
  • 2. Set Up Staking Mechanics
  • 3. Publish the Pool
  • 4. (Optional) Set Redemption Timer
  • 5. Start Redemption Period
  • Reward Distribution Formula
  • FAQs
  1. STAKING

NFT Staking lifecycle

The NFT staking process follows a clear lifecycle, from pool creation to reward redemption. This guide will walk you through each stage and help you understand how rewards and points are computed.


1. Create Your Pool

Start by creating your staking pool and importing up to 5 existing NFT collections that you want to allow for staking.

  • Only one chain is supported per pool.

  • Cross-chain staking is not yet available.


2. Set Up Staking Mechanics

After importing collections, you may configure the reward system for your pool:

Gamify Rare NFTs

Assign token multipliers to specific NFTs. For example, give higher multipliers to rarer NFTs in the collection.

Community-Based Rewards

Incentivize your community using:

  • Address multipliers: Apply custom multipliers to specific wallets.

  • Boosters: Add flat bonus points to select addresses.

Deposit Liquidity

Fund your pool by depositing ERC20 tokens as rewards.

  • You can deposit up to 20 different ERC20 tokens.

  • This is what participants will be able to redeem at the end of the staking cycle.


3. Publish the Pool

Once you're satisfied with your setup, publish your pool.

After publishing:

  • Your pool becomes publicly visible on the site.

  • Users can begin staking their NFTs.

  • This ensures pool visibility and protects users from disappearing pools.

Important: Once pools are published, they cannot be deleted anymore. This ensures stakers will have a page for staking/unstaking their NFTs.


4. (Optional) Set Redemption Timer

You can optionally configure a redemption countdown timer for your community.

  • This is a visual timer only and does not affect smart contract logic.

  • The pool owner must manually start the redemption period when ready.


5. Start Redemption Period

When ready, start the Redemption Period.

During this phase:

  • Most pool functions (like setting multipliers/boosters) are disabled.

  • Participants can now claim rewards.

  • The contract will distribute the liquidity based on the total points each participant earned.

After this, users should unstake their NFTs.

This marks the end of the NFT staking lifecycle.


Reward Distribution Formula

During redemption, the pool’s reward tokens will be divided based on each participant's total points.

Points Computation

Total Points = 
  (NFTs Staked × Multiplier × Days Staked) +
  (Address Multiplier × Days Staked) +
  (Flat Booster Points)
  • Default NFT multiplier: 1 point per NFT per day

  • Default Address multiplier: 0

  • Default Booster: 0


Example

Wallet
NFTs Staked
Token Multiplier
Address Multiplier
Booster
Days Staked
Total Points

A

3

2

1

10

10

(3×2×10)+(1×10)+10 = 80

B

5

1

0

0

10

(5×1×10) = 50


Liquidity Split

Once the redemption starts, 97% of the liquidity in the pool will be split among participants proportionally to their total points.

  • The remaining 3% is allocated to Kingdomly as protocol fees.


FAQs

Will my points persist if I unstake early?

Yes, your total points are preserved in a separate tracking holder even after unstaking. This means early unstakers can still claim their rewards when redemption begins.

When can I see my reward share?

You’ll be able to view your share of the pool once the redemption period has started. The rewards are automatically distributed based on your total points earned relative to the entire pool.

Every when does my points add up?

Your points add up automatically, points are growing every second but is only rounded up for display purposes.

Where can I see others points?

On the following versions, we will be adding a leaderboard for better transparency purposes within the staking pool.

PreviousTroubleshootingNextManage your NFT staking pool

Last updated 1 month ago