127 lines
4.0 KiB
Markdown
127 lines
4.0 KiB
Markdown
<!-- file: deltas/0.3.8/pre.008.md -->
|
|
<!-- version: 1 -->
|
|
|
|
# Delta `0.3.8-pre.008` — RAW Accounts DataTables server-side + détail
|
|
|
|
## Base requise
|
|
|
|
Base directe attendue : `0.3.8-pre.007-fix.003` (`workspace.package.version = 0.3.8-pre.7.fix.3`).
|
|
|
|
## Objet
|
|
|
|
Brancher la vue `RAW Accounts` de `ksp-app-store-desk` sur les capabilities backend-neutrales `RawAccountStateInspectionRead` et `RawAccountStateRead`, sans modifier Store API, Store façade, PostgreSQL ou les queries keyset machine.
|
|
|
|
## Backend applicatif
|
|
|
|
Store Desk ajoute cinq DTO app-owned et deux commands Tauri :
|
|
|
|
```text
|
|
store_query_accounts
|
|
store_get_account_detail
|
|
```
|
|
|
|
`store_query_accounts` reçoit uniquement :
|
|
|
|
```text
|
|
offset decimal
|
|
limit = 25 | 50 | 100
|
|
pubkey exacte optionnelle
|
|
slot_min optionnel
|
|
slot_max optionnel
|
|
direction = ascending | descending
|
|
```
|
|
|
|
Le network n'est jamais fourni par le frontend : il est dérivé du `ksp-store-lib::Store` déjà ouvert. Le runtime construit `RawInspectionPageRequest` + `RawAccountStateInspectionQuery` puis appelle `RawAccountStateInspectionRead`.
|
|
|
|
La réponse app-owned contient :
|
|
|
|
```text
|
|
rows data-free
|
|
records_total_decimal
|
|
records_filtered_decimal
|
|
```
|
|
|
|
Tous les `u64` susceptibles de dépasser le domaine JS-safe restent encodés en texte décimal.
|
|
|
|
## Table Accounts
|
|
|
|
La table passe à :
|
|
|
|
```text
|
|
serverSide: true
|
|
searching: false
|
|
ordering: false
|
|
pageLength: 25
|
|
lengthMenu: [25, 50, 100]
|
|
ajax: fonction custom -> invoke Tauri
|
|
```
|
|
|
|
Le mapping visible est :
|
|
|
|
```text
|
|
DataTables start -> offset
|
|
DataTables length -> limit
|
|
Store total -> recordsTotal
|
|
Store filtered -> recordsFiltered
|
|
Store summaries -> data
|
|
DataTables draw -> frontend uniquement
|
|
```
|
|
|
|
Les filtres Store explicites sont `pubkey` exacte, `slot min`, `slot max` et `direction`. Tout changement de filtre redessine depuis la première page. Aucun pager Store ou cursor n'est rendu.
|
|
|
|
## Rows et détail
|
|
|
|
Les rows exposent uniquement pubkey, slot, state hash, owner, lamports, executable, rent epoch et data length. Aucun byte Account n'est présent dans la table.
|
|
|
|
Le bouton `Détail` recharge l'identité exacte `(pubkey, slot, state_hash)` via `RawAccountStateRead`. Le modal expose :
|
|
|
|
- pubkey, slot, state hash, owner, lamports, executable et rent epoch ;
|
|
- data length exacte ;
|
|
- preview hex des 512 premiers bytes maximum ;
|
|
- flag explicite de troncature ;
|
|
- bouton de copie du preview affiché uniquement, sans charger le reste des bytes.
|
|
|
|
Pubkey, owner et state hash réutilisent le helper générique de troncature centrale + tooltip valeur complète + copie stabilisé par les fixes `pre.007`.
|
|
|
|
## Sécurité / instrumentation
|
|
|
|
- rejet Rust de `length=-1` et de toute taille autre que 25/50/100 ;
|
|
- offset/slots/pubkey/state hash parsés sans écho de valeur dans les erreurs ;
|
|
- counts décimaux convertis côté TypeScript seulement après contrôle `Number.MAX_SAFE_INTEGER` ;
|
|
- aucune search/order DataTables arbitraire dans le contrat IPC ;
|
|
- aucune URI, credential, SQL, handle PostgreSQL ou byte Account dans les logs ;
|
|
- tracing query/page/page-length/redraw/refresh/détail/copie sans valeurs de filtres ni identité ;
|
|
- nouveaux items `pub(crate)` réexportés par `lib.rs` et consommés via `crate::Item` conformément aux règles KSP.
|
|
|
|
## Hors scope
|
|
|
|
Aucune observation Store n'est ajoutée à l'UI ; cette extension reste réservée à `pre.009`/`pre.010`. Aucun changement de Store API, Store façade, PostgreSQL, migration, index, capability ou Config composite.
|
|
|
|
## Version
|
|
|
|
```text
|
|
delivery = 0.3.8-pre.008
|
|
workspace.package.version = 0.3.8-pre.8
|
|
commit = v0.3.8-pre.008
|
|
tag = aucun
|
|
```
|
|
|
|
## Gate requis
|
|
|
|
```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
|
|
cargo check --workspace
|
|
cargo clippy --workspace --all-targets
|
|
cargo test -p ksp-app-store-desk
|
|
cargo test -p ksp-store-lib
|
|
cargo check -p ksp-store-lib --no-default-features
|
|
```
|
|
|
|
Smoke runtime recommandé :
|
|
|
|
```bash
|
|
(cd crates/ksp-app-store-desk && cargo tauri dev)
|
|
```
|