vTAO tutorial #195

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged

chideraao merged 5 commits into main from vtao-tutorial

Feb 5, 2026

docs/evm-tutorials/bridge-vtao.md

-Original file line number
+Diff line change
@@ Expand Up / @@ -5,6 +5,7 @@ title: "Token Bridging" @@
     # Token Bridging
     This guide provides an overview of two related topics:
     - how to moves TAO between Substrate-style wallets (SS58) and the Etherum style wallets on Bittensor EVM
     - how to use vTAO as a token bridge between Bittensor EVM and other EVM chains.
@@ Expand All @@
     You can move TAO back and forth between Substrate and EVM wallets several ways:
     Use example scripts:
-    	- [Transfer TAO from H160 to SS58](./convert-h160-to-ss58)
-    	- [Transfer TAO from SS58 to H160](./transfer-from-metamask-to-ss58)
-    - Using [`tao.app/bridge`](https://tao.app/bridge).
+    - [Transfer TAO from H160 to SS58](./convert-h160-to-ss58)
+    - [Transfer TAO from SS58 to H160](./transfer-from-metamask-to-ss58)
+    - Using [`tao.app/bridge`](https://tao.app/bridge).
     - Using OTF's EVM Bridge: [`bridge.bittensor.com/`](https://bridge.bittensor.com/)
     ## Bridge to other EVM Chains with vTAO
@@ Expand All @@
     - vTAO can be bridged between supported EVM chains.
     :::tip
-    vTAO conceptually similar to [Lido's wstETH](https://docs.lido.fi/contracts/wsteth/).
+    vTAO conceptually similar to [Lido's wstETH](https://docs.lido.fi/contracts/wsteth/). For more information on how to bridge and wrap vTAO, see [Bridging and Wrapping vTAO](./vtao-bridge-tutorial.md)
     :::

docs/evm-tutorials/vtao-bridge-tutorial.md

-Original file line number
+Diff line change
@@ -0,0 +1,86 @@
+    ---
+    title: "Bridging and Wrapping vTAO"
+    ---
+    import SubstrateWallet from '/img/docs/connect-ss58-wallet.png';
+    import EVMWallet from '/img/docs/connect-evm-wallet.png';
+    import VTAOBridge from '/img/docs/wrap-vtao.png';
+    # Bridging and Wrapping vTAO
+    This page explains how to move native TAO from the Bittensor Substrate layer to the Bittensor EVM and wrap it into vTAO.
+    ## Introduction
+    TAO, the native token of the Bittensor network, exists on Subtensor, a Substrate-based platform. Hence, TAO is normally held in Substrate-style, ss58-format wallets.
+    If TAO is transferred to an Ethereum-style h160 wallet, it can be used in Bittensor's EVM layer. The process of moving TAO between Substrate and EVM wallets is referred to as _TAO bridging_.
+    ## Prerequisites
+    To follow along with the rest of the tutorial, you will need the following:
+    - A Talisman browser extension with a Substrate wallet—or "Polkadot account"—containing native TAO on Bittensor mainnet.
+    - An EVM Wallet extension, e.g. Talisman or Metamask.
+    For simplicity, we will be using the Talisman browser extension for this tutorial.
+    ## Step 1: Connect your wallets
+    To begin, you must first connect your Substrate and EVM wallet to the [TAO.app](https://www.tao.app/explorer) Bittensor explorer. This step requires that you have the Talisman wallet extension installed on your browser.
+    ### Connect your Substrate wallet
+. Visit the [TAO.app](https://www.tao.app/explorer) explorer page. If you do not already have a connected wallet, you will be redirected to the Talisman extension pop-up to connect a wallet
+. Select your preferred Substrate account and then click **Connect**.
+    <img src={SubstrateWallet} alt="Connect Substrate wallet" style={{width: 300, display: "flex", justifySelf: "center"}} />
+    <br/>
+    ### Connect your EVM wallet
+. Navigate to the [TAO.app](https://www.tao.app/bridge) bridge page.
+. On the **TAO EVM** tab, input the amount of native TAO to transfer from your Substrate wallet to the Bittensor EVM.
+. Click **Connect Wallet** and continue the process on the Talisman extension.
+    <img src={EVMWallet} alt="Connect EVM wallet" style={{width: 700, display: "flex", justifySelf: "center"}} />
+    <br/>
+    ## Step 2: Bridge TAO to Bittensor EVM
+    Now, you can conver native TAO to EVM-compatible TAO. To do this:
+. Ensure that you are on the **TAO EVM** tab within the [TAO.app](https://www.tao.app/bridge) bridge page.
+. Input the amount of TAO you want to transfer.
+. Click **Bridge** and then approve the transaction on the Talisman extension.
+    :::warning Gas fees
+    Ensure you have enough TAO in your native Substrate wallet to cover the gas fees for the transaction.
+    :::
+    Once the transaction is processed, verify that the TAO balance is now reflected in your Talisman EVM wallet.
+    ## Step 3: Wrap TAO to vTAO
+    After the TAO arrives on the Talisman EVM wallet, you can begin the process of wrapping TAO to vTAO.
+. Navigate to the **Bridge** tab within the [TAO.app](https://www.tao.app/bridge) bridge page to open the cross-chain bridge modal.
+. Click the **Sign & Accept** button to confirm the disclaimer and then approve with your Talisman wallet.
+. On the **From** dropdown, select TAO under **Bittensor (EVM)** and input the amount of TAO you want to wrap.
+. On the **To** dropdown, select vTAO under **Bittensor (EVM)**.
+. Click **Bridge** and sign the pop-up on the Talisman extension.
+    <img src={VTAOBridge} alt="vTAO bridge" style={{width: 700, display: "flex", justifySelf: "center"}} />
+    <br/>
+    This converts your TAO into vTAO, the wrapped version compatible with cross-chain activity. Once the transaction is processed, verify that the vTAO balance is now reflected in your Talisman EVM wallet.
+    :::warning Gas fees
+    Ensure you have enough TAO in your EVM wallet to cover the gas fees for the transaction.
+    :::
+    ## Next steps
+    After converting your TAO to vTAO, you can use it to earn staking rewards while using your TAO anywhere. For more information, see [Providing vTAO liquidity to Aerodrome](./vtao-liquidity-on-aerodrome.md).

docs/evm-tutorials/vtao-liquidity-on-aerodrome.md

-Original file line number
+Diff line change
@@ -0,0 +1,93 @@
+    ---
+    title: "Providing vTAO liquidity to Aerodrome"
+    ---
+    import ConvertVTAO from '/img/docs/convert-vtao.png';
+    import AerodromeDeposit from '/img/docs/aerodrome-deposit.png';
+    import vTAODeposit from '/img/docs/vtao-deposit.png';
+    import ConfirmDeposit from '/img/docs/confirm-deposit.png';
+    # Providing vTAO liquidity to Aerodrome
+    This page walks through how to move vTAO from the Bittensor EVM to the Base network to provide liquidity on Aerodrome.
+    :::danger Understanding liquidity positions
+    Providing liquidity in a Concentrated Volatile pool involves significant risk, including Impermanent Loss. Before following this tutorial, ensure you understand how price ranges affect your asset ratio.
+    For more information on how liquidity positions work, see [Understanding Liquidity Provision in DeFi](https://blog.uniswap.org/how-liquidity-provision-in-defi-works).
+    :::
+    ## Prerequisites
+    To continue with the rest of this tutorial,, you will need the following:
+    - An EVM Wallet browser extension containing some vTAO.
+    - Some ETH and USDC on the Base network in your EVM wallet.
+    To learn about how to convert native TAO to vTAO, see [Bridging and Wrapping vTAO](./vtao-bridge-tutorial.md).
+    ## Step 1: Bridge vTAO to Base
+    Bridging vTAO to Base is a two-step process: first, approve the smart contract to access your tokens, then execute the final transaction to confirm. To do this:
+. Navigate to the [TAO.app](https://www.tao.app/bridge) bridge page.
+. Switch to the **Bridge** tab within the [TAO.app](https://www.tao.app/bridge) bridge page to open the cross-chain bridge modal.
+. On the **From** dropdown, select vTAO under **Bittensor (EVM)** and input the amount of vTAO you want to bridge.
+. On the **To** dropdown, select vTAO under **Base**.
+. Click the **Approve vTAO** button and sign the pop-up on the browser extension.
+    <img src={ConvertVTAO} alt="Convert vTAO" style={{width: 700, display: "flex", justifySelf: "center"}} />
+    <br/>
+    Once the approval is confirmed, click the **Bridge** button and then sign the pop-up on the browser extension to finalize the transaction.
+    :::warning Gas fees
+    Bridging vTAO from the Bittensor EVM to Base requires native TAO for gas. Ensure your EVM wallet holds a sufficient TAO balance to cover these transaction fees.
+    :::
+    ## Step 2: Connect EVM wallet to Aerodrome
+. Visit to the [Aerodrome Finance](https://aero.drome.eth.limo/connect?to=%2Fdash%3F) page.
+. Click the **Browser Wallet** button to connect your EVM wallet.
+    :::tip
+    On the [TAO.app](https://www.tao.app/bridge) bridge page, retrieve the contact address for vTAO on the Base network from the **vTAO Contract Addresses** section—`0xe9f6D9898f9269B519E1435E6ebafF766c7f46BF`.
+    :::
+    ## Step 3: Configure the deposit pool
+. Navigate to the [Aerodrome dashboard](https://aero.drome.eth.limo/dash).
+. Click on the **New deposit** button to open the modal.
+. In the **Token you want to deposit** dropdown, select USDC.
+. On the **Token you want to pair with** dropdown, paste the contact address for vTAO on the Base network.
+. Open the **USDC/VTAO** pair tagged `0.3% Concentrated Volatile 200` and click **Continue**.
+    <img src={AerodromeDeposit} alt="Aerodrome deposit" style={{width: 700, display: "flex", justifySelf: "center"}} />
+    <br/>
+    ## Step 4: Deposit assets
+. Ensure that you are on the **New deposit** page
+. In the **Set price range** section, click the `USDC|vTAO` toggle to switch the view to vTAO.
+. Define your price range:
+       - **Low**: The lowest price in your range; below this, your position is 100% USDC.
+       - **High**: The highest price in your range; above this, your position becomes 100% vTAO.
+. Set the amount of vTAO to deposit.
+. Click **Deposit** and then sign the transaction in your EVM wallet.
+    :::warning Gas fees
+    Depositing assets on Aerodrome requires native ETH on the Base network for gas. Ensure your EVM wallet holds a sufficient ETH balance to cover these transaction fees.
+    :::
+    <img src={vTAODeposit} alt="vTAO deposit" style={{width: 700, display: "flex", justifySelf: "center"}} />
+    <br/>
+    :::info Two-Step Transaction Flow
+    To finish your deposit, you must sign two wallet prompts: first to approve the vTAO spend, and then to finalize. The second wallet pop-up will appear immediately after the first transaction clears.
+    :::
+    After signing the transaction that confirms the deposit, you can confirm the deposit by checking the [Aerodrome dashboard](https://aero.drome.eth.limo/dash).
+    <img src={ConfirmDeposit} alt="vTAO deposit" style={{width: 700, display: "flex", justifySelf: "center"}} />
+    Notice the new deposit under the **Liquidity Rewards** section.

sidebars.js

-Original file line number
+Diff line change
@@ Expand Up / @@ -289,6 +289,8 @@ const sidebars = { @@
             "evm-tutorials/convert-h160-to-ss58",
             "evm-tutorials/transfer-from-metamask-to-ss58",
             "evm-tutorials/transfer-between-two-h160-accounts",
+            "evm-tutorials/vtao-bridge-tutorial",
+            "evm-tutorials/vtao-liquidity-on-aerodrome",
             "evm-tutorials/withdraw-from-alice",
             "evm-tutorials/ed25519-verify-precompile",
             "evm-tutorials/staking-precompile",
@@ Expand Down @@

static/img/docs/aerodrome-deposit.png

Sorry, something went wrong. Reload?