unchained-capital / caravan

Bitcoin multisig coordination software
https://unchained-capital.github.io/caravan/
MIT License
203 stars 177 forks source link

Private node documentation recommendation - Caravan requires a non-descriptor legacy wallet open in Bitcoin Core for address import #367

Open bitcoinlizard opened 9 months ago

bitcoinlizard commented 9 months ago

I believe some additional documentation should be included for the Private Node section of the README. Caravan requires that a legacy non-descriptor wallet be loaded in Bitcoin Core to successfully import addresses. If you try to run the "importmulti" method with Bitcoin Core running with a descriptor wallet open Bitcoin Core will respond with "Only legacy wallets are supported by this command" and the import will fail. Everything works correctly if Bitcoin Core is running with a legacy wallet.

This will become more relevant over time as descriptor wallets have been the default since Bitcoin Core version 23.0 which was released in April of 2022.

The Bitcoin Core steps to be able to import Caravan addresses on a new Bitcoin Core install would be as follows:

1) Create a legacy wallet (command below) 2) Ensure that with Bitcoin Core running the legacy wallet is open 3) The Caravan address import will be successful. Bitcoin Core can be instructed to rescan from the Caravan interface

If anyone happens to see this issue and is having problems you can create a legacy wallet in Bitcoin Core version 26.0 with this command:

bitcoin-cli -named createwallet wallet_name="YOUR WALLET NAME" descriptors=false