Governance Quickstart

​

Choose Your Governance Path

• Tight Control to Start: Begin with a restrictive configuration—set high proposal thresholds or require proposals to originate from a designated manager role. This ensures stability, refined decision-making, and controlled growth in your early stages.
• Incremental Opening of Access: As your community gains confidence and experience, use Agora’s tools to systematically lower thresholds and expand proposal rights. Transition decision-making power from a trusted core to the broader community.
• Progressive Onchain Expansion: Start with low-risk onchain actions—such as updating parameters or distributing small grants—to build trust and validate your governance framework. Gradually expand to encompass treasury management, infrastructure upgrades, and critical parameters.

​

Deploy your token

​

Using an Existing Token

• Fast integration with Agora’s governance system.
• Leverages an existing, recognized token within your ecosystem.
• Reduces development time and cost by skipping token creation.

• Ensure your token aligns with your governance goals (e.g., holder distribution and utility).
• Assess whether the current token design supports advanced features like delegation or partial delegation.

​

Deploying a New Token

• Tailor the token to align with your DAO’s vision and governance requirements.
• Seamlessly integrate features like partial delegation or specific voting thresholds.
• Opportunity to design a tokenomics model optimized for your community.

• Developing a new token requires thoughtful planning around distribution, utility, and compliance.
• Launch timing is critical—ensure readiness for the transition to governance.

​

Facilitating Token Distribution with Agora Token Launch

1. MiCA-Compliant Initial Coin Offering (ICO):
   • Launch your token in compliance with EU regulations for transparent and secure distribution.
   • Attract contributors with a legally sound framework.
2. Token Claims:
   • Soft Claim: Your DAO handles the gas fees, ensuring a seamless claim process for participants.
   • Hard Claim: Users pay their own gas fees to claim tokens, reducing cost burdens for the DAO.
   • Mixed Claim: Combine both methods to offer flexibility for your community.

• Clear, structured distribution methods tailored to your DAO’s needs.
• Builds trust and accessibility with compliant and efficient launch mechanisms.
• Flexibility to adapt to varying levels of user engagement and technical expertise.

• Token claims require precise configuration to ensure smooth execution.
• Compliance and transparency are critical—errors can damage trust and governance credibility.

​

Final Advice

​

Deploy the Governor

git clone https://github.com/voteagora/agora-governor.git
cd agora-governor

​

Install Foundry

curl -L https://foundry.paradigm.xyz | bash
foundryup

​

Install dependencies

forge install

​

Configure the Environment

cp .env.example .env

• Private key for the deployment wallet
• RPC URL for the Ethereum node you’ll connect to
• Contract-specific settings

​

Build the contracts

forge build

​

Write the Deployment Script

// SPDX-License-Identifier: MIT
pragma solidity ^0.8.17;

import "forge-std/Script.sol";
import "../src/AgoraGovernor.sol";

contract DeployAgoraGovernor is Script {
    function run() external {
        uint256 deployerPrivateKey = vm.envUint("PRIVATE_KEY");
        vm.startBroadcast(deployerPrivateKey);

        IVotesUpgradeable votingToken = IVotesUpgradeable(vm.envAddress("VOTING_TOKEN_ADDRESS"));
        address admin = vm.envAddress("ADMIN_ADDRESS");
        address manager = vm.envAddress("MANAGER_ADDRESS");
        TimelockControllerUpgradeable timelock = TimelockControllerUpgradeable(vm.envAddress("TIMELOCK_ADDRESS"));
        IProposalTypesConfigurator proposalTypesConfigurator = IProposalTypesConfigurator(vm.envAddress("PROPOSAL_CONFIGURATOR_ADDRESS"));

        AgoraGovernor governor = new AgoraGovernor();
        governor.initialize(votingToken, admin, manager, timelock, proposalTypesConfigurator, new IProposalTypesConfigurator ProposalType        
        vm.stopBroadcast();
    }
}

​

Deploy the contracts

forge script script/DeployAgoraGovernor.s.sol --rpc-url <RPC_URL> --broadcast --verify

​

Verify the deployment

1. Check the deployed contract addresses in the output of your script.
2. Use a blockchain explorer (e.g., Etherscan) to verify the contracts were deployed correctly.
3. Interact with the contract’s methods to confirm its initialization, such as retrieving the votingToken or admin address.

​

Next Steps

1. Use Agora’s open source client as a starting place Visit Agora Next to access a pre-built client designed to seamlessly work with Agora Governor. This client provides an open source solution to serve your governance app, complete with core features like proposal creation, voting, and results visualization. It’s the fastest way to get started and ensures you’re using a trusted, tested solution. You will need to modify the data endpoints and roll your own database, but if you are a skilled developer and willing to put in the time you can make it happen with this as a starting point. We accept PRs too 🥳.
2. Roll Your Own Custom Client If you prefer building your own governance interface, all data emitted by Agora Governor contracts can be indexed and stored by you. Use this data to design and develop a bespoke governance app tailored to your community’s unique needs. With Agora, you have full flexibility to innovate and create something amazing.