83 lines
2.5 KiB
Markdown
83 lines
2.5 KiB
Markdown
<!-- file: prompts/012-V0_2_7_START_PROMPT.md -->
|
|
<!-- version: 2 -->
|
|
|
|
# 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 et les migrations explicites. `0.2.7` revient donc à la séquence Transport prévue avant l'intercalation temporaire du chantier binaire.
|
|
|
|
La release à ouvrir est :
|
|
|
|
```text
|
|
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 :
|
|
|
|
```text
|
|
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 :
|
|
|
|
```text
|
|
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
|
|
|
|
```text
|
|
Helius LaserStream WebSocket -> 0.2.8
|
|
Yellowstone gRPC
|
|
Store/materialization
|
|
Wallet/2FA
|
|
pool automatique sophistiqué de sessions WebSocket
|
|
frontend réseau direct
|
|
```
|
|
|
|
## 6. Validation
|
|
|
|
```bash
|
|
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.
|