0.1.0

migration/khadhroony-bot2-reference/kb_decoder_spl_token_2022/README.md

@@ -0,0 +1,30 @@
+<!-- file: kb_decoder_spl_token_2022/README.md -->
+<!-- version: 4 -->
+
+# kb_decoder_spl_token_2022
+
+Ce crate décode la surface `spl_token_2022` afin de normaliser les événements token fondamentaux.
+
+La première tranche d'audit publie `docs/SPL_TOKEN_2022_MATRIX.json`. Elle inventorie les 48 tags
+de premier niveau et les 29 types TLV de production. La résolution opérateur confirme
+`spl-token-2022-interface 3.1.1` avec `default + serde` et
+`spl-elgamal-registry-interface 0.2.1` avec `default`. Le scaffold reste volontairement inchangé
+tant que les sous-discriminants, comptes exacts et processors ne sont pas confirmés.
+
+La crate opérationnelle utilise la cible de tracing canonique `kb_decoder_spl_token_2022`. Pendant
+la phase d'audit, l'appel du scaffold émet seulement un diagnostic `debug` structuré indiquant
+qu'aucun événement métier n'a encore été produit ; il ne revendique aucun décodage effectif.
+
+## Rôle dans l'écosystème
+
+Ce module fait partie du découpage strict de Khadhroony Bot2. Il doit conserver des dépendances limitées et ne pas contourner les interfaces communes du workspace.
+
+## Règles locales
+
+- Les commentaires de code restent en anglais.
+- La documentation Markdown reste en français.
+- Les exports publics sont contrôlés depuis `lib.rs` lorsque le crate expose une bibliothèque.
+- Les binaires utilisent `main.rs` avec les attributs Rust obligatoires.
+- Le seul Program ID accepté sera `TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb`.
+- Le registre ElGamal, le programme ZK ElGamal natif et les implémentations externes de Transfer
+  Hook, Token Group ou Token Metadata conservent des dispatchs et matrices séparés.