H
Bridge
alpha
The Fiamma Bridge is a revolutionary new solution for cross-chain BTC asset transfer.
In this tutorial, you will learn how to interact with the Fiamma Bridge, the first trust-minimized Bitcoin Bridge powered by BitVM2.
In this tutorial, you will learn how to interact with the Fiamma Bridge, the first trust-minimized Bitcoin Bridge powered by BitVM2.
Section1
Preparation
To begin, you'll need wallets that support EVM-compatible and BTC addresses, along with the corresponding test tokens on the testnet.
Step1
In this tutorial, we will use MetaMask (holesky) and Unisat (signet) as examples.
Step2
If your metamask does not have holesky network, please go to chainlist , enter holesky in the input box and check include Testnets.
Step3
Then add Holesky to wallet in search results.
Step4
Click the button in the upper right corner of the main page to switch the network to Bitcoin Signet.
Step5
If you are using okx wallet, you can click the square button in the upper right corner of the main interface and enter signet in the input box of the new page.
BTC Signet is only available for OKX extension version 2.82.32 or above.
Section2
Register
Before starting interactions, we also need to register an account to record our operations and Fluff Energy (activity points).
Step1
Go to Register page. Connect EVM then sign in the pop-up wallet window, then connect to X.
If you fail to connect to x, please confirm the wallet signature, not just connect the wallet. If this is the case, disconnect the wallet first then sign, finally connect X.
Step2
When you see this tutorial, there is a high probability that there is no seed code anymore. So click 'Already have referral Code? Enter here' and enter referral code wSf4Ev / ESML5X 😆
Step3
Here is the account panel, which records your Fluff Energy and daily completion status. Currently you can earn Fluff Energy by inviting others and completing Peg-In and Peg-Out.
Section3
PEG-IN
In this section, you will convert sBTC(Signet) to mamaBTC(Holesky).(mamaBTC is tokenized BTC minted via Fiamma Bridge, it's always backed 1:1 by sBTC on Signet, ensuring that mamaBTC:sBTC = 1:1)
Step1
Go to Bridge Page. Connect Bitcoin Wallet (using Unisat as an example here)
Please note that we only support Native Segwit and Taproot address types in alpha-testnet.
Step2
Clicking on the input box will automatically pop up the evm address bound to the current account. Of course you can also enter other recipient's address, ensuring it is an ERC20-compatible address from the Holesky network.
Step3
Enter amount within 0.0001 ~ 0.001 sBTC (Due to current liquidity constraints in our operator, we have implemented a temporary limit on amounts. We anticipate increasing these limits.)
If your available amount does not match your wallet's, please check if there are any unconfirmed transactions. If the available keeps showing as 0, please try to upgrade your wallet.
Step4
Check the terms and if everything goes well you can click the 'Deposit' button.
Step5
Click deposit in the dialog then sign PEG-IN (Deposit) Transaction and pre-sign Take Transactions in the pop-up wallet window.
If there is no response when clicking deposit or a Sign Error is prompted, please go to Fiamma-Discord to report the situation.
Step6
Well! PEG-IN has been submitted, The rest will be left to FiammaBridge. Your sBTC is transferred to a multi-sig address joinly managed by the user and the Bridge Covenant Committee (BCC). The relayer node synchronizes Bitcoin block information with the Bitcoin light client on the sidechain. The minter node obtains the PEG-IN Merkle proof and invokes the mint function. At last you will receive the 1:1 sBTC amount of mamaBTC on the Holesky.
The completion time mainly depends on the signet block confirmation speed
Section4
PEG-OUT
In this section, you will convert mamaBTC(Holesky) into equivalent sBTC(Signet)
Step1
Connect EVM-compatible wallet (using MetaMask as an example here)
Step2
Fill out the recipient address on Bitcoin. If you have already connected to the btc wallet, you can choose autocomplete.
Step3
There are two input modes: express and custom. Turn on Custom mode, then enter PEG-OUT Amount.
Step4
Check the terms and if everything goes well you can click the 'Withdraw' button.
Step5
Click withdraw in the dialog then confirm Withdraw and Sign Burn Transaction in the pop-up wallet window.
!!! Please make sure your wallet is on holesky before confirming, otherwise the gas of the current chain will be deducted.
Step6
The operator will validate the burn and pre-pay the equivalent sBTC to the you.
🎉 Congratulations on completing this tutorial