Skip to content

Commit 92fbd31

Browse files
committed
Add governance participation and DAO treasury documents; include images for voting processes in guides and update the table of contents
1 parent f40366c commit 92fbd31

File tree

10 files changed

+469
-0
lines changed

10 files changed

+469
-0
lines changed

astro.config.mjs

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -40,6 +40,7 @@ export default defineConfig({
4040

4141
{ label: "Tokenomics", slug: "explanations/holders/tokenomics" },
4242
{ label: "Staking", slug: "explanations/holders/staking" },
43+
{ label: "Governance Participation", slug: "explanations/holders/governance-participation" },
4344
],
4445
},
4546
{
@@ -60,6 +61,7 @@ export default defineConfig({
6061
collapsed: true,
6162
items: [
6263
{ label: "Root Agents", slug: "explanations/goal-leaders/root-agents" },
64+
{ label: "DAO Treasury", slug: "explanations/goal-leaders/dao-treasury" },
6365
{ label: "Emission Proposals", slug: "explanations/goal-leaders/emission-proposals" },
6466
{ label: "Permission System", slug: "explanations/goal-leaders/permissions" },
6567
{ label: "Recursive Delegation", slug: "explanations/goal-leaders/recursive-delegation" },
@@ -81,6 +83,7 @@ export default defineConfig({
8183
{ label: "Setup a Wallet", slug: "how-to-guides/holders/setup-a-wallet" },
8284
{ label: "Bridge from Base", slug: "how-to-guides/holders/bridge-from-base" },
8385
{ label: "Stake your Torus", slug: "how-to-guides/holders/stake-your-torus" },
86+
{ label: "Vote on Proposals", slug: "how-to-guides/holders/vote-on-proposals" },
8487
],
8588
},
8689
{
@@ -100,6 +103,7 @@ export default defineConfig({
100103
collapsed: true,
101104
items: [
102105
{ label: "Become a Root Agent", slug: "how-to-guides/goal-leaders/become-a-root-agent" },
106+
{ label: "Request DAO Treasury Transfer", slug: "how-to-guides/goal-leaders/request-dao-treasury-transfer" },
103107
{ label: "Create Emission Proposal", slug: "how-to-guides/goal-leaders/create-emission-proposal" },
104108
{ label: "Create Capability Permission", slug: "how-to-guides/goal-leaders/create-capability-permission" },
105109
{ label: "Create Emission Permission", slug: "how-to-guides/goal-leaders/create-emission-permission" },
136 KB
Loading
127 KB
Loading
115 KB
Loading
Lines changed: 63 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,63 @@
1+
---
2+
title: DAO Treasury
3+
description: Understanding the DAO Treasury system, funding mechanisms, and proposal processes in Torus governance.
4+
---
5+
6+
import {
7+
Aside,
8+
Card,
9+
CardGrid,
10+
Code,
11+
Tabs,
12+
TabItem,
13+
} from "@astrojs/starlight/components";
14+
15+
The DAO Treasury serves as a community-controlled funding mechanism that enables decentralized allocation of TORUS to support ecosystem development
16+
and community initiatives.
17+
18+
Proposals undergo review and voting by the community (all token holders), if approved, Torus Treasury funds are allocated to the destined wallet chosen by the proposer.
19+
20+
### Proposal Submission Costs
21+
22+
**Proposal Cost**: Each treasury transfer request requires a 10,000 TORUS deposit from the proposer's wallet.
23+
- **Approved proposals**: The 10,000 TORUS is refunded to the proposer
24+
- **Rejected proposals**: The 10,000 TORUS is transferred to the Treasury, increasing available funds
25+
26+
27+
28+
## Use Cases and Eligibility
29+
30+
**Development Projects**
31+
- Infrastructure improvements and tooling
32+
- Developer SDKs and libraries
33+
- Integration with external services
34+
- Protocol upgrades and enhancements
35+
36+
**Community Building**
37+
- Educational content and documentation
38+
- Community events and hackathons
39+
- Marketing and outreach initiatives
40+
- Ecosystem partnerships
41+
42+
**Research and Innovation**
43+
- Proof-of-concept implementations
44+
- Security audits and reviews
45+
- Economic research and modeling
46+
- Technical feasibility studies
47+
48+
### Accountability Mechanisms
49+
50+
Successful Proposals Recipient's are expected to:
51+
- Deliver on proposed milestones and timelines
52+
- Provide regular progress updates to the community
53+
- Maintain transparency about fund utilization
54+
55+
## Related Concepts
56+
57+
- **[Governance DAO](https://docs.torus.network/explanations/goal-leaders/governance-dao/)** - Overall DAO structure and decision-making processes
58+
- **[Emission Proposals](https://docs.torus.network/explanations/goal-leaders/emission-proposals/)** - Alternative funding mechanisms through delegation rewards
59+
- **[Root Agents](https://docs.torus.network/explanations/goal-leaders/root-agents/)** - DAO-approved agents with special privileges
60+
61+
<Aside type="tip" title="Ready to Submit a Proposal?">
62+
Follow our [step-by-step guide to request DAO Treasury transfers](https://docs.torus.network/how-to-guides/goal-leaders/request-dao-treasury-transfer/) for practical instructions.
63+
</Aside>
Lines changed: 143 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,143 @@
1+
---
2+
title: Governance Participation
3+
description: Understanding voting rights, power delegation, and governance mechanisms for TORUS token holders.
4+
---
5+
6+
import {
7+
Aside,
8+
Card,
9+
CardGrid,
10+
Code,
11+
Tabs,
12+
TabItem,
13+
} from "@astrojs/starlight/components";
14+
15+
Governance participation enables TORUS token holders to shape the network's evolution through democratic decision-making processes. Every token holder has voting rights proportional to their holdings, creating a decentralized governance system where community consensus drives protocol changes.
16+
17+
The Torus DAO operates on principles of transparency, inclusivity, and token-weighted voting, ensuring that those with the most stake in the network's success have proportional influence over its direction.
18+
19+
## Voting Power and Token Weight
20+
21+
### Voting Power Calculation
22+
Voting power directly correlates to TORUS token holdings:
23+
- **1 TORUS = 1 vote**
24+
- Voting power is calculated at proposal snapshot time
25+
- Staked tokens may have additional voting weight (depending on staking mechanics)
26+
- Tokens must be held in your connected wallet during voting periods
27+
28+
### Power User vs Delegated Voting
29+
30+
**Delegated Voting (Default)**
31+
- Validators automatically vote on behalf of token holders
32+
- No action required from individual holders
33+
- Validators make decisions based on their assessment of proposals
34+
- Reduces participation burden for passive holders
35+
- Can be changed to personal voting at any time
36+
37+
**Power User Mode**
38+
- Direct control over your voting decisions
39+
- Must actively participate in each proposal vote
40+
- Full autonomy over how your tokens influence governance
41+
- Requires transaction to enable/disable
42+
- Ideal for active community members who want direct control
43+
44+
## Proposal Types and Voting
45+
46+
### Treasury Transfer Proposals
47+
Community requests for funding from the DAO Treasury to support ecosystem development, research, or community initiatives.
48+
49+
**Voting Considerations:**
50+
- Project viability and team credibility
51+
- Benefit to the Torus ecosystem
52+
- Budget reasonableness and timeline
53+
- Alignment with network priorities
54+
55+
### Emission Proposals
56+
Changes to network economics, including token emission rates, burn mechanisms, and reward distribution parameters.
57+
58+
**Voting Considerations:**
59+
- Long-term economic sustainability
60+
- Impact on token value and inflation
61+
- Effects on network incentives
62+
- Technical feasibility of implementation
63+
64+
### Governance Parameter Changes
65+
Modifications to voting thresholds, proposal costs, voting periods, and other governance mechanics.
66+
67+
**Voting Considerations:**
68+
- Democratic accessibility vs governance security
69+
- Participation requirements and barriers
70+
- Protection against governance attacks
71+
- Community representation balance
72+
73+
## Voting Mechanics
74+
75+
### Proposal Lifecycle
76+
1. **Submission**: Proposals submitted with required deposit (typically 10,000 TORUS)
77+
2. **Review Period**: Community discussion and feedback (informal)
78+
3. **Voting Period**: 7-day voting window for all token holders
79+
4. **Execution/Rejection**: Automatic execution based on voting results
80+
81+
### Approval Criteria
82+
**Standard Requirements:**
83+
- **Support Threshold**: At least 50% of votes must be favorable
84+
- **Participation Threshold**: More than 10% of total token supply must participate
85+
- **Time Limit**: Voting closes after 7 days regardless of participation
86+
87+
**Outcome Scenarios:**
88+
- **Approved**: 50%+ support + 10%+ participation → Automatic execution
89+
- **Rejected**: Less than 50% support + 10%+ participation → Proposal fails
90+
- **Insufficient Participation**: Less than 10% participation → Proposal expires
91+
92+
### Vote Finality
93+
Once cast, votes cannot be changed during the voting period. This ensures predictability and prevents last-minute manipulation, but requires careful consideration before voting.
94+
95+
## Economic Incentives and Costs
96+
97+
### Proposal Costs
98+
- **Submission Fee**: 10,000 TORUS required to submit proposals
99+
- **Cost Recovery**: Fee refunded if proposal passes, retained by Treasury if rejected
100+
- **Spam Prevention**: Economic barrier prevents frivolous proposals
101+
102+
### Voting Costs
103+
- **Transaction Fees**: Standard network fees apply for voting transactions
104+
- **Power User Setup**: One-time transaction to enable direct voting control
105+
- **Switching Modes**: Small transaction cost to change between delegated and power user modes
106+
107+
## Strategic Voting Considerations
108+
109+
### Information Gathering
110+
- **Proposal Details**: Thoroughly review all proposal documentation
111+
- **Community Discussion**: Engage in Discord, Telegram, and forum discussions
112+
- **Technical Analysis**: Understand implementation details and potential impacts
113+
- **Precedent Setting**: Consider how current votes affect future proposals
114+
115+
### Long-term Impact
116+
- **Network Health**: Vote for proposals that strengthen the ecosystem
117+
- **Economic Sustainability**: Support proposals that enhance long-term value
118+
- **Community Growth**: Favor initiatives that expand and engage the user base
119+
- **Innovation**: Encourage proposals that advance technical capabilities
120+
121+
## Governance Security
122+
123+
### Attack Prevention
124+
- **Proposal Costs**: Economic barriers prevent spam and low-quality submissions
125+
- **Time Delays**: Voting periods allow community review and response
126+
- **Participation Thresholds**: Ensure broad community involvement in decisions
127+
- **Transparent Process**: All votes and outcomes are publicly recorded
128+
129+
### Best Practices
130+
- **Diversified Holdings**: Avoid concentration of voting power in few hands
131+
- **Active Participation**: Regular voting prevents governance capture
132+
- **Community Engagement**: Discuss proposals before voting
133+
- **Long-term Thinking**: Consider ecosystem health over short-term gains
134+
135+
## Related Concepts
136+
137+
- **[Tokenomics](https://docs.torus.network/explanations/holders/tokenomics/)** - Understanding TORUS token economics and distribution
138+
- **[Staking](https://docs.torus.network/explanations/holders/staking/)** - How staking affects voting power and governance participation
139+
- **[Governance DAO](https://docs.torus.network/explanations/goal-leaders/governance-dao/)** - Overall DAO structure and decision-making processes
140+
141+
<Aside type="tip" title="Ready to Start Voting?">
142+
Follow our [step-by-step guide to vote on proposals](https://docs.torus.network/how-to-guides/holders/vote-on-proposals/) for practical instructions.
143+
</Aside>

src/content/docs/explanations/table-of-contents.mdx

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -25,6 +25,7 @@ Learn about TORUS economics and understand how you can participate:
2525

2626
- [Tokenomics](https://docs.torus.network/explanations/holders/tokenomics/) — Economics of TORUS: supply mechanisms and emission distribution models
2727
- [Staking](https://docs.torus.network/explanations/holders/staking/) — Staking mechanisms and incentives for network participation
28+
- [Governance Participation](https://docs.torus.network/explanations/holders/governance-participation/) — Voting rights, power delegation, and governance mechanisms
2829

2930

3031
---
@@ -48,6 +49,7 @@ Understanding how agent systems work within Torus:
4849
Understanding governance and leadership systems:
4950

5051
- [Root Agents](https://docs.torus.network/explanations/goal-leaders/root-agents/) — DAO approval process and direct emission access
52+
- [DAO Treasury](https://docs.torus.network/explanations/goal-leaders/dao-treasury/) — Community funding mechanisms and proposal processes
5153
- [Emission Proposals](https://docs.torus.network/explanations/goal-leaders/emission-proposals/) — How to adjust network economics through governance
5254
- [Permission System](https://docs.torus.network/explanations/goal-leaders/permissions/) — How agents interact and delegate authority
5355
- [Recursive Delegation](https://docs.torus.network/explanations/goal-leaders/recursive-delegation/) — Specific capability delegation mechanisms
Lines changed: 116 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,116 @@
1+
---
2+
title: Request DAO Treasury Transfer
3+
description: Step-by-step guide to requesting TORUS funding from the DAO Treasury for building projects and initiatives.
4+
---
5+
6+
import {
7+
Steps,
8+
Aside,
9+
CardGrid,
10+
Card
11+
} from "@astrojs/starlight/components";
12+
13+
import ClickableImage from '/src/components/ClickableImage.astro';
14+
import RedText from '/src/components/RedText.astro';
15+
16+
In this guide, we'll walk through the process of **requesting a transfer from the DAO Treasury** to fund your building projects or initiatives.
17+
18+
The DAO Treasury is a community-controlled fund that provides financial support to builders and contributors who want to develop tools, services, or improvements for the Torus ecosystem.
19+
20+
#### Why request DAO Treasury funding?
21+
22+
DAO Treasury transfers provide essential funding for builders who need capital to start projects but may not have the initial resources.
23+
24+
#### What we will accomplish
25+
26+
- Submit a proposal to request TORUS from the DAO Treasury
27+
28+
<Aside>
29+
⏱️ **Estimated time to complete this guide: 30 minutes**
30+
</Aside>
31+
32+
## Prerequisites
33+
34+
<CardGrid>
35+
<Card title="Torus Wallet" icon="seti:license">
36+
You must have a Torus wallet set up with sufficient balance to cover the proposal cost.
37+
You can find a [guide on how to set up a wallet here](https://docs.torus.network/how-to-guides/holders/setup-a-wallet/).
38+
</Card>
39+
<Card title="Proposal Cost Balance" icon="seti:shell">
40+
Ensure you have at least **10,000 TORUS** in your wallet to cover the proposal cost.
41+
You can find a [guide on how to bridge TORUS here](https://docs.torus.network/how-to-guides/holders/bridge-from-base/).
42+
</Card>
43+
</CardGrid>
44+
45+
## Request DAO Treasury Transfer
46+
47+
<Steps>
48+
49+
1. **Visit the [Proposals Tab in the DAO Governance Portal](https://dao.torus.network/proposals)**
50+
Navigate to the **Shape the Network** section in the Torus DAO Portal.
51+
52+
2. **Connect your Wallet**
53+
<RedText variant="light">Ensure you're connected with a wallet</RedText> that has at least 10,000 TORUS for the proposal cost.
54+
55+
3. **Click in Shape the Network**
56+
It can be found in the top right corner of the page.
57+
58+
4. **Select "Transfer DAO Treasury" Type**
59+
In the modal, choose <RedText variant="light">**"Transfer DAO Treasury"**</RedText> from the dropdown menu of available options.
60+
61+
5. **Complete the Transfer Request Form**
62+
Fill out the required information:
63+
64+
```md
65+
# Destination
66+
[Enter the wallet address where funds should be sent]
67+
68+
# Value
69+
[Specify the amount in TORUS you're requesting]
70+
71+
# Application Title
72+
[Provide a clear, descriptive title for your project]
73+
74+
# Application Body
75+
[Write a detailed explanation including:
76+
- Project overview and objectives
77+
- How it benefits the Torus ecosystem
78+
- Timeline and milestones
79+
- Budget breakdown and justification
80+
- Your background and qualifications]
81+
```
82+
5. **Submit and Sign the Transaction**
83+
The proposal cost is **10,000 TORUS** which will be <RedText variant="light">deducted from your connected wallet</RedText>.
84+
Review all information carefully, then click **Submit Proposal**.
85+
Open the SubWallet extension and <RedText variant="light">sign the transaction</RedText> to pay the proposal cost.
86+
87+
<Aside type="caution">
88+
The proposal cost will be refunded if your proposal is approved, but will go to the Treasury if rejected.
89+
</Aside>
90+
91+
6. **All Done**
92+
You've successfully submitted a proposal to request TORUS from the DAO Treasury.
93+
Now you must wait for community feedback and voting.
94+
95+
96+
97+
</Steps>
98+
99+
100+
101+
## What's Next?
102+
103+
After submitting your treasury request:
104+
105+
- **[DAO Dashboard](https://dao.torus.network/dao-dashboard)** - Check "DAO Treasury Funds" in the left sidebar
106+
- **[Proposal History](https://dao.torus.network/proposals)**: All approved, rejected and open proposals are publicly recorded in the proposals tab.
107+
- **Direct Treasury Address**: `5EYCAe5jXm8DLvvQ2YjbsmnoMpDHAfokKZfg12KzGSSAzM4D`
108+
109+
Connect with the community:
110+
- [Discord](https://discord.gg/torus) — Technical discussions, support, and announcements
111+
- [Telegram](https://t.me/torusnetwork) — General chat and announcements
112+
- [Twitter](https://x.com/torus_network) — Updates and ecosystem news
113+
114+
<Aside type="tip" title="Want to Learn More?">
115+
Learn about [DAO Treasury mechanisms](https://docs.torus.network/explanations/goal-leaders/dao-treasury/) and governance processes.
116+
</Aside>

0 commit comments

Comments
 (0)