Add a document on how to recover a Liana wallet using Bitcoin Core 25.0

[darosior]

No description provided.

[pythcoiner]

just tried that today:

bitcoin-cli createwallet liana_restore

'[{"desc": "wsh(andor(pk([a5c6xxxx/48'/0'/0'/2']xpub6E3yjBcNhpWPoUxxxxxxxxxxxrwNV5is7cpypaYVkmnxTbrx1GMrYjN7p9F7Hr184UjgXFCSzitZ6q9UtXdTfnZv8UaS1VTvidYGdCkoq7k/<0;1>/*),older(65535),or_d(pk([a5c6xxxx/84'/0'/0']xpub6DUuCx6R9qdwWeTgYQbwtHFC6HT3QdxKVm3rxxxxxxxxxxxxxxxxxxxxxxxxxGpUjhEWJWUx9EkkvMeXTTpkwmFAzjLfgHssFFzsohnV8Sh4To/<0;1>/*),and_v(v:pk([1801xxxx/84'/0'/0']xpub6D7RmbwBaHXkSjxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxecADgycn4ayon3vkcbEMfMw23Q3E8KJao2H8wfngQe8Nf44m6eyHnvpD1qR/<0;1>/*),older(4400)))))#dn2236k4", "range": [0,10000], "timestamp": 1682920310}]'

then i got this response:

[
  {
    "success": false,
    "error": {
      "code": -5,
      "message": "A function is needed within P2WSH"
    }
  }
]

[darosior]

It's because Bitcoin Core doesn't yet support "multipath" key expressions (bitcoin/bitcoin#22838). You'll be able to import the descriptor if you split it between receive and change:

wsh(andor(pk([a5c6xxxx/48'/0'/0'/2']xpub6E3yjBcNhpWPoUxxxxxxxxxxxrwNV5is7cpypaYVkmnxTbrx1GMrYjN7p9F7Hr184UjgXFCSzitZ6q9UtXdTfnZv8UaS1VTvidYGdCkoq7k/0/*),older(65535),or_d(pk([a5c6xxxx/84'/0'/0']xpub6DUuCx6R9qdwWeTgYQbwtHFC6HT3QdxKVm3rxxxxxxxxxxxxxxxxxxxxxxxxxGpUjhEWJWUx9EkkvMeXTTpkwmFAzjLfgHssFFzsohnV8Sh4To/0/*),and_v(v:pk([1801xxxx/84'/0'/0']xpub6D7RmbwBaHXkSjxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxecADgycn4ayon3vkcbEMfMw23Q3E8KJao2H8wfngQe8Nf44m6eyHnvpD1qR/0/*),older(4400)))))
wsh(andor(pk([a5c6xxxx/48'/0'/0'/2']xpub6E3yjBcNhpWPoUxxxxxxxxxxxrwNV5is7cpypaYVkmnxTbrx1GMrYjN7p9F7Hr184UjgXFCSzitZ6q9UtXdTfnZv8UaS1VTvidYGdCkoq7k/1/*),older(65535),or_d(pk([a5c6xxxx/84'/0'/0']xpub6DUuCx6R9qdwWeTgYQbwtHFC6HT3QdxKVm3rxxxxxxxxxxxxxxxxxxxxxxxxxGpUjhEWJWUx9EkkvMeXTTpkwmFAzjLfgHssFFzsohnV8Sh4To/1/*),and_v(v:pk([1801xxxx/84'/0'/0']xpub6D7RmbwBaHXkSjxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxecADgycn4ayon3vkcbEMfMw23Q3E8KJao2H8wfngQe8Nf44m6eyHnvpD1qR/1/*),older(4400)))))

[pythcoiner]

receive and changes are /0/* and /1/* at end of xpub?

[darosior]

Yes. ------- Original Message -------

…

On Sunday, May 14th, 2023 at 2:13 PM, pythcoiner ***@***.***> wrote: receive and changes are /0/* and /1/* at end of xpub? — Reply to this email directly, [view it on GitHub](#375 (comment)), or [unsubscribe](https://github.com/notifications/unsubscribe-auth/AFLK3F4QM3SBP6ZMUCX5IXLXGDD55ANCNFSM6AAAAAAWGP3IPI). You are receiving this because you were assigned.Message ID: ***@***.***>

[pythcoiner]

it will alway be 0 & 1? maybe a python script can be useful for user who want recover in core?

[pythcoiner]

Here the steps to recover on Bitcoin core (signet) from descriptor wsh(or_d(pk([40259ab7/48'/1'/0'/2']tpubDFcY6nTiMAWBd5d2bS8JZvjcaLjC6GE6XnPAJAPUkVj5wa5Pyb4gumx1ZWvnXQ8tmorCmpAyai69K9hD2mGQUeNkuXfjztsfqnE5FMk1CCh/<0;1>/*),and_v(v:pkh([842a626e/48'/1'/0'/2']tpubDENBboujRvpkS8SgZsrpqG2BCUBoaAc4c57jHFe1NwKAtfVjDZDUadQKYv4pkAEF2afPv6TtQ2BoYFJAPLbuKpL1usiySERZekGo4JmnWhh/<0;1>/*),older(65535))))#deguz53x:

Create wallet:

bitcoin-cli -signet createwallet 'liana_recovery' true

output:

{
  "name": "liana_recovery"
}

Import descriptor:

bitcoin-cli -signet -rpcwallet=liana_recovery importdescriptors '[{"desc": "wsh(or_d(pk([40259ab7/48'/1'/0'/2']tpubDFcY6nTiMAWBd5d2bS8JZvjcaLjC6GE6XnPAJAPUkVj5wa5Pyb4gumx1ZWvnXQ8tmorCmpAyai69K9hD2mGQUeNkuXfjztsfqnE5FMk1CCh/0/*),and_v(v:pkh([842a626e/48'/1'/0'/2']tpubDENBboujRvpkS8SgZsrpqG2BCUBoaAc4c57jHFe1NwKAtfVjDZDUadQKYv4pkAEF2afPv6TtQ2BoYFJAPLbuKpL1usiySERZekGo4JmnWhh/0/*),older(65535))))#7g3cds5h", "range": [0,10000], "timestamp": 1682920310}, {"desc": "wsh(or_d(pk([40259ab7/48'/1'/0'/2']tpubDFcY6nTiMAWBd5d2bS8JZvjcaLjC6GE6XnPAJAPUkVj5wa5Pyb4gumx1ZWvnXQ8tmorCmpAyai69K9hD2mGQUeNkuXfjztsfqnE5FMk1CCh/1/*),and_v(v:pkh([842a626e/48'/1'/0'/2']tpubDENBboujRvpkS8SgZsrpqG2BCUBoaAc4c57jHFe1NwKAtfVjDZDUadQKYv4pkAEF2afPv6TtQ2BoYFJAPLbuKpL1usiySERZekGo4JmnWhh/1/*),older(65535))))#njcmmphw", "range": [0,10000], "timestamp": 1682920310}]'

(here original descriptor might to be split in 2 descriptor (receive + change), and each checksum re-processed)

output:

[
  {
    "success": true
  },
  {
    "success": true
  }
]

Check wallet infos:

bitcoin-cli -signet -rpcwallet=liana_recovery getwalletinfo

output:

{
  "walletname": "liana_recovery",
  "walletversion": 169900,
  "format": "sqlite",
  "balance": 0.01575593,
  "unconfirmed_balance": 0.00000000,
  "immature_balance": 0.00000000,
  "txcount": 5,
  "keypoolsize": 0,
  "keypoolsize_hd_internal": 0,
  "paytxfee": 0.00000000,
  "private_keys_enabled": false,
  "avoid_reuse": false,
  "scanning": false,
  "descriptors": true,
  "external_signer": false
}

Create spending tx:

bitcoin-cli -signet -rpcwallet=liana_recovery sendall '["tb1qed7lyessqcecav5uxultf6zc8nefd9kalgaa7dwrglcc6ld5vd3qe20spe"]' null "unset" 20

output:

{
  "psbt": "cHNidP8BALACAAAAA8Ms485HnnpglFFToTOMhyoFspUwcydbtr7Oe0cju/HYAAAAAAD9////MEK+0DRfAs+nLoFgsOeHD3sAq00x+mldkOOxvwUeHw0AAAAAAP3///+2JGYCXJ9JwW7XppZFW6oXGXP4GXC+jacj8v3U1VZv8gEAAAAA/f///wGN9BcAAAAAACIAIMt98mYQBjOOspw3PrToWDzylpbd+jvfNcNH8Y19tGNiAAAAAAABAH0CAAAAAbuuo6PMGF0d9d+07OxD8H64e23mJ1Tq3tSmTvTpie2sAAAAAAD+////AkBCDwAAAAAAIgAgy33yZhAGM46ynDc+tOhYPPKWlt36O981w0fxjX20Y2I61w1BSwYAABYAFKFdJuaJFK5HoS2etlvok4dTxqs+8TkCAAEBK0BCDwAAAAAAIgAgy33yZhAGM46ynDc+tOhYPPKWlt36O981w0fxjX20Y2IBBUQhApVoqmBo/jMxzCCpvdcbwdhJDthL0+GB7WGHQ6DELIEQrHNkdqkULwYnq2qWrWGTkA0Y/IsE+NjzFHaIrQP//wCyaCIGApVoqmBo/jMxzCCpvdcbwdhJDthL0+GB7WGHQ6DELIEQHEAlmrcwAAAAAQAAAAAAAAACAAAAAAAAAAEAAAAiBgMQKlFFwRGRkmA1hC/gCOASBlnO1OtElVfVmX5GzyxZBByEKmJuMAAAAAEAAAAAAAAAAgAAAAAAAAABAAAAAAEAXgIAAAABXj9sRzsv3z0XhBJamOjA87kXRRaN8jx3IphAvC9l01MBAAAAAP3///8BlTUBAAAAAAAiACA2QMbRg1YGiC2ExTZBPRPY3n53oOokWa+WUur6MzAvdAAAAAABASuVNQEAAAAAACIAIDZAxtGDVgaILYTFNkE9E9jefneg6iRZr5ZS6vozMC90AQVEIQKipAwQ5vWYhWWdOXhn2E2XoL2ceHjWJF2lkmRIsQ0a16xzZHapFDYLYnHZGjfVubU6TdQlLr9zB9yuiK0D//8AsmgiBgJKODPae5V0IQ6hJsO47vyQOQiTntq+P/exsBrEdSTvvhyEKmJuMAAAAAEAAAAAAAAAAgAAAAEAAAAAAAAAIgYCoqQMEOb1mIVlnTl4Z9hNl6C9nHh41iRdpZJkSLENGtccQCWatzAAAAABAAAAAAAAAAIAAAABAAAAAAAAAAABAIkCAAAAAQihHZ2Q7yT7P4RJjdktxHyQ10ivoWoWCTM6cGNTFCCbAAAAAAD9////AiChBwAAAAAAIgAgY3cybmT4gTn6KggInDcQAsFr77Nhmc0iwAclvt5HvHnUkgcAAAAAACIAIIVfqoy+QF3kHoOIm84f5DsxyDiMHQab75d6ftQfbUSOAAAAAAEBK9SSBwAAAAAAIgAghV+qjL5AXeQeg4ibzh/kOzHIOIwdBpvvl3p+1B9tRI4BBUQhAv97HqEGboRAJX9A8VX9sArwGT12eqKA43JqG1asXFyzrHNkdqkUL7kkRIbko8v2Xo0f/5qXFOSzdIyIrQP//wCyaCIGAv97HqEGboRAJX9A8VX9sArwGT12eqKA43JqG1asXFyzHEAlmrcwAAAAAQAAAAAAAAACAAAAAQAAAAUAAAAiBgOkjN3jkLc4LnoC6atMq+lDjCV4sKk/cxOcI+7FmPA8tByEKmJuMAAAAAEAAAAAAAAAAgAAAAEAAAAFAAAAAAEBRCEClWiqYGj+MzHMIKm91xvB2EkO2EvT4YHtYYdDoMQsgRCsc2R2qRQvBierapatYZOQDRj8iwT42PMUdoitA///ALJoIgIClWiqYGj+MzHMIKm91xvB2EkO2EvT4YHtYYdDoMQsgRAcQCWatzAAAAABAAAAAAAAAAIAAAAAAAAAAQAAACICAxAqUUXBEZGSYDWEL+AI4BIGWc7U60SVV9WZfkbPLFkEHIQqYm4wAAAAAQAAAAAAAAACAAAAAAAAAAEAAAAA",
  "complete": false
}

[darosior]

A guide was added (see #619 and #636). It can most probably be improved, but we've now got a solid base so i think this can be closed. Anyone feel free to PR enhancements to the documentation.

Special thanks go to @pythcoiner for this.