4.9 KiB
Delta 0.3.8-pre.013-fix.001 — trajectoire Worker RAW Transaction multi-source
1. Base requise
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 :
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 :
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 :
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 :
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 :
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
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é
deltas/0.3.8/pre.013-fix.001.md
7. Fichiers supprimés
Aucun.
8. Hors scope
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
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 :
0.3.8-pre.014 — CHANGELOG + ROADMAP + prompt 0.3.9
0.3.8-rel.001 — publication stable