FluxStake - Ethereum ERC-20 Token Staking DApp with Multiple Fixed-APR Packages & Rewards

FluxStake is a production-ready staking application for ERC-20 tokens on Ethereum and EVM-compatible networks. It combines a solid smart contract with a modern React/Vite frontend so you can launch fixed-APR staking quickly. Token holders stake your token, select a lock period (package), and withdraw principal plus fixed rewards at maturity. Admins manage packages, APR changes, and reward funding directly from the contract.

Who Is It For?

• Token projects that want a clean, trustworthy staking product for their community.
• DeFi teams, DAOs, launchpads, NFT or gaming projects needing lock-up mechanics and predictable rewards.
• Agencies and freelancers who need a reusable staking solution for clients.

How It Works (User Flow)

1. Connect a wallet (WalletConnect/MetaMask compatible).
2. Enter an amount, choose a package (for example, 7, 30, 60, 90 days), and confirm the stake.
3. View TVL, balance, personal stakes, recent stakes, top stakers, and 14-day activity.
4. At maturity, withdraw principal plus the fixed reward for that package.

How It Works (Admin Flow)

1. Deploy the ERC-20 token (or use an existing one) on the target network.
2. Deploy the FluxStaking contract, set initial packages, and fund the reward pool.
3. Adjust APRs over time; decreases use a safety delay to protect stakers.
4. Configure the frontend with your contract addresses and RPC, then build and host.

Key Features

• Multiple lock packages with fixed APR (basis points) and clear maturity rules.
• Deferred APR decreases with a minimum delay to protect existing stakers.
• Real-time UI: TVL, recent stakes, top stakers, and 14-day staking activity chart.
• Auto-refresh on new on-chain events (stake/withdraw) without manual reloads.
• Responsive, accessible UX; keyboard-friendly controls.
• Wallet integration via WalletConnect, Wagmi, and Viem.

Smart Contract Highlights

• Solidity 0.8.x with OpenZeppelin Ownable, ReentrancyGuard, and SafeERC20.
• Owner actions: add/update packages, update APR, enable/disable staking and withdrawals, fund/withdraw rewards, recover non-stake tokens.
• View functions for dashboards: daily totals, pending rewards, user stakes, ROI history.
• Events on stake and withdraw for indexing and live UI updates.

What You Can Configure

• Packages: lock period (seconds), active state, initial APR (basis points).
• APR changes: increases can be immediate; decreases enforce a minimum delay.
• Global switches: enable or disable new staking and withdrawals.
• Reward pool management: fund and withdraw rewards (owner only).
• Frontend: network, RPC, contract addresses, branding, and theme variables.

Technology Stack

• Frontend: React, Vite, TypeScript, Tailwind CSS, Wagmi, Viem, WalletConnect.
• Smart Contracts: Solidity with OpenZeppelin libraries.
• Build and Deploy: Vite output in a static dist folder for any hosting.

What’s Included

• Frontend source code with a ready-made staking UI and charts.
• Flattened staking contract file for easy Remix deployment.
• Optional Hardhat version with imports for advanced workflows.
• Documentation with step-by-step deployment and configuration.

Requirements

• Node.js LTS for building the frontend.
• An ERC-20 token deployed on the same network as the staking contract.
• RPC provider URL and a WalletConnect Project ID.

Security Notes

• Uses established OpenZeppelin patterns and guards.
• For production, an independent smart-contract audit is strongly recommended.
• Test on a test network before mainnet deployment.

Limitations and Compatibility

• Built for ERC-20 tokens on Ethereum and EVM-compatible chains.
• Rewards must be funded; withdrawals revert if rewards are insufficient.
• APR is fixed per package; customize or remove methods to fit your tokenomics.

Quick Start

1. Deploy the ERC-20 and the staking contract via Remix using the provided flattened file.
2. Fund rewards and ensure packages are active.
3. Update the frontend configuration with your contract addresses and RPC.
4. Run npm install, then npm run build, and upload the dist folder to your hosting.

Who Owns the Funds?

Users retain custody in their wallets until they approve and stake. The contract safely holds principal until withdrawal and pays rewards from the owner-funded reward pool per package rules.

Why FluxStake?

• Clear, transparent staking mechanics your community can understand.
• Fast to deploy, easy to brand, and simple to maintain.
• Built for developer ergonomics and end-user trust.

Support

Documentation is included. The codebase is commented and organized to speed up customization and audits.