{"id":35405040,"url":"https://github.com/hoddukzoa12/crowdmantle","last_synced_at":"2026-01-13T19:43:05.364Z","repository":{"id":331441257,"uuid":"1126634498","full_name":"hoddukzoa12/crowdmantle","owner":"hoddukzoa12","description":"Decentralized equity crowdfunding with milestone-based fund release on Mantle Network","archived":false,"fork":false,"pushed_at":"2026-01-03T08:20:25.000Z","size":351,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-01-08T10:41:19.255Z","etag":null,"topics":["blockchain","crowdfunding","defi","governance","hackathon","mantle","nextjs","solidity","thirdweb","web3"],"latest_commit_sha":null,"homepage":"https://crowdmantle.vercel.app/","language":"TypeScript","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/hoddukzoa12.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,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-01-02T09:51:46.000Z","updated_at":"2026-01-03T08:15:34.000Z","dependencies_parsed_at":"2026-01-09T11:12:58.484Z","dependency_job_id":null,"html_url":"https://github.com/hoddukzoa12/crowdmantle","commit_stats":null,"previous_names":["hoddukzoa12/crowdmantle"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/hoddukzoa12/crowdmantle","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hoddukzoa12%2Fcrowdmantle","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hoddukzoa12%2Fcrowdmantle/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hoddukzoa12%2Fcrowdmantle/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hoddukzoa12%2Fcrowdmantle/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hoddukzoa12","download_url":"https://codeload.github.com/hoddukzoa12/crowdmantle/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hoddukzoa12%2Fcrowdmantle/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28397826,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-13T14:36:09.778Z","status":"ssl_error","status_checked_at":"2026-01-13T14:35:19.697Z","response_time":56,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["blockchain","crowdfunding","defi","governance","hackathon","mantle","nextjs","solidity","thirdweb","web3"],"created_at":"2026-01-02T12:39:01.831Z","updated_at":"2026-01-13T19:43:05.359Z","avatar_url":"https://github.com/hoddukzoa12.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# CrowdMantle\n\n\u003cdiv align=\"center\"\u003e\n\n**Decentralized Equity Crowdfunding with Milestone-Based Fund Release**\n\n*Mantle Global Hackathon 2025*\n\n[![Mantle Network](https://img.shields.io/badge/Network-Mantle%20Sepolia-blue)](https://sepolia.mantlescan.xyz)\n[![Solidity](https://img.shields.io/badge/Solidity-0.8.20-363636)](https://soliditylang.org)\n[![Next.js](https://img.shields.io/badge/Next.js-16-black)](https://nextjs.org)\n[![License](https://img.shields.io/badge/License-MIT-green)](LICENSE)\n\n\u003c/div\u003e\n\n---\n\n## Problem Statement\n\nTraditional crowdfunding platforms suffer from a critical issue: **once a campaign succeeds, creators receive 100% of funds immediately**, leaving investors with no leverage to ensure project delivery.\n\n**CrowdMantle solves this** by implementing milestone-based fund release with on-chain governance, ensuring:\n- Creators must deliver promised milestones to access funds\n- Investors retain voting power throughout the project lifecycle\n- Transparent, trustless fund management via smart contracts\n\n---\n\n## How It Works\n\n```\nTraditional Crowdfunding:\nCampaign Success → Creator Claims 100% → Investors Hope for Delivery\n\nCrowdMantle Approach:\nCampaign Success → Milestone 1 Submitted → Investors Vote → Approved? → 30% Released\n                → Milestone 2 Submitted → Investors Vote → Approved? → 40% Released\n                → Milestone 3 Submitted → Investors Vote → Approved? → 30% Released\n```\n\n---\n\n## Key Features\n\n| Feature | Description |\n|---------|-------------|\n| **Milestone-Gated Release** | Up to 3 milestones with customizable fund allocation |\n| **On-Chain Governance** | Token-weighted voting for milestone approval |\n| **Equity Tokens** | ERC-20 tokens issued 1:1 with MNT invested |\n| **Investor Protection** | Emergency refund if milestones fail |\n| **Automatic Escrow** | Funds held securely until governance approval |\n| **Founder Allocation** | Up to 30% founder token share |\n| **Platform Fee** | 2% fee on released funds |\n\n---\n\n## Tech Stack\n\n| Layer | Technology |\n|-------|------------|\n| **Frontend** | Next.js 16, React 19, TypeScript |\n| **Styling** | Tailwind CSS 4, Shadcn/ui |\n| **Web3** | Thirdweb SDK v5 |\n| **Smart Contracts** | Solidity 0.8.20, Hardhat, OpenZeppelin |\n| **Network** | Mantle Sepolia Testnet (Chain ID: 5003) |\n\n---\n\n## Smart Contracts\n\n### Deployed Addresses (Mantle Sepolia)\n\n| Contract | Address | Description |\n|----------|---------|-------------|\n| **MilestoneEscrow** | `0x14361d51520528a050ae45E028AFdEDe89Ae7428` | Unified escrow with milestone support |\n| **GovernanceV2** | `0xe43E47b6F542541b86F5CA27dcf4DFBbE84BDDB8` | Extended governance for milestones |\n| **Platform Wallet** | `0xBf30B87972F7A1e1fA018615d636b2C3c7bcA8Ef` | Fee recipient |\n\n### Contract Architecture\n\n```\n┌─────────────────────────────────────────────────────────────────────┐\n│                        MilestoneEscrow                               │\n│  ┌──────────────┐  ┌──────────────┐  ┌────────────────────────────┐ │\n│  │  Campaign    │  │  Milestone   │  │  EquityToken               │ │\n│  │  Management  │  │  Tracking    │  │  (deployed per campaign)   │ │\n│  │              │  │              │  │                            │ │\n│  │  • create    │  │  • submit    │  │  • 1:1 with MNT           │ │\n│  │  • pledge    │  │  • approve   │  │  • 18 decimals            │ │\n│  │  • refund    │  │  • release   │  │  • governance voting      │ │\n│  └──────────────┘  └──────────────┘  └────────────────────────────┘ │\n└─────────────────────────────────────────────────────────────────────┘\n                                │\n                                │ milestone proposals\n                                ▼\n┌─────────────────────────────────────────────────────────────────────┐\n│                          GovernanceV2                                │\n│  ┌──────────────┐  ┌──────────────┐  ┌────────────────────────────┐ │\n│  │  Proposals   │  │  Voting      │  │  Milestone Integration     │ │\n│  │              │  │              │  │                            │ │\n│  │  • create    │  │  • for/against│ │  • auto-approve on pass   │ │\n│  │  • execute   │  │  • 3-day period│ │  • auto-reject on fail   │ │\n│  │  • cancel    │  │  • weighted  │  │  • fund release trigger   │ │\n│  └──────────────┘  └──────────────┘  └────────────────────────────┘ │\n└─────────────────────────────────────────────────────────────────────┘\n```\n\n### MilestoneEscrow.sol\n\n**Key Functions:**\n\n| Function | Description |\n|----------|-------------|\n| `createCampaignWithMilestones()` | Create campaign with up to 3 milestones |\n| `createCampaign()` | Create standard campaign (immediate claim) |\n| `pledge()` | Invest MNT in a campaign |\n| `submitMilestoneForApproval()` | Submit milestone for governance vote |\n| `releaseMilestoneFunds()` | Release funds after vote approval |\n| `claimTokens()` | Investors claim equity tokens |\n| `refund()` | Full refund if campaign fails |\n| `emergencyRefund()` | Refund if milestone rejected |\n\n**Constants:**\n\n| Constant | Value | Description |\n|----------|-------|-------------|\n| `PLATFORM_FEE_BPS` | 200 | 2% platform fee |\n| `MAX_MILESTONES` | 3 | Maximum milestones per campaign |\n| `MAX_FOUNDER_SHARE_BPS` | 3000 | 30% max founder allocation |\n| `MIN_DURATION_DAYS` | 1 | Minimum campaign duration |\n| `MAX_DURATION_DAYS` | 60 | Maximum campaign duration |\n\n### GovernanceV2.sol\n\n**Key Functions:**\n\n| Function | Description |\n|----------|-------------|\n| `createMilestoneProposal()` | Create proposal for milestone approval |\n| `vote()` | Cast token-weighted vote |\n| `executeProposal()` | Finalize after voting period |\n| `getProposal()` | Get proposal details |\n\n**Voting Parameters:**\n- Voting Period: 3 days\n- Minimum Proposer Holding: 1% of token supply\n- Quorum: Simple majority\n\n---\n\n## Project Structure\n\n```\ncrowdmantle/\n├── app/                              # Next.js App Router\n│   ├── page.tsx                      # Landing page\n│   ├── campaign/[id]/                # Campaign detail (unified)\n│   ├── dashboard/                    # User dashboard\n│   ├── project/create/               # Campaign creation\n│   └── projects/                     # Browse campaigns\n│\n├── components/\n│   ├── milestones/                   # Milestone components\n│   │   ├── milestone-card.tsx        # Individual milestone\n│   │   ├── milestone-progress-card.tsx # Progress timeline\n│   │   ├── milestone-tab.tsx         # Campaign milestones tab\n│   │   └── milestone-form-step.tsx   # Creation form step\n│   ├── governance/                   # Governance components\n│   │   ├── governance-tab.tsx        # Governance container\n│   │   ├── proposal-list.tsx         # Proposal listing\n│   │   ├── proposal-card.tsx         # Proposal display\n│   │   ├── create-proposal-dialog.tsx\n│   │   └── vote-buttons.tsx\n│   ├── crowdfunding/                 # Crowdfunding components\n│   ├── project/                      # Project components\n│   ├── ui/                           # Shadcn/ui components\n│   └── layout/                       # Layout components\n│\n├── contracts/                        # Solidity contracts\n│   ├── MilestoneEscrow.sol          # Main escrow contract\n│   ├── GovernanceV2.sol             # Extended governance\n│   ├── EquityToken.sol              # ERC-20 token\n│   └── interfaces/\n│\n├── lib/\n│   ├── contracts/                    # Contract utilities\n│   │   ├── abis.ts                  # Contract ABIs\n│   │   ├── escrow.ts                # Escrow interactions\n│   │   ├── milestones.ts            # Milestone utilities\n│   │   ├── governance.ts            # Governance interactions\n│   │   └── types.ts                 # TypeScript types\n│   ├── constants/                    # Configuration\n│   │   └── addresses.ts             # Contract addresses\n│   └── thirdweb/                    # Thirdweb config\n│\n├── src/                             # Clean architecture layers\n│   ├── application/                 # Use cases \u0026 DTOs\n│   ├── infrastructure/              # Blockchain contracts\n│   └── presentation/                # React hooks\n│\n├── test/                            # Contract tests\n│   ├── MilestoneEscrow.test.ts\n│   └── GovernanceV2.test.ts\n│\n└── scripts/                         # Deployment scripts\n    ├── deploy.ts\n    └── deploy-milestone.ts\n```\n\n---\n\n## Getting Started\n\n### Prerequisites\n\n- Node.js 18+\n- npm or yarn\n- MetaMask or compatible wallet\n- MNT on Mantle Sepolia ([Faucet](https://faucet.sepolia.mantle.xyz))\n\n### Installation\n\n```bash\n# Clone repository\ngit clone \u003crepository\u003e\ncd crowdmantle\n\n# Install dependencies\nnpm install\n\n# Create environment file\ncp .env.example .env.local\n# Add NEXT_PUBLIC_THIRDWEB_CLIENT_ID\n```\n\n### Development\n\n```bash\n# Start development server\nnpm run dev\n\n# Compile contracts\nnpm run compile\n\n# Run tests\nnpm run test                    # All tests\nnpm run test:milestone          # Milestone tests only\nnpm run test:governance         # Governance tests only\n\n# Deploy contracts\nnpm run deploy:milestone-sepolia\n```\n\n### Build\n\n```bash\nnpm run build\nnpm start\n```\n\n---\n\n## Environment Variables\n\n```env\n# .env.local (Frontend)\nNEXT_PUBLIC_THIRDWEB_CLIENT_ID=your_client_id\n\n# .env (Hardhat)\nPRIVATE_KEY=your_wallet_private_key\nPLATFORM_WALLET=platform_fee_recipient_address\n```\n\n---\n\n## User Flows\n\n### Creator Flow (Milestone Campaign)\n\n```\n1. Connect Wallet\n         ↓\n2. Create Campaign with Milestones\n   • Set funding goal \u0026 duration\n   • Define up to 3 milestones\n   • Set percentage allocation per milestone\n         ↓\n3. Wait for Funding\n         ↓\n4. Campaign Succeeds (goal reached)\n         ↓\n5. Submit Milestone 1 for Approval\n         ↓\n6. Token Holders Vote (3 days)\n         ↓\n7. If Approved → Claim 30% (minus 2% fee)\n         ↓\n8. Repeat for Milestones 2 \u0026 3\n```\n\n### Investor Flow\n\n```\n1. Connect Wallet\n         ↓\n2. Browse Active Campaigns\n         ↓\n3. Pledge MNT\n         ↓\n4. Wait for Campaign End\n         ↓\n5. If Successful:\n   • Claim equity tokens\n   • Vote on milestone proposals\n   • Monitor fund releases\n         ↓\n6. If Failed:\n   • Claim full refund (100%)\n```\n\n### Governance Flow\n\n```\n1. Own equity tokens from campaign\n         ↓\n2. Creator submits milestone\n         ↓\n3. Vote on milestone proposal\n   • For: Approve milestone\n   • Against: Reject milestone\n         ↓\n4. After 3 days:\n   • Majority For → Funds released\n   • Majority Against → Milestone rejected\n         ↓\n5. If all milestones rejected → Emergency refund available\n```\n\n---\n\n## API Reference\n\n### Campaign Data Structure\n\n```typescript\ninterface Campaign {\n  creator: string;           // Creator address\n  goal: bigint;              // Funding goal (wei)\n  pledged: bigint;           // Current pledged (wei)\n  startAt: bigint;           // Start timestamp\n  endAt: bigint;             // End timestamp\n  claimed: boolean;          // Funds claimed (non-milestone)\n  equityToken: string;       // Token contract address\n  name: string;              // Campaign name\n  tokenSymbol: string;       // Token symbol\n  founderShareBps: bigint;   // Founder share (basis points)\n  founderTokensClaimed: boolean;\n  milestoneCount: bigint;    // Number of milestones\n  releasedAmount: bigint;    // Total released (wei)\n  hasMilestones: boolean;    // Is milestone campaign?\n}\n```\n\n### Milestone Data Structure\n\n```typescript\nenum MilestoneStatus {\n  Pending = 0,    // Not yet submitted\n  Voting = 1,     // Vote in progress\n  Approved = 2,   // Vote passed\n  Rejected = 3,   // Vote failed\n  Released = 4,   // Funds released\n}\n\ninterface Milestone {\n  title: string;\n  description: string;\n  percentage: bigint;     // Basis points (3000 = 30%)\n  deadline: bigint;       // Unix timestamp\n  status: MilestoneStatus;\n  proposalId: bigint;     // Linked governance proposal\n}\n```\n\n---\n\n## Security\n\n- **ReentrancyGuard**: All fund transfers protected\n- **Checks-Effects-Interactions**: State updated before external calls\n- **Access Control**: Role-based restrictions on sensitive functions\n- **Escrow Pattern**: Funds held until governance approval\n- **No Direct Transfers**: `receive()` function rejects direct MNT\n- **Sequential Milestones**: Must complete in order (1 → 2 → 3)\n\n---\n\n## Network Information\n\n| Property | Value |\n|----------|-------|\n| Network | Mantle Sepolia Testnet |\n| Chain ID | 5003 |\n| RPC URL | https://rpc.sepolia.mantle.xyz |\n| Explorer | https://sepolia.mantlescan.xyz |\n| Faucet | https://faucet.sepolia.mantle.xyz |\n| Native Token | MNT |\n\n---\n\n## Testing\n\n```bash\n# Run all 40 contract tests\nnpm run test\n\n# Expected output:\n# MilestoneEscrow - 26 passing\n# GovernanceV2 - 14 passing\n```\n\n---\n\n## Roadmap\n\n| Phase | Timeline | Features |\n|-------|----------|----------|\n| **Core Enhancement** | Q1 2025 | Mainnet deployment, Stablecoin support (USDT/USDC), Project whitepaper |\n| **Compliance \u0026 Trust** | Q2 2025 | KYC integration, Creator verification, Accredited investor tier |\n| **Trading Ecosystem** | Q3-Q4 2025 | Secondary market for tokens, Bybit partnership, xStock listing |\n| **Scale \u0026 Expand** | 2026 | Cross-chain support, Mobile app, Platform DAO |\n\n### Revenue Model\n\n| Stream | Description |\n|--------|-------------|\n| Platform Fee | 2% on released funds (currently implemented) |\n| Premium Features | Creator analytics, campaign promotion |\n| KYC Services | Identity verification fees |\n| Trading Fees | Secondary market transaction fees |\n\n---\n\n## Team\n\n| Name | Role | Contact |\n|------|------|---------|\n| **hoddukzoa** | Full-stack Developer | [GitHub](https://github.com/hoddukzoa12) |\n\n---\n\n## Compliance Declaration\n\nThis project does not involve regulated securities or financial assets. Equity tokens issued are governance tokens for voting purposes only and do not represent ownership or profit-sharing rights in any legal entity. Deployed on Mantle Sepolia Testnet for demonstration purposes.\n\n---\n\n## License\n\nMIT License\n\n---\n\n## Acknowledgments\n\n- [Mantle Network](https://mantle.xyz) - L2 scaling solution\n- [Thirdweb](https://thirdweb.com) - Web3 development framework\n- [OpenZeppelin](https://openzeppelin.com) - Smart contract security\n- [Shadcn/ui](https://ui.shadcn.com) - UI components\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhoddukzoa12%2Fcrowdmantle","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhoddukzoa12%2Fcrowdmantle","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhoddukzoa12%2Fcrowdmantle/lists"}