0.5.1-pre.002

ks-program-ids/README.md

@@ -0,0 +1,38 @@
+<!-- file: ks-program-ids/README.md -->
+<!-- version: 9 -->
+
+# ks-program-ids
+
+`ks-program-ids` est la source Rust canonique des Program IDs Solana et des comptes connus utilisés par le workspace.
+
+## Responsabilités
+
+- exposer les constantes Base58 canoniques ;
+- fournir un registre énumérable et trié ;
+- distinguer les programmes natifs exécutables des comptes natifs connus ;
+- offrir une recherche exacte par adresse ;
+- réserver les identifiants nécessaires aux surfaces futures sans les déclarer implémentées.
+
+La présence d’un Program ID dans cette crate ne signifie pas qu’un décodeur, exécuteur ou matérialisateur existe.
+
+## API publique
+
+- constantes `*_PROGRAM_ID` ;
+- `STAKE_CONFIG_ACCOUNT_ID` et alias historique associé ;
+- `ProgramIdEntry` ;
+- `entries()` ;
+- `registered_program_ids()` ;
+- `native_program_ids()` ;
+- `native_well_known_account_ids()` ;
+- `find_registered_program_id()`.
+
+## Sources documentaires
+
+La documentation détaillée des Program IDs, de leur vérification et des IDL sera construite séparément. Elle pourra utiliser les archives bot2 et d’autres projets historiques, mais le code de production reste fondé sur les constantes vérifiées de cette crate.
+
+## Documentation
+
+- [USAGE.md](USAGE.md)
+- [TODO.md](TODO.md)
+- [CHANGELOG.md](CHANGELOG.md)
+- [Matrice des surfaces](../docs/architecture/SURFACE_CRATE_MATRIX.md)