VenturePilot Smart Contracts 🎯

A milestone-based funding platform with jury voting system for early-stage projects. Built with Factory Pattern for scalability and advanced governance features.

🏗️ VenturePilot Ecosystem

Repository	Description	Status
Frontend	Next.js web application with React & Material-UI	✅ Active
Backend	AI Multiagent system for deck and document analysis	✅ Active
Smart Contracts	Solidity contracts with Hardhat & TypeScript	✅ Active

🌟 Overview

VenturePilot revolutionizes early-stage project funding by implementing a milestone-based approach where investors commit funds that are only released when specific project milestones are approved by an authorized jury. This system ensures accountability, reduces risk, and enables partial funding with community governance.

🏗️ Architecture

graph TB
    subgraph "Factory Layer"
        Factory[VenturePilotFactory]
        Factory --> AuthorizeJurors[Authorize Jurors]
        Factory --> CreateRounds[Create Rounds]
        Factory --> TrackRounds[Track Rounds]
    end
    
    subgraph "Round Layer"
        Round1[VenturePilotRound #1]
        Round2[VenturePilotRound #2]
        RoundN[VenturePilotRound #N]
    end
    
    subgraph "Governance"
        Jury[Jury Members]
        Community[Community Triggers]
        Founders[Project Founders]
        Investors[Investors]
    end
    
    Factory --> Round1
    Factory --> Round2
    Factory --> RoundN
    
    Jury --> Round1
    Jury --> Round2
    Jury --> RoundN
    
    Community --> Round1
    Community --> Round2
    Community --> RoundN
    
    Founders --> Round1
    Founders --> Round2
    Founders --> RoundN
    
    Investors --> Round1
    Investors --> Round2
    Investors --> RoundN
    
    classDef factory fill:#e1f5fe,stroke:#0277bd,stroke-width:2px
    classDef round fill:#f3e5f5,stroke:#7b1fa2,stroke-width:2px
    classDef governance fill:#e8f5e8,stroke:#388e3c,stroke-width:2px
    
    class Factory factory
    class Round1,Round2,RoundN round
    class Jury,Community,Founders,Investors governance

🎯 System Flow

sequenceDiagram
    participant F as Factory Owner
    participant Founder as Project Founder
    participant Investor as Investor
    participant Jury as Jury Member
    participant Community as Community
    participant Round as Round Contract
    
    F->>+Factory: authorizeJuror(juror)
    Factory-->>-F: ✅ Juror authorized
    
    Founder->>+Factory: createFundingRound(token, amount, deadline, milestones)
    Factory->>+Round: Deploy new round
    Round-->>-Factory: Round created
    Factory-->>-Founder: Round ID & Address
    
    Founder->>+Round: whitelistInvestor(investor)
    Round-->>-Founder: ✅ Investor whitelisted
    
    Investor->>+Round: invest(amount)
    Round-->>-Investor: ✅ Investment recorded
    
    Note over Round: Funding deadline reached
    Round->>Round: Move to Execution Phase
    
    Community->>+Round: triggerMilestoneDeadline(milestoneId)
    Round-->>-Community: ✅ Voting started
    
    Jury->>+Round: castJuryVote(milestoneId, approve)
    Round-->>-Jury: ✅ Vote recorded
    
    Note over Round: Jury approves milestone
    
    Founder->>+Round: completeMilestone(milestoneId)
    Round-->>-Founder: ✅ Milestone completed
    
    Note over Round: 24h verification delay
    
    Founder->>+Round: releaseFunds(milestoneId)
    Round-->>-Founder: 💰 Funds released

✨ Key Features

🎯 Funding & Governance

📊 Partial Funding: Rounds can proceed with partial funding
🗳️ Jury Voting: 3 authorized wallets decide milestone approval
⏰ Deadline System: Specific deadlines per milestone
🚫 Restricted Voting: Only jury can vote (not founders/investors)
🔄 Community Triggers: Anyone can activate deadline voting

🔐 Security & Controls

🏭 Factory Pattern: Scalable and gas-optimized deployment
🛡️ Security First: ReentrancyGuard, SafeERC20, comprehensive validations
🚨 Emergency Features: Pause, cancel, withdrawal protections
💰 Proportional Release: Funds released proportionally to funding achieved

💡 User Experience

👥 Whitelist System: Founder-controlled investor access
🔄 Multiple Rounds: Independent rounds per project
📈 Transparent Tracking: Full visibility of funding and milestones
⚡ Automatic Transitions: Smart phase management

🚀 Quick Start

# Clone and setup
git clone https://github.com/TomasDmArg/money-mule-contracts.git
cd money-mule-contracts
npm install

# Compile contracts
npm run compile

# Run tests
npm run test

# Deploy demo system
npm run deploy:factory

📦 Deployed Contracts

🏭 Factory System

Contract	Address	Network
VenturePilotFactory	`0xa1820208Dff37B39a8a324e82E3449283e21703b`	Saga Chainlet
USDC Token	`0xA2bE65F0Bfb810eF7B17807F3cd10D428f989A4a`	Saga Chainlet

🌐 Network Details

Parameter	Value
Chain ID	2751721147387000
RPC URL	https://moneymule-2751721147387000-1.jsonrpc.sagarpc.io
Explorer	https://moneymule-2751721147387000-1.sagaexplorer.io

📚 Documentation

📖 Detailed Guides

📋 Smart Contract Documentation - Complete technical documentation
🪙 USDC Token Guide - Token deployment and configuration

🎯 Core Workflow

1. Setup Phase

// Factory owner authorizes jurors
await factory.authorizeJuror(juror1.address);
await factory.authorizeJuror(juror2.address);
await factory.authorizeJuror(juror3.address);

2. Round Creation

// Founder creates funding round
const milestones = [{
  description: "MVP Development",
  fundingAmount: ethers.parseEther("40"),
  deadline: fundingDeadline + 86400,
  juryWallets: [juror1, juror2, juror3]
}];

const [roundId, roundContract] = await factory.createFundingRound(
  tokenAddress,
  ethers.parseEther("100"),
  fundingDeadline,
  milestones
);

3. Investment Phase

// Founder whitelists investors
await round.whitelistInvestor(investor.address);

// Investors contribute funds
await round.invest(ethers.parseEther("50"));

4. Milestone Execution

// Community triggers milestone deadline
await round.triggerMilestoneDeadline(1);

// Jury votes on milestone completion
await round.castJuryVote(1, true);  // Approve

// Founder completes milestone
await round.completeMilestone(1);

// Funds released after verification delay
await round.releaseFunds(1);

🧪 Testing

Test Suite

# Run all tests
npm run test

# Run with coverage
npm run test:coverage

# Clean and rebuild
npm run clean && npm run compile

Test Coverage

✅ Factory management & juror authorization
✅ Round creation & validation
✅ Funding phase & investor whitelisting
✅ Jury voting system & deadline triggers
✅ Milestone completion & fund release
✅ Investment withdrawal & edge cases
✅ Complete lifecycle integration tests

🚀 Deployment Scripts

Available Scripts

# 🏭 Factory Deployment
npm run deploy:factory          # Full demo deployment
npm run deploy:production       # Production deployment
npm run manage:factory          # Post-deployment management

# 🎬 Demo & Testing
npm run demo:factory           # Complete lifecycle demo
npm run demo:factory:local     # Local demo

# 🪙 USDC Token
npm run deploy:usdc            # Deploy USDC token
npm run mint:usdc              # Mint USDC tokens

Environment Setup

# Required
PRIVATE_KEY=your-private-key-here
FACTORY_ADDRESS=0xa1820208Dff37B39a8a324e82E3449283e21703b

# For demo accounts
PRIVATE_KEY_2=second-account-private-key
PRIVATE_KEY_3=third-account-private-key

# Network configuration
SAGA_RPC_URL=https://moneymule-2751721147387000-1.jsonrpc.sagarpc.io

📋 Smart Contract API

VenturePilotFactory

// Core Functions
function createFundingRound(
    address token,
    uint256 targetAmount,
    uint256 fundingDeadline,
    MilestoneData[] calldata milestones
) external returns (uint256 roundId, address roundContract);

function authorizeJuror(address juror) external;
function revokeJuror(address juror) external;

// View Functions
function getRoundContract(uint256 roundId) external view returns (address);
function getFounderRounds(address founder) external view returns (uint256[] memory);
function isAuthorizedJuror(address juror) external view returns (bool);

VenturePilotRound

// Investment Functions
function whitelistInvestor(address investor) external;
function invest(uint256 amount) external;
function withdrawInvestment(uint256 amount) external;

// Milestone Functions
function triggerMilestoneDeadline(uint256 milestoneId) external;
function castJuryVote(uint256 milestoneId, bool approve) external;
function completeMilestone(uint256 milestoneId) external;
function releaseFunds(uint256 milestoneId) external;

🔒 Security Features

Built-in Protections

🛡️ Reentrancy Guard: All critical functions protected
🔐 Access Control: Role-based permissions with validation
✅ Input Validation: Comprehensive parameter checking
🚨 Emergency Controls: Pause, cancel, emergency recovery
💎 Safe Transfers: OpenZeppelin SafeERC20 implementation

Governance Security

🎯 Voting Isolation: Only authorized jury members can vote
⏰ Time Controls: Deadlines and verification delays
🔄 Transparent Process: All actions emit comprehensive events
💰 Fund Protection: Multiple withdrawal conditions and safeguards

🎮 Demo Scenarios

Successful Funding

graph LR
    A[Create Round] --> B[Whitelist Investors]
    B --> C[Receive Funding]
    C --> D[Trigger Milestone]
    D --> E[Jury Votes]
    E --> F[Complete Milestone]
    F --> G[Release Funds]
    
    classDef success fill:#e8f5e8,stroke:#388e3c,stroke-width:2px
    class A,B,C,D,E,F,G success

Partial Funding

graph LR
    A[Create Round] --> B[Partial Funding]
    B --> C[Proportional Milestones]
    C --> D[Scaled Fund Release]
    
    classDef partial fill:#fff3e0,stroke:#f57c00,stroke-width:2px
    class A,B,C,D partial

Milestone Rejection

graph LR
    A[Trigger Milestone] --> B[Jury Votes]
    B --> C[Milestone Rejected]
    C --> D[Investor Withdrawal]
    
    classDef rejected fill:#ffebee,stroke:#d32f2f,stroke-width:2px
    class A,B,C,D rejected

🏆 Built For ETH Global Cannes 2025

Tech Stack

🔨 Hardhat 3: Development framework
🛡️ OpenZeppelin: Security standards
⚡ Ethers.js v6: Ethereum library
🌐 Saga Chainlet: Deployment network
📝 TypeScript: Type safety

Innovation Highlights

🏭 Factory Pattern: Scalable round deployment
⚖️ Jury Governance: Decentralized milestone approval
📊 Partial Funding: Flexible funding thresholds
🔄 Community Triggers: Permissionless deadline activation

🤝 Contributing

Fork the repository
Create feature branch (git checkout -b feature/amazing-feature)
Commit changes (git commit -m 'Add amazing feature')
Push to branch (git push origin feature/amazing-feature)
Open Pull Request

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

📋 Key Principles

💰 Funding Restriction: Only invest during funding phase
🗳️ Voting Restriction: Only authorized jury votes
⏰ Community Trigger: Anyone can activate deadline voting
💎 Proportional Release: Funds released proportionally to funding achieved
🚨 Emergency Safety: Owner controls for critical situations

🎉 Complete milestone-based funding with jury governance!

Name		Name	Last commit message	Last commit date
Latest commit History 18 Commits
.docs		.docs
contracts		contracts
docs		docs
ignition/modules		ignition/modules
scripts		scripts
test		test
types/ethers-contracts		types/ethers-contracts
.gitignore		.gitignore
README.md		README.md
hardhat.config.ts		hardhat.config.ts
package-lock.json		package-lock.json
package.json		package.json
tsconfig.json		tsconfig.json

Folders and files

Latest commit

History

Repository files navigation

VenturePilot Smart Contracts 🎯

🏗️ VenturePilot Ecosystem

🌟 Overview

🏗️ Architecture

🎯 System Flow

✨ Key Features

🎯 Funding & Governance

🔐 Security & Controls

💡 User Experience

🚀 Quick Start

📦 Deployed Contracts

🏭 Factory System

🌐 Network Details

📚 Documentation

📖 Detailed Guides

🎯 Core Workflow

1. Setup Phase

2. Round Creation

3. Investment Phase

4. Milestone Execution

🧪 Testing

Test Suite

Test Coverage

🚀 Deployment Scripts

Available Scripts

Environment Setup

📋 Smart Contract API

VenturePilotFactory

VenturePilotRound

🔒 Security Features

Built-in Protections

Governance Security

🎮 Demo Scenarios

Successful Funding

Partial Funding

Milestone Rejection

🏆 Built For ETH Global Cannes 2025

Tech Stack

Innovation Highlights

🤝 Contributing

📄 License

📋 Key Principles

About

Resources

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Packages