# Wallet Connection

This section details how to connect your compatible wallet to your Rails account for deposits and withdrawals.&#x20;

{% hint style="warning" %}
**Before you continue:**

* Wallet Connections, Deposits & Withdrawals are not supported on mobile at this time.
* You will not be able to connect a wallet [unless your available balance is 0](#why-cant-i-change-my-wallet-when-i-have-an-available-balance).
* Rails will never request your private keys. If you [lose access to your wallet](/deposits-and-withdrawals/wallet-connection.md#what-if-ive-lost-access-to-my-linked-wallet-address), you will not be able to update your wallet address in Rails.
* Wallet connection is only available on your Main account.  Learn more about how Rails sub-accounts  work [here](/general/navigating-the-platform/main-and-sub-accounts.md).
  {% endhint %}

<table data-view="cards"><thead><tr><th align="center"></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td align="center"><strong>Compatible Wallets</strong></td><td><a href="/pages/XIwZ69Xy4CzagK6JP2LQ#what-wallets-are-supported">/pages/XIwZ69Xy4CzagK6JP2LQ#what-wallets-are-supported</a></td></tr><tr><td align="center"><strong>Connecting Your Wallet</strong></td><td><a href="/pages/XIwZ69Xy4CzagK6JP2LQ#connecting-your-wallet">/pages/XIwZ69Xy4CzagK6JP2LQ#connecting-your-wallet</a></td></tr><tr><td align="center"><strong>Changing Your Wallet</strong></td><td><a href="/pages/XIwZ69Xy4CzagK6JP2LQ#changing-your-wallet">/pages/XIwZ69Xy4CzagK6JP2LQ#changing-your-wallet</a></td></tr></tbody></table>

## Connecting your Wallet

{% columns %}
{% column %}

1. Click **Deposit** in the top right corner of the trading platform from your desktop.

{% endcolumn %}

{% column %}

<figure><img src="/files/l45rBoZgdQEjrmcFbnx5" alt="" width="375"><figcaption></figcaption></figure>
{% endcolumn %}
{% endcolumns %}

{% columns %}
{% column %}
2\. Click **Connect Wallet.**
{% endcolumn %}

{% column %}

<figure><img src="/files/YHixDC27WEXLMdYi0JN3" alt="" width="375"><figcaption></figcaption></figure>
{% endcolumn %}
{% endcolumns %}

{% columns %}
{% column %}
3\. Select your [compatible wallet](#what-wallets-are-supported) from the available list. Make sure you have the appropriate extension installed.&#x20;
{% endcolumn %}

{% column %}
{% hint style="info" %}
**Note**: Some users have reported issues with Phantom, Uniswap and Trust Wallet. We recommend using alternative wallets like Metamask or Rainbow. Check out these [troubleshooting tips](/support/troubleshooting-tips.md#wallets-deposits-and-withdrawals) for additional help.
{% endhint %}
{% endcolumn %}
{% endcolumns %}

4. Follow the prompts in your wallet to connect to Rails, and you'll be directed to the [deposit](/deposits-and-withdrawals/deposits.md#before-you-deposit) screen.

## Changing Your Wallet

Before you can connect a new wallet address you'll need to unlink your current wallet address.  You'll need to be on desktop, as mobile wallet connection is not currently supported.

Once you're ready, follow the steps below:

<details>

<summary>How to unlink and change your connected wallet</summary>

1. If your balance is greater than 0.00 follow these steps, else jump to step 2.
   1. Navigate to the main trading page and click **Close** next to all open positions.
   2. [Withdraw](/deposits-and-withdrawals/withdrawals.md) your full account balance.
2. Click on the **Options (3 lines)** tab on the top right of your trading screen and select **Settings**.
3. Click on **Wallet** on the left of the options page.
4. Click on **Unlink Wallet**.
5. Click on **Send Code**.
6. Check your email for the One-Time-Passcode (OTP).
7. Input the code and click **Unlink Wallet**.
8. Click **Connect Wallet** to connect a new wallet address via [these steps](#connecting-your-wallet).

</details>

## Frequently Asked Questions

<details>

<summary>What wallets are supported?</summary>

Most wallets are supported, but some may make it difficult for you to view the bridging or deposit transactions in your wallet. This is because not all natively support the Ink network.&#x20;

If you can't see the transaction in your wallet, you can verify if it was successful using [Layer Zero Scan](https://layerzeroscan.com/) or the blockchain transaction verification site of your choosing, and try importing the Ink network to your wallet manually.

The table below lists all wallets that we have confirmed support the Ink network:

<table><thead><tr><th width="203.09552001953125">Wallet</th><th width="263.18499755859375">Ink Network Support</th></tr></thead><tbody><tr><td>Kraken</td><td><mark style="background-color:green;">Natively supported</mark></td></tr><tr><td>Rainbow</td><td><mark style="background-color:green;">Natively Supported</mark></td></tr><tr><td>Metamask</td><td><mark style="background-color:green;">Supported</mark></td></tr><tr><td>Coinbase</td><td><mark style="background-color:green;">Supported</mark></td></tr><tr><td>OKX</td><td><mark style="background-color:green;">Supported</mark></td></tr><tr><td>Brave</td><td><mark style="background-color:green;">Supported</mark></td></tr></tbody></table>

{% hint style="info" %}
If your preferred wallet isn't listed, it may still support Ink. We recommend verifying compatibility with Ink before proceeding.
{% endhint %}

</details>

<details>

<summary>What is a connected vs. linked wallet?</summary>

Since Rails uses onchain custody, a digital wallet is required to be **connected** and **linked** to your account to deposit or withdraw funds.&#x20;

* **Connected**: Provide authorization for the Rails platform to interact with your wallet by verifying the connection in your wallet.&#x20;
* **Linked**: One wallet address is linked or fixed to each account at a time. Wallets are automatically linked to your account at time of first connection. [Changes](#changing-your-wallet) can only be made by unlinking your wallet which requires an account balance of $0.00.&#x20;

</details>

<details>

<summary>What if I forgot which wallet address is linked to my account?</summary>

To find the public address of your linked wallet, do the following:

1. [Login](https://trade.rails.xyz/trade/BTC-USD) to your Rails account.
2. Click on the **Options button** (Username) on the top right corner and then select **Settings**.
3. Click **Wallet** in the left-hand navigation bar.&#x20;
4. Your public address is listed under <kbd>Wallet Address</kbd>.  If you don't see this section, you do not have a linked wallet and may connect a new one.&#x20;

</details>

<details>

<summary>What if I've lost access to my linked wallet address?</summary>

As an onchain custody platform, if you lose access to your wallet we are not able to help you reclaim access to it or any tokens it may have held. &#x20;

If you've lost access to your linked wallet and your account balance is greater than 0, you will not be permitted to change it. You will need to open a new account to connect a new wallet, or wait until your balance is 0.

{% hint style="danger" %}
Not your keys, not your coins! Never share your private keys with ANYONE. Rails will never ask for these.
{% endhint %}

</details>

<details>

<summary>Why can't I change my wallet when I have an available balance?</summary>

Rails restricts or limits wallet changes intentionally to increase security and reduce risk on the platforms.

This means that all open positions must be closed and funds withdrawn to an already connected wallet.  Users are only permitted to change their wallet address if their account balance is 0.

Rails users must take proactive steps to secure their private keys or secret recovery codes.

</details>


---

# Agent Instructions: 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:

```
GET https://help.rails.xyz/deposits-and-withdrawals/wallet-connection.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
