v0.2.9-pre.004

docs/plans/016-V0_2_9_YELLOWSTONE_GRPC_PLAN.md

@@ -1,9 +1,9 @@
 <!-- file: docs/plans/016-V0_2_9_YELLOWSTONE_GRPC_PLAN.md -->
-<!-- version: 9 -->
+<!-- version: 10 -->
 
 # Plan `0.2.9` — moteur Yellowstone gRPC + standard Solana + PublicNode
 
-> **Statut : `0.2.9-pre.003-fix.001` — `pre.002-fix.002` est fermée sur gate opérateur intégralement vert. Le premier gate `pre.003` confirme fmt/audit/check, les 354 unit tests Transport, 43 public API, 36 completeness, 4 doctests, le dependency canary et le workspace complet ; seul Clippy échoue sur `implicit_return` dans la fixture `#[tonic::async_trait]` et deux closures metadata. `fix.001` corrige uniquement cette conformité de test, sans changement du moteur/TLS/metadata/unary de production. `pre.003` ajoute uniquement TLS client, metadata générique redacted, connexion HTTP/2 réelle, fixture Geyser locale et les sept unary standard ; `Subscribe`, PublicNode et Config V3 restent hors tranche. `0.2.9` reste bornée à un moteur client Yellowstone partagé, une façade Solana Yellowstone standard et une première intégration concrète PublicNode. Seuls OrbitFlare puis Helius LaserStream gRPC sont actuellement planifiés comme releases provider suivantes ; les autres providers restent en TODO/IDEAS sans numéro réservé. Chaque prerelease vise 15–20 minutes de travail effectif et la release complète doit rester clôturable dans une seule session de chat.**
+> **Statut : `0.2.9-pre.004` candidate. `pre.003-fix.001` est fermée sur gate opérateur intégralement vert : fmt/audit/check/Clippy/workspace PASS, Transport 354 unit + 43 public API + 36 completeness + 4 doctests, et graphes Cargo inspectés sans seconde version Tonic/Prost/Solana. `pre.004` matérialise uniquement la fondation `SubscribeRequest` standard : sept maps nommées, commitment, account-data slices ordonnées, ping, `from_slot`, bornes communes, unicité globale des noms et Debug sans payload arbitraire. Les champs détaillés Accounts/Slots/Transactions/Blocks restent réservés à `pre.005–007` et aucun stream bidi n'est encore ouvert. PublicNode et Config V3 restent hors tranche. `0.2.9` reste bornée à un moteur client Yellowstone partagé, une façade Solana Yellowstone standard et une première intégration concrète PublicNode. Seuls OrbitFlare puis Helius LaserStream gRPC sont actuellement planifiés comme releases provider suivantes ; les autres providers restent en TODO/IDEAS sans numéro réservé. Chaque prerelease vise 15–20 minutes de travail effectif et la release complète doit rester clôturable dans une seule session de chat.**
 
 ## 1. Objet, base et état d'ouverture
 
@@ -431,7 +431,18 @@ ping?                id
 from_slot?           u64
 ```
 
-KSP appliquera des bornes déterministes avant I/O sur les noms, cardinalités, listes de comptes/owners, memcmp, data slices et tailles de payload. Les valeurs exactes sont un contrat KSP et non une copie aveugle des quotas d'un provider ; elles seront matérialisées avec tests en `pre.004`.
+KSP applique des bornes déterministes avant I/O sur les noms, cardinalités, listes de comptes/owners, memcmp, data slices et tailles de payload. Les valeurs exactes sont un contrat KSP et non une copie aveugle des quotas d'un provider. `pre.004` matérialise les bornes communes suivantes :
+
+```text
+filter groups nommés, total  <= 1024 sur les sept maps
+filter name                  non vide, trim exact, sans caractère de contrôle, <= 128 octets
+filter names                 uniques globalement entre les sept maps
+accounts_data_slice count    <= 128
+accounts_data_slice length   <= 64 MiB
+offset + length              aucun overflow u64
+```
+
+Les bornes account/owner/include/exclude/required, memcmp et Cuckoo restent volontairement dans les tranches de famille `pre.005–007`.
 
 ## 8. Matrice `SubscribeUpdate`
 
@@ -905,11 +916,11 @@ pre.001  DONE — audit upstream/service/proto + providers gratuits + licences/d
 pre.002  DONE — moteur Yellowstone : proto/dependencies + settings/errors + channel minimal
          budget : 15–20 min ; gate final fix.002 : fmt/audit/check/Clippy + Transport 346/42/35/4 + dependency canary + workspace PASS
 
-pre.003  FIX.001 CANDIDATE — moteur TLS/metadata + façade N2 unary + fixture locale + 7 unary RPCs
-         budget : 15–20 min ; preuve cible : connect/TLS/timeouts/Status safe + metadata redacted + wire unary exact + cargo tree
+pre.003  DONE — moteur TLS/metadata + façade N2 unary + fixture locale + 7 unary RPCs
+         budget : 15–20 min ; gate final fix.001 : fmt/audit/check/Clippy/workspace PASS + graphes Cargo inspectés
 
-pre.004  standard Solana : Subscribe foundation + maps/commitment/ping/from_slot/data slices/bounds
-         budget : 15–20 min ; preuve : omitted/empty/oneof exact + rejets avant I/O
+pre.004  CANDIDATE — standard Solana : Subscribe foundation + maps/commitment/ping/from_slot/data slices/bounds
+         budget : 15–20 min ; preuve : map vide/entrée nommée vide/common wire exact + rejets déterministes avant I/O
 
 pre.005  standard Solana : Accounts + Slots filters/updates
          budget : 15–20 min ; preuve : fixtures exactes + enum/optional/malformed/adversarial
@@ -973,14 +984,16 @@ crates/ksp-onchain-transport-lib/unit_tests/grpc_unary.rs
 crates/ksp-onchain-transport-lib/src/grpc_channel.rs
 crates/ksp-onchain-transport-lib/src/grpc_settings.rs
 
-# pre.004+
-crates/ksp-onchain-transport-lib/src/grpc_session.rs
-crates/ksp-onchain-transport-lib/src/grpc_protocol.rs
+# pre.004
 crates/ksp-onchain-transport-lib/src/grpc_subscribe.rs
-crates/ksp-onchain-transport-lib/src/grpc_updates.rs
-unit_tests/ correspondants
+crates/ksp-onchain-transport-lib/unit_tests/grpc_subscribe.rs
 tests/public_api.rs
 tests/release_completeness.rs
+
+# pre.005+
+crates/ksp-onchain-transport-lib/src/grpc_session.rs
+crates/ksp-onchain-transport-lib/src/grpc_updates.rs
+unit_tests/ correspondants
 tests/yellowstone_grpc_*_smoke.rs
 crates/ksp-config-lib/src/transport.rs
 config/std.transport.json