v0.1.0-pre.061

idls/001.README.md

@@ -1,8 +1,62 @@
 <!-- file: idls/001.README.md -->
-<!-- version: 1 -->
+<!-- version: 2 -->
 
 # IDL locales
 
-Ce répertoire contient les IDL locales utilisées comme sources de connaissance pour les décodeurs.
+Ce répertoire contient les IDL téléchargées depuis des sources officielles ou de référence et utilisées pour auditer les décodeurs, matérialiseurs et exécuteurs.
 
-Les fichiers JSON ne doivent pas être modifiés pour ajouter des commentaires, car le format JSON standard ne les supporte pas.
+## Règle d’admission
+
+Une IDL devient une source locale active lorsqu’un décodeur ou un exécuteur correspondant est développé. À ce moment-là, il faut :
+
+1. télécharger l’IDL utilisée ;
+2. vérifier son Program ID et sa provenance ;
+3. conserver son contenu JSON inchangé ;
+4. la renommer selon la convention canonique ;
+5. documenter sa version ou son commit lorsqu’ils sont connus ;
+6. ajouter des tests comparant, selon le périmètre disponible, l’IDL, le runtime, les builders et l’interface officielle.
+
+Les fichiers JSON ne doivent pas recevoir de commentaires ni être reformattés uniquement pour satisfaire la documentation.
+
+## Convention de nommage
+
+Forme principale :
+
+```text
+<PROGRAM_ID>.<protocol_type>.<protocol_code>.json
+```
+
+Exemple actif :
+
+```text
+metaqbxxUerdq28cj1RbAWkYQm3ybzjb6a8bt518x1s.metadata.metaplex_token_metadata.json
+```
+
+Lorsqu’il faut conserver plusieurs versions réellement distinctes d’une même IDL :
+
+```text
+<PROGRAM_ID>.<protocol_type>.<protocol_code>.<version>.json
+```
+
+Suffixes admis, par ordre de préférence :
+
+```text
+v<semver>
+commit-<short_hash>
+slot-<deployment_slot>
+date-YYYY-MM-DD
+```
+
+La version ne doit jamais être inventée. Tant qu’une seule IDL est conservée pour un programme, le suffixe de version reste facultatif.
+
+## Classification
+
+- `protocol_type` représente la famille fonctionnelle stable, par exemple `metadata`, `launchpad`, `amm`, `clmm`, `lending`, `router`, `vault` ou `orderbook`.
+- `protocol_code` représente le protocole ou la surface exacte, par exemple `metaplex_token_metadata`.
+- La classification est validée lors de l’implémentation du décodeur ou de l’exécuteur ; les IDL de référence non encore utilisées ne doivent pas être renommées massivement sur une classification incertaine.
+
+## Intégrité
+
+Le renommage du fichier est autorisé. Le contenu de l’IDL doit rester identique à la source téléchargée.
+
+Les graphies externes telles que `token2022`, les noms de types Anchor et les identifiants publiés dans l’IDL ne doivent pas être adaptés à la nomenclature interne du workspace.

idls/metaplex_token_metadata.SOURCE.md

@@ -1,13 +0,0 @@
-# Metaplex Token Metadata IDL source
-
-- Repository: `metaplex-foundation/mpl-token-metadata`
-- Path: `idls/token_metadata.json`
-- Branch used for this snapshot: `main`
-- Program ID: `metaqbxxUerdq28cj1RbAWkYQm3ybzjb6a8bt518x1s`
-- Git blob SHA observed during retrieval: `5df4a24f62c2743125be096cc174680790c92c18`
-
-Refresh with:
-
-```bash
-scripts/fetch_metaplex_token_metadata_idl.sh
-```