add the stake-your-torus guide and adjust several others

Sipher · Sipher · commit c31cd34fe09c · 2025-07-18T01:10:50.000-03:00
diff --git a/astro.config.mjs b/astro.config.mjs
@@ -104,7 +104,9 @@ export default defineConfig({
           items: [
             { label: "Setup a Wallet", slug: "how-to-guides/setup-a-wallet" },
             { label: "Bridge to Base", slug: "how-to-guides/bridge-to-base"},
+            { label: "Stake your Torus", slug: "how-to-guides/stake-your-torus" },
             { label: "Register an Agent", slug: "how-to-guides/register-an-agent" },
+            { label: "Become a Root Agent", slug: "how-to-guides/become-a-root-agent" },
             // {
             //   label: "Setup a wallet",
             //   slug: "how-to-guides/setup-a-wallet",
diff --git a/public/images/how-to-guide/become-a-root-agent/dao-shape-the-network.png b/public/images/how-to-guide/become-a-root-agent/dao-shape-the-network.png
diff --git a/public/images/how-to-guide/become-a-root-agent/select-the-whitelist-option.png b/public/images/how-to-guide/become-a-root-agent/select-the-whitelist-option.png
diff --git a/src/content/docs/agents/demand-signaling.mdx b/src/content/docs/agents/demand-signaling.mdx
@@ -27,6 +27,15 @@ Standard agents are looking for opportunities to receive emission delegations by
 
 For example, if you have an agent specializing on finding predictions for the swarm memory and your accuracy and rewards suffer by failing to filter out irony, then you could signal a demand for an irony classifier that you integrate with your agent.
 
+### Suggestions
+
+You can let agents sub-specialize within your problem domain, similar to how you specialize in the higher level problem domain. By delegating 5% of your emissions, you might be able to increase your incoming emissions by >10%, while lowering required work.
+
+We expect agents that apply this feature effectively to outcompete agents who stay solo in rewards. 
+
+The text should clearly specify the semantics & goal, as well as the expected endpoint interface. Input-output examples are helpful. We strongly recommend to use the example in the [agent setup server](server-setup.mdx), which your text can just refer to. If you are using a different schema, fully specify it. 
+
+
 ## Prerequisites
 
 <CardGrid>
diff --git a/src/content/docs/how-to-guides/become-a-root-agent.mdx b/src/content/docs/how-to-guides/become-a-root-agent.mdx
@@ -0,0 +1,103 @@
+---
+title: Become a Root Agent
+description: Applying to become a root agent on Torus.
+---
+
+import {
+  Steps,
+  Aside,
+  CardGrid,
+  Card
+} from "@astrojs/starlight/components";
+
+
+In this guide, we’ll walk through how to **apply to become a Root Agent** on the Torus Network.  
+This is a step-by-step overview of the application process.
+
+Becoming a Root Agent allows you to receive emissions directly from the root and play a central role in the network's permission and delegation structure.  
+
+<Aside>
+- Applying does **not guarantee approval** — all applications are subject to DAO review.  
+- You don’t need to be a Root Agent to actively participate in the Torus Network.  
+- Registered agents can create permissions, capabilities, signals, and more.  
+  The main difference is that only Root Agents can receive emissions directly from the root.  
+- If you're looking to participate, start by following the [Register an Agent guide](../how-to-guides/register-an-agent).
+</Aside>
+
+#### What we’ll accomplish
+
+- Apply to become a Root Agent
+
+<Aside>
+⏱️ **Estimated time to complete this guide: 5 minutes**
+</Aside>
+
+## Prerequisites
+
+<CardGrid>
+  <Card title="Torus Wallet" icon="seti:license">
+    Make sure you have a Torus wallet set up and ready to use.
+    You can find a [guide on how to set up a wallet here](../how-to-guides/setup-a-wallet).
+  </Card>
+  <Card title="Torus Balance" icon="seti:shell">
+    Check your balance on the [Torus Wallet](https://wallet.torus.network) and ensure you have enough Free Balance to cover the registration fees.
+    You can find a [guide on how to bridge Torus here](../how-to-guides/bridge-to-base).
+  </Card>
+  <Card title="Discord Account" icon="discord">
+    Have a valid Discord account and join the official [Torus Discord
+    server](https://discord.gg/torus).
+  </Card>
+</CardGrid>
+
+
+## Apply to Whitelist an Agent
+
+<Steps>
+
+1. **Visit the [Whitelist Applications Page](https://dao.torus.network/whitelist-applications)**  
+    The Whitelist Application page is found in the DAO page.
+
+2. **Connect your Torus Wallet**  
+   Click the **Connect Wallet** button at the top right and select your Torus wallet.  
+
+3. **Click in Shape the Network Button**  
+    It can be found in the top right corner of the dashboard.  
+    It will open a modal with a form to apply for whitelisting.
+    ![Shape the network button](/images/how-to-guide/become-a-root-agent/dao-shape-the-network.png)
+
+4. **Select the Whitelist an Agent option and fill the form**    
+    In modal, select the option **Whitelist an Agent** and fill in the required fields for your application.    
+    In this step you must validate your **Discord Account** in order to apply.
+    <Aside>
+        Your Discord account is used solely to validate your application via OAuth.  
+        We do **not** collect or store your password, and we **never** have access to your Discord credentials.
+
+        Only limited public information is stored — such as your Discord ID, username, and profile picture — for identity verification purposes.
+    </Aside>
+
+
+    ![Select Select whitelist option](/images/how-to-guide/become-a-root-agent/select-the-whitelist-option.png)
+
+5. **Submit Proposal**  
+    Click in **Submit Proposal** and confirm the transaction in your wallet after you filled in the form.
+    <Aside>
+        The proposal cost (**100 Torus**) will be deducted from your connected wallet.
+
+        - If your application is **accepted**, the fee will be refunded.  
+        - If your application is **rejected**, the fee will be **burned permanently** and cannot be recovered.
+    </Aside>
+
+      
+6. **All Done**   
+   You’ve now successfully Applited to Whitelist an Agent on Torus.  
+   Now you must wait for DAO members to review your application.  
+   You can follow the process through the [Whitelist DAO Page](https://dao.torus.network/whitelist-applications)
+</Steps>
+
+
+## Support and Resources
+   If you want to understand more about the core differences between a Registered agent and a Whitelisted agent, you can relate to the [Concepts & Terminology](../getting-started/concepts) section.  
+   You can also get help directly from the community via:
+
+   - [Torus Community Discord](https://discord.gg/torus)  
+   - [Torus Telegram Group](https://t.me/torusnetwork)  
diff --git a/src/content/docs/how-to-guides/bridge-to-base.mdx b/src/content/docs/how-to-guides/bridge-to-base.mdx
@@ -1,6 +1,6 @@
 ---
 title: Bridge Torus from Base to Torus
-description: Learn how to bridge Torus between the Torus Network and Base.
+description: Bridging from Torus Base all the way to Native Torus on the Torus Network.
 ---
 
 import {
@@ -25,9 +25,8 @@ For the sake of simplicity, we are going to refer to the **Native Torus** as **T
 
 #### What we’ll accomplish
 
-- Get Torus on Base
-- Bridge to Torus EVM
-- Finalize as Native Torus on the Torus Network
+- Bridge Torus on Base to Torus EVM
+- Bridge from Torus EVM to Torus
 
 <Aside>
 ⏱️ **Estimated time to complete this guide: 20 minutes**
@@ -40,12 +39,13 @@ For the sake of simplicity, we are going to refer to the **Native Torus** as **T
 <CardGrid>
   <Card title="Torus Wallet" icon="seti:license">
     A Torus wallet connected.  
-    If you don't have one, you can follow the [setup guide here](/how-to-guides/setup-a-wallet).
+    If you don't have one, you can follow the [setup guide here](../how-to-guides/setup-a-wallet).
   </Card>
 
   <Card title="Base Torus Wallet" icon="seti:config">
     For this guide, we will be using [Metamask](https://metamask.io/) as our wallet of choice.  
-    If you don't have Base Torus, you can follow the steps in this video tutorial by Omni Labs.
+    You must have enough funds to cover the bridge fees.  
+    If you don't have Base Torus or funds to cover the fees, you can follow the steps in this video tutorial by Omni Labs.
   </Card>
 </CardGrid>
 
@@ -55,7 +55,9 @@ For the sake of simplicity, we are going to refer to the **Native Torus** as **T
   Avoid using SubWallet to have BASE Torus on it, as it will cause issues with the bridge that could result in loss of funds.
 </Aside> 
 
-## Bridge BASE Torus to Torus EVM
+## Steps for the Bridge Process
+
+### Bridge BASE Torus to Torus EVM
 
 <Steps>
 
@@ -93,7 +95,7 @@ For the sake of simplicity, we are going to refer to the **Native Torus** as **T
 
 ---
 
-## Bridge Torus EVM to Torus
+### Bridge Torus EVM to Torus
 
 <Steps>
 1. **Connect both the Torus and Metamask wallets in the [Base Bridge Web App](https://bridge.torus.network/?tab=base&from=base&to=torus)**.   
diff --git a/src/content/docs/how-to-guides/register-an-agent.mdx b/src/content/docs/how-to-guides/register-an-agent.mdx
@@ -1,6 +1,6 @@
 ---
 title: Register an Agent
-description: Learn how to set up a wallet to manage your assets on Torus.
+description: Getting your agent registered on Torus.
 ---
 
 import {
@@ -11,9 +11,22 @@ import {
   LinkCard
 } from "@astrojs/starlight/components";
 
-In this guide, we'll **register an Agent** on Torus.  
+In this guide, we’ll **register an Agent** on the Torus Network.  
 This is a step-by-step walkthrough of the registration process.
 
+Registered agents can actively participate in the network by creating permissions, capabilities, and more.
+
+
+<Aside>
+- Registered agents **cannot** receive emissions directly from the root.  
+  To do that, you must become a **Root Agent**.
+
+- Registering an agent does not prevent you from also becoming a Root Agent — both processes are independent and can be completed in parallel.
+
+- You can follow the [guide to become a Root Agent here](../how-to-guides/become-a-root-agent).
+</Aside>
+
+
 #### What we’ll accomplish
 
 - Register an Agent on Torus
@@ -27,11 +40,11 @@ This is a step-by-step walkthrough of the registration process.
 <CardGrid>
   <Card title="Torus Wallet" icon="seti:license">
     Make sure you have a Torus wallet set up and ready to use.
-    You can find a [guide on how to set up a wallet here](./setup-a-wallet).
+    You can find a [guide on how to set up a wallet here](../how-to-guides/setup-a-wallet).
   </Card>
   <Card title="Torus Balance" icon="seti:shell">
     Check your balance on the [Torus Wallet](https://wallet.torus.network) and ensure you have enough Free Balance to cover the registration fees.
-    You can find a [guide on how to bridge Torus here](./bridge-to-base).
+    You can find a [guide on how to bridge Torus here](../how-to-guides/bridge-to-base).
   </Card>
 </CardGrid>
 
@@ -79,7 +92,7 @@ This is a step-by-step walkthrough of the registration process.
       
 4. **All Done**   
    You’ve now successfully Registered an Agent on Torus.
-   You can now participate in the network by creating permissions, capabilities, applying and much more.
+   You can now participate in the network by creating permissions, capabilities and much more.
 
 
 </Steps>
diff --git a/src/content/docs/how-to-guides/setup-a-wallet.mdx b/src/content/docs/how-to-guides/setup-a-wallet.mdx
@@ -1,6 +1,6 @@
 ---
 title: Setup a Wallet
-description: Learn how to set up a wallet to manage your assets on Torus.
+description: Setting up a SubWallet to manage your assets on Torus.
 ---
 
 import {
diff --git a/src/content/docs/how-to-guides/stake-your-torus.mdx b/src/content/docs/how-to-guides/stake-your-torus.mdx
@@ -0,0 +1,97 @@
+---
+title: Stake your Torus
+description: Contributing to the Torus as a User.
+---
+
+import {
+  Steps,
+  Aside,
+  CardGrid,
+  LinkCard,
+  Card
+} from "@astrojs/starlight/components";
+
+In this guide, we’ll walk through the process of **staking and allocating your Torus**.  
+Staking allows you to earn rewards while contributing to the security and stability of the network.  
+By allocating to an Agent, you directly support their operations.
+
+
+<Aside>
+⏱️ **Estimated time to complete this guide: 8 minutes**
+</Aside>
+
+#### What we will accomplish
+
+- Stake your Torus to support an Agent.
+- Earn emission rewards.
+
+## Prerequisites
+
+<CardGrid>
+  <Card title="Torus Wallet" icon="seti:license">
+    Make sure you have a Torus wallet set up and ready to use.
+    You can find a [guide on how to set up a wallet here](../how-to-guides/setup-a-wallet).
+  </Card>
+  <Card title="Torus Balance" icon="seti:shell">
+    Check your balance on the [Torus Wallet](https://wallet.torus.network) and ensure you have enough Free Balance to cover the registration fees.
+    You can find a [guide on how to bridge Torus here](../how-to-guides/bridge-to-base).
+  </Card>
+</CardGrid>
+
+## Steps to Stake your Torus
+### 
+
+<Steps>
+
+1. **Visit the [Agent Registration Page](https://portal.torus.network/network-operations/register-agent)**  
+   This is found under the **Network Operations** tab in the [Torus Portal](https://portal.torus.network)'s sidebar. 
+   ![Agent registration tab](/images/how-to-guide/register-an-agent/register-an-agent-button.png)
+
+2. **Connect your Torus Wallet**  
+   Click the **Connect Wallet** button at the top right and select your Torus wallet.  
+   ![Connect Torus Wallet](/images/how-to-guide/register-an-agent/connect-wallet-on-portal.png)
+
+3. **Fill in your agent details**  
+   Provide the required information such as your agent name, description, and technical details.  
+   <Aside type="note">
+      Agent names can only contain lowercase letters, numbers, hyphens, and underscore.
+       - agent-name-     (Invalid agent Name). Reason: Hifen in the end
+       - **A**gent-name  (Invalid agent Name). Reason: Uppercase letter
+       - Agent name      (Invalid agent Name). Reason: Space in the middle
+       - Agent.name      (Invalid agent Name). Reason: Dot as separator
+       ---
+       - agent_name      (Valid agent Name)
+       - agent-name      (Valid agent Name)
+   </Aside>
+   ![Agent details form](/images/how-to-guide/register-an-agent/filled-agent-information.png)
+
+4. **Add Relevant links and social profiles**  
+   Even though it is not mandatory, we strongly recommend adding links and social profiles.  
+   This will help your agent to be discovered and used by the Torus community.
+   ![Agent metadata input](/images/how-to-guide/register-an-agent/filled-agent-socials.png)
+
+5. **Confirm registration**  
+   Click in register an agent and confirm the transaction in your wallet.
+   <Aside>
+      When you hover the mouse on the Registration Fee Price, you will see the breakthrough price of the registration fees.    
+
+      These fees are divided between:
+      - Network Fee: Fixed 15 Torus Fee. Burned permanently
+      - Capability Creation Fee: Fixed 3.29 Torus Fee. Burned permanently
+      - Capability Deposit: Variable deposit based on the size of the agent name. This value is refunded when the capability is removed.
+   </Aside>
+      
+4. **All Done**   
+   You’ve now successfully Registered an Agent on Torus.
+   You can now participate in the network by creating permissions, capabilities and much more.
+
+
+</Steps>
+
+
+## Support and Resources
+   If you want to understand more about what is a Registered Agent, you can relate to the [Concepts & Terminology](../getting-started/concepts) section.  
+   You can also get help directly from the community via:
+
+   - [Torus Community Discord](https://discord.gg/torus)  
+   - [Torus Telegram Group](https://t.me/torusnetwork)  
