diff --git a/.gitignore b/.gitignore
index 58ba907..0dd80fd 100644
--- a/.gitignore
+++ b/.gitignore
@@ -23,3 +23,7 @@ pnpm-debug.log*
.DS_Store
.env.local
+
+# Crush local data
+.crush/
+CRUSH.md
\ No newline at end of file
diff --git a/astro.config.mjs b/astro.config.mjs
index 16e6186..bea82c5 100644
--- 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
index e0089d2..81222e6 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
@@ -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 **SubWallet** browser extension, 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
-
+
## Steps to connect your SubWallet to Torus.
-### Installing the SubWallet Extension
+### Installing the SubWallet Extension
@@ -59,16 +57,18 @@ You need a wallet to hold TORUS and interact with Torus - it's required for stak
-
+
-
### Creating a New Account
-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**
@@ -76,12 +76,12 @@ You need a wallet to hold TORUS and interact with Torus - it's required for stak
- 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. This password is crucial as it encrypts your wallet data on your device for security.
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
-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.
@@ -105,39 +105,52 @@ You need a wallet to hold TORUS and interact with Torus - it's required for stak
-
+
- ### Adding Torus to the Subwallet
+### Adding Torus to the Subwallet
- 1. **Open the Subwallet Setup**
- Click on the three bars (**☰**) on the top left corner of the subwallet extension.
-
+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 **Manage Networks**.
-
+ {" "}
+
+2. **Select Manage Networks**
+ Under the **Assets & Addresses** tab, click on **Manage Networks**.
- 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.
-
-
+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.
+
+
+
+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.
+ {" "}
5. **All Done**
Torus is now connected to your SubWallet.
@@ -145,16 +158,17 @@ You need a wallet to hold TORUS and interact with Torus - it's required for stak
-
## 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
new file mode 100644
index 0000000..31baa25
--- /dev/null
+++ 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.
+
+
+
+## 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
+
+
+
+ Any EVM-compatible wallet (Coinbase Wallet, MetaMask, Rabby, etc.)
+
+
+ You might need a small amount of TORUS to send transactions on Torus EVM.
+
+
+
+---
+
+## 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
+
+
+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
+
+
+
+
+---
+
+## Add to other EVM wallets (generic)
+
+
+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)
+
+
+### 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
index b0cd0d7..ab58ce0 100644
--- 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,7 +35,7 @@ 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/)
@@ -43,18 +43,18 @@ If you're developing tools, services, or integrations on Torus:
---
-## 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.