v0.3.9-pre.004

2026-09-04 21:23:46 +02:00
parent bb7ee3cc3a
commit eb39aaa904
7 changed files with 362 additions and 27 deletions
--- a/deltas/0.3.9/pre.004.md
+++ b/deltas/0.3.9/pre.004.md
@@ -0,0 +1,60 @@
+<!-- file: deltas/0.3.9/pre.004.md -->
+<!-- version: 1 -->
+
+# Delta `0.3.9-pre.004`
+
+## 1. Objet
+
+Fermer l'audit RAW A après freeze effective de `ksp-worker-api` : Solana standard HTTP/WS, inventaire KSP Transport/Store/Config, taxonomie de capabilities et premiers gaps préparatoires pour `0.3.10`/`0.3.12`.
+
+Aucun runtime, DTO Transport, Store model, Config profile ou Worker API n'est modifié.
+
+## 2. Base et version
+
+Base opérateur : `0.3.9-pre.3`, dont le gate Worker est PASS.
+
+```text
+workspace.package.version = 0.3.9-pre.4
+```
+
+## 3. Décisions
+
+```text
+getSignaturesForAddress + getTransaction -> history/catch-up/repair adressé
+getBlocks/getBlocksWithLimit + getBlock  -> catch-up/gap repair global sous gap provenance
+logsSubscribe                             -> live discovery + hydration
+signatureSubscribe                        -> confirmation ciblée, pas discovery
+blockSubscribe                            -> direct full sous capability explicite, méthode instable
+slot/ledger methods                       -> auxiliaires de continuité
+reconnect WS                              -> jamais assimilé à replay
+mainnet-beta                              -> identité réseau durable canonique
+```
+
+## 4. Gaps ouverts, non implémentés
+
+- `get_block_observed` ou équivalent nécessaire si la voie bloc multi-endpoint est admise en V1 ;
+- extraction/canonicalisation transaction-par-transaction depuis un bloc à définir ;
+- canonicalizer RAW v1 actuellement owned par Backfill à rendre réutilisable sans dépendance Worker -> Job ni duplication ;
+- gap repair explicite requis après reconnexion/overflow WS ;
+- Config future à exprimer par capabilities/rôles et non enum de protocole ;
+- cohérence `mainnet` profile alias / `mainnet-beta` durable à préserver.
+
+## 5. Fichiers
+
+| Fichier                                                        | Action | Rôle                                  |
+|----------------------------------------------------------------|--------|---------------------------------------|
+| Cargo.toml                                                     | MOD    | workspace `0.3.9-pre.4`               |
+| docs/000-README.md                                             | MOD    | indexe l’architecture RAW             |
+| docs/architecture/000-README.md                                | MOD    | ajoute le document 011                |
+| docs/architecture/011-RAW_TRANSACTION_ACQUISITION.md           | ADD    | audit standard + taxonomie + gaps     |
+| docs/plans/030-V0_3_9_WORKER_API_RAW_TRANSACTION_AUDIT_PLAN.md | MOD    | freeze pre.003 + réalisation pre.004  |
+| docs/validation/026-V0_3_9_WORKER_API_RAW_TRANSACTION_AUDIT.md | MOD    | preuves opérateur + checklist pre.004 |
+| deltas/0.3.9/pre.004.md                                        | ADD    | présent delta                         |
+
+## 6. Sources externes
+
+Documentation RPC Solana officielle consultée le 4 septembre 2026. Les liens exacts sont conservés dans `docs/architecture/011-RAW_TRANSACTION_ACQUISITION.md`. Les providers, quotas, Helius, Yellowstone et kbot3 restent réservés à `pre.005`.
+
+## 7. Gates
+
+Les audits Python sont exécutés après assemblage. Les gates Cargo de cette tranche restent à exécuter par l'opérateur ; le changement Rust se limite au metadata de version workspace.