175 lines
4.9 KiB
Markdown
175 lines
4.9 KiB
Markdown
<!-- file: deltas/0.2.8/pre.004.md -->
|
|
<!-- version: 1 -->
|
|
|
|
# Delta `0.2.8-pre.004` — Config V2 Helius LaserStream WebSocket
|
|
|
|
## 1. Objet
|
|
|
|
Cette tranche ouvre Config V2 au protocole WebSocket `helius_laserstream`, matérialise son mapping vers `WsProtocolKind::HeliusLaserStream` et prouve la résolution/redaction de la clé Helius sans modifier le moteur WebSocket ni commencer `transactionSubscribe`.
|
|
|
|
Le checkpoint opérateur de `pre.003` est intégralement vert.
|
|
|
|
Version workspace :
|
|
|
|
```text
|
|
0.2.8-pre.4
|
|
```
|
|
|
|
Livraison / commit attendu :
|
|
|
|
```text
|
|
0.2.8-pre.004
|
|
v0.2.8-pre.004
|
|
```
|
|
|
|
Aucun tag prerelease.
|
|
|
|
## 2. Discriminateur Config WebSocket
|
|
|
|
Le JSON Schema V2 accepte désormais exactement :
|
|
|
|
```text
|
|
solana_standard
|
|
helius_laserstream
|
|
```
|
|
|
|
L'adapter `ksp-config-lib` mappe :
|
|
|
|
```text
|
|
solana_standard -> WsProtocolKind::SolanaStandard
|
|
helius_laserstream -> WsProtocolKind::HeliusLaserStream
|
|
```
|
|
|
|
Le discriminateur reste possédé par `profiles[].ws_endpoints[].kind`; aucun alias ou contrat gRPC n'est introduit.
|
|
|
|
## 3. Fixture et exemple Helius
|
|
|
|
La fixture `ksp-config-lib` ajoute un second endpoint WebSocket :
|
|
|
|
```text
|
|
name = fixture_helius_ws
|
|
provider = helius
|
|
cluster = mainnet-beta
|
|
kind = helius_laserstream
|
|
url = wss://mainnet.helius-rpc.com/?api-key=${KSP_SECRET_HELIUS_API_KEY:-fixture-helius-key}
|
|
```
|
|
|
|
`config/examples/std.transport.example.json` remplace l'ancien second endpoint WebSocket provider générique par un exemple Helius explicite :
|
|
|
|
```text
|
|
name = mainnet_helius_ws
|
|
provider = helius
|
|
kind = helius_laserstream
|
|
url = wss://mainnet.helius-rpc.com/?api-key=${KSP_SECRET_HELIUS_API_KEY:-replace-me}
|
|
```
|
|
|
|
Le document canonique `config/std.transport.json` reste volontairement inchangé et standard-only : la configuration par défaut ne doit pas embarquer un endpoint provider nécessitant une credential factice.
|
|
|
|
## 4. Secret Helius et redaction
|
|
|
|
`.env.example` inventorie :
|
|
|
|
```text
|
|
KSP_SECRET_HELIUS_API_KEY
|
|
```
|
|
|
|
sous forme commentée avec placeholder non secret.
|
|
|
|
Un nouveau test Config injecte une clé canari et prouve :
|
|
|
|
```text
|
|
l'URL runtime contient la clé résolue
|
|
le protocol runtime vaut HeliusLaserStream
|
|
la projection safe_value redige /ws_endpoints/1/url
|
|
ResolvedTransportConfig Debug ne contient pas la clé
|
|
```
|
|
|
|
Config reste l'unique propriétaire de l'environnement. Transport ne lit pas `std::env`.
|
|
|
|
## 5. Composition Config -> Transport
|
|
|
|
La fixture principale vérifie maintenant deux endpoints WebSocket :
|
|
|
|
```text
|
|
fixture_private_ws -> SolanaStandard
|
|
fixture_helius_ws -> HeliusLaserStream
|
|
```
|
|
|
|
Le second endpoint est également passé au constructeur public `HeliusLaserStreamWsSession::connect` sans polling afin de verrouiller la compatibilité de types Config -> Transport. Les guards runtime du protocole restent propriétaires de Transport.
|
|
|
|
## 6. Documentation ciblée
|
|
|
|
`ksp-config-lib/USAGE.md` documente les deux valeurs `kind`, le namespace WebSocket du discriminateur Helius et l'ownership/redaction de `KSP_SECRET_HELIUS_API_KEY`.
|
|
|
|
Le plan reste propriétaire du forecast ; la validation reste propriétaire des critères et preuves. Aucun nouveau document/fichier fourre-tout n'est créé.
|
|
|
|
## 7. Hors périmètre préservé
|
|
|
|
Cette tranche ne modifie pas :
|
|
|
|
```text
|
|
config/std.transport.json
|
|
WsSession / actor / reconnect / queues
|
|
les six wrappers Helius standard acquis en pre.003
|
|
WsSubscriptionKind
|
|
transactionSubscribe / transactionUnsubscribe
|
|
transactionNotification
|
|
heartbeat provider
|
|
HTTP 52/14
|
|
Wallet / Store / Program
|
|
```
|
|
|
|
Aucune dépendance Rust n'est ajoutée.
|
|
|
|
## 8. Preuve opérateur héritée
|
|
|
|
Le checkpoint `pre.003` fourni le 2026-08-23 est :
|
|
|
|
```text
|
|
cargo fmt --all OK
|
|
python3 scripts/audit_rust_workspace_rules.py clean
|
|
cargo check --workspace OK
|
|
cargo clippy --workspace --all-targets OK
|
|
cargo test -p ksp-onchain-transport-lib OK
|
|
cargo test --workspace OK
|
|
```
|
|
|
|
Les preuves spécifiques Helius standard sont également vertes : 314 tests unitaires Transport, 38 public API, 26 release-completeness et 4 doctests compile-fail.
|
|
|
|
## 9. Fichiers de la livraison
|
|
|
|
Nouveau :
|
|
|
|
```text
|
|
deltas/0.2.8/pre.004.md
|
|
```
|
|
|
|
Modifiés :
|
|
|
|
```text
|
|
Cargo.toml
|
|
.env.example
|
|
config/examples/std.transport.example.json
|
|
config/schemas/std.transport.schema.json
|
|
crates/ksp-config-lib/src/transport.rs
|
|
crates/ksp-config-lib/unit_tests/fixtures/std.transport.json
|
|
crates/ksp-config-lib/unit_tests/transport.rs
|
|
crates/ksp-config-lib/USAGE.md
|
|
docs/plans/015-V0_2_8_HELIUS_LASERSTREAM_WEBSOCKET_PLAN.md
|
|
docs/validation/011-V0_2_8_HELIUS_LASERSTREAM_WEBSOCKET.md
|
|
```
|
|
|
|
## 10. Validation à exécuter
|
|
|
|
```bash
|
|
cargo fmt --all
|
|
python3 scripts/audit_rust_workspace_rules.py
|
|
cargo check --workspace
|
|
cargo clippy --workspace --all-targets
|
|
cargo test -p ksp-config-lib
|
|
cargo test -p ksp-onchain-transport-lib
|
|
cargo test --workspace
|
|
```
|
|
|
|
`pre.004` reste `PREPARED` jusqu'à réception de ce checkpoint.
|