v0.1.0-pre.007

kb-lib/README.md

@@ -1,5 +1,5 @@
 <!-- file: kb-lib/README.md -->
-<!-- version: 3 -->
+<!-- version: 4 -->
 
 # kb-lib
 
@@ -43,11 +43,25 @@ cumulés et interdit les batches imbriqués. Le décodeur n’invente ni mint, n
 final ; les validations `M/N`, soldes et autorités existantes restent stateful. La matrice
 normative est `docs/SPL_TOKEN_MATRIX.json`.
 
+## Décodeur SPL Associated Token Account
+
+`SplAssociatedTokenAccountDecoder` couvre exclusivement
+`ATokenGPvbdGVxr1b2hvZbsiqW5xWH25efTNsLJA8knL`. Il reconnaît les trois variantes publiées
+`Create`, `CreateIdempotent` et `RecoverNested`, ainsi que l’encodage historique vide de `Create`.
+
+Le décodeur conserve les comptes dans leur ordre original, leurs flags, doublons, chemins
+outer/inner et le statut de transaction. Il dérive les PDA avec l’ordre canonique
+`[wallet, token_program, mint]`, conserve simultanément l’adresse observée et l’adresse attendue,
+puis expose tout écart comme diagnostic. SPL Token classique et Token‑2022 sont distingués par leur
+Program ID sans reconstruire leur état ni interpréter leurs extensions. La matrice normative est
+`docs/SPL_ASSOCIATED_TOKEN_ACCOUNT_MATRIX.json`.
+
 ## API publique utile
 
 - `SolanaCoreDecoder` : décodeur concret natif ;
 - `SplMemoDecoder` : décodeur exact des trois générations SPL Memo ;
 - `SplTokenDecoder` : décodeur exact du programme SPL Token classique ;
+- `SplAssociatedTokenAccountDecoder` : décodeur exact du programme Associated Token Account ;
 - `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 ;