# Delta `0.3.8-pre.013-fix.001` — trajectoire Worker RAW Transaction multi-source ## 1. Base requise ```text 0.3.8-pre.013 workspace.package.version = 0.3.8-pre.13 ``` Cette correction reste dans le couloir de réconciliation documentaire de `pre.013`. Elle est créée avant `pre.014` afin de ne pas introduire une décision d'architecture durable dans la tranche de publication minimale. ## 2. Objectif Figer les décisions prises après la réconciliation Store Desk concernant : ```text 0.3.9 ksp-worker-api + audit exhaustif des sources RawTransaction en fin de release 0.3.10 ksp-worker-raw-transaction-ingest-lib multi-source dès V1 0.3.11 ksp-app-raw-transaction-ingest-desk 0.3.12 extension multi-source de ksp-job-backfill-lib + ksp-app-backfill-desk ``` Aucun endpoint Helius, aucune URL, aucun secret nouveau, aucune modification Config/Transport/runtime et aucun code Worker ne sont ajoutés dans `0.3.8`. ## 3. Version Correction strictement documentaire : ```text workspace.package.version reste 0.3.8-pre.13 Cargo.toml inchangé ``` Conformément à `VER-ID-008`, l'identifiant de delta n'est pas reflété dans Cargo. ## 4. Décisions durablement documentées ### 4.1 Worker API `ksp-worker-api` reste une API générique de services continus, distincte de Job API et sans dépendance Solana/Transport/Store/Tauri. Elle doit être fonctionnellement stabilisée avant l'audit détaillé du premier worker concret. ### 4.2 Premier worker RAW Le nom retenu est : ```text ksp-worker-raw-transaction-ingest-lib ``` Le worker n'est pas défini par un protocole unique. Il doit pouvoir composer des stratégies d'acquisition alternatives, complémentaires, redondantes ou spécialisées live/catch-up/gap-repair, tout en convergeant vers `RawTransaction` + `RawTransactionObservation` puis `ksp-store-lib`. ### 4.3 Audit de fin `0.3.9` Après fermeture fonctionnelle de Worker API, `0.3.9` doit auditer au minimum : ```text HTTP signatures + hydration HTTP slot/block acquisition WS logs/signature/block selon disponibilité réelle extensions transactionnelles provider-specific dont Helius Yellowstone transactions / transaction_status / blocks / block_meta replay/from_slot/catch-up selon provider combinaisons multi-provider et multi-transport ``` L'audit compare discovery, hydration, payload direct, filtres, ordering/duplicates, reconnect/replay, gap recovery, backpressure, commitment, provenance, quotas et gaps KSP Transport/Config. ### 4.4 Helius Décisions préparatoires seulement : ```text KSP_SECRET_HELIUS_API_KEY existe déjà et doit être réutilisée via Config Helius HTTP/WS Mainnet/Devnet sont des sources candidates futures les endpoints/profils nécessaires ne sont ajoutés qu'en 0.3.10 capabilities standard vs advanced/enhanced doivent être réauditées au moment du travail aucune URL Helius nouvelle n'entre dans 0.3.8 ``` kbot3 reste une référence fonctionnelle obligatoire pour cet audit, jamais une source de code, de DTO, de Config ou de dépendance. ### 4.5 Mainnet / mainnet-beta Aucun renommage n'est appliqué maintenant. L'audit doit déterminer une stratégie de canonicalisation/aliasing compatible avec Store, Config, Transport, checkpoints et fingerprints afin de ne jamais créer deux identités KSP pour le même cluster. ### 4.6 Backfill Le backfill `0.3.6`/`0.3.7` est explicitement décrit comme **première stratégie HTTP**, et non comme définition générale du backfill. Après le worker live et sa Desk, `0.3.12` étendra `ksp-job-backfill-lib` et `ksp-app-backfill-desk` avec les autres stratégies historiques/catch-up pertinentes issues du même audit. ## 5. Fichiers modifiés ```text docs/architecture/004-COMPONENT_INVENTORY.md docs/architecture/005-DEPENDENCY_GRAPH.md docs/architecture/009-ACQUISITION_WORKERS_AND_JOBS.md docs/architecture/010-APPS_SERVICES_SCENARIOS_AND_CONTROL.md ``` ## 6. Fichier ajouté ```text deltas/0.3.8/pre.013-fix.001.md ``` ## 7. Fichiers supprimés Aucun. ## 8. Hors scope ```text Cargo.toml ROADMAP.md CHANGELOG.md prompt 0.3.9 src/** tests/** frontend/** Config runtime / std.transport ksp-onchain-transport-lib runtime endpoints ou URLs Helius .env / .env.example Store/schema/migrations ``` `ROADMAP.md`, `CHANGELOG.md` et le prompt suivant restent réservés à `pre.014`. ## 9. Validations de l'environnement d'assemblage ```text python3 scripts/audit_rust_workspace_rules.py : clean python3 scripts/audit_markdown_tables.py README.md RULES.md ROADMAP.md CHANGELOG.md docs prompts crates deltas : clean Rust export completeness audit : 0 candidate(s) contrôle différentiel : uniquement architecture + delta Cargo.toml : inchangé ``` Cargo/rustc/rustfmt ne sont pas requis pour cette correction strictement documentaire. ## 10. Suite Après application et audits documentaires verts : ```text 0.3.8-pre.014 — CHANGELOG + ROADMAP + prompt 0.3.9 0.3.8-rel.001 — publication stable ```