Skip to content

Governance modules for Cardano protocols

License

Notifications You must be signed in to change notification settings

Liqwid-Labs/agora

Folders and files

NameName
Last commit message
Last commit date
Nov 1, 2022
Dec 8, 2022
Oct 19, 2022
Mar 4, 2023
Apr 24, 2023
Apr 24, 2023
Mar 24, 2023
Apr 24, 2023
Sep 16, 2022
Mar 24, 2023
Jan 12, 2022
Dec 7, 2022
Apr 24, 2023
Oct 31, 2022
Jan 13, 2022
Jan 20, 2023
Feb 27, 2024
Mar 24, 2023
Mar 30, 2023
Aug 12, 2022
Aug 26, 2024
Mar 22, 2023
Jan 12, 2022
Apr 27, 2022

Repository files navigation

Agora 🏛️

Agora is a set of Plutus scripts that compose together to form a governance system.

What is Agora

Goals:

  • Agora aims to reduce duplication in Liqwid and XplorerDAO 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 liqwid-plutarch-extra.

Project setup

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.

agora-scripts HTTP export server

To use scripts in a frontend, you can use the agora-scripts executable which allows you to query them on-demand.

The CTL repo agora-offchain already has the setup prepared for this feature.

In order to run the server, simply run the following command:

cabal run agora-scripts -- --enable-cors-middleware

Documentation

Documentation for Agora is hosted on Notion. You can find the specs here.

Using Agora for your protocol

If you are a protocol wanting to use Agora, read Using Agora.

Contributing

Please read CONTRIBUTING.md. Additionally, please follow the Git policy when contributing to this project.

Overview of components

Road-map

v1

  • Governor
  • Treasury
  • Stakes
  • Proposals
  • Effects

v2

  • Flexible scripts using TxT pattern integrated with governance
  • Different voting mechanisms

Available support channels info

You can find help, more information and ongoing discusion about the project here:

About

Governance modules for Cardano protocols

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages