v0.2.7-pre.006

docs/validation/010-V0_2_7_ONCHAIN_WEBSOCKET.md

@@ -1,5 +1,5 @@
 <!-- file: docs/validation/010-V0_2_7_ONCHAIN_WEBSOCKET.md -->
-<!-- version: 7 -->
+<!-- version: 8 -->
 
 # Validation `0.2.7` — WebSocket Solana standard
 
@@ -377,6 +377,39 @@ cycles connect/close répétés -> terminaison bornée
 
 Le signal de shutdown est indépendant de la command queue et les opérations socket longues de l'actor surveillent ce signal. Aucun reconnect/resubscribe n'est activé par cette tranche.
 
+## 9.4 Checkpoint registry subscriptions `pre.006`
+
+Surface matérialisée :
+
+```text
+WsSubscription<T>                     handle public typed
+WsSubscriptionId                      local stable, actor-assigned
+remote subscription id                interne/transient uniquement
+registry local                        BTreeMap ordonnée par local ID
+remote -> local                        mapping actor-owned
+subscribe generic                     crate-private, wrappers publics futurs
+unsubscribe                           handle public, bool Solana préservé
+notification queue                    typed + bounded
+reconnect/resubscribe                 non, pre.007
+backpressure adversarial complet      non, pre.008
+```
+
+Gates déterministes ajoutés :
+
+```text
+subscribe ACK -> binding remote/local atomique
+notification -> bonne subscription typed
+2 familles -> IDs locaux 1 puis 2, remote IDs indépendants
+unknown/stale remote ID -> safe drop, session Active
+notification method mismatch -> subscription Failed seulement
+typed decoder failure -> erreur livrée + subscription Failed seulement
+unsubscribe -> exact *Unsubscribe avec remote ID interne
+unsubscribe bool -> préservé au caller
+snapshot -> local IDs + remote_bound uniquement
+```
+
+Le registry est détenu par le même actor que le socket et la pending map JSON-RPC. Aucun caller ne manipule le socket ni le remote ID. Les wrappers publics `accountSubscribe`, `programSubscribe`, etc. restent volontairement différés aux lots `pre.009+` afin de ne pas exposer une API raw provider-extension intermédiaire.
+
 ## 10. Validation du gate `pre.001`
 
 Exécuté dans le sandbox :