v0.5.2-pre.001

ks-wallet/CHANGELOG.md

@@ -1,8 +1,34 @@
 <!-- file: ks-wallet/CHANGELOG.md -->
-<!-- version: 6 -->
+<!-- version: 9 -->
 
 # CHANGELOG — ks-wallet
 
+## `0.5.2-pre.001`
+
+- caractérise précisément le format legacy `<alias>.json`, ses permissions Unix, ses erreurs, sa publication directe dans le chemin final et ses limites d’atomicité/TOCTOU ;
+- inventorie les consommateurs `ks-wallet`, les usages directs de `solana_keypair` / `solana_signer`, les variables/configurations wallet et les workflows CLI qui dépendent encore du keypair Solana brut ;
+- définit le contrat fonctionnel `0.5.2` autour de la gestion multi-wallet par alias, des wallets temporaires/jetables, du mot de passe modifiable, de la signature sans exposition du secret et de l’import/export explicite ;
+- retient comme cible un conteneur natif binaire versionné `<alias>.kswallet`, sans fixer prématurément KDF/AEAD ou layout binaire ;
+- impose un mot de passe valide pour tout export contenant ou permettant de reconstruire le secret ;
+- définit la migration legacy comme import vers un nouveau `.kswallet` avec conservation de la pubkey, écriture atomique et rollback, sans réécriture destructive du `.json` ;
+- corrige README/USAGE/TODO afin d’aligner les objectifs sur ce contrat simplifié ;
+- ne modifie aucune API runtime, aucun fichier wallet et n’introduit encore aucun nouveau format persistant.
+
+### `pre.001-delta-fix-001`
+
+- corrige la version Cargo de `0.5.2-pre.001` vers le SemVer valide `0.5.2-pre.1` ;
+- simplifie profondément le plan initial, retire l’exclusion erronée de l’export privé contrôlé et supprime l’hypothèse d’un alias principal universel par profil ;
+- formalise l’extension native `.kswallet`, le wallet temporaire et l’obligation de password pour tout export secret.
+
+### `pre.001-delta-fix-002`
+
+- précise que `ks-wallet` découvrira les wallets persistants par scan borné des `<alias>.kswallet` dans son répertoire résolu, sans faire confiance au seul nom de fichier ;
+- distingue explicitement changement de password et rotation de keypair : le password rechiffre la même keypair, tandis qu’un nouveau secret Ed25519 implique une nouvelle pubkey ;
+- rend obligatoires l’import **et** l’export du format keypair JSON standard utilisé par les binaires Solana ;
+- ajoute une matrice de compatibilité à établir pour Phantom, Solflare, Backpack, Trust Wallet, Coinbase/Base et les autres wallets Solana techniquement documentés ;
+- borne `0.5.2` à un adaptateur wallet tiers d’exemple en plus du format Solana CLI obligatoire, avec report des autres adaptateurs faisables au TODO pour une version ultérieure non déterminée ;
+- interdit de synthétiser une recovery phrase supposée restaurer une keypair arbitraire lorsque la mnemonic/seed d’origine n’est pas disponible.
+
 ## `0.5.1-pre.002`
 
 - renomme `kb-wallet` en `ks-wallet` et `kb_wallet` en `ks_wallet` ;