115 lines
4.7 KiB
Markdown
115 lines
4.7 KiB
Markdown
<!-- file: deltas/0.3.9/pre.006.md -->
|
|
<!-- version: 1 -->
|
|
|
|
# Delta `0.3.9-pre.006`
|
|
|
|
## 1. Objet
|
|
|
|
Fermer l'audit RAW Transaction de `0.3.9` par une synthèse **exhaustive des possibilités d'acquisition**, sans limiter l'architecture aux providers/tiers actuellement accessibles à l'opérateur. La tranche distingue possibilité connue, support KSP et preuve live, classe les sources par réseau/coût/temporalité/complétude/replay et produit le handoff exact vers le Worker live `0.3.10` et l'extension Backfill `0.3.12`.
|
|
|
|
Aucun runtime d'acquisition n'est modifié dans cette tranche.
|
|
|
|
## 2. Baseline
|
|
|
|
Entrée : `0.3.9-pre.005` appliquée après la freeze Worker API `pre.003` et les audits RAW standard/providers `pre.004`/`pre.005`.
|
|
|
|
Dernier gate opérateur explicitement fourni avant cette tranche pour l'état documentaire `pre.004` :
|
|
|
|
```text
|
|
General Rust rule audit: clean
|
|
Rust export completeness audit: 0 candidate(s)
|
|
KSP workspace Rust rule audit: clean
|
|
Markdown table audit: clean (327 table(s), 738 file(s))
|
|
```
|
|
|
|
`pre.005` a ensuite été poursuivi sur demande de l'opérateur ; aucun gate Cargo `pre.005` n'est inventé par ce delta.
|
|
|
|
## 3. Version
|
|
|
|
```text
|
|
workspace.package.version = 0.3.9-pre.6
|
|
```
|
|
|
|
Cette livraison est une prerelease non-fix ; la synchronisation Cargo suit `VER-ID-009` même si la tranche reste documentaire côté runtime.
|
|
|
|
## 4. Synthèse fermée
|
|
|
|
`docs/architecture/011-RAW_TRANSACTION_ACQUISITION.md` ajoute :
|
|
|
|
- une légende d'admission/support/preuve ;
|
|
- la matrice exhaustive des familles HTTP, WS, Yellowstone, archive, self-hosted et pre-execution ;
|
|
- une matrice providers/réseaux/prix/tier/proof status datée au 4 septembre 2026 ;
|
|
- Helius, PublicNode, OrbitFlare, QuickNode, Alchemy, Chainstack, Shyft, Triton One, dRPC, Ankr, GetBlock et les providers Yellowstone génériques ;
|
|
- les feeds EARLY : Helius Shred Delivery, OrbitFlare Jetstream, Shyft RabbitStream, Triton Deshred/Shreds, bloXroute, DoubleZero et Jito sunset ;
|
|
- la stratégie réseau Mainnet/Devnet/Testnet/local ;
|
|
- le modèle Worker V1 par capabilities ;
|
|
- la déduplication de contenu séparée des observations de provenance ;
|
|
- l'échelle de gap repair replay -> redondance -> block scan -> hydration -> archive ;
|
|
- les adaptations Transport/Config requises pour `0.3.10` ;
|
|
- l'ownership commun de canonicalisation via `ksp-raw-transaction-lib` ;
|
|
- la matrice des stratégies Backfill destinées à `0.3.12` ;
|
|
- un ordre d'implémentation qui ne supprime aucune capability admise faute de compte payant.
|
|
|
|
## 5. Décisions d'architecture
|
|
|
|
```text
|
|
NON PROUVÉ != REJETÉ
|
|
PAYANT/BLOQUÉ != NON SUPPORTÉ
|
|
IMPLÉMENTÉ != PROUVÉ LIVE
|
|
```
|
|
|
|
`ksp-worker-raw-transaction-ingest-lib` sera multi-source par rôles/capabilities et pourra combiner sources directes full, discovery+hydration, replay, gap repair et signaux EARLY.
|
|
|
|
La canonicalisation RAW v1 commune ne reste pas dans `ksp-job-backfill-lib` et n'est pas copiée dans le Worker. `0.3.10` doit extraire la logique source-neutral dans `ksp-raw-transaction-lib`, avec golden bytes/hash inchangés.
|
|
|
|
## 6. Preuves et comptes disponibles
|
|
|
|
La synthèse sépare le support de la preuve afin de permettre :
|
|
|
|
```text
|
|
Mainnet standard HTTP/WS : smokes multi-provider gratuits quand accessibles
|
|
Mainnet Yellowstone : PublicNode disponible actuellement
|
|
Devnet : Solana public + providers gratuits, dont OrbitFlare gRPC
|
|
Testnet : Solana public + PublicNode
|
|
branches payantes : tests déterministes + smokes live ignored jusqu'à accès
|
|
local/custom : fixtures/Agave/Yellowstone auto-hébergé si nécessaire
|
|
```
|
|
|
|
Aucune clé, URL d'endpoint runtime ou donnée de compte n'est ajoutée au dépôt par cette tranche.
|
|
|
|
## 7. Fichiers
|
|
|
|
Modifiés :
|
|
|
|
```text
|
|
Cargo.toml
|
|
docs/architecture/011-RAW_TRANSACTION_ACQUISITION.md
|
|
docs/plans/030-V0_3_9_WORKER_API_RAW_TRANSACTION_AUDIT_PLAN.md
|
|
docs/validation/026-V0_3_9_WORKER_API_RAW_TRANSACTION_AUDIT.md
|
|
```
|
|
|
|
Ajouté :
|
|
|
|
```text
|
|
deltas/0.3.9/pre.006.md
|
|
```
|
|
|
|
Aucun fichier Rust, Config, schema, endpoint provider, secret ou Store n'est modifié.
|
|
|
|
## 8. Validation d'assemblage
|
|
|
|
Assemblage local :
|
|
|
|
```text
|
|
General Rust rule audit: clean
|
|
Rust export completeness audit: 0 candidate(s)
|
|
KSP workspace Rust rule audit: clean
|
|
Markdown table audit: clean (343 table(s), 740 file(s))
|
|
```
|
|
|
|
Le sandbox d'assemblage ne fournit pas Cargo ; aucun `cargo check`, Clippy ou test Rust `pre.006` n'est déclaré PASS localement. Les gates Cargo opérateur restent séparés et ne sont jamais inventés.
|
|
|
|
## 9. Handoff
|
|
|
|
Après `pre.006`, l'audit RAW est fonctionnellement fermé. `pre.007` doit être un **gate technique final** sans nouvelle fonctionnalité ; `pre.008` réconcilie les documents durables ; `pre.009` prépare le prompt `0.3.10` et la publication.
|