v0.2.11-pre.001

2026-08-25 17:50:08 +02:00
parent afaa9c0239
commit a8e980b225
13 changed files with 1216 additions and 31 deletions
--- a/docs/architecture/002-LAYERS_AND_DEPENDENCIES.md
+++ b/docs/architecture/002-LAYERS_AND_DEPENDENCIES.md
@@ -1,5 +1,5 @@
 <!-- file: docs/architecture/002-LAYERS_AND_DEPENDENCIES.md -->
-<!-- version: 6 -->
+<!-- version: 7 -->

 # Couches et dépendances KSP

@@ -134,7 +134,7 @@ Les applications Tauri restent minces :
 - instrumentation frontend ;
 - aucun déplacement de logique de transport, Wallet, Config, Program, Store ou Materializer dans Tauri.

-Des applications spécialisées sont ajoutées au fur et à mesure pour valider les couches : Config Desk, Wallet Desk, Price Desk, backfill/RAW tooling, CORE tooling puis Market Desk.
+Des applications spécialisées sont ajoutées au fur et à mesure pour valider les couches : Config Desk, Wallet Desk, `ksp-app-solprices-desk`, backfill/RAW tooling, CORE tooling puis Market Desk. `ksp-app-solprices-desk` reste une HID mince : elle consomme l’inventaire, les observations, les états et les opérations génériques de `ksp-offchain-transport-lib` sans connaître les providers, leurs endpoints, leurs credentials ni leurs limites.

 ## Workers et jobs

--- a/docs/architecture/003-COMPONENT_CONTRACTS.md
+++ b/docs/architecture/003-COMPONENT_CONTRACTS.md
@@ -1,5 +1,5 @@
 <!-- file: docs/architecture/003-COMPONENT_CONTRACTS.md -->
-<!-- version: 7 -->
+<!-- version: 8 -->

 # Contrats initiaux des composants KSP

@@ -72,7 +72,13 @@ La complétude vaut aussi à l'intérieur de chaque opération : paramètres, op

 Aucune `ksp-offchain-transport-api` commune n'est prévue.

-`ksp-offchain-transport-lib` peut contenir plusieurs modules/APIs distincts : prix, metadata HTTP/IPFS/Arweave, quotes et autres accès externes. La première surface engagée est le prix SOL/USD et SOL/EUR.
+`ksp-offchain-transport-lib` peut contenir plusieurs modules/APIs distincts : prix, metadata HTTP/IPFS/Arweave, quotes et autres accès externes. La première surface engagée par `0.2.11` est exclusivement le prix SOL/USD.
+
+Pour cette surface, Off-chain Transport possède le registry runtime des providers, leurs adapters/wires privés, leurs capacités et contraintes de refresh, la classification des indisponibilités et l'orchestration de refresh individuel/multiple. Plusieurs providers peuvent produire la même paire sans que KSP invente un consensus, une moyenne ou un fallback automatique.
+
+Les adapters provider V1 utilisent uniquement `reqwest` et les primitives génériques du workspace ; aucun SDK provider n'est introduit. Config peut adapter ses documents vers les settings publics provider-capability-aware, mais Off-chain Transport ne lit jamais directement l'environnement ou les fichiers Config.
+
+La future `ksp-app-solprices-desk` est une HID provider-agnostic : elle liste et déclenche uniquement les surfaces génériques de la crate. Toute connaissance de CoinGecko, CoinMarketCap, CoinPaprika, Kraken, Coinbase, Jupiter, Birdeye ou DexScreener reste sous Off-chain Transport/Config.

 ## Wallet

--- a/docs/architecture/004-COMPONENT_INVENTORY.md
+++ b/docs/architecture/004-COMPONENT_INVENTORY.md
@@ -1,5 +1,5 @@
 <!-- file: docs/architecture/004-COMPONENT_INVENTORY.md -->
-<!-- version: 21 -->
+<!-- version: 22 -->

 # Inventaire initial des composants KSP

@@ -29,11 +29,11 @@ Ce document maintient l'inventaire synthétique des composants retenus ou presse
 | Wallet V2               | `ksp-wallet-lib`                         | lib                | Stable       | `0.2.6`                         | wire/runtime V2 + API default/versionnée + migration explicite |
 | Standard WS             | `ksp-onchain-transport-lib`              | lib                | Stable       | `0.2.7`                         | WebSocket Solana 18/18, sessions/subscriptions bornées         |
 | Helius WS               | `ksp-onchain-transport-lib`              | lib                | Stable       | `0.2.8`                         | LaserStream WS : 7 standard + transaction, actor partagé       |
-| Yellowstone             | `ksp-onchain-transport-lib`              | lib                | Pressenti    | `0.2.9`                         | client gRPC standard/provider-neutral                          |
-| Off-chain price         | `ksp-offchain-transport-lib`             | lib                | Retenu       | `0.2.10`                        | première abstraction/provider de prix SOL/USD, SOL/EUR         |
-| Price Desk              | nom à fixer                              | app                | Retenu       | `0.2.11`                        | visualisation/validation des prix + intégration Wallet Desk    |
-| Wire                    | `ksp-interface-lib`                      | lib                | Retenu       | `0.2.12`                        | façade wire officielle + API publique wire                     |
-| Program API             | `ksp-program-api`                        | API                | Retenu       | `0.2.13`                        | contrats extensibles Program                                   |
+| Yellowstone             | `ksp-onchain-transport-lib`              | lib                | Stable       | `0.2.9`                         | client gRPC standard/provider-neutral                          |
+| Off-chain price         | `ksp-offchain-transport-lib`             | lib                | Actif        | `0.2.11`                        | prix SOL/USD multi-provider, limits et availability            |
+| SOL Prices Desk         | `ksp-app-solprices-desk`                 | app                | Retenu       | `0.2.12`                        | HID provider-agnostic pour visualisation/refresh prix          |
+| Wire                    | `ksp-interface-lib`                      | lib                | Retenu       | `0.2.13`                        | façade wire officielle + API publique wire                     |
+| Program API             | `ksp-program-api`                        | API                | Retenu       | `0.2.14`                        | contrats extensibles Program                                   |
 | Program impl.           | `ksp-program-lib`                        | lib                | Retenu       | vertical slices ultérieurs      | implementations Program officielles                            |
 | Program extension       | `ksp-program-<name>-lib`                 | lib externe        | À la demande | dès besoin                      | implementation externe de `ksp-program-api`                    |
 | Store API               | `ksp-store-api`                          | API                | Retenu       | `0.3.1`                         | contrats persistence backend-agnostic, RAW d'abord             |
@@ -87,6 +87,8 @@ Les WebSockets supportent plusieurs sessions pour un même endpoint URL, mais un

 Les providers Yellowstone spécifiques restent des extensions futures ; le contrat standard est provider-neutral.

+`ksp-offchain-transport-lib` ouvre en `0.2.11` une première surface SOL/USD multi-provider. La crate possède les adapters `reqwest`, les capacités/rate limits, l’état runtime et le refresh individuel/multiple. Elle ne dépend pas de Config et n’expose aucun wire provider comme contrat de l’application. `ksp-app-solprices-desk`, prévu en `0.2.12`, consomme exclusivement cette surface générique et reste une HID sans connaissance provider.
+
 ## Wallet

 Le format natif est `.kspwallet`.
--- a/docs/architecture/005-DEPENDENCY_GRAPH.md
+++ b/docs/architecture/005-DEPENDENCY_GRAPH.md
@@ -1,5 +1,5 @@
 <!-- file: docs/architecture/005-DEPENDENCY_GRAPH.md -->
-<!-- version: 13 -->
+<!-- version: 14 -->

 # Graphe de dépendances KSP

@@ -120,12 +120,22 @@ Yellowstone gRPC est un backend standard/provider-neutral. Les adapters/capabili
 ksp-offchain-transport-lib
    -> ksp-core-lib
    -> ksp-logging-lib
-    -> external HTTP/client crates nécessaires
+    -> reqwest
+    -> serde / serde_json
+    -> tokio
 ```

 Aucune `ksp-offchain-transport-api` globale n'est prévue.

-La première surface est un reader de prix ; metadata HTTP/IPFS/Arweave et autres besoins sont ajoutés lorsqu'ils deviennent concrets.
+La première surface `0.2.11` est SOL/USD uniquement et peut être servie par plusieurs adapters REST. Aucun SDK provider n'est ajouté : les DTOs wire restent privés et les origines provider V1 sont fixes. La crate possède le registry, les capacités/rate limits, les cooldowns, l'état d'indisponibilité et les refresh individuel/multiple.
+
+```text
+ksp-offchain-transport-lib -X-> ksp-config-lib
+ksp-offchain-transport-lib -X-> ksp-onchain-transport-lib
+ksp-offchain-transport-lib -X-> provider SDKs
+```
+
+Config peut dépendre d'Off-chain Transport pour adapter un document standard vers ses settings publics. Metadata HTTP/IPFS/Arweave et autres besoins sont ajoutés lorsqu'ils deviennent concrets.

 ## Wallet

@@ -390,15 +400,17 @@ ksp-app-wallet-desk

 L'app compose ; elle ne déplace pas Config/Wallet/Transport dans Tauri. Les handles `WalletView`/`WalletOwner` restent côté Rust, et le frontend ne reçoit que des DTOs sûrs. Config fournit la racine/profil Wallet et le profil Transport. Les passwords Wallet ne deviennent jamais des champs des documents JSON Config ; ils peuvent être saisis éphémèrement frontend -> Rust ou provenir plus tard de secrets process/`.env` `KSP_SECRET_WALLET_PASS_*` possédés exclusivement par Config. Le secret Solana ne devient jamais une valeur Config ni un DTO frontend.

-### Price Desk
+### SOL Prices Desk

 ```text
-price desk
+ksp-app-solprices-desk
    -> ksp-config-lib
    -> ksp-offchain-transport-lib
    -> ksp-logging-lib
 ```

+L'application est une HID pure. Elle ne dépend d'aucun SDK provider, ne construit aucune requête HTTP provider et ne connaît ni endpoint, ni credential, ni limite provider. Les rows et actions de refresh sont alimentées par les descriptors/états/opérations génériques de `ksp-offchain-transport-lib`.
+
 ### Backfill app

 ```text