137 lines
4.8 KiB
Markdown
137 lines
4.8 KiB
Markdown
<!-- file: deltas/0.2.9/pre.013-fix.004.md -->
|
|
<!-- version: 1 -->
|
|
|
|
# Delta `0.2.9-pre.013-fix.004` — conformité Clippy du smoke PublicNode final
|
|
|
|
## 1. Base
|
|
|
|
```text
|
|
0.2.9-pre.013-fix.003
|
|
```
|
|
|
|
Cette tranche reste strictement dans le couloir technique/live de fin de release. Elle ne modifie ni Config, ni README/USAGE, ni plan/validation, ni CHANGELOG/ROADMAP, ni le prompt de la release suivante.
|
|
|
|
## 2. Motif opérateur
|
|
|
|
La validation opérateur de `pre.013-fix.003` confirme le comportement live final du smoke PublicNode :
|
|
|
|
```text
|
|
Mainnet Subscribe + slot PASS
|
|
Testnet Subscribe + slot PASS
|
|
2 passed / 0 failed
|
|
```
|
|
|
|
Elle confirme aussi :
|
|
|
|
```text
|
|
cargo fmt --all PASS
|
|
python3 scripts/audit_rust_workspace_rules.py clean / 0 export candidate / clean
|
|
cargo check --workspace PASS
|
|
cargo test -p ksp-config-lib 113 unit + 5 ownership + 15 public API PASS
|
|
cargo test -p ksp-onchain-transport-lib 383 unit + 49 public API + 43 completeness + 4 doctests PASS
|
|
cargo test -p ksp-core-lib --test workspace_dependencies 3/3 PASS
|
|
cargo test --workspace PASS
|
|
cargo tree -p ksp-onchain-transport-lib exécuté
|
|
cargo tree -p ksp-onchain-transport-lib --duplicates exécuté
|
|
cargo tree --duplicates exécuté
|
|
```
|
|
|
|
Le seul gate en échec est :
|
|
|
|
```text
|
|
cargo clippy --workspace --all-targets
|
|
```
|
|
|
|
Clippy relève onze violations localisées exclusivement dans `tests/yellowstone_publicnode_smoke.rs` : huit `clippy::expect_used`, deux `clippy::question_mark_used` et un `clippy::implicit_return`.
|
|
|
|
Aucun défaut fonctionnel du moteur Yellowstone, de Config ou du live PublicNode n'est révélé par ce gate.
|
|
|
|
## 3. Version technique
|
|
|
|
`workspace.package.version` devient :
|
|
|
|
```text
|
|
0.2.9-pre.13.fix.4
|
|
```
|
|
|
|
## 4. Correction du smoke
|
|
|
|
Le smoke conserve exactement le même contrat fonctionnel et opérateur que `fix.003` :
|
|
|
|
- deux lignes de token sur stdin, Mainnet puis Testnet ;
|
|
- metadata secrète `x-token` ;
|
|
- ouverture TLS puis `Subscribe` ;
|
|
- attente bornée d'un `YellowstoneSubscribeUpdate::Slot` ;
|
|
- `slot > 0` obligatoire ;
|
|
- fermeture gracieuse ou timeout KSP de half-close accepté uniquement après réception du slot ;
|
|
- aucune lecture Config/env KSP depuis Transport ;
|
|
- aucun secret dans URL, arguments ou diagnostics.
|
|
|
|
Seule la forme Rust du harness est corrigée :
|
|
|
|
- tous les `expect()` des helpers non annotés `#[test]` sont remplacés par des `match` explicites ;
|
|
- les deux propagations `?` sont remplacées par des branches `Result::Err` explicites ;
|
|
- la sortie du `async` d'attente de slot utilise `return update.slot()` ;
|
|
- la borne externe de fermeture est contrôlée par `match` plutôt que `expect()` ;
|
|
- aucun `#[allow(clippy::expect_used)]`, `#[allow(clippy::question_mark_used)]` ou `#[allow(clippy::implicit_return)]` n'est ajouté.
|
|
|
|
Le runtime Transport n'est pas modifié.
|
|
|
|
## 5. Inspection finale du graphe déjà exécutée
|
|
|
|
Le graphe Transport communiqué par l'opérateur confirme la stack gRPC attendue :
|
|
|
|
```text
|
|
yellowstone-grpc-proto 12.6.0
|
|
tonic 0.14.6
|
|
tonic-prost 0.14.6
|
|
prost 0.14.4
|
|
prost-types 0.14.4
|
|
```
|
|
|
|
Aucun `yellowstone-grpc-client` n'est introduit comme seconde abstraction runtime. Les doublons signalés par Cargo concernent notamment les contextes build/runtime et des transitifs génériques ; le graphe communiqué ne montre pas de seconde version concurrente de `tonic` ou `prost` dans la stack Yellowstone Transport.
|
|
|
|
## 6. Gate opérateur ciblé à rejouer
|
|
|
|
Le correctif ne changeant que le harness live et la version Cargo, le gate minimal est :
|
|
|
|
```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.9
|
|
cargo check --workspace
|
|
cargo clippy --workspace --all-targets
|
|
cargo test -p ksp-onchain-transport-lib
|
|
cargo test --workspace
|
|
```
|
|
|
|
Puis le smoke live final, avec les credentials déjà validés :
|
|
|
|
```bash
|
|
read -rsp 'PublicNode Mainnet Yellowstone x-token: ' PUBLICNODE_MAINNET_TOKEN
|
|
echo
|
|
read -rsp 'PublicNode Testnet Yellowstone x-token: ' PUBLICNODE_TESTNET_TOKEN
|
|
echo
|
|
printf '%s\n%s\n' "$PUBLICNODE_MAINNET_TOKEN" "$PUBLICNODE_TESTNET_TOKEN" \
|
|
| cargo test -p ksp-onchain-transport-lib --test yellowstone_publicnode_smoke -- --ignored --nocapture
|
|
unset PUBLICNODE_MAINNET_TOKEN PUBLICNODE_TESTNET_TOKEN
|
|
```
|
|
|
|
Attendu :
|
|
|
|
```text
|
|
2 passed
|
|
0 failed
|
|
0 ignored
|
|
```
|
|
|
|
Les trois `cargo tree` n'ont pas besoin d'être rejoués si le payload appliqué correspond exactement à ce delta : aucune dépendance ni feature Cargo n'est modifiée.
|
|
|
|
## 7. Fichiers modifiés/ajoutés
|
|
|
|
```text
|
|
Cargo.toml
|
|
crates/ksp-onchain-transport-lib/tests/yellowstone_publicnode_smoke.rs
|
|
deltas/0.2.9/pre.013-fix.004.md
|
|
```
|