khadhroony-bot3/CHANGELOG.md

<!-- file: CHANGELOG.md -->
<!-- version: 10 -->

# 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.