Skip to content

Commit

Permalink
formatting improvements 2
Browse files Browse the repository at this point in the history
  • Loading branch information
walldiss committed Feb 11, 2025
1 parent 884c0ea commit 90840d5
Showing 1 changed file with 23 additions and 15 deletions.
38 changes: 23 additions & 15 deletions docs/adr/reconstruction.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,3 @@
Below is a revised version of the document with improvements in clarity, grammar, and style. Additionally, all images have been resized to approximately half their original display width.

---

## Abstract
Expand Down Expand Up @@ -118,7 +116,7 @@ Below is a step-by-step illustration of the reconstruction flow, with accompanyi

<img src="https://github.com/user-attachments/assets/2849d1a1-07bd-4284-b1ce-bcaebf713acd" width="50%">

8. **Reconstruct the entire block**
8. **Reconstruction is possible now**
- FN2 can now reconstruct the block via erasure decoding.

<img src="https://github.com/user-attachments/assets/51e81ccb-2107-45d7-b553-f7af1f1cada3" width="50%">
Expand Down Expand Up @@ -415,22 +413,32 @@ A coordinated network upgrade may be required as this protocol evolves. The impl
---

## Full Reconstruction Process Diagram
<div style="transform: scale(0.50); transform-origin: top left;">

```mermaid
flowchart TB
A((Start)) --> B{Retrieve block\nvia shrex?}
B -- "Yes" --> C["Block fully retrieved\nvia shrex\n(Stop reconstruction)"]
B -- "No / Timeout" --> D["Initiate block reconstruction\nprocess"]
B -- "No / Timeout" --> D["Initiate reconstruction"]
D --> E["Subscribe to\nbitmap updates"]
D --> F["Request LN samples\n(in batches)"]
E --> G["Receive FNs' bitmaps"]
F --> H["Receive LN samples"]
D --> E["Subscribe to bitmap\nupdates from FNs"]
E --> F["Request LN samples\n(in batches)"]
F --> G["Receive LN samples"]
G --> H["Update local storage\n(Have state)"]
H --> I["Publish local bitmap\nto connected FNs"]
G --> I["Update local storage\n(Have state)"]
H --> I
I --> J{"Sufficient samples\nto decode block?"}
J -- "No" --> K["Wait for additional\nsamples (LN/FN/new LN)"]
K --> G
I --> J["Publish local bitmap\nto FNs"]
J -- "Yes" --> L["Decode block\nusing erasure coding"]
L --> M["Notify network\nof complete sample set"]
M --> N((Done\nReconstruction complete))
J --> K{"Sufficient samples\nto decode block?"}
K -- "No" --> L["Wait for more samples\n(LN/FN/new LN)"]
L --> I
K -- "Yes" --> M["Decode block\n(erasure coding)"]
M --> N["Notify network\nof complete sample set"]
N --> O((Done\nReconstruction complete))
```
</div>

0 comments on commit 90840d5

Please sign in to comment.