Skip to content

Commit 2c68e61

Browse files
committed
feat: add Torus EVM Network guide and update documentation
- Introduced a new guide for adding the Torus EVM network to wallets, including configuration details and troubleshooting tips. - Updated the Table of Contents to include the new Torus EVM Network guide. - Added a link to the Torus EVM Network in the existing setup wallet guide for improved user navigation. - Enhanced .gitignore to include local data and documentation files related to the new feature.
1 parent 1fd6a77 commit 2c68e61

5 files changed

Lines changed: 160 additions & 55 deletions

File tree

.gitignore

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -23,3 +23,7 @@ pnpm-debug.log*
2323
.DS_Store
2424

2525
.env.local
26+
27+
# Crush local data
28+
.crush/
29+
CRUSH.md

astro.config.mjs

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -88,6 +88,7 @@ export default defineConfig({
8888
items: [
8989
{ label: "Setup a Wallet", slug: "how-to-guides/holders/setup-a-wallet" },
9090
{ label: "Bridge from Base", slug: "how-to-guides/holders/bridge-from-base" },
91+
{ label: "Torus EVM Network", slug: "how-to-guides/holders/torus-evm-network" },
9192
{ label: "Stake your Torus", slug: "how-to-guides/holders/stake-your-torus" },
9293
],
9394
},

src/content/docs/how-to-guides/holders/setup-a-wallet.mdx

Lines changed: 57 additions & 43 deletions
Original file line numberDiff line numberDiff line change
@@ -8,17 +8,17 @@ import {
88
Aside,
99
CardGrid,
1010
LinkCard,
11-
Card
11+
Card,
1212
} from "@astrojs/starlight/components";
1313

14-
import ClickableImage from '/src/components/ClickableImage.astro';
15-
import subwalletExtensionActivated from '/public/images/how-to-guide/setup-wallet/subwallet-extension-activated.png';
16-
import subwalletCreatedSuccessfully from '/public/images/how-to-guide/setup-wallet/subwallet-created-successfully.png';
17-
import subwalletOpenSetup from '/public/images/how-to-guide/setup-wallet/subwallet-open-setup.png';
18-
import subwalletSelectConfigToAddNetwork from '/public/images/how-to-guide/setup-wallet/subwallet-select-config-to-add-network.png';
19-
import subwalletSearchTorusNetwork from '/public/images/how-to-guide/setup-wallet/subwallet-search-torus-network.png';
20-
import subwalletDoneTorusSetup from '/public/images/how-to-guide/setup-wallet/subwallet-done-torus-setup.png';
21-
import RedText from '/src/components/RedText.astro';
14+
import ClickableImage from "/src/components/ClickableImage.astro";
15+
import subwalletExtensionActivated from "/public/images/how-to-guide/setup-wallet/subwallet-extension-activated.png";
16+
import subwalletCreatedSuccessfully from "/public/images/how-to-guide/setup-wallet/subwallet-created-successfully.png";
17+
import subwalletOpenSetup from "/public/images/how-to-guide/setup-wallet/subwallet-open-setup.png";
18+
import subwalletSelectConfigToAddNetwork from "/public/images/how-to-guide/setup-wallet/subwallet-select-config-to-add-network.png";
19+
import subwalletSearchTorusNetwork from "/public/images/how-to-guide/setup-wallet/subwallet-search-torus-network.png";
20+
import subwalletDoneTorusSetup from "/public/images/how-to-guide/setup-wallet/subwallet-done-torus-setup.png";
21+
import RedText from "/src/components/RedText.astro";
2222

2323
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.
2424
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
3434
- Create a new wallet (master password + seed phrase)
3535
- Connect SubWallet to Torus
3636

37-
<Aside>
38-
⏱️ **Estimated time to complete this guide: 5 minutes**
39-
</Aside>
37+
<Aside>⏱️ **Estimated time to complete this guide: 5 minutes**</Aside>
4038

4139
## Steps to connect your SubWallet to Torus.
4240

43-
### Installing the SubWallet Extension
41+
### Installing the SubWallet Extension
4442

4543
<Steps>
4644

@@ -59,29 +57,31 @@ You need a wallet to hold TORUS and interact with Torus - it's required for stak
5957

6058
</span>
6159

62-
<ClickableImage src={subwalletExtensionActivated} alt="SubWallet extension activated in Brave browser" />
60+
<ClickableImage
61+
src={subwalletExtensionActivated}
62+
alt="SubWallet extension activated in Brave browser"
63+
/>
6364

6465
</Steps>
6566

66-
6767
### Creating a New Account
6868

6969
<Steps>
7070

71-
1. **Open the SubWallet extension in your browser**
71+
1. **Open the SubWallet extension in your browser**
7272
Click on the SubWallet icon in your browser’s extension area to open the wallet.
7373

7474
2. **Click Create a New Account**
7575
You will be prompted between three options:
7676

7777
- Create new account
7878
- Import account
79-
- Connect existing account
80-
81-
Select the **"Create new account"** option.
79+
- Connect existing account
80+
8281

82+
Select the **"Create new account"** option.
8383

84-
3. **Create a Master Password**
84+
3. **Create a Master Password**
8585
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>
8686

8787
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
9595

9696
</Aside>
9797

98-
5. **Create an account name**:
98+
5. **Create an account name**:
9999
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.
100100

101101
<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
105105

106106
</span>
107107

108-
<ClickableImage src={subwalletCreatedSuccessfully} alt="SubWallet account successfully created" />
108+
<ClickableImage
109+
src={subwalletCreatedSuccessfully}
110+
alt="SubWallet account successfully created"
111+
/>
109112

110113
</Steps>
111114

112-
### Adding Torus to the Subwallet
115+
### Adding Torus to the Subwallet
113116

114117
<Steps>
115118

116-
1. **Open the Subwallet Setup**
117-
Click on the three bars (****) on the top left corner of the subwallet extension.
118-
<ClickableImage src={subwalletOpenSetup} alt="SubWallet setup button" />
119+
1. **Open the Subwallet Setup**
120+
Click on the three bars (****) on the top left corner of the subwallet extension.
119121

120-
2. **Select Manage Networks**
121-
Under the **Assets & Addresses** tab, click on <RedText variant="light">**Manage Networks**</RedText>.
122-
<ClickableImage src={subwalletSelectConfigToAddNetwork} alt="SubWallet manage networks button" />
122+
{" "}
123+
<ClickableImage src={subwalletOpenSetup} alt="SubWallet setup button" />
123124

125+
2. **Select Manage Networks**
126+
Under the **Assets & Addresses** tab, click on <RedText variant="light">**Manage Networks**</RedText>.
124127

125-
3. **Search for Torus and activate it**
126-
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.
127-
<ClickableImage src={subwalletSearchTorusNetwork} alt="SubWallet search for Torus button" />
128-
<Aside type="caution">
129-
If you don't see **Torus** in the list, you might need to add it manually.
130-
Follow the steps in this [video tutorial by Omni Labs](https://www.youtube.com/watch?v=3JDQFYg0u_A&t=172s).
128+
{" "}
129+
<ClickableImage
130+
src={subwalletSelectConfigToAddNetwork}
131+
alt="SubWallet manage networks button"
132+
/>
131133

132-
**RPC URL:** `wss://api.torus.network`
133-
</Aside>
134+
3. **Search for Torus and activate it**
135+
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.
136+
137+
<ClickableImage src={subwalletSearchTorusNetwork} alt="SubWallet search for Torus button" />
138+
<Aside type="caution">
139+
If you don't see **Torus** in the list, you might need to add it manually.
140+
Follow the steps in this [video tutorial by Omni Labs](https://www.youtube.com/watch?v=3JDQFYg0u_A&t=172s).
141+
142+
**RPC URL:** `wss://api.torus.network`
134143

135-
4. **Confirm Torus is active**
136-
Once enabled, **Torus** will appear in your list of active networks.
137-
You might have to scroll down to find Torus in the list.
138-
<ClickableImage src={subwalletDoneTorusSetup} alt="SubWallet network list with torus" />
144+
</Aside>
139145

146+
4. **Confirm Torus is active**
147+
Once enabled, **Torus** will appear in your list of active networks.
148+
You might have to scroll down to find Torus in the list.
140149

150+
<ClickableImage
151+
src={subwalletDoneTorusSetup}
152+
alt="SubWallet network list with torus"
153+
/>{" "}
141154

142155
5. **All Done**
143156
Torus is now connected to your SubWallet.
144157
You’re ready to explore the Torus ecosystem and manage your assets securely.
145158

146159
</Steps>
147160

148-
149161
## What's Next?
150162

151163
Now that you have a wallet set up, you can:
152164

153165
- **Get TORUS**: [Bridge from Base](https://docs.torus.network/how-to-guides/holders/bridge-from-base/) to get TORUS into your wallet
166+
- **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/)
154167

155168
For SubWallet-specific help, check the [SubWallet Documentation](https://docs.subwallet.app/main).
156169

157-
Connect with the community:
170+
Connect with the community:
171+
158172
- [Discord](https://discord.gg/torus) — Technical discussions, support, and announcements
159173
- [Telegram](https://t.me/torusnetwork) — General chat and announcements
160174
- [Twitter](https://x.com/torus_network) — Updates and ecosystem news
Lines changed: 87 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,87 @@
1+
---
2+
title: Torus EVM Network
3+
sidebar:
4+
label: Torus EVM Network
5+
order: 40
6+
---
7+
8+
import { Steps, Aside, CardGrid, Card } from "@astrojs/starlight/components";
9+
10+
In this guide, you'll add the Torus EVM network to your wallet so dapps and the Bridge can connect reliably.
11+
12+
<Aside type="note">
13+
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.
14+
</Aside>
15+
16+
## What you will do
17+
18+
- Add the Torus EVM network to your wallet
19+
- Verify RPC/Explorer are reachable
20+
- (Optional) Enable Torus EVM on Coinbase Wallet via custom networks
21+
22+
## Prerequisites
23+
24+
<CardGrid>
25+
<Card title="An EVM Wallet" icon="seti:config">
26+
Any EVM-compatible wallet (Coinbase Wallet, MetaMask, Rabby, etc.)
27+
</Card>
28+
<Card title="Funds for gas" icon="seti:json">
29+
You might need a small amount of TORUS to send transactions on Torus EVM.
30+
</Card>
31+
</CardGrid>
32+
33+
---
34+
35+
## Network configuration
36+
37+
- Network Name: Torus EVM
38+
- Chain ID: 21000
39+
- Currency Symbol: TORUS
40+
- Decimals: 18
41+
42+
### RPC URLs
43+
- Primary RPC: https://api.torus.network
44+
- Alternate RPC: https://api-hyperlane.nodes.torus.network
45+
46+
### Explorer
47+
- Block Explorer: https://blockscout.torus.network
48+
- Explorer API: https://api.blockscout.torus.network/api
49+
50+
---
51+
52+
## Add to Coinbase Wallet
53+
54+
Reference: https://www.coinbase.com/learn/wallet/How-to-add-custom-networks-Coinbase-Wallet
55+
56+
<Steps>
57+
1. Open Coinbase Wallet → Settings
58+
2. Tap Active dapp network → + (Add custom network)
59+
3. Fill:
60+
- Name: Torus EVM
61+
- RPC URL: https://api.torus.network
62+
- Chain ID: 21000
63+
- Symbol: TORUS
64+
- Explorer: https://blockscout.torus.network
65+
4. Save → toggle it as Active network
66+
5. Send a small amount of TORUS to see your balance on Torus EVM
67+
</Steps>
68+
69+
<Aside>
70+
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.
71+
</Aside>
72+
73+
---
74+
75+
## Add to other EVM wallets (generic)
76+
77+
<Steps>
78+
1. Open your wallet → Settings
79+
2. Select Networks → Add Network
80+
3. Paste the configuration above
81+
4. Save, switch to Torus EVM, and retry your action (e.g., the Bridge)
82+
</Steps>
83+
84+
### Troubleshooting
85+
- RPC errors: try the Alternate RPC URL
86+
- Stuck on wrong network: refresh the dapp and re-connect the wallet
87+
- Tokens not visible: import token by contract address on Torus EVM

src/content/docs/how-to-guides/table-of-contents.mdx

Lines changed: 11 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -2,29 +2,29 @@
22
title: Table of Contents
33
description: Step-by-step walkthroughs to help users and builders interact with Torus.
44
---
5+
56
import {
67
Steps,
78
Aside,
89
CardGrid,
910
Card,
1011
Tabs,
11-
TabItem
12+
TabItem,
1213
} from "@astrojs/starlight/components";
1314

1415
Welcome to the **How-to Guides** section of the Torus documentation.
1516

16-
These guides are focused, practical, and designed to help you achieve specific outcomes within the Torus ecosystem, without distractions or deep dives into theory.
17-
If you prefer to start with the theory first, begin with [Explanations](https://docs.torus.network/explanations/table-of-contents) and continue from there.
17+
These guides are focused, practical, and designed to help you achieve specific outcomes within the Torus ecosystem, without distractions or deep dives into theory.
18+
If you prefer to start with the theory first, begin with [Explanations](https://docs.torus.network/explanations/table-of-contents) and continue from there.
1819
Whether you're here to use Torus, build on it, or coordinate its evolution, there's a guide to get you there.
1920

20-
21-
2221
## For Torus Holders
2322

2423
If you want to interact with Torus as an end-user or holder:
2524

2625
- [Set up a Wallet](https://docs.torus.network/how-to-guides/holders/setup-a-wallet/)
2726
- [Bridge from Base](https://docs.torus.network/how-to-guides/holders/bridge-from-base/)
27+
- [Add Torus EVM Network](https://docs.torus.network/how-to-guides/holders/add-torus-evm-network/)
2828
- [Stake your TORUS](https://docs.torus.network/how-to-guides/holders/stake-your-torus/)
2929

3030
---
@@ -35,26 +35,26 @@ If you're developing tools, services, or integrations on Torus:
3535

3636
- [Register an Agent](https://docs.torus.network/how-to-guides/builders/register-an-agent/)
3737
- [Edit your Agent](https://docs.torus.network/how-to-guides/builders/edit-your-agent/)
38-
- [Manage Permissions](https://docs.torus.network/how-to-guides/builders/manage-permissions/)
38+
- [Manage Permissions](https://docs.torus.network/how-to-guides/builders/manage-permissions/)
3939
- [Manage Capabilities](https://docs.torus.network/how-to-guides/builders/manage-capabilities/)
4040
- [Create a Signal](https://docs.torus.network/how-to-guides/builders/create-signal/)
4141
- [Setup Agent Server](https://docs.torus.network/how-to-guides/builders/setup-agent-server/)
4242
- [Setup Agent Client](https://docs.torus.network/how-to-guides/builders/setup-agent-client/)
4343

4444
---
4545

46-
## For Root Goal-Setters and Leaders
46+
## For Root Goal-Setters and Leaders
47+
4748
_Leading new swarms or driving protocol changes_
4849

4950
If you're pioneering new goals or submitting DAO proposals:
5051

5152
- [Become a Root Agent](https://docs.torus.network/how-to-guides/goal-leaders/become-a-root-agent/)
5253
- [Create Emission Proposal](https://docs.torus.network/how-to-guides/goal-leaders/create-emission-proposal/)
53-
- _See the [Governance & DAO](https://docs.torus.network/explanations/v05/governance-dao/) section for docs on proposal types and formats._
54+
- _See the [Governance & DAO](https://docs.torus.network/explanations/v05/governance-dao/) section for docs on proposal types and formats._
5455

5556
---
5657

57-
5858
## Additional Resources
5959

6060
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
6363
- **[Torus Telegram](https://t.me/torusnetwork)** — Quick help, casual discussion, and important updates.
6464
- **[Torus Twitter](https://twitter.com/torus_network)** — Stay up to date with announcements and news from the Torus ecosystem.
6565

66-
6766
### Core Projects
6867

6968
Torus is fully open source. You’re welcome to explore, contribute, or report issues:
7069

7170
- **[torus-substrate](https://github.com/renlabs-dev/torus-substrate)** — Core blockchain runtime built on Substrate.
72-
- **[torus-ts](https://github.com/renlabs-dev/torus-ts)** — TypeScript SDK for building on Torus and WebApps.
73-
- **[torus-docs](https://github.com/renlabs-dev/torus-docs)** — This documentation.
71+
- **[torus-ts](https://github.com/renlabs-dev/torus-ts)** — TypeScript SDK for building on Torus and WebApps.
72+
- **[torus-docs](https://github.com/renlabs-dev/torus-docs)** — This documentation.

0 commit comments

Comments
 (0)