Files
khadhroony-solana-project/deltas/0.3.12/pre.003-fix.001.md

4.1 KiB

Delta 0.3.12-pre.003-fix.001 — suppression du dead code préparatoire

Base requise

0.3.12-pre.003
workspace.package.version = 0.3.12-pre.3

Le gate opérateur reçu pour pre.003 montre :

audit Rust : clean
audit Markdown : clean (340 tables, 803 fichiers)
cargo check --workspace : PASS visible
cargo test -p ksp-worker-raw-transaction-ingest-lib : 45 PASS, 0 fail
cargo clippy --workspace --all-targets --all-features -- -D warnings : FAIL

L'échec Clippy est limité à huit diagnostics dead_code dans runtime_resources.rs pour les adapters privés préparatoires de pre.003 et le champ privé route.

Objectif

Corriger exclusivement le gate Clippy de pre.003 sans avancer le périmètre fonctionnel vers pre.004.

Version

La correction touche du code Rust ; conformément à VER-ID-007 et VER-ID-010 :

delivery id = 0.3.12-pre.003-fix.001
workspace.package.version = 0.3.12-pre.3.fix.1

Correction

RUST-API-008 exige qu'un helper strictement privé, sans consommateur de production et présent uniquement pour une préparation testée, soit compilé sous #[cfg(test)] jusqu'à sa première consommation réelle.

Sont donc passés sous #[cfg(test)] :

import sha2::Digest utilisé uniquement par le fingerprint préparatoire
RAW_TRANSACTION_INGEST_YELLOWSTONE_FILTER_FINGERPRINT_DOMAIN
RawTransactionIngestSourceFamily
RawTransactionIngestSourceTimestamp + Debug
RawTransactionIngestSourceSignal + Debug
RawTransactionIngestYellowstoneSignalView
impls Transaction et TransactionStatus
impls From vers le signal privé
matched_filter_fingerprint
project_yellowstone_signal

Ces éléments restent présents dans la source et restent exercés par les unit tests pre.003; ils réentreront dans le build productif à leur première consommation réelle en pre.004.

Aucun #[allow(dead_code)] ni #[expect(dead_code)] n'est utilisé.

Le champ RawTransactionIngestYellowstoneSource::route n'est pas test-only : sa validation provider/endpoint fait déjà partie du contrat productif pre.003. Le Debug sûr de la source lit maintenant ce champ, ce qui supprime son warning sans masquer le lint.

Décisions prises

respect strict de RUST-API-008
pas de suppression des adapters testés de pre.003
pas d'élargissement de visibilité
pas d'allow/expect dead_code
route validée conservée dans la source productive
aucune activation live anticipée

Questions ouvertes

Aucune. La première consommation productive des adapters reste pre.004.

Fichiers ajoutés

deltas/0.3.12/pre.003-fix.001.md

Fichiers modifiés

Cargo.toml
crates/ksp-worker-raw-transaction-ingest-lib/src/runtime_resources.rs
docs/validation/029-V0_3_12_YELLOWSTONE_HYDRATION_CONTINUITY.md

Fichiers supprimés

Aucun.

Validations exécutées dans l'environnement d'assemblage

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
python3 scripts/audit_markdown_tables.py README.md RULES.md ROADMAP.md CHANGELOG.md docs prompts crates deltas
Markdown table audit: clean (340 table(s), 804 file(s))

Validations non exécutées dans l'environnement d'assemblage

cargo, rustc et rustfmt ne sont pas installés dans cet environnement. Aucun gate Cargo local n'est déclaré PASS.

Gate opérateur demandé

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
cargo check --workspace
cargo clippy --workspace --all-targets --all-features -- -D warnings
cargo test -p ksp-worker-raw-transaction-ingest-lib

Non-claims

Ce correctif ne revendique toujours pas :

stream Yellowstone ouvert
update réseau consommée
hydration HTTP
Common RAW issu du réseau
provenance composite finale
persistence réseau
Block / BlockMeta / Slot
coalescence
frontier / from_slot / ReplayInfo