168 lines
6.0 KiB
Markdown
168 lines
6.0 KiB
Markdown
<!-- file: deltas/0.2.9/pre.006.md -->
|
|
<!-- version: 1 -->
|
|
|
|
# Delta `0.2.9-pre.006` — namespace privé HTTP explicite
|
|
|
|
## 1. Base requise
|
|
|
|
```text
|
|
0.2.9-pre.5.fix.1
|
|
```
|
|
|
|
Le gate opérateur de `pre.005-fix.001` est intégralement vert : fmt, audit Rust, check, Clippy, Transport 364 unit + 45 public API + 38 release-completeness + 4 doctests, dependency canary Core 3/3 et workspace complet.
|
|
|
|
## 2. Objectif
|
|
|
|
Réduire l'ambiguïté croissante dans `ksp-onchain-transport-lib` maintenant que HTTP, WebSocket et Yellowstone gRPC coexistent dans la même crate.
|
|
|
|
Cinq modules privés sont exclusivement propriétaires de la pile HTTP et reçoivent un préfixe explicite :
|
|
|
|
```text
|
|
client.rs -> http_client.rs
|
|
executor.rs -> http_executor.rs
|
|
pool.rs -> http_pool.rs
|
|
resilience.rs -> http_resilience.rs
|
|
settings.rs -> http_settings.rs
|
|
```
|
|
|
|
Les unit tests miroirs suivent exactement les mêmes renommages.
|
|
|
|
## 3. Frontière du renommage
|
|
|
|
Le renommage n'est pas appliqué mécaniquement à tous les anciens modules.
|
|
|
|
`rpc_accounts`, `rpc_blocks`, `rpc_transactions` et `rpc_common` portent déjà des DTOs/types Solana réutilisés par WebSocket et/ou gRPC. Le préfixe `http_` y serait donc architecturalement faux. Les autres `rpc_*` restent dans la même famille cohérente.
|
|
|
|
`json_rpc` décrit une couche de protocole/enveloppe et conserve son nom. `constants` et `error` sont transverses à plusieurs transports et restent également inchangés.
|
|
|
|
Aucun type ou nom public n'est renommé : les surfaces HTTP publiques utilisent déjà des noms `Http*` et restent réexportées depuis le crate root.
|
|
|
|
## 4. Forecast recalibré
|
|
|
|
L'ancien `pre.006` fonctionnel est décalé afin de ne pas mélanger ce refactor de fichiers avec l'ajout Transactions/transaction_status.
|
|
|
|
```text
|
|
pre.006 namespace privé HTTP explicite
|
|
pre.007 Transactions + transaction_status
|
|
pre.008 Blocks + block_meta + entry
|
|
pre.009 bidi/backpressure/half-close/shutdown
|
|
pre.010 reconnect/replay/gaps/duplicates
|
|
pre.011 Config V3 + protocol/provider + profils PublicNode
|
|
pre.012 PublicNode live + compliance + docs/prompt 0.2.10
|
|
rel.001
|
|
```
|
|
|
|
Le contenu fonctionnel des tranches décalées ne change pas.
|
|
|
|
## 5. Fichiers ajoutés par renommage
|
|
|
|
```text
|
|
crates/ksp-onchain-transport-lib/src/http_client.rs
|
|
crates/ksp-onchain-transport-lib/src/http_executor.rs
|
|
crates/ksp-onchain-transport-lib/src/http_pool.rs
|
|
crates/ksp-onchain-transport-lib/src/http_resilience.rs
|
|
crates/ksp-onchain-transport-lib/src/http_settings.rs
|
|
crates/ksp-onchain-transport-lib/unit_tests/http_client.rs
|
|
crates/ksp-onchain-transport-lib/unit_tests/http_executor.rs
|
|
crates/ksp-onchain-transport-lib/unit_tests/http_pool.rs
|
|
crates/ksp-onchain-transport-lib/unit_tests/http_resilience.rs
|
|
crates/ksp-onchain-transport-lib/unit_tests/http_settings.rs
|
|
```
|
|
|
|
## 6. Fichiers supprimés
|
|
|
|
Un ZIP overlay ne peut pas supprimer ces chemins. L'opérateur doit donc les retirer explicitement après extraction :
|
|
|
|
```text
|
|
crates/ksp-onchain-transport-lib/src/client.rs
|
|
crates/ksp-onchain-transport-lib/src/executor.rs
|
|
crates/ksp-onchain-transport-lib/src/pool.rs
|
|
crates/ksp-onchain-transport-lib/src/resilience.rs
|
|
crates/ksp-onchain-transport-lib/src/settings.rs
|
|
crates/ksp-onchain-transport-lib/unit_tests/client.rs
|
|
crates/ksp-onchain-transport-lib/unit_tests/executor.rs
|
|
crates/ksp-onchain-transport-lib/unit_tests/pool.rs
|
|
crates/ksp-onchain-transport-lib/unit_tests/resilience.rs
|
|
crates/ksp-onchain-transport-lib/unit_tests/settings.rs
|
|
```
|
|
|
|
Commande opérateur :
|
|
|
|
```bash
|
|
rm \
|
|
crates/ksp-onchain-transport-lib/src/{client,executor,pool,resilience,settings}.rs \
|
|
crates/ksp-onchain-transport-lib/unit_tests/{client,executor,pool,resilience,settings}.rs
|
|
```
|
|
|
|
## 7. Fichiers modifiés
|
|
|
|
```text
|
|
Cargo.toml
|
|
crates/ksp-onchain-transport-lib/src/lib.rs
|
|
crates/ksp-onchain-transport-lib/tests/release_completeness.rs
|
|
docs/plans/016-V0_2_9_YELLOWSTONE_GRPC_PLAN.md
|
|
docs/validation/012-V0_2_9_YELLOWSTONE_GRPC.md
|
|
deltas/0.2.9/pre.006.md
|
|
```
|
|
|
|
`workspace.package.version` devient :
|
|
|
|
```text
|
|
0.2.9-pre.6
|
|
```
|
|
|
|
## 8. Canaries
|
|
|
|
Le nouveau canari release-completeness vérifie :
|
|
|
|
- les cinq déclarations privées `mod http_*` ;
|
|
- l'absence des cinq anciennes déclarations ambiguës ;
|
|
- la présence des types/fonctions HTTP structurants dans les nouveaux fichiers ;
|
|
- le maintien volontaire des modules partagés/protocolaires `rpc_*`, `json_rpc`, `constants`, `error` ;
|
|
- l'absence de changement de surface publique requise par ce refactor.
|
|
|
|
## 9. Documentation Markdown
|
|
|
|
Les tableaux touchés dans `016` et `012` sont reformattés selon le comportement JetBrains RustRover : largeur de chaque colonne basée sur son contenu le plus large, puis exactement un espace de padding de part et d'autre du contenu avant les pipes.
|
|
|
|
## 10. Validations exécutées lors de la préparation
|
|
|
|
```text
|
|
python3 scripts/audit_rust_workspace_rules.py
|
|
General Rust rule audit: clean
|
|
Rust export completeness audit: 0 candidate(s)
|
|
KSP workspace Rust rule audit: clean
|
|
```
|
|
|
|
Contrôles statiques supplémentaires :
|
|
|
|
```text
|
|
5 nouveaux modules HTTP source présents
|
|
5 nouveaux unit tests miroirs présents
|
|
5 anciens modules source absents du worktree final
|
|
5 anciens unit tests absents du worktree final
|
|
aucun renommage des modules rpc_* partagés
|
|
aucun changement de dépendance Cargo
|
|
aucune modification de public_api.rs
|
|
```
|
|
|
|
## 11. Validations non exécutées dans l'environnement de préparation
|
|
|
|
Cargo/Rust ne sont pas disponibles dans l'environnement de préparation. L'opérateur doit exécuter après extraction **et suppression des anciens chemins** :
|
|
|
|
```bash
|
|
cargo fmt --all
|
|
python3 scripts/audit_rust_workspace_rules.py
|
|
cargo check --workspace
|
|
cargo clippy --workspace --all-targets
|
|
cargo test -p ksp-onchain-transport-lib
|
|
cargo test -p ksp-core-lib --test workspace_dependencies
|
|
cargo test --workspace
|
|
```
|
|
|
|
Aucun `cargo tree` n'est requis : aucune dépendance ni feature ne change.
|
|
|
|
## 12. Verdict
|
|
|
|
`pre.006` est une candidate structurelle sans changement fonctionnel ni API publique. Sa fermeture exige l'absence effective des dix anciens chemins et un gate Cargo intégralement vert.
|