From 43d09b8fa64ba265d33fbbb41a14aa325ac099f0 Mon Sep 17 00:00:00 2001 From: Marcin Pawlowski Date: Thu, 30 Jul 2026 18:23:59 +0200 Subject: [PATCH] Importing TSI report --- reports/tsi/README.md | 24 ++ reports/tsi/report-figures/fig10_sawtooth.png | Bin 0 -> 306598 bytes .../report-figures/fig11_profitability.png | Bin 0 -> 217667 bytes reports/tsi/report-figures/fig12_tipping.png | Bin 0 -> 201744 bytes reports/tsi/report-figures/fig13_selfish.png | Bin 0 -> 288257 bytes .../report-figures/fig14_optimal_rewards.png | Bin 0 -> 280051 bytes reports/tsi/report-figures/fig15_mandate.png | Bin 0 -> 256659 bytes .../report-figures/fig16_stake_vs_delay.png | Bin 0 -> 194495 bytes .../tsi/report-figures/fig17_divergence.png | Bin 0 -> 126619 bytes .../report-figures/fig18_tip_agreement.png | Bin 0 -> 141595 bytes .../fig19_accuracy_vs_latency.png | Bin 0 -> 90808 bytes reports/tsi/report-figures/fig1_bootstrap.png | Bin 0 -> 251709 bytes .../report-figures/fig20_heatmap_accuracy.png | Bin 0 -> 97456 bytes .../fig21_heterogeneous_recovery.png | Bin 0 -> 93154 bytes .../fig22_heatmap_window_delay.png | Bin 0 -> 175971 bytes .../tsi/report-figures/fig23_nscaling_u1.png | Bin 0 -> 257309 bytes .../report-figures/fig24_nscaling_probe.png | Bin 0 -> 231204 bytes .../tsi/report-figures/fig25_window_scale.png | Bin 0 -> 265951 bytes .../report-figures/fig26_deficit_vs_rho.png | Bin 0 -> 280599 bytes .../tsi/report-figures/fig27_reorg_tail.png | Bin 0 -> 207033 bytes .../fig28_reorg_depth_vs_delay.png | Bin 0 -> 179224 bytes reports/tsi/report-figures/fig29_churn.png | Bin 0 -> 362614 bytes .../report-figures/fig2_uncle_recovery.png | Bin 0 -> 134598 bytes .../tsi/report-figures/fig3_hops_delay.png | Bin 0 -> 262869 bytes reports/tsi/report-figures/fig4_window.png | Bin 0 -> 165898 bytes .../tsi/report-figures/fig5_window_uncles.png | Bin 0 -> 130386 bytes .../tsi/report-figures/fig6_block_rate.png | Bin 0 -> 241751 bytes .../fig7_feedback_bistability.png | Bin 0 -> 226417 bytes reports/tsi/report-figures/fig8_adversary.png | Bin 0 -> 146300 bytes reports/tsi/report-figures/fig9_withhold.png | Bin 0 -> 175593 bytes .../figB1_fluctuation_trace.png | Bin 0 -> 229637 bytes .../figB2_fluctuation_stats.png | Bin 0 -> 247927 bytes ...i-report-1-overview-and-recommendations.md | 184 +++++++++++ .../tsi/tsi-report-2-accuracy-and-design.md | 308 ++++++++++++++++++ .../tsi-report-3-robustness-and-incentives.md | 226 +++++++++++++ ...report-4-reproducibility-and-appendices.md | 137 ++++++++ 36 files changed, 879 insertions(+) create mode 100644 reports/tsi/README.md create mode 100644 reports/tsi/report-figures/fig10_sawtooth.png create mode 100644 reports/tsi/report-figures/fig11_profitability.png create mode 100644 reports/tsi/report-figures/fig12_tipping.png create mode 100644 reports/tsi/report-figures/fig13_selfish.png create mode 100644 reports/tsi/report-figures/fig14_optimal_rewards.png create mode 100644 reports/tsi/report-figures/fig15_mandate.png create mode 100644 reports/tsi/report-figures/fig16_stake_vs_delay.png create mode 100644 reports/tsi/report-figures/fig17_divergence.png create mode 100644 reports/tsi/report-figures/fig18_tip_agreement.png create mode 100644 reports/tsi/report-figures/fig19_accuracy_vs_latency.png create mode 100644 reports/tsi/report-figures/fig1_bootstrap.png create mode 100644 reports/tsi/report-figures/fig20_heatmap_accuracy.png create mode 100644 reports/tsi/report-figures/fig21_heterogeneous_recovery.png create mode 100644 reports/tsi/report-figures/fig22_heatmap_window_delay.png create mode 100644 reports/tsi/report-figures/fig23_nscaling_u1.png create mode 100644 reports/tsi/report-figures/fig24_nscaling_probe.png create mode 100644 reports/tsi/report-figures/fig25_window_scale.png create mode 100644 reports/tsi/report-figures/fig26_deficit_vs_rho.png create mode 100644 reports/tsi/report-figures/fig27_reorg_tail.png create mode 100644 reports/tsi/report-figures/fig28_reorg_depth_vs_delay.png create mode 100644 reports/tsi/report-figures/fig29_churn.png create mode 100644 reports/tsi/report-figures/fig2_uncle_recovery.png create mode 100644 reports/tsi/report-figures/fig3_hops_delay.png create mode 100644 reports/tsi/report-figures/fig4_window.png create mode 100644 reports/tsi/report-figures/fig5_window_uncles.png create mode 100644 reports/tsi/report-figures/fig6_block_rate.png create mode 100644 reports/tsi/report-figures/fig7_feedback_bistability.png create mode 100644 reports/tsi/report-figures/fig8_adversary.png create mode 100644 reports/tsi/report-figures/fig9_withhold.png create mode 100644 reports/tsi/report-figures/figB1_fluctuation_trace.png create mode 100644 reports/tsi/report-figures/figB2_fluctuation_stats.png create mode 100644 reports/tsi/tsi-report-1-overview-and-recommendations.md create mode 100644 reports/tsi/tsi-report-2-accuracy-and-design.md create mode 100644 reports/tsi/tsi-report-3-robustness-and-incentives.md create mode 100644 reports/tsi/tsi-report-4-reproducibility-and-appendices.md diff --git a/reports/tsi/README.md b/reports/tsi/README.md new file mode 100644 index 0000000..9587fc6 --- /dev/null +++ b/reports/tsi/README.md @@ -0,0 +1,24 @@ +# Total-Stake-Inference parameter selection + +*Per-node network simulation of Cryptarchia Total Stake Inference (TSI). Simulator: [`tsi-sim-pernode`](../../tools/simulators/tsi/tsi-sim-pernode). All runs at the true security parameter **k = 2160** unless noted; latency is in slots and **1 slot = 1 s**.* + +This report selects and justifies the TSI parameters for Cryptarchia from a per-node network simulation. It is split into four cohesive parts; section numbers (§1–§9, A–C) are stable identifiers preserved across the set. + +## Parts + +1. **[Overview and recommendations](tsi-report-1-overview-and-recommendations.md)** — the executive summary, the per-knob parameter reference (§7), and the safest selection with residual risks and the recommendation-vs-spec deltas (§8). +2. **[Accuracy and design](tsi-report-2-accuracy-and-design.md)** — the model and counting rule (§2), the seven findings and their evidence (§3), and the design equations / selection algorithm (§4–§5). +3. **[Robustness and incentives](tsi-report-3-robustness-and-incentives.md)** — jitter, grinding, withholding, selfish mining, the reward design, fork/reorg depth, and organic churn (§6). +4. **[Reproducibility and appendices](tsi-report-4-reproducibility-and-appendices.md)** — how to re-run every study (§9), the residual f-rounding offset (App A), the per-epoch noise floor (App B), and consensus detail (App C). + +## Headline recommendation + +Cryptarchia baseline f = 1/30: security `k = 2160`, uncle window `W = 300` slots, uncle cap `U = ⌈ρ⌉ + 1` (2 at the Blend target), learning rate `β = 1`, peering degree ≥ 6 at scale, soft uncle rewards with `w_u + w_n < 1`, and operate at load `ρ = f·D_vis < 1`. The full recommended-configuration table and rationale are in **[Part 1 →](tsi-report-1-overview-and-recommendations.md)**. + +## Figures + +Figures are embedded from [`report-figures/`](report-figures) via relative links and are versioned here alongside the report. They are produced by the simulator's plotting scripts (`scripts/*.py` and `tsi_sim.plotting`) in [`tsi-sim-pernode`](../../tools/simulators/tsi/tsi-sim-pernode); that simulation folder does **not** commit its own generated figures — the copies checked in here are the report's figures of record. + +## Reproducing the results + +The simulation code, configs, and run data live in [`tools/simulators/tsi/tsi-sim-pernode`](../../tools/simulators/tsi/tsi-sim-pernode). Every study's exact command is listed in [Part 4 — Reproducibility (§9)](tsi-report-4-reproducibility-and-appendices.md). In short, from the simulator directory: `make install`, then `make ` to run a sweep (results land under `runs/_