You can always recover your funds even if you lose access to your hub.
In Alby Hub can seamlessly transfer bitcoin between your wallet balance (lightning) and on-chain balance through so called swaps.
If a swap is in progress, please keep your Hub online to ensure the swap completes successfully. If you restart your Hub, pending swaps will be resumed.
Lightning to on-chain swaps are atomic. Make sure to read our backup guide to ensure you can always recover funds from your Hub.
Swapping in requires you to send on-chain bitcoin from your wallet to an on-chain address. These funds will be claimed by Boltz if the swap succeeds. In case the swap fails (for example, Boltz cannot reach your Hub to make the payment, or you do not have enough receiving capacity in your channels, or you accidentally send the wrong amount), you must be able to recover the funds that you have sent to the on-chain address.
As long as you leave your Hub online, Alby Hub will automatically recover funds from failed swaps into your Hub's on-chain balance.
If the swap does still not succeed 24 hours after you initiated the swap, you can go to Settings -> Debug Tools in your Hub and press the List Swaps button. Find the swap ID of the failed swap, and then click the Refund Swap button on the same page. You'll see a field to paste the swap ID and click confirm to request the refund.
In case you lose access to your Hub (e.g. you self-host and your hard-drive dies) or if the Refund Swap button does not work, you can still recover funds from failed swaps as long as you have backed up your recovery phrase.
In the following section you will need to enter your recovery phrase in an application to derive your Boltz mnemonic. DO NOT enter your recovery phrase in any website or application that you do not trust. If you have any concerns, please contact Alby Support.
If you still have access to Alby Hub, you can go to Settings -> Debug Tools and press the Swap Mnemonic button to reveal your Boltz Mnemonic.
Alby Hub uses a dedicated mnemonic derived from your main recovery phrase for Boltz swaps (see BIP-85). To derive this mnemonic you can import your Hub's recovery phrase into any wallet that supports BIP-85. Some hardware wallets support BIP-85 child mnemonic derivation. Ian Coleman's BIP39 tool (Standalone offline version recommended) also supports deriving BIP-85 child mnemonics - search for "Show BIP85" and check the checkbox.
Use the following derivation index: 128260
Visit the Boltz Refund Page. Enter your Boltz Mnemonic. DO NOT enter your boltz mnemonic in any website other than the official boltz.exchange website. Your Boltz mnemonic will not be sent to Boltz - it will only be used client-side by the Boltz Web App.
The swaps that can be rescued will show up in a list. When you click on one you will be able to provide a refund address from your on-chain bitcoin wallet.
Last updated
Was this helpful?
Was this helpful?
