{"id":30232263,"url":"https://github.com/mathuo/erc20-token","last_synced_at":"2025-08-14T23:40:32.293Z","repository":{"id":308686389,"uuid":"1033445137","full_name":"mathuo/erc20-token","owner":"mathuo","description":"Example ERC20 Token ","archived":false,"fork":false,"pushed_at":"2025-08-07T08:53:24.000Z","size":372,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-08-07T10:16:12.077Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://mathuo.github.io/erc20-token/","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mathuo.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-08-06T20:33:23.000Z","updated_at":"2025-08-07T08:58:46.000Z","dependencies_parsed_at":"2025-08-07T10:28:15.657Z","dependency_job_id":null,"html_url":"https://github.com/mathuo/erc20-token","commit_stats":null,"previous_names":["mathuo/erc20-token"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/mathuo/erc20-token","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mathuo%2Ferc20-token","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mathuo%2Ferc20-token/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mathuo%2Ferc20-token/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mathuo%2Ferc20-token/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mathuo","download_url":"https://codeload.github.com/mathuo/erc20-token/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mathuo%2Ferc20-token/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":270500504,"owners_count":24595156,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-14T02:00:10.309Z","response_time":75,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-08-14T23:40:28.881Z","updated_at":"2025-08-14T23:40:32.282Z","avatar_url":"https://github.com/mathuo.png","language":"JavaScript","readme":"# 🚀 DeFi Token Suite\n\nA comprehensive monorepo for DeFi token management with smart contracts and web interface.\n\n![](website.png)\n\n## 📋 Overview\n\nThis monorepo contains:\n- **Smart Contracts**: ERC-20 tokens with advanced airdrop functionality\n- **Web Interface**: Next.js frontend for token management\n- **Multi-Network Support**: Ethereum, Base, and testnets\n- **Complete DeFi Stack**: Airdrops, liquidity, bridging, treasury\n\n## 🏗️ Project Structure\n\n```\ndefi-token-suite/\n├── packages/\n│   ├── contracts/          # Smart contracts (Hardhat)\n│   │   ├── contracts/      # Solidity contracts\n│   │   ├── scripts/        # Deployment \u0026 management scripts\n│   │   ├── test/          # Contract tests\n│   │   └── deployments/   # Deployment artifacts\n│   └── frontend/          # Web interface (Next.js)\n│       ├── src/\n│       │   ├── app/       # Next.js app router\n│       │   ├── components/ # React components\n│       │   ├── lib/       # Utilities \u0026 ABIs\n│       │   └── hooks/     # Custom React hooks\n│       └── public/        # Static assets\n├── package.json           # Root workspace config\n└── README.md             # This file\n```\n\n## ⚡ Quick Start\n\n### Prerequisites\n- Node.js 18+\n- npm 8+\n- Git\n\n### Installation\n\n```bash\n# Clone the repository\ngit clone https://github.com/your-username/defi-token-suite.git\ncd defi-token-suite\n\n# Install all dependencies\nnpm run install:all\n\n# Or install individually\nnpm install                    # Root workspace\nnpm run install:contracts      # Contracts only\nnpm run install:frontend       # Frontend only\n```\n\n### Development\n\n```bash\n# Start both contracts and frontend in development mode\nnpm run dev\n\n# Or start individually\nnpm run dev:contracts          # Local Hardhat node\nnpm run dev:frontend           # Next.js dev server\n```\n\n### Build \u0026 Test\n\n```bash\n# Build everything\nnpm run build\n\n# Test everything  \nnpm test\n\n# Or build/test individually\nnpm run build:contracts        # Compile contracts\nnpm run build:frontend         # Build Next.js app\nnpm run test:contracts         # Run contract tests\nnpm run test:frontend          # Run frontend tests\n```\n\n## 🏗️ Smart Contracts\n\n### Core Contracts\n\n- **MyToken.sol**: ERC-20 token with minting, burning, and treasury\n- **BatchAirdrop.sol**: Direct batch token distribution\n- **MerkleAirdrop.sol**: Scalable merkle tree-based airdrops  \n- **PublicAirdrop.sol**: Open claim airdrops with conditions\n- **ConditionalAirdrop.sol**: Advanced conditional claim logic\n- **SwapHelper.sol**: Uniswap V3 integration utilities\n\n### Deployment\n\n```bash\n# Deploy to testnets\nnpm run deploy:sepolia\nnpm run deploy:base-sepolia\n\n# Deploy to mainnets\nnpm run deploy:ethereum\nnpm run deploy:base\n```\n\n### Contract Management\n\n```bash\n# Navigate to contracts package\ncd packages/contracts\n\n# Airdrop operations\nnpm run deploy-airdrop         # Deploy airdrop contracts\nnpm run batch-airdrop          # Execute batch airdrop\nnpm run create-merkle-airdrop  # Create merkle campaign\nnpm run create-public-campaign # Create public claim campaign\n\n# Liquidity operations  \nnpm run create-pool:base       # Create Uniswap pool\nnpm run add-liquidity:base     # Add liquidity\n\n# Bridge operations\nnpm run bridge-deposit         # Bridge to Base\nnpm run bridge-withdraw        # Bridge to Ethereum\n\n# Status monitoring\nnpm run airdrop-status         # Check airdrop status\nnpm run public-airdrop-status  # Check public campaigns\n```\n\n## 🖥️ Web Interface\n\n### Tech Stack\n- **Next.js 14**: React framework with app router\n- **TypeScript**: Type-safe development\n- **Tailwind CSS**: Utility-first styling\n- **Wagmi**: React hooks for Ethereum\n- **RainbowKit**: Wallet connection UI\n- **Ethers.js**: Ethereum library\n\n### Features\n\n- 🔗 **Wallet Connection**: MetaMask, WalletConnect, and more\n- 🪙 **Token Management**: Deploy, mint, burn, transfer\n- 🎁 **Airdrop Interface**: All airdrop types with UI\n- 💧 **Liquidity Tools**: Uniswap V3 position management\n- 🌉 **Bridge Interface**: Cross-chain token transfers\n- 📊 **Analytics Dashboard**: Token metrics and history\n- 🎨 **Responsive Design**: Mobile-first interface\n\n### Development\n\n```bash\ncd packages/frontend\n\n# Environment setup\ncp .env.example .env.local\n# Edit .env.local with your configuration\n\n# Development server\nnpm run dev\n\n# Build for production\nnpm run build\nnpm run start\n```\n\n## 🌐 Supported Networks\n\n| Network | Chain ID | Status | Features |\n|---------|----------|--------|----------|\n| Ethereum | 1 | ✅ Production | All features |\n| Base | 8453 | ✅ Production | All features |\n| Sepolia | 11155111 | ✅ Testnet | All features |\n| Base Sepolia | 84532 | ✅ Testnet | All features |\n| Localhost | 31337 | 🔧 Development | All features |\n\n## 🎯 Airdrop Types\n\n### 1. Batch Airdrops\n- Direct token distribution to recipients\n- Owner pays all gas costs\n- Best for: \u003c 500 recipients\n\n### 2. Merkle Airdrops  \n- Recipients claim using merkle proofs\n- Cryptographically verified eligibility\n- Best for: \u003e 1000 recipients\n\n### 3. Public Airdrops\n- Anyone can claim (with conditions)\n- No pre-defined recipient list\n- Best for: Community building\n\n## 🔐 Environment Configuration\n\n### Contracts (.env)\n```bash\n# Network RPCs\nETHEREUM_RPC_URL=https://eth-mainnet.alchemyapi.io/v2/your-key\nBASE_RPC_URL=https://mainnet.base.org\nSEPOLIA_RPC_URL=https://ethereum-sepolia-rpc.publicnode.com\n\n# Deployment\nPRIVATE_KEY=your_private_key_without_0x_prefix\nETHERSCAN_API_KEY=your_etherscan_key\nBASESCAN_API_KEY=your_basescan_key\n\n# Token Configuration\nTOKEN_NAME=MyToken\nTOKEN_SYMBOL=MTK\nMAX_SUPPLY=1000000000\nINITIAL_SUPPLY=200000000\n```\n\n### Frontend (.env.local)\n```bash\n# WalletConnect\nNEXT_PUBLIC_PROJECT_ID=your_walletconnect_project_id\n\n# Contract Addresses (auto-populated after deployment)\nNEXT_PUBLIC_TOKEN_ADDRESS_ETHEREUM=0x...\nNEXT_PUBLIC_TOKEN_ADDRESS_BASE=0x...\nNEXT_PUBLIC_BATCH_AIRDROP_ADDRESS=0x...\nNEXT_PUBLIC_MERKLE_AIRDROP_ADDRESS=0x...\n```\n\n## 📚 Documentation\n\n- **Contracts**: See `packages/contracts/README.md`\n- **Frontend**: See `packages/frontend/README.md`\n- **Guides**: \n  - `UNISWAP_GUIDE.md` - Liquidity management\n  - `BRIDGE_GUIDE.md` - Cross-chain bridging  \n  - `TREASURY_GUIDE.md` - Treasury operations\n  - `CLAUDE.md` - Development workflow\n\n## 🧪 Testing\n\n### Contract Tests\n```bash\ncd packages/contracts\nnpm test                       # All tests\nnpx hardhat test               # Hardhat test runner\nnpm run coverage               # Coverage report\n```\n\n### Frontend Tests\n```bash\ncd packages/frontend  \nnpm test                       # Jest tests\nnpm run test:watch             # Watch mode\nnpm run test:coverage          # Coverage report\n```\n\n## 🚀 Deployment Guide\n\n### 1. Contract Deployment\n```bash\n# 1. Configure environment\ncp packages/contracts/.env.example packages/contracts/.env\n# Edit packages/contracts/.env\n\n# 2. Deploy contracts\nnpm run deploy:sepolia         # Test deployment\nnpm run deploy:ethereum        # Production deployment\n\n# 3. Export ABIs for frontend\ncd packages/contracts\nnpm run export-abis\n```\n\n### 2. Frontend Deployment\n```bash\n# 1. Configure environment  \ncp packages/frontend/.env.example packages/frontend/.env.local\n# Edit packages/frontend/.env.local with contract addresses\n\n# 2. Build and deploy\nnpm run build:frontend\n# Deploy to Vercel, Netlify, or your hosting provider\n```\n\n## 🤝 Contributing\n\n1. Fork the repository\n2. Create a feature branch: `git checkout -b feature/amazing-feature`\n3. Commit changes: `git commit -m 'Add amazing feature'`\n4. Push to branch: `git push origin feature/amazing-feature`\n5. Open a Pull Request\n\n### Development Workflow\n1. Make changes in appropriate package\n2. Run tests: `npm test`\n3. Build: `npm run build`\n4. Lint: `npm run lint` (in frontend package)\n5. Commit with clear messages\n\n## 📄 License\n\nMIT License - see [LICENSE](LICENSE) file for details.\n\n## 🆘 Support\n\n- **Documentation**: Check package-specific READMEs\n- **Issues**: Open GitHub issue with detailed description\n- **Discord**: Join our community (link coming soon)\n\n## 🔗 Links\n\n- **Live Demo**: https://defi-token-suite.vercel.app (coming soon)\n- **Contract Addresses**: See deployment files in `packages/contracts/deployments/`\n- **Block Explorers**: \n  - [Ethereum](https://etherscan.io)\n  - [Base](https://basescan.org)\n  - [Sepolia](https://sepolia.etherscan.io)\n\n---\n\n**Built with ❤️ for the DeFi community**","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmathuo%2Ferc20-token","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmathuo%2Ferc20-token","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmathuo%2Ferc20-token/lists"}