Baal (Molochv3) is a minimal yet composable DAO template continuing work from the Moloch, Minion, Compound/OZ and Safe frameworks to make it easier for people to combine and command crypto assets with intuitive membership games.
Guilds, venture clubs and control panels can benefit from Baal:
If you are going to just use this project feel free to clone it. If you would like to submit any pull requests please create an issue or work on a current issue and fork the repo. The main groups that are contributing to this project are Moloch Mystics, DaoHaus MetaCartel.
yarn install
- to install all of the components for the project
This project uses the hardhat ethereum tools for solidity compiling and running a virtual ethereum environment for testing.
yarn build
- will compile the solidity code and generate your contract artifacts (in the /artifacts directory), and generate all of the necessary types.
the Baal contracts, types, and abis are published through the CI process, after making changes to the repo, and when you are ready to publish the packages, do the following:
- bump the version in
package.json
- push and merge into
feat/baalZodiac
branch
running the CI process will trigger on merges to feat/baalZodiac branch
build the dist folder and publish it to @daohaus/baal-contracts
package to npm if the package.json version is different than the current latest on npm.
If you are looking to work on unit tests for this project be sure to read the README file in the test directory.
npx hardhat test
- run the unit tests
is a minimal yet composable DAO template continuing work from the Moloch, Minion and Compound frameworks to make it easier for people to combine and command crypto assets with intuitive membership games.
EIP721 OZ Minimal Clone Factoy EIP 1167 Clones Gnosis Safe Module Zodiac
have direct execution, voting, and exit rights around actions taken by the main DAO contract. Shareholders are the collective DAO admins.
ERC20, Initializable OpenZeplin v4
abstract with a similar Implimentation of ERC20VOTES with the main difference being auto self-delegation and the use of timestmap instead of block.number.
ERC20Permit
has only exit rights against the DAO treasury, so loot does not have the ability to admin the DAO config. However, because it has exit rights, it is still a powerful unit, and because it is an ERC-20 can be used in many composable ways.
ERC20, ERC20Snapshot, ERC20Permit, Initializable OpenZeplin v4
is a helper contract for making tribute proposals. Provides contract to approve ERC-20 transfers. Provides a simple function/interface to make a single proposal type.
Factory to summon new dao contracts. It has 2 main functions one to deploy the dao contracts and the Safe treasury and one to use an existing Safe treasury.
- ./abi - generated abis
- ./contracts - main solidity contracts, interfaces, tools and utils
- ./scripts - deploy scripts and helpers
- ./tasks - hard hat cli tasks
- ./tests - test files
currently, coverage is turned off for test efficiency purposes. In order to switch coverage on, add yul
to the hardhat config:
{
...
compilers: [
{
version: "0.8.7",
settings: {
optimizer: {
enabled: true,
runs: 200,
details: {
yul: true
}
},
},
}
]
}
then run the coverage command:
npx hardhat coverage
- Shamans - are specific addresses that have more granular control outside the standard governance proposal flow. These addresses should always be contracts that have been explicitly given these rights through the standard proposal flow or during initial DAO setup.
- Governor - can cancel a proposal, set Governance Config (change the length of proposals, if there is a required quorum, etc.).
- Manager - can mint/burn shares/loot.
- Admin - can set Admin configuration and pause/unpause shares/loot.
- DAO - is always a super admin over its config and can vote to make changes to its configuration at any time.
- In case of Shaman keys leak, an attacker can get access to Baal (admin) functionalities, burn, mint, give shaman roles etc. Because of this Shamans are ment to be external contracts and not EOAs but it is up to the DAO to enforce this.
More docs for Functions and Events, V3 updates, patterns, stories and other superficial musings can be found at the Docs Page here
See audit notes in ./audits
beta release of the factories. These factories may change until we get to final stable release.
src/addresses/deployed.js