v0.1.0-pre.021

docs/KB_LIB_MIGRATION_AUDIT.md

@@ -0,0 +1,31 @@
+# Audit de migration de `kb-lib`
+
+## État après `0.1.0-pre.021`
+
+L’inventaire des anciennes crates métier de `khadhroony-bot2` a été comparé à l’arborescence consolidée de `khadhroony-bot3/kb-lib`.
+
+### Implémentations fonctionnelles migrées
+
+- modèles et contrats publics de décodage, matérialisation et exécution ;
+- décodeur Solana Core ;
+- décodeurs SPL Memo, Token classique, ATA, Token-2022 et ElGamal Registry ;
+- décodeur Metaplex Token Metadata dans l’état intermédiaire atteint par bot2 `0.4.7` ;
+- matérialisateurs transaction annotations, token accounts, admin, risk, fees, lifecycle, metadata, staking et compliance audit ;
+- exécuteurs Solana Core, SPL Memo v4, SPL Token classique, ATA, Token-2022 et ElGamal Registry ;
+- politique de sécurité commune des exécuteurs.
+
+### Éléments encore à migrer dans `kb-lib`
+
+Il reste une ancienne crate fonctionnelle :
+
+- `kb_execution_solana` : assemblage de transactions legacy, durable nonce, validation des comptes nonce, signature, preuves de simulation et contrôle de taille de paquet.
+
+Cette couche n’est pas un exécuteur de programme. Elle doit être portée sous la famille `executor/solana` avant la migration du transport on-chain.
+
+### Éléments volontairement réservés
+
+Les autres modules de décodeurs, matérialisateurs et exécuteurs présents dans bot3 correspondent aux placeholders réservés de bot2. Ils ne contiennent pas d’implémentation fonctionnelle perdue à migrer.
+
+### Étape suivante
+
+Migrer `kb_execution_solana`, vérifier ses contrats publics et ses tests, puis clôturer la parité de `kb-lib` avant de passer à la future crate de transport on-chain.