36 lines
3.2 KiB
Markdown
36 lines
3.2 KiB
Markdown
<!-- file: docs/architecture/SURFACE_CRATE_MATRIX.md -->
|
|
<!-- version: 1 -->
|
|
|
|
# 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écodeur partiellement migré | à compléter selon besoins | à compléter | acquisition standard | à créer/compléter | à 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.
|
|
- Metaplex Token Metadata appartient au travail `0.4.7` commencé avant la migration et seulement partiellement repris dans bot3.
|