4.7 KiB
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 :
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
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
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 :
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 :
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é :
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 :
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.