Merge pull request #16 from renlabs-dev/dev

Moved how to guides to the top and added a start here file to guide users

Author: Sipher

astro.config.mjs

@@ -26,12 +26,24 @@ export default defineConfig({
           label: "Getting Started",
           items: [
             { label: "Introduction", slug: "index" },
+            { label: "Tokenomics", slug: "concepts/tokenomics" },
             {
               label: "Concepts & Terminology",
               slug: "getting-started/concepts",
             },
-            { label: "Setup CLI", slug: "getting-started/setup-cli" },
-            { label: "Setup Wallet", slug: "getting-started/setup-wallet" },
+          ],
+        },
+        {
+          label: "How-to Guides",
+          items: [
+            { label: "Start Here", slug: "how-to-guides/start-here" },
+            { 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: "Edit your Agent", slug: "how-to-guides/edit-your-agent" },
+            { label: "Setup CLI", slug: "how-to-guides/setup-cli" },
           ],
         },
         {
@@ -45,7 +57,6 @@ export default defineConfig({
               slug: "v05/capability-permissions",
             },
             { label: "Emission Permissions", slug: "v05/emission-permissions" },
-            { label: "Tokenomics", slug: "concepts/tokenomics" },
             { label: "Governance & DAO", slug: "concepts/governance-dao" },
           ],
         },
@@ -99,20 +110,6 @@ export default defineConfig({
             },
           ],
         },
-        {
-          label: "How-to Guides",
-          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",
-            // },
-          ],
-        },
       ],
       customCss: ["./src/tailwind.css"],
     }),

public/images/how-to-guide/edit-your-agent/allocator-card-edit-agent.png

@@ -23,7 +23,7 @@ The AgentServer uses **Hono** for HTTP routing and **Zod** for input validation,
 - **Namespace Permissions**: Blockchain-based access control
 - **OpenAPI Documentation**: Automatic API documentation generation
 - **Type Safety**: Full TypeScript support with Zod schemas
-- **Blockchain Integration**: Direct connection to Torus Network
+- **Blockchain Integration**: Direct connection to Torus
 
 ## Installation
 
@@ -180,7 +180,7 @@ const agent = new AgentServer({
 
 ## Namespace Permissions
 
-The AgentServer integrates with Torus Network's capability permission system for fine-grained access control.
+The AgentServer integrates with Torus capability permission system for fine-grained access control.
 
 ### Basic Namespace Protection
 

public/images/how-to-guide/edit-your-agent/allocator-success-toast.png

@@ -14,14 +14,14 @@ import daoShapeTheNetwork from '/public/images/how-to-guide/become-a-root-agent/
 import selectTheWhitelistOption from '/public/images/how-to-guide/become-a-root-agent/select-the-whitelist-option.png';
 
 
-In this guide, we’ll walk through how to **apply to become a Root Agent** on the Torus Network.  
+In this guide, we'll walk through how to **apply to become a Root Agent** on Torus.  
 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.  
+- You don't need to be a Root Agent to actively participate in Torus.  
 - 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](https://docs.torus.network/how-to-guides/register-an-agent/).
@@ -44,7 +44,7 @@ Becoming a Root Agent allows you to receive emissions directly from the root and
   </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](https://docs.torus.network/how-to-guides/bridge-to-base/).
+    You can find a [guide on how to bridge TORUS here](https://docs.torus.network/how-to-guides/bridge-to-base/).
   </Card>
   <Card title="Discord Account" icon="discord">
     Have a valid Discord account and join the official [Torus Discord
@@ -63,14 +63,14 @@ Becoming a Root Agent allows you to receive emissions directly from the root and
 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.  
+3. **Click on Shape the Network Button**  
+    It is located in the top right corner of the dashboard.  
     It will open a modal with a form to apply for whitelisting.
     <ClickableImage src={daoShapeTheNetwork} alt="Shape the network button" />
 
 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.
+    In the 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.
@@ -82,24 +82,24 @@ Becoming a Root Agent allows you to receive emissions directly from the root and
     <ClickableImage src={selectTheWhitelistOption} alt="Select whitelist option" />
 
 5. **Submit Proposal**  
-    Click in **Submit Proposal** and confirm the transaction in your wallet after you filled in the form.
+    After filling in the form, click **Submit Proposal** and confirm the transaction in your wallet.
     <Aside>
-        The proposal cost (**100 Torus**) will be deducted from your connected wallet.
+        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.  
+   You've now successfully Applied 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](https://docs.torus.network/getting-started/concepts/) section.  
+   If you want to understand more about the core differences between a Registered agent and a Whitelisted agent, you can refer to the [Concepts & Terminology](https://docs.torus.network/getting-started/concepts/) section.  
    You can also get help directly from the community via:
 
    - [Torus Community Discord](https://discord.gg/torus)  

public/images/how-to-guide/register-an-agent/registered-agent-on-allocator-page.png

@@ -1,6 +1,6 @@
 ---
 title: Bridge Torus from Base to Torus
-description: Bridging from Torus Base all the way to Native Torus on the Torus Network.
+description: Bridging from Torus Base all the way to Native TORUS on the Network.
 ---
 
 import {
@@ -19,23 +19,25 @@ import fillInFormToConvertTorusEvmNativeTorus from '/public/images/how-to-guide/
 import confirmTransactionInMetamaskTorusEvmToTorus from '/public/images/how-to-guide/bridge-to-base/confirm-transaction-in-metamask-torus-evm-to-torus.png';
 import torusEvmConvertSuccessfully from '/public/images/how-to-guide/bridge-to-base/torus-evm-convert-successfully.png';
 
-In this guide, we’ll **bridge Torus between the Torus Network and Base**.  
-This process is necessary in order to obtain **Native Torus**, which is required to interact with the Torus Network directly.
+In this guide, we'll **bridge TORUS between Torus and Base**.  
+This process is necessary in order to obtain **Native TORUS**, which is required to interact with Torus directly.
 
-**Native Torus** is used for essential on-chain actions, such as:
+**Native TORUS** is used for essential on-chain actions, such as:
 
 - Registering an Agent
 - Becoming a Root Agent  
 - Creating a permission  
 - Creating a signal  
 - And more...
 
-For the sake of simplicity, we are going to refer to the **Native Torus** as **Torus**.
+To keep things clear and concise, **Native TORUS** will be referred to as **TORUS** from this point forward.
+
+
 
 #### What we will accomplish
 
-- Bridge Torus on Base to Torus EVM
-- Bridge from Torus EVM to Torus
+- Bridge TORUS on Base to TORUS EVM
+- Bridge from TORUS EVM to TORUS
 
 <Aside>
 ⏱️ **Estimated time to complete this guide: 20 minutes**
@@ -51,17 +53,17 @@ For the sake of simplicity, we are going to refer to the **Native Torus** as **T
     If you don't have one, you can follow the [setup guide here](https://docs.torus.network/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.  
+  <Card title="Base TORUS Wallet" icon="seti:config">
+    For this guide, we will be using [MetaMask](https://metamask.io/) as our wallet of choice.  
     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. */}
+    {/* 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>
 
 ---
 
 <Aside type="danger">
-  Avoid using SubWallet to have BASE Torus on it, as it will cause issues with the bridge that could result in loss of funds.
+  Avoid storing BASE TORUS in SubWallet, as it will cause issues with the bridge that could result in loss of funds.
 </Aside> 
 
 ## Steps for the Bridge Process
@@ -70,14 +72,14 @@ For the sake of simplicity, we are going to refer to the **Native Torus** as **T
 
 <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)**.   
+1. **Connect both the Torus and MetaMask wallets in the [Base Bridge Web App](https://bridge.torus.network/?tab=base&from=base&to=torus)**.   
    At the top right corner of the app, connect both your **Torus Wallet** and **MetaMask**.
-   <ClickableImage src={metamaskSubwalletConnect} alt="SubWallet and Metamask connect screen" />
+   <ClickableImage src={metamaskSubwalletConnect} alt="SubWallet and MetaMask connect screen" />
 
-2. **Swap from Base Torus to Torus EVM**  
-    - Make sure you are **connected** in **Both Wallets**
-    - Make sure you are in the **correct Tab**, **TORUS EVM - Base**
-    - Make sure it is **FROM** Base Torus **TO** Torus EVM
+2. **Swap from Base TORUS to Torus EVM**  
+    - Make sure you are **connected** to **both wallets**
+    - Make sure you are on the **correct tab**, **TORUS EVM - Base**
+    - Make sure it is **FROM** Base TORUS **TO** Torus EVM
 
    Fill in the form with the amount you want to convert and the Recipient Address, by clicking on the Self button, it will automatically fill the address for you with your connected base wallet.
    With all the information filled in, click **Continue**.
@@ -87,15 +89,15 @@ For the sake of simplicity, we are going to refer to the **Native Torus** as **T
 3. **Confirm the transaction**   
    After filling in the form, you will be prompted to confirm the transaction in Metamask.
    <Aside type="caution">
-      Always verify the transaction in Metamask before signing it, it is of your responsibility to verify the transaction details.  
-      You also must have enough funds in your Metamask wallet to cover the transaction fees.
+      Always verify the transaction in MetaMask before signing it, as it is your responsibility to verify the transaction details.  
+      You also must have enough funds in your MetaMask wallet to cover the transaction fees.
    </Aside>
-   <ClickableImage src={confirmTransactionInMetamask} alt="Confirm the transaction in Metamask" />
+   <ClickableImage src={confirmTransactionInMetamask} alt="Confirm the transaction in MetaMask" />
 
 4. **Confirmation of the swap**  
-   After the transaction succeeds, your Base Torus should now be displayed as Torus EVM as it was successfully swapped.  
-   This process can take a while to happen in the chain side,
-   so please, wait a few minutes and refresh the [Base Bridge Web App](https://bridge.torus.network/?tab=base&from=base&to=torus).   
+   After the transaction succeeds, your Base TORUS should now be displayed as Torus EVM as it was successfully swapped.  
+   This process can take a while to complete on the blockchain,
+   so please wait a few minutes and refresh the [Base Bridge Web App](https://bridge.torus.network/?tab=base&from=base&to=torus).   
    If you have any issues, reach out to our support on the [Official Torus Discord](https://discord.gg/torus).  
    <ClickableImage src={baseTorusSwappedSuccessfully} alt="Confirmation of the swap" />
 
@@ -107,9 +109,9 @@ For the sake of simplicity, we are going to refer to the **Native Torus** as **T
 ### 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)**.   
+1. **Connect both the Torus and MetaMask wallets in the [Base Bridge Web App](https://bridge.torus.network/?tab=base&from=base&to=torus)**.   
    At the top right corner of the app, connect both your **Torus Wallet** and **MetaMask**.
-   <ClickableImage src={metamaskConnectEvm} alt="SubWallet and Metamask connect screen" />
+   <ClickableImage src={metamaskConnectEvm} alt="SubWallet and MetaMask connect screen" />
 
 
 1. **Swap from Torus EVM to Torus**
@@ -118,32 +120,32 @@ For the sake of simplicity, we are going to refer to the **Native Torus** as **T
    - Make sure it is **FROM** Torus EVM **TO** Torus
 
    Fill in the form with the amount you want to convert, after confirmation, you will be prompted to sign the transaction in Torus.
-   <ClickableImage src={fillInFormToConvertTorusEvmNativeTorus} alt="Convert Torus EVM to Native Torus" />
+   <ClickableImage src={fillInFormToConvertTorusEvmNativeTorus} alt="Convert Torus EVM to Native TORUS" />
 
 2. **Confirm the transaction**  
    After filling in the form, you will be prompted to confirm the transaction in Metamask.
    <Aside type="caution">
-      Always verify the transaction in Metamask before signing it, it is of your responsibility to verify the transaction details.  
-      You also must have enough funds in your Metamask wallet to cover the transaction fees.
+      Always verify the transaction in MetaMask before signing it, as it is your responsibility to verify the transaction details.  
+      You also must have enough funds in your MetaMask wallet to cover the transaction fees.
    </Aside>
 
-   <ClickableImage src={confirmTransactionInMetamaskTorusEvmToTorus} alt="Confirm the transaction in Metamask" />
+   <ClickableImage src={confirmTransactionInMetamaskTorusEvmToTorus} alt="Confirm the transaction in MetaMask" />
 
 3. **Confirmation of the swap**  
-   After the transaction succeeds, your Torus EVM should now be displayed as Torus as it was successfully swapped.
-   This process can take a while to happen in the chain side,
-   so please, wait a few minutes and refresh the [Base Bridge Web App](https://bridge.torus.network/?tab=base&from=base&to=torus).   
+   After the transaction succeeds, your Torus EVM should now be displayed as TORUS as it was successfully swapped.
+   This process can take a while to complete on the blockchain,
+   so please wait a few minutes and refresh the [Base Bridge Web App](https://bridge.torus.network/?tab=base&from=base&to=torus).   
    <ClickableImage src={torusEvmConvertSuccessfully} alt="Confirmation of the swap" />
 
 4. **All Done**   
-   You’ve now successfully bridged Torus tokens between **Torus**, **Torus EVM**, and **Base**.  
+   You've now successfully bridged TORUS tokens between **Torus**, **Torus EVM**, and **Base**.  
    You can view your updated balances directly in the [Torus Web App](https://wallet.torus.network) or SubWallet.
 </Steps>
 
 
 ## Support and Resources
    By following these steps, you can successfully bridge your tokens between Torus, Torus EVM, and Base.
-   Holding native Torus is required to interact with the Torus Network, and currently, this is the only supported method for bridging.  
+   Holding native TORUS is required to interact with Torus, and currently, this is the only supported method for bridging.  
    If you need help or have questions, you can reach out through the official community channels:
 
    - [Torus Community Telegram](https://t.me/torusnetwork)