Zodiac Wiki

[[File:banner-gnosis-guild.jpg]]

==What Is Zodiac?==

{{About Zodiac Protocol}}

The Zodiac open standard enables:

* '''Flexible''', module-based control of programmable accounts (avatars)
* '''Un-opinionated''' standards for programmable account interaction
* '''Reusable''' implementations of core and factory logic

To learn more about the ideas behind Zodiac, visit the [http://gnosisguild.mirror.xyz Gnosis Guild blog].

==Who Is Zodiac For?==

* '''[[:Category:DAO_Operator|DAO Operators]]:''' If you are a steward, admin, or manager of an organization with a [https://gnosis-safe.io Safe], use the collection of tools through the Zodiac App and read through the operator tutorials.

* '''[[:Category:DAO_Member|DAO Members:]]''' If you are a member of an organization that uses a Zodiac tool, read through the member tutorials.

* '''[https://github.com/gnosis/zodiac DAO Developers]:''' If you are a developer who is comfortable with the command line and would like to implement, modify, or build upon Zodiac, visit the developer tutorials [https://github.com/gnosis/zodiac here].

Anyone can contribute to the Zodiac-compliant collection of tools by submitting a pull request on the [https://github.com/gnosis/zodiac repository].

==The Zodiac Architecture==

* '''Avatars''' are programmable Ethereum accounts, like the [https://gnosis-safe.io/ Safe]. Avatars are the address that holds balances, owns systems, executes transaction; is referenced externally; and ultimately represents your DAO. Avatars must expose an interface like <code>IAvatar.sol</code>.

* '''Modules''' are contracts enabled by an Avatar that implement some decision making logic. They should import <code>Module.sol</code>.

* '''Modifiers''' are contracts that sit between Modules and Avatars to modify the Module's behavior. For example, they might enforce a delay on all functions a Module attempts to execute. Modifiers should import <code>Modifier.sol</code> and must expose an interface like <code>IAvatar.sol</code>.

* '''Guards''' are contracts that can be enabled on Modules and implement pre- or post-checks on each transaction that the Module executes. This allows Avatars to do things like limit the scope of addresses and functions that a module can call or ensure a certain state is never changed by a module. Guards should import <code>BaseGuard.sol</code>.



[[File:zodiac-protocol.jpg]]

==Zodiac-Compliant Tools==

Zodiac embraces [https://gnosis-safe.io/ Safe] (formerly Gnosis Safe) as a powerful, extensible and programmable account standard, which we call an '''avatar'''. The Zodiac App can be accessed through Safe. However, all Zodiac tools are framework agnostic, and they can be plugged into any programmable account that implements the [https://github.com/gnosis/zodiac/blob/master/contracts/interfaces/IAvatar.sol IAvatar] interface.

===Avatars===
* '''[https://gnosis-safe.io/ Safe]''' (formerly Gnosis Safe): The most trusted platform for managing digital assets on Ethereum. Zodiac embraces Safe as a powerful, extensible and programmable account standard. Safe is the reference implementation of the IAvatar.sol interface specified in this library. However, all Zodiac tools are framework agnostic, and they can be plugged into any programmable account that implements the IAvatar interface.

===Modules===
* '''[[:Category:Bridge_Module|Bridge]]''' (developed by [https://www.gnosisguild.org Gnosis Guild]): This module allows an address on one chain to control an avatar on another chain using an Arbitrary Message Bridge (AMB). This enables a DAO on one chain to control assets and interact with systems like a Safe on a different chain.
* '''[https://github.com/gnosis/zodiac-module-connext/ Connext Module]''' (developed by [https://www.connext.network Connext] + [https://www.gnosisguild.org Gnosis Guild]): This module enables crosschain governance, allowing an avatar to be the target of any arbitrary function call originating from a Safe on another domain (chain or rollup) using Connext, a modular protocol for cross-domain communication. [https://blog.connext.network/crosschain-governance-a-new-integration-connext-x-zodiac-gnosis-guild-5cf119a6cf2e Read more about the integration].
* '''[[:Category:Governor_Module|Governor]]''' (developed by [https://www.gnosisguild.org Gnosis Guild]): The module enables an OpenZeppelin Governor contract as a Safe module. By equipping the most popular on-chain governance framework as a module, a multisig can seamlessly transition into a multiplayer DAO with on-chain voting, while still maintaining flexibility and optionality. 
* '''[[:Category:Exit_Module|Exit]]''' (developed by [https://www.gnosisguild.org Gnosis Guild]): This module allows members to redeem a designated token, including an NFT, for a proportion of an avatar's digital assets, similar to Moloch DAO's rageQuit() function. Members can use the Exit App to redeem their tokens.
* '''[[:Category:Reality_Module|Reality]]''' (developed by [https://www.gnosisguild.org Gnosis Guild]): This module allows on-chain execution based on the outcome of events reported by the Reality.eth oracle. While built initially to execute Safe transactions according to Snapshot proposals, this module is framework agnostic. It can enable proposal execution from just about anywhere.
* '''[https://daohaus.substack.com/p/6991f40b-3931-47ff-bea3-fa6f9c365135?s=r Safe Minion]''' (developed by [https://daohaus.club DAOhaus]): This module allows Moloch DAOs to manage the assets in a Safe based on the outcome of v2 Moloch DAO proposals. Safe Minion enables Moloch DAOs to manage collections of NFTs, manage LP positions with AMMs, and initiate any other arbitrary interactions. It enables DAOs that start as a Safe to later delegate governance to a Moloch DAO.
* '''[https://github.com/gnosis/zodiac-module-siphon Siphon]''' (developed by [https://www.gnosisguild.org Gnosis Guild]): This module exposes a public interface that allows anyone to trigger an avatar to withdraw from a designated liquidity position to pay down some of its debt in a designated debt position, thereby improving the health of the position.
* '''[https://github.com/tellor-io/snapshot-zodiac-module Tellor Module]''' (developed by [https://tellor.io/ Tellor]): This module allows successful Snapshot proposals to execute transactions using the Tellor oracle.
* '''[https://docs.outcome.finance/optimistic-governance/what-is-the-optimistic-governor UMA Optimistic Governor Module]''' (developed by [https://www.outcome.finance/ Outcome Finance]): This module allows successful Snapshot proposals to execute transactions using UMA's optimistic oracle.
* '''[https://github.com/SekerDAO/Usul Usul]''' (developed by [https://sekerdao.com/ SekerDAO]): This module allows avatars to operate with trustless tokenized DeGov, similar to Compound or Gitcoin, with a time-boxed proposal core that can register swappable voting contracts. This enables DAOs to choose from various on-chain voting methods that best suit their needs.

===Modifiers===
* '''[https://assets.website-files.com/5fcaa3a6fcb269f7778d1f87/63567cc61762834da944c575_Kolektivo%20Bluepaper.pdf Badger Access Control (BAC)]''' (developed by [https://www.kolektivo.network/ Kolektivo]) is a fork of Gnosis Zodiac’s Roles Modifier. It enables a Safe to delegate the permission to call certain functions on behalf of the Safe to another externally owned address or smart contract. A so-called delegate can call specified functions without requiring the M of N consent of the associated Safe. As opposed to Zodiac’s original implementation which kept the record of delegates internally, BAC refers to an external ERC1155 token contract — the Badger — to determine if an address is a qualified delegate, namely by checking if that address holds the required badge — a type of NFT.
* '''[[:Category:Delay_Modifier|Delay]]''' (developed by [https://www.gnosisguild.org Gnosis Guild]): This modifier allows avatars to enforce a time delay between when a module initiates a transaction and when it can be executed by an avatar.
* '''[[:Category:Roles_Modifier|Roles]]''' (developed by [https://www.gnosisguild.org Gnosis Guild]): This modifier allows for fine-grained, role-based, access control for enabled modules. Scopes for a given role include allowed addresses, and optionally include allowed functions on allowed addresses, allowed parameters on allowed functions, whether or not delegate calls are allowed to an allowed address, and whether or not value (ETH) can be sent to an allowed address.
* '''[https://assets.website-files.com/5fcaa3a6fcb269f7778d1f87/63567cc61762834da944c575_Kolektivo%20Bluepaper.pdf SecretDelay]''' (developed by [https://www.kolektivo.network/ Kolektivo]) is a fork of Zodiac’s Delay Modifier. The original Delay modifier introduces a three step process for making Safe transactions: (1) authorized addresses can propose a transaction, then after a (2) pre-configured cooldown period passes, (3) the transaction becomes executable by anyone. During the cooldown period, the associated Safe can step in and dismiss a proposed transaction. SecretDelay extends these capabilities by adding two features: It allows to propose secret transactions by just submitting a hash of the transaction in the first step, and it introduces an acceleration mechanism where the associated Safe signers may approve transactions for immediate execution. The addition of these two features better serve a real-world user community, where certain transactions may need to be private or expedited in the event of an emergency without any major disruption to the functioning of a community economy.

===Guards===
* '''[https://github.com/gnosis/zodiac-guard-scope Scope]''' (developed by [https://www.gnosisguild.org Gnosis Guild]): This guard allows an avatar to limit the scope of the addressable functions with which its owners can interact. This enables the avatar to define granular permissions for different control mechanisms.
* '''Mod''' (developed by [https://www.gnosisguild.org Gnosis Guild]): This guard allows an avatar to prevent the removal of a given module. For example, a DAO might have its governance contracts enabled as a module to a Safe, in parallel with some multisig signers. This guard could be used to prevent the multisig signers from removing the DAO's governance contracts as a module.

Have you built something cool belonging to the Zodiac collection of tools and want to add it to the list? Open a PR!

==Resources==

* [[:Category:Documentation|Documentation]]
* [[FAQ: Zodiac Protocol]]

==Questions?==

Visit the [[Zodiac Protocol FAQ]]. If you need support or have questions about Zodiac, join the [https://discord.gg/gnosisguild Gnosis Guild Discord].

[[Category:Documentation]]