https://github.com/aeternity/aepp-governance

Aeternity Governance Aepp
https://github.com/aeternity/aepp-governance

aepp aeternity blockchain delegation poll signaling

Last synced: about 2 months ago
JSON representation

Aeternity Governance Aepp

• Host: GitHub
• URL: https://github.com/aeternity/aepp-governance
• Owner: aeternity
• License: isc
• Created: 2019-07-22T20:17:28.000Z (over 5 years ago)
• Default Branch: master
• Last Pushed: 2024-07-15T12:30:41.000Z (6 months ago)
• Last Synced: 2024-07-16T11:29:43.005Z (6 months ago)
• Topics: aepp, aeternity, blockchain, delegation, poll, signaling
• Language: JavaScript
• Homepage: https://governance.aeternity.com/
• Size: 52.1 MB
• Stars: 2
• Watchers: 7
• Forks: 7
• Open Issues: 9
• Metadata Files:
  • Readme: Readme.md
  • License: LICENSE
  • Governance: governance-aepp/.dockerignore

Awesome Lists containing this project

README

        
# Governance Aepp

This repository will hold the full system used for the aeternity polling system.

It consists of the used smart contracts, including their tests.

A trustless backend service used for aggregation and caching of results for better presentation.

Additionally, there will be an frontend-aepp that allows for user-friendly registration, discovery and participation in polls.

## Resources

 - [GUIDE: How to verify results](./docs/how-to-verify-results.md)

 - [GUIDE: How to run governance locally](./docs/how-to-run.md)

 - [GUIDE: How the governance contract works](./docs/how-to-governance-contract.md)

 - [GUIDE: How the governance backend works](./docs/how-to-governance-backend.md)

## Introduction

Earlier this year there was a proposal to include a polling system directly in the aeternity protocol, in [Polling System Protocol](https://github.com/aeternity/protocol/blob/gov/POLLING_SYSTEM.md), but this was not finalized yet.

This project aims to build a first version of the aeternity polling system as smart contract and aepp to explore governance models better, so in a later stage a more informed decision can be made of what to include on protocol level.

 

The governance aepp will implement a delegated weighted polling mechanism, polls and votes will be registered on-chain together with minimal meta information.

Discussions about poll proposals should happen off-chain, e.g. the aeternity forum.

Due to building this as smart contract system a few limitations are introduced, for example the final poll results will not be published within the smart contract, but will be verifiable using external scripts.

 

## Rules

 - Poll voting options are non-binary but limited to one vote per account or delegatee

 - There can only be one delegation from one account, but multiple for one account 

 - Delegations are global and permanent, meaning one delegation is in effect for all polls

 - Delegations can be updated and revoked at any time by the delegator

 - Delegations can be recursive

 - Voting on polls does overwrite a delegation from this account for the single poll

 - Votes can be updated and revoked until a poll is closed

 - A poll is counted with the state of its closing height, meaning considering the active delegations and account stakes at this height

 - The closing height is defined on poll creation, but is optional to be able to create ongoing signaling systems

## Ideas

 - Each poll should be a single smart contract and in the future there could be multiple registries that provide different views on the same polls

 - Standardizing the polling system as aeternity aexpansion could yield more powerful alternative implementations without breaking compatibility in the future

 - Certain events should be logged in the smart contract to be able to listen for them