khadhroony-solana-project/deltas/0.2.6/pre.005.md

<!-- file: deltas/0.2.6/pre.005.md -->
<!-- version: 1 -->

# Delta `0.2.6-pre.005` — création Wallet et lifecycle de session Rust

## Base requise

```text
0.2.6-pre.004-fix.001 appliquée
workspace.package.version = 0.2.6-pre.4.fix.1
```

Les preuves opérateur de `pre.004-fix.001` sont vertes : `cargo fmt --all`, audit structurel Python, `cargo check --workspace`, `cargo clippy --workspace --all-targets`, `cargo test -p ksp-app-wallet-desk`, `cargo test --workspace` et `cargo tauri dev -c crates/ksp-app-wallet-desk/tauri.conf.json`, sans les warnings `unused_imports` corrigés par le fix.

## Type de livraison

```text
ksp-general-0.2.6-pre.005.zip
```

Cette tranche modifie le runtime Rust/frontend ; le signal technique devient :

```text
workspace.package.version = 0.2.6-pre.5
commit = v0.2.6-pre.005
```

Aucun tag stable.

## Objet

Rendre enfin possible la création d'un vrai `.kspwallet` depuis Wallet Desk et poser le lifecycle de session backend avant les unlock VIEW/OWNER de wallets existants.

## Session Rust durable

`AppState` possède désormais :

```text
Mutex<WalletSession>
```

avec les états actuellement matérialisés :

```text
NoSelection
Locked { wallet_id, path, locked_info }
Owner { wallet_id, path, view_enabled, wallet: WalletOwner }
```

Le chemin complet et `WalletOwner` restent exclusivement en Rust.

Transitions `pre.005` :

```text
select_wallet   -> drop session précédente -> inspect -> Locked
create_wallet   -> drop session précédente -> create file -> Owner
deselect_wallet -> drop handle/path -> NoSelection
lock_wallet     -> drop Owner -> inspect file -> Locked
refresh_wallets -> deselect backend -> refresh inventory
```

Les unlock VIEW/OWNER de fichiers existants restent hors scope et arrivent en `pre.006`.

## Création native

Le formulaire Create transmet :

```text
filename
OWNER password
VIEW password optionnel
alias interne optionnel
note initiale optionnelle
```

Rust valide le filename root-scoped puis appelle exclusivement :

```text
ksp_wallet_lib::create_wallet_file_v1
```

La publication reste no-clobber et la destination reste sous `ResolvedWalletConfig::effective_wallets_directory()`.

Le `String` OWNER est immédiatement déplacé dans `OwnerPassword`; le `String` VIEW optionnel est immédiatement déplacé dans `ViewPassword`. Les request DTOs de password ne dérivent ni `Debug` ni `Clone`.

Après succès, le `WalletOwner` retourné est conservé dans `WalletSession::Owner`. La réponse `WalletAuthorizedDto` expose seulement les informations autorisées nécessaires à l'UI :

```text
wallet_id / filename
capability = owner
format_version
view_enabled
Pubkey
alias optionnel
notes protégées
```

Aucun password, seed, keypair, secret bytes ou path complet n'est sérialisé.

## Frontend et purge

La carte Wallet courant sait maintenant afficher l'état OWNER après création avec `fa-lock-open`, Pubkey, alias et notes. Le formulaire Create est fonctionnel ; le bouton VIEW active/désactive son champ password.

Les opérations suivantes purgent les inputs password/alias/note et toute projection autorisée devenue invalide :

```text
sélection d'un autre wallet
Lock
Deselect
Refresh
échec de transition
```

Après une création réussie, l'inventory est relu par `list_wallets` sans détruire la session OWNER. Un Refresh utilisateur appelle au contraire `refresh_wallets`, qui purge d'abord la session backend pour garder UI et Rust synchronisés.

Les logs frontend/backend n'incluent ni password, ni alias, ni note. Ils peuvent inclure le filename/root-scoped wallet id et les états/capabilities.

## Commandes Tauri

Ajouts :

```text
create_wallet
deselect_wallet
lock_wallet
```

`select_wallet` installe désormais réellement la session Locked au lieu de retourner seulement une projection éphémère.

## DTOs

Ajouts :

```text
WalletCreateRequestDto
WalletAuthorizedDto
WalletNoteDto
WalletSessionDto
WalletSessionStateDto
```

`WalletCreateRequestDto` est strictement frontend -> Rust. Les autres DTOs ne transportent aucun password.

## Tests et canaris

La tranche ajoute/étend des canaris pour :

```text
NoSelection sans identité
request de création non Clone/Debug par conception
create/session backend owned
commands create/deselect/lock présentes
form Create présente
passwords absents de WalletAuthorizedDto
purge frontend explicite
inventory locked toujours sans identité protégée
```

Les tests existants de `ksp-wallet-lib` restent l'autorité pour la cryptographie, le no-clobber, la persistance et les garanties VIEW/OWNER du format V1.

## Dépendances

Aucune dépendance Cargo ou npm n'est ajoutée/modifiée dans cette tranche.

**Aucune commande npm directe n'est nécessaire.**

## Validation opérateur requise

```bash
cargo fmt --all
python3 scripts/audit_rust_workspace_rules.py
cargo check --workspace
cargo clippy --workspace --all-targets
cargo test -p ksp-app-wallet-desk
cargo test --workspace
KSP_WALLETS_DIRECTORY=var/wallet-desk-pre005 cargo tauri dev -c crates/ksp-app-wallet-desk/tauri.conf.json
```

Vérification UI recommandée :

```text
Create / Import
-> choisir un filename *.kspwallet neuf
-> saisir OWNER password
-> activer ou non VIEW et saisir son password si activé
-> alias/note optionnels
-> Create wallet
-> vérifier session OWNER + fa-lock-open + Pubkey
-> vérifier apparition dans DataTable
-> Lock -> fa-lock + purge Pubkey/alias/notes
-> Deselect -> NoSelection
-> recréer même filename -> échec no-clobber
-> Refresh pendant OWNER -> session purgée
```

Toujours aucun `cargo tauri build` à ce stade.

## Suite

Après validation de `pre.005`, `pre.006` ajoutera l'unlock manuel VIEW/OWNER et le provider Config `KSP_SECRET_WALLET_PASS_*`, sans auto-unlock silencieux.