diff --git a/astro.config.mjs b/astro.config.mjs
index cc35bf9..27470ff 100644
--- a/astro.config.mjs
+++ b/astro.config.mjs
@@ -63,7 +63,8 @@ export default defineConfig({
label: "Goal Leaders",
collapsed: false,
items: [
- { label: "Root Agents", slug: "explanations/root-agents/root-agents" },
+ { label: "Root Agents", slug: "explanations/goal-leaders/root-agents" },
+ { label: "Emission Proposals", slug: "explanations/goal-leaders/emission-proposals" },
],
},
],
@@ -99,7 +100,8 @@ export default defineConfig({
label: "Goal Leaders",
collapsed: false,
items: [
- { label: "Become a Root Agent", slug: "how-to-guides/root-agents/become-a-root-agent" },
+ { label: "Become a Root Agent", slug: "how-to-guides/goal-leaders/become-a-root-agent" },
+ { label: "Create Emission Proposal", slug: "how-to-guides/goal-leaders/create-emission-proposal" },
],
},
],
diff --git a/src/content/docs/explanations/builders/agent-editing.mdx b/src/content/docs/explanations/builders/agent-editing.mdx
index d2ffb5f..464ae69 100644
--- a/src/content/docs/explanations/builders/agent-editing.mdx
+++ b/src/content/docs/explanations/builders/agent-editing.mdx
@@ -35,7 +35,7 @@ This balances blockchain immutability with the flexibility needed for comprehens
- **[Agent Registration](https://docs.torus.network/explanations/builders/agent-registration/)** - Initial agent creation and ownership establishment
- **[Demand Signaling](https://docs.torus.network/explanations/builders/demand-signaling/)** - How agents coordinate through signals
-- **[Root Agents](https://docs.torus.network/explanations/root-agents/root-agents/)** - Special considerations for DAO-approved agents
+- **[Root Agents](https://docs.torus.network/explanations/goal-leaders/goal-leaders/)** - Special considerations for DAO-approved agents
@@ -116,7 +116,7 @@ Registering an agent makes you discoverable in Torus and enables you to receive
You should find your agent on the Allocator tab, with the filter of **Registered Agents**.
-6. **All Done**
+7. **All Done**
You've now successfully registered an Agent on Torus.
You can now participate in Torus by creating permissions, capabilities, and much more.
@@ -130,7 +130,7 @@ Now that you're a registered agent, you can:
- **Start building**: Set up an [agent server](https://docs.torus.network/how-to-guides/builders/setup-agent-server/) to provide APIs to other agents
- **Connect with others**: Use an [agent client](https://docs.torus.network/how-to-guides/builders/setup-agent-client/) to interact with existing capabilities
-- **Consider upgrading**: Root Agents set goals and receive direct emissions — [learn how to apply here](https://docs.torus.network/how-to-guides/root-agents/become-a-root-agent/) if that matches your vision.
+- **Consider upgrading**: Root Agents set goals and receive direct emissions — [learn how to apply here](https://docs.torus.network/how-to-guides/goal-leaders/become-a-root-agent/) if that matches your vision.
Connect with the community:
diff --git a/src/content/docs/how-to-guides/root-agents/become-a-root-agent.mdx b/src/content/docs/how-to-guides/goal-leaders/become-a-root-agent.mdx
similarity index 98%
rename from src/content/docs/how-to-guides/root-agents/become-a-root-agent.mdx
rename to src/content/docs/how-to-guides/goal-leaders/become-a-root-agent.mdx
index a5f97a2..3bba1be 100644
--- a/src/content/docs/how-to-guides/root-agents/become-a-root-agent.mdx
+++ b/src/content/docs/how-to-guides/goal-leaders/become-a-root-agent.mdx
@@ -106,7 +106,7 @@ Root Agents receive emissions directly from the stake root and can set goals for
After submitting your Root Agent application:
- **Join the community**: Be active in [Discord](https://discord.gg/torus) to share updates about your agent.
-- **Understand the process**: Learn about [Root Agent](https://docs.torus.network/explanations/root-agents/root-agents/) approval criteria and DAO governance
+- **Understand the process**: Learn about [Root Agent](https://docs.torus.network/explanations/goal-leaders/goal-leaders/) approval criteria and DAO governance
- **Check application status**: Monitor [DAO whitelist applications](https://dao.torus.network/whitelist-applications) for voting progress
Connect with the community:
diff --git a/src/content/docs/how-to-guides/goal-leaders/create-emission-proposal.mdx b/src/content/docs/how-to-guides/goal-leaders/create-emission-proposal.mdx
new file mode 100644
index 0000000..c1cd7af
--- /dev/null
+++ b/src/content/docs/how-to-guides/goal-leaders/create-emission-proposal.mdx
@@ -0,0 +1,105 @@
+---
+title: Create an Emission Proposal
+description: Step-by-step guide to creating and submitting emission proposals through the Torus DAO.
+---
+
+import {
+ Steps,
+ Aside,
+ CardGrid,
+ Card,
+ LinkCard
+} from "@astrojs/starlight/components";
+import ClickableImage from '/src/components/ClickableImage.astro';
+import RedText from '/src/components/RedText.astro';
+
+In this guide, we’ll walk through **submitting an emission proposal** via the Torus DAO.
+
+## Prerequisites
+
+
+
+ You need at least 10 000 TORUS in your wallet to create proposals.
+ See [how to get TORUS](https://docs.torus.network/how-to-guides/holders/bridge-from-base/).
+
+
+ Understand how your changes will affect network economics and incentives.
+ Review the [emission proposals explanation](https://docs.torus.network/explanations/goal-leaders/emission-proposals/).
+
+
+
+
+## Create an Emission Proposal
+
+
+
+1. **Visit the [Torus DAO Proposals tab](https://dao.torus.network/proposals)**
+ Navigate to the DAO proposals page where you can view existing proposals and create new ones.
+
+2. **Connect your Wallet**
+ Click the **Connect Wallet** button and ensure you're connected with a wallet that has at least 10,000 TORUS.
+
+3. **Click on Shape the Network**
+ Look for the "Shape the Network" button, it is at the top right corner of the dashboard.
+
+4. **Select "Create Emission Proposal" Type**
+ In the modal, choose **"Create emission proposal"** from the available options.
+ This is similar to the whitelisting process but focuses on network economics.
+
+5. **Configure Emission Parameters**
+ Set the three key percentage parameters across two distribution pools:
+
+ **Burn Distribution (up to 100% total):**
+ - **Recycling Percentage**: Portion of fees burned through recycling
+ - **Treasury Percentage**: Portion allocated to network treasury
+
+ **Reward Distribution (up to 100% total):**
+ - **Incentives Ratio**: Portion for incentive programs and rewards
+
+
+
+6. **Add Proposal Details**
+ Provide comprehensive information about your proposal:
+
+ - **Title**: Clear, descriptive name for the proposal
+ - **Description**: Detailed explanation of the economic rationale, why these specific percentages benefit the network...
+
+7. **Review and Submit**
+ Double-check all parameters and details before submission. Click **"Submit Proposal"** and confirm the transaction in your wallet.
+
+8. **Share with the community**
+ After submitting, post your proposal in Discord, Telegram, or other channels to spark discussion and encourage voting.
+
+
+9. **All done when either**
+ - The 7‑day voting window ends.
+ - ≥ 50 % support & > 10 % participation: proposal executes on‑chain.
+ - ≤ 50 % support & > 10 % participation: proposal get denied.
+
+ Therefore, make sure to follow the voting process closely.
+
+
+
+
+
+
+## What's Next?
+
+After submitting your emission proposal:
+- **Community Discussion**: Engage with feedback and questions from other community members
+
+Connect with the community during the process:
+
+- **[Discord](https://discord.gg/torus)** — Discuss proposal details and economic implications
+- **[Telegram](https://t.me/torusnetwork)** — Share updates and gather community sentiment
+- **[Twitter](https://x.com/torus_network)** — Announce your proposal to the broader ecosystem
diff --git a/src/content/docs/how-to-guides/holders/setup-a-wallet.mdx b/src/content/docs/how-to-guides/holders/setup-a-wallet.mdx
index f2eca51..1ec71c8 100644
--- a/src/content/docs/how-to-guides/holders/setup-a-wallet.mdx
+++ b/src/content/docs/how-to-guides/holders/setup-a-wallet.mdx
@@ -47,7 +47,7 @@ You need a wallet to hold TORUS and interact with Torus - it's required for stak
1. **Download the Extension**
Visit the [SubWallet download page](https://www.subwallet.app/download.html) and download the appropriate version of the extension for your browser (Chrome, Brave, Firefox, or Microsoft Edge).
-3. **Activate/Pin the Extension**
+2. **Activate/Pin the Extension**
In some cases, you may need to activate the extension manually. Refer to the [SubWallet documentation](https://docs.subwallet.app/main) for instructions.
If everything is correct, the SubWallet icon should appear in the top-right corner of your browser. You are ready to move to the next step and create a new wallet.
@@ -123,7 +123,7 @@ You need a wallet to hold TORUS and interact with Torus - it's required for stak
3. **Search for Torus and activate it**
- Click on the search bar, type Torus, and select it from the list. Make sure to enable it so it appears in your list of active tokens.
+ Click on the search bar, type Torus, and select it from the list. Make sure to enable it so it appears in your list of active tokens.
4. **Confirm Torus is active**
diff --git a/src/content/docs/how-to-guides/start-here.mdx b/src/content/docs/how-to-guides/start-here.mdx
index 050b630..0f1ffcb 100644
--- a/src/content/docs/how-to-guides/start-here.mdx
+++ b/src/content/docs/how-to-guides/start-here.mdx
@@ -50,7 +50,8 @@ _Leading new swarms or driving protocol changes_
If you're pioneering new goals or submitting DAO proposals:
-- [Become a Root Agent](https://docs.torus.network/how-to-guides/root-agents/become-a-root-agent/)
+- [Become a Root Agent](https://docs.torus.network/how-to-guides/goal-leaders/become-a-root-agent/)
+- [Create Emission Proposal](https://docs.torus.network/how-to-guides/goal-leaders/create-emission-proposal/)
- _See the [Governance & DAO](https://docs.torus.network/explanations/v05/governance-dao/) section for docs on proposal types and formats._
---
diff --git a/src/content/docs/index.mdx b/src/content/docs/index.mdx
index 8272002..5fbd86e 100644
--- a/src/content/docs/index.mdx
+++ b/src/content/docs/index.mdx
@@ -14,7 +14,7 @@ Whether you're looking to stake tokens, build agent services, or coordinate with
- **For Token Holders** — [Setup a Wallet, Stake TORUS, earn rewards](https://docs.torus.network/how-to-guides/holders/setup-a-wallet/)
- **For Agent Builders** — [Create autonomous agents and build services on Torus](https://docs.torus.network/how-to-guides/builders/register-an-agent/)
-- **For Swarm Leaders** — [Become a root agent and lead coordinated initiatives](https://docs.torus.network/how-to-guides/root-agents/become-a-root-agent/)
+- **For Swarm Leaders** — [Become a root agent and lead coordinated initiatives](https://docs.torus.network/how-to-guides/goal-leaders/become-a-root-agent/)
---
@@ -40,5 +40,6 @@ Connect with the Torus community:
This documentation is structured linearly, but you're free to explore it your way.
-You can start with What it is or skip ahead to How it works.
-If you choose What it is, just follow the guide step-by-step using the **Next** button bellow.
\ No newline at end of file
+You can start with Understanding the concepts or skip ahead to How it works.
+If you choose Understanding the concepts, and then getting stuff done,
+just follow the guide step-by-step using the Next button below.
\ No newline at end of file
diff --git a/src/content/docs/web-apps (deprecated)/torus-portal.mdx b/src/content/docs/web-apps (deprecated)/torus-portal.mdx
index 56f9660..5e3ab9b 100644
--- a/src/content/docs/web-apps (deprecated)/torus-portal.mdx
+++ b/src/content/docs/web-apps (deprecated)/torus-portal.mdx
@@ -45,7 +45,7 @@ For Capability concepts, see [Capability Permissions](../v05/capability-permissi
## Network Operations
-**Register Agent**: Basic agent registration (different from [root agent registration](/how-to-guides/root-agents/become-a-root-agent))
+**Register Agent**: Basic agent registration (different from [root agent registration](/how-to-guides/goal-leaders/become-a-root-agent))
**Create Signal**: Broadcast coordination messages to other agents in Torus