khadhroony-solana-project/deltas/0.2.5/pre.010.md

Delta 0.2.5-pre.010

Objet

Clôturer documentairement 0.2.5 — Wallet foundation après le gate security/interoperability/compliance pre.009 validé, sans modifier le code de production, les dépendances, la cryptographie ni le wire .kspwallet V1.

Cette tranche prépare la candidate de publication rel.001 et le prompt d'ouverture de 0.2.6 — Wallet Desk.

Base validée

Base fonctionnelle :

0.2.5-pre.009
workspace.package.version = 0.2.5-pre.9

Checkpoint opérateur communiqué le 2026-08-19 :

cargo fmt --all                         OK
cargo check --workspace                 OK, aucun warning
cargo clippy --workspace --all-targets  OK, aucun warning
cargo test -p ksp-wallet-lib            OK
  unit                                  58 passed / 1 ignored
  dependency_boundary                    3 passed
  public_api                             9 passed
  doctests                               2 passed
cargo test --workspace                  OK

Audit inverse final communiqué :

ed25519-dalek 2.2.0
  <- ksp-wallet-lib
  <- solana-keypair 3.1.2 <- ksp-wallet-lib

solana-keypair 3.1.2
  <- ksp-wallet-lib uniquement comme parent KSP direct

solana-address 2.7.0
  <- solana-keypair 3.1.2
  <- solana-pubkey 4.3.0 via ksp-core-lib

Aucune remédiation de code, dépendance ou wire n'est requise par ce checkpoint.

Version Cargo

pre.010 est strictement documentaire. Conformément à la règle KSP faisant de workspace.package.version un signal technique, Cargo.toml n'est pas modifié et reste :

0.2.5-pre.9

La livraison/delta reste néanmoins identifiée :

0.2.5-pre.010

0.2.5-rel.001 effectuera le passage Cargo vers 0.2.5 lors de la publication stable.

Documentation Wallet ajoutée

crates/ksp-wallet-lib/README.md

Ajoute la synthèse consumer-facing de Wallet :

• responsabilités et hors-périmètre ;
• dépendances et frontières KSP ;
• états Locked/VIEW/OWNER ;
• format V1 et primitives ;
• persistence/no-clobber/state conflict ;
• import/export ;
• threat model et limites ;
• fixtures/tests et liens durables.

crates/ksp-wallet-lib/USAGE.md

Ajoute des exemples des surfaces publiques :

create_wallet_file_v1
inspect_locked_wallet_file_v1
open_wallet_view_file_v1
open_wallet_owner_file_v1
WalletOwner::sign
metadata administration
OWNER/VIEW password rotation
disable/recreate VIEW
inspect/import transfer
OWNER export
surfaces in-memory

Le guide rappelle explicitement que les octets d'export contiennent le secret et que Config/Transport restent hors de Wallet.

Spécification et validation finales

docs/formats/KSPWALLET_V1.md passe en candidate documentaire finale :

• toutes les tranches pre.006–pre.010 sont indiquées acquises ;
• aucune opération V1 n'est encore annoncée comme restant à implémenter ;
• la boundary async KDF est décrite au présent ;
• le tree final est rattaché au gate pre.009 ;
• une section de statut de clôture rappelle que rel.001 ne doit pas changer le wire.

docs/validation/008-V0_2_5_WALLET_SECURITY_COMPLIANCE.md devient la matrice finale :

• ajoute les résultats opérateur pre.009 ;
• enregistre les convergences Dalek/Solana-address/keypair ;
• ajoute le gate documentaire pre.010 ;
• porte le verdict final candidate positif ;
• pointe vers rel.001 strictement publicationnelle.

Graphes et plans

Le graphe Wallet documente désormais les dépendances réelles et rappelle :

Pubkey -> ksp-core-lib
Keypair -> encapsulée dans ksp-wallet-lib
Wallet -X-> Config/Transport/Tauri/Store/tracing direct/env

ROADMAP, séquence fonctionnelle, plan 0.2.5, indices formats/validation/docs et prompts sont synchronisés sur :

pre.010 acquis
rel.001 prochaine étape
0.2.6 Wallet Desk ensuite

Prompt 0.2.6

Ajoute :

prompts/011-V0_2_6_START_PROMPT.md

Le prompt impose 0.2.6-pre.001 comme gate d'audit/sizing avant UI lourde et cadre notamment :

• ksp-app-wallet-desk Tauri mince ;
• composition Config composite + Wallet + HTTP ;
• besoin minimal identité autorisée + getBalance ;
• audit d'un std.wallet minimal sans secret ;
• handles VIEW/OWNER possédés côté Rust ;
• passwords éphémères et aucun secret en Config/frontend persistence ;
• inventory/path safety ;
• administration OWNER via les APIs Wallet existantes ;
• logging Tauri via l'écosystème tracing KSP ;
• TS-RS uniquement à la frontière applicative ;
• smoke Devnet de composition possible dans l'app ;
• cargo tauri build comme dernière validation.

Fichiers

Ajoutés :

crates/ksp-wallet-lib/README.md
crates/ksp-wallet-lib/USAGE.md
prompts/011-V0_2_6_START_PROMPT.md
deltas/0.2.5/pre.010.md

Modifiés :

ROADMAP.md
docs/000-README.md
docs/architecture/005-DEPENDENCY_GRAPH.md
docs/formats/000-README.md
docs/formats/KSPWALLET_V1.md
docs/plans/002-FUNCTIONAL_RELEASE_SEQUENCE.md
docs/plans/012-V0_2_5_WALLET_FOUNDATION_PLAN.md
docs/validation/000-README.md
docs/validation/008-V0_2_5_WALLET_SECURITY_COMPLIANCE.md
prompts/000-README.md

Total delta : 14 fichiers.

Contrôles attendus

Le delta étant documentaire, aucun cargo tree supplémentaire n'est requis. Le checkpoint de clôture recommandé reste :

cargo fmt --all
cargo check --workspace
cargo clippy --workspace --all-targets
cargo test -p ksp-wallet-lib
cargo test --workspace

Vérifications documentaires :

liens Markdown relatifs valides
aucun fichier Rust modifié
Cargo.toml identique à pre.009
workspace.package.version toujours 0.2.5-pre.9
README/USAGE/spec/validation/plan/prompt cohérents

Suite

Si le checkpoint reste vert :

commit : v0.2.5-pre.010
next   : 0.2.5-rel.001

Aucun tag stable n'est créé pour pre.010.