> ## Documentation Index
> Fetch the complete documentation index at: https://docs.superbots.finance/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect Your Wallet to UpBots SuperBots

> Learn how to connect a Web3 wallet to UpBots SuperBots using MetaMask or WalletConnect so you can deposit into vaults and manage your positions.

UpBots SuperBots uses Web3Modal to handle wallet connections. You do not need to create an account — your wallet address serves as your identity on the platform. Once connected, you can browse vaults, approve token spending, deposit funds, and track your positions.

## Before you connect

* **Install a wallet.** On desktop, MetaMask is the most common option. On mobile, use a wallet app with a built-in DApp browser, or any WalletConnect-compatible wallet.
* **Have gas tokens.** You need ETH on Ethereum or BNB on BNB Smart Chain to pay transaction fees. Without a small gas balance, on-chain actions such as approvals and deposits will fail.
* **Have the tokens you want to deposit.** Each vault accepts specific tokens (for example, USDC and WETH for spot vaults on Ethereum).

<Note>
  On desktop, UpBots SuperBots connects through injected browser wallets (such as MetaMask). On mobile, WalletConnect is also available.
</Note>

## How to connect

<Steps>
  <Step title="Open UpBots SuperBots in your browser">
    Navigate to the UpBots SuperBots app. If you are on desktop, make sure your wallet extension is installed and unlocked in your browser.
  </Step>

  <Step title="Click the wallet connect button">
    Click the **Connect wallet** button in the header. This opens the Web3Modal connection dialog.
  </Step>

  <Step title="Select your wallet">
    <Tabs>
      <Tab title="MetaMask (desktop)">
        Select **MetaMask** (shown as the injected provider) in the dialog. MetaMask will prompt you to approve the connection. Click **Connect** in the MetaMask popup.
      </Tab>

      <Tab title="WalletConnect (mobile)">
        Select **WalletConnect** in the dialog. Scan the QR code with your mobile wallet app. Approve the connection request in your wallet.
      </Tab>

      <Tab title="Binance Chain Wallet">
        If you have the Binance Chain Wallet browser extension installed, select it from the dialog and approve the connection request.
      </Tab>
    </Tabs>
  </Step>

  <Step title="Confirm the network">
    After connecting, check that your wallet is on the correct network for the feature you want to use — Ethereum (chain ID 1) for ETH-based vaults, or BNB Smart Chain (chain ID 56) for BSC-based vaults and staking. If you need to switch, use the network toggle in the header or switch directly in your wallet.
  </Step>

  <Step title="Start using the platform">
    Your wallet address appears in the header. You can now browse vaults, approve tokens, deposit funds, and track your portfolio.
  </Step>
</Steps>

## What happens after you connect

Once your wallet is connected, the platform reads your on-chain balances and fetches your existing positions across all vaults on the active network. The interface updates to show:

* Your token balances available for deposit
* Any existing vault positions and their current value
* Your transaction history (deposits, withdrawals, trades)

<Tip>
  If you previously connected your wallet, Web3Modal caches the provider. The next time you open the app, it attempts to reconnect automatically — you may not need to go through the connection steps again.
</Tip>

## Switching networks

Your wallet must be on the same network as the vault or feature you want to use.

<Steps>
  <Step title="Use the network toggle">
    Click the network toggle in the header to switch between Ethereum and BNB Smart Chain.
  </Step>

  <Step title="Approve the switch in your wallet">
    Your wallet prompts you to confirm the network switch. Click **Switch network** (or equivalent) to approve.
  </Step>

  <Step title="Wait for the page to refresh">
    The platform detects the new chain ID and reloads your balances and vault data for the selected network.
  </Step>
</Steps>

<Warning>
  If you try to deposit into a vault on a network your wallet is not connected to, the transaction will fail. Always confirm the active network in both the platform header and your wallet before submitting any transaction.
</Warning>

## Disconnecting your wallet

To disconnect, click your wallet address in the header and select **Disconnect**. This clears the cached provider and resets your session. Your on-chain funds are not affected — they remain in the smart contracts until you withdraw them.