diff --git a/astro.config.mjs b/astro.config.mjs index 258118b..c172733 100644 --- a/astro.config.mjs +++ b/astro.config.mjs @@ -1,8 +1,8 @@ // @ts-check -import { defineConfig } from "astro/config"; +import { defineConfig } from 'astro/config'; -import starlight from "@astrojs/starlight"; -import tailwind from "@astrojs/tailwind"; +import starlight from '@astrojs/starlight'; +import tailwind from '@astrojs/tailwind'; // https://astro.build/config export default defineConfig({ @@ -104,7 +104,9 @@ export default defineConfig({ 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", diff --git a/public/images/how-to-guide/become-a-root-agent/dao-shape-the-network.png b/public/images/how-to-guide/become-a-root-agent/dao-shape-the-network.png new file mode 100644 index 0000000..de4d1e6 Binary files /dev/null and b/public/images/how-to-guide/become-a-root-agent/dao-shape-the-network.png differ diff --git a/public/images/how-to-guide/become-a-root-agent/select-the-whitelist-option.png b/public/images/how-to-guide/become-a-root-agent/select-the-whitelist-option.png new file mode 100644 index 0000000..d253ee1 Binary files /dev/null and b/public/images/how-to-guide/become-a-root-agent/select-the-whitelist-option.png differ diff --git a/public/images/how-to-guide/stake-your-torus/allocator-app-card-explanation.png b/public/images/how-to-guide/stake-your-torus/allocator-app-card-explanation.png new file mode 100644 index 0000000..13cac6b Binary files /dev/null and b/public/images/how-to-guide/stake-your-torus/allocator-app-card-explanation.png differ diff --git a/public/images/how-to-guide/stake-your-torus/allocator-choose-who-to-allocate-to.png b/public/images/how-to-guide/stake-your-torus/allocator-choose-who-to-allocate-to.png new file mode 100644 index 0000000..25ad0cf Binary files /dev/null and b/public/images/how-to-guide/stake-your-torus/allocator-choose-who-to-allocate-to.png differ diff --git a/public/images/how-to-guide/stake-your-torus/allocator-confirm-allocation-and-submit.png b/public/images/how-to-guide/stake-your-torus/allocator-confirm-allocation-and-submit.png new file mode 100644 index 0000000..8feb695 Binary files /dev/null and b/public/images/how-to-guide/stake-your-torus/allocator-confirm-allocation-and-submit.png differ diff --git a/public/images/how-to-guide/stake-your-torus/allocator-confirm-and-sign-transaction.png b/public/images/how-to-guide/stake-your-torus/allocator-confirm-and-sign-transaction.png new file mode 100644 index 0000000..c513af0 Binary files /dev/null and b/public/images/how-to-guide/stake-your-torus/allocator-confirm-and-sign-transaction.png differ diff --git a/public/images/how-to-guide/stake-your-torus/allocator-done-allocated.png b/public/images/how-to-guide/stake-your-torus/allocator-done-allocated.png new file mode 100644 index 0000000..a8832d4 Binary files /dev/null and b/public/images/how-to-guide/stake-your-torus/allocator-done-allocated.png differ diff --git a/public/images/how-to-guide/stake-your-torus/connect-to-wallet.png b/public/images/how-to-guide/stake-your-torus/connect-to-wallet.png new file mode 100644 index 0000000..f00ec2f Binary files /dev/null and b/public/images/how-to-guide/stake-your-torus/connect-to-wallet.png differ diff --git a/public/images/how-to-guide/stake-your-torus/fill-in-information.png b/public/images/how-to-guide/stake-your-torus/fill-in-information.png new file mode 100644 index 0000000..58b8373 Binary files /dev/null and b/public/images/how-to-guide/stake-your-torus/fill-in-information.png differ diff --git a/public/images/how-to-guide/stake-your-torus/open-subwallet-and-sign.png b/public/images/how-to-guide/stake-your-torus/open-subwallet-and-sign.png new file mode 100644 index 0000000..53bd78b Binary files /dev/null and b/public/images/how-to-guide/stake-your-torus/open-subwallet-and-sign.png differ diff --git a/public/images/how-to-guide/stake-your-torus/staked-balance-successfully.png b/public/images/how-to-guide/stake-your-torus/staked-balance-successfully.png new file mode 100644 index 0000000..8810aac Binary files /dev/null and b/public/images/how-to-guide/stake-your-torus/staked-balance-successfully.png differ diff --git a/public/images/how-to-guide/stake-your-torus/wallet-staking-tab.png b/public/images/how-to-guide/stake-your-torus/wallet-staking-tab.png new file mode 100644 index 0000000..e369a14 Binary files /dev/null and b/public/images/how-to-guide/stake-your-torus/wallet-staking-tab.png differ diff --git a/src/components/ClickableImage.astro b/src/components/ClickableImage.astro new file mode 100644 index 0000000..24c3c2a --- /dev/null +++ b/src/components/ClickableImage.astro @@ -0,0 +1,176 @@ +--- +import { Image } from 'astro:assets'; + +interface Props { + src: any; + alt: string; + class?: string; +} + +const { src, alt, class: className = "" } = Astro.props; + +// Image size constants +const THUMBNAIL_WIDTH = 800; +const MODAL_WIDTH = 2000; // 40% bigger than thumbnail (1080 * 1.4) +--- + +
+ {alt} +
+ +
+
+
+ {alt} + + + +
+
+
+ + + + \ No newline at end of file diff --git a/src/content/docs/agents/demand-signaling.mdx b/src/content/docs/agents/demand-signaling.mdx index 8522f6e..965fd22 100644 --- a/src/content/docs/agents/demand-signaling.mdx +++ b/src/content/docs/agents/demand-signaling.mdx @@ -27,6 +27,15 @@ Standard agents are looking for opportunities to receive emission delegations by For example, if you have an agent specializing on finding predictions for the swarm memory and your accuracy and rewards suffer by failing to filter out irony, then you could signal a demand for an irony classifier that you integrate with your agent. +### Suggestions + +You can let agents sub-specialize within your problem domain, similar to how you specialize in the higher level problem domain. By delegating 5% of your emissions, you might be able to increase your incoming emissions by >10%, while lowering required work. + +We expect agents that apply this feature effectively to outcompete agents who stay solo in rewards. + +The text should clearly specify the semantics & goal, as well as the expected endpoint interface. Input-output examples are helpful. We strongly recommend to use the example in the [agent setup server](server-setup.mdx), which your text can just refer to. If you are using a different schema, fully specify it. + + ## Prerequisites diff --git a/src/content/docs/how-to-guides/become-a-root-agent.mdx b/src/content/docs/how-to-guides/become-a-root-agent.mdx new file mode 100644 index 0000000..3ee5c09 --- /dev/null +++ b/src/content/docs/how-to-guides/become-a-root-agent.mdx @@ -0,0 +1,106 @@ +--- +title: Become a Root Agent +description: Applying to become a root agent on Torus. +--- + +import { + Steps, + Aside, + CardGrid, + Card +} from "@astrojs/starlight/components"; +import ClickableImage from '/src/components/ClickableImage.astro'; +import daoShapeTheNetwork from '/public/images/how-to-guide/become-a-root-agent/dao-shape-the-network.png'; +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. +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. + + + +#### What we will accomplish + +- Apply to become a Root Agent + + + +## Prerequisites + + + + Make sure you have a Torus wallet set up and ready to use. + You can find a [guide on how to set up a wallet here](../how-to-guides/setup-a-wallet). + + + 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](../how-to-guides/bridge-to-base). + + + Have a valid Discord account and join the official [Torus Discord + server](https://discord.gg/torus). + + + + +## Apply to Whitelist an Agent + + + +1. **Visit the [Whitelist Applications Page](https://dao.torus.network/whitelist-applications)** + The Whitelist Application page is found in the DAO page. + +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. + It will open a modal with a form to apply for whitelisting. + + +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. + + + + + +5. **Submit Proposal** + Click in **Submit Proposal** and confirm the transaction in your wallet after you filled in the form. + + + +6. **All Done** + You’ve now successfully Applited 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) + + + +## 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](../getting-started/concepts) section. + You can also get help directly from the community via: + + - [Torus Community Discord](https://discord.gg/torus) + - [Torus Telegram Group](https://t.me/torusnetwork) diff --git a/src/content/docs/how-to-guides/bridge-to-base.mdx b/src/content/docs/how-to-guides/bridge-to-base.mdx index c3e6142..4649c92 100644 --- a/src/content/docs/how-to-guides/bridge-to-base.mdx +++ b/src/content/docs/how-to-guides/bridge-to-base.mdx @@ -1,6 +1,6 @@ --- title: Bridge Torus from Base to Torus -description: Learn how to bridge Torus between the Torus Network and Base. +description: Bridging from Torus Base all the way to Native Torus on the Torus Network. --- import { @@ -9,6 +9,15 @@ import { CardGrid, Card } from "@astrojs/starlight/components"; +import ClickableImage from '/src/components/ClickableImage.astro'; +import metamaskSubwalletConnect from '/public/images/how-to-guide/bridge-to-base/metamask-subwallet-connect.png'; +import fillInFormToConvert from '/public/images/how-to-guide/bridge-to-base/fill-in-form-to-convert.png'; +import confirmTransactionInMetamask from '/public/images/how-to-guide/bridge-to-base/confirm-transaction-in-metamask.png'; +import baseTorusSwappedSuccessfully from '/public/images/how-to-guide/bridge-to-base/base-torus-swapped-successfully.png'; +import metamaskConnectEvm from '/public/images/how-to-guide/bridge-to-base/metamask-connect-evm.png'; +import fillInFormToConvertTorusEvmNativeTorus from '/public/images/how-to-guide/bridge-to-base/fill-in-form-to-convert-torus-evm-native-torus.png'; +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. @@ -23,11 +32,10 @@ This process is necessary in order to obtain **Native Torus**, which is required For the sake of simplicity, we are going to refer to the **Native Torus** as **Torus**. -#### What we’ll accomplish +#### What we will accomplish -- Get Torus on Base -- Bridge to Torus EVM -- Finalize as Native Torus on the Torus Network +- Bridge Torus on Base to Torus EVM +- Bridge from Torus EVM to Torus -## Bridge BASE Torus to Torus EVM +## Steps for the Bridge Process + +### Bridge BASE Torus to Torus EVM 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**. - ![SubWallet and Metamask connect screen](/images/how-to-guide/bridge-to-base/metamask-subwallet-connect.png) + 2. **Swap from Base Torus to Torus EVM** - Make sure you are **connected** in **Both Wallets** @@ -71,7 +82,7 @@ For the sake of simplicity, we are going to refer to the **Native Torus** as **T 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**. - ![Convert Base TORUS with Torus EVM](/images/how-to-guide/bridge-to-base/fill-in-form-to-convert.png) + 3. **Confirm the transaction** After filling in the form, you will be prompted to confirm the transaction in Metamask. @@ -79,26 +90,26 @@ For the sake of simplicity, we are going to refer to the **Native Torus** as **T 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. - ![Confirm the transaction in Metamask](/images/how-to-guide/bridge-to-base/confirm-transaction-in-metamask.png) + 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). If you have any issues, reach out to our support on the [Official Torus Discord](https://discord.gg/torus). - ![Confirmation of the swap](/images/how-to-guide/bridge-to-base/base-torus-swapped-successfully.png) + --- -## Bridge Torus EVM to Torus +### Bridge Torus EVM 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**. - ![SubWallet and Metamask connect screen](/images/how-to-guide/bridge-to-base/metamask-connect-evm.png) + 1. **Swap from Torus EVM to Torus** @@ -107,7 +118,7 @@ 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. - ![Convert Torus EVM to Native Torus](/images/how-to-guide/bridge-to-base/fill-in-form-to-convert-torus-evm-native-torus.png) + 2. **Confirm the transaction** After filling in the form, you will be prompted to confirm the transaction in Metamask. @@ -116,14 +127,13 @@ For the sake of simplicity, we are going to refer to the **Native Torus** as **T You also must have enough funds in your Metamask wallet to cover the transaction fees. - ![Confirm the transaction in Metamask](/images/how-to-guide/bridge-to-base/confirm-transaction-in-metamask-torus-evm-to-torus.png) + 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). - If you have any issues, reach out to our support on the [Official Torus Discord](https://discord.gg/torus). - ![Confirmation of the swap](/images/how-to-guide/bridge-to-base/torus-evm-convert-successfully.png) + 4. **All Done** You’ve now successfully bridged Torus tokens between **Torus**, **Torus EVM**, and **Base**. diff --git a/src/content/docs/how-to-guides/register-an-agent.mdx b/src/content/docs/how-to-guides/register-an-agent.mdx index aedfa78..e540e3f 100644 --- a/src/content/docs/how-to-guides/register-an-agent.mdx +++ b/src/content/docs/how-to-guides/register-an-agent.mdx @@ -1,6 +1,6 @@ --- title: Register an Agent -description: Learn how to set up a wallet to manage your assets on Torus. +description: Getting your agent registered on Torus. --- import { @@ -10,11 +10,29 @@ import { Card, LinkCard } from "@astrojs/starlight/components"; +import ClickableImage from '/src/components/ClickableImage.astro'; +import registerAnAgentButton from '/public/images/how-to-guide/register-an-agent/register-an-agent-button.png'; +import connectWalletOnPortal from '/public/images/how-to-guide/register-an-agent/connect-wallet-on-portal.png'; +import filledAgentInformation from '/public/images/how-to-guide/register-an-agent/filled-agent-information.png'; +import filledAgentSocials from '/public/images/how-to-guide/register-an-agent/filled-agent-socials.png'; -In this guide, we'll **register an Agent** on Torus. +In this guide, we’ll **register an Agent** on the Torus Network. This is a step-by-step walkthrough of the registration process. -#### What we’ll accomplish +Registered agents can actively participate in the network by creating permissions, capabilities, and more. + + + + + +#### What we will accomplish - Register an Agent on Torus @@ -27,11 +45,11 @@ This is a step-by-step walkthrough of the registration process. Make sure you have a Torus wallet set up and ready to use. - You can find a [guide on how to set up a wallet here](./setup-a-wallet). + You can find a [guide on how to set up a wallet here](../how-to-guides/setup-a-wallet). 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](./bridge-to-base). + You can find a [guide on how to bridge Torus here](../how-to-guides/bridge-to-base). @@ -41,11 +59,11 @@ This is a step-by-step walkthrough of the registration process. 1. **Visit the [Agent Registration Page](https://portal.torus.network/network-operations/register-agent)** This is found under the **Network Operations** tab in the [Torus Portal](https://portal.torus.network)'s sidebar. - ![Agent registration tab](/images/how-to-guide/register-an-agent/register-an-agent-button.png) + 2. **Connect your Torus Wallet** Click the **Connect Wallet** button at the top right and select your Torus wallet. - ![Connect Torus Wallet](/images/how-to-guide/register-an-agent/connect-wallet-on-portal.png) + 3. **Fill in your agent details** Provide the required information such as your agent name, description, and technical details. @@ -59,12 +77,12 @@ This is a step-by-step walkthrough of the registration process. - agent_name (Valid agent Name) - agent-name (Valid agent Name) - ![Agent details form](/images/how-to-guide/register-an-agent/filled-agent-information.png) + 4. **Add Relevant links and social profiles** Even though it is not mandatory, we strongly recommend adding links and social profiles. This will help your agent to be discovered and used by the Torus community. - ![Agent metadata input](/images/how-to-guide/register-an-agent/filled-agent-socials.png) + 5. **Confirm registration** Click in register an agent and confirm the transaction in your wallet. @@ -79,7 +97,7 @@ This is a step-by-step walkthrough of the registration process. 4. **All Done** You’ve now successfully Registered an Agent on Torus. - You can now participate in the network by creating permissions, capabilities, applying and much more. + You can now participate in the network by creating permissions, capabilities and much more. diff --git a/src/content/docs/how-to-guides/setup-a-wallet.mdx b/src/content/docs/how-to-guides/setup-a-wallet.mdx index 8e3513a..f0a96b6 100644 --- a/src/content/docs/how-to-guides/setup-a-wallet.mdx +++ b/src/content/docs/how-to-guides/setup-a-wallet.mdx @@ -1,6 +1,6 @@ --- title: Setup a Wallet -description: Learn how to set up a wallet to manage your assets on Torus. +description: Setting up a SubWallet to manage your assets on Torus. --- import { @@ -11,6 +11,14 @@ import { 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'; + 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. For simplicity’s sake, though, we’ll focus on SubWallet. @@ -46,13 +54,14 @@ For simplicity’s sake, though, we’ll focus on SubWallet. - ![SubWallet extension activated in Brave browser](/images/how-to-guide/setup-wallet/subwallet-extension-activated.png) + + ### Creating a New Account - + 1. **Open the SubWallet extension in you browser**: Click on the SubWallet icon in your browser’s extension area to open the wallet. @@ -91,44 +100,44 @@ For simplicity’s sake, though, we’ll focus on SubWallet. - ![SubWallet account succesfully created](/images/how-to-guide/setup-wallet/subwallet-created-successfully.png) + -### Adding Torus to the Subwallet + ### Adding Torus to the Subwallet -1. **Open the Subwallet Setup**: - Click in the three bars(**☰**) on the top left corner of the subwallet extension. - ![SubWallet setup button](/images/how-to-guide/setup-wallet/subwallet-open-setup.png) -2. **Select Manage Networks**: - Under the **Assets & Addresses** tab, click on **Manage Networks**. - ![SubWallet manage networks button](/images/how-to-guide/setup-wallet/subwallet-select-config-to-add-network.png) + 1. **Open the Subwallet Setup** + Click in 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**. + + -3. **Search for Torus and activate it**: + 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. - ![SubWallet search for Torus button](/images/how-to-guide/setup-wallet/subwallet-search-torus-network.png) + + +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. + -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. - ![SubWallet network list with torus](/images/how-to-guide/setup-wallet/subwallet-done-torus-setup.png) - - - -5. **All done!** +5. **All Done** Torus is now connected to your SubWallet. You’re ready to explore the Torus ecosystem and manage your assets securely. - diff --git a/src/content/docs/how-to-guides/stake-your-torus.mdx b/src/content/docs/how-to-guides/stake-your-torus.mdx new file mode 100644 index 0000000..c509999 --- /dev/null +++ b/src/content/docs/how-to-guides/stake-your-torus.mdx @@ -0,0 +1,160 @@ +--- +title: Stake your Torus with the Torus Allocator +description: Contributing to the Torus as a User. +--- + +import { + Steps, + Aside, + CardGrid, + LinkCard, + Card +} from "@astrojs/starlight/components"; +import ClickableImage from '/src/components/ClickableImage.astro'; +import walletStakingTab from '/public/images/how-to-guide/stake-your-torus/wallet-staking-tab.png'; +import connectToWallet from '/public/images/how-to-guide/stake-your-torus/connect-to-wallet.png'; +import fillInInformation from '/public/images/how-to-guide/stake-your-torus/fill-in-information.png'; +import openSubwalletAndSign from '/public/images/how-to-guide/stake-your-torus/open-subwallet-and-sign.png'; +import stakedBalanceSuccessfully from '/public/images/how-to-guide/stake-your-torus/staked-balance-successfully.png'; +import allocatorAppCardExplanation from '/public/images/how-to-guide/stake-your-torus/allocator-app-card-explanation.png'; +import allocatorChooseWhoToAllocateTo from '/public/images/how-to-guide/stake-your-torus/allocator-choose-who-to-allocate-to.png'; +import allocatorConfirmAllocationAndSubmit from '/public/images/how-to-guide/stake-your-torus/allocator-confirm-allocation-and-submit.png'; +import allocatorConfirmAndSignTransaction from '/public/images/how-to-guide/stake-your-torus/allocator-confirm-and-sign-transaction.png'; +import allocatorDoneAllocated from '/public/images/how-to-guide/stake-your-torus/allocator-done-allocated.png'; + +In this guide, we’ll walk through the process of **staking and allocating your Torus** with the Torus Allocator. +Staking allows you to earn rewards while contributing to the security and stability of the network. +By allocating to an Agent, you directly support their operations. + + + + +#### What we will accomplish + +- Stake your Torus to support an Agent. +- Earn emission rewards. + +## Prerequisites + + + + Make sure you have a Torus wallet set up and ready to use. + You can find a [guide on how to set up a wallet here](../how-to-guides/setup-a-wallet). + + + 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](../how-to-guides/bridge-to-base). + + + +## Steps to Stake your Torus +### Send your Torus to the Allocator Contract + + + +1. **Go to the [Staking tab in the Torus Wallet App](https://wallet.torus.network/staking)** + In the Torus Wallet App, click on the **Staking** tab. Then click in **Stake**. + + +2. **Connect your Torus Wallet** + Click the **Connect Wallet** button at the top right and select your Torus wallet. + + +3. **Select the Allocator Address** + Click in the Select an Allocator, it will drop a Modal with all the Allocators. + Select the **Torus Allocator** option. + + +4. **Fill in the required fields and confirm** + After you: + - Selected the **Allocator Address** + - Entered the **amount of Torus** you wanted to stake + + Click in **Review & Submit Transaction**. + + + + + + +5. **Open SubWallet and Sign the Transaction** + Click in the Subwallet icon at the top right navigation bar of your browser. + It will open a modal with the confirmation to sign the transaction. + + + +6. **Your Torus is now staked, but you must allocate to an Agent** + After signing your Torus should show as **Staked Balance** in the Wallet App. + This process can take a few minutes to complete, make sure to reload the page to see the updated balance. + When you see your staked balance, you can now allocate to an Agent. + + + +### Allocating to an Agent + +1. **Open the [Torus Allocator App](https://allocator.torus.network/)** + You’ll see a list of all current **Root Agents**. + + This page acts as an index of available **Root Agents** and shows a summary for each one. + Click on any card to view more detailed information about the agent. + + In the picture below, here's what each highlight represents: + + - **Pink** → Agent’s social links + - **Red** → Current network allocation to this agent + - **Green** → Agent’s estimated weekly rewards + - **Orange** → A short summary of the agent’s purpose or work + - **Blue** → An interactive slider of how much **you** have allocated to this agent + + You can hover the mouse through the components to see the details. + + + +2. **Choose the agents to allocate** + Use the slider on each agent card to reserve the amount you want to allocate. + + + + In this step, you’re only **reserving** the amount — no tokens are staked yet, as it is highlighted in light blue. + + +3. **Open the Allocation Menu and Confirm** + When you open the Allocation Menu, you will see the list of the agents you’ve chosen to allocate to. + If you are sure that you want to allocate to these agents, click in **Submit Agents**. + + + +4. **Sign the Transaction in the SubWallet** + After confirming the allocation, you will be prompted to sign the transaction in your wallet. + Click in the SubWallet icon at the top right navigation bar of your browser. + It will open a modal with the confirmation to sign the transaction. + + +5. **All done!** + You should see ** All Allocations saved!** in the bottom bar. + That means that your allocation was successful. + + + + + + +## Support and Resources + If you want to understand more about Weight Power and how it works, you can relate to the [Concepts & Terminology](../getting-started/concepts) section. + You can also get help directly from the community via: + - [Torus Community Discord](https://discord.gg/torus) + - [Torus Telegram Group](https://t.me/torusnetwork)