v0.2.8-pre.002
This commit is contained in:
@@ -1,9 +1,9 @@
|
||||
<!-- file: docs/validation/011-V0_2_8_HELIUS_LASERSTREAM_WEBSOCKET.md -->
|
||||
<!-- version: 5 -->
|
||||
<!-- version: 6 -->
|
||||
|
||||
# Validation `0.2.8` — Helius LaserStream WebSocket
|
||||
|
||||
> **Statut : gate `0.2.8-pre.001` positif ; architecture corrigée par `pre.001-fix.001`, forecast et nomenclature clarifiés par `pre.001-fix.002`.** Les graphes Cargo opérateur sont reçus et non bloquants. La validation runtime doit prouver deux façades protocolaires distinctes partageant un seul moteur `WsSession` et préserver une distinction explicite entre Helius LaserStream **WebSocket** et le futur LaserStream gRPC.
|
||||
> **Statut : `0.2.8-pre.002` implémente le socle des deux façades protocolaires sur le moteur `WsSession` unique.** Le protocol kind Helius LaserStream WebSocket, les guards de constructeur, la compatibilité standard historique et l'absence d'escape hatch Helius sont matérialisés. Les six subscriptions standard supportées par Helius restent volontairement ouvertes pour `pre.003`.
|
||||
|
||||
## 1. Références
|
||||
|
||||
@@ -101,13 +101,13 @@ Verdict : doublons transitifs, aucune nouvelle dépendance Helius, aucune anomal
|
||||
|
||||
| Critère | Décision | Preuve cible | État |
|
||||
|-------------------------------------|------------------------------------------------------------------|---------------------------------|--------|
|
||||
| actor physique | un seul `WsSession` actor partagé | source/runtime canary | décidé |
|
||||
| façade standard | `SolanaStandardWsSession` | public API canary | décidé |
|
||||
| façade Helius | `HeliusLaserStreamWsSession` | public API canary | décidé |
|
||||
| actor physique | un seul `WsSession` actor partagé | source/runtime canary | pre.002 implémenté |
|
||||
| façade standard | `SolanaStandardWsSession` | public API canary | pre.002 implémenté |
|
||||
| façade Helius | `HeliusLaserStreamWsSession` | public API canary | pre.002 implémenté |
|
||||
| namespace LaserStream WS | `WsProtocolKind` + `ws_endpoints` possèdent `helius_laserstream` | API/Config/docs canary | décidé |
|
||||
| LaserStream gRPC | backend/type/Config distincts, hors `0.2.8` | absence de réutilisation WS | décidé |
|
||||
| escape hatch Helius | aucun `inner()`/`into_inner()` public | API/source canary | décidé |
|
||||
| generic Helius `WsSession::connect` | ne doit pas permettre de contourner la façade | invalid protocol pre-I/O canary | décidé |
|
||||
| escape hatch Helius | aucun `inner()`/`into_inner()` public | compile-fail/source canary | pre.002 implémenté |
|
||||
| generic Helius `WsSession::connect` | ne doit pas permettre de contourner la façade | invalid protocol pre-I/O canary | pre.002 implémenté |
|
||||
| Helius unsupported | absent de la façade | compile-fail/API absence canary | décidé |
|
||||
| standard Helius commun | délégation vers le même wire/actor | exact fixture | décidé |
|
||||
| DTO duplication | seulement si wire/sémantique divergent | public/source audit | décidé |
|
||||
@@ -159,19 +159,19 @@ aucun payload brut dans logs/snapshots
|
||||
## 6. Validation lifecycle/provider à construire
|
||||
|
||||
```text
|
||||
[ ] un seul actor/socket implementation path
|
||||
[ ] SolanaStandardWsSession public et constructible
|
||||
[ ] HeliusLaserStreamWsSession public et constructible
|
||||
[ ] `helius_laserstream` reste possédé par le namespace WebSocket
|
||||
[ ] aucune API/Config gRPC n'est anticipée ou aliasée sur le contrat WS
|
||||
[ ] WsSession historique standard reste compatible
|
||||
[ ] Helius facade n'expose pas blockSubscribe
|
||||
[ ] Helius facade n'expose pas slotsUpdatesSubscribe
|
||||
[ ] Helius facade n'expose pas voteSubscribe
|
||||
[ ] SolanaStandard facade n'expose pas transactionSubscribe
|
||||
[ ] Helius facade n'expose aucun escape hatch vers le handle générique
|
||||
[ ] protocol mismatch rejeté avant I/O
|
||||
[ ] 6 familles standard Helius utilisent le wire standard exact
|
||||
[x] un seul actor/socket implementation path dans le code `pre.002`
|
||||
[ ] SolanaStandardWsSession public et constructible — canary ajoutée, exécution opérateur requise
|
||||
[ ] HeliusLaserStreamWsSession public et constructible — canary ajoutée, exécution opérateur requise
|
||||
[x] `helius_laserstream` reste possédé par le namespace WebSocket
|
||||
[x] aucune API/Config gRPC n'est anticipée ou aliasée sur le contrat WS
|
||||
[x] WsSession historique reste public et son constructeur devient explicitement standard-only
|
||||
[x] Helius facade n'expose pas blockSubscribe en `pre.002`
|
||||
[x] Helius facade n'expose pas slotsUpdatesSubscribe en `pre.002`
|
||||
[x] Helius facade n'expose pas voteSubscribe en `pre.002`
|
||||
[x] SolanaStandard facade n'expose pas transactionSubscribe
|
||||
[x] Helius facade n'expose aucun escape hatch vers le handle générique
|
||||
[ ] protocol mismatch rejeté avant I/O — fixtures ajoutées, exécution opérateur requise
|
||||
[ ] 6 familles standard Helius utilisent le wire standard exact — `pre.003`
|
||||
[ ] transaction subscribe/ack exact
|
||||
[ ] transaction unsubscribe/result exact
|
||||
[ ] transaction notification dispatch exact
|
||||
@@ -232,7 +232,7 @@ Le plan est la source normative du forecast. La validation reprend la même form
|
||||
pre.001 DONE — audit/sizing/matrice/dependencies
|
||||
fix.001 DONE — façades séparées + gate Cargo fermé
|
||||
fix.002 DONE — forecast compact + namespace LaserStream WS/gRPC
|
||||
pre.002 socle protocolaire/façades/connect partagé
|
||||
pre.002 PREPARED — socle protocolaire/façades/connect partagé
|
||||
pre.003 6 familles Helius communes + absence 3 unsupported
|
||||
pre.004 Config V2 + secrets
|
||||
pre.005 transaction request/unsubscribe
|
||||
@@ -274,4 +274,42 @@ Le forecast reste souple ; les fixes ne sont pas comptés comme des prereleases
|
||||
[x] doublons ciblés analysés comme transitifs/non bloquants
|
||||
```
|
||||
|
||||
Verdict : **gate `0.2.8-pre.001` positif. `pre.002` peut ouvrir le socle protocolaire/façades sans commencer prématurément `transactionSubscribe`.**
|
||||
Verdict : **gate `0.2.8-pre.001` positif ; socle `pre.002` matérialisé, validations compilées opérateur encore requises avant commit.**
|
||||
|
||||
## 12. Preuve spécifique `pre.002`
|
||||
|
||||
Surface introduite :
|
||||
|
||||
```text
|
||||
WsProtocolKind::HeliusLaserStream -> "helius_laserstream"
|
||||
SolanaStandardWsSession
|
||||
HeliusLaserStreamWsSession
|
||||
WsSession::connect_for_protocol -> crate-internal
|
||||
WsSession::connect_physical -> unique physical spawn path
|
||||
```
|
||||
|
||||
Canaries ajoutées/prévues dans la livraison :
|
||||
|
||||
```text
|
||||
[x] protocol descriptors distincts
|
||||
[x] façade standard publique + 9 délégations vers les wrappers 0.2.7
|
||||
[x] façade Helius publique + lifecycle partagé
|
||||
[x] generic WsSession::connect rejette Helius avant I/O
|
||||
[x] chaque façade rejette le mauvais protocol kind avant I/O
|
||||
[ ] les deux façades ouvrent/ferment une connexion contre un peer local via le même actor — test ajouté
|
||||
[ ] Debug Helius ne projette pas une query api-key canary — test ajouté
|
||||
[x] source de façade sans second spawn/socket/command actor
|
||||
[ ] compile-fail Helius blockSubscribe — doctest ajouté
|
||||
[ ] compile-fail Helius into_inner — doctest ajouté
|
||||
[ ] six wrappers standard Helius — `pre.003`
|
||||
```
|
||||
|
||||
Validation du sandbox de préparation :
|
||||
|
||||
```text
|
||||
python3 scripts/audit_rust_workspace_rules.py = clean
|
||||
cargo fmt/check/clippy/test = non exécutables dans le sandbox de préparation
|
||||
```
|
||||
|
||||
Les gates compilés opérateur de `pre.002` restent requis avant commit.
|
||||
|
||||
|
||||
Reference in New Issue
Block a user