diff --git a/astro.config.mjs b/astro.config.mjs index 75af27d..f41293b 100644 --- a/astro.config.mjs +++ b/astro.config.mjs @@ -100,10 +100,9 @@ export default defineConfig({ collapsed: true, items: [ { label: "Setup a Wallet", slug: "how-to-guides/holders/setup-a-wallet" }, - { label: "Fast Bridge", slug: "how-to-guides/holders/fast-bridge" }, + { label: "Bridge your tokens", slug: "how-to-guides/holders/bridge-your-torus" }, { label: "Stake your Torus", slug: "how-to-guides/holders/stake-your-torus" }, { label: "Vote on Proposals", slug: "how-to-guides/holders/vote-on-proposals" }, - { label: "Standard Bridge", slug: "how-to-guides/holders/standard-bridge" }, ], }, { diff --git a/public/images/how-to-guide/simple-bridge/Bridge interface explained.png b/public/images/how-to-guide/simple-bridge/Bridge interface explained.png new file mode 100644 index 0000000..686f1d0 Binary files /dev/null and b/public/images/how-to-guide/simple-bridge/Bridge interface explained.png differ diff --git a/public/images/how-to-guide/simple-bridge/Login in both wallets.png b/public/images/how-to-guide/simple-bridge/Login in both wallets.png new file mode 100644 index 0000000..f8fb847 Binary files /dev/null and b/public/images/how-to-guide/simple-bridge/Login in both wallets.png differ diff --git a/src/content/docs/development/web/querying-data.mdx b/src/content/docs/development/web/querying-data.mdx index 0d51fd8..8c90905 100644 --- a/src/content/docs/development/web/querying-data.mdx +++ b/src/content/docs/development/web/querying-data.mdx @@ -6,7 +6,7 @@ description: Learn how to query the stake weight between keys import { CardGrid, LinkCard, Aside } from "@astrojs/starlight/components"; Our API allows you to retrieve information about the stake allocation between keys and agents. -You can query this data by making a GET request to: `https://portal.torus.network/api/allocated-weight`. +You can query this data by making a GET request to: `https://torus.network/api/allocated-weight`. ## API Response Format @@ -29,12 +29,12 @@ The API response has the following structure: To filter the response for a specific allocating key, append the userKey query parameter to the API endpoint: - ```portal.torus.network/api/allocated-weight?userKey=``` + ```https://torus.network/api/allocated-weight?userKey=``` - Filter by Agent Key To filter the response for specific agents, append the agentKey query parameter to the API endpoint: - ```portal.torus.network/api/allocated-weight?agentKey=``` + ```https://torus.network/api/allocated-weight?agentKey=``` -6. **Check your Agent on the [Allocator tab](https://portal.torus.network/root-allocator?isWhitelisted=false)** +6. **Check your Agent on the [Allocator tab](https://torus.network/root-allocator?isWhitelisted=false)** You should find your agent on the Allocator tab, with the filter of **Registered Agents**. diff --git a/src/content/docs/how-to-guides/holders/bridge-from-base.mdx b/src/content/docs/how-to-guides/holders/bridge-from-base.mdx index 302f9cd..7b43826 100644 --- a/src/content/docs/how-to-guides/holders/bridge-from-base.mdx +++ b/src/content/docs/how-to-guides/holders/bridge-from-base.mdx @@ -167,7 +167,7 @@ Now that you have TORUS tokens, you can: - **Start earning rewards**: [Stake your TORUS](https://docs.torus.network/how-to-guides/holders/stake-your-torus/) to support agents and earn emissions - **Become an agent**: [Register an agent](https://docs.torus.network/how-to-guides/builders/register-an-agent/) to provide services and earn directly -- **Explore the ecosystem**: Browse agents and allocators on the [Torus Portal](https://portal.torus.network/) +- **Explore the ecosystem**: Browse agents and allocators on the [Torus Portal](https://torus.network/portal) - **Understand tokenomics**: Learn about [TORUS economics](https://docs.torus.network/explanations/holders/tokenomics/) and emission mechanisms Connect with the community: diff --git a/src/content/docs/how-to-guides/holders/bridge-your-torus.mdx b/src/content/docs/how-to-guides/holders/bridge-your-torus.mdx new file mode 100644 index 0000000..0c87e9b --- /dev/null +++ b/src/content/docs/how-to-guides/holders/bridge-your-torus.mdx @@ -0,0 +1,155 @@ +--- +title: Bridge your tokens +description: Bridging from TORUS Base all the way to Native TORUS on the Network. +--- + +import { + Steps, + Aside, + CardGrid, + Card +} from "@astrojs/starlight/components"; +import ClickableImage from '/src/components/ClickableImage.astro'; +import RedText from '/src/components/RedText.astro'; +import connectBothWallets from '/public/images/how-to-guide/simple-bridge/Login in both wallets.png'; +import bridgeMechanisms from '/public/images/how-to-guide/simple-bridge/Bridge interface explained.png'; + +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. +This process also works to bridge from **Native TORUS** to **Base TORUS**. + +The bridge automates the intermediate steps, completing the transfer in minutes. + +#### Why bridge TORUS tokens? + +You need Native TORUS to participate in Torus - it's required for registering agents, becoming a Root Agent, staking, governance voting, and all on-chain activities. Bridging converts your Base TORUS into the native format. + +To keep things clear and concise, **Native TORUS** will be referred to as **TORUS** from this point forward. + +#### What we will accomplish + +- Bridge TORUS from Base to TORUS in one streamlined process +- Bridge TORUS from Torus back to Base (bidirectional support) + + + +--- + +## Prerequisites + + + + A Torus wallet connected. + If you don't have one, you can follow the [setup guide here](https://docs.torus.network/how-to-guides/holders/setup-a-wallet/). + + + + 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. */} + + + +--- + + + + + +## Steps for the Bridge Process + + + +1. **Connect both the Torus and MetaMask wallets in the [Bridge Web App](https://bridge.torus.network/)**. + At the top right corner of the app, connect both your **Torus Wallet** and **MetaMask**. + + +2. **Swap from Base TORUS to TORUS** + - Make sure you are **connected** to **both wallets** + - Make sure it is FROM **Base TORUS** TO **TORUS** + + Fill in the amount you want to convert, then click **Submit Base to Torus transaction**. + + + +3. **Add Torus EVM network to MetaMask** + The bridge will automatically prompt MetaMask to switch to the Torus EVM network for the second transaction. If this is your first time, you may need to approve adding this network. + + + +4. **Sign both transactions in MetaMask** + You will need to approve two transactions - one on Base and one on Torus EVM. The second step is automated by the bridge, but requires your signature to complete. + + + +5. **Confirmation of the swap** + After the transactions succeed, your Base TORUS should now be displayed as TORUS. + This process can take a while to complete on the blockchain, + so please wait a few minutes and **don't** refresh the page. + + You should now have TORUS on Torus. + + + + +--- + +## Bridging from TORUS to Base TORUS + +The process to bridge from TORUS back to Base TORUS is nearly identical. Simply follow the same steps above, but swap the direction: + +- In **Step 2**, make sure it is FROM **TORUS** TO **Base TORUS** +- Click **Submit Torus to Base transaction** instead + +Everything else remains the same - you'll still need to approve adding the Torus EVM network (if not already added) and sign both transactions in MetaMask. The bridge handles the rest automatically. + +--- + +## Bridging Funds from EVM Layer + + + +--- + + + +## What's Next? + +Now that you have TORUS tokens, you can: + +- **Start earning rewards**: [Stake your TORUS](https://docs.torus.network/how-to-guides/holders/stake-your-torus/) to support agents and earn emissions +- **Become an agent**: [Register an agent](https://docs.torus.network/how-to-guides/builders/register-an-agent/) to provide services and earn directly +- **Explore the ecosystem**: Browse agents and allocators on the [Torus Portal](https://torus.network/portal) +- **Understand tokenomics**: Learn about [TORUS economics](https://docs.torus.network/explanations/holders/tokenomics/) and emission mechanisms + + 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/stake-your-torus.mdx b/src/content/docs/how-to-guides/holders/stake-your-torus.mdx index bc39364..8c0855a 100644 --- a/src/content/docs/how-to-guides/holders/stake-your-torus.mdx +++ b/src/content/docs/how-to-guides/holders/stake-your-torus.mdx @@ -102,7 +102,7 @@ Staking your TORUS allows you to earn emission rewards while supporting agents y ### Allocating to an Agent -1. **Open the [Torus Allocator Tab](https://portal.torus.network/root-allocator)** +1. **Open the [Torus Allocator Tab](https://torus.network/root-allocator)** You'll see a list of all current **Root Agents**. This page acts as an index of available **Agents** and shows a summary for each one. @@ -160,7 +160,7 @@ Staking your TORUS allows you to earn emission rewards while supporting agents y Now that you're earning emissions, you might want to: -- **Optimize your strategy**: Monitor agent performance on the [Allocator tab](https://portal.torus.network/root-allocator) and adjust allocations +- **Optimize your strategy**: Monitor agent performance on the [Allocator tab](https://torus.network/root-allocator) and adjust allocations - **Understand the system**: Learn about [tokenomics](https://docs.torus.network/explanations/holders/tokenomics/) and how emissions flow through the network - **Receive Updates**: Follow [Torus on Twitter](https://x.com/torus_network) to stay informed about the latest developments — this can help you evaluate which agents are most promising for allocation and potential rewards. diff --git a/src/content/docs/how-to-guides/system/create-capability-permission.mdx b/src/content/docs/how-to-guides/system/create-capability-permission.mdx index c1586c6..ba84359 100644 --- a/src/content/docs/how-to-guides/system/create-capability-permission.mdx +++ b/src/content/docs/how-to-guides/system/create-capability-permission.mdx @@ -54,7 +54,7 @@ Capability permissions let you control who can access your services while mainta -1. **Visit the [Capability Permissions Tab in the Torus Portal](https://portal.torus.network/permissions/create-permission/capability)** +1. **Visit the [Capability Permissions Tab in the Torus Portal](https://torus.network/permissions/create-permission/capability)** Click the **Capability Permission** tab under Permissions in the Torus Portal. 2. **Connect your Torus Wallet** @@ -129,8 +129,8 @@ Capability permissions let you control who can access your services while mainta Now that you've created capability permission, you might want to: -- **Monitor your delegations**: Adjust delegation chains in the [Manage Permissions tab](https://portal.torus.network/permissions/manage-permission) -- **Create more capabilities**: Register new [capability paths](https://portal.torus.network/capabilities/register-capability) to expand what you can delegate +- **Monitor your delegations**: Adjust delegation chains in the [Manage Permissions tab](https://torus.network/permissions/manage-permission) +- **Create more capabilities**: Register new [capability paths](https://torus.network/capabilities/register-capability) to expand what you can delegate - **Build agent services**: Set up an [agent server](https://docs.torus.network/how-to-guides/builders/setup-agent-server/) to provide APIs that utilize your delegated permissions Connect with the community: diff --git a/src/content/docs/how-to-guides/system/create-emission-permission.mdx b/src/content/docs/how-to-guides/system/create-emission-permission.mdx index e949827..98d1298 100644 --- a/src/content/docs/how-to-guides/system/create-emission-permission.mdx +++ b/src/content/docs/how-to-guides/system/create-emission-permission.mdx @@ -52,8 +52,8 @@ Emission permissions enable economic coordination by delegating portions of your -1. **Visit the [Create Permissions tab in the Torus Portal](https://portal.torus.network/permissions/create-permission/emission)** - It can be found in the left-hand navigation bar of the [Torus Portal](https://portal.torus.network). +1. **Visit the [Create Permissions tab in the Torus Portal](https://torus.network/permissions/create-permission/emission)** + It can be found in the left-hand navigation bar of the [Torus Portal](https://torus.network/portal). 2. **Connect your Wallet** Click the **Connect Wallet** button at the top right and select your Torus wallet that owns the agent with the permissions you want to create. @@ -109,7 +109,7 @@ Emission permissions enable economic coordination by delegating portions of your Sign the transaction in your Wallet to finish the creation. 6. **All Done** - Your Emission Permission is now delegated. You can check it in the [Management tab](https://portal.torus.network/permissions/edit-permission). + Your Emission Permission is now delegated. You can check it in the [Management tab](https://torus.network/permissions/edit-permission). ## What's Next? diff --git a/src/content/docs/how-to-guides/system/create-permission.mdx b/src/content/docs/how-to-guides/system/create-permission.mdx index 223384e..a54de93 100644 --- a/src/content/docs/how-to-guides/system/create-permission.mdx +++ b/src/content/docs/how-to-guides/system/create-permission.mdx @@ -64,7 +64,7 @@ Permissions enable fine-grained control over emission distribution and capabilit -1. **Visit the [Torus Portal](https://portal.torus.network/)** +1. **Visit the [Torus Portal](https://torus.network/portal)** Navigate to **Permissions Management** → **Create Permission**. 2. **Connect your wallet** diff --git a/src/content/docs/how-to-guides/system/create-stream-permission.mdx b/src/content/docs/how-to-guides/system/create-stream-permission.mdx index c2ec973..58216bf 100644 --- a/src/content/docs/how-to-guides/system/create-stream-permission.mdx +++ b/src/content/docs/how-to-guides/system/create-stream-permission.mdx @@ -52,8 +52,8 @@ Stream permissions enable economic coordination by delegating portions of your t -1. **Visit the [Create Stream Permission tab in the Torus Portal](https://portal.torus.network/permissions/create-permission/stream)** - It can be found in the left-hand navigation bar of the [Torus Portal](https://portal.torus.network). +1. **Visit the [Create Stream Permission tab in the Torus Portal](https://torus.network/permissions/create-permission/stream)** + It can be found in the left-hand navigation bar of the [Torus Portal](https://torus.network/portal). 2. **Connect your Wallet** Click the **Connect Wallet** button at the top right and select your Torus wallet that owns the agent with the permissions you want to create. @@ -107,7 +107,7 @@ Stream permissions enable economic coordination by delegating portions of your t Sign the transaction in your Wallet to finish the creation. 6. **All Done** - Your Stream Permission is now delegated. You can check it in the [Management tab](https://portal.torus.network/permissions/manage-permission). + Your Stream Permission is now delegated. You can check it in the [Management tab](https://torus.network/permissions/manage-permission). ## What's Next? diff --git a/src/content/docs/how-to-guides/system/create-wallet-stake-permission.mdx b/src/content/docs/how-to-guides/system/create-wallet-stake-permission.mdx index f1474f2..67f34f5 100644 --- a/src/content/docs/how-to-guides/system/create-wallet-stake-permission.mdx +++ b/src/content/docs/how-to-guides/system/create-wallet-stake-permission.mdx @@ -52,7 +52,7 @@ Wallet permissions let you delegate staking management to hot wallets without ex -1. **Visit the [Wallet Permissions Tab in the Torus Portal](https://portal.torus.network/permissions/create-permission/wallet)** +1. **Visit the [Wallet Permissions Tab in the Torus Portal](https://torus.network/permissions/create-permission/wallet)** Click the **Wallet Permission** tab under Permissions in the Torus Portal. 2. **Connect your Cold Wallet** @@ -106,7 +106,7 @@ Wallet permissions let you delegate staking management to hot wallets without ex Now that you've created wallet permission, you might want to: -- **Monitor your delegations**: Track delegation status in the [Manage Permissions tab](https://portal.torus.network/permissions/manage-permission) +- **Monitor your delegations**: Track delegation status in the [Manage Permissions tab](https://torus.network/permissions/manage-permission) - **Optimize your stakes**: Work with your hot wallet to [manage staking positions](https://docs.torus.network/how-to-guides/holders/stake-your-torus/) efficiently - **Understand COLD vs HOT Wallet**: Watch [this Coingecko video](https://www.youtube.com/watch?v=kf28zqP_F2s) diff --git a/src/content/docs/how-to-guides/system/manage-permissions.mdx b/src/content/docs/how-to-guides/system/manage-permissions.mdx index 13a1974..2e122c3 100644 --- a/src/content/docs/how-to-guides/system/manage-permissions.mdx +++ b/src/content/docs/how-to-guides/system/manage-permissions.mdx @@ -56,8 +56,8 @@ Both capability and stream permissions can be viewed and monitored through the m -1. **Visit the [Manage Permissions](https://portal.torus.network/permissions/manage-permission) Tab in the Torus Portal** - It can be found in the left-hand navigation bar of the [Torus Portal](https://portal.torus.network). +1. **Visit the [Manage Permissions](https://torus.network/permissions/manage-permission) Tab in the Torus Portal** + It can be found in the left-hand navigation bar of the [Torus Portal](https://torus.network/portal). 2. **Connect your Wallet** Click the **Connect Wallet** button at the top right and select your Torus wallet. @@ -103,9 +103,9 @@ Both capability and stream permissions can be managed through the same interface -1. **Visit the [Manage Permissions](https://portal.torus.network/permissions/manage-permission) Tab in the Torus Portal** +1. **Visit the [Manage Permissions](https://torus.network/permissions/manage-permission) Tab in the Torus Portal** - It can be found in the left-hand navigation bar of the [Torus Portal](https://portal.torus.network). + It can be found in the left-hand navigation bar of the [Torus Portal](https://torus.network/portal). 2. **View Your Permissions** Browse your permissions organized by role: 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 2a57962..170b133 100644 --- a/src/content/docs/how-to-guides/table-of-contents.mdx +++ b/src/content/docs/how-to-guides/table-of-contents.mdx @@ -37,10 +37,9 @@ If you're managing permissions and system-level coordination: 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/) — Configure SubWallet to connect to Torus network -- [Fast Bridge](https://docs.torus.network/how-to-guides/holders/fast-bridge/) — Transfer TORUS tokens from Base to Torus quickly with fewer steps +- [Bridge your tokens](https://docs.torus.network/how-to-guides/holders/bridge-your-torus/) — Transfer TORUS tokens between Base and Torus - [Stake your TORUS](https://docs.torus.network/how-to-guides/holders/stake-your-torus/) — Delegate tokens to agents and participate in network rewards - [Vote on Proposals](https://docs.torus.network/how-to-guides/holders/vote-on-proposals/) — Participate in governance decisions and proposal voting -- [Standard Bridge](https://docs.torus.network/how-to-guides/holders/standard-bridge/) — Transfer TORUS tokens from Base to Torus using the traditional multi-step process ---