Sasedev/khadhroony-solana-project
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

v0.2.8-pre.011

Browse Source
This commit is contained in:
SinuS von SifriduS
2026-08-23 20:01:28 +02:00
parent d8bfd7cd2e
commit 7cdf5e80c9
10 changed files with 1671 additions and 24 deletions
Download Patch File Download Diff File Expand all files Collapse all files

4
docs/000-README.md
View File

File diff suppressed because one or more lines are too long

4
docs/plans/000-README.md
View File

@@ -1,5 +1,5 @@
<!-- file: docs/plans/000-README.md -->
<!-- version: 57 -->
<!-- version: 58 -->
# Plans KSP
@@ -23,7 +23,7 @@ Un plan décrit le périmètre, les décisions déjà acquises, les questions ou
- [`012-V0_2_5_WALLET_FOUNDATION_PLAN.md`](012-V0_2_5_WALLET_FOUNDATION_PLAN.md) — plan historique clôturé de la release stable `0.2.5 — Wallet foundation`, ouvert par `pre.001`, livré jusqu’à `pre.010`, renforcé par `pre.010-fix.001`–`fix.003` pour Dalek 3 et la normalisation Rust/audit structurel, puis publié par `rel.001`; il couvre `.kspwallet` V1, VIEW/OWNER, crypto, persistence, administration, transfer et compliance.
- [`013-V0_2_6_WALLET_DESK_PLAN.md`](013-V0_2_6_WALLET_DESK_PLAN.md) — plan historique clôturé de la release stable `0.2.6 — Wallet Desk`, ouvert par `pre.001`, étendu en `pre.015`–`pre.017` au wire binaire `.kspwallet` V2, aux APIs multi-version et à la migration V1 -> V2, puis fermé par `pre.018`/`fix.001` avec le runtime Tauri packagé et le build final vert avant publication `rel.001`.
- [`014-V0_2_7_ONCHAIN_WEBSOCKET_PLAN.md`](014-V0_2_7_ONCHAIN_WEBSOCKET_PLAN.md) — plan historique clôturé de la release stable `0.2.7 — WebSocket Solana standard`, ouvert par `pre.001`, exécuté jusqu’à `pre.014`, corrigé documentairement par `pre.014-fix.001` puis publié par `rel.001`; il conserve l’inventaire officiel 18 méthodes, le modèle session/subscription, le threat model, les preuves de compliance/smoke/dépendances et la préparation de `0.2.8`.
- [`015-V0_2_8_HELIUS_LASERSTREAM_WEBSOCKET_PLAN.md`](015-V0_2_8_HELIUS_LASERSTREAM_WEBSOCKET_PLAN.md) — plan actif de `0.2.8 — Helius LaserStream WebSocket`, ouvert par `pre.001`; il conserve l’audit Helius du 23 août 2026, la matrice provider, le choix `HeliusLaserStream`, la stratégie transaction/heartbeat/Config/secrets et le forecast souple recalibré.
- [`015-V0_2_8_HELIUS_LASERSTREAM_WEBSOCKET_PLAN.md`](015-V0_2_8_HELIUS_LASERSTREAM_WEBSOCKET_PLAN.md) — plan candidat de `0.2.8 — Helius LaserStream WebSocket`, ouvert par `pre.001` et fermé techniquement/documentairement jusqu’à `pre.011`; il conserve la surface finale Helius `7 standard + transaction`, heartbeat/Config/secrets, l’historique des fixes heartbeat, la stratégie live architecture-safe, les graphes Cargo finaux et la préparation du prompt `0.2.9`.
Le `pre.001` de chaque release fonctionnelle peut introduire son propre plan détaillé lorsque la release s'ouvre.

8
docs/plans/002-FUNCTIONAL_RELEASE_SEQUENCE.md
View File

@@ -1,5 +1,5 @@
<!-- file: docs/plans/002-FUNCTIONAL_RELEASE_SEQUENCE.md -->
<!-- version: 83 -->
<!-- version: 84 -->
# Séquence des releases fonctionnelles KSP
@@ -465,11 +465,11 @@ La candidate atteint `pre.014` après matérialisation des 9 familles standard,
### `0.2.8` — Helius LaserStream WebSocket
Mission active : étendre le moteur WebSocket standard avec la surface Helius LaserStream WebSocket actuelle sans copier le client/session actor. Le gate `pre.001` est conservé dans [`015-V0_2_8_HELIUS_LASERSTREAM_WEBSOCKET_PLAN.md`](015-V0_2_8_HELIUS_LASERSTREAM_WEBSOCKET_PLAN.md) et la matrice active dans [`../validation/011-V0_2_8_HELIUS_LASERSTREAM_WEBSOCKET.md`](../validation/011-V0_2_8_HELIUS_LASERSTREAM_WEBSOCKET.md).
Mission candidate : étendre le moteur WebSocket standard avec la surface Helius LaserStream WebSocket actuelle sans copier le client/session actor. Le gate et l'historique complet sont conservés dans [`015-V0_2_8_HELIUS_LASERSTREAM_WEBSOCKET_PLAN.md`](015-V0_2_8_HELIUS_LASERSTREAM_WEBSOCKET_PLAN.md) et la matrice candidate dans [`../validation/011-V0_2_8_HELIUS_LASERSTREAM_WEBSOCKET.md`](../validation/011-V0_2_8_HELIUS_LASERSTREAM_WEBSOCKET.md).
L'audit Helius du 23 août 2026 retient `helius_laserstream` comme nouveau protocol kind : les six familles standard `account/logs/program/root/signature/slot` réutilisent les wrappers publiés, tandis que `block/slotsUpdates/vote` sont rejetées avant I/O sur Helius selon l'index provider exhaustif. `transactionSubscribe`/`transactionUnsubscribe` et `tokenAccounts` constituent la nouvelle surface typed principale. `notifyOn`, désormais deprecated et no-op depuis Agave 4.2, n'est pas exposé. Un heartbeat Helius-only est planifié dans l'actor existant pour le timeout d'inactivité provider.
Le réaudit final Helius du 23 août 2026 retient `helius_laserstream` comme protocol kind WebSocket : les sept familles standard `account/logs/program/root/signature/slot/slotsUpdates` réutilisent les wrappers publiés, `block/vote` restent absents et `transactionSubscribe`/`transactionUnsubscribe` constitue l'extension provider-specific. `slotsUpdates` conserve son statut unstable, `notifyOn` deprecated/no-op n'est pas exposé et le heartbeat Helius-only envoie un WebSocket Ping control frame toutes les 60 secondes depuis l'actor partagé.
Le forecast souple est recalibré jusqu'à `pre.010` avant `rel.001`; le numéro final reste non contractuel. Aucun SDK Helius, aucune dépendance gRPC et aucun replay historique WebSocket ne sont introduits.
`pre.010` ferme README/USAGE, la stratégie smoke live architecture-safe et les graphes Cargo finaux ; `pre.011` prépare la candidate documentaire et [`../../prompts/014-V0_2_9_START_PROMPT.md`](../../prompts/014-V0_2_9_START_PROMPT.md). Aucun SDK Helius, aucune dépendance gRPC et aucun replay historique WebSocket ne sont introduits. La publication stable reste réservée à `rel.001`.
### `0.2.9` — Yellowstone gRPC standard

112
docs/plans/015-V0_2_8_HELIUS_LASERSTREAM_WEBSOCKET_PLAN.md
View File

@@ -1,9 +1,9 @@
<!-- file: docs/plans/015-V0_2_8_HELIUS_LASERSTREAM_WEBSOCKET_PLAN.md -->
<!-- version: 24 -->
<!-- version: 25 -->
# Plan `0.2.8` — Helius LaserStream WebSocket
> **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.**
> **Statut : `0.2.8-pre.010` est validé intégralement par l’opérateur : fmt/audit/check/Clippy, 335 unit Transport, 41 API, 34 completeness, 4 doctests, workspace complet et trois audits `cargo tree` exécutés. `0.2.8-pre.011` prépare la candidate documentaire finale, ferme plan/matrice/indexes et crée le prompt autonome `0.2.9`.**
## 1. Objet, base et état courant
@@ -41,14 +41,15 @@ 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 validé
pre.009 compliance provider/current + slotsUpdates Helius validé
pre.010 documentation/smoke policy/cargo tree final — préparé
pre.010 documentation/smoke policy/cargo tree final validé
pre.011 clôture candidate plan/matrice/indexes + prompt 0.2.9 — préparé
workspace.package.version courant = 0.2.8-pre.10
commit attendu = v0.2.8-pre.010
workspace.package.version courant = 0.2.8-pre.11
commit attendu = v0.2.8-pre.011
aucun tag prerelease
```
Le checkpoint opérateur de `pre.003` est intégralement vert : `cargo fmt`, audit Rust, `cargo check --workspace`, `cargo clippy --workspace --all-targets`, tests Transport et `cargo test --workspace`. Les six familles standard Helius sont donc acquises sans dette de gate avant l'ouverture de Config Helius en `pre.004`.
Le checkpoint opérateur de `pre.010` est intégralement vert, y compris les trois audits `cargo tree`. La candidate `pre.011` ne rouvre aucune capacité runtime : elle synchronise uniquement la documentation de clôture et le contrat de démarrage `0.2.9`.
## 2. Forecast souple courant
@@ -82,9 +83,9 @@ pre.007 DONE — heartbeat Helius WebSocket/idle + timers + interaction reconne
pre.008 DONE — provider adversarial lifecycle + capability guards + payload/backpressure + security/redaction
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 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
pre.010 DONE — stratégie smoke Helius live fermée sans nouveau cross-crate owner + README/USAGE
+ cargo tree direct/duplicates final exécutés et inspectés
pre.011 PREPARED — validation workspace finale + fermeture plan/matrice/indexes + prompt 0.2.9 autonome
rel.001 publication stable stricte
```
@@ -1523,3 +1524,96 @@ cargo tree --duplicates
`pre.011` reste bloqué jusqu’au gate complet et à l’inspection de ces graphes.
## 23. Fermeture `pre.010` et préparation `pre.011`
### 23.1 Gate opérateur `0.2.8-pre.10`
Le checkpoint opérateur du 23 août 2026 est intégralement vert :
```text
[x] cargo fmt --all
[x] python3 scripts/audit_rust_workspace_rules.py
General Rust rule audit: clean
Rust export completeness audit: 0 candidate(s)
KSP workspace Rust rule audit: clean
[x] cargo check --workspace
[x] cargo clippy --workspace --all-targets
[x] Transport unit = 335/335
[x] Transport public API = 41/41
[x] release completeness = 34/34
[x] Transport doctests = 4/4
[x] cargo test --workspace
[x] cargo tree -p ksp-onchain-transport-lib
[x] cargo tree -p ksp-onchain-transport-lib --duplicates
[x] cargo tree --duplicates
```
Le graphe Transport direct reste centré sur les dépendances déjà acquises (`futures-util`, `reqwest`, `serde`, `serde_json`, `tokio`, `tokio-tungstenite`, Core et Logging). Aucun SDK Helius/gRPC ni dépendance Config inverse n'apparaît.
Doublons ciblés Transport observés :
```text
syn 2.x / 3.x
webpki-roots 0.26.x / 1.x
```
Ils sont transitifs et non bloquants. Le graphe workspace complet expose d'autres duplications transitives provenant principalement de Tauri/GTK, JSON Schema et des stacks crypto Wallet/Solana ; aucune dérive nouvelle propre à `0.2.8` n'est identifiée.
Verdict : **`pre.010` DONE.**
### 23.2 Clôture documentaire `pre.011`
`pre.011` ne doit ajouter aucune capacité runtime Helius. Sa mission est :
```text
workspace.package.version = 0.2.8-pre.11
fermer le plan et la matrice au niveau candidate
synchroniser les index documentaires devenus obsolètes
créer prompts/014-V0_2_9_START_PROMPT.md
conserver ROADMAP/CHANGELOG pour la publication stable rel.001
rejouer le gate workspace final
```
Le prompt `0.2.9` est construit conformément à `docs/rules/PROMPT_STRUCTURE.md` et comparé aux prompts `0.2.5`–`0.2.8`. Il conserve notamment :
```text
base stable exacte et archive opérateur autoritaire
ordre de lecture interne obligatoire
sources externes Yellowstone à réauditer
état HTTP/WS/Helius à préserver
frontières Config/Transport/provider-neutral
questions ouvertes dependencies/proto/licence/lifecycle
première mission pre.001 audit/brainstorming/sizing obligatoire
prévision souple initiale détaillée et recalibrable
workflow version/delta/commit/archive/tag
validation Rust/cargo tree/smoke
critères de clôture
instruction d'ouverture interdisant le client lourd avant gate
```
Le réaudit préparatoire Yellowstone du 23 août 2026 confirme que l'upstream évolue rapidement (`Subscribe`, unary RPCs, replay, filtres enrichis et extensions deshred). Le prompt n'en fait aucun pin : il impose à `0.2.9-pre.001` de réauditer release, proto, crates, MSRV, features et licences avant de choisir les dépendances.
Critères `pre.011` :
```text
[ ] workspace.package.version = 0.2.8-pre.11
[ ] aucun code runtime Helius modifié
[ ] aucune nouvelle dépendance
[ ] prompt 0.2.9 autonome présent
[ ] prompt suit les 16 rubriques normatives de PROMPT_STRUCTURE
[ ] forecast 0.2.9 visible, détaillé et explicitement souple
[ ] prompt impose audit licence/dependencies avant Yellowstone/Tonic/Prost
[ ] prompt distingue Yellowstone standard des providers et de deshred/pré-exécution
[ ] docs/000, plans/000, validation/000, prompts/000 et séquence fonctionnelle synchronisés
[ ] ROADMAP non marqué stable avant rel.001
[ ] CHANGELOG non utilisé comme journal de prerelease
[ ] cargo fmt --all
[ ] audit Rust workspace clean
[ ] cargo check --workspace sans warning
[ ] cargo clippy --workspace --all-targets sans warning
[ ] cargo test -p ksp-onchain-transport-lib
[ ] cargo test --workspace
```
Si ce gate est vert, la prochaine livraison est `0.2.8-rel.001`; aucune `pre.012` n'est nécessaire sauf défaut réel.

4
docs/validation/000-README.md
View File

@@ -1,5 +1,5 @@
<!-- file: docs/validation/000-README.md -->
<!-- version: 21 -->
<!-- version: 22 -->
# Validations KSP
@@ -19,4 +19,4 @@ Documents :
- [`008-V0_2_5_WALLET_SECURITY_COMPLIANCE.md`](008-V0_2_5_WALLET_SECURITY_COMPLIANCE.md) — matrice finale validée de la release stable `0.2.5`, threat model V1, canaris adversariaux, reproduction externe des vecteurs, audit de frontières, normalisation Rust/audit structurel, graphes Cargo et checkpoint final `pre.010-fix.003` vert.
- [`009-V0_2_6_WALLET_DESK_COMPLIANCE.md`](009-V0_2_6_WALLET_DESK_COMPLIANCE.md) — matrice finale validée de la release stable `0.2.6`, couvrant Wallet Desk, les wires V1/V2, la migration explicite, le runtime Tauri packagé, les frontières sécurité/ownership et le gate opérateur `pre.018-fix.001` avec build final Linux vert.
- [`010-V0_2_7_ONCHAIN_WEBSOCKET.md`](010-V0_2_7_ONCHAIN_WEBSOCKET.md) — matrice finale validée de la release stable `0.2.7`, ouverte par `pre.001`, fermée techniquement par `pre.014` puis publiée par `rel.001` : inventaire 9 subscribe + 9 unsubscribe, lifecycle borné, statuts unstable, compliance 18/18, non-régression HTTP 52+14, composition Config V2, smoke WebSocket Devnet et audit de dépendances.
- [`011-V0_2_8_HELIUS_LASERSTREAM_WEBSOCKET.md`](011-V0_2_8_HELIUS_LASERSTREAM_WEBSOCKET.md) — matrice active de `0.2.8`, ouverte par `pre.001` : support Helius par famille, `transactionSubscribe`/`transactionUnsubscribe`, `tokenAccounts`, `notifyOn` deprecated/no-op, capability validation, heartbeat provider, secrets et non-régressions Transport/Config.
- [`011-V0_2_8_HELIUS_LASERSTREAM_WEBSOCKET.md`](011-V0_2_8_HELIUS_LASERSTREAM_WEBSOCKET.md) — matrice candidate finale de `0.2.8`, ouverte par `pre.001` et consolidée jusqu’à `pre.011` : Helius `account/logs/program/root/signature/slot/slotsUpdates + transaction`, `block/vote` absents, heartbeat provider, sécurité/redaction, lifecycle adversarial, non-régressions HTTP/WS, stratégie smoke live et graphes Cargo finaux.

71
docs/validation/011-V0_2_8_HELIUS_LASERSTREAM_WEBSOCKET.md
View File

@@ -1,9 +1,9 @@
<!-- file: docs/validation/011-V0_2_8_HELIUS_LASERSTREAM_WEBSOCKET.md -->
<!-- version: 23 -->
<!-- version: 24 -->
# Validation `0.2.8` — Helius LaserStream WebSocket
> **Statut : `pre.009` est entièrement vert : 335/335 unit Transport, 41/41 API, 33/33 completeness, 4/4 doctests et workspace complet. `pre.010` est préparé pour synchroniser README/USAGE, verrouiller la stratégie de smoke live architecture-safe et rejouer le cargo tree final.**
> **Statut : `pre.010` est entièrement vert : 335/335 unit Transport, 41/41 API, 34/34 completeness, 4/4 doctests, workspace complet et audits Cargo tree exécutés. `pre.011` est la candidate documentaire finale : matrice/indexes fermés et prompt `0.2.9` autonome préparé avant `rel.001`.**
## 1. Références
@@ -32,6 +32,7 @@ pre.007 dependency-firewall fix deltas/0.2.8/pre.007-fix.004.md
pre.008 adversarial/compliance guard deltas/0.2.8/pre.008.md
pre.009 compliance provider/current deltas/0.2.8/pre.009.md
pre.010 docs/smoke/tree final deltas/0.2.8/pre.010.md
pre.011 candidate/prompt deltas/0.2.8/pre.011.md
validation standard WS docs/validation/010-V0_2_7_ONCHAIN_WEBSOCKET.md
HTTP compliance docs/validation/007-V0_2_4_HTTP_FINAL_COMPLIANCE.md
KSP-TRANSPORT-007 docs/validation/005-V0_2_3_KSP_TRANSPORT_007_RETRO_AUDIT.md
@@ -1057,3 +1058,69 @@ Le smoke live Helius est donc **différé vers la future surface d’intégratio
Verdict courant : **`pre.010` PREPARED ; `pre.011` bloqué jusqu’au gate opérateur et au cargo tree final.**
## 25. Gate `pre.010` fermé et candidate `pre.011`
### 25.1 Preuves opérateur `pre.010`
```text
[x] cargo fmt --all
[x] audit Rust = 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 = 34/34
[x] Transport doctests = 4/4
[x] cargo test --workspace = vert
[x] cargo tree Transport direct = exécuté
[x] cargo tree Transport duplicates = exécuté
[x] cargo tree workspace duplicates = exécuté
```
Audit graphe :
```text
Transport direct : aucune dépendance nouvelle Helius/gRPC/Config
Transport duplicates ciblés : syn 2/3 + webpki-roots 0.26/1.0, transitifs
workspace duplicates : transitifs historiques Tauri/GTK/JSON Schema/crypto, non introduits par pre.010
```
Verdict : **`pre.010` DONE.**
### 25.2 Candidate `pre.011`
La clôture candidate doit prouver :
```text
[ ] version Cargo pre.11
[ ] zéro changement runtime provider
[ ] matrice Helius finale cohérente : 7 standard + transaction ; block/vote absents
[ ] Standard WS 18/18 et HTTP 52+14 conservés
[ ] stratégie smoke live différée vers intégration/orchestration conservée
[ ] dependency graph final enregistré comme non bloquant
[ ] prompts/014-V0_2_9_START_PROMPT.md présent
[ ] prompt 0.2.9 conforme PROMPT_STRUCTURE et autonome
[ ] prompt 0.2.9 contient un forecast souple détaillé
[ ] prompt 0.2.9 impose le gate audit/sizing avant client gRPC lourd
[ ] prompt 0.2.9 impose audit licence/MSRV/features/transitifs
[ ] prompt distingue standard Yellowstone, provider adapters et deshred/pré-exécution
[ ] index docs/plans/validation/prompts synchronisés
[ ] workspace complet vert
```
État fonctionnel candidat `0.2.8` :
```text
HTTP 52 current + 14 historical
Solana Standard WebSocket 9 familles / 18 opérations
Helius common account/logs/program/root/signature/slot/slotsUpdates
Helius extension transactionSubscribe/unsubscribe
Helius unsupported block/vote
heartbeat Ping control frame / 60 s / Helius only
Config V2 helius_laserstream + secret provenance/redaction
actor WsSession physique unique partagé
smoke provider live reporté vers future intégration/orchestration
```
Le prompt suivant vise `0.2.9 — Yellowstone gRPC standard/provider-neutral`. La release stable n'est pas encore publiée à `pre.011`; `ROADMAP.md` et `CHANGELOG.md` restent donc à finaliser dans `rel.001`.