| name | dao-scaffold |
| description | Scaffold a new DAO into the governance calldata verification system. Creates directory structure, interfaces, base test class, and registry entry. Use when adding support for a new DAO. |
| disable-model-invocation | true |
| argument-hint | <dao-name> |
DAO Scaffold
Scaffold the complete directory structure and boilerplate for adding a new DAO.
Full guide: docs/ADDING_A_NEW_DAO.md
Prerequisites
Before starting, gather:
- DAO name and governance type (OZ Governor+Timelock or Azorius)
- Governor/Azorius contract address
- Timelock/Treasury contract address
- Governance token address
- Chain (mainnet, arbitrum, etc.)
- Tally slug (from URL:
tally.xyz/gov/{slug})
- Proposer address with enough tokens
- 10+ voter addresses that together achieve quorum
Steps
1. Create directory structure
mkdir -p src/$ARGUMENTS/interfaces src/$ARGUMENTS/helpers src/$ARGUMENTS/proposals
2. Add remapping
Append to remappings.txt:
@$ARGUMENTS/=src/$ARGUMENTS/
3. Extract interfaces
cast interface GOVERNOR_ADDRESS --chain mainnet -n IGovernor > src/$ARGUMENTS/interfaces/IGovernor.sol
cast interface TIMELOCK_ADDRESS --chain mainnet -n ITimelock > src/$ARGUMENTS/interfaces/ITimelock.sol
cast interface TOKEN_ADDRESS --chain mainnet -n IToken > src/$ARGUMENTS/interfaces/IToken.sol
Clean up: add SPDX header, set pragma solidity >=0.8.25 <0.9.0;, keep only needed functions.
4. Write base test class
For Governor+Timelock DAOs: use src/ens/ens.t.sol as the template. For Azorius DAOs: use
src/shutter/shutter.t.sol as the template.
Create src/$ARGUMENTS/$ARGUMENTS.t.sol inheriting CalldataComparison from @contracts/base/CalldataComparison.sol.
5. Add to DAO registry
Add a new key under daos in src/dao-registry.json. See docs/ADDING_A_NEW_DAO.md for the full schema.
6. Verify
forge build --skip script
7. Validate with first proposal
Find a recently executed proposal on Tally, fetch its data, write a test, verify it passes.
8. Commit
git add src/$ARGUMENTS/ remappings.txt src/dao-registry.json
git commit -m "feat($ARGUMENTS): scaffold DAO governance test infrastructure"
