A decentralized Memecoin Launchpad inspired by Pump.fun — built using Solidity, Hardhat, Ethers.js, and Next.js.
This project enables users to create, deploy, and interact with ERC-20 tokens directly through their MetaMask wallet on a local blockchain network.
fun.pump is a full-stack decentralized application (dApp) that recreates the core mechanics of a memecoin launchpad.
It allows users to deploy custom ERC-20 tokens using smart contracts, manage token trading logic, and interact with these contracts through an intuitive Next.js frontend.
The platform simulates how modern token launchpads operate — combining blockchain backend logic with seamless frontend integration and real wallet connectivity.
🧠 This project was built as part of a guided tutorial by Dapp University to deepen understanding of blockchain architecture, Solidity contract deployment, and web3 integration.
✅ 🧱 Dual Smart Contracts — Includes both Factory and Token contracts.
- Factory: Deploys new ERC-20 token contracts dynamically.
- Token: Implements the token logic (name, symbol, supply, transfer).
✅ 🔗 MetaMask Wallet Integration — Users can connect directly to their wallet for on-chain interactions.
✅ ⚙️ Hardhat Local Blockchain — Runs a private Ethereum network for safe, local development.
✅ 🧠 Ethers.js Integration — Handles contract calls, event listening, and wallet transactions.
✅ 🎨 Modern Frontend — Built using Next.js for responsive, dynamic user experience.
✅ 🧩 Modular Architecture — Clear structure separating contracts, components, and configuration.
✅ 📦 Configurable Deployment — Works seamlessly with Hardhat’s localhost network (chain ID: 31337).
| Category | Technology Used |
|---|---|
| Smart Contracts | Solidity |
| Blockchain Framework | Hardhat |
| Frontend Framework | Next.js |
| Blockchain Interaction | Ethers.js |
| Wallet Provider | MetaMask |
| Styling | CSS / Tailwind (optional) |
| Testing | Hardhat Testing Environment |
git clone https://github.com/<your-username>/fun-pump.git
cd fun-pumpnpm installnpx hardhat nodeIn a new terminal window, run:
npx hardhat ignition deploy ignition/modules/Factory.js --network localhostIf you’ve deployed before and want to reset:
npx hardhat ignition deploy ignition/modules/Factory.js --network localhost --resetnpm run devVisit the app at 👉 http://localhost:3000
fun-pump/
│
├── app/
│ ├── abis/ # Compiled contract ABIs (Factory, Token)
│ ├── components/ # React components (Header, List, Token, Trade)
│ ├── config.json # Local contract addresses and chain info
│ ├── globals.css # Global styles
│ ├── layout.js # App layout
│ └── page.js # Main entry page
│
├── contracts/
│ ├── Factory.sol # Factory contract (deploys Token contracts)
│ └── Token.sol # ERC-20 token contract
│
├── ignition/ # Hardhat deployment scripts
├── test/ # Contract test scripts
├── hardhat.config.js # Hardhat configuration
├── next.config.mjs # Next.js configuration
├── package.json # Dependencies
└── README.md
- Hardhat Node runs a local blockchain simulation (chain ID: 31337).
- The Factory Contract is deployed — it can mint and deploy multiple Token contracts.
- The Next.js Frontend interacts with these contracts using Ethers.js and MetaMask.
- Users connect their MetaMask wallet, deploy new tokens, and simulate on-chain interactions.
- Real blockchain logic is executed locally, with full transparency through console logs and contract events.
- Demonstrates the complete Web3 stack — Solidity, Hardhat, MetaMask, and Next.js.
- Implements dynamic smart contract deployment and real wallet connectivity.
- Utilizes config.json for flexible network configuration (safe for localhost).
- Designed for learning full-stack blockchain development with real-world architecture.
This project is intended for educational and experimental purposes only.
Do not use it for real financial transactions or deploy it to mainnet.