Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ChaosDAO-org/InternalGov-2.0
Monitor governance referendas on Polkadot/Kusama - Create a thread for each referenda for internal users to discuss before proxy account makes the vote.
https://github.com/ChaosDAO-org/InternalGov-2.0
Last synced: 9 days ago
JSON representation
Monitor governance referendas on Polkadot/Kusama - Create a thread for each referenda for internal users to discuss before proxy account makes the vote.
- Host: GitHub
- URL: https://github.com/ChaosDAO-org/InternalGov-2.0
- Owner: ChaosDAO-org
- License: apache-2.0
- Created: 2023-02-11T12:01:18.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2024-10-10T00:11:05.000Z (about 1 month ago)
- Last Synced: 2024-10-18T23:36:21.709Z (29 days ago)
- Language: Python
- Size: 721 KB
- Stars: 21
- Watchers: 1
- Forks: 14
- Open Issues: 9
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-dot - ChaosDAO OpenGov Bot
README
# ChaosDAO Governance bot
A dedicated discussion forum within your Discord server, specifically designed to facilitate thoughtful and constructive conversations around ongoing proposals. This interactive platform empowers members to openly share their insights, perspectives, and opinions on each referendum prior to the submission of an official vote by the designated proxy account on behalf of the collective or DAO.
The primary objective of this forum is to foster an environment of collaboration and informed decision-making, ensuring that every voice within the community is acknowledged and taken into consideration. By harnessing the collective wisdom of your community, you can make well-informed decisions that truly represent the best interests of the entire group.
We encourage everyone to actively participate in these discussions, as your input and feedback are invaluable in shaping the direction and outcomes of your collectives endeavors. Together, we can forge a stronger, more unified community that thrives on the principles of transparency, cooperation, and shared vision.
---
## Initial setup
- [Discord API key, Server & Forum ID](https://github.com/ChaosDAO-org/InternalGov-2.0/wiki/1.-Initial-Setup#discord-application-api-key)
- [Enabling your community server & creating a forum channel](https://github.com/ChaosDAO-org/InternalGov-2.0/wiki/2.-Forum-Channels#what-are-forum-channels)
- [Organising with categories](https://github.com/ChaosDAO-org/InternalGov-2.0/wiki/3.-Channel-Categories#adding-a-category)
- [FAQ](https://github.com/ChaosDAO-org/InternalGov-2.0/wiki/99.-FAQ)
[](https://www.youtube.com/watch?v=SYnpgcgfDsA)
---
### [.env.sample](https://raw.githubusercontent.com/ChaosDAO-org/InternalGov-2.0/main/.env.sample)
#### This file should be renamed from .env.sample -> .env
---
## Installing prerequisite libraries / tooling
```shell
cd InternalGov-2.0
pip3 install -r requirements.txt
```
##### Installing PM2 (Process Manager)
###### PM2 is a daemon process manager that will help you manage and keep your application/bot online 24/7
https://pm2.keymetrics.io/docs/usage/quick-start/
`npm install pm2 -g`
###### Daemonizing the bot to run 24/7 with PM2
```shell
# change directory
cd InternalGov-2.0/bot/
# test before daemonizing (review log file in /data/logs/governance_bot.log)
python3 main.py
# daemonize
pm2 start main.py --name polkadot_gov --interpreter python3
pm2 save
# stopping/starting & restarting pm2 process
pm2 stop polkadot_gov
pm2 start polkadot_gov
pm2 restart polkadot_gov
# list process(s); App name, ID, Mode, Status, CPU, Memory, Uptime, Restarts
pm2 list
```
---
## Autonomous voting
When the bot votes is dictated by `/data/vote_periods`. Each origin of a proposal has its own setting on when the first vote should be made & second. A second vote will only be made if the result differs from the first vote. If the first vote is AYE and it remains AYE on the second period then no vote will be made on the network.
[Polkadot vote periods](/data/vote_periods/polkadot.json)
[Kusama vote periods](/data/vote_periods/kusama.json)
### vote settings
###### Kusama vote periods
| Role | Decision Period (days) | Internal Vote Period (days) | Revote Period (days) |
|---------------------|------------------------|-----------------------------|----------------------|
| Root | 14 | 5 | 10 |
| WhitelistedCaller | 14 | 3 | 10 |
| StakingAdmin | 14 | 5 | 10 |
| Treasurer | 14 | 5 | 10 |
| LeaseAdmin | 14 | 5 | 10 |
| FellowshipAdmin | 14 | 5 | 10 |
| GeneralAdmin | 14 | 5 | 10 |
| AuctionAdmin | 14 | 5 | 10 |
| ReferendumCanceller | 7 | 2 | 4 |
| ReferendumKiller | 14 | 2 | 10 |
| SmallTipper | 7 | 1 | 4 |
| BigTipper | 7 | 1 | 4 |
| SmallSpender | 14 | 5 | 10 |
| MediumSpender | 14 | 5 | 10 |
| BigSpender | 14 | 5 | 10 |
| WishForChange | 14 | 5 | 10 |
> Example:
> > A proposal is submitted with its origin designated as 'Treasurer'. Following a period of five days after its on-chain introduction, a vote is conducted in accordance with the predetermined internal outcome. Should there be a shift in the voting stance from 'AYE' to 'NAY', a subsequent vote will be executed on the tenth day of the proposal's on-chain presence. In instances where the initial decision remains unaltered and the proposal has aged ten days or more, no further on-chain voting action will be undertaken.
---
###### Polkadot vote periods
| Role | Decision Period (days) | Internal Vote Period (days) | Revote Period (days) |
|---------------------|------------------------|-----------------------------|----------------------|
| Root | 28 | 7 | 20 |
| WhitelistedCaller | 28 | 2 | 20 |
| StakingAdmin | 28 | 7 | 20 |
| Treasurer | 28 | 7 | 20 |
| LeaseAdmin | 28 | 7 | 20 |
| FellowshipAdmin | 28 | 7 | 20 |
| GeneralAdmin | 28 | 7 | 20 |
| AuctionAdmin | 28 | 7 | 20 |
| ReferendumCanceller | 7 | 2 | 4 |
| ReferendumKiller | 28 | 4 | 20 |
| SmallTipper | 7 | 2 | 4 |
| BigTipper | 7 | 2 | 4 |
| SmallSpender | 28 | 7 | 20 |
| MediumSpender | 28 | 7 | 20 |
| BigSpender | 28 | 7 | 20 |
| WishForChange | 28 | 7 | 20 |
> Example:
> > A proposal is submitted with its origin designated as 'AuctionAdmin'. Following a period of seven days after its on-chain introduction, a vote is conducted in accordance with the predetermined internal outcome. Should there be a shift in the voting stance from 'AYE' to 'NAY', a subsequent vote will be executed on the twentieth day of the proposal's on-chain presence. In instances where the initial decision remains unaltered and the proposal has aged ten days or more, no further on-chain voting action will be undertaken.
---
## Support
For assistance or inquiries, please refer to the following official channels of communication:
| Platform | User | UID/URL |
|----------|--------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| Telegram | n4droj | [](https://t.me/n4droj) |
| Discord | n4dro | [](https://discord.com/invite/fGJe2AWkGe) |
| Twitter | n4dro | [](https://www.x.com/N4DRO) |