<!-- file: idls/001.README.md -->
<!-- version: 2 -->

# Répertoire IDL v3

Ce répertoire contient 91 fichiers IDL JSON issus exclusivement de `idls_v2.zip`.
Le contenu brut des JSON n'a pas été modifié ; seuls les noms de fichiers ont été normalisés.

## Convention

```text
<famille-kb-lib>.<program-id>.<chemin-module>[.<génération-ou-sous-système>].V<version-idl>.from_<source>.json
```

- `famille-kb-lib` correspond au premier niveau fonctionnel de `kb-lib` : `solana`, `spl`,
  `metadata`, `launchpad`, `fees`, `strategy`, etc.
- `program-id` est l'identifiant canonique du programme.
- `chemin-module` correspond au module fonctionnel cible sans les rôles `decoder` ou `executor`.
- `v1`, `v3`, `v4` désignent une génération de programme ou de surface.
- `V3_0_1` désigne la version déclarée par l'IDL.
- `from_solscan` et `from_github_solana_program` indiquent la provenance.

## Documents

- `../docs/IDL_AUDIT.md` : inventaire, validation JSON, versions et empreintes.
- `../docs/MISSING_PROGRAM_IDLS.md` : programmes connus sans IDL présente ou sans IDL officielle identifiée.
- `../docs/IDL_TO_KB_LIB_NOMENCLATURE.md` : correspondance entre chaque IDL et le module `kb-lib`.

## Décisions architecturales intégrées

- `admin/pump_fees` devient `fees/pump_fees`.
- `admin/jupiter_lock` devient `vesting/jupiter_lock`.
- `amm/metadao_futarchy_amm` devient `governance/metadao_futarchy`.
- `amm/virtuals` devient `launchpad/virtuals`.
- `router/jupiter_dca` devient `strategy/jupiter_dca`.
- une famille `storage` est proposée pour `storage/solana_record`.

Ces changements de modules ne sont pas appliqués au code Rust dans cette archive ; ils servent de cible
pour la prochaine refactorisation de `kb-lib`.