Sasedev/khadhroony-bot3
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

v0.5.2-pre.002

Browse Source
This commit is contained in:
SinuS von SifriduS
2026-08-10 15:06:38 +02:00
parent 0bd5bbf1c4
commit eaa24e6f11
12 changed files with 835 additions and 58 deletions
Download Patch File Download Diff File Expand all files Collapse all files

17
docs/plans/V0_5_2_KS_WALLET_RESTRUCTURING_PLAN.md
View File

@@ -1,5 +1,5 @@
<!-- file: docs/plans/V0_5_2_KS_WALLET_RESTRUCTURING_PLAN.md -->
<!-- version: 3 -->
<!-- version: 4 -->
# Plan `0.5.2` — restructuration de `ks-wallet`
@@ -40,6 +40,8 @@ Le store doit donc pouvoir scanner son répertoire résolu à la recherche des f
Le scan doit être borné au répertoire possédé par le store, non récursif par défaut, refuser les symlinks/fichiers non réguliers et ne considérer un candidat comme wallet qu'après validation de l'alias, du suffixe, du magic et de la version du conteneur. Le nom de fichier n'est pas à lui seul une preuve de validité.
Cette découverte automatique n'interdit pas l'ouverture explicite d'un fichier natif situé ailleurs. Un consommateur, par exemple `kb-app-demo-desktop` après sélection via un file browser, doit pouvoir fournir un chemin arbitraire vers un `.kswallet` à `ks-wallet`. Ce chemin explicite ne modifie pas le répertoire configuré, n'enregistre pas automatiquement le fichier dans le store et ne doit pas être projeté dans une identité publique ou un DTO frontend. L'ouverture réelle utilisera le mot de passe fourni au moment de l'appel ou dans l'étape d'ouverture immédiatement associée.
### 2.2 Wallets temporaires ou jetables
`ks-wallet` doit conserver la capacité actuelle de générer des wallets temporaires en mémoire pour :
@@ -469,11 +471,15 @@ Le découpage reste borné mais peut être ajusté si une tranche devient trop l
### `0.5.2-pre.002` — caractérisation exécutable et API de base
- tests externes du legacy ;
- identité publique minimale ;
- manager/scan/listing/lookup multi-wallet ;
- identité publique minimale sans chemin local ;
- manager/scan/listing/lookup multi-wallet sur le répertoire configuré ;
- inspection explicite d'un `.kswallet` hors store sans mutation de la configuration ni auto-enregistrement ;
- préambule d'identification natif minimal `magic + version`, uniquement pour rendre la découverte exécutable ;
- contrat de wallet temporaire ;
- frontière de signature compatible avec `ks-lib`.
Le préambule d'identification introduit ici ne définit pas encore le payload protégé : le codec complet, les bornes du conteneur, KDF et AEAD restent dans `pre.003`.
### `0.5.2-pre.003` — codec et stockage `.kswallet`
- spécification binaire versionnée ;
@@ -581,6 +587,7 @@ Le plan est désormais centré sur les décisions suivantes :
14. le format keypair JSON des binaires Solana est obligatoire en import et en export dans `0.5.2` ;
15. une matrice officielle des formats Phantom/Solflare/Backpack/Trust/Coinbase-Base et autres cibles pertinentes sera finalisée avant les adaptateurs ;
16. un seul adaptateur wallet tiers est implémenté dans `0.5.2` comme exemple, les autres formats faisables étant reportés au TODO sans version déterminée ;
17. les détails KDF/AEAD et le modèle runtime d'un wallet ouvert seront décidés dans leurs tranches techniques, après tests et vérification des dépendances.
17. les détails KDF/AEAD et le modèle runtime d'un wallet ouvert seront décidés dans leurs tranches techniques, après tests et vérification des dépendances ;
18. le scan automatique reste limité au répertoire configuré, tandis qu'un consommateur peut fournir explicitement un autre chemin `.kswallet` à `ks-wallet` sans modifier le store ni enregistrer ce fichier automatiquement.
Ces décisions suffisent pour ouvrir `0.5.2-pre.002` après validation du présent fix de `pre.001`.
Ces décisions ont permis d'ouvrir `0.5.2-pre.002`.