Sasedev/khadhroony-solana-project
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

v0.3.9-pre.006-fix.001

Browse Source
This commit is contained in:
SinuS von SifriduS
2026-09-05 02:24:47 +02:00
parent e6c2649410
commit 116eabba7d
4 changed files with 965 additions and 828 deletions
Download Patch File Download Diff File Expand all files Collapse all files

23
docs/plans/030-V0_3_9_WORKER_API_RAW_TRANSACTION_AUDIT_PLAN.md
View File

@@ -1,5 +1,5 @@
<!-- file: docs/plans/030-V0_3_9_WORKER_API_RAW_TRANSACTION_AUDIT_PLAN.md -->
<!-- version: 10 -->
<!-- version: 11 -->
# Plan v0.3.9 — Worker API générique + audit RAW Transaction
@@ -506,15 +506,18 @@ Après freeze fonctionnelle de `ksp-worker-api` en `pre.003`, l’audit RAW est
docs/architecture/011-RAW_TRANSACTION_ACQUISITION.md
```
Ce document séparera :
Après la synthèse `pre.006-fix.001`, ce document doit être lu comme une **architecture unique centrée sur Store / `RawTransaction`**, et non comme la juxtaposition chronologique des audits A/B. Il sépare :
```text
partie durable : taxonomy capabilities/roles/combinations/convergence
partie audit daté : disponibilité provider, quotas, replay, tiers et liens sources primaires
handoff : gaps Transport/Config 0.3.10 et applicability Backfill 0.3.12
centre durable : Store / RawTransaction / observations / provenance
producteur 1 : Job Backfill historique, paramétré, borné et terminable
producteur 2 : Worker Ingest continu, start/stop, sans requête métier historique
capabilities : HTTP / WS / gRPC / archive / EARLY utilisables selon l'intention
preuve datée : providers, réseaux, tiers, prix, replay et accès réellement prouvés
handoffs : Worker 0.3.10 et Backfill 0.3.12, sans edge Job <-> Worker
```
Ce choix évite de transformer le plan de release en registre provider tout en donnant à `0.3.10` et `0.3.12` une référence architecturale réauditable. L’index architecture ne sera synchronisé qu’au moment où ce document sera réellement créé, puis réconcilié dans le couloir documentaire final.
Les protocoles n'appartiennent à aucun producteur. Une capability gRPC/WS peut servir au Job lorsqu'elle fournit un historique/replay borné ; HTTP peut servir au Worker pour hydration, live block polling ou repair de sa continuité active. L’index architecture ne sera synchronisé qu’au moment où ce document sera réellement créé, puis réconcilié dans le couloir documentaire final.
kbot3 ne sera alors utilisé que pour inventorier des comportements historiques. Aucun code, DTO, Config, URL, dependency ou version n’en sera repris.
@@ -595,7 +598,13 @@ Budget cible : **15-20 min**. `docs/architecture/011-RAW_TRANSACTION_ACQUISITION
**Statut : réalisé ; synthèse exhaustive des possibilités, y compris non prouvées/non testables actuellement, sans changement runtime.**
Budget cible : **15-20 min**. `docs/architecture/011-RAW_TRANSACTION_ACQUISITION.md` ferme la matrice par familles de sources, providers, réseaux, prix/tier datés, temporalité, complétude, replay, destination Worker/Backfill et statut de preuve. La synthèse sépare explicitement possibilité connue, support KSP et preuve live afin qu'un tier payant ou un compte indisponible n'exclue jamais une branche de l'architecture. Le handoff `0.3.10` retient un Worker multi-source par capabilities, les adapters standard/Yellowstone/Helius déjà auditables, les hooks EARLY, la stratégie de gap repair et l'extraction de la canonicalisation dans `ksp-raw-transaction-lib`; `0.3.12` reçoit les stratégies block scan, replay Yellowstone, archives/provider history et Old Faithful. Aucun endpoint, secret ou client provider n'est ajouté ici.
Budget cible : **15-20 min**. `docs/architecture/011-RAW_TRANSACTION_ACQUISITION.md` ferme la matrice par familles de sources, providers, réseaux, prix/tier datés, temporalité, complétude, replay, destination Worker/Backfill et statut de preuve. La synthèse sépare explicitement possibilité connue, support KSP et preuve live afin qu'un tier payant ou un compte indisponible n'exclue jamais une branche de l'architecture. Le handoff distingue deux producteurs indépendants de Store : `0.3.10` reçoit le Worker live start/stop, sans requête historique métier, et les adaptations communes nécessaires ; `0.3.12` reçoit l'extension du Job Backfill historique paramétré. Les protocoles restent orthogonaux aux rôles : HTTP peut servir au Worker et WS/gRPC au Job lorsque leur sémantique le justifie. Aucun endpoint, secret ou client provider n'est ajouté ici.
#### `pre.006-fix.001` — synthèse Store-centrique et séparation stricte Worker / Backfill
**Statut : réalisé ; correctif documentaire uniquement.**
Réécriture complète de `docs/architecture/011-RAW_TRANSACTION_ACQUISITION.md` pour supprimer l'effet « audit A + audit B + synthèse ajoutée ». Le document devient une référence architecturale unique centrée sur `RawTransaction` dans Store. Il fixe explicitement : Job Backfill = historique paramétré/borné ; Worker Ingest = acquisition continue start/stop sans paramètres métier historiques ; aucun edge, délégation ou coordination obligatoire entre les deux ; capabilities HTTP/WS/gRPC/archive classifiées par usage et non par producteur. Le replay/repair Worker est limité à la continuité de son acquisition active et ne devient jamais une campagne historique. Correctif strictement documentaire : `workspace.package.version` reste `0.3.9-pre.6`.
### `pre.007` — gate technique final