v0.2.4-pre.009
This commit is contained in:
@@ -1,5 +1,5 @@
|
||||
<!-- file: docs/plans/011-V0_2_4_HTTP_BLOCKS_ECONOMICS_PLAN.md -->
|
||||
<!-- version: 5 -->
|
||||
<!-- version: 6 -->
|
||||
|
||||
# Plan `0.2.4` — HTTP Blocks + Economics + compliance HTTP finale
|
||||
|
||||
@@ -18,6 +18,8 @@ Ce plan ouvre `0.2.4` par `0.2.4-pre.001` sur la base stable attendue `v0.2.3`.
|
||||
|
||||
La mission de `0.2.4` est strictement de compléter les **10 Blocks + 5 Economics** déjà affectées à `V0_2_4`, puis de fermer la compliance HTTP globale **52/52 current + 14/14 historical** sous la règle `KSP-TRANSPORT-007`.
|
||||
|
||||
`0.2.4-pre.009` amène ce plan au statut **candidate de clôture** : les 15/15 wrappers `V0_2_4` sont implémentés, l'inventaire officiel final reste 52 current + 14 Deprecated, les deux ensembles correspondent exactement au registre KSP et la matrice durable de clôture est `docs/validation/007-V0_2_4_HTTP_FINAL_COMPLIANCE.md`. Le statut stable reste réservé à `rel.001`.
|
||||
|
||||
## Gate de sizing `pre.001`
|
||||
|
||||
Question obligatoire :
|
||||
@@ -427,13 +429,65 @@ historical Deprecated/Removed == 14/14
|
||||
KSP-TRANSPORT-007 audited current == 52/52
|
||||
```
|
||||
|
||||
La compliance `KSP-TRANSPORT-007` des 37 wrappers de `0.2.1`–`0.2.3` reste acquise par `docs/validation/005-V0_2_3_KSP_TRANSPORT_007_RETRO_AUDIT.md`; la clôture `0.2.4` vérifie qu'aucune régression n'a été introduite et applique la même règle aux 15 nouveaux wrappers. Le réaudit final inclut explicitement l'état des SIMD susceptibles de modifier la surface HTTP ou sa sémantique observable, au minimum SIMD-0180, SIMD-0298, SIMD-0301, SIMD-0307, SIMD-0385, SIMD-0490, SIMD-0550 et SIMD-0553, afin qu'une évolution devenue stable pendant la session ne soit pas oubliée. Il réaudite aussi l'inventaire officiel lui-même afin de détecter d'éventuels nouveaux endpoints issus de SIMD-0180 ou d'une autre évolution d'interface.
|
||||
La compliance `KSP-TRANSPORT-007` des 37 wrappers de `0.2.1`–`0.2.3` reste acquise par `docs/validation/005-V0_2_3_KSP_TRANSPORT_007_RETRO_AUDIT.md`; la clôture `0.2.4` vérifie qu'aucune régression n'a été introduite et applique la même règle aux 15 nouveaux wrappers. Le réaudit final inclut explicitement les extensions wire déjà acquises SIMD-0118 et SIMD-0291, puis l'état des SIMD susceptibles de modifier la surface HTTP ou sa sémantique observable, au minimum SIMD-0180, SIMD-0298, SIMD-0301, SIMD-0307, SIMD-0385, SIMD-0490, SIMD-0550 et SIMD-0553, afin qu'une évolution devenue stable pendant la session ne soit pas oubliée. Il réaudite aussi l'inventaire officiel lui-même afin de détecter d'éventuels nouveaux endpoints issus de SIMD-0180 ou d'une autre évolution d'interface.
|
||||
|
||||
## Réaudit final `pre.009`
|
||||
|
||||
Le réaudit du **18 août 2026** confirme l'index HTTP officiel actuel sans recalibrage :
|
||||
|
||||
```text
|
||||
Solana current HTTP exact names == KSP current registry exact names == 52
|
||||
Solana Deprecated exact names == KSP historical exact names == 14
|
||||
missing == 0
|
||||
extra == 0
|
||||
```
|
||||
|
||||
La navigation officielle actuelle ne contient aucun nouvel endpoint HTTP issu de SIMD-0180.
|
||||
|
||||
État final de la watchlist prospective :
|
||||
|
||||
```text
|
||||
SIMD-0180 Review
|
||||
SIMD-0298 Idea
|
||||
SIMD-0301 PR closed / unmerged
|
||||
SIMD-0307 Review
|
||||
SIMD-0385 Review
|
||||
SIMD-0490 Review
|
||||
SIMD-0550 Review
|
||||
SIMD-0553 Draft
|
||||
```
|
||||
|
||||
Extensions SIMD déjà matérialisées dans le wire stable et réauditées à la clôture :
|
||||
|
||||
```text
|
||||
SIMD-0118 Activated -> numRewardPartitions préservé en omitted/null/value
|
||||
SIMD-0291 Review -> commission et commissionBps préservés indépendamment
|
||||
```
|
||||
|
||||
Le statut `Review` de SIMD-0291 ne retire pas le champ déjà exposé par Agave `v4.2.1` : `KSP-TRANSPORT-007` impose de conserver ce wire réellement livré. SIMD-0118 est `Activated` et confirme définitivement que `numRewardPartitions` fait partie des extensions de bloc à ne pas aplatir ni synthétiser.
|
||||
|
||||
Conséquences :
|
||||
|
||||
- aucun changement anticipé de `getLeaderSchedule` pour SIMD-0180 ;
|
||||
- aucun `footer`, `bankHash` ou `parentBankHash` spéculatif dans `getBlock` ;
|
||||
- `SolanaTransactionVersion::Number(u8)` reste générique ;
|
||||
- minimum de délégation et inflation restent des valeurs runtime ;
|
||||
- SIMD-0553 ne crée aucun nouveau contrat HTTP stable dans la baseline auditée.
|
||||
|
||||
La preuve typed finale est doublée :
|
||||
|
||||
```text
|
||||
public API canary -> référence les 52 wrappers current + 2 wrappers legacy séparés
|
||||
release canary -> fige noms exacts 52 + 14 et partition 4/22/11/15
|
||||
```
|
||||
|
||||
La matrice complète est conservée dans `docs/validation/007-V0_2_4_HTTP_FINAL_COMPLIANCE.md`.
|
||||
|
||||
## Smokes live
|
||||
|
||||
Les smokes restent opt-in et secondaires par rapport aux fixtures locales.
|
||||
|
||||
Le smoke Transport pur peut être étendu uniquement avec quelques reads robustes, par exemple `getBlockHeight`, `getFirstAvailableBlock`, `minimumLedgerSlot`, `getInflationRate` ou `getStakeMinimumDelegation`. Éviter un `getBlock` dépendant d'un slot fixe ou tout scénario fragile lié à des récompenses d'un epoch précis.
|
||||
`pre.009` étend le smoke Transport pur avec `getBlockHeight`, `getInflationRate` et `getStakeMinimumDelegation`. Ces reads restent robustes : aucun slot historique fixe, aucun compte reward spécifique et aucune valeur économique codée en dur. Éviter un `getBlock` dépendant d'un slot fixe ou tout scénario fragile lié à des récompenses d'un epoch précis.
|
||||
|
||||
Le smoke historique Config -> Transport reste une exception transitoire de composition et ne devient pas la destination générale des futurs scénarios cross-crates.
|
||||
|
||||
@@ -452,7 +506,7 @@ pre.006 réaudit SIMD-0298/0307 + getBlock moderne + bare encoding legacy + tra
|
||||
pre.007 réaudit SIMD-0490/0550 + Economics simples : getInflationGovernor, getInflationRate,
|
||||
getStakeMinimumDelegation, getSupply
|
||||
pre.008 réaudit commitment runtime + getInflationReward + null positionnels + commissionBps SIMD-0291 + invariants
|
||||
pre.009 réaudit SIMD HTTP (0180/0298/0301/0307/0385/0490/0550/0553 minimum)
|
||||
pre.009 réaudit SIMD HTTP (0118/0180/0291/0298/0301/0307/0385/0490/0550/0553 minimum)
|
||||
+ réaudit inventaire officiel + compliance finale 52/52 + 14/14
|
||||
+ KSP-TRANSPORT-007 + docs + smokes + graphes + prompt 0.2.5 — Wallet foundation
|
||||
rel.001 publication strictement publicationnelle
|
||||
@@ -490,6 +544,6 @@ réécriture des deltas historiques
|
||||
|
||||
## Questions ouvertes
|
||||
|
||||
Aucune question bloquante pour `pre.002`.
|
||||
Aucune question bloquante pour la candidate `pre.009`.
|
||||
|
||||
Les noms Rust exacts des DTOs peuvent encore être ajustés pendant l'implémentation. En revanche, les formes RPC, overloads, distinctions wire et limites fixées dans ce plan ne doivent pas être réduits pour simplifier l'API KSP.
|
||||
Les choix fonctionnels et wire de `0.2.4` sont désormais figés pour cette release. Toute nouvelle évolution officielle détectée après cette candidate appartient à une release ultérieure, sauf défaut de conformité démontré nécessitant un fix avant publication.
|
||||
|
||||
Reference in New Issue
Block a user