Liquid Integrations¶
Integrations Summary¶
The table below summarizes platforms and projects that have integrated Liquid. More integrations are currently in progress and the table will be updated as they go live.
Note
Here’s a summary of possible Liquid integration features.
Deposits: supports Liquid asset deposits to a custodial wallet. Depending on the implementation, L-BTC may be converted to BTC balances on arrival.
Withdrawals: supports Liquid asset withdrawals to third-party Liquid wallets.
Asset Exchange: supports the conversion of cryptocurrencies or fiat for Liquid assets. E.g. BTC for L-BTC.
Liquid Integration |
Type |
Deposits |
Withdrawals |
Asset Exchange Support |
Supported Assets |
|---|---|---|---|---|---|
Exchange |
✓ |
✓ |
✓ |
L-BTC, USDt |
|
Merchant processing |
x |
x |
x |
L-BTC, USDt, ETB |
|
Exchange |
✓ |
✓ |
✓ |
L-BTC, USDt |
|
Exchange |
✓ |
x |
x |
L-BTC |
|
Exchange |
✓ |
✓ |
x |
L-BTC |
|
Exchange |
x |
x |
✓ |
L-BTC |
|
Exchange |
✓ |
✓ |
x |
L-BTC |
|
Exchange |
✓ |
✓ |
✓ |
L-BTC, L-BCH, USDt |
|
Exchange |
✓ |
✓ |
✓ |
L-BTC |
|
Exchange |
x |
x |
✓ |
L-BTC |
|
Integration Guides¶
To help users get started with these integrations some unofficial guides are provided below. Note that these services are not necessarily approved by Blockstream or the Liquid Federation and users use them at their own risk. For the most up-to-date information on each integration, always refer the official websites for each platform.
Acquire L-BTC with Bitfinex¶
Step 1: Send bitcoins to the Bitfinex Exchange Wallet and wait for at least 3 confirmations.
Step 2: Go to the Wallets page Currency Conversions section and complete the relevant fields pictured below.
Step 3: Confirm that the conversion details are correct.
Step 4: Select Convert.
Step 5: See the updated L-BTC balance on the Wallets page.
Step 6: Go to the Withdraw page and select LiquidBTC.
Step 7: Open Blockstream Green wallet and generate an L-BTC receiving address using this guide.
Step 8: On the LiquidBTC withdrawal page, enter the receiving address along with the other required information and select Request Withdrawal.
Step 9: Complete Bitfinex’s withdrawal confirmation and wait for the Liquid wallet’s balance to update. Funds will be immediately available for spending.
Acquire L-BTC with Sideshift AI¶
Step 1: Open sideshift.ai, and confirm that both icons represent the assets to be converted.
Step 2: To select Liquid Bitcoin (L-BTC), click the right asset icon, and select Bitcoin (Liquid) from the Other category.
Step 3: Enter the receiving L-BTC address and click Shift.
Step 4: Send the appropriate amount to the provided QR code after confirm the address in the Will settle to: field.
Acquire L-BTC with Wyre¶
Step 1: Go to Wyre.
Step 2: Select L-BTC from the right asset menu.
Step 3: Enter the value for the amount of L-BTC to purchase. Confirm the values in the Wyre Fee and Network Fee fields.
Step 4: Enter a wallet address.
Step 5: Select a payment method from the Pay With menu.
Step 6: Agree to the account debiting authorization, and click Pay.
Step 7: Enter the necessary information for a debit card or Apple Pay payment on the following screen(s), and complete the payment.
Acquire L-BTC with Hodl Hodl¶
This section explains how to buy and sell Bitcoin (BTC) for L-BTC via Hodl Hodl
Step 1: Go to hodlhodl.com and select Buy BTC or Sell BTC in the top left corner.
Step 2: In the Filter offers window, go to Payment method and select Liquid Bitcoin as shown below.
Step 3: Click Apply filters, find an offer, and complete the order request.
Acquire USDt with Bitfinex¶
Step 1: Create or log into a Bitfinex account, and deposit or convert a deposited asset to USDt.
Step 2: Select Withdraw under the Wallet menu in the top, right corner of the screen.
Step 3: Select US Dollar under the Tether section of the New Withdrawal menu.
Step 4: Select USD(Tether) on Liquid under Transport.
Step 5: Enter the receiving address in the Address field.
Step 6: Enter the amount of USDt to withdraw via Liquid in the Amount field.
Step 7: Select Exchange Wallet from the Wallet menu.
Step 8: Check the appropriate fields and press Confirm Withdrawal
Acquire USDt with Sideshift AI¶
Step 1: Open sideshift.ai, and click the left asset icon. Choose the appropriate asset to convert from the list.
Step 2: Click the right asset icon, and select USDt (Liquid) from the Stablecoin category.
Step 3: Enter the receiving USDt address and click Shift.
Step 4: Confirm the address in the Will settle to: field, and send the appropriate asset and amount to the provided QR code.
Use L-BTC with BTCPay Server¶
Here’s a short guide to setting up BTCPay Server to accept Liquid asset payments at an online store. This guide assumes the user has already successfully deployed and configured BTCPay Server.
Note
Here’s a list of assets currently available for integration by BTCPay Server deployments. Enabling Liquid Bitcoin (L-BTC) implicitly enables other Liquid assets configured in BTCPay Server like Liquid Tether (USDt).
Step 1: To get started, follow these example instructions from BTCPay Server’s documentation to add an new asset. Replace the example asset ticker with LBTC.
Step 2: In BTCPay Server, go to General settings.
Step 3: Click on the Import from… menu and select …a new/existing seed.
Step 4: Enter the following information and select Segwit wrapped for address type.
Note
BTCPay Server supports Liquid blech32 segwit confidential addresses but Blockstream Green does not, which is why using Segwit wrapped p2sh addresses is recommended.
Step 5: Check the boxes for Is hot wallet and Import keys to RPC.
Step 6: Click Generate.
Step 7: Save and securely store the generated seed key after generating. Then click Confirm
Note
Liquid’s Confidential Transactions (CTs) are enabled by default when adding L-BTC to BTCPay Server. CTs blind (or hide) the asset type and amount in a transaction. To skip CT configuration, add -[unblinded] to the xpub generated in Step 6.
Example: xpub6DHf9nVQP6mc5FgKD4E3UuxPubv7Gf19BUMemRR73o5BRiTsgexiDmMsVv3DDeH251UdJFkUYAkneiwg5RKHn8wa3Azpkx2eVHmFLY3ErmF-[p2sh]-[unblinded]
Skipping CT configuration will prevent blinding transaction amounts and asset types.