๐ LaunchPaw - Token Launch Platform
LaunchPaw is a decentralized platform built on EduChain that enables users to create, launch, and trade tokens with an automated bonding curve mechanism.
โจ Features
-
๐ซ Bonding Curve Mechanism
- Dynamic pricing based on supply and demand
- Fair token distribution
- Automated price discovery
-
๐ง Liquidity Management
- Automated liquidity pool creation
- Built-in reward system for liquidity providers
- Efficient token swapping
-
๐ Security Features
- Verified smart contracts
- Automated security checks
- Transparent token mechanics
-
๐ User Dashboard
- Portfolio tracking
- Transaction history
- Performance analytics
๐ ๏ธ Technical Stack
-
Frontend
- React + TypeScript
- Tailwind CSS
- Framer Motion
- wagmi/viem
- ethers.js
-
Smart Contracts
- Solidity
- Hardhat
- OpenZeppelin
๐ Getting Started
Prerequisites
node.js >= 16.0.0
npm or yarn
Installation
- Clone the repository:
git clone https://github.com/arhansuba/launchpaw.git
cd launchpaw
- Install dependencies:
# Install frontend dependencies
cd src
npm install
# Install contract dependencies
cd contracts
npm install
- Set up environment variables:
cp .env.example .env
- Start local development:
# Start local hardhat node
npx hardhat node
# Deploy contracts
npx hardhat run scripts/deploy.js --network localhost
# Start frontend
npm run dev
๐ Project Structure
LaunchPaw/
โโโ src/ # Frontend application
โ โโโ components/ # Reusable components
โ โโโ pages/ # Page components
โ โโโ hooks/ # Custom React hooks
โ โโโ config/ # Configuration files
โ โโโ utils/ # Utility functions
โ
โโโ contracts/ # Smart contracts
โ โโโ contracts/ # Contract source files
โ โโโ scripts/ # Deployment scripts
โ โโโ test/ # Contract tests
๐ง Configuration
- Configure your network in
src/config/chains.ts - Update contract addresses in
src/config/contracts.ts - Configure hardhat settings in
contracts/hardhat.config.js
๐งช Testing
# Run contract tests
cd contracts
npx hardhat test
# Run frontend tests
cd src
npm test
๐ Deployment
- Deploy contracts:
cd contracts
npx hardhat run scripts/deploy.js --network educhain
- Build frontend:
cd src
npm run build
๐ Smart Contract Documentation
Key contracts:
TokenFactory.sol: Main factory for token creationNativeLiquidityPool.sol: Handles liquidity and swapsBondingCurve.sol: Implements bonding curve mechanics
๐ค Contributing
- Fork the repository
- Create your feature branch (
git checkout -b feature/AmazingFeature) - Commit your changes (
git commit -m 'Add some AmazingFeature') - Push to the branch (
git push origin feature/AmazingFeature) - Open a Pull Request
๐ License
This project is licensed under the MIT License - see the LICENSE.md file for details.
๐ Acknowledgments
- Built for the EduChain Hackathon
- Inspired by innovative DeFi platforms
- Uses OpenZeppelin contracts for security
๐ Support
For support and questions, please open an issue in the GitHub repository or contact the team at [your contact info].
๐ฎ Future Roadmap
- Enhanced analytics dashboard
- Additional token features
- Advanced trading tools
- Mobile app development
Description
Languages
TypeScript
93.1%
JavaScript
5.1%
CSS
1.6%
HTML
0.2%