Clarity Docs
  • Introduction
  • DAO FUNDAMENTALS
    • Decentralized Autonomous Organizations
    • Decentralized Organizations
    • Agora Overview
  • Getting Started
    • Connecting Your Wallet
      • Setting Collateral
      • Switching Networks
      • Eternl DApp Browser
      • Register for Clarity
      • Brave Browser Connection Error
    • Using Clarity on Testnet
      • Minting Governance Tokens
    • Navigating Clarity
  • Clarity V1
    • Key Distinctions
      • Organizations vs Agora DAOs
      • Voting Power: Snapshot vs Agora
      • Polls vs Proposals
      • Snapshots vs Agora Proposals
      • Quests vs Raids
    • Creating an Organization
      • Finishing Setting Up Your Organization
    • Participating in an Organization
      • Creating a Governance Action
      • Voting on a Poll or Snapshot Proposal
        • Calculating Voting Power for Polls & Snapshot Proposals
        • Adding and Managing a Submission to an Open Poll
      • Quests and Raids
      • Admin Actions
        • Configure Governance Tokens
        • Configure Voting Power Calculations
        • Updating Governance Settings
        • Manage Membership, Badges, and Permissions
          • Creating/Updating a New Member Application Workflow
          • Creating and Managing Badges and Associated Permissions
          • Assigning Badges
          • Adding and Removing Admins
            • Adding Admin Error
            • Admins vs Super Admins
        • Updating Organization Information
      • Badge Member Actions
        • Approving Pending Governance Items
        • Creating and Managing Quests & Raids
        • Creating and Managing Rewards
    • Launching an Agora DAO
      • Finding your Governance Token Policy ID
      • Finding your Governance Hex Encoded Token Asset Name
    • Participating in a DAO
      • Staking
        • Creating and Editing Stakes
        • Removing Stake Locks
        • Delegating and Undelegating Stakes
      • Creating a Proposal
        • Proposal Templates
      • Voting on a Proposal
      • Depositing to Treasury
  • More Docs
    • Clarity API Docs
    • Clarity SDK Docs
Powered by GitBook
On this page
  • Agora Summary
  • Agora Concepts
  • Governance Token
  • Governor Contract
  • Stakes
  • Proposals
  • Votes
  1. DAO FUNDAMENTALS

Agora Overview

What is Agora, and how does it work?

PreviousDecentralized OrganizationsNextConnecting Your Wallet

Last updated 9 months ago

As mentioned on the Decentralized Autonomous Organizations page, DAOs transfer the trust from an individual or group to an audited smart contract when it comes to executing and enforcing collective decisions.

is the audited library of open-source governance scripts that allow for DAO creation and management, built specifically for Cardano. The protocol allows DAOs to operate completely on-chain, from spinning up to collectively managing funds and voting on proposals.

Agora Summary

Users deposit governance tokens into stakes, which allows them to create and vote on proposals. Voting weight is equal to the staked amount. Proposals specify smart contract effects on-chain that are executed if and only if the community-wide vote passes.

Examples of proposal smart contract effects include:

  1. Management of a treasury containing ADA and/or other assets.

  2. Changing on-chain parameters that are meaningful to the DAO. For example, changing the amount of GT required vote in favor of a proposal for it to execute.

  3. Swapping treasury assets.

  4. Staking DAO treasury assets.

In Agora, these effects are expressive and can be added to the system at any point. This is useful because it means proposals can adapt to changing needs and developments in the Cardano ecosystem.

Agora Concepts

This section gives a very high level overview of the parts of Agora that are most relevant to your experience using Clarity. For a more detailed overview of the inner-workings of Agora, see the .

Governance Token

The token that enables individuals to take governance actions in an Agora DAO. Each DAO designates its Governance Token when created, which can be any Cardano Native Asset. This asset is identified by the token's unique Policy ID and hex-encoded name. This means NFT collections don't work well as Governance Tokens, because the hex-encoded asset name of a collection will differ from token to token.

Governor Contract

This is the smart contract that enforces the governance rules of a DAO on-chain. This contract can be customized to fit an individual organization's needs. The following parameters are configurable and controlled by the governor contract:

  • Governance Token

    • The token used to grant governance power to DAO participants

  • Proposal Timing

  • Proposal Approval Threshold

    • The number of tokens that must be staked behind votes for a proposal for it to pass

  • User Participation Thresholds

    • The minimum amount of Governance Tokens a stake must hold to be used to either create or vote on a proposal.

  • Maximum Proposals per Stake

    • The maximum number of proposals one stake can be used to create.

  • Vote Cool Down Period

    • The amount of time that must pass after a DAO member submits a vote before they can retract it.

Stakes

Stakes are how voting power is calculated in Agora. Stakes lock a DAO member's Governance tokens in a smart contract to prevent double-counting votes.

An Agora DAO member's governance power in on-chain actions is equal to the number of governance tokens they have locked in their stake(s). This power will be used to ensure the user meets the User Participation Thresholds set by the governor contract and is used to weigh votes submitted using the stake.

Stake States

Stakes can be in several states which determine what can be done with them.

  • Locked: Proposals are Locked when they are being used in a vote. The stake can still be used to create and vote on other Proposals, but the Stake cannot be edited or deleted. To edit or delete stakes, all votes using that stake must be retracted.

  • Free: The stake can be used to create and vote on proposals. Governance Tokens behind the stake can be added or removed.

Proposals

DAO members create Proposals for the DAO using Stakes.

Proposals allow DAO participants to hold community-wide votes on-chain. When a proposal is created, it must explicitly define what its effects will be if the proposal is passed.

Agora allows for any combination of smart contracts to be effects of a proposal. A Proposal defines which effect(s) will run, and with what arguments. For example, a proposal could be created using the 'Treasury Spend' effect, with arguments that define which assets to send, how much, and to which addresses.

These effect smart contracts will execute as proposed if and only if the Proposal is passed by a community-wide vote.

Votes

DAO members cast Votes on Proposals using Stakes.

Votes are transactions that add a members's contribution to the Vote Tally and lock the Stake that was used to prevent double-voting.

Voting on multiple proposals is also made possible, since the only thing that is prevented when a lock is placed is withdrawing and depositing governance tokens.

Vote States

Votes can be in several states which determine what can be done with them and the Stakes they use.

The cadence at which all proposals will move through their

Cooling Down: The vote is not able to be retracted until the Vote Cool Down Period, as defined in the DAO's , has elapsed. The Stake being used for this vote is .

Submitted: The vote is recorded and the Vote Cool Down Period has passed. The vote can be retracted if the owner desires. The Stake being used for this vote is .

Retracted: The vote is removed and no longer counts towards the Vote Tally. The Stake that was used used for this vote is (assuming it is not Locked by any votes on other Proposals).

Agora
Agora Specs
Governor Contract
Locked
Locked
Available
stages