v0.2.3-pre.005

docs/plans/010-V0_2_3_HTTP_TRANSACTIONS_PLAN.md

@@ -1,5 +1,5 @@
 <!-- file: docs/plans/010-V0_2_3_HTTP_TRANSACTIONS_PLAN.md -->
-<!-- version: 3 -->
+<!-- version: 4 -->
 
 # Plan `0.2.3` — HTTP Transactions
 
@@ -217,6 +217,30 @@ fige donc pas artificiellement le type public sur une liste de versions sériali
 Pour la **sortie** `getTransaction`, le wire doit rester plus large : `base58`, `base64`, `json`, `jsonParsed`, ainsi que les formes legacy encore
 acceptées/auditées. Les formes encodées et JSON ne doivent pas être écrasées dans un seul `String` ambigu.
 
+## Règle de complétude des wrappers RPC
+
+À partir de `pre.005`, la règle générale `KSP-TRANSPORT-007` explicite un principe déjà recherché par les releases HTTP précédentes : un wrapper KSP
+n'est pas considéré complet s'il ne couvre qu'un sous-ensemble de convenance de la méthode RPC. Il doit exposer toute la surface sémantique auditée :
+
+```text
+paramètres obligatoires et optionnels
+champs de configuration
+variantes/overloads courants
+formes legacy encore supportées
+contraintes déterministes connues
+variantes/null/omissions significatives des réponses
+```
+
+Cette exigence ne signifie pas recopier `solana-rpc-client` ou tout `solana-transaction-status-client-types`. Une structure riche peut rester un
+`serde_json::Value` à une frontière explicitement lossless lorsque KSP n'a pas encore besoin de son modèle métier, à condition qu'aucune possibilité
+RPC ni information wire ne soit supprimée. Les syntaxes strictement équivalentes peuvent être canonicalisées.
+
+Pour `getTransaction`, `pre.005` couvre donc les deux formes de requête auditée : objet moderne et bare encoding legacy déprécié. La documentation
+publique courante expose `base58`, `base64`, `json` et `jsonParsed` pour l'objet moderne ; Agave `v4.2.1` accepte aussi l'alias rétrocompatible
+`binary` via le même enum wire, que KSP conserve donc sans le présenter comme choix moderne recommandé. La config complète
+`commitment/encoding/maxSupportedTransactionVersion` est exposée, avec rejet local de `processed` car la méthode documente `confirmed|finalized`. Le résultat
+`null`, les transactions chaîne/tuple/objet, les versions `legacy`/numériques, `meta` lossless et `transactionIndex` optionnel courant sont préservés.
+
 ## Matrice exacte des 11 méthodes
 
 | Méthode                       | Paramètres ordonnés / config                          | Résultat à préserver                             | Validation / particularités                                                    |
@@ -586,6 +610,7 @@ clôture documentaire/validation et ne doit pas devenir une implémentation mass
 La release ne peut être candidate stable que si :
 
 - les 11 wrappers sont publics et passent tous par `execute_standard_rpc` ;
+- chaque wrapper couvre tous les paramètres/options/overloads normatifs ou runtime supportés retenus par l'audit, selon `KSP-TRANSPORT-007` ;
 - les trois classes de sécurité restent exactes `8 Read / 2 WriteSubmission / 1 Simulation` ;
 - `requestAirdrop` et `sendTransaction` prouvent l'absence de resend automatique après dispatch ambigu ;
 - `getTransaction` préserve la forme moderne et la compatibilité legacy explicitement dépréciée ;