> For the complete documentation index, see [llms.txt](https://docs.basis.pro/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.basis.pro/getting-started/deposits/wallet-connection-guide.md). # Wallet Connection Guide {% hint style="info" %} Operator and jurisdiction: BASIS is operated by BASIS DIGITAL INFRASTRUCTURE LTD, a Seychelles IBC (LEI: [254900IX2F2KCWNSSS64](https://lei.bloomberg.com/leis/view/254900IX2F2KCWNSSS64)). {% endhint %} This guide explains the correct wallet connection flow for ETH, PAXG, and SOL deposits on BASIS. *** ## Supported Assets and Wallets | Asset | Supported Network | Recommended Wallet | Required Path | | ----- | --------------------- | ------------------ | ---------------------------------- | | ETH | Ethereum Mainnet only | MetaMask | Assets page > Deposit | | PAXG | Ethereum ERC-20 only | MetaMask | Assets page > Deposit | | SOL | Solana Mainnet only | Phantom Wallet | Assets page > Deposit | | BTC | Bitcoin Mainnet only | N/A | BASIS-assigned BTC deposit address | {% hint style="warning" %} ETH and PAXG deposits must be completed on an Ethereum/ERC-20 compatible wallet flow. SOL deposits must be completed on the Solana wallet flow. If an unsupported wallet cannot complete the smart-contract flow, use the recommended wallet for that asset. {% endhint %} *** ## Correct Flow: Deposit from the Assets Page ### Step 1 - Open the Assets Page Navigate to **Assets** and locate the **Deposit**, **Withdraw**, or **Swap** buttons. These buttons open the BASIS asset-specific deposit workflow. {% hint style="success" %} Always start deposits from the **Assets page**. Use the Deposit, Withdraw, or Swap buttons shown below. {% endhint %} ![Use the Deposit / Withdraw / Swap buttons on the Assets page.](https://docs-img.basis.pro/step-01-assets-page.png) *** ### Step 2 - Select the Asset and Connect the Correct Wallet If the selected asset does not have a wallet connected, the deposit modal will display a **Connect Wallet** button. Click it to begin the wallet connection. ![If the asset wallet is not connected, click Connect Wallet from the deposit modal.](https://docs-img.basis.pro/step-02-connect-wallet.png) *** ### Step 3 - Choose the Recommended Wallet Select the wallet that matches the asset network. * For **ETH** and **PAXG**: select **MetaMask** * For **SOL**: select **Phantom Wallet** {% hint style="info" %} WalletConnect and other wallets may appear in the list, but compatibility can vary. Use MetaMask for ETH/PAXG and Phantom for SOL to ensure a reliable flow. {% endhint %} ![Select MetaMask for ETH/PAXG or Phantom Wallet for SOL.](https://docs-img.basis.pro/step-03-wallet-selection.png) *** ### Step 4 - Approve the Wallet Connection Review the wallet connection prompt in your wallet application. Confirm only the account you intend to use for this deposit. ![Review the account details and approve the wallet connection.](https://docs-img.basis.pro/step-04-approve-connection.png) *** ### Step 5 - Confirm the Deposit Transaction Review the amount, asset, and destination in the BASIS deposit modal. Then confirm the transaction in your connected wallet. {% hint style="warning" %} Verify all details - asset type, network, amount, and destination address - before signing. Confirm only after everything matches the BASIS deposit modal. {% endhint %} ![Review the amount and confirm the transaction in your connected wallet.](https://docs-img.basis.pro/step-05-confirm-transaction.png?v=2) *** ## Switching Between MetaMask and Phantom This section explains how to switch from an Ethereum-compatible wallet used for ETH or PAXG to a Solana-compatible wallet when depositing SOL. Use this flow whenever you need to move between Ethereum and Solana wallet connections. ### Overview BASIS uses asset-specific wallet connections. ETH and PAXG are handled on the Ethereum network and are recommended to be used with MetaMask. SOL is handled on the Solana network and is recommended to be used with Phantom Wallet or another Solana-compatible wallet. If an Ethereum wallet is currently connected and you want to deposit SOL, disconnect the Ethereum wallet first, then connect a Solana-compatible wallet from the Deposit modal. | Asset | Network | Recommended Wallet | Action | | ----- | -------- | ------------------ | ----------------------------------------------------------------------------------------- | | ETH | Ethereum | MetaMask | Use Deposit / Withdraw from the Assets page. | | PAXG | Ethereum | MetaMask | Use the same Ethereum wallet flow as ETH. | | SOL | Solana | Phantom Wallet | Disconnect the Ethereum wallet first, then connect Phantom or a Solana-compatible wallet. | {% hint style="info" %} The wallet shown in the top-right corner is the currently connected wallet. Use it to manage, switch, or disconnect the active wallet connection before selecting another network. {% endhint %} *** ### Step 1 - Open the Connected Wallet Panel On the Assets page, click the connected wallet indicator in the top-right corner. This opens the Connected Wallet panel. ![Open the Connected Wallet panel from the top-right wallet indicator.](https://docs-img.basis.pro/step-switch-01.png) *** ### Step 2 - Disconnect the Current Ethereum Wallet If you were previously using ETH or PAXG, an Ethereum wallet may still be connected. Click **Disconnect** to clear the current Ethereum wallet connection. ![Disconnect the currently connected Ethereum wallet before switching to SOL.](https://docs-img.basis.pro/step-switch-02.png) *** ### Step 3 - Select Solana (SOL) in the Deposit Modal Return to **Assets**, open **Deposit**, and select **Solana (SOL)**. When no Solana wallet is connected, click **Connect Wallet**. ![Select Solana (SOL), then click Connect Wallet.](https://docs-img.basis.pro/step-switch-03.png) *** ### Step 4 - Choose a Solana-Compatible Wallet Select **Phantom Wallet** or another Solana-compatible wallet from the wallet list. BASIS recommends Phantom Wallet for SOL operations. ![Select Phantom Wallet or another Solana-compatible wallet.](https://docs-img.basis.pro/step-switch-04.png) *** ### Step 5 - Approve the Wallet Connection Your wallet will display a connection request. Review the account and connect it to basis.pro. Only approve connection requests from the official BASIS website. ![Confirm the connection request inside the selected Solana wallet.](https://docs-img.basis.pro/step-switch-05.png) *** ### Step 6 - Confirm That the SOL Wallet Is Active After the Solana wallet is connected, the SOL Deposit form becomes available. Review the connected wallet, enter the amount, and proceed with the deposit flow. ![The SOL Deposit form is available after a Solana wallet is connected.](https://docs-img.basis.pro/step-switch-06.png) *** ### Switching Back to ETH or PAXG The same process applies in reverse. If a Solana wallet is connected and you want to deposit or withdraw ETH or PAXG, open the Connected Wallet panel, disconnect the Solana wallet, and then connect MetaMask on the Ethereum network. After switching wallets, always confirm that the selected asset, network, and connected wallet match before proceeding with Deposit or Withdraw. *** ## Troubleshooting Checklist * Confirm the selected asset matches the wallet network. * For ETH and PAXG: verify the wallet is using the **Ethereum / ERC-20** network. * For SOL: verify **Phantom Wallet** is connected and set to **Solana Mainnet**. * Refresh the page and reconnect the recommended wallet if the Deposit button does not proceed. * If a third-party wallet fails to complete the flow, retry with **MetaMask** (ETH/PAXG) or **Phantom** (SOL). * Disconnect the previously connected wallet when switching between Ethereum and Solana networks. * After switching wallets, confirm that the selected asset, network, and connected wallet match before proceeding. * If the expected wallet is not shown, verify that the wallet extension is installed, unlocked, and set to the correct network. * If support review is required, provide the asset, network, wallet address, screenshots, and transaction hash (if a transaction was submitted). *** ## Related Resources * [BASIS App](https://basis.pro) * [BASIS Documentation](https://docs.basis.pro) * [Deposit BTC](https://docs.basis.pro/getting-started/deposits/deposit-btc) * [Deposit ETH](https://docs.basis.pro/getting-started/deposits/deposit-eth) * [Deposit SOL](https://docs.basis.pro/getting-started/deposits/deposit-sol) * [Deposit PAXG](https://docs.basis.pro/getting-started/deposits/deposit-paxg) --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.basis.pro/getting-started/deposits/wallet-connection-guide.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.