v0.2.7-pre.009

docs/plans/014-V0_2_7_ONCHAIN_WEBSOCKET_PLAN.md

@@ -1,5 +1,5 @@
 <!-- file: docs/plans/014-V0_2_7_ONCHAIN_WEBSOCKET_PLAN.md -->
-<!-- version: 10 -->
+<!-- version: 11 -->
 
 # Plan `0.2.7` — WebSocket Solana standard
 
@@ -780,6 +780,36 @@ Définir des DTOs WS dédiés pour : enveloppes notification, lifecycle, subscri
 
 Pour unstable/évolutif, préférer des enums avec fallback `Unknown { type_name, raw }` borné plutôt qu'un rejet session-wide d'un variant upstream nouveau.
 
+### 16.1 Checkpoint wrappers stables lot A `pre.009`
+
+Le premier lot public conserve exactement les options retenues par l'audit :
+
+```text
+accountSubscribe
+  pubkey
+  encoding = binary | base58 | base64 | jsonParsed | base64+zstd
+  dataSlice
+  commitment
+  minContextSlot non exposé : champ upstream partagé mais ignoré par le handler PubSub v4.2.1
+
+programSubscribe
+  program pubkey
+  mêmes encoding/dataSlice/commitment account
+  filters = dataSize | memcmp | tokenAccountState
+  withContext omitted/false/true
+  sortResults non exposé : option HTTP non consommée par le handler PubSub audité
+  notification = keyed account bare OU RpcResponse<KeyedAccount>
+
+logsSubscribe
+  filter = all | allWithVotes | mentions exactement une pubkey
+  commitment
+  notification = RpcResponse<{ signature, err nullable, logs ordonnés }>
+```
+
+Les wrappers publics sont `WsSession::account_subscribe`, `WsSession::program_subscribe` et `WsSession::logs_subscribe`. Ils retournent tous `WsSubscription<T>` et réutilisent donc sans duplication le registry local, le remapping remote/local, le reconnect/resubscribe, le backpressure et l'unsubscribe par handle. Le constructeur générique `subscribe_typed` reste `pub(crate)` et aucune méthode provider-extension arbitraire n'entre dans l'API publique.
+
+La forme `Mentions(Pubkey)` rend la cardinalité `mentions == 1` vraie par construction. Les contraintes déterministes déjà retenues pour les filtres programme sont conservées côté WS : maximum quatre filtres et maximum 128 octets pour la variante raw `Bytes` de `memcmp`; les formes encodées restent laissées au runtime upstream comme sur la surface HTTP existante.
+
 ## 17. API générique provider-specific
 
 Le moteur interne doit encoder une spec générique `subscribe_method + unsubscribe_method + params + decoder`, afin qu'une release provider-specific puisse réutiliser la session.
@@ -887,7 +917,7 @@ pre.005  DONE — limites frame/message/request + control frames + cancellation/
 pre.006  DONE — registry subscriptions + IDs locaux + generic subscribe/unsubscribe engine + channels typed bounded
 pre.007  DONE — reconnect borné + resubscribe déterministe + continuity gap + races unsubscribe/reconnect
 pre.008  DONE — backpressure per-sub + overflow/limits + causes terminales sûres + leak/lifecycle adversarial tests
-pre.009  wrappers stable lot A : account + program + logs, DTOs/options/KSP-TRANSPORT-007
+pre.009  DONE — wrappers stable lot A : account + program + logs, DTOs/options/KSP-TRANSPORT-007
 pre.010  wrappers stable lot B : signature + slot + root, terminaison signature/KSP-TRANSPORT-007
 pre.011  unstable : block + slotsUpdates + vote, warnings + fallbacks wire/KSP-TRANSPORT-007
 pre.012  compliance 18/18 + canaries public API + composition Config + régressions HTTP