Skip to content
/ v2-core Public

CreateDAO v2 core smart contracts built on top of OpenZeppelin OZ Governor

License

MIT license
0 stars 0 forks Branches Tags Activity
Star
Notifications You must be signed in to change notification settings

createDAO/v2-core

BranchesTags

Repository files navigation

createDAO v2

A comprehensive DAO creation and management platform built on EVM-compatible blockchains using OpenZeppelin Governance.

License: MIT Solidity OpenZeppelin Hardhat

About v2

This is a complete rewrite of createDAO, rebuilt from the ground up using OpenZeppelin's battle-tested governance contracts. Version 2 prioritizes security and simplicity by leveraging the industry-standard OZ Governor pattern rather than custom governance implementations.

Features

  • OpenZeppelin Governance: Built on proven, audited governance contracts
  • EIP-1167 Minimal Proxies: Gas-efficient DAO deployment using clone pattern
  • Deterministic Deployment: CREATE2 for predictable contract addresses across chains
  • Auto-Delegation: Voting power automatically activated on token receipt
  • Manager Role: On-chain authorization for off-chain DAO operations
  • TimelockController Treasury: Secure fund management with execution delay

Architecture

┌─────────────────────────────────────────────────────────────────────────────┐
│                              DAOFactory                                     │
│  - Deploys implementations in constructor (tokenImpl, governorImpl)         │
│  - Creates complete DAO systems via Clones                                  │
│  - Tracks all deployed DAOs                                                 │
└─────────────────────────────────┬───────────────────────────────────────────┘
                                  │ createDAO()
                                  ▼
              ┌───────────────────┼───────────────────┐
              │                   │                   │
              ▼                   ▼                   ▼
    ┌─────────────────┐  ┌──────────────────┐  ┌──────────────────┐
    │ DAOToken (Proxy)│  │TimelockController│  │DAOGovernor(Proxy)│
    │   EIP-1167      │  │   (Treasury)     │  │   EIP-1167       │
    │                 │  │                  │  │                  │
    │ ERC20Votes      │  │ Holds 99% tokens │  │ Governor         │
    │ ERC20Permit     │  │ 1-day delay      │  │ Settings         │
    │ Auto-delegate   │  │                  │  │ Counting         │
    │                 │  │                  │  │ Votes/Quorum     │
    │ 1% → Creator    │  │                  │  │ Timelock         │
    │ 99% → Treasury  │  │                  │  │                  │
    └─────────────────┘  └──────────────────┘  └──────────────────┘

Core Contracts

Contract Description
DAOFactory Factory for deploying complete DAO systems via minimal proxies
DAOToken ERC20 governance token with voting power and auto-delegation
DAOGovernor Governor contract with timelock integration and manager role
TimelockController Treasury holding 99% of tokens with execution delay

Governance Settings

Setting Value Description
Creator Allocation 1% Tokens sent to DAO creator (auto-delegated)
Treasury Allocation 99% Tokens held in TimelockController
Quorum 1% Minimum participation for valid proposals
Proposal Threshold 1% Tokens required to create proposals
Timelock Delay 1 day Execution delay after proposal passes
Token Decimals 18 Standard ERC20 decimals

Deployments

Deployed using Arachnid’s deterministic CREATE2 deployer, so the DAOFactory address is identical across chains when the salt + initCodeHash are the same.

Base (Mainnet)

Contract Address Explorer
DAOFactory 0xd141662F4b788F28B2a0769a6d3f243D046B571f View on Basescan
DAOToken Implementation 0xfAAB628eddeEC6093CCdB5288b865a8073ab55Db View on Basescan
DAOGovernor Implementation 0x2F81fb483fD1B578d16d41e92c62A365b4b04081 View on Basescan

Example DAO deployed on Base (from deployment record base-8453-2025-12-24T11-50-43.211Z.json)

Contract Address Explorer
DAOToken (Proxy / Clone) 0x154EB315Ab729E998847aA55F8b5bC73cf8A61d9 View on Basescan
DAOGovernor (Proxy / Clone) 0x4013cdFEB389A4213e8565258D2ac3604bFbB1B3 View on Basescan
TimelockController (Treasury) 0xb8CE0BbD2c5B589Da458677392B255E761E1A15F View on Basescan

Sepolia (Ethereum Testnet)

Contract Address Explorer
DAOFactory 0xd141662F4b788F28B2a0769a6d3f243D046B571f View on Etherscan
DAOToken Implementation 0xfAAB628eddeEC6093CCdB5288b865a8073ab55Db View on Etherscan
DAOGovernor Implementation 0x2F81fb483fD1B578d16d41e92c62A365b4b04081 View on Etherscan

Example DAO deployed on Sepolia (from deployment record sepolia-11155111-2025-12-24T11-25-23.612Z.json)

Contract Address Explorer
DAOToken (Proxy / Clone) 0x2F524705E04aFa3b450a8C60f04975630B6deff4 View on Etherscan
DAOGovernor (Proxy / Clone) 0x707e6c8d2C52C16eA4F93e41932b11e34814B4B0 View on Etherscan
TimelockController (Treasury) 0x2cA78756658e85DC5F175363553225881e8537FC View on Etherscan

Deployment Details (CREATE2)

CREATE2 Deployer: 0x4e59b44847b379578588920cA78FbF26c0B4956C
Salt: CreateDAO_Production_v2_0_0
Salt Hash: 0x86e878d0db536a6fd426beb56994c299552f4885e0000a9bb0b08f46860e1fdb
Init Code Hash: 0xb88b2130abbf8e7570a958fcdc98f4143b26f2bd1d7ad95c56b62f31350f8485

Installation

# Clone the repository
git clone https://github.com/createDAO/v2-core.git
cd v2-core

# Install dependencies
npm install

Configuration

Create a .env file in the project root:

# Network RPC URLs
SEPOLIA_RPC_URL=https://rpc.ankr.com/eth_sepolia
BASE_RPC_URL=https://mainnet.base.org

# API Keys for contract verification
ETHERSCAN_API_KEY=your_etherscan_api_key

# Deployment wallet (use hardhat-keystore for production)
# PRIVATE_KEY=your_wallet_private_key

Secure Key Management

For production deployments, use Hardhat's keystore feature instead of plaintext private keys:

# Create encrypted keystore
npx hardhat keystore set deployer

# View keystore accounts
npx hardhat keystore list

Usage

Running Tests

Run the comprehensive test suite locally:

# Run all tests
npm test

# Run with Hardhat directly
npx hardhat test

# Run specific test file
npx hardhat test test/DAOFactory.test.ts

Deployment

Recommended Flow (Deploy then Verify)

  1. Deploy + Create DAO (writes a deployment record; no verification)
npx hardhat run scripts/flow/deploy-and-create.js --network sepolia

Optional:

FACTORY_SALT="my-production-salt" DEPLOYMENT_TAG="sepolia-smoke" npx hardhat run scripts/flow/deploy-and-create.js --network sepolia

This creates:

  • deployments/sepolia.latest.json
  • deployments/sepolia-<chainId>-<timestamp>.json
  1. Verify everything from the deployment record
npx hardhat run scripts/flow/verify-all.js --network sepolia

To verify a specific record:

DEPLOYMENT_FILE=deployments/sepolia-11155111-<timestamp>.json npx hardhat run scripts/flow/verify-all.js --network sepolia

Advanced: Deploy Factory Only (Deterministic)

npx hardhat run scripts/deploy/factoryDeterministic.js --network sepolia

Predict Address Before Deployment

npx hardhat run scripts/deploy/predictAddress.js

Creating a DAO

After the factory is deployed, you can create a new DAO:

const factory = await ethers.getContractAt("DAOFactory", FACTORY_ADDRESS);

const tx = await factory.createDAO({
  daoName: "My DAO",
  tokenName: "My DAO Token",
  tokenSymbol: "MDT",
  totalSupply: ethers.parseEther("1000000"), // 1M tokens
  votingDelay: 86400,    // 1 day in seconds
  votingPeriod: 604800   // 1 week in seconds
});

const receipt = await tx.wait();
// Parse DAOCreated event for contract addresses

Project Structure

createdao-contracts/
├── contracts/
│   ├── DAOFactory.sol      # Factory for deploying DAOs
│   ├── DAOGovernor.sol     # Governor with OZ extensions
│   └── DAOToken.sol        # ERC20 governance token
├── scripts/
│   ├── deploy/             # Deployment scripts
│   ├── flow/               # Complete workflow scripts
│   ├── utils/              # Utility functions
│   └── verify/             # Contract verification
└── test/
    ├── DAOFactory.test.ts  # Factory tests
    ├── DAOGovernor.test.ts # Governor tests
    ├── DAOToken.test.ts    # Token tests
    ├── helpers/            # Test utilities
    └── integration/        # Integration tests

Tech Stack

  • Hardhat 3.1.0 - Development environment
  • OpenZeppelin Contracts 5.4.0 - Governance and token standards
  • OpenZeppelin Contracts Upgradeable 5.4.0 - For minimal proxy pattern
  • Viem - TypeScript Ethereum library
  • TypeScript - Type-safe development

Documentation

License

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

Copyright 2025 CreateDAO

Contact

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

  1. Fork the Project
  2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
  3. Commit your Changes (git commit -m 'Add some AmazingFeature')
  4. Push to the Branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

⚠️ Note: This project is in active development. Mainnet deployments will be announced once the contracts have been thoroughly tested and audited.

About

CreateDAO v2 core smart contracts built on top of OpenZeppelin OZ Governor

Resources

Readme

License

MIT license
Activity
Custom properties

Stars

0 stars

Watchers

0 watching

Forks

0 forks
Report repository

Releases

1 tags

Packages

No packages published

Languages