v0.2.11-pre.012

crates/ksp-offchain-transport-lib/README.md

@@ -1,5 +1,5 @@
 <!-- file: crates/ksp-offchain-transport-lib/README.md -->
-<!-- version: 1 -->
+<!-- version: 2 -->
 
 # ksp-offchain-transport-lib
 
@@ -135,4 +135,12 @@ URL provider configurable
 - [`../../docs/plans/018-V0_2_11_OFFCHAIN_PRICE_TRANSPORT_PLAN.md`](../../docs/plans/018-V0_2_11_OFFCHAIN_PRICE_TRANSPORT_PLAN.md) — plan de release ;
 - [`../../docs/validation/014-V0_2_11_OFFCHAIN_PRICE_TRANSPORT.md`](../../docs/validation/014-V0_2_11_OFFCHAIN_PRICE_TRANSPORT.md) — matrice de validation.
 
-Ce README est un **brouillon technique de `pre.010`**. La réconciliation documentaire finale reste la responsabilité de `pre.012`, après le gate technique/live de `pre.011`.
+## Validation de release `0.2.11`
+
+La candidate finale a été validée sur les huit adapters par tests déterministes. Le smoke live keyless de clôture a réellement rafraîchi les sept modes ne nécessitant aucun credential : Coinbase Exchange, CoinGecko, CoinMarketCap, CoinPaprika, DexScreener, Jupiter et Kraken. Un premier passage a révélé le paramètre CoinMarketCap V2 erroné `ids`; `pre.011-fix.001` l'a corrigé en `id=5426`, puis le re-smoke a passé les sept providers.
+
+Birdeye n'expose pas de mode keyless V1. Le smoke keyed commun Birdeye/CoinGecko Demo/CoinMarketCap Basic/Jupiter Free reste opt-in et peut être `SKIP opérateur` lorsque les quatre credentials gratuits ne sont pas disponibles. KSP ne transforme jamais cette absence de credentials en preuve live fictive.
+
+Les offres gratuites, quotas et conditions d'usage appartiennent aux providers et peuvent évoluer indépendamment du contrat KSP. Les descriptors représentent le snapshot audité pour `0.2.11`; un changement commercial ou de quota futur peut rendre un provider indisponible sans modifier la façade provider-neutral.
+
+Ce README est la documentation durable de la surface `0.2.11`. Les détails de construction et les commandes de smoke sont conservés dans [`USAGE.md`](USAGE.md), tandis que le plan et la matrice de validation enregistrent les décisions et preuves de release.

crates/ksp-offchain-transport-lib/USAGE.md

@@ -1,9 +1,9 @@
 <!-- file: crates/ksp-offchain-transport-lib/USAGE.md -->
-<!-- version: 1 -->
+<!-- version: 2 -->
 
 # Usage de ksp-offchain-transport-lib
 
-Cette page montre la surface technique disponible à `0.2.11-pre.010`. Les credentials et documents runtime doivent normalement être résolus par `ksp-config-lib`; les constructions directes ci-dessous servent surtout aux tests, outils bas niveau et compositions programmatiques maîtrisées.
+Cette page documente la surface stable préparée pour `0.2.11`. Les credentials et documents runtime doivent normalement être résolus par `ksp-config-lib`; les constructions directes ci-dessous servent surtout aux tests, outils bas niveau et compositions programmatiques maîtrisées.
 
 ## 1. Construire un service programmatique
 
@@ -147,6 +147,35 @@ payload de Config secret
 
 `ksp-offchain-transport-lib` utilise `ksp-logging-lib` et son `TRACING_TARGET` propriétaire ; une application ne doit pas ajouter un bypass direct `tracing` pour obtenir les payloads rejetés.
 
-## 10. Statut documentaire
+## 10. Smokes live de release
 
-Ce document est un **brouillon technique de `pre.010`**. Il ne vaut ni smoke live, ni garantie commerciale sur les plans gratuits des providers. `pre.011` porte les contrôles techniques/live finaux ; `pre.012` porte la réconciliation documentaire finale.
+Le smoke keyless final ne requiert aucun secret et couvre les sept modes V1 concernés :
+
+```bash
+cargo test -p ksp-offchain-transport-lib \
+  --test market_price_live_smoke \
+  keyless_market_price_providers_live_smoke \
+  -- --ignored --exact --nocapture --test-threads=1
+```
+
+Le gate `0.2.11-pre.011-fix.001` a passé ce smoke en `7/7`. Le test ne compare jamais les providers à un prix exact commun : il valide l'identité, la paire SOL/USD, la sémantique, un prix canonique positif et la cohérence des timestamps disponibles.
+
+Le smoke keyed reste volontairement distinct. Il lit quatre clés sur `stdin`, dans l'ordre Birdeye, CoinGecko Demo, CoinMarketCap Basic et Jupiter Free :
+
+```bash
+printf '%s\n%s\n%s\n%s\n' \
+  "$KSP_SECRET_BIRDEYE_API_KEY" \
+  "$KSP_SECRET_COINGECKO_DEMO_API_KEY" \
+  "$KSP_SECRET_COINMARKETCAP_API_KEY" \
+  "$KSP_SECRET_JUPITER_API_KEY" \
+| cargo test -p ksp-offchain-transport-lib \
+    --test market_price_live_smoke \
+    keyed_market_price_providers_live_smoke \
+    -- --ignored --exact --nocapture --test-threads=1
+```
+
+Ce second smoke peut être omis si l'opérateur ne possède pas les quatre credentials ; l'absence de credentials doit alors rester explicitement `SKIP opérateur`.
+
+## 11. Statut documentaire
+
+Ce document est la référence d'usage durable de la surface `market_price` livrée par `0.2.11`. Il ne promet ni prix identique entre providers, ni disponibilité permanente de leurs plans gratuits, ni compatibilité avec une surface provider qui changerait après la release.

crates/ksp-offchain-transport-lib/src/lib.rs

@@ -1,5 +1,5 @@
 // file: crates/ksp-offchain-transport-lib/src/lib.rs
-// version: 11
+// version: 12
 
 #![warn(missing_docs)]
 #![deny(unreachable_pub)]
@@ -7,7 +7,7 @@
 
 //! KSP-owned off-chain transport foundation.
 //!
-//! `0.2.11-pre.010` hardens the complete SOL/USD V1 surface over eight providers. The crate owns exact decimal normalization, provider adapters, hardened
+//! `0.2.11` delivers the complete SOL/USD V1 surface over eight providers. The crate owns exact decimal normalization, provider adapters, hardened
 //! HTTP, non-blocking rate-limit/cooldown handling, provider-neutral registry/availability and individual/multiple/all refresh operations. Provider-specific
 //! setup remains confined to composition while runtime consumers can operate on opaque provider identifiers, registry projections and normalized outcomes.
 //! Config integration is implemented externally by `ksp-config-lib`; this crate remains independent from Config and never reads KSP environment variables