BTC.b to LBTC and LBTC to BTC.b Swaps

This guide covers how to convert between BTC.b and LBTC by interacting directly with Lombard's smart contracts through block explorers.

All amounts are denominated in satoshis (1 BTC = 100,000,000 satoshis).


How to Swap BTC.b for LBTC

Step 1: Initiate Deposit on the Asset Router

Open the Asset Router contract in explorer:

https://etherscan.io/address/0x9eCe5fB1aB62d9075c4ec814b321e24D8EA021ac#writeProxyContractarrow-up-right

Open the Contract tab and select Write as Proxy.

Click on Connect to Web3 to connect to the wallet. Make sure that connection established is with the correct address (the one you have BTC.b on).

Navigate to the function 18. deposit (0x8340f549)arrow-up-right and enter:

The amount should be in satoshis.

Click on the Write button, check transaction details in your wallet app and accept if everything is correct. After transaction submission it would take some time for Lombard (depending on the blockchain) to notarize it and produce data for further minting.

Step 2: Get Authorization Signatures to Mint LBTC

In order to get proof and payload for your transaction from Step 1, navigate to:

with your address. e.g.

Example API response:

The raw_payload and proof fields in a real response are much longer. Copy them in full.

Use payload and proof for Step 3.

Note: Payload and proof is available only after Lombard notarized your transaction (JSON above should have "notarization_status": "NOTARIZATION_STATUS_SESSION_APPROVED").

Step 3: Mint LBTC

Open the LBTC contract in explorer:

https://etherscan.io/address/0x8236a87084f8B84306f72007F36F2618A5634494#writeProxyContractarrow-up-right

Open the Contract tab and select Write as Proxy.

Click on Connect to Web3 to connect to the wallet. Make sure that connection established is with the correct address (the one you have LBTC on).

Navigate to the function 21. mint (0x6bc63893). Copy and paste payload and proof collected at previous step.

Click on the Write button, check transaction details in your wallet app and accept if everything is correct.

Corresponding amount of LBTC will be minted on the address that initially had deposited BTC.b as soon as the transaction gets mined and added to the blockchain.


How to Redeem LBTC for BTC.b

Step 1: Initiate Redeem on the LBTC Contract

Open the LBTC contract in explorer:

https://katanascan.com/address/0xecAc9C5F704e954931349Da37F60E39f515c11c1#writeProxyContractarrow-up-right

Open the Contract tab and select Write as Proxy.

Click on Connect to Web3 to connect to the wallet. Make sure that connection established is with the correct address (the one you have LBTC on).

Navigate to the function 25. redeem (0xdb006a75) and enter amount of LBTC you want to redeem (convert to BTC.b).

The amount should be in satoshis.

Click on the Write button, check transaction details in your wallet app and accept if everything is correct.

Step 2: Get Authorization Signatures to Mint BTC.b

LBTC must be unstaked from Bitcoin Secured Networks before BTC.b is available. This process takes up to 8 days to complete (availability based on working capital). After this period of time, Lombard's Security Consortium notarizes the request and issues a payload and proof on Lombard Ledger (Lombard's appchain).

In order to get proof and payload for your transaction from Step 1, navigate to:

with your address. e.g.

Example API response:

The payload and proof fields in a real response are much longer. Copy them in full.

Use payload and proof for Step 3.

Note: Payload and proof is available only after Lombard notarized your transaction (JSON above should have "notarization_status": "NOTARIZATION_STATUS_SESSION_APPROVED").

Step 3: Mint BTC.b

Open the BTC.b contract in explorer:

https://katanascan.com/address/0xb0f70c0bd6fd87dbeb7c10dc692a2a6106817072#writeProxyContractarrow-up-right

Open the Contract tab and select Write as Proxy.

Click on Connect to Web3 to connect to the wallet. Make sure that connection established is with the correct address (the one you have LBTC on).

Navigate to the function 21. mintV1 (0x8307f738). Copy and paste payload and proof collected at previous step.

Click on the Write button, check transaction details in your wallet app and accept if everything is correct.

Corresponding amount of BTC.b will be minted on the address that initially had redeemed LBTCs as soon as the transaction gets mined and added to the blockchain.

Last updated