From 6e3344fd1b67ecb68b2c6f89a3fe3a46fad5769c Mon Sep 17 00:00:00 2001
From: parketh <yeungparkhay@gmail.com>
Date: Sat, 19 Oct 2024 19:42:43 +0100
Subject: [PATCH] docs: add troubleshooting entry on btc wallet null balance

---
 README.md | 30 +++++++++++++++++++++++++++++-
 1 file changed, 29 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 923e1f9..aa47a70 100644
--- a/README.md
+++ b/README.md
@@ -1 +1,29 @@
-# babylon-deployment
\ No newline at end of file
+# babylon-deployment
+
+## Troubleshooting
+
+1. BTC staker balance null or no unspent outputs
+
+After running `verify-bitcoin-sync-balance.sh`, the BTC staker wallet should be loaded to bitcoind. If not, you will run into null balance or no unspent outputs errors when running `create-btc-delegations.sh`.
+
+To check the wallet balance:
+
+```
+docker exec bitcoindsim /bin/sh -c "bitcoin-cli -signet -rpcuser=rpcuser -rpcpassword=rpcpass -rpcwallet=btcstaker listunspent"
+```
+
+To check unspent outputs:
+
+```
+docker exec bitcoindsim /bin/sh -c "bitcoin-cli -signet -rpcuser=rpcuser -rpcpassword=rpcpass -rpcwallet=btcstaker getbalance"
+```
+
+If your wallet balance is 0 or you have no unspent outputs, you may need to re-load the wallet:
+
+```
+docker exec bitcoindsim /bin/sh -c "bitcoin-cli -signet -rpcuser=rpcuser -rpcpassword=rpcpass -rpcwallet=btcstaker unloadwallet btcstaker"
+
+docker exec bitcoindsim /bin/sh -c "bitcoin-cli -signet -rpcuser=rpcuser -rpcpassword=rpcpass -rpcwallet=btcstaker loadwallet btcstaker"
+```
+
+Now recheck the balance and unspent outputs.
\ No newline at end of file