181 lines
5.3 KiB
Markdown
181 lines
5.3 KiB
Markdown
<!-- file: deltas/0.3.11/pre.006.md -->
|
|
<!-- version: 1 -->
|
|
|
|
# Delta `0.3.11-pre.006` — admission bornée et canonicalisation Common RAW
|
|
|
|
## Base requise
|
|
|
|
```text
|
|
0.3.11-pre.005
|
|
workspace.package.version = 0.3.11-pre.5
|
|
```
|
|
|
|
Le gate opérateur du 8 septembre 2026 est vert sur `fmt`, audits Rust/Markdown, `cargo check --workspace`, Clippy strict, les 18 tests de la crate Worker, doc-tests et les arbres Cargo normal/features.
|
|
|
|
## Objectif
|
|
|
|
Matérialiser uniquement la responsabilité `pre.006` du plan `032` : admission `mpsc` centrale bornée, backpressure async, ingress privé, canonicalisation via `ksp-raw-transaction-lib`, observation key Worker déterministe et assembly du `RawTransactionAcquisition`. Aucune persistence Store et aucune source réseau.
|
|
|
|
## Version
|
|
|
|
```text
|
|
identifiant de livraison : 0.3.11-pre.006
|
|
workspace.package.version : 0.3.11-pre.6
|
|
```
|
|
|
|
## Admission privée bornée
|
|
|
|
Le supervisor crée un seul channel central dimensionné par `RawTransactionIngestSettings::admission_queue_capacity()` :
|
|
|
|
```text
|
|
tokio::sync::mpsc::channel(...)
|
|
```
|
|
|
|
Le seam source reçoit le sender `mpsc` borné et le signal de stop. Le contrat prouvé est :
|
|
|
|
```text
|
|
send().await pour le backpressure
|
|
select! biased : stop avant send dans le harness source
|
|
aucun unbounded_channel
|
|
receiver close au shutdown
|
|
```
|
|
|
|
Au shutdown, le receiver ferme les nouvelles admissions et consume les entrées déjà en queue avant le join final des tâches enfants.
|
|
|
|
## Ingress et Common RAW
|
|
|
|
L'ingress crate-private, absent de l'API publique, transporte :
|
|
|
|
```text
|
|
RawTransactionMaterial
|
|
RawNetworkId attendu
|
|
RawAcquisitionProvenance
|
|
source key opaque [u8; 32]
|
|
```
|
|
|
|
Le pipeline est :
|
|
|
|
```text
|
|
network guard
|
|
ksp_raw_transaction_lib::canonicalize_raw_transaction(...)
|
|
material network guard
|
|
observation key Worker
|
|
ksp_raw_transaction_lib::assemble_raw_transaction_acquisition(...)
|
|
```
|
|
|
|
Aucune canonicalisation RAW v1 n'est réimplémentée dans le Worker.
|
|
|
|
## Observation key V1
|
|
|
|
Domaine exact :
|
|
|
|
```text
|
|
ksp.raw_transaction_ingest.observation.v1\0
|
|
```
|
|
|
|
Le SHA-256 encode avec longueur `u64` big-endian :
|
|
|
|
```text
|
|
network
|
|
signature
|
|
source key
|
|
```
|
|
|
|
Golden harness :
|
|
|
|
```text
|
|
network : mainnet
|
|
signature : 64 x 0x07
|
|
source key : 32 x 0x09
|
|
SHA-256 : f8d161dca8a8a72a0da110fc87882ee7136848461c6aa32b09e30a6188b95dcc
|
|
```
|
|
|
|
Aucun timestamp local, run id ou ordre d'admission ne participe à la clé.
|
|
|
|
## Tests ajoutés ou étendus
|
|
|
|
```text
|
|
capacity=1 : second send bloqué jusqu'à consommation d'un slot
|
|
stop : sender bloqué rejeté sans admission post-stop
|
|
payload common RAW canonique exact
|
|
format id/version exacts
|
|
observation-key golden exact
|
|
assembly transaction/provenance/reference exact
|
|
mismatch network ingress/material rejetés sans fuite de valeurs
|
|
dependency boundary : mpsc/common RAW requis, persistence/Transport/snapshot toujours interdits
|
|
```
|
|
|
|
## Fichiers ajoutés
|
|
|
|
```text
|
|
crates/ksp-worker-raw-transaction-ingest-lib/src/admission.rs
|
|
crates/ksp-worker-raw-transaction-ingest-lib/unit_tests/admission.rs
|
|
deltas/0.3.11/pre.006.md
|
|
```
|
|
|
|
## Fichiers modifiés
|
|
|
|
```text
|
|
Cargo.toml
|
|
crates/ksp-worker-raw-transaction-ingest-lib/src/lib.rs
|
|
crates/ksp-worker-raw-transaction-ingest-lib/src/runtime.rs
|
|
crates/ksp-worker-raw-transaction-ingest-lib/tests/dependency_boundary.rs
|
|
crates/ksp-worker-raw-transaction-ingest-lib/unit_tests/runtime.rs
|
|
docs/plans/032-V0_3_11_RAW_TRANSACTION_INGEST_WORKER_FOUNDATION_PLAN.md
|
|
docs/validation/028-V0_3_11_RAW_TRANSACTION_INGEST_WORKER_FOUNDATION.md
|
|
```
|
|
|
|
## Fichiers supprimés
|
|
|
|
Aucun.
|
|
|
|
## Hors scope conservé
|
|
|
|
```text
|
|
RawTransactionWrite / persistence Store
|
|
RawTransactionAcquisitionMode::Normal
|
|
persistence concurrency
|
|
Store outcome mapping / idempotence / conflict
|
|
snapshots concrets
|
|
source live / Transport
|
|
Config
|
|
retry / reconnect / gap repair
|
|
```
|
|
|
|
## Validations exécutées dans l'environnement d'assemblage
|
|
|
|
```text
|
|
General Rust rule audit: clean
|
|
Rust export completeness audit: 0 candidate(s)
|
|
KSP workspace Rust rule audit: clean
|
|
Markdown table audit: clean (340 table(s), 781 file(s))
|
|
|
|
scan production : aucun ?, unwrap, expect, panic, unbounded_channel
|
|
scan scope : aucune persistence Store, aucun Transport, aucun snapshot concret
|
|
pipeline : exactement 1 mpsc::channel, 1 canonicalize_raw_transaction, 1 assemble_raw_transaction_acquisition
|
|
observation golden indépendant : f8d161dca8a8a72a0da110fc87882ee7136848461c6aa32b09e30a6188b95dcc
|
|
```
|
|
|
|
L'environnement d'assemblage ne fournit ni `cargo`, ni `rustc`, ni `rustfmt`. Aucun gate Cargo de `pre.006` n'est déclaré PASS localement.
|
|
|
|
## 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
|
|
cargo tree -p ksp-worker-raw-transaction-ingest-lib --edges normal
|
|
cargo tree -p ksp-worker-raw-transaction-ingest-lib -e features
|
|
```
|
|
|
|
## Décision
|
|
|
|
`pre.007` reste bloquée jusqu'à validation opérateur verte de l'admission bornée, du backpressure, du golden observation et de l'assembly Common RAW.
|
|
|
|
## Questions ouvertes
|
|
|
|
Aucune nouvelle question architecturale. La persistence réelle et les outcomes Store restent dans `pre.007`, les snapshots dans `pre.008`, et le hardening fault/drain dans `pre.009`.
|