Zodiac Wiki

Gnosis Guild orb
Home

Introduction: Zodiac Standard

Banner-gnosis-guild.jpg

What Is Zodiac?[edit]

The expansion pack for DAOs, Zodiac is a collection of tools built according to an open standard. The Zodiac open standard enables DAOs to act more like constellations, connecting protocols, platforms, and chains, no longer confined to monolithic designs.

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 Gnosis Guild blog.

Who Is Zodiac For?[edit]

  • DAO Operators: If you are a steward, admin, or manager of an organization with a Safe, use the collection of tools through the Zodiac App and read through the operator tutorials.
  • DAO Members: If you are a member of an organization that uses a Zodiac tool, read through the member tutorials.
  • 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 here.

Anyone can contribute to the Zodiac-compliant collection of tools by submitting a pull request on the repository.

The Zodiac Architecture[edit]

  • Avatars are programmable Ethereum accounts, like the 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 IAvatar.sol.
  • Modules are contracts enabled by an Avatar that implement some decision making logic. They should import Module.sol.
  • 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 Modifier.sol and must expose an interface like IAvatar.sol.
  • 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 BaseGuard.sol.


Zodiac-protocol.jpg

Zodiac-Compliant Tools[edit]

Zodiac embraces 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 IAvatar interface.

Avatars[edit]

  • 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[edit]

  • Bridge (developed by 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.
  • Connext (developed by Connext + Gnosis Guild): This module enables 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.
  • Governor (developed by 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.
  • Exit (developed by 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.
  • Reality (developed by 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.
  • Safe Minion (developed by 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.
  • Siphon (developed by 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.
  • Tellor (developed by Tellor): This module allows successful Snapshot proposals to execute transactions using the Tellor oracle.
  • UMA Optimistic Governor (developed by Outcome Finance): This module allows successful Snapshot proposals to execute transactions using UMA's optimistic oracle.
  • Usul (developed by 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[edit]

  • Badger Access Control (BAC) (developed by 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.
  • Delay (developed by 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.
  • Roles (developed by 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.
  • SecretDelay (developed by 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[edit]

  • Meta (developed by Cardstack): This guard allows an avatar to have multiple checking processes by registering multiple guards to this meta guard.
  • Mod (developed by 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.
  • Scope (developed by 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.

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

Resources[edit]

Questions?[edit]

Visit the Zodiac Standard FAQ. If you need support or have questions about Zodiac, join the Gnosis Guild Discord.