Agora is a set of Plutus scripts that compose together to form a governance system.
Goals:
- Agora aims to reduce duplication in Liqwid and LiqwidX and to serve as a one-size-fits-all governance library for projects on the Cardano blockchain.
- Agora aims to be modular and flexible for specific needs but presents an opinionated architecture.
Non-goals:
- Agora is not a DAO. It doesn't have tokenomics or even a token. It is simply a library for governance.
- Agora doesn't aim to provide any primitive tools for Plutus that are not governance-specific. For this, see plutus-extra.
An up to date version of the Nix package manager (>=2.3) is required to build this project. For information on how to install, see the NixOS website. Important: see also this section on binary caches.
Open a development shell with nix develop and build the project with cabal build. Those pained by the need to remember to enter a Nix shell may consider using nix-direnv.
Documentation for Agora may be found in docs.
Haddock is deployed on GitHub Pages here.
If you are a protocol wanting to use Agora, read Using Agora.
- Governor
- Treasury
- Staking pool
- Proposals
- Effects
- Rewards distribution
- Escrow staking pool solution
- ...
This section seeks to introduce to the reader the concept of governance systems on Cardano and acquaint them with the core components of a generic governance system.
A: A governance system is a component of a Cardano system, that allows for its community to issue and vote on proposals.
A: That depends on the Cardano protocol in-question. An example for a proposal could suggest that funds be released from a community treasury. Another might propose an alteration to some parameter in the wider-system.
A: The right to vote is conferred by the staking of some designated governance token (GT). If one owns the relevant token, they may 'stake' some of it to vote in favour of, or opposition to, some proposal.
More-detailed information on individual components will be included in their own, specific documentation. This section provides brief descriptions on the purpose of each component.
A user is a member of the DAO (decentralised autonomous organisation), who may choose to redeem governance tokens (GT) from the treasury and stake those GT to vote in favour of, or opposition to, proposals.
Governance tokens (GTs) are a currency, which confer the right to vote on proposals.
The treasury of a governance system is responsible for determining which users are entitled to what GT rewards and when. If a user is eligible for a reward, it they must claim it from the treasury. A treasury can also serve as a form of 'DAO wallet', storing and saving funds that can be later spent by the community.
Users are required to 'lock' their GT in stakes, so that the system has some idea of their eligibility to vote on proposal.
A proposal suggests for some specified changes to be made to a Cardano system. It is voted upon by the community and, if passed, its effects are applied to the system.
Proposals may have one or many 'effects', which represent the concrete, individual changes the proposal would make to the system. If their corresponding proposals have been passed, each effect is granted a governance authority token (GAT) by the governor. This token permits the effect to alter the system.
The governor is responsible for validating whether proposals have passed. If they have, it issues GATs to the proposals' effects.