v0.1.0-pre.009

kb-lib/README.md

@@ -1,5 +1,5 @@
 <!-- file: kb-lib/README.md -->
-<!-- version: 5 -->
+<!-- version: 6 -->
 
 # kb-lib
 
@@ -80,6 +80,24 @@ est `docs/SPL_TOKEN_2022_MATRIX.json`.
 clé publique ElGamal et le wire complet. La matrice normative est
 `docs/SPL_ELGAMAL_REGISTRY_MATRIX.json`.
 
+## Décodeur Metaplex Token Metadata
+
+`MetadataMetaplexTokenMetadataDecoder` couvre exclusivement
+`metaqbxxUerdq28cj1RbAWkYQm3ybzjb6a8bt518x1s`. Il inventorie exactement les 58
+discriminateurs `0..=57`, conserve les arguments Borsh, les comptes positionnels,
+les placeholders optionnels, les chemins outer/CPI et les transactions échouées
+comme intentions non commitées.
+
+Le module public
+`kb_lib::decoder::metadata::metaplex_token_metadata` expose aussi les parseurs
+bornés des 15 variantes `Key 0..=14` : Metadata, Edition et Master Edition,
+Edition Marker V1/V2, Token Record, records de délégation et d’autorité, Token
+Owned Escrow et Reservation List historiques. Chaque parseur vérifie l’owner,
+le PDA, le bump, la longueur et les suffixes avant projection. Les comptes
+historiques gardent une provenance et un lifecycle matérialisables, mais une
+politique d’exécution définitivement interdite. La matrice normative est
+`docs/METAPLEX_TOKEN_METADATA_MATRIX.json`.
+
 ## API publique utile
 
 - `SolanaCoreDecoder` : décodeur concret natif ;
@@ -89,6 +107,8 @@ clé publique ElGamal et le wire complet. La matrice normative est
 - `SplToken2022Decoder` : décodeur exact des instructions Token‑2022 ;
 - `Token2022State`, `Token2022StateKind`, `Token2022TlvEntry` et `parse_token_2022_state()` : API publique de lecture d’état Token‑2022 ;
 - `SplElgamalRegistryDecoder`, `ElGamalRegistryState` et `parse_elgamal_registry_state()` : API publique du registre ElGamal ;
+- `MetadataMetaplexTokenMetadataDecoder` : décodeur exact du programme Metaplex Token Metadata ;
+- `kb_lib::decoder::metadata::metaplex_token_metadata` : parseurs et snapshots publics des comptes Metaplex ;
 - `InstructionDecoder` : contrat de reconnaissance, couverture et décodage contextualisé ;
 - `ProtocolDecoder` : contrat de compatibilité avec les observations historiques ;
 - `CoreInstructionReplayInput` : input source-neutral produit par l’extraction core ;