Zodiac Wiki

Gnosis Guild orb
Home

Introduction: Zodiac Protocol

Banner-gnosis-guild.jpg

What Is Zodiac?

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?

  • 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

  • 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

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

  • 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

  • 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.
  • 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.
  • 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.
  • 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.
  • 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

  • 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.

Guards

  • 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.
  • 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.

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

Resources

Questions?

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