Fractal Contracts

Azorius Protocol

A Safe module which allows for composable governance.

Azorius conforms to the Zodiac pattern for Safe modules.

The Azorius contract acts as a central manager of DAO Proposals, maintaining the specifications of the transactions that comprise a Proposal.

All voting details are delegated to BaseStrategy implementations, of which an Azorius DAO can have any number.

Azorius was forked from and heavily based on the Usul module, by SekerDAO.

Contract Documentation

NatSpec documentation for Azorius Protocol contracts are available here.

Local Setup & Testing

Clone the repository:

``shell
git clone https://github.com/decent-dao/fractal-contracts.git
`

Look up the recommended Node version to use in the .nvmrc file and install and use the correct version:

`shell
nvm install
nvm use
`

Install necessary dependencies:

`shell
npm install
`

Copy the example .env and replace the values for the desired networks

`shell
cp .env.example .env
`

Compile contracts to create typechain files:

`shell
npm run compile
`

Run the tests

`shell
npm run test
`

Update natspec doc files after modifying contracts

`shell
npx hardhat docgen
`

Deploy Contracts to

`shell
npx hardhat deploy --network
`

Deployed contracts can be verified on Etherscan via the following command:

`shell
npx hardhat verify --network {network name} {contract address}
`

Currently, this is done manually for each contract deployed, found in deployments//XXX.json

Local Hardhat deployment

To deploy the Fractal contracts to a local node:

`shell
npx hardhat node
`

NPM Package

The core contracts in this repository are published in an NPM package for easy use within other repositories.

To install the npm package in your project, run:

`shell
npm i @fractal-framework/fractal-contracts
`

To include uncompiled contracts within typechain-types follow these steps.

Publishing new versions to NPM

1. Increment the version in package.json, then npm install to get those version updates into package-lock.json`.
1. Get those changes into the main branch through a PR.
1. Tag the merge commit with that version number you just bumped.
1. Create a Release on GitHub.

Versioning

Fractal follows a modified style of semantic versioning (https://semver.org/) specific to a smart contract use case.

There are three types of releases:

- MAJOR: Rare, and correlates to a major overhaul to the core DAO governance contracts. These are changes incompatible with prior contract versions and would require an existing DAO's successful proposal to migrate to. A major version will have undergone a professional smart contract audit.
- MINOR: Adds backwards-compatible functionality and additional utility or optimizations to the core governance smart contracts. New functionality will not impact the existing core governance contracts, will be optional for a DAO to utilize, and will have undergone either a contract audit or community bug bounty.
- PATCH: Also rare, but adds bug and/or security fixes. No new functionality will be introduced and the code may or may not have a contract audit or bug bounty, depending on the context and severity of the issue. Also depending on the context of the issue, DAOs may be required to pass a proposal to migrate to this new version.