Skip to content

Latest commit

 

History

History
66 lines (53 loc) · 5.9 KB

Jam Wallet Recovery Umbrel.md

File metadata and controls

66 lines (53 loc) · 5.9 KB

How to Recover Your Umbrel Jam Wallet

This guide will show you how to recover your Jam wallet that you somehow have lost on your Umbrel server. You will be guided through different recovery scenarios, depending on what has happened (e. g. hard drive failure) - or more precisely - what you have at hand (e. g. seed phrase).

⚠️ Jam and Umbrel are beta software, they can fail at any time. Your hardware can also fail at any time.
Write down your seed phrase(s) and wallet password right after installation so you don't have to worry about losing funds! ⚠️

Prerequisites

It is crucial to know that Umbrel and Jam don't share the same wallet. What you do with and have in your Umbrel wallet is completely apart from your Jam wallet. Jam is only using Umbrels Bitcoin Node app, creates and uses its own wallet with its own funds. As said above, it is therefore a must to not only write down your Umbrel seed phrase right after you have installed your Umbrel server, you also need to write down your Jam seed phrase right after installing the Jam plugin on your Umbrel. If you have done that, no need to worry. Please note that this guide is written for Umbrel 0.5 and above. Let's go!

Recovery with both Seeds

This is the best case scenario. You have both - your Umbrel and your Jam seed phrase - at hand. To recover your Umbrel Bitcoin funds, you will need to do the following:

  1. Install Umbrel
  2. Install Bitcoin Node from the Umbrel App Store and wait until it is 100% synched
  3. Install Lightning Node from the App Store, let it fully synch
  4. Open the Lightning Node app and recover your Umbrel funds with your Umbrel seed phrase

OK, cool. You should have recovered your old Umbrel server and wallet successfully. You should be able to see and access your funds again. If not, checkout the Umbrel Community where you can find more detailed instructions and support. Let's see how you can recover your Jam wallet now:

  1. Install Jam from the Umbrel App Store
  2. Connect to your Umbrel via SSH
  3. Go into the Jam Docker container
  4. Use the wallet-tool.py script with your Jam seed phrase

So here is an essential version of what you will need to type and see in your terminal (replace "zoo..." with your personal Jam seed phrase):

user@device  % ssh [email protected]
[email protected]'s password: 
umbrel@umbrel:~/ $ docker exec -it jam_web_1 bash
root@33025215bd28:/src/scripts# cd ..
root@33025215bd28:/src# python3 scripts/wallet-tool.py recover --gap-limit=200 --recoversync
User data location: /root/.joinmarket/
Input mnemonic recovery phrase: zoo zoo zoo zoo zoo zoo zoo zoo zoo zoo zoo wrong
Input mnemonic extension, leave blank if there isnt one: 
Enter new passphrase to encrypt wallet: 
Reenter new passphrase to encrypt wallet: 
Input wallet file name (default: wallet.jmdat): recover.jmdat
Would you like this wallet to support fidelity bonds? write 'n' if you don't know what this is (y/n): y
Write down this wallet recovery mnemonic

zoo zoo zoo zoo zoo zoo zoo zoo zoo zoo zoo wrong

Recovered wallet OK

Now - when opening your Jam app on Umbrel in your browser - you should see your recovered wallet and be able to open and use it. If you don't see your wallet at all, you probably forgot adding the .jmdat while naming the recovered wallet. If you don't see transactions and funds, you might have to adjust the --gap-limit parameter with the recovery tool. Or you need to do a...

Rescan Blockchain with Umbrels Bitcoin Node App

You probably need to rescan the blockchain on your Umbrel if you had to reinstall or resynch the Bitcoin Node before recovering your Jam wallet. This can be done with the bitcoin-cli on your Umbrel but can take a long time if you rescan the whole blockchain. If you know roughly when you created (and lost) your old Jam wallet that you want to recover, you can pass an optional start/end block height to avoid needlessly rescanning the whole blockchain. This is how you do a rescan on Umbrel:

  1. Connect to your Umbrel via SSH
  2. Find the specific block height(s) by time
  3. Use the bitcoin-cli to start the rescan

So here is an essential version of what you will need to type and see in your terminal. Note that you can also skip the stop_height parameter in order to scan from a specific block height to now:

user@device  % ssh [email protected]
[email protected]'s password: 
umbrel@umbrel:~ $ ./umbrel/scripts/app compose bitcoin exec bitcoind bitcoin-cli rescanblockchain 510110 510114
{
  "start_height": 510110,
  "stop_height": 510114
}

Recovery with Jam Seed, without Umbrel Seed

As explained above, the Umbrel wallet and Jam wallet are independent from each other. If you somehow have lost your Umbrel seed phrase, you might not be able to rescue funds from your lost Umbrel wallet - but your Jam wallet funds are safe as long as you only have your Jam seed phrase at hand. If you want to keep using Jam with Umbrel, you basically have to to the same as described above. The only difference will be that you will get a new and empty Umbrel wallet with a new seed phrase (write that down immediately!). You could also recover your Jam wallet without Umbrel by installing Jam in another environment and use the wallet-tool.py script there.

Recovery without Seed(s)