2.6 KiB
Prompt de démarrage 0.2.7 — WebSocket Solana standard
1. Contexte de reprise
Base attendue : tag stable v0.2.6.
0.2.6 a validé Wallet Desk puis intégré le wire binaire .kspwallet V2, les APIs Wallet génériques/versionnées, la compatibilité V1/V2, les migrations explicites et le runtime packagé commun des Desks sans dépendance au checkout source. 0.2.7 revient donc à la séquence Transport prévue avant l'intercalation temporaire du chantier binaire.
La release à ouvrir est :
0.2.7 — WebSocket Solana standard
0.2.7-pre.001 commence obligatoirement par audit officiel actuel + inventory exhaustif des subscriptions/unsubscriptions/notifications + threat-model/reconnexion + sizing avant implémentation lourde.
2. Mission
Étendre ksp-onchain-transport-lib à la surface WebSocket Solana standard retenue, sans déplacer Config dans Transport et sans introduire encore Helius LaserStream.
Contrat de sessions :
une même URL peut porter plusieurs sessions physiques
une session peut porter plusieurs subscriptions
pas de pool/scheduler automatique complexe sans besoin démontré
reconnexion bornée et états de subscription explicites
notifications typées sans fuite d'URL/secrets dans Debug/logs
3. Frontières
Conserver :
Transport -X-> Config
Transport -X-> Wallet
Transport -X-> Store
Transport -X-> tracing direct
Config -> Transport autorisé
ksp-logging-lib seul propriétaire des émissions applicatives
4. Audit pre.001
Auditer au minimum :
- documentation Solana/Agave actuelle ;
- méthodes subscribe/unsubscribe courantes, deprecated/unstable et notifications associées ;
- formes de paramètres/options et réponses ;
- reconnexion, resubscribe, backpressure, cancellation et shutdown ;
- plusieurs sessions pour une même URL ;
- limites provider utiles sans les figer comme règles Solana universelles ;
- dépendances WebSocket Rust actuelles et leur graphe ;
- sizing « une release = une session ».
5. Hors périmètre
Helius LaserStream WebSocket -> 0.2.8
Yellowstone gRPC
Store/materialization
Wallet/2FA
pool automatique sophistiqué de sessions WebSocket
frontend réseau direct
6. Validation
cargo fmt --all
python3 scripts/audit_rust_workspace_rules.py
cargo check --workspace
cargo clippy --workspace --all-targets
cargo test -p ksp-onchain-transport-lib
cargo test --workspace
Prévoir des fixtures déterministes et un smoke réseau opt-in seulement lorsqu'une composition réelle le justifie.