v0.3.13-pre.003

This commit is contained in:
2026-09-10 11:38:34 +02:00
parent 2e8feb56dd
commit f7ed053e8e
14 changed files with 1503 additions and 146 deletions

View File

@@ -1,5 +1,5 @@
<!-- file: docs/plans/034-V0_3_13_MULTI_SOURCE_LIVE_CONVERGENCE_PLAN.md -->
<!-- version: 2 -->
<!-- version: 3 -->
# Plan v0.3.13 — WS standard / Helius / HTTP live + convergence multi-source RawTransaction
@@ -460,6 +460,26 @@ Hydration retry/rate limit : Transport HTTP.
Preuve : fixture logs notification -> une seule hydration -> exact Common RAW golden ; mentions/all/allWithVotes ; stop/reconnect/backpressure ; redaction des logs.
### 13.1 Décisions matérialisées en pre.003
La tranche conserve la barrière dactivation simultanée de `pre.002` : une source unique Yellowstone ou Standard Logs est productive ; une collection `2..32` reste rejetée avant spawn jusquau supervisor `pre.007`. Il nest donc pas créé de supervisor provisoire qui ignorerait une partie de la configuration.
Le coordinateur dhydration Yellowstone devient un contrat privé source-neutral réutilisé par Standard Logs. Pour cette tranche, chaque exécution mono-source en possède une instance ; la possession réellement globale entre plusieurs sources narrive quavec le supervisor `pre.007`. Cette distinction corrige le raccourci de wording « coordinator global » du sizing initial sans modifier lobjectif de convergence.
Bornes retenues :
```text
hydration in-flight <= persistence_concurrency
pending source signals <= admission_queue_capacity
aucune queue Worker non bornée
```
Le `getTransaction observed` commun passe à `maxSupportedTransactionVersion = 1` pour Yellowstone comme pour Standard Logs. Cela ne déclare aucun chemin RAW-direct V1 ; il sagit uniquement de rendre lhydration HTTP version-aware conformément au contrat `0.3.13`.
Pour Standard Logs, lidentité logique inclut le réseau, la famille `standard_logs`, lidentité provider/endpoint sûre, le commitment et lempreinte privée du filtre. Le rôle/pool HTTP dhydration nentre pas dans cette identité. Les variantes `All`, `AllWithVotes` et `Mentions(pubkey)` sont distinguées sans recopier le pubkey dans `Debug`, snapshot ou diagnostics.
Les valeurs `logs` et `err` de la notification restent entièrement dans Transport : le Worker ne projette que `context.slot` et `signature`.
## 14. Contrat source WS standard blockSubscribe
Entrée caller-composed :
@@ -776,7 +796,7 @@ Collection bornée 1..32, source key, discriminants capability-owned, validation
### pre.003 — WS standard logsSubscribe + hydration
Source logs, signal privé, intégration coordinator global et hydration observed.
Source logs, signal privé, réutilisation du coordinator dhydration source-neutral et hydration observed ; activation simultanée toujours différée à pre.007.
### pre.004 — WS standard blockSubscribe