Files
khadhroony-solana-project/deltas/0.3.9/pre.004.md
2026-09-04 21:23:46 +02:00

61 lines
3.3 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
<!-- file: deltas/0.3.9/pre.004.md -->
<!-- version: 1 -->
# Delta `0.3.9-pre.004`
## 1. Objet
Fermer l'audit RAW A après freeze effective de `ksp-worker-api` : Solana standard HTTP/WS, inventaire KSP Transport/Store/Config, taxonomie de capabilities et premiers gaps préparatoires pour `0.3.10`/`0.3.12`.
Aucun runtime, DTO Transport, Store model, Config profile ou Worker API n'est modifié.
## 2. Base et version
Base opérateur : `0.3.9-pre.3`, dont le gate Worker est PASS.
```text
workspace.package.version = 0.3.9-pre.4
```
## 3. Décisions
```text
getSignaturesForAddress + getTransaction -> history/catch-up/repair adressé
getBlocks/getBlocksWithLimit + getBlock -> catch-up/gap repair global sous gap provenance
logsSubscribe -> live discovery + hydration
signatureSubscribe -> confirmation ciblée, pas discovery
blockSubscribe -> direct full sous capability explicite, méthode instable
slot/ledger methods -> auxiliaires de continuité
reconnect WS -> jamais assimilé à replay
mainnet-beta -> identité réseau durable canonique
```
## 4. Gaps ouverts, non implémentés
- `get_block_observed` ou équivalent nécessaire si la voie bloc multi-endpoint est admise en V1 ;
- extraction/canonicalisation transaction-par-transaction depuis un bloc à définir ;
- canonicalizer RAW v1 actuellement owned par Backfill à rendre réutilisable sans dépendance Worker -> Job ni duplication ;
- gap repair explicite requis après reconnexion/overflow WS ;
- Config future à exprimer par capabilities/rôles et non enum de protocole ;
- cohérence `mainnet` profile alias / `mainnet-beta` durable à préserver.
## 5. Fichiers
| Fichier | Action | Rôle |
|----------------------------------------------------------------|--------|---------------------------------------|
| Cargo.toml | MOD | workspace `0.3.9-pre.4` |
| docs/000-README.md | MOD | indexe larchitecture RAW |
| docs/architecture/000-README.md | MOD | ajoute le document 011 |
| docs/architecture/011-RAW_TRANSACTION_ACQUISITION.md | ADD | audit standard + taxonomie + gaps |
| docs/plans/030-V0_3_9_WORKER_API_RAW_TRANSACTION_AUDIT_PLAN.md | MOD | freeze pre.003 + réalisation pre.004 |
| docs/validation/026-V0_3_9_WORKER_API_RAW_TRANSACTION_AUDIT.md | MOD | preuves opérateur + checklist pre.004 |
| deltas/0.3.9/pre.004.md | ADD | présent delta |
## 6. Sources externes
Documentation RPC Solana officielle consultée le 4 septembre 2026. Les liens exacts sont conservés dans `docs/architecture/011-RAW_TRANSACTION_ACQUISITION.md`. Les providers, quotas, Helius, Yellowstone et kbot3 restent réservés à `pre.005`.
## 7. Gates
Les audits Python sont exécutés après assemblage. Les gates Cargo de cette tranche restent à exécuter par l'opérateur ; le changement Rust se limite au metadata de version workspace.