renlabs-dev · rodrigooler · Aug 4, 2025
diff --git a/.gitignore b/.gitignore
@@ -23,3 +23,7 @@ pnpm-debug.log*
 .DS_Store
 
 .env.local
+
+# Crush local data
+.crush/
+CRUSH.md
diff --git a/astro.config.mjs b/astro.config.mjs
@@ -88,6 +88,7 @@ export default defineConfig({
               items: [
                 { label: "Setup a Wallet", slug: "how-to-guides/holders/setup-a-wallet" },
                 { label: "Bridge from Base", slug: "how-to-guides/holders/bridge-from-base" },
+                { label: "Torus EVM Network", slug: "how-to-guides/holders/torus-evm-network" },
                 { label: "Stake your Torus", slug: "how-to-guides/holders/stake-your-torus" },
               ],
             },

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
@@ -8,17 +8,17 @@ import {
   Aside,
   CardGrid,
   LinkCard,
-  Card
+  Card,
 } from "@astrojs/starlight/components";
 
-import ClickableImage from '/src/components/ClickableImage.astro';
-import subwalletExtensionActivated from '/public/images/how-to-guide/setup-wallet/subwallet-extension-activated.png';
-import subwalletCreatedSuccessfully from '/public/images/how-to-guide/setup-wallet/subwallet-created-successfully.png';
-import subwalletOpenSetup from '/public/images/how-to-guide/setup-wallet/subwallet-open-setup.png';
-import subwalletSelectConfigToAddNetwork from '/public/images/how-to-guide/setup-wallet/subwallet-select-config-to-add-network.png';
-import subwalletSearchTorusNetwork from '/public/images/how-to-guide/setup-wallet/subwallet-search-torus-network.png';
-import subwalletDoneTorusSetup from '/public/images/how-to-guide/setup-wallet/subwallet-done-torus-setup.png';
-import RedText from '/src/components/RedText.astro';
+import ClickableImage from "/src/components/ClickableImage.astro";
+import subwalletExtensionActivated from "/public/images/how-to-guide/setup-wallet/subwallet-extension-activated.png";
+import subwalletCreatedSuccessfully from "/public/images/how-to-guide/setup-wallet/subwallet-created-successfully.png";
+import subwalletOpenSetup from "/public/images/how-to-guide/setup-wallet/subwallet-open-setup.png";
+import subwalletSelectConfigToAddNetwork from "/public/images/how-to-guide/setup-wallet/subwallet-select-config-to-add-network.png";
+import subwalletSearchTorusNetwork from "/public/images/how-to-guide/setup-wallet/subwallet-search-torus-network.png";
+import subwalletDoneTorusSetup from "/public/images/how-to-guide/setup-wallet/subwallet-done-torus-setup.png";
+import RedText from "/src/components/RedText.astro";
 
 In this guide, we'll walk through setting up a wallet with the <RedText variant="light">**SubWallet** browser extension</RedText>, a popular non-custodial wallet for managing assets across multiple blockchains.  
 If you prefer a different extension, scroll to the bottom for a list of other wallets that work with Torus.  
@@ -34,13 +34,11 @@ You need a wallet to hold TORUS and interact with Torus - it's required for stak
 - Create a new wallet (master password + seed phrase)
 - Connect SubWallet to Torus
 
-<Aside>
-⏱️ **Estimated time to complete this guide: 5 minutes**
-</Aside>
+<Aside>⏱️ **Estimated time to complete this guide: 5 minutes**</Aside>
 
 ## Steps to connect your SubWallet to Torus.
 
-###  Installing the SubWallet Extension
+### Installing the SubWallet Extension
 
 <Steps>
 
@@ -59,29 +57,31 @@ You need a wallet to hold TORUS and interact with Torus - it's required for stak
 
     </span>
 
-    <ClickableImage src={subwalletExtensionActivated} alt="SubWallet extension activated in Brave browser" />
+    <ClickableImage
+      src={subwalletExtensionActivated}
+      alt="SubWallet extension activated in Brave browser"
+    />
 
 </Steps>
 
-
 ### Creating a New Account
 
  <Steps>
 
-1.  **Open the SubWallet extension in your browser**   
+1.  **Open the SubWallet extension in your browser**  
      Click on the SubWallet icon in your browser’s extension area to open the wallet.
 
 2.  **Click Create a New Account**  
      You will be prompted between three options:
 
     - Create new account
     - Import account
-    - Connect existing account   
-
-    Select the **"Create new account"** option.
+    - Connect existing account  
+
 
+    Select the **"Create new account"** option.
 
-3.  **Create a Master Password**   
+3.  **Create a Master Password**  
     You will be prompted to create a master password. <RedText variant="light">This password is crucial as it encrypts your wallet data on your device for security.</RedText>
 
 4.  **Backup Your Seed Phrase**  
@@ -95,7 +95,7 @@ You need a wallet to hold TORUS and interact with Torus - it's required for stak
 
     </Aside>
 
-5.  **Create an account name**:   
+5.  **Create an account name**:  
     Choose an account name, this does not impact anything, so feel free to choose any name you like. If you want to change it later, you can do so from the account settings.
 
         <span style={{ fontSize: "0.9rem", fontStyle: "italic" }}>
@@ -105,56 +105,70 @@ You need a wallet to hold TORUS and interact with Torus - it's required for stak
 
         </span>
 
-    <ClickableImage src={subwalletCreatedSuccessfully} alt="SubWallet account successfully created" />
+    <ClickableImage
+      src={subwalletCreatedSuccessfully}
+      alt="SubWallet account successfully created"
+    />
 
 </Steps>
 
- ### Adding Torus to the Subwallet
+### Adding Torus to the Subwallet
 
 <Steps>
 
-  1. **Open the Subwallet Setup**  
-    Click on the three bars (**☰**) on the top left corner of the subwallet extension.    
-     <ClickableImage src={subwalletOpenSetup} alt="SubWallet setup button" />
+1. **Open the Subwallet Setup**  
+   Click on the three bars (**☰**) on the top left corner of the subwallet extension.
 
-  2. **Select Manage Networks**   
-  Under the **Assets & Addresses** tab, click on <RedText variant="light">**Manage Networks**</RedText>.
-     <ClickableImage src={subwalletSelectConfigToAddNetwork} alt="SubWallet manage networks button" />
+   {" "}
+   <ClickableImage src={subwalletOpenSetup} alt="SubWallet setup button" />
 
+2. **Select Manage Networks**  
+   Under the **Assets & Addresses** tab, click on <RedText variant="light">**Manage Networks**</RedText>.
 
- 3. **Search for Torus and activate it**    
-    Click on the search bar, type Torus, and select it from the list. <RedText variant="light">Make sure to enable it</RedText> so it appears in your list of active tokens.
-    <ClickableImage src={subwalletSearchTorusNetwork} alt="SubWallet search for Torus button" /> 
-     <Aside type="caution">
-      If you don't see **Torus** in the list, you might need to add it manually.  
-      Follow the steps in this [video tutorial by Omni Labs](https://www.youtube.com/watch?v=3JDQFYg0u_A&t=172s).
+   {" "}
+   <ClickableImage
+     src={subwalletSelectConfigToAddNetwork}
+     alt="SubWallet manage networks button"
+   />
 
-    **RPC URL:** `wss://api.torus.network`
-    </Aside>
+3. **Search for Torus and activate it**  
+   Click on the search bar, type Torus, and select it from the list. <RedText variant="light">Make sure to enable it</RedText> so it appears in your list of active tokens.
+
+   <ClickableImage src={subwalletSearchTorusNetwork} alt="SubWallet search for Torus button" /> 
+ <Aside type="caution">
+  If you don't see **Torus** in the list, you might need to add it manually.  
+  Follow the steps in this [video tutorial by Omni Labs](https://www.youtube.com/watch?v=3JDQFYg0u_A&t=172s).
+
+   **RPC URL:** `wss://api.torus.network`
 
-4. **Confirm Torus is active**   
-    Once enabled, **Torus** will appear in your list of active networks.    
-    You might have to scroll down to find Torus in the list.  
-    <ClickableImage src={subwalletDoneTorusSetup} alt="SubWallet network list with torus" /> 
+   </Aside>
 
+4. **Confirm Torus is active**  
+   Once enabled, **Torus** will appear in your list of active networks.  
+   You might have to scroll down to find Torus in the list.
 
+   <ClickableImage
+     src={subwalletDoneTorusSetup}
+     alt="SubWallet network list with torus"
+   />{" "}
 
 5. **All Done**  
    Torus is now connected to your SubWallet.  
    You’re ready to explore the Torus ecosystem and manage your assets securely.
 
 </Steps>
 
-
 ## What's Next?
 
 Now that you have a wallet set up, you can:
 
 - **Get TORUS**: [Bridge from Base](https://docs.torus.network/how-to-guides/holders/bridge-from-base/) to get TORUS into your wallet
+- **Torus EVM Network**: If your wallet doesn’t auto-switch during bridging, [add Torus EVM manually](https://docs.torus.network/how-to-guides/holders/add-torus-evm-network/)
 
 For SubWallet-specific help, check the [SubWallet Documentation](https://docs.subwallet.app/main).
 
- Connect with the community:
+Connect with the community:
+
 - [Discord](https://discord.gg/torus) — Technical discussions, support, and announcements
 - [Telegram](https://t.me/torusnetwork) — General chat and announcements
 - [Twitter](https://x.com/torus_network) — Updates and ecosystem news

diff --git a/src/content/docs/how-to-guides/holders/torus-evm-network.mdx b/src/content/docs/how-to-guides/holders/torus-evm-network.mdx
@@ -0,0 +1,87 @@
+---
+title: Torus EVM Network
+sidebar:
+  label: Torus EVM Network
+  order: 40
+---
+
+import { Steps, Aside, CardGrid, Card } from "@astrojs/starlight/components";
+
+In this guide, you'll add the Torus EVM network to your wallet so dapps and the Bridge can connect reliably.
+
+<Aside type="note">
+We automatically prompt a network switch in the Bridge flow. If that fails or your wallet doesn’t switch networks, follow this guide to add Torus EVM manually.
+</Aside>
+
+## What you will do
+
+- Add the Torus EVM network to your wallet
+- Verify RPC/Explorer are reachable
+- (Optional) Enable Torus EVM on Coinbase Wallet via custom networks
+
+## Prerequisites
+
+<CardGrid>
+  <Card title="An EVM Wallet" icon="seti:config">
+    Any EVM-compatible wallet (Coinbase Wallet, MetaMask, Rabby, etc.)
+  </Card>
+  <Card title="Funds for gas" icon="seti:json">
+    You might need a small amount of TORUS to send transactions on Torus EVM.
+  </Card>
+</CardGrid>
+
+---
+
+## Network configuration
+
+- Network Name: Torus EVM
+- Chain ID: 21000
+- Currency Symbol: TORUS
+- Decimals: 18
+
+### RPC URLs
+- Primary RPC: https://api.torus.network
+- Alternate RPC: https://api-hyperlane.nodes.torus.network
+
+### Explorer
+- Block Explorer: https://blockscout.torus.network
+- Explorer API: https://api.blockscout.torus.network/api
+
+---
+
+## Add to Coinbase Wallet
+
+Reference: https://www.coinbase.com/learn/wallet/How-to-add-custom-networks-Coinbase-Wallet
+
+<Steps>
+1. Open Coinbase Wallet → Settings
+2. Tap Active dapp network → + (Add custom network)
+3. Fill:
+   - Name: Torus EVM
+   - RPC URL: https://api.torus.network
+   - Chain ID: 21000
+   - Symbol: TORUS
+   - Explorer: https://blockscout.torus.network
+4. Save → toggle it as Active network
+5. Send a small amount of TORUS to see your balance on Torus EVM
+</Steps>
+
+<Aside>
+Custom networks let Coinbase Wallet access more ecosystems and dapps. EVM-compatible networks share the same address format, so your Ethereum address is also valid on Torus EVM.
+</Aside>
+
+---
+
+## Add to other EVM wallets (generic)
+
+<Steps>
+1. Open your wallet → Settings
+2. Select Networks → Add Network
+3. Paste the configuration above
+4. Save, switch to Torus EVM, and retry your action (e.g., the Bridge)
+</Steps>
+
+### Troubleshooting
+- RPC errors: try the Alternate RPC URL
+- Stuck on wrong network: refresh the dapp and re-connect the wallet
+- Tokens not visible: import token by contract address on Torus EVM
diff --git a/src/content/docs/how-to-guides/table-of-contents.mdx b/src/content/docs/how-to-guides/table-of-contents.mdx
@@ -2,29 +2,29 @@
 title: Table of Contents
 description: Step-by-step walkthroughs to help users and builders interact with Torus.
 ---
+
 import {
   Steps,
   Aside,
   CardGrid,
   Card,
   Tabs,
-  TabItem
+  TabItem,
 } from "@astrojs/starlight/components";
 
 Welcome to the **How-to Guides** section of the Torus documentation.
 
-These guides are focused, practical, and designed to help you achieve specific outcomes within the Torus ecosystem, without distractions or deep dives into theory.   
-If you prefer to start with the theory first, begin with [Explanations](https://docs.torus.network/explanations/table-of-contents) and continue from there.   
+These guides are focused, practical, and designed to help you achieve specific outcomes within the Torus ecosystem, without distractions or deep dives into theory.  
+If you prefer to start with the theory first, begin with [Explanations](https://docs.torus.network/explanations/table-of-contents) and continue from there.  
 Whether you're here to use Torus, build on it, or coordinate its evolution, there's a guide to get you there.
 
-
-
 ## For Torus Holders
 
 If you want to interact with Torus as an end-user or holder:
 
 - [Set up a Wallet](https://docs.torus.network/how-to-guides/holders/setup-a-wallet/)
 - [Bridge from Base](https://docs.torus.network/how-to-guides/holders/bridge-from-base/)
+- [Add Torus EVM Network](https://docs.torus.network/how-to-guides/holders/add-torus-evm-network/)
 - [Stake your TORUS](https://docs.torus.network/how-to-guides/holders/stake-your-torus/)
 
 ---
@@ -35,26 +35,26 @@ If you're developing tools, services, or integrations on Torus:
 
 - [Register an Agent](https://docs.torus.network/how-to-guides/builders/register-an-agent/)
 - [Edit your Agent](https://docs.torus.network/how-to-guides/builders/edit-your-agent/)
-- [Manage Permissions](https://docs.torus.network/how-to-guides/builders/manage-permissions/) 
+- [Manage Permissions](https://docs.torus.network/how-to-guides/builders/manage-permissions/)
 - [Manage Capabilities](https://docs.torus.network/how-to-guides/builders/manage-capabilities/)
 - [Create a Signal](https://docs.torus.network/how-to-guides/builders/create-signal/)
 - [Setup Agent Server](https://docs.torus.network/how-to-guides/builders/setup-agent-server/)
 - [Setup Agent Client](https://docs.torus.network/how-to-guides/builders/setup-agent-client/)
 
 ---
 
-## For Root Goal-Setters and Leaders  
+## For Root Goal-Setters and Leaders
+
 _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/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._  
+- _See the [Governance & DAO](https://docs.torus.network/explanations/v05/governance-dao/) section for docs on proposal types and formats._
 
 ---
 
-
 ## Additional Resources
 
 Can’t find the guide you’re looking for? Connect with us through our community channels:
@@ -63,11 +63,10 @@ Can’t find the guide you’re looking for? Connect with us through our communi
 - **[Torus Telegram](https://t.me/torusnetwork)** — Quick help, casual discussion, and important updates.
 - **[Torus Twitter](https://twitter.com/torus_network)** — Stay up to date with announcements and news from the Torus ecosystem.
 
-
 ### Core Projects
 
 Torus is fully open source. You’re welcome to explore, contribute, or report issues:
 
 - **[torus-substrate](https://github.com/renlabs-dev/torus-substrate)** — Core blockchain runtime built on Substrate.
-- **[torus-ts](https://github.com/renlabs-dev/torus-ts)**               — TypeScript SDK for building on Torus and WebApps.
-- **[torus-docs](https://github.com/renlabs-dev/torus-docs)**           — This documentation.
+- **[torus-ts](https://github.com/renlabs-dev/torus-ts)** — TypeScript SDK for building on Torus and WebApps.
+- **[torus-docs](https://github.com/renlabs-dev/torus-docs)** — This documentation.