diff --git a/doc/zombierecovery-flow.drawio b/doc/zombierecovery-flow.drawio new file mode 100644 index 0000000..ed5f812 --- /dev/null +++ b/doc/zombierecovery-flow.drawio @@ -0,0 +1 @@ +7V1bc+K4Ev41VM0+TArf4TEwM7tbNTknO5mqPfu0JWwBPjEWJSsh7K9fSb5gWzIWMUYk8dQUwW1ZNupPn1qtbnlkzTcvv2KwXd+hAEYjcxy8jKwvI9OcOC79ZIJ9KvCm01SwwmGQioyD4CH8B2bCcSZ9CgOYVAoShCISbqtCH8Ux9ElFBjBGu2qxJYqqd92CFRQEDz6IROmfYUDW+c8aH+S/wXC1zu9sjLMzG5AXzgTJGgRoVxJZX0fWHCNE0m+blzmMWNvl7ZJe963hbPFgGMZE5YJdCL/dff/t7x8mwkuUPAfPf1ifzbSWZxA9ZT/49zgkISAIs8ohZH9GJlWiRTVizT5lIuOX7EeRfd5SyS7cRCCmR7OEAEwyXVrssggsYDQD/uMKo6c4mKOI1m99iREvvgyjKBfRGwUOnAQ2rwajR1g6MzEXluvSM9lTQ0zgS2NzGEUjU3BCtIEE72mR7IICYRkwDTc73h3UbEwz2bqk4ukkE4IMWqui7kPr0y+ZAk5QxlRoUxhQMGaHCJM1WqEYRF8P0hlvT8hqZe18KPMdoS0VGlT4f0jIPtMGeCKIitZkE2Vn03uyGzU25DHkJOgJ+/BIOSfrtACv4LH6PLm2MIwACZ+rD3f2lneEbvDAICzoY4vCmPCbOzP6f3xj2PTSefF35NBSc34mPa7KJo68tMGl9Rry0tnfWt1GTZY/iVC6Wjf9TzvWGmzZL9q8rBhp3yy2m/gGPnOFl7HBOlhIufA76773KKHMgGJ6boEIQZvmfk276pL/K9VxG4Urdi1huJyB7Min96SEYs22EIdUl+z7F6owSu/w/iCaoScShTHlgpzlGdpBsk0PluEL6wJ5KSqhDBQHADNhst8sEPtFKxhDDCJV+mhGfSOnWE6FUmyRUSwJoVh98YknoPoHXIUJ4QwOKLrHMR2uP2PoI9oW+3a0mzJQy2SeKEwxbrYDP5V5dcx7MtDLZKZEKK1S1ulqD9ncWwhIHum53Tok8GELOAXu6GlGyRSUOWkX9DxLUgLmoyi7+A7gR472BMZBj5isD3OGCMqJBJRuX6A07fc4yhkTxWHOtHSOc/ljVijBh+y+7BFyHhhTiwwOdKCFDnCmj4sxQjH+aGMEcRLyQOCWzTLozCNiNsmCjljuin379N8tM0JAJJmA8OlCPkszqwRQ19oyQjt/TW28GxDHiABW6d9myTLB6S9PTZyS7RPBJRPzzgDxV2Y0JS3m0iYMAk5jdVuoONGXqj+7VV1LLBJbour+dG0ZOth/ieJ8OmpcYjRISV5lNJjoHA3yx6yMBs8h3EkGA+s2m/WP52vaY7iTJ6RaoWoxxwEE9D7fSn4Ck5V8gPDgRPCpDoBP+GVLNAwuWgaXp4TPpi40sliKtua0N7bRYmtenG1UbU/b1so2ou35e0zn6fxKRirMr5sMxPABiME21YjB6YsYbOsjEIOlaobYDdpTJgZ+6S3GYF8qkPXcQ833TFAChV1FhePWFjBq5d2jxemX9AEOqCh+SYcRRDSR7jFkGmLtumafj3CfDFNmrR40H4db0it91fhrqsZfvU2jbHHKPC/s68zgNm/oxy2hwnWB1W2K3aCEWVbqHqMtSlgBwKTcbMeAcEHMDHy/sPnpgE3YNQPQdQC9Z1dxdfnCmYgoN1xHhLnXF8ydbsO08bphOgDJurieHdwDQiCOuYQ5pS4/ktu24khuaXUv549ZoqVfIaOkRUh8yhDsnkGAYTKY+e92pLyugdI1BaRdgEEuTQ/OVJEe3LFcexeKspgK9HBYfULLJTNbBlrQQAsXX3PyJAsRMl7oLdTKda+BF+BLSP7H/AkUA+nRX1lJ9v3LS+Zq4Af70kEpMobL+uaXnJ7b+cXpyC+vdCRUDdeJdZIjoVa8H0dCfs/yjG0N/cdiipWwJUHaxBjECZ3HsZXDgQzfp42kQIbeJcnQ67Yoe2YyNEpUeCDGKyJD1YhWt+vi7uvIsDaLn0yOk2G9/LQeRl4rP7GOFe+JPB2BPCn+QOCDhAyceQWc2ffyUQ3Sjpr12N+s8lgY3ZK2FnOuothfg3BApB5EgkVCacEvIriak0+kc/XeZ0BTyaBf2LEXiQ4XV7b+U40GL4J5bny0EWB8LN1HqQ2Pp+e4VrW9pOk50mh6o68Gy1nobUQu567z1sjlPKuuzZwxtEaP5I/ZELnM0howD+IcXMtv14fUsHiRZ9fUpk2ajQDDe5d0oLrSZLha6UBcaXrwAXOgLHnm6j9oswgZNWQr1wMrvFlnykmkYOieGhiuxKwi4ZI9MgvMGID4RkMnToKh9pwakR5/wA0iRTz+3BzdjiV5/eZpef31zH0AJ0t/JMncd/0JXCzPMzWwzao7QDo1kMaZ9+ZBzeccb8MWyKPiWz2diqaA1iQWkW+H1P3RkLrfgPpmAq9yiu7UfZmDcUjdf3dGxXFMXlvqvjXRMcqdK5hKddQzVIOprK7BDt1MjmPBVEMq/zXQwzlcYicxhPZph6VlC6tLM0RuK7QzhFYfWf6YQ3r3RyGczsvwJ7GN9vTu3Eh/52yjOg23tG6hZ4kT8SG9+2MSg/b0bqdbQOOZiEEhj6x37vAUuSNVhTbuEHcqHLKsr41DzrCUdxqL6M4dc8xOLHL92aeqLGKrbjCjl0XsY1GZbFaCN2CIEf443hBZ/rqMQPpLX+/mLz1XXkVMf0uaZeY5+fFfmZnDDw65FfxoXz46V3aFKtfkNmE713QNR3xddkVtncht2bPGqAUGuJfYtCZvwxIR3oHHIcn23dtP7fwnyyvrj/8kQXqQJztmOBx/un+Y/WS+REpihStRnLwNAH1/q5muJH63iOS5TBbPsRW0IYvnGiCpIYvnJBBLs3hkIO4tUMToNkl9pavrYFNWDMobpyeTMh8S2qxHVXeX0RBheJrxKFh79qQKD2tcU3v6YNlVB82faoUWQ3Z+H/u4FerUn+vE8uYlrFZDy56cF8w6VwWxqrflPCA+FXsClsZXiKXinWuaWPGm+0T7sDfMeGxXwOlavewQowpPQ3U90tCy/4Fb36uzZTMYx+5W3mrxAAhcfRH8a1kA6wf/10PM6sifDsin9Tk6kC9O6rKXyYiG8nt/YczxNBqjph5bMiGXvRymv+BB0W2ZqU60DAfVVTx9iu/16S8Sy2hSnfgGjkF1FTeYoup6S12zxdiLTHXOiL/6F2x41g//pBJx48RBoWWFepIYbJlCjf5yP99KELaq3ZXvdt/+Hgu9mYjdjO5XLvee1ejuUYn5YlD7wm5X47mbEsVtkTI69AoujBfJtmicgQgbiHA61myUuI0jmxiXMaiurDpjrKi7/rYk7bascbl921XpT33XUK3054n095PH337iS/Yw+GWUvQOG1ZTwX76Bn8X3tJJ1GK9G2cI+WGGeK4T4DseINsAaYvbimYcw9tmJGIZMNCpiAB5jtGO1p8G/wCdPIDrc+Zt4vwWIAK9rzmCMnjh2+e9dA76gW3kQfkAfMak+Tx1xaTL7SL6UWcJND2uTxzusW19Ml/RX6RYYRn1F6nzIEYM9xAaNg1uM0e7QNpVo11oUbDXw1Rrl24qUWbra5V/ff1u7pdew/0upwR1Je+eyjguL1rQ2yahPHlL+ERYWRZ9czYfn1XdLPNMKZZECUpsVNW7JXi9fXVXqx1foiQmSbwiy5wul1IttrxYiOalDUhXb3qSlkzRgux1O9BAjRMrFmSF4hwLISvwL \ No newline at end of file diff --git a/doc/zombierecovery-flow.png b/doc/zombierecovery-flow.png new file mode 100644 index 0000000..f934055 Binary files /dev/null and b/doc/zombierecovery-flow.png differ diff --git a/doc/zombierecovery-flow.svg b/doc/zombierecovery-flow.svg new file mode 100644 index 0000000..c46f675 --- /dev/null +++ b/doc/zombierecovery-flow.svg @@ -0,0 +1,4 @@ + + + +Initiator peer (peer 1)
Start
Start
Register at node-recovery
Register at n...
Receive recovery file
Receive recov...
Step 1
(Optional)
Step 1...
Review recovery file: 1) Channel indeed dead?
2) See peer contact info
Review recove...
Install Chantools
Install Chant...
Prepare the keys file
Prepare the k...
Contact peer 2. Attach the preparedkeys file. Propose a fee rate and channel state.
Contact peer 2. Attach the...
Get bitcoin address
Get bitcoin a...
Receive offer
Receive offer
Check and sign transaction
Check and s...
Broadcast transaction
Broadcast tra...
Receive funds onchain
Receive funds onchain
Node-recovery.com
Receive registrations
Receive regis...
Scan for zombie channels
Scan for zomb...
Notify peers
Notify peers
Remote peer (peer 2)
Start
Start
Register at node-recovery
Register at n...
Receive recovery file
Receive recov...
Review recovery file: 1) Channel indeed dead?
2) See peer contact info
Review recove...
Install Chantools
Install Chant...
Prepare the keys file
Prepare the k...
Receive information
Receive infor...
Make offer
Make offer
Send offer (PSBT) to peer 1
Send offer (PSBT) to peer 1
Receive funds onchain
Receive funds onchain
Step 2
Step 2
Step 3
Step 3
Step 4
Step 4
Step 5 & 6
Step 5...
Step 7 
Step 7 
Step 8
Step 8
The (offered) state is some-
thing to agree on together. Since neither peer knows the actual state/
balance, you will have to agree to this together.
The (offered) state is some-...
Text is not SVG - cannot display
\ No newline at end of file diff --git a/doc/zombierecovery.md b/doc/zombierecovery.md index 4814376..b6ab27c 100644 --- a/doc/zombierecovery.md +++ b/doc/zombierecovery.md @@ -27,6 +27,10 @@ Preparation: file (see ["File format" section](#file-format)) and skip to step 3 below. Steps: + +Below image is a simplified version of the steps described below the image. +![Zombierecovery Flow](zombierecovery-flow.svg) + 1. _(Optional -- only needed if you have no contact with the remote party)_ Register at [node-recovery.com](https://node-recovery.com). This website helps you connect to peers, for recovery. You enter your public key and some @@ -79,7 +83,7 @@ chantools zombierecovery makeoffer \ chantools zombierecovery signoffer \ --psbt ``` -9. After signing, the transaction can be broadcast. From the PSBT (_partially +8. After signing, the transaction can be broadcast. From the PSBT (_partially signed_ bitcoin transaction), by signing, you have now (together) created a proper bitcoin transaction. An offer has been made, you have agreed on what split ("piece of the pie") goes to whom, created a transaction, signed it.