VIA Protocol
  • Getting Started
    • Introduction
  • Technical Specs
    • Architecture Overview
    • Core Functionalities
      • Block Generation
      • Proof Generation
      • Proof Verification
      • Block Finality
    • Transaction Flows Overview
      • L2 Transactions
      • Deposits
      • Withdrawals
    • Inscription Standard
    • Verifier Network
  • User Guide
    • Bridge BTC between Bitcoin and VIA
    • Get VIA Testnet BTC
    • Run VIA Verifier Node
  • Developer Docs
    • Quickstart
    • Tooling
    • 🛰️ RPC Documentation
    • Connect to VIA Network
  • Future Research
    • System Constraints and Design Trade-offs
    • Trust-minimized BTC Bridge
  • FAQs & Troubleshooting
    • FAQs
    • Contact & Support
Powered by GitBook
On this page
  • 🧩 Required Wallets
  • Xverse Wallet
  • MetaMask Wallet
  1. User Guide

Bridge BTC between Bitcoin and VIA

Learn how to bridge your assets between Bitcoin Testnet3 and VIA Alpha Testnet.

PreviousVerifier NetworkNextGet VIA Testnet BTC

Last updated 15 days ago

The VIA Alpha Testnet is fully equipped to support BTC deposits and withdrawals through a simple and intuitive . This is the recommended interface for interacting with the network during the Alpha phase.

🧩 Required Wallets

To use the bridge, you’ll need to install and connect the following wallets:

Install on your browser or mobile device.


🔧 Setting Up Xverse Wallet for Testnet 3 for our Alpha Testnet

You need to configure the Xverse wallet properly to bridge BTC between Bitcoin Testnet3 and the VIA Alpha Testnet.

⚙️ Configure Xverse Wallet for Testnet3

  1. Open Xverse Wallet

    • Go to your browser extension or app.

    • Unlock your wallet.

  2. Access Network Settings

    • Click on the settings icon.

    • Go to Network settings.

  3. Select “Testnet3”

    • Choose the “Testnet3” option from the list.

  4. Set Custom URLs Fill in the fields as shown below:

    Stacks URL:

    https://api.testnet.hiro.so

    BTC URL:

    https://mempool.space/testnet/api

    Fallback BTC URL:

    https://blockstream.info/testnet/api
  5. Click "Save" After entering all the URLs correctly, click Save.

Once you’ve completed these steps, your Xverse Wallet will be fully connected to Bitcoin Testnet3, allowing you to interact with the VIA Alpha Testnet bridge for BTC deposits and withdrawals.

Make sure to only use testnet BTC with this configuration.


  • Required to sign and broadcast Bitcoin Testnet3 transactions (deposits).

  • Used to provide your Bitcoin Testnet3 address for receiving tBTC on L1.

MetaMask Wallet

  • Required to sign and broadcast VIA Testnet transaction (withdrawals).

  • Used to provide your VIA Testnet (EVM) address for receiving L2 funds.

MetaMask version >=12.15.2 is required to sign withdrawal (EIP712) transactions successfully.

Xverse Wallet Chrome Extension
MetaMask Wallet Chrome Extension
VIA Bridge
Xverse Wallet
Xverse Wallet
VIA Bridge UI Deposit
Xverse Wallet address
VIA Bridge UI Withdrawal
MetaMask Wallet