v0.3.9-pre.005

This commit is contained in:
2026-09-04 21:53:36 +02:00
parent eb39aaa904
commit e85d6f6963
5 changed files with 299 additions and 20 deletions

71
deltas/0.3.9/pre.005.md Normal file
View File

@@ -0,0 +1,71 @@
<!-- file: deltas/0.3.9/pre.005.md -->
<!-- version: 1 -->
# Delta `0.3.9-pre.005`
## 1. Objet
Poursuivre l'audit RAW post-freeze avec Helius, Yellowstone, providers alternatifs et la référence fonctionnelle historique kbot3. Cette tranche ferme les preuves provider/tier/replay nécessaires avant la synthèse multi-source `pre.006`.
Aucun runtime, DTO, endpoint, secret, profil Config, Store model ou Worker API n'est modifié.
## 2. Base et version
Base : `0.3.9-pre.4`, dont les audits opérateur Rust/Markdown sont PASS.
```text
workspace.package.version = 0.3.9-pre.5
```
## 3. Décisions fermées
```text
Helius Standard WSS -> admis ; provider-managed continuity, repair KSP conservé
Helius transactionSubscribe -> live_direct_full spécialisé déjà supporté par Transport
Helius LaserStream gRPC -> Yellowstone-compatible, replay from_slot 24 h prouvé
Yellowstone transactions -> live_direct_full générique prioritaire
Yellowstone status/meta -> signaux incomplets/continuité, jamais RAW seuls
PublicNode Yellowstone -> live prouvé, profondeur replay non prouvée
OrbitFlare Yellowstone -> live prouvé, profondeur replay non prouvée
OrbitFlare archive HTTP -> historique complet depuis genesis annoncé
kbot3 -> référence fonctionnelle uniquement, aucune source de code/config
```
## 4. Gaps ouverts
- convergence RAW commune entre `transactionSubscribe`, Yellowstone transaction et autres sources full ;
- Config Yellowstone multi-provider par capabilities, sans SDK provider parallèle ;
- replay gRPC activé uniquement si support/rétention provider réellement observés ;
- repair externe conservé pour WSS lorsque la plage manquée n'est pas adressable ;
- réutilisation unique de `KSP_SECRET_HELIUS_API_KEY` dans la future composition Helius ;
- stratégies historiques provider-specific réservées à la synthèse `0.3.12`.
## 5. Fichiers
| Fichier | Action | Rôle |
|----------------------------------------------------------------|--------|------------------------------------------|
| Cargo.toml | MOD | workspace `0.3.9-pre.5` |
| docs/architecture/011-RAW_TRANSACTION_ACQUISITION.md | MOD | audit providers/Yellowstone/kbot3 + gaps |
| docs/plans/030-V0_3_9_WORKER_API_RAW_TRANSACTION_AUDIT_PLAN.md | MOD | marque pre.005 réalisé |
| docs/validation/026-V0_3_9_WORKER_API_RAW_TRANSACTION_AUDIT.md | MOD | preuves/checklist pre.005 |
| deltas/0.3.9/pre.005.md | ADD | présent delta |
## 6. Sources
| Famille | Preuves consultées |
|----------------------|------------------------------------------------------------------------------------|
| Helius | LaserStream WSS/gRPC, pricing, rate limits, gTFA, Preconfirmations, Parsed Streams |
| Yellowstone upstream | proto, README, changelog |
| PublicNode | page Solana officielle |
| OrbitFlare | Yellowstone docs, pricing, archive, gRPC product |
| kbot3 fourni | référence fonctionnelle locale uniquement |
Toutes les sources externes sont datées du 4 septembre 2026 dans l'owner architecture. Les URLs qui y figurent sont des liens documentaires ; aucune URL d'endpoint provider n'est transférée dans Config.
## 7. kbot3
L'archive historique a uniquement servi à inventorier les comportements `BackfillSource`, discovery/hydration, reprise, session WS, fallback et provenance. Aucun code, type, DTO, URL d'endpoint, secret, configuration, dependency ou convention de version n'est repris.
## 8. Gates
Les audits Python sont exécutés après assemblage. Les gates Cargo de cette tranche restent opérateur-owned ; le changement Rust se limite au metadata de version workspace.