khadhroony-bot3/kb-program-ids/README.md

kb-program-ids

kb-program-ids est la source unique des identifiants de programmes Solana et des comptes natifs connus utilisés par le workspace.

La tranche 0.1.0-pre.004 expose les 18 surfaces exécutables nécessaires au décodeur Solana Core, les comptes natifs associés utilisés par leurs contrats et l’identifiant SPL Token classique employé par les tests de frontière. La tranche 0.1.0-pre.005 ajoute les trois identifiants SPL Memo v1, v3 et v4 sans les classer parmi les surfaces natives. 0.1.0-pre.006 active l’identifiant SPL Token classique dans un décodeur concret tout en le maintenant hors des surfaces natives. 0.1.0-pre.007 ajoute les identifiants SPL Associated Token Account et Token‑2022 nécessaires à la frontière ATA. 0.1.0-pre.008 ajoute le Program ID indépendant du registre ElGamal de Token‑2022. 0.1.0-pre.009 ajoute le Program ID indépendant de Metaplex Token Metadata. Ces programmes restent hors des surfaces natives.

constants.rs reste l’unique source des adresses et des tableaux statiques. programs.rs porte ProgramIdEntry, ses méthodes et toutes les fonctions de consultation. lib.rs se limite aux déclarations de modules et aux réexports documentés de la façade.

API publique

• les constantes *_PROGRAM_ID et STAKE_CONFIG_ACCOUNT_ID exposent les adresses Base58 canoniques ;
• ProgramIdEntry conserve un code stable et une adresse, accessibles par les champs compatibles name/address et par code()/program_id() ;
• native_program_ids() retourne exactement les 18 surfaces exécutables de Solana Core ;
• native_well_known_account_ids() sépare les comptes natifs non exécutables ;
• registered_program_ids() et son alias de compatibilité entries() retournent le registre actuellement migré ;
• find_registered_program_id() effectue une recherche exacte par adresse.

STAKE_CONFIG_PROGRAM_ID reste uniquement un alias de compatibilité historique. L’adresse correspondante est un compte de configuration Stake connu, pas un programme exécutable.