v0.3.10-pre.002

docs/validation/027-V0_3_10_RAW_TRANSACTION_INGEST.md

@@ -1,5 +1,5 @@
 <!-- file: docs/validation/027-V0_3_10_RAW_TRANSACTION_INGEST.md -->
-<!-- version: 1 -->
+<!-- version: 2 -->
 
 # Validation v0.3.10 — RAW Transaction commune + Worker d’ingestion
 
@@ -80,6 +80,31 @@ Tauri build : NON EXÉCUTÉ ici
 
 Aucun de ces gates n’est déclaré PASS par cette session. Le journal opérateur fourni pour la stable `0.3.9` montre un gate complet antérieur ; il reste une preuve externe de la base stable, pas une exécution `pre.001` locale.
 
+### 2.4 Gate opérateur après livraison de `pre.001`
+
+Le 6 septembre 2026, l’opérateur a exécuté sur `workspace.package.version = 0.3.10-pre.1` :
+
+```text
+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
+```
+
+Résultats communiqués :
+
+```text
+General Rust rule audit: clean
+Rust export completeness audit: 0 candidate(s)
+KSP workspace Rust rule audit: clean
+Markdown table audit: clean (339 table(s), 753 file(s))
+cargo check --workspace : terminé sans erreur
+cargo clippy --workspace --all-targets --all-features -- -D warnings : terminé sans erreur
+```
+
+Ce gate opérateur ferme les contrôles demandés pour passer à `pre.002`. Aucun `cargo test` de `pre.001` n’a été fourni dans ce message et il n’est pas inventé.
+
 ## 3. Preuves de conception fermées en `pre.001`
 
 ### 3.1 Common RAW
@@ -92,7 +117,7 @@ format_version courant = 1
 RawObservationKey est explicitement producer-owned dans Store
 RawTransaction identity = network + signature
 RawTransactionObservation est séparée de l’entité
-ksp-store-lib reexporte les primitives nécessaires
+`DEP-PIPE-006` impose les modèles `ksp-store-api` à la lower-layer RAW réutilisable ; la décision `ksp-store-lib` de `pre.001` est corrigée en `pre.002`
 Backfill conversion mélange actuellement canonicalisation commune et metadata Job-owned
 ```
 
@@ -352,3 +377,104 @@ pre.015 final docs reconciliation
 pre.016 publication preparation
 rel.001 stable publication
 ```
+
+## 11. Gate `pre.002` — common RAW foundation
+
+État : **matérialisé ; gate Cargo opérateur requis**.
+
+### 11.1 Crate et frontière
+
+```text
+crate = ksp-raw-transaction-lib
+workspace.package.version = 0.3.10-pre.2
+runtime async = aucun
+Transport / Config / Job / Worker = absents
+backend Store = absent
+```
+
+La dépendance exacte retenue après contrôle normatif est :
+
+```text
+ksp-raw-transaction-lib
+    -> ksp-core-lib
+    -> ksp-store-api
+    -> serde_json
+    -> sha2
+```
+
+Cette correction remplace la proposition `ksp-store-lib(default-features=false)` de `pre.001` car `DEP-PIPE-006` est plus spécifique : le pipeline RAW partagé peut dépendre de `ksp-store-api`, pas de `ksp-store-lib`.
+
+### 11.2 Surface matérialisée
+
+```text
+RAW_TRANSACTION_FORMAT_ID = ksp.solana.raw_transaction
+RAW_TRANSACTION_FORMAT_VERSION = 1
+MIN_RAW_TRANSACTION_SIGNATURE_TEXT_BYTES = 64
+MAX_RAW_TRANSACTION_SIGNATURE_TEXT_BYTES = 88
+
+RawTransactionMaterial
+RawTransactionWireField<T>
+RawTransactionVersion
+RawTransactionAcquisition
+
+parse_raw_transaction_signature(...)
+canonicalize_raw_transaction(...)
+assemble_raw_transaction_acquisition(...)
+
+ERROR_CODE_RAW_TRANSACTION_CANONICALIZATION_INVALID
+ERROR_CODE_RAW_TRANSACTION_MATERIAL_INVALID
+ERROR_CODE_RAW_TRANSACTION_SIGNATURE_INVALID
+```
+
+`RawObservationKey` reste fournie par le producteur. La common crate ne contient aucun domaine de clé Backfill/Worker.
+
+### 11.3 Preuves déterministes ajoutées
+
+```text
+signature Base58 : bornes texte + alphabet + overflow + exactement 64 octets
+RAW v1 golden : 112 bytes exacts
+RAW v1 SHA-256 : 220792d2b15d262fda242cb220774ee9ddeffebf04dcfadabcf8ef76a9b1a7c3
+meta/version/index : omitted != null != value
+JSON : clés objet triées récursivement, arrays conservés, strings échappées, nombres conservés
+block_time : négatif/overflow/max Store
+payload : borne MAX_RAW_PAYLOAD_BYTES
+Debug/error : aucune signature, transaction body ou meta hostile recopiée
+acquisition : observation key producer-owned et référence exactement égale à la transaction
+public API : consommation par crate-root
+firewall : absence Store runtime/Transport/Config/Job/Worker/backend
+```
+
+### 11.4 Validation locale d’assemblage
+
+Exécuté 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 (339 table(s), 754 file(s))
+
+manifest TOML : 20 membres workspace, ksp-raw-transaction-lib présent
+manifest common : 4 dépendances exactes, aucune feature/dev/build dependency
+```
+
+`cargo`, `rustc` et `rustfmt` ne sont pas présents dans cet environnement. Les gates Cargo de la nouvelle crate restent donc **NON EXÉCUTÉS LOCALEMENT**.
+
+### 11.5 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-raw-transaction-lib
+cargo tree -p ksp-raw-transaction-lib --edges normal
+cargo tree -p ksp-raw-transaction-lib -e features
+```
+
+`pre.003` ne doit migrer le Backfill qu’après ce gate vert.
+