🚀 StakeHive — Enterprise-Grade DeFi Staking Protocol

🔥 Live Demo

🧪 How to Use StakeHive

🔹 Step 1: Enable Test Networks in MetaMask

🔹 Step 2: Add Sepolia Testnet (If Not Visible)

🔹 Step 3: Get Sepolia ETH for Gas

🔹 Step 4: Add HIVE Token to MetaMask

🔹 Step 5: Connect Wallet to StakeHive

🔁 StakeHive Features & How to Use Them

✅ Stake HIVE Tokens

💸 Claim Rewards

🔓 Withdraw Staked Tokens

🔁 Transfer HIVE Tokens

🎯 Pro Tips

✨ Key Features

🏗️ Architecture Overview

graph TD
A[Frontend: Nuxt3] -->|Ethers.js| B[Smart Contracts]
B --> C[Blockchain]
F[Users] --> A

🛠️ Technology Stack

Smart Contracts

Frontend

📦 Getting Started

Prerequisites

🚀 Quick Start (Testing Only)

# 1. Clone the repo
git clone https://github.com/Darahat/stakehive-dapp.git
cd stakehive-dapp

# 2. Install Web3 dependencies
npm install

# 3. Install frontend dependencies
cd frontend
npm install

# 4. Run the frontend
npm run dev

🛠️ Full Development Setup

# 1. Clone the repo
git clone https://github.com/Darahat/stakehive-dapp.git
cd stakehive-dapp

# 2. Install dependencies for backend and frontend
npm install
cd frontend
npm install
cd ..

# 3. Start local blockchain (in a separate terminal)
# Open a new terminal and run:
npx hardhat node
# Keep this terminal running

# 4. Deploy contracts to localhost (in your main terminal)
npx hardhat run scripts/deploy-and-update.js --network localhost

# Note: No .env file needed for localhost! Only required for Sepolia testnet deployment

# 5. Run the frontend
cd frontend
npm run dev

# Create .env file only if deploying to Sepolia testnet
cp .env.example .env

# Then edit .env with:
SEPOLIA_RPC_URL=https://eth-sepolia.g.alchemy.com/v2/YOUR_API_KEY
PRIVATE_KEY=your_wallet_private_key_without_0x

# Deploy to Sepolia:
npx hardhat run scripts/deploy-and-update.js --network sepolia

🔴 CRITICAL: Understanding Contract Addresses

export const ADDRESS_MAP = {
  31337: {
    // Hardhat Local Network
    HIVE_TOKEN: "0x5FbDB2315678afecb367f032d93F642f64180aa3",
    STAKE_HIVE: "0xe7f1725E7734CE288F8367e1Bb143E90bb3F0512",
  },
  11155111: {
    // Sepolia Testnet
    HIVE_TOKEN: "0x359863fB0ca4E4be77daD9dFFBB0BbdA94690cCC",
    STAKE_HIVE: "0x3531D47A28Aa87Bd5F9eaD3D2d8Fe07Ce16C8DDc",
  },
};

🟢 Option A: Automated Deployment (Recommended)

# Deploy to Sepolia and auto-update frontend
npx hardhat run scripts/deploy-and-update.js --network sepolia

# Or for local Hardhat network:
npx hardhat node  # Terminal 1 - keep running
npx hardhat run scripts/deploy-and-update.js --network localhost  # Terminal 2

# 1. Import new token to MetaMask with printed address
# 2. Transfer tokens to your wallet (update recipient address in script first)
npx hardhat run scripts/transfer-tokens.js --network sepolia

# 3. Start the frontend
cd frontend
npm run dev

🔴 Option B: Manual Deployment (Not Recommended)

# Deploy contracts
npx hardhat run scripts/deploy.js --network sepolia

node scripts/update-addresses.js <chainId> <hiveTokenAddress> <stakeHiveFarmAddress>

# Example:
node scripts/update-addresses.js 11155111 0x123... 0x456...

export const ADDRESS_MAP = {
  11155111: {
    // Sepolia
    HIVE_TOKEN: "0xYOUR_NEW_TOKEN_ADDRESS",
    STAKE_HIVE: "0xYOUR_NEW_FARM_ADDRESS",
  },
};

# 1. Restart frontend dev server
cd frontend
npm run dev

# 2. Hard refresh browser (Ctrl+Shift+R)
# 3. Reconnect MetaMask wallet
# 4. Import new HIVE token address to MetaMask
# 5. Transfer tokens to your account

🧪 Running Tests

# Run all tests
npx hardhat test

# Run specific test file
npx hardhat test test/StakeHiveFarm.test.js

# Run with gas reporting
REPORT_GAS=true npx hardhat test

🎓 Usage Guide & Best Practices

Connecting Your Wallet

Getting HIVE Tokens

# Edit scripts/transfer-tokens.js with:
# - recipientAddress: your wallet address
# - hiveTokenAddress: your deployed token address
# - transferAmount: amount to transfer (default: "10000")

npx hardhat run scripts/transfer-tokens.js --network sepolia

Importing HIVE Token to MetaMask

Using StakeHive Features

Important Notes

📊 Performance Highlights

🔧 Developer Tools & Scripts

Available Scripts

Project Structure

stakehive-dapp/
├── contracts/              # Solidity smart contracts
│   ├── HiveToken.sol      # ERC20 token with mint/burn
│   └── StakeHiveFarm.sol  # Staking rewards contract
├── scripts/               # Deployment and utility scripts
│   ├── deploy-and-update.js   # Automated deployment ✅
│   ├── deploy.js             # Manual deployment
│   ├── update-addresses.js   # Address updater utility
│   └── transfer-tokens.js    # Token transfer helper
├── test/                  # Hardhat test suite
│   └── StakeHiveFarm.test.js
├── frontend/              # Nuxt 3 frontend
│   ├── components/        # Vue components
│   ├── pages/            # Route pages
│   ├── stores/           # Pinia state management
│   │   └── walletStore.js   # Wallet & blockchain logic
│   ├── utils/
│   │   └── contract.js      # Contract ABIs & addresses ⚠️
│   └── plugins/
│       └── web3.js          # Ethers.js setup
├── hardhat.config.js     # Hardhat configuration
├── .env.example          # Environment template
└── .env                  # Your secrets (gitignored)

Key Files to Know

Debugging Tips

⚠️ Troubleshooting Guide

🔴 "Available Balance: 0.00 HIVE" but MetaMask shows tokens

🔴 "Unknown Token" in MetaMask

🔴 Transaction Failures

🔴 Frontend doesn't recognize deployed contracts

🔴 "Receiver must be an instance of class" error

🔴 Wallet not detected

🔴 Contract deployment fails

💡 Best Practices

👨‍💻 Developer Notes

📬 Contact & Collaboration

📜 License