186 lines
5.9 KiB
Markdown
186 lines
5.9 KiB
Markdown
<!-- file: deltas/0.2.11/pre.002-fix.003.md -->
|
|
<!-- version: 1 -->
|
|
|
|
# Delta `0.2.11-pre.002-fix.003` — nommage public `MarketPrice*`
|
|
|
|
## 1. Base requise
|
|
|
|
Ce correctif s'applique exclusivement après :
|
|
|
|
```text
|
|
v0.2.10
|
|
+ 0.2.11-pre.001
|
|
+ 0.2.11-pre.001-fix.001
|
|
+ 0.2.11-pre.002
|
|
+ 0.2.11-pre.002-fix.001
|
|
+ 0.2.11-pre.002-fix.002
|
|
```
|
|
|
|
La version Cargo attendue avant application est :
|
|
|
|
```text
|
|
0.2.11-pre.2.fix.2
|
|
```
|
|
|
|
## 2. Motif du correctif
|
|
|
|
`pre.002-fix.001` a correctement classé la première capacité de `ksp-offchain-transport-lib` sous les modules privés `market_price_*`, mais sa façade crate-root conservait des noms publics génériques `Price*`.
|
|
|
|
Cette asymétrie créerait une dette publique dès l'apparition d'autres familles hétérogènes, notamment :
|
|
|
|
```text
|
|
swap_quote_*
|
|
metadata_*
|
|
autres données off-chain futures
|
|
```
|
|
|
|
Des noms tels que `PriceProviderId`, `PriceProviderState` ou `PriceTimestamp` pourraient alors être interprétés comme des abstractions crate-wide alors qu'ils ne sont actuellement prouvés que pour la famille `market_price`.
|
|
|
|
Le correctif applique donc la même frontière de responsabilité aux modules privés et à la façade publique avant l'introduction du runtime HTTP de `pre.003`.
|
|
|
|
## 3. Convention publique retenue
|
|
|
|
Toute API spécifique à la famille `market_price` porte désormais le préfixe :
|
|
|
|
```text
|
|
MarketPrice*
|
|
```
|
|
|
|
et toute constante correspondante :
|
|
|
|
```text
|
|
MARKET_PRICE_*
|
|
ERROR_CODE_MARKET_PRICE_*
|
|
```
|
|
|
|
Exemples principaux :
|
|
|
|
```text
|
|
PriceDecimal -> MarketPriceDecimal
|
|
SolUsdPriceObservation -> MarketPriceObservation
|
|
PriceTimestamp -> MarketPriceTimestamp
|
|
PriceProvenance -> MarketPriceProvenance
|
|
PricePair -> MarketPricePair
|
|
PriceSemantics -> MarketPriceSemantics
|
|
PriceProviderId -> MarketPriceProviderId
|
|
PriceProviderDescriptor -> MarketPriceProviderDescriptor
|
|
PriceProviderRateLimit -> MarketPriceProviderRateLimit
|
|
PriceProviderAvailability -> MarketPriceProviderAvailability
|
|
PriceProviderState -> MarketPriceProviderState
|
|
PriceProviderCommonSettings -> MarketPriceProviderCommonSettings
|
|
```
|
|
|
|
Les enums de rate-limit/quota/auth suivent la même règle.
|
|
|
|
Aucun alias public `Price*` n'est conservé. La release est encore en prerelease et conserver ces aliases figerait précisément l'ambiguïté que ce correctif doit supprimer.
|
|
|
|
## 4. Observation V1
|
|
|
|
`SolUsdPriceObservation` devient `MarketPriceObservation` plutôt que `MarketPriceSolUsdObservation`.
|
|
|
|
La paire réellement supportée reste portée explicitement par :
|
|
|
|
```text
|
|
MarketPricePair::SolUsd
|
|
```
|
|
|
|
Cette forme évite un nouveau renommage du type observation si une version ultérieure étend proprement la famille `market_price` à d'autres paires, tout en conservant le gate V1 strictement limité à SOL/USD.
|
|
|
|
## 5. Codes d'erreur
|
|
|
|
Les identifiants publics et les codes textuels spécifiques à cette famille sont également namespacés :
|
|
|
|
```text
|
|
market_price_decimal_invalid
|
|
market_price_provider_descriptor_invalid
|
|
market_price_provider_id_invalid
|
|
market_price_observation_invalid
|
|
market_price_provider_settings_invalid
|
|
```
|
|
|
|
Le domaine `ksp_core_lib::ErrorCode` reste :
|
|
|
|
```text
|
|
offchain_transport
|
|
```
|
|
|
|
Une future famille peut ainsi ajouter ses propres codes sans collision sémantique avec `market_price`.
|
|
|
|
## 6. Version technique
|
|
|
|
Le correctif modifie du Rust public. `VER-ID-007` et `VER-ID-010` imposent donc :
|
|
|
|
```text
|
|
workspace.package.version = 0.2.11-pre.2.fix.3
|
|
```
|
|
|
|
## 7. Validation opérateur acquise avant ce fix
|
|
|
|
L'état `0.2.11-pre.002-fix.002` a été validé par l'opérateur le `2026-08-25` avec :
|
|
|
|
```text
|
|
cargo fmt --all exécuté
|
|
python3 scripts/audit_rust_workspace_rules.py clean
|
|
python3 scripts/audit_markdown_tables.py clean, 116 tables / 104 files
|
|
cargo check --workspace PASS
|
|
cargo test -p ksp-offchain-transport-lib PASS, 10 unit + 1 boundary + 2 public API
|
|
cargo clippy --workspace --all-targets PASS
|
|
```
|
|
|
|
`cargo test --workspace` n'a pas été rejoué après `pre.002-fix.002` et n'est donc pas déclaré PASS pour cet état exact.
|
|
|
|
## 8. Validations demandées après application
|
|
|
|
```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.11
|
|
cargo check --workspace
|
|
cargo clippy --workspace --all-targets
|
|
cargo test -p ksp-offchain-transport-lib
|
|
cargo test --workspace
|
|
```
|
|
|
|
Le canari public doit notamment compiler exclusivement avec les noms `MarketPrice*` et ne plus trouver de surface publique `Price*` historique.
|
|
|
|
## 9. Scope inchangé
|
|
|
|
Ce correctif reste strictement rattaché à la fondation `pre.002` :
|
|
|
|
```text
|
|
aucun reqwest
|
|
aucun client HTTP
|
|
aucun limiter actif
|
|
aucun adapter provider
|
|
aucun credential provider
|
|
aucune nouvelle paire
|
|
aucune quote Jupiter
|
|
```
|
|
|
|
`pre.003` reste propriétaire du premier runtime HTTP commun.
|
|
|
|
## 10. Fichiers modifiés
|
|
|
|
```text
|
|
Cargo.toml
|
|
crates/ksp-offchain-transport-lib/src/error.rs
|
|
crates/ksp-offchain-transport-lib/src/lib.rs
|
|
crates/ksp-offchain-transport-lib/src/market_price_decimal.rs
|
|
crates/ksp-offchain-transport-lib/src/market_price_observation.rs
|
|
crates/ksp-offchain-transport-lib/src/market_price_provider.rs
|
|
crates/ksp-offchain-transport-lib/src/market_price_settings.rs
|
|
crates/ksp-offchain-transport-lib/tests/public_api.rs
|
|
crates/ksp-offchain-transport-lib/unit_tests/market_price_decimal.rs
|
|
crates/ksp-offchain-transport-lib/unit_tests/market_price_observation.rs
|
|
crates/ksp-offchain-transport-lib/unit_tests/market_price_provider.rs
|
|
crates/ksp-offchain-transport-lib/unit_tests/market_price_settings.rs
|
|
docs/plans/018-V0_2_11_OFFCHAIN_PRICE_TRANSPORT_PLAN.md
|
|
docs/validation/014-V0_2_11_OFFCHAIN_PRICE_TRANSPORT.md
|
|
```
|
|
|
|
## 11. Fichier ajouté
|
|
|
|
```text
|
|
deltas/0.2.11/pre.002-fix.003.md
|
|
```
|