4.2 KiB
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.
workspace.package.version = 0.3.9-pre.5
3. Décisions fermées
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_KEYdans 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.