From 8965ad892d66213a1e9ab121b7d1851ccc88d5bf Mon Sep 17 00:00:00 2001
From: icyfestive <>
Date: Thu, 12 Jan 2023 17:07:50 +0000
Subject: [PATCH] document use of asb export-bitcoin-wallet

Add to the `asb` document @delta1's text on exporting the Bitcoin wallet
descriptor and importing the descriptor into Sparrow Wallet.

TODO: maybe it would make sense to add the images to Git, instead of
linking to files on Github?
---
 docs/asb/README.md | 46 ++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 46 insertions(+)

diff --git a/docs/asb/README.md b/docs/asb/README.md
index e0991d8d..e41eb028 100644
--- a/docs/asb/README.md
+++ b/docs/asb/README.md
@@ -161,3 +161,49 @@ May 01 01:32:05.018  INFO Tor found. Setting up hidden service.
 May 01 01:32:07.475  INFO /onion3/z4findrdwtfbpoq64ayjtmxvr52vvxnsynerlenlfkmm52dqxsl4deyd:9939
 May 01 01:32:07.476  INFO /onion3/z4findrdwtfbpoq64ayjtmxvr52vvxnsynerlenlfkmm52dqxsl4deyd:9940
 ```
+
+### Exporting the Bitcoin wallet descriptor
+
+
+First use `swap` or `asb` with the `export-bitcoin-wallet` subcommand.
+
+Output example:
+
+```json
+{"descriptor":"wpkh(tprv8Zgredacted.../84'/1'/0'/0/*)","blockheight":2415616,"label":"asb-testnet"}
+```
+
+The wallet can theoretically be directly imported into
+[bdk-cli](https://bitcoindevkit.org/bdk-cli/installation/) but it is easier to
+use Sparrow Wallet.
+
+Sparrow wallet import works as follows:
+
+    * File -> New wallet -> Give it a name
+
+    * Select "New or Imported Software Wallet"
+
+    * Click "Enter Private Key" for "Master Private Key (BIP32)"
+
+    * Enter the `xprv...` or `tprv...` part of the descriptor (example above is `tprv8Zgredacted...`:
+
+
+![image](https://user-images.githubusercontent.com/351403/212085114-450725b3-3ff4-4010-a142-b7d39b3200d3.png)
+
+    * Click "Import"
+
+    * Leave the derivation path as `m/84'/0'/0'` and click "Import Keystore" button
+
+    * Click "Apply" and then supply password
+
+
+![image](https://user-images.githubusercontent.com/351403/212085483-47ab7cc8-8d65-454a-877b-10b309d71bc6.png)
+
+    * Click Transactions tab
+
+    * ???
+
+    * Profit!
+
+
+![image](https://user-images.githubusercontent.com/351403/212085966-d318011d-79bf-4e72-aced-4026499591c5.png)