# CHANGELOG — khadhroony-bot3 Ce changelog décrit les évolutions fonctionnelles globales du projet. Il ne recense pas les prereleases, les correctifs `fix` ni le détail de chaque delta. Ces informations appartiennent aux changelogs des crates concernées. ## 0.1.0-mig-from-kbot2 — transition architecturale vers khadhroony-bot3 Cette entrée de transition regroupe la migration structurelle et fonctionnelle commencée depuis `khadhroony-bot2`. Elle identifie la campagne `0.1.0-pre.*` de bot3 sans constituer une version fonctionnelle équivalente à bot2 `0.1.0` ni un alignement officiel sur `0.4.6`. ### Architecture - consolidation de plus de 250 crates historiques en 11 crates de workspace ; - regroupement des modèles, décodeurs, exécuteurs et matérialisateurs dans `kb-lib` ; - consolidation du stockage dans `kb-store` ; - renommage de `kb-rpc` en `kb-onchain-transport` ; - migration du pipeline dans `kb-pipeline` ; - extraction des scénarios de démonstration dans `kb-pipeline-demo-scenarios` ; - maintien de `kb-app-demo-desktop` comme crate mixte bibliothèque et binaire ; - migration et renommage du portefeuille en `kb-wallet`. ### Normes - adoption de Rust 2024 et des règles strictes du workspace bot3 ; - interdiction des paniques implicites et des erreurs opaques dans le code de production ; - normalisation des exports publics, des en-têtes de fichiers, du tracing et des conventions de modules ; - ajout d’audits automatiques des règles Rust, des exports et des contraintes Khadhroony ; - adoption d’un contrat documentaire par crate fondé sur `README.md`, `TODO.md`, `USAGE.md` et `CHANGELOG.md`. ### Migration fonctionnelle - migration du stockage canonique, des observations, de l’extraction Core et du replay ; - migration des transports HTTP, WebSocket, acquisition canonique, soumission et confirmation ; - migration des décodeurs, matérialisateurs et exécuteurs Solana Core et SPL jusqu’à un périmètre proche de bot2 `0.4.6` ; - migration du décodeur Metaplex Token Metadata commencé pendant bot2 `0.4.7` ; - migration des préflights et orchestrations stateful Token-2022 ; - conservation de Memo v1 et v3 en décodage uniquement et de Memo v4 comme génération exécutable. ### Validation - validation du workspace, des audits et des tests ciblés pendant les prereleases `0.1.0-pre.*` ; - validation Devnet de Solana Core System Transfer, Memo v4, ATA classique, ATA Token-2022, SPL Token classique et huit opérations Token-2022 ; - validation des parcours de simulation, confirmation opérateur, envoi, insertion canonique, extraction Core, replay, matérialisation et idempotence pour les scénarios couverts ; - registre ElGamal non déclaré validé, faute de fixture de preuve, de raccordement desktop fonctionnel et de confirmation de déploiement réseau. # Historique fonctionnel de khadhroony-bot2 Les sections dont le numéro porte le suffixe `-kbot2` décrivent exclusivement les versions et travaux réalisés dans `khadhroony-bot2`. Elles constituent l’historique fonctionnel du projet d’origine et ne représentent pas des versions publiées de `khadhroony-bot3`. `khadhroony-bot3` résulte de la migration et de la consolidation de cette base historique dans une nouvelle architecture. Son futur alignement de version sera décidé après la clôture de l’audit `0.4.6`. La future version fonctionnelle `0.4.7` de `khadhroony-bot3` devra réunir : - la clôture des écarts résiduels de migration ; - les capacités historiques de bot2 nécessaires à l’alignement ; - les travaux Metaplex Token Metadata déjà réalisés puis migrés ; - l’achèvement des éléments de l’objectif `0.4.7-kbot2` restés incomplets, notamment l’exécuteur, l’intégration au pipeline, les démonstrations et les validations finales. Les entrées `0.0.1-kbot2` à `0.4.6-kbot2` décrivent des versions fonctionnelles clôturées de bot2. L’entrée `0.4.7-kbot2` décrit une version interrompue en cours de développement par la migration vers bot3. ## 0.4.7-kbot2 — Metaplex Token Metadata interrompu par la migration bot3 Cette section décrit l’objectif `0.4.7` commencé dans `khadhroony-bot2` après la clôture de `0.4.6-kbot2`. Cet objectif a été interrompu avant sa finalisation afin de réaliser la migration architecturale vers `khadhroony-bot3`. - implémentation du décodeur Metaplex Token Metadata dans bot2 ; - implémentation de la matérialisation associée dans bot2 ; - interruption volontaire du développement de cette surface afin de réaliser la migration architecturale vers `khadhroony-bot3` ; - reprise du décodeur pendant la migration vers bot3 ; - exécuteur, intégration complète au pipeline, scénarios de démonstration et validations finales reportés vers l’objectif fonctionnel `0.4.7` de `khadhroony-bot3`. ## 0.4.6-kbot2 — Token-2022, extensions et registre ElGamal - couverture bornée de Token-2022, de ses extensions et des interfaces externes associées ; - préflight, orchestration de preuves, corrélation stateful, validation et matérialisation ; - intégration du registre ElGamal avec validation synthétique et garde-fous fail-closed ; - absence de validation réelle du registre ElGamal sur Devnet ou Mainnet. ## 0.4.5-kbot2 — SPL Associated Token Account - décodage et exécution des créations ATA classiques et Token-2022 ; - vérification des PDA, de l’ordre des seeds et des contrats officiels ; - intégration aux matérialisateurs et au pipeline de validation. ## 0.4.4-kbot2 — SPL Token classique - couverture des instructions SPL Token classiques, y compris opérations checked, multisig, native token et batch borné ; - matérialisation des comptes, autorités, délégations, risques et changements administratifs ; - exécution typée, préflight, simulation-first et validation des signers. ## 0.4.3-kbot2 — SPL Memo v1, v3 et v4 - décodage borné des trois générations ; - matérialisation des annotations transactionnelles ; - exécution limitée à Memo v4 ; - validation Devnet de Memo v4. ## 0.4.2-kbot2 — exécution native et RPC Solana standard - infrastructure d’exécution Solana Core ; - couverture des programmes natifs, loaders, précompiles et opérations supportées ; - simulation, soumission, confirmation et politiques de sécurité ; - matrice d’exécution native et contrats de transaction legacy ou durable nonce. ## 0.4.1-kbot2 — programmes Solana natifs - décodage des programmes natifs, loaders, Compute Budget, Address Lookup Table, Stake, Vote et précompiles ; - matérialisations lifecycle, administration, compliance et staking ; - extraction et replay contextualisés. ## 0.4.0-kbot2 — infrastructure de décodage et matérialisation - contrats communs de décodeurs, support, compatibilité et replay ; - ledger de traitement et matérialisation optionnelle ; - matrices contractuelles exécutables et tests de couverture. ## 0.3.4-kbot2 — extraction Core et clôture de la fondation transactionnelle - extraction des transactions canoniques vers les tables Core ; - replay déterministe et traitement idempotent ; - ledger de progression et reprise bornée. ## 0.3.3-kbot2 — backfill HTTP - acquisition historique gratuite par adresse et signatures ; - pagination, retries, annulation coopérative et reprise déterministe ; - démonstration applicative du backfill. ## 0.3.2-kbot2 — contrat canonique et adaptateur HTTP - définition d’une transaction Solana canonique indépendante du fournisseur ; - conversions explicites depuis les réponses RPC ; - conservation sans perte des données nécessaires au replay. ## 0.3.1-kbot2 — transaction canonique et observations - séparation entre payload canonique et observations d’acquisition ; - migration du schéma PostgreSQL vers les tables raw, observations et Core actives ; - suppression de la duplication durable des payloads complets. ## 0.3.0-kbot2 — cadrage des sources temps réel - étude d’un nœud Agave local ; - abandon temporaire comme source légère en raison du coût matériel ; - réorientation vers des transports interchangeables. ## 0.2.5-kbot2 — diagnostics PostgreSQL - fenêtres de diagnostic du backend, du schéma et des tables raw/Core ; - initialisation contrôlée du schéma au démarrage ; - diagnostics strictement read-only. ## 0.2.4-kbot2 — stockage Core Solana - tables Core normalisées ; - construction des entrées de replay instruction-level ; - migrations et initialisation idempotentes. ## 0.2.3-kbot2 — stockage brut Solana - stockage idempotent des transactions et notifications brutes ; - index minimaux et cycle de vie initial des données. ## 0.2.2-kbot2 — infrastructure PostgreSQL - connexion, migrations, healthcheck et conventions de schéma ; - tests PostgreSQL réels optionnels. ## 0.2.1-kbot2 — contrats de stockage - DTO, entités et repositories du stockage ; - contrats de replay instruction-level. ## 0.2.0-kbot2 — conventions SQL et base de données - séparation des contrats de stockage et de l’implémentation PostgreSQL ; - règles de nommage, migrations et erreurs structurées. ## 0.1.3-kbot2 — transports Solana initiaux - clients HTTP et WebSocket Solana standard ; - rôles d’endpoints, pools et configuration des sources. ## 0.1.2-kbot2 — intégration configuration, logging et desktop - liaison de la configuration typée et du logging à l’application Tauri ; - première démonstration intégrée. ## 0.1.1-kbot2 — configuration typée - profils validés, schéma JSON et chargement structuré ; - gestion explicite des erreurs de configuration. ## 0.1.0-kbot2 — logging structuré - infrastructure de logging et tracing ; - configuration des targets et sorties. ## 0.0.2-kbot2 — squelette stabilisé - conventions initiales du workspace et premières crates ; - validation du build de base. ## 0.0.1-kbot2 — création du projet - création du workspace initial khadhroony-bot2.