khadhroony-bot3/docs/architecture/SURFACE_CRATE_MATRIX.md

Matrice des responsabilités par surface

1. Légende

• Contrat/implémentation : responsabilité métier principale.
• Orchestration : coordination entre couches.
• Persistance : stockage et replay.
• Transport : acquisition ou appel RPC.
• Présentation : UI ou adaptation de démonstration.

2. Matrice

Surface	kb-lib	kb-pipeline	kb-store	kb-onchain-transport	scénarios	desktop
Solana Core	décodeurs, exécuteurs, matérialisateurs	extraction, replay, exécution	persistance	RPC	validations Devnet	panneaux fonctionnels
SPL Memo	décodage v1/v3/v4, exécution v4	replay et exécution v4	persistance	RPC	scénario Memo v4	panneau Memo v4
SPL Token classique	contrats et implémentations	stateful, préflight, orchestration	persistance	RPC	scénarios Devnet	panneaux fonctionnels
SPL ATA	contrats et implémentations	état et orchestration	persistance	RPC	scénarios classique/Token-2022	panneaux fonctionnels
Token-2022	contrats et implémentations	corrélation, preuves, préflight, validation	persistance	RPC	scénarios Devnet	panneaux fonctionnels
Registre ElGamal	implémentation partielle confirmée	traitement stateful à vérifier par API	persistance selon flux	acquisition de comptes	pas de validation réelle déclarée	présentation non raccordée fonctionnellement
Metaplex Token Metadata	décodeurs de comptes/instructions et matérialisation migrés ; exécuteur réservé à achever	pipeline généraliste Metaplex à achever	persistance générique présente ; projections à auditer	acquisition standard	scénarios Devnet/Testnet à créer/compléter	adaptateurs et panneaux à créer/compléter

3. Interprétation

Cette matrice décrit les responsabilités observées au niveau architectural. Elle ne déclare pas une couverture exhaustive de chaque instruction ou compte. La couverture détaillée reste démontrée par le code, les tests et les matrices sous test-fixtures/contract-matrices/.

4. Statuts sensibles

• Memo v1 et v3 restent non exécutables.
• Memo v4 est exécutable.
• Le registre ElGamal ne doit pas être présenté comme validé Devnet/Mainnet.
• Tout le travail Metaplex Token Metadata réalisé dans bot2 a été migré dans bot3. 0.4.7 doit achever la surface sans présenter cette migration comme partielle.