🛠️
Stacks Documentation
  • Start Here
  • 🧠Concepts
    • Stacks 101
      • What Is Stacks?
      • Bitcoin Connection
      • Proof of Transfer
      • Stacks Among Other Layers
      • Financial Incentive and Security Budget
    • Network Fundamentals
      • Network Basics
      • Mainnet and Testnets
      • Accounts
      • Authentication
      • Bitcoin Name System
      • SIPs
      • Technical Specifications
    • Block Production
      • Mining
      • Signing
      • Bitcoin Finality
      • Bitcoin Reorgs
      • Stacking
    • Transactions
      • How Transactions Work
      • Post Conditions
    • Clarity
      • Overview
      • Decidability
    • sBTC
      • Core Features
      • sBTC Operations
        • Deposit
        • Withdrawal
        • Deposit vs Withdrawal Times
      • Emily API
      • Peg Wallet UTXO
      • Clarity Contracts
        • sBTC Registry
        • sBTC Token
        • sBTC Deposit
        • sBTC Withdrawal
      • Auxiliary Features
        • Transaction Fee Sponsorship
        • Signer Wallet Rotation
      • Walkthroughs
        • Signer Process Walkthrough
        • sBTC Transaction Walkthrough
      • sBTC FAQ
    • Gaia
      • Configuration
      • Deploy Gaia Hub
      • Amazon EC2
      • Linux
      • Mac OS
  • 🛠️Guides & Tutorials
    • Developer Quickstart
    • Clarity Crash Course
    • Build a Borrowing & Lending Protocol
    • Bitcoin Integration
      • Sending Bitcoin with Leather Wallet
      • Verifying a Bitcoin Transaction
      • Parsing a Bitcoin Transaction
    • Create Tokens
      • Creating a NFT
      • Creating a Fungible Token
    • Build a Frontend
      • Post Conditions with Stacks.js
      • Authentication with Stacks.js
      • Sending Transactions with Stacks.js
    • Testing Smart Contracts
      • Fuzz Testing
    • Run a Node
      • Run a Node with Docker
      • Run a Node with Digital Ocean
      • Run a Node with a Hosted Provider
      • Run a Node with Quicknode
      • Run a Bitcoin Node
      • Run a Pruned Bitcoin Node
    • Run a Miner
      • Miner Prerequisites
      • Miner Costs and Fees
      • Mine Testnet Stacks Tokens
      • Mine Mainnet Stacks Tokens
      • Verify Miner
    • Run a Signer
      • Signer Quickstart
      • How to Read Signer Logs
      • How to Monitor a Signer
      • Best practices for running a Signer
      • OpSec Best Practices
    • sBTC
      • How to Run an sBTC Signer
      • Best practices for running an sBTC Signer
      • How to Use the sBTC Bridge
      • Earn sBTC Rewards
    • Stack STX
      • Solo Stack
      • Operate a Pool
      • Stack with a Pool
      • Increase Stacked Position
      • Stop Stacking
    • Oracles
    • Community Tutorials
  • 📚Reference
    • API
    • Clarity Types
    • Clarity Functions
    • Clarity Keywords
    • Stacks Node Configuration
    • Signer Configuration
    • Stacks Tooling
  • 🏗️Example Contracts
    • Audited Starter Contracts
    • Stacking
    • BNS
    • Multi Send
  • 🧡Press & Top Links
    • 🔶2024
      • 🔸January 2024
      • 🔸February 2024
      • 🔸March 2024
      • 🔸April 2024
      • 🔸May 2024
      • 🔸June 2024
      • 🔸July 2024
      • 🔸August 2024
      • 🔸September 2024
      • 🔸October 2024
      • 🔸November 2024
      • 🔸December 2024
    • 🔶2025
      • 🔸January 2025
      • 🔸February 2025
      • 🔸March 2025
  • 🧡Bitcoin Theses and Reports
    • 🟠Bitcoin Theses
    • 📙Bitcoin Reports
  • Contribute
Powered by GitBook
On this page
  • Video Walkthrough
  • Written Walkthrough
  • Reclaiming BTC

Was this helpful?

  1. Guides & Tutorials
  2. sBTC

How to Use the sBTC Bridge

PreviousBest practices for running an sBTC SignerNextEarn sBTC Rewards

Last updated 4 months ago

Was this helpful?

The sBTC bridge is a web application allowing you to convert your BTC into sBTC on the Stacks chain.

Ensure that you are using the bridge located at app.stacks.co. This is the only official sBTC bridge.

If you aren't familiar with sBTC, be sure to check out the to understand how it works.

The bridge has been designed to be as simple as possible to use. In order to utilize sBTC, all you need to do is send a Bitcoin transaction using a supported wallet (like or ).

Below you'll find both a video and written walkthrough of using the bridge.

Note that only deposits are currently available. Withdrawals will be released in , estimated in March 2025.

Video Walkthrough

Written Walkthrough

There are 5 simple steps to convert your BTC to sBTC.

1

Connect your wallet

First, you'll need to connect your wallet to the bridge UI. Currently Leather and Xverse are supported, with more on the way.

2

Choose the amount to deposit

After your wallet is connected, choose how much BTC you would like to convert to sBTC.

There are two transaction fees required to mint your sBTC. The first is set by the user manually when they initiate the deposit transaction within their wallet. The second is a fee used to consolidate the deposit UTXOs into the single signer UTXO. This separate transaction fee happens automatically and is set to a max of 80k sats. This is automatically deducted from your minted sBTC. This is not a signer fee but a regular Bitcoin transaction fee.

3

Choose the Stacks address to mint to

Next, enter the Stacks address you would like your sBTC minted to.

4

Initiate the transaction

After you choose your Stacks address, you'll use your connected wallet to transfer the BTC.

5

Receive your sBTC

In the UI, you can monitor the status of your transaction to see when it has been completed, at which point you can see the sBTC in your wallet. It will go through three stages:

  • Pending - Your Bitcoin transaction is processing

  • Minting - Your Bitcoin transaction has processed and the sBTC signers are minting your sBTC

  • Completed - Your sBTC has been minted to your wallet

The History tab is in progress and will make viewing previous transactions easier.

Note that you may need to enable the display of the sBTC token within your wallet by clicking on 'Manage Tokens' and enabling sBTC.

Reclaiming BTC

There is an intermediate step in between depositing BTC and the sBTC signers consolidating it into the single signer UTXO. If the transaction is not picked up by signers, you can reclaim it using this UI. Note there is a 'Lock Time' field on the Reclaim page. That indicates the amount of blocks that must have passed in order to reclaim your BTC.

This initiates a Bitcoin transaction that will transfer your BTC back to you.

If you accidentally leave the transaction page, you can view the status of your transaction by adding the txId, step, and amount query parameters to the bridge URL, eg.

If your sBTC mint fails, you can reclaim your sBTC. You can do this via the bridge by visiting the reclaim page at https://app.stacks.co/reclaim?depositTxId=[TX_ID_HERE] and replacing the bracketed text with your transaction ID, eg.

🛠️
https://app.stacks.co/?txId=1ca44721135c00a170cbec406733f25d9621e0598c011c78246c2fe173c4c9aa&step=3&amount=10000
https://app.stacks.co/reclaim?depositTxId=8f37f750b6646f0a217121201967170bd3cfef5f2ebd4f30f359b5e9308470c4
sBTC Conceptual Guide
Leather
Xverse
Phase 2