Files
khadhroony-solana-project/deltas/0.2.12/pre.008-fix.002.md

79 lines
4.1 KiB
Markdown

<!-- file: deltas/0.2.12/pre.008-fix.002.md -->
<!-- version: 1 -->
# Delta `0.2.12-pre.008-fix.002` — équivalent USD Wallet et version desktop dynamique
## Base
```text
0.2.12-pre.008-fix.001
```
## Cause
Le gate opérateur de `pre.008-fix.001` confirme `cargo fmt`, les audits KSP, `cargo check --workspace`, Clippy et le démarrage Tauri. Le refresh Wallet exécute aussi correctement `getBalance` et la collecte SOL/USD : huit providers sont chargés, six observations sont produites et la moyenne est disponible.
Deux écarts restent néanmoins visibles :
- la vue Details n'affiche ni le prix moyen SOL/USD calculé ni l'équivalent USD de la balance demandé par l'opérateur ;
- le badge principal de Wallet Desk reste figé à `0.2.6`, et le canari historique de packaging recherche encore une version littérale dans `frontend/main.html`, ce qui fait échouer `cargo test -p ksp-app-wallet-desk` après le passage à `0.2.12-pre.8.fix.1`.
## Correctif
- version workspace : `0.2.12-pre.8.fix.2` ;
- versions npm/Tauri Wallet Desk synchronisées sur `0.2.12-pre.8.fix.2` ;
- `WalletBalanceDto` gagne `sol_usd_equivalent: Option<String>` ;
- l'équivalent USD est calculé côté Rust à partir des lamports et de `sol_usd_average`, sans `f64`/`f32`, avec arrondi half-up à huit décimales maximum et dégradation à `None` si le prix auxiliaire est absent ou si l'arithmétique ne peut pas être représentée ;
- Dashboard et Details affichent désormais le prix moyen en `USD/SOL` et l'équivalent de la balance en `USD`, ou `N.A.` lorsque la moyenne auxiliaire est indisponible ;
- le badge statique `0.2.6` est remplacé par un élément alimenté par `RuntimeStatusDto.application_version` ;
- le canari `pre_018_packaged_runtime_bundles_config_resources_and_keeps_wallet_desk_version_coherent` vérifie le binding dynamique de version au lieu de rechercher la version courante en littéral dans le HTML ;
- les canaris `pre.008` vérifient l'absence de calcul flottant frontend et la présence des projections moyenne/équivalent dans Dashboard et Details.
## Invariants préservés
```text
getBalance autoritatif inchangé
MarketPriceService::refresh_all inchangé
providers utilisés pour la moyenne succès du refresh courant uniquement
prix auxiliaire indisponible balance SOL valide, moyenne/équivalent N.A.
provider_id / URL / credential frontend absents
commande prix dédiée Wallet absente
fetch / calcul prix frontend absents
WalletSession VIEW/OWNER inchangée
```
Aucune donnée provider détaillée n'est ajoutée à Wallet Desk. L'équivalent USD est une projection auxiliaire dérivée de la moyenne déjà calculée par `pre.008` ; SOL Prices Desk reste l'application dédiée aux observations et disponibilités provider par provider.
## Fichiers modifiés/ajoutés
```text
Cargo.toml
crates/ksp-app-wallet-desk/package.json
crates/ksp-app-wallet-desk/tauri.conf.json
crates/ksp-app-wallet-desk/frontend/main.html
crates/ksp-app-wallet-desk/frontend/ts/main.ts
crates/ksp-app-wallet-desk/src/app_state.rs
crates/ksp-app-wallet-desk/src/lib.rs
crates/ksp-app-wallet-desk/src/wallet_balance.rs
crates/ksp-app-wallet-desk/tests/desktop_contract.rs
crates/ksp-app-wallet-desk/unit_tests/wallet_balance.rs
docs/plans/019-V0_2_12_SOL_PRICES_DESK_PLAN.md
docs/validation/015-V0_2_12_SOL_PRICES_DESK.md
deltas/0.2.12/pre.008-fix.002.md
```
## Gate opérateur attendu
```bash
cargo fmt --all
python3 scripts/audit_rust_workspace_rules.py
python3 scripts/audit_markdown_tables.py README.md RULES.md ROADMAP.md CHANGELOG.md docs prompts crates deltas/0.2.12
cargo check --workspace
cargo clippy --workspace --all-targets
cargo test -p ksp-app-wallet-desk
cargo test --workspace
(cd crates/ksp-app-wallet-desk && cargo tauri dev)
```
Le contrôle manuel doit confirmer que Details affiche le prix moyen SOL/USD et l'équivalent USD après `Refresh balance`, que Dashboard reflète les mêmes valeurs, et que le badge d'application n'affiche plus une version statique obsolète.