v0.3.8-pre.013-fix.001
This commit is contained in:
150
deltas/0.3.8/pre.013-fix.001.md
Normal file
150
deltas/0.3.8/pre.013-fix.001.md
Normal file
@@ -0,0 +1,150 @@
|
||||
<!-- file: deltas/0.3.8/pre.013-fix.001.md -->
|
||||
<!-- version: 1 -->
|
||||
|
||||
# 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
|
||||
```
|
||||
Reference in New Issue
Block a user