Files
khadhroony-solana-project/deltas/0.2.9/pre.013-fix.004.md

4.8 KiB

Delta 0.2.9-pre.013-fix.004 — conformité Clippy du smoke PublicNode final

1. Base

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 :

Mainnet Subscribe + slot   PASS
Testnet Subscribe + slot   PASS
2 passed / 0 failed

Elle confirme aussi :

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 :

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 :

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 :

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 :

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 :

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 :

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

Cargo.toml
crates/ksp-onchain-transport-lib/tests/yellowstone_publicnode_smoke.rs
deltas/0.2.9/pre.013-fix.004.md