> For the complete documentation index, see [llms.txt](https://help.rails.xyz/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.rails.xyz/manage-account/wallet-connection.md).

# Wallet Connection

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

You'll need a [Stellar compatible](#compatible-wallets) digital asset wallet to use [Rails Exchange](https://help.rails.xyz/about-rails/rails-exchange.md). The following guide will help you connect your wallet.

## Wallet Basics

{% hint style="info" %}
If you're already familiar with digital asset wallets basics, skip forward to [#how-wallets-work-on-stellar](#how-wallets-work-on-stellar "mention").
{% endhint %}

A digital asset wallet is a secure software application or hardware device used to manage, send, and receive cryptocurrencies and tokens. Rather than physically storing your coins, it holds the cryptographic private keys that prove your ownership and authorize transactions on a blockchain. Think of it like a digital keychain:

* your **public wallet address** acts like a bank account number others can send funds to.
* your **private key** is the master password that unlocks and moves them.

There are several different wallets available, however, because Rails is built on the Stellar network, you'll need one that is compatible with Stellar.

Stellar is a specialized payment network, using addresses that start with G address prefixes. EVM chains (like Ethereum, Arbitrum, or Polygon) are broader "programmable" blockchains using 0x address prefixes. Because they speak completely different technical languages, you cannot send funds directly between them without using a bridge or a crypto exchange to convert the asset from one network to the other.

These wallets generally fall into three categories:

1. browser extensions (software plugins that connect directly to web applications)
2. mobile apps (smartphone wallets designed for on-the-go access)
3. hardware wallets (physical offline devices that offer maximum security for long-term storage).

For the best experience on Rails, we recommend using a browser extension wallet, as it integrates seamlessly with our desktop interface to make connecting, signing transactions, and trading fast and effortless.

## How Wallets Work on Stellar

{% hint style="info" %}
If you've already used Stellar wallets, you likely have the XLM you need and can skip straight to [#connecting-a-funded-stellar-wallet](#connecting-a-funded-stellar-wallet "mention").
{% endhint %}

Unlike standard wallets on other networks, Stellar-compatible wallets have unique account activation and asset permission rules set by the Stellar Network. There are 2 specific requirements before you can start using any Stellar-compatible wallet:

1. **You must have a small amount of XLM for Gas fees:** Every wallet on the Stellar network requires a small amount of [Stellar Lumens (XLM)](https://stellar.org/learn/lumens) to maintain its minimum base reserve and cover micro-transaction fees (commonly referred to as gas fees). This is similar to Ethereum wallets requiring a small amount of ETH to cover the same type of fees.
2. **Trustlines for USDT:** The Stellar ledger also requires you to establish a trustline. A trustline is an explicit opt-in setting on the Stellar ledger that authorizes your wallet address to hold, receive, and trade a specific custom asset (such as USDT) from a designated issuer, while simultaneously reserving a small amount of XLM to maintain that permission on-chain. If you're new to Stellar, you'll need to establish a trustline to hold USDT when [#setting-up-a-new-wallet](#setting-up-a-new-wallet "mention").

Rails sponsors the XLM required for your initial account setu&#x70;**.** When you connect a new wallet, Rails automatically sponsors fee requirements as part of [#wallet-connection](#wallet-connection "mention"), allowing you to start trading immediately without manually sourcing XLM beforehand.

## Compatible Wallets

Both MetaMask and Varial wallets allow you to hold, send, and manage digital assets including [USDT](https://help.rails.xyz/manage-account/manage-funds/acquiring-usdt.md) on Stellar, which means they can both be used with Rails Exchange:

1. **MetaMask** is the world’s most popular browser extension wallet, trusted by over 30 million monthly active users as the industry standard for connecting to Ethereum and EVM-compatible decentralized applications. MetaMask now supports the Stellar chain.&#x20;
2. **Varial** (formerly known as Freighter) is the official, flagship browser extension wallet developed by the Stellar Development Foundation, serving as the primary industry standard for connecting to decentralized applications across the Stellar ecosystem.

You can choose either wallet, but Rails recommends MetaMask if you're new to digital asset trading or aren't already familiar with the Stellar network. Our in-app [Bridge](https://help.rails.xyz/manage-account/manage-funds/bridge.md)flow also works best on Rails with MetaMask, so if you already hold USDT on a supported network, the flow is optimized for you already.

You can get either wallet at the sites below:

<table><thead><tr><th width="195.8125"></th><th>MetaMask</th><th valign="top">Varial</th></tr></thead><tbody><tr><td>Website</td><td><a href="https://metamask.com/">https://metamask.com/</a></td><td valign="top"><a href="https://varialwallet.com/">https://varialwallet.com/</a></td></tr><tr><td>Chrome Browser Extension</td><td><a href="https://chromewebstore.google.com/detail/metamask/nkbihfbeogaeaoehlefnkodbefgpgknn">https://chromewebstore.google.com/detail/metamask/nkbihfbeogaeaoehlefnkodbefgpgknn</a></td><td valign="top"><a href="https://chromewebstore.google.com/detail/varial-wallet/bcacfldlkkdogcmkkibnjlakofdplcbk?pli=1">https://chromewebstore.google.com/detail/varial-wallet/bcacfldlkkdogcmkkibnjlakofdplcbk?pli=1</a></td></tr></tbody></table>

{% hint style="info" %}
We recommend installing your chosen wallet's browser extension installed for the best Rails experience. Mobile wallet connections are not currently supported, so you must be on Desktop to manage your wallet connection. We also recommend using Chrome as your browser. See below on how to ensure you have your browser connection set up:

<p align="center"><img src="https://1893902947-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvoJ4s2ha99AB453yyXn5%2Fuploads%2F9gnDt2YwC38FLtIRESho%2FWhere%20to%20find%20your%20wallet%20extension.png?alt=media&amp;token=f1500aaa-cf2d-48b5-9953-e24fa997921f" alt=""></p>
{% endhint %}

## Access Wallet Settings

{% columns %}
{% column width="58.333333333333336%" %}
Access your wallet settings in Rails directly from your profile at the bottom of the sidebar.

From here, you can manage your wallet connection by [connecting](#wallet-connection), or [changing your wallet](https://help.rails.xyz/manage-account/wallet-connection.md#changing-your-wallet) (provided your account balance is 0). This section ensures that your on-platform trading experience remains smooth, secure, and fully under your control.
{% endcolumn %}

{% column width="41.666666666666664%" %}

<figure><img src="https://1893902947-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvoJ4s2ha99AB453yyXn5%2Fuploads%2Fg1yxaYgHvJejiByp3K75%2FCleanShot%202026-11-06%20at%2011.30.06%20AM%402x.jpg?alt=media&amp;token=2efa6087-c42e-4e55-bb88-28324c6e28e2" alt=""><figcaption></figcaption></figure>
{% endcolumn %}
{% endcolumns %}

The [Wallet](https://help.rails.xyz/manage-account/wallet-connection.md) section displays the public address of the wallet currently linked to your account, along with its current status (either connected or disconnected):

<figure><img src="https://1893902947-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvoJ4s2ha99AB453yyXn5%2Fuploads%2FYPCHCPMUorhPlxvvWZLt%2FCleanShot%202026-11-06%20at%2012.15.14%20PM%402x.jpg?alt=media&amp;token=2e38a160-b839-438b-b298-c916ca233953" alt="" width="563"><figcaption></figcaption></figure>

## Wallet Connection

{% hint style="info" %}

#### **Before you continue**

* Wallet Connections, Deposits & Withdrawals are not supported on mobile at this time.
* You can only change your linked wallet when your account balance is $0.00. Close all positions and withdraw your full balance first.
* Rails will never request your private keys. If you lose access to your wallet, you will not be able to update your wallet address in Rails.
  {% endhint %}

{% hint style="info" %}
If you've already previously funded a wallet with XLM and USDT, you have already completed these steps, and you can skip forward to [#connecting-a-funded-stellar-wallet](#connecting-a-funded-stellar-wallet "mention").
{% endhint %}

When you connect a wallet for the first time, Rails guides you through a short setup: we verify your wallet, activate it on the Stellar network, and enable it to hold USDT, the collateral used on Rails. Each step needs your approval in your wallet, and the full setup usually takes just a few minutes.

### Setting Up A New Wallet

{% columns %}
{% column width="66.66666666666666%" %}
If you've never interacted with the Stellar Network through MetaMask or Varial, you'll need to follow the steps to allow Rails to sponsor XLM on Stellar for you, and enable your USDT trustline. Once your wallet is connected, Rails walks you through 3 setup steps. You'll see your progress at the top of each screen in the modal.

If you already use MetaMask, your wallet group also gives you a Stellar wallet address that you can use, as shown. This means that your EVM wallet has an associated Stellar Wallet address, and you don't need to get another wallet to get started on Rails.

Both flows are similar, but we recommend using MetaMask as [Acquiring USDT](https://help.rails.xyz/manage-account/manage-funds/acquiring-usdt.md)  and bridging it from other supported blockchains is simpler on Rails.
{% endcolumn %}

{% column width="33.33333333333334%" %}

<figure><img src="https://1893902947-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvoJ4s2ha99AB453yyXn5%2Fuploads%2FbyM2noLek8NfuZfjOoLU%2FCleanShot%202026-11-13%20at%201.31.55%20PM%402x.jpg?alt=media&amp;token=e966cbd7-7363-4ee1-a46a-5c1cc639d08e" alt="" width="375"><figcaption><p>MetaMask Stellar Public Address</p></figcaption></figure>

{% endcolumn %}
{% endcolumns %}

Once your wallet is connected, Rails walks you through 3 setup steps. You'll see your progress at the top of each screen in the modal. Note: the example screens show the Meta Mask flow.

{% stepper %}
{% step %}

### Connect & Verify Your Wallet

Select Connect Wallet in the top-right hand side of your screen on any page. You can also go through [Wallet Settings](#access-wallet-settings) from your profile to access the same flow. Rails verifies your wallet automatically. There's nothing for you to do, and it only takes a few seconds.

<figure><img src="https://1893902947-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvoJ4s2ha99AB453yyXn5%2Fuploads%2FvpoBmhJA8iDqAMvAdRqg%2FCleanShot%202026-11-13%20at%201.40.34%20PM.gif?alt=media&amp;token=41e5932e-8641-4b1d-89b6-d88956ae08b0" alt="" width="563"><figcaption></figcaption></figure>

Rails automatically links this wallet to your account. When verification is complete, you'll see the confirmation message "*Your Stellar wallet is verified and ready to use*."

{% hint style="info" %}
While we review your wallet, you'll see a notice that deposits and positions are restricted. This clears once verification is complete.
{% endhint %}
{% endstep %}

{% step %}

### Activate Your Wallet with XLM

A new Stellar wallet needs XLM before it's active on the Stellar network. Rails can sponsor your account by covering the required XLM on your behalf.

1. Click **Sponsor my account**.
2. Review the transaction in your wallet and click **Confirm**.

<figure><img src="https://1893902947-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvoJ4s2ha99AB453yyXn5%2Fuploads%2FCH3qCIoNsiXawM2ZgeKH%2FCleanShot%202026-11-13%20at%201.56.38%20PM.gif?alt=media&amp;token=633de6c7-29b5-4eb6-a7c6-0fb1d1d97948" alt="" width="563"><figcaption></figcaption></figure>

You'll see "*Stellar account created"* once your wallet is active.

{% hint style="info" %}
**Prefer to fund XLM yourself?** Instead of using sponsorship, you can activate your wallet by sending 2.5 XLM to it instead. If your wallet is pre-funded with XLM, the Wallet Set-up flow will confirm this, and move to the next step.
{% endhint %}
{% endstep %}

{% step %}

### Enable a Trustline for USDT0

Rails uses USDT as collateral, so your wallet needs a trustline before it can hold USDT.

1. Click **Enable USDT0**.
2. Review the **Add Trustline** request in your wallet and click **Confirm**.

<figure><img src="https://1893902947-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvoJ4s2ha99AB453yyXn5%2Fuploads%2FxIjTQONYCiDOIkzeoKLu%2FCleanShot%202026-11-13%20at%202.07.15%20PM.gif?alt=media&amp;token=675c527f-a378-473b-980a-f2c850a7990c" alt="" width="563"><figcaption></figcaption></figure>

You'll see *Trustline submitted*, followed by *Your wallet is ready*.
{% endstep %}
{% endstepper %}

Once all thre steps have been completed successfully, you're ready to [Deposit](https://help.rails.xyz/manage-account/manage-funds/deposit.md). If you don't already have USDT on Stellar, see [Acquiring USDT](https://help.rails.xyz/manage-account/manage-funds/acquiring-usdt.md).

### Connecting a funded Stellar Wallet

If you've previously funded your wallet with XLM & USDT, connecting your wallet is much simpler as you've already funded your account with XLM, and have set up a trustline to receive USDT:

1. Click **Connect Wallet** in the top right corner of the trading platform. You can also connect from **Wallet Settings** in your profile, found in the bottom left of your screen. You'll see the verification step that confirms your wallet on the Stellar Network.
2. Click **Connect wallet**, and choose your preferred wallet from the drop-down menu.
3. Review the **Connection Request** in your wallet and click **Connect**. This allows Rails to view your wallet address, balance and activity, and to request your approval for transactions.
4. Your wallet then asks you to sign a message confirming that you accept the Rails Terms of Service. Click **Confirm**.

<figure><img src="https://1893902947-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvoJ4s2ha99AB453yyXn5%2Fuploads%2FJ47MZyjHQnJJofQ96E2g%2FCleanShot%202026-11-05%20at%205.23.26%20PM.gif?alt=media&amp;token=9a1ac168-5350-4e68-80c0-0cf42cd9e1a5" alt="" width="563"><figcaption></figcaption></figure>

The steps above are generally for the first time you connect your wallet. Your wallet may become "disconnected" from Rails occasionally, but stay linked to your Rails account. Connecting your wallet in those cases will appear much faster.

## Changing Your Wallet

{% hint style="warning" %}
We'll send you a **Wallet updated** notification whenever the wallet linked to your account changes. If you didn't make the change, [Contact Us](https://help.rails.xyz/support/contactus.md) immediately.
{% endhint %}

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 connections are not currently supported.

You can only change your wallet when your balance is 0 across Rails Exchange, so make sure to close all your open positions, and withdraw funds from Rails before you attempt to change your wallet.

{% columns %}
{% column width="41.66666666666667%" %}
You'll see an error message if your wallet change is not permitted because of a balance.
{% endcolumn %}

{% column width="58.33333333333333%" %}

<figure><img src="https://1893902947-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvoJ4s2ha99AB453yyXn5%2Fuploads%2FBfJpSVMvGXqsSC2KLZLW%2FCleanShot%202026-11-06%20at%2011.39.56%20AM%402x.jpg?alt=media&amp;token=57149e85-d6ff-40c6-bd58-cdd5e47c6d19" alt=""><figcaption></figcaption></figure>
{% endcolumn %}
{% endcolumns %}

Once you're ready, follow the steps below:

{% columns %}
{% column width="41.66666666666667%" %}

1. Navigate to your **Account** **Settings**.
2. Click on **Wallet Settings**.
3. Click on **Unlink Wallet**.
   {% endcolumn %}

{% column width="58.33333333333333%" %}

<figure><img src="https://1893902947-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvoJ4s2ha99AB453yyXn5%2Fuploads%2FUVoUS4KLks8DnwtQRcjv%2FCleanShot%202026-11-05%20at%206.06.55%20PM%402x.jpg?alt=media&amp;token=deaa4a30-c16b-44fa-a595-826a84fc9db0" alt=""><figcaption></figcaption></figure>
{% endcolumn %}
{% endcolumns %}

{% columns %}
{% column width="41.66666666666667%" %}
4\. Click on **Send Code**.
5\. Check your email for your Verification Code.
6\. Input the code and click **Unlink Wallet**.

Then connect a new wallet address that you own using the [#wallet-connection](#wallet-connection "mention") steps above.
{% endcolumn %}

{% column width="58.33333333333333%" %}

<figure><img src="https://1893902947-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvoJ4s2ha99AB453yyXn5%2Fuploads%2FazpF2A2M5xkth8ZGA0fB%2FCleanShot%202026-11-05%20at%206.08.39%20PM%402x.jpg?alt=media&amp;token=f456e6e5-2ae0-4148-8fd0-e4512bbc6c1d" alt=""><figcaption></figcaption></figure>
{% endcolumn %}
{% endcolumns %}

{% hint style="info" %}
**Still need help?** See our [Troubleshooting Guide](https://help.rails.xyz/support/troubleshooting-guide.md), or [Contact Us](https://help.rails.xyz/support/contactus.md) for assistance.
{% endhint %}
