137 lines
4.1 KiB
Markdown
137 lines
4.1 KiB
Markdown
<!-- file: deltas/0.3.12/pre.003-fix.001.md -->
|
|
<!-- version: 2 -->
|
|
|
|
# Delta `0.3.12-pre.003-fix.001` — suppression du dead code préparatoire
|
|
|
|
## Base requise
|
|
|
|
```text
|
|
0.3.12-pre.003
|
|
workspace.package.version = 0.3.12-pre.3
|
|
```
|
|
|
|
Le gate opérateur reçu pour `pre.003` montre :
|
|
|
|
```text
|
|
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` :
|
|
|
|
```text
|
|
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)]` :
|
|
|
|
```text
|
|
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
|
|
|
|
```text
|
|
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
|
|
|
|
```text
|
|
deltas/0.3.12/pre.003-fix.001.md
|
|
```
|
|
|
|
## Fichiers modifiés
|
|
|
|
```text
|
|
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
|
|
|
|
```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
|
|
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é
|
|
|
|
```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
|
|
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 :
|
|
|
|
```text
|
|
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
|
|
```
|