72 lines
4.2 KiB
Markdown
72 lines
4.2 KiB
Markdown
<!-- 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.
|