Note: We will be using the 2 way peg app on 2-Way Peg App - Testnet for learning purposes. For transactions using real tokens, use the 2-Way Peg App - Mainnet application.

Install Apps

The Bitcoin testnet app does not show on Ledger live manager by default. To be able to see the BTC Testnet app you need to enable the developer mode in Ledger live.

  • Enable Developer Mode for Bitcoin Testnet
    1. Connect your ledger hardware device and unlock it.
    2. Open Ledger live, click on Manager and open settings.
    3. Navigate to the experimental features menu and enable developer mode. This will show developer and testnet apps in the manager.
      Install Apps Settings
    4. Go to Ledger live manager and search for Bitcoin testnet app
    5. Click on install to install the Bitcoin Testnet application. To use the testnet app you also need the main Bitcoin app. So install both the apps to your device.
      Install bitcoin test
  • Get Testnet address
    • On your ledger device, you’ll find all the apps installed on your device. The Bitcoin app to be used on Mainnet, and Bitcoin Test app to be used on Testnet. To start using testnet, we need the testnet address, to get this address:
      1. Open the Bitcoin test app on your ledger device. You will see a “Bitcoin Testnet is ready” screen
      2. In the ledger live app, go to accounts tab, click on add account.
        Add Account
      3. Search testnet and select Bitcoin Testnet (BTC). Click on Continue
        Add Account 2
      4. Approve the Bitcoin Test app on your hardware wallet device
      5. On the next screen choose the address format (Native SegWit / SegWit).
      6. Click on Add Account:
        Add Accounts 3

      Note: See supported addresses for the types of addresses supported by the 2 way peg app.

      • You have successfully added the Bitcoin testnet app to your account.
        Account Added Successfully

Get Funds

  • Get Testnet Tokens
    1. Go to the receive tab on Ledger live.
      Receive tab
    2. Select Bitcoin testnet and click on continue.
      Receive Tab - Select Bitcoin Testnet
    3. Copy BTC Testnet address
      Copy BTC Testnet Address
    4. Use the following faucet to receive testnet tokens:
      • Open Coinfaucet
      • Paste the address into the field and click on Get Bitcoins.

    Note: You need at least 0.005 BTC to perform a peg-in on Mainnet and Testnet. Likewise, you need at least 0.004 RBTC to perform a peg-out on Mainnet and Testnet.

  • Get Mainnet Tokens

    The 2 way peg app is available on both Mainnet and Testnet. Both applications follow the same process, for production purposes, use Mainnet, for testing and development purposes, use the Testnet. See glossary for explanation of these terms.

Setup Requirements

To get started with the 2-way peg app, ensure you have the following:

  • System Requirements
    • A computer with at least Windows 8.1 (64-bit), macOS 10.10, or a Linux distribution, and an internet connection.
  • Hardware Wallets

    For Peg-out requirements, ensure you have either the Liquality or Metamask wallet installed in your browser. For more information, see Supported Browsers and Supported Wallets.

  • Funds
    • A minimum balance of 0.005 BTC for peg-in and 0.004 RBTC for peg-out processes.

Note: This guide primarily uses the Ledger Nano S hardware wallet for illustration, but all models of Ledger and Trezor wallets are compatible with the 2-way peg app. If you do not have any of the listed hardware wallets, consider purchasing one from the official Ledger or Trezor websites.


Receive updates

Get the latest updates from the Rootstock ecosystem