Hemi
DiscordGithub
  • 🏠Main
    • Welcome to the Hemi Docs
    • Getting Started
      • Developer Quickstart
      • Enthusiast Quickstart
      • Miner Quickstart
    • Network Details
  • ⛰️Foundational Topics
    • The Architecture
      • Consensus and Security Protocols
      • Ethereum Rollups
        • Pros & Cons
        • Decentralized Rollups
      • Sequencer Consensus
        • Proof-of-Stake (PoS)
        • PoS-Only Pitfalls
        • PoS Solutions
      • Proof-of-Proof (PoP)
        • Proof-of-Proof Consensus & Bitcoin Finality
        • Proof-of-Proof vs. Merged Mining
        • Running a PoP Mining
      • Tunnels
        • Ethereum Tunnel
        • Bitcoin Tunnel
      • Ethereum Virtual Machine (EVM)
      • Blocks
      • Transactions
      • Gas
    • Nodes & Clients
      • Node Guides
    • Wallet Support
  • 📖How-To Tutorials
    • Using Hemi
      • Wallet Setup
        • EVM Wallet Setup
        • BTC Wallet Setup
          • Switch Bitcoin Networks
      • Tunnel from Ethereum
        • Tunnel ERC20s via Native Tunnel
        • Tunnel ERC20s via 3rd Party
          • Tunnel via Stargate
      • Tunnel from Bitcoin
        • Tunnel BTC via Native Tunnel
        • Tunnel BTC via 3rd Party
      • Stake
      • Developer Tooling
        • Set Up a Safe Wallet
        • Create a Capsule
      • PoP Mining
        • CLI PoP Miner
          • (Testnet) Add tHEMI to MetaMask
          • (Mainnet) Add PoPPoints to Metamask
        • Web PoP Miner (deprecated)
    • Developing on Hemi
      • General
        • HelloWorld.sol
        • Deploy an ERC-20 Token
      • hVM & hBK
        • Using the hBK Demo App
        • Get Bitcoin Balance with Remix
  • ⚙️Building Bitcoin Apps
    • Introduction
    • Hemi Virtual Machine (hVM)
      • Motivation
      • Feature Summary
      • Deploy on hVM
    • Hemi Bitcoin Kit (hBK)
      • Overview
      • hBK Smart Contract
  • ⚙️Tooling
    • viem
    • Contract Addresses
    • Contract Verification
    • Data Indexing
    • Oracles
  • 📝Incentives
    • Points
    • Grants
    • Retroactive Funding
    • One-Off Spends
  • ⚡Additional Resources
    • Partners
    • FAQ
    • Official Links
    • Brand Kit
  • 📨Send Feedback
    • Bug Report
    • Contact Us
Powered by GitBook
On this page
  • 🏁 Prerequisites
  • 📚 Tutorial
  • 1. Visit the Hemi Portal
  • 2. Connect wallet
  • 3. Connect your EVM wallet
  • 4. Connect your BTC wallet
  • 5. Select 'Bitcoin' as the 'From Network'
  • 6. Enter the amount of BTC to tunnel
  • 7. Confirm the deposit in UniSat
  • 8. You have successfully tunneled BTC to Hemi! 🎉

Was this helpful?

Edit on GitHub
Export as PDF
  1. How-To Tutorials
  2. Using Hemi
  3. Tunnel from Bitcoin

Tunnel BTC via Native Tunnel

PreviousTunnel from BitcoinNextTunnel BTC via 3rd Party

Last updated 2 months ago

Was this helpful?

📜 TL;DR:

  • Move your BTC to Hemi by using the Bitcoin Tunnel, enabling interactions within the Hemi Network ecosystem with Bitcoin assets.

  • An and wallet are required to move BTC assets via the Bitcoin Tunnel.

  • A minimum of 0.0001 BTC is required to deposit and withdrawal using the Native Tunnel.


🏁 Prerequisites

  • Acquire BTC - BTC can be purchased on any number of exchanges and on-ramps.

  • - Set up your EVM wallet and add Hemi Network.

  • - Set up your BTC wallet.

TESTNET ONLY If you plan on developing on or interacting with Hemi testnet, alternative prerequisites may apply. To test out the Bitcoin Tunnel on testnet, you can obtain tBTC (Testnet Bitcoin) via the .


📚 Tutorial

1. Visit the Hemi Portal

Go to to access the Hemi Portal.

Select your network of choice using the network dropdown located at the bottom left.


2. Connect wallet

Click 'Connect Wallets' in the top-right corner of the Hemi Portal.


3. Connect your EVM wallet

Currently, MetaMask and Rabby are the only EVM wallets Hemi supports. Our team is working to add support for additional wallets.

Connecting an EVM wallet is required for the initial version of the Bitcoin Tunnel. The address connected will receive the tunneled Bitcoin assets.


4. Connect your BTC wallet


5. Select 'Bitcoin' as the 'From Network'

Ensure that you are connected to the Bitcoin network.

Tunneled BTC will be sent to the EVM address connected (denoted by the 'Receiving Hemi Address' at the bottom of the screen). In future versions, you will be able to manually input the preferred receiving address.


6. Enter the amount of BTC to tunnel

Input the amount of BTC you wish to tunnel to Hemi. There is a minimum amount of 0.0001 BTC to deposit and withdrawal.

After you have confirmed the gas fee and wish to proceed with the deposit, click 'Deposit.'


7. Confirm the deposit in UniSat

Confirm your BTC deposit in the UniSat browser extension.


8. You have successfully tunneled BTC to Hemi! 🎉

Your transaction has been initiated and must go through two confirmation periods to confirm your deposit:

  1. Withdrawal from BTC address (~1hr) - When you initiate a deposit request, a transaction is signed from your BTC address to transfer the specified amount into a secure vault on the Bitcoin network. This deposit requires six block confirmations, which generally takes about one hour to complete.

  2. Deposit into EVM Hemi address - Once the deposit is fully confirmed on the Bitcoin network, the Hemi Network validates the transaction and mints a corresponding token receipt (hemiBTC) on the Hemi blockchain, ensuring a seamless transition of assets.

You can check the status and view the transaction in the 'Transaction History' tab.

hemiBTC can be tracked and added to your wallet at the following contract address: 0xAA40c0c7644e0b2B224509571e10ad20d9C4ef28

Manual confirmation of deposit

After six confirmations, Hemi can confirm a successful deposit from the Bitcoin network and deposit the funds to your address. Occasionally, the vault operator will require a manual confirmation in order to complete the deposit.

Connect your BTC wallet (currently only UniSat supported). If you do not have a UniSat wallet, you can view our to create and set one up.

📖
EVM
BTC
EVM (MetaMask) Wallet Setup
BTC Wallet Setup
Direct Faucet Access
https://app.hemi.xyz/en/tunnel/
tutorial