v0.2.8-pre.010
This commit is contained in:
@@ -1,9 +1,9 @@
|
||||
<!-- file: docs/plans/015-V0_2_8_HELIUS_LASERSTREAM_WEBSOCKET_PLAN.md -->
|
||||
<!-- version: 23 -->
|
||||
<!-- version: 24 -->
|
||||
|
||||
# Plan `0.2.8` — Helius LaserStream WebSocket
|
||||
|
||||
> **Statut : `0.2.8-pre.008` est validé intégralement par l’opérateur : fmt/audit/check/Clippy, 335 unit Transport, 40 API, 30 completeness, 5 doctests et workspace complet verts. `0.2.8-pre.009` réconcilie la documentation Helius courante, ajoute `slotsUpdates` à la façade Helius et ferme les canaris de compliance HTTP/WS/Config/dependencies.**
|
||||
> **Statut : `0.2.8-pre.009` est validé intégralement par l’opérateur : fmt/audit/check/Clippy, 335 unit Transport, 41 API, 33 completeness, 4 doctests et workspace complet verts. `0.2.8-pre.010` synchronise README/USAGE, ferme la stratégie de smoke live sans violer l’ownership Config/Transport et demande le cargo tree final à l’opérateur.**
|
||||
|
||||
## 1. Objet, base et état courant
|
||||
|
||||
@@ -39,10 +39,12 @@ pre.007-fix.001 lint + close canary corrigés
|
||||
pre.007-fix.002 observation yield-only insuffisante — checkpoint historique
|
||||
pre.007-fix.003 heartbeat Transport fermé
|
||||
pre.007-fix.004 alignement canari dependency-firewall Tokio dev validé
|
||||
pre.008 adversarial provider/capabilities/payload/security — préparé
|
||||
pre.008 adversarial provider/capabilities/payload/security validé
|
||||
pre.009 compliance provider/current + slotsUpdates Helius validé
|
||||
pre.010 documentation/smoke policy/cargo tree final — préparé
|
||||
|
||||
workspace.package.version courant = 0.2.8-pre.8
|
||||
commit attendu = v0.2.8-pre.008
|
||||
workspace.package.version courant = 0.2.8-pre.10
|
||||
commit attendu = v0.2.8-pre.010
|
||||
aucun tag prerelease
|
||||
```
|
||||
|
||||
@@ -78,10 +80,10 @@ pre.007 DONE — heartbeat Helius WebSocket/idle + timers + interaction reconne
|
||||
fix.003 DONE — canari heartbeat périodique stabilisé sans changer le runtime
|
||||
fix.004 DONE — dependency-firewall aligné sur `io-util, net, rt, test-util`
|
||||
pre.008 DONE — provider adversarial lifecycle + capability guards + payload/backpressure + security/redaction
|
||||
pre.009 PREPARED — compliance Helius WebSocket + réconciliation documentaire `slotsUpdates`
|
||||
pre.009 DONE — compliance Helius WebSocket + réconciliation documentaire `slotsUpdates`
|
||||
+ non-régressions Solana standard 18/18 + HTTP 52/14 + Config/API/dependency-firewall canaries
|
||||
pre.010 smoke Helius WebSocket live opt-in si stratégie sûre + README/USAGE
|
||||
+ cargo tree direct/duplicates final
|
||||
pre.010 PREPARED — stratégie smoke Helius live fermée sans nouveau cross-crate owner + README/USAGE
|
||||
+ cargo tree direct/duplicates final à rejouer par l’opérateur
|
||||
pre.011 validation workspace finale + fermeture plan/matrice/indexes + prompt 0.2.9
|
||||
rel.001 publication stable stricte
|
||||
```
|
||||
@@ -1461,3 +1463,63 @@ Aucune nouvelle dépendance, aucun nouveau DTO Helius pour `slotsUpdates`, aucun
|
||||
|
||||
`pre.010` reste réservé au smoke Helius live opt-in si une stratégie credential-safe est disponible, à README/USAGE et au `cargo tree` final.
|
||||
|
||||
## 22. Fermeture `pre.009` et préparation `pre.010`
|
||||
|
||||
Checkpoint opérateur `0.2.8-pre.9` reçu le 2026-08-23 :
|
||||
|
||||
```text
|
||||
[x] cargo fmt --all
|
||||
[x] python3 scripts/audit_rust_workspace_rules.py = clean / 0 candidate
|
||||
[x] cargo check --workspace = vert, sans warning
|
||||
[x] cargo clippy --workspace --all-targets = vert, sans warning
|
||||
[x] Transport unit = 335/335
|
||||
[x] Transport public API = 41/41
|
||||
[x] release completeness = 33/33
|
||||
[x] Transport doctests = 4/4
|
||||
[x] cargo test --workspace = vert
|
||||
```
|
||||
|
||||
Verdict : **`pre.009` DONE.**
|
||||
|
||||
Le réaudit Helius courant confirme les endpoints unifiés `wss://mainnet.helius-rpc.com/?api-key=...` et `wss://devnet.helius-rpc.com/?api-key=...`, le heartbeat recommandé par Ping chaque minute, `slotSubscribe` sur ces endpoints et `transactionSubscribe` comme extension Helius. La stratégie de smoke durable est néanmoins contrainte par l’architecture KSP :
|
||||
|
||||
```text
|
||||
Transport -X-> Config / environnement
|
||||
Config ne doit pas devenir la destination générale des futurs smokes cross-crates
|
||||
KSP_SECRET_HELIUS_API_KEY appartient exclusivement à Config
|
||||
```
|
||||
|
||||
Décision `pre.010` : **aucun nouveau smoke Helius live committé dans Transport ou Config**. La future surface KSP d’intégration/orchestration dédiée devra porter le scénario `Config helius_devnet -> HeliusLaserStreamWsSession -> slotSubscribe -> notification -> unsubscribe -> close`. `transactionSubscribe` pourra rester un smoke opt-in supplémentaire dépendant des droits provider, jamais un gate réseau stable.
|
||||
|
||||
Livraison `pre.010` :
|
||||
|
||||
```text
|
||||
- README Transport synchronisé avec la surface Helius finale 7 standard + transaction
|
||||
- USAGE Transport documente Config -> façade Helius, heartbeat et limites d’ownership
|
||||
- release completeness verrouille l’absence de lecture secret/env dans le smoke Transport
|
||||
- aucun nouveau test Helius live dans Config
|
||||
- aucune nouvelle dépendance
|
||||
- cargo tree final requis de l’opérateur
|
||||
```
|
||||
|
||||
Gate attendu :
|
||||
|
||||
```text
|
||||
Transport unit 335
|
||||
Transport public API 41
|
||||
release completeness 34
|
||||
Transport doctests 4
|
||||
workspace vert
|
||||
warnings 0
|
||||
```
|
||||
|
||||
Audit graphe à joindre au checkpoint opérateur :
|
||||
|
||||
```bash
|
||||
cargo tree -p ksp-onchain-transport-lib
|
||||
cargo tree -p ksp-onchain-transport-lib --duplicates
|
||||
cargo tree --duplicates
|
||||
```
|
||||
|
||||
`pre.011` reste bloqué jusqu’au gate complet et à l’inspection de ces graphes.
|
||||
|
||||
|
||||
Reference in New Issue
Block a user