v0.1.0-pre.064-065

olddocs/archivekbot2/kb_executor_spl_associated_token_account/README.md

@@ -0,0 +1,35 @@
+<!-- file: kb_executor_spl_associated_token_account/README.md -->
+<!-- version: 3 -->
+
+# kb_executor_spl_associated_token_account
+
+Ce crate construit les plans typés de la surface SPL Associated Token Account courante.
+
+## Surface
+
+- `Create` ;
+- `CreateIdempotent` ;
+- `RecoverNested` ;
+- Token Program classique ou Token-2022 comme cible explicite de la dérivation.
+
+Chaque plan conserve l’ordre et les flags des metas produits par le builder officiel de
+`spl-associated-token-account-interface 2.0.0`. Les signataires requis sont dédupliqués séparément,
+sans réordonner les comptes de l’instruction.
+
+## Garde-fous
+
+La simulation est obligatoire, le mode par défaut reste `dry_run`, les plafonds de rent et de frais
+sont explicites et le replay post-exécution complet est requis. Le préflight stateful Localnet/Devnet
+est orchestré par `kb_pipeline` : il contrôle cluster, mints, PDA, comptes Token existants,
+`RecoverNested`, signataires et solde couvrant le plafond rent-plus-frais.
+
+Pour Token-2022, le préflight valide uniquement le préfixe commun Mint/Token Account et accepte des
+octets d’extension suffixés. Il ne décode ni instruction ni extension Token-2022 ; la simulation
+officielle reste l’autorité pour la taille de compte et le rent exacts liés aux extensions.
+
+## Preuves Devnet
+
+Les parcours contrôlés du 16 juillet 2026 ont validé `CreateIdempotent` pour un mint classique et
+un mint Token-2022, puis la réutilisation des deux ATA avec second replay sans doublon. Un scénario
+`RecoverNested` classique a transféré 1 000 000 000 unités brutes vers l'ATA wallet, fermé le nested
+ATA et confirmé les postconditions ainsi que deux matérialisations distinctes lifecycle/risk.