FBiT Staking — Solana DApp
A production-ready, decentralized staking platform for the FBiT token on Solana. The platform implements Proof-of-Stake (PoS) APY, a 10-level referral commission system, a Team Target Bonus program, a deflationary burn mechanism, and an automated emission reserve — all governed by an on-chain Anchor smart contract.
Live Demo: https://futurebit.in
Table of Contents
- Project Overview
- How It Works — Complete Flow
- Reward & Fee System
- 10-Level Referral System
- Team Target Bonus
- Burn & PoS Emission System
- Ownership Renouncement
- Admin Panel
- Smart Contract
- Frontend Architecture
- Security System
- Project Structure
- Environment Variables
- Deployment Guide
- Technology Stack
- Token & Contract Addresses
- Changelog
1. Project Overview
FBiT Staking is a fully on-chain staking DApp where users lock FBiT tokens for 30 days and earn rewards. The APY is not fixed — it adjusts automatically based on how many tokens are currently staked (Proof-of-Stake model). As more users stake, the APY decreases; as users unstake, the APY rises. The system is designed to be fully autonomous: the admin deposited the full token reserve and renounced ownership on-chain (see Section 7) — the contract now runs indefinitely with no admin able to change any parameter, ever.
Core Highlights
| Feature | Details |
|---|
| Lock Period | 30 days (fixed) |
| Claim Interval | Every 6 hours (4 intervals/day) |
| APY Range | 10% – 300% (auto-adjusting, PoS) |
| Burn Rate | 5% base (of the after-fee reward amount) + up to another 5% from any unpaid claim-referral levels — see the new Claim Referral row below (locked permanently, self-corrected in code — set_burn_bps is disabled post-renouncement) |
| Referral Levels | 10 levels deep (one-time, on stake) |
| Referral Total | 17.75% distributed across all 10 levels on stake (live on-chain config, confirmed current; contract's compile-time default is 30% and only applies if this is ever unset) |
| Claim Referral (v2.7) | A separate recurring referral layer paid on every claim/compound — levels 1-5 only, 3%/2.5%/2%/1.5%/1% (10% max), carved out of that claim's own after-fee amount, not the pool — see Section 3 |
| Team Bonus | Up to +10% on top of staking rewards |
| Network | Solana Mainnet |
| Platform Fee | 0.25% on all operations, routed to feeRecipient now that ownership is renounced (see Section 3) |
| AI Support Chat | Claude-powered widget answering platform FAQs (/api/support-chat) |
2. How It Works — Complete Flow
Step 1 — Connect Wallet
Users connect their Solana wallet (Phantom, Solflare, Backpack, or any Wallet Standard-compliant wallet) via Reown AppKit.
Step 2 — Register with a Referral Link (Optional)
Before staking, a user can click a referral link (?ref=<address>). This stores the referrer on-chain and credits all 10 levels of the referral chain when the user stakes. The referrer must already have an active stake themselves (total_staked > 0) for their link to work — this is a deliberate security requirement (see the v2.4/v2.6 Changelog entries) that also makes a circular referral chain impossible to construct.
Step 3 — Stake FBiT Tokens
- User enters an amount of FBiT tokens.
- Smart contract deducts a 0.25% platform fee (routed to
feeRecipient, the former admin's address — ownership is already renounced on this deployment, see Section 7).
- Remaining tokens are locked for 30 days.
- The contract records the effective APY at stake time for display.
- The referral chain (up to 10 levels) immediately receives commissions from the reward pool.
Step 4 — Earn Rewards
Rewards accumulate every 6 hours (4 intervals/day). Formula:
grossReward = stakedAmount × effectiveAPY × intervals / (1,460 × 10,000)
Where:
effectiveAPY = clamp(ANNUAL_EMISSION × 10,000 / totalStaked, 1_000, 30_000)
MIN_APY_BPS = 1,000 (10% floor) MAX_APY_BPS = 30,000 (300% ceiling)
intervals = seconds elapsed / 21,600 (each interval = 6 hours)
1,460 = total 6-hour intervals in one year (4 × 365)
The APY self-adjusts in real time:
- More stakers → lower APY (reward pie splits among more people)
- Fewer stakers → higher APY (each person gets a larger share)
Step 5 — Claim or Compound Rewards
Every 6 hours the user can:
- Claim: Receive net FBiT reward to their wallet
- Compound: Re-stake the net reward, increasing their stake (and future earnings)
In both cases, the burn mechanism applies (see Section 3).
Step 6 — Unstake After 30 Days
Once the lock period expires, the user calls Unstake. The contract:
- Deducts the same 0.25% fee from the principal (this applies whether ownership is renounced or not — it just routes to
feeRecipient post-renouncement instead of the admin wallet, see Section 3).
- Transfers the remaining principal back to the user.
3. Reward & Fee System
The 0.25% platform fee applies identically on every operation (stake, claim, compound, unstake) whether ownership is renounced or not — renouncing only changes where it's sent (see below). There is no separate, larger fee that appears after renouncement — an earlier design had one (a 25%-of-gross cut funded from the pool), but it was simplified away in v2.1 in favor of just keeping the platform fee flowing, permanently, to whichever address is entitled to it.
This is the beginning of the README. Read the rest at the original. Read the full README ↗
