Compare commits
27 Commits
| Author | SHA1 | Date | |
|---|---|---|---|
| 9785cda39d | |||
| 0cea99cd5e | |||
| 71bc754feb | |||
| cabbfed730 | |||
| 8b6ef7778a | |||
| 06319655b0 | |||
| f636169783 | |||
| 0f8f38ff52 | |||
| 142998afb3 | |||
| 665d7d2bb6 | |||
| 1746d47412 | |||
| 9bb2f7bcae | |||
| 1f2720463b | |||
| 8bb530e9b4 | |||
| 72df965a9c | |||
| f688325170 | |||
| c711213dcc | |||
| 11ecdccd65 | |||
| 27ab84d198 | |||
| 28e4da3879 | |||
| 31c0a83e51 | |||
| 34fddc3bf5 | |||
| 13c3dac554 | |||
| f7ed053e8e | |||
| 2e8feb56dd | |||
| 793178b345 | |||
| ee0359efd5 |
14
CHANGELOG.md
14
CHANGELOG.md
@@ -1,8 +1,20 @@
|
|||||||
<!-- file: CHANGELOG.md -->
|
<!-- file: CHANGELOG.md -->
|
||||||
<!-- version: 32 -->
|
<!-- version: 33 -->
|
||||||
|
|
||||||
# Changelog KSP
|
# Changelog KSP
|
||||||
|
|
||||||
|
## 0.3.13 — convergence live multi-source du Worker RawTransaction — 2026-09-10
|
||||||
|
|
||||||
|
`0.3.13` généralise `ksp-worker-raw-transaction-ingest-lib` de la verticale Yellowstone de `0.3.12` vers une composition caller-owned de `1..32` sources logiques appartenant au même réseau. Cinq familles live convergent désormais vers le même pipeline Common RAW / admission / Store : Yellowstone, Standard Logs avec hydration `getTransaction observed`, Standard Block RAW-direct, Helius `transactionSubscribe` avec hydration et HTTP Block Polling run-local RAW-direct. Le Worker reste sans Config, Job Backfill, backend Store physique, client réseau direct ou SDK provider parallèle.
|
||||||
|
|
||||||
|
La convergence partage un registre global d'hydration entre Yellowstone, Standard Logs et Helius afin de coalescer `(network, signature, commitment)` avant fan-out HTTP. Après canonicalisation, les acquisitions de même `(network, signature)` sont sérialisées de manière bornée : un contenu identique conserve les observations/provenances distinctes, tandis qu'une divergence devient un `content_conflict` terminal explicite. Aucune majorité provider, préférence silencieuse ou stratégie `first-provider-wins` n'est introduite. Standard Block et HTTP Block Polling admettent directement les transactions Legacy/V0/V1 qualifiées avec `maxSupportedTransactionVersion = 1`.
|
||||||
|
|
||||||
|
Le supervisor multi-source possède toutes les tâches et applique des bornes source-neutral sur admission, pending signals, hydrations et persistence avec une fairness minimale entre sources reference-bearing. Les snapshots agrègent activity/health/backpressure/reconnect/replay/gap sans exposer le matériau provider. La politique reste conservative : une source configurée qui échoue est terminale faute d'équivalence de coverage prouvée ; le gap repair, les rôles degraded/failover et la preuve de couverture restent donc `0.3.14`. Le shutdown stop/fault/drain/abort+join est durci contre les races, leaders d'hydration abandonnés, Store lent et publications tardives.
|
||||||
|
|
||||||
|
Le gate déterministe final passe `cargo fmt`, audits Rust/Markdown, `cargo check --workspace`, Clippy workspace/all-targets/all-features avec `-D warnings`, `cargo test --workspace --all-targets --all-features` et les graphes Cargo : `1 850` tests passent, `0` échoue et `15` restent ignored opt-in/operator-only. Les smokes keyless Solana HTTP Devnet et WebSocket Devnet passent `1/1` chacun. Yellowstone provider-gated, Helius `transactionSubscribe` live, `blockSubscribe` provider dédié, HTTP polling Worker end-to-end et Worker multi-source vers Store restent explicitement non exécutés faute de gate provisionné ; aucune fixture ne les requalifie en PASS.
|
||||||
|
|
||||||
|
`prompts/033-V0_3_14_START_PROMPT.md` ouvre `0.3.14` exclusivement depuis le futur tag stable `v0.3.13`. Cette release doit fermer le gap repair/hardening multi-source limité au run actif — replay adressable, coverage redondante, scan HTTP borné, hydration de réparation, unresolved gaps et health policy — sans transformer le Worker en moteur historique ni créer de dépendance vers `ksp-job-backfill-lib`.
|
||||||
|
|
||||||
## 0.3.12 — Yellowstone + hydration HTTP + continuité de run du Worker RawTransaction — 2026-09-09
|
## 0.3.12 — Yellowstone + hydration HTTP + continuité de run du Worker RawTransaction — 2026-09-09
|
||||||
|
|
||||||
`0.3.12` ouvre la première source réseau productive de `ksp-worker-raw-transaction-ingest-lib` sans remettre en cause la fondation source-neutral de `0.3.11`. Le Worker dépend désormais de la façade `ksp-onchain-transport-lib` mais reste sans Config, Job Backfill, backend Store physique, `reqwest`, `tonic` ou proto provider direct. `RawTransactionIngestRuntimeResources` reçoit une source Yellowstone caller-composed et un pool HTTP cohérent ; `start` conserve la fondation sans source, tandis que `start_with_runtime_resources` lance la verticale live supervisée.
|
`0.3.12` ouvre la première source réseau productive de `ksp-worker-raw-transaction-ingest-lib` sans remettre en cause la fondation source-neutral de `0.3.11`. Le Worker dépend désormais de la façade `ksp-onchain-transport-lib` mais reste sans Config, Job Backfill, backend Store physique, `reqwest`, `tonic` ou proto provider direct. `RawTransactionIngestRuntimeResources` reçoit une source Yellowstone caller-composed et un pool HTTP cohérent ; `start` conserve la fondation sans source, tandis que `start_with_runtime_resources` lance la verticale live supervisée.
|
||||||
|
|||||||
@@ -1,12 +1,12 @@
|
|||||||
# file: Cargo.toml
|
# file: Cargo.toml
|
||||||
# version: 539
|
# version: 565
|
||||||
|
|
||||||
[workspace]
|
[workspace]
|
||||||
resolver = "3"
|
resolver = "3"
|
||||||
members = ["crates/ksp-app-backfill-desk", "crates/ksp-app-config-desk", "crates/ksp-app-solprices-desk", "crates/ksp-app-store-desk", "crates/ksp-app-wallet-desk", "crates/ksp-config-lib", "crates/ksp-core-lib", "crates/ksp-interface-lib", "crates/ksp-job-api", "crates/ksp-job-backfill-lib", "crates/ksp-logging-lib", "crates/ksp-offchain-transport-lib", "crates/ksp-onchain-transport-lib", "crates/ksp-program-api", "crates/ksp-raw-transaction-lib", "crates/ksp-store-api", "crates/ksp-store-lib", "crates/ksp-store-postgres-lib", "crates/ksp-wallet-lib", "crates/ksp-worker-api", "crates/ksp-worker-raw-transaction-ingest-lib"]
|
members = ["crates/ksp-app-backfill-desk", "crates/ksp-app-config-desk", "crates/ksp-app-solprices-desk", "crates/ksp-app-store-desk", "crates/ksp-app-wallet-desk", "crates/ksp-config-lib", "crates/ksp-core-lib", "crates/ksp-interface-lib", "crates/ksp-job-api", "crates/ksp-job-backfill-lib", "crates/ksp-logging-lib", "crates/ksp-offchain-transport-lib", "crates/ksp-onchain-transport-lib", "crates/ksp-program-api", "crates/ksp-raw-transaction-lib", "crates/ksp-store-api", "crates/ksp-store-lib", "crates/ksp-store-postgres-lib", "crates/ksp-wallet-lib", "crates/ksp-worker-api", "crates/ksp-worker-raw-transaction-ingest-lib"]
|
||||||
|
|
||||||
[workspace.package]
|
[workspace.package]
|
||||||
version = "0.3.12"
|
version = "0.3.13"
|
||||||
edition = "2024"
|
edition = "2024"
|
||||||
license = "MIT"
|
license = "MIT"
|
||||||
repository = "https://git.sasedev.com/Sasedev/khadhroony-solana-project"
|
repository = "https://git.sasedev.com/Sasedev/khadhroony-solana-project"
|
||||||
|
|||||||
@@ -1,5 +1,5 @@
|
|||||||
<!-- file: README.md -->
|
<!-- file: README.md -->
|
||||||
<!-- version: 13 -->
|
<!-- version: 14 -->
|
||||||
|
|
||||||
# Khadhroony Solana Project
|
# Khadhroony Solana Project
|
||||||
|
|
||||||
@@ -57,7 +57,7 @@ La couche RAW dispose d'une façade Store backend-neutral et d'un premier job hi
|
|||||||
|
|
||||||
`ksp-worker-api` fournit désormais la fondation générique des services continus : identité Worker, lifecycle borné, health/activity, intention de stop coopératif et observation latest-value. Cette API reste Core-only, runtime-neutral et sans connaissance Solana, Transport, Store ou Job. Elle ne démarre ni n'arrête elle-même un runtime concret.
|
`ksp-worker-api` fournit désormais la fondation générique des services continus : identité Worker, lifecycle borné, health/activity, intention de stop coopératif et observation latest-value. Cette API reste Core-only, runtime-neutral et sans connaissance Solana, Transport, Store ou Job. Elle ne démarre ni n'arrête elle-même un runtime concret.
|
||||||
|
|
||||||
`ksp-worker-raw-transaction-ingest-lib` est le premier Worker concret distinct du Job Backfill. Il conserve sa fondation Start/Stop, admission bornée, Common RAW, Store backend-neutral, shutdown borné et snapshots latest-value, et possède maintenant une première source productive Yellowstone + hydration HTTP `getTransaction`. Les signaux `Transaction`, `TransactionStatus` et transactions de `Block` sont coalescés puis hydratés avant admission RAW ; `BlockMeta` et `Slot` restent des signaux de continuité. Le reconnect/replay reste propriétaire de Transport, la frontier de traitement reste run-local et un gap de rétention prouvé provoque un fault au lieu de lancer une campagne historique. `ksp-job-backfill-lib` conserve son rôle historique paramétré et borné ; les deux producteurs restent indépendants et convergent uniquement vers les mêmes contrats RAW/Store.
|
`ksp-worker-raw-transaction-ingest-lib` est le premier Worker concret distinct du Job Backfill. Il conserve sa fondation Start/Stop, admission bornée, Common RAW, Store backend-neutral, shutdown borné et snapshots latest-value. Ses sources productives couvrent maintenant Yellowstone + hydration HTTP `getTransaction`, Standard WS `logsSubscribe` + hydration, Standard WS `blockSubscribe` RAW-direct, Helius `transactionSubscribe` + hydration et Solana HTTP live block polling. Le polling HTTP démarre au `getSlot` observé du run, découvre uniquement les blocs live via `getBlocksWithLimit` puis matérialise les slots listés via `getBlock observed`; il n'est jamais utilisé comme Backfill implicite. Les signaux hydratés de même `(network, signature, commitment)` convergent vers le même coordinator, tandis que les voies block RAW-direct passent par la même admission Common RAW. Le reconnect/replay reste propriétaire de Transport, la frontier de traitement reste run-local et un gap de rétention prouvé provoque un fault au lieu de lancer une campagne historique. `ksp-job-backfill-lib` conserve son rôle historique paramétré et borné ; les deux producteurs restent indépendants et convergent uniquement vers les mêmes contrats RAW/Store.
|
||||||
|
|
||||||
## Points d'entrée
|
## Points d'entrée
|
||||||
|
|
||||||
|
|||||||
@@ -1,5 +1,5 @@
|
|||||||
<!-- file: ROADMAP.md -->
|
<!-- file: ROADMAP.md -->
|
||||||
<!-- version: 110 -->
|
<!-- version: 111 -->
|
||||||
|
|
||||||
# Roadmap KSP
|
# Roadmap KSP
|
||||||
|
|
||||||
@@ -105,7 +105,7 @@ RAW -> STRUCTURAL -> DECODED -> DOMAIN
|
|||||||
- [X] `0.3.10` — Lower-layer RAW Transaction commune stabilisée : `ksp-raw-transaction-lib` possède la canonicalisation RAW v1 source-neutral partagée, le Backfill est migré sans changement des golden bytes/hash, Transport expose `get_block_observed`, le wire Solana Legacy/V0/V1 est matérialisé et les canaris HTTP/WS standard/Helius/Yellowstone qualifient précisément les voies directes ou nécessitant hydration. La release se ferme sans runtime Worker concret ; celui-ci commence en `0.3.11` selon le redécoupage `0.3.11`–`0.3.14`.
|
- [X] `0.3.10` — Lower-layer RAW Transaction commune stabilisée : `ksp-raw-transaction-lib` possède la canonicalisation RAW v1 source-neutral partagée, le Backfill est migré sans changement des golden bytes/hash, Transport expose `get_block_observed`, le wire Solana Legacy/V0/V1 est matérialisé et les canaris HTTP/WS standard/Helius/Yellowstone qualifient précisément les voies directes ou nécessitant hydration. La release se ferme sans runtime Worker concret ; celui-ci commence en `0.3.11` selon le redécoupage `0.3.11`–`0.3.14`.
|
||||||
- [X] `0.3.11` — Fondation runtime de `ksp-worker-raw-transaction-ingest-lib` livrée : crate/dependency firewall, settings source-neutral, handle/start-stop, lifecycle, snapshots, supervisor, admission bornée, canonicalisation Common RAW, persistence/déduplication Store déterministe, backpressure et shutdown/fault hardening. La release se ferme volontairement sans source réseau productive ; Yellowstone + hydration HTTP commencent en `0.3.12`.
|
- [X] `0.3.11` — Fondation runtime de `ksp-worker-raw-transaction-ingest-lib` livrée : crate/dependency firewall, settings source-neutral, handle/start-stop, lifecycle, snapshots, supervisor, admission bornée, canonicalisation Common RAW, persistence/déduplication Store déterministe, backpressure et shutdown/fault hardening. La release se ferme volontairement sans source réseau productive ; Yellowstone + hydration HTTP commencent en `0.3.12`.
|
||||||
- [X] `0.3.12` — Première source live productive du Worker livrée : Yellowstone `Transaction`/`TransactionStatus`/`Block` vers signaux source-neutral, coalescence bornée puis hydration HTTP `getTransaction` observed avant Common RAW/Store ; `BlockMeta`/`Slot` restent continuity-only. Processing frontier run-local, reconnect/from_slot/ReplayInfo Transport-owned, compteurs source-neutral et fault sur gap de rétention prouvé sans Backfill automatique. Hardening duplicate/backpressure/stop/fault et canaris cross-layer fermés ; gate workspace complet vert, smokes live HTTP Devnet + WebSocket Devnet verts, Yellowstone token-gated/Worker end-to-end laissés explicitement non exécutés.
|
- [X] `0.3.12` — Première source live productive du Worker livrée : Yellowstone `Transaction`/`TransactionStatus`/`Block` vers signaux source-neutral, coalescence bornée puis hydration HTTP `getTransaction` observed avant Common RAW/Store ; `BlockMeta`/`Slot` restent continuity-only. Processing frontier run-local, reconnect/from_slot/ReplayInfo Transport-owned, compteurs source-neutral et fault sur gap de rétention prouvé sans Backfill automatique. Hardening duplicate/backpressure/stop/fault et canaris cross-layer fermés ; gate workspace complet vert, smokes live HTTP Devnet + WebSocket Devnet verts, Yellowstone token-gated/Worker end-to-end laissés explicitement non exécutés.
|
||||||
- [ ] `0.3.13` — Ajouter les voies **WS standard / Helius / HTTP live** et leur convergence multi-source : `logsSubscribe + getTransaction`, `blockSubscribe`, `transactionSubscribe + hydration`, polling blocs HTTP, observations multiples, content conflict explicite, coalescence et backpressure sans second actor Transport.
|
- [X] `0.3.13` — Convergence live multi-source du Worker RAW livrée : composition caller-owned `1..32` sources d’un même réseau, cinq familles Yellowstone / Standard Logs / Standard Block / Helius Transaction / HTTP Block Polling, hydration globale des trois voies reference-bearing, RAW-direct Legacy/V0/V1 pour les deux voies blocs, observations multiples, content conflict explicite, coalescence cross-source, fairness/backpressure/health source-neutral et shutdown hardening sans second actor Transport. Gate workspace complet vert (`1 850` PASS / `0` échec / `15` ignored) et smokes keyless HTTP + WebSocket Devnet verts ; les preuves provider/resource-gated non exécutées restent explicitement non revendiquées.
|
||||||
- [ ] `0.3.14` — Fermer le Worker par le **gap repair/hardening multi-source** : replay natif, source redondante, scan HTTP blocs, hydration de réparation, unresolved gaps visibles, politiques degraded/unhealthy/faulted, shutdown pendant repair, smokes provider accessibles et adapter EARLY seulement si réellement prouvé.
|
- [ ] `0.3.14` — Fermer le Worker par le **gap repair/hardening multi-source** : replay natif, source redondante, scan HTTP blocs, hydration de réparation, unresolved gaps visibles, politiques degraded/unhealthy/faulted, shutdown pendant repair, smokes provider accessibles et adapter EARLY seulement si réellement prouvé.
|
||||||
- [ ] `0.3.15` — Introduire `ksp-app-raw-transaction-ingest-desk`, Desk Tauri KSP spécialisée qui choisit et supervise une ou plusieurs sources/méthodes réellement admises par le Worker finalisé : lifecycle, health, rates, backpressure, reconnect/recovery, gap state et compteurs sûrs. La Desk ne réimplémente ni discovery, hydration, déduplication, reprise ni persistence.
|
- [ ] `0.3.15` — Introduire `ksp-app-raw-transaction-ingest-desk`, Desk Tauri KSP spécialisée qui choisit et supervise une ou plusieurs sources/méthodes réellement admises par le Worker finalisé : lifecycle, health, rates, backpressure, reconnect/recovery, gap state et compteurs sûrs. La Desk ne réimplémente ni discovery, hydration, déduplication, reprise ni persistence.
|
||||||
- [ ] `0.3.16` — Étendre `ksp-job-backfill-lib` et `ksp-app-backfill-desk` au **backfill multi-source/multi-stratégie** à partir de la même matrice d'acquisition auditée en `0.3.9`. Conserver la stratégie actuelle `getSignaturesForAddress + getTransaction` comme première voie HTTP valide, puis ajouter seulement les voies historiques/catch-up/gap-repair réellement pertinentes et sûres, sans supposer qu'une source live WS constitue un historique universel.
|
- [ ] `0.3.16` — Étendre `ksp-job-backfill-lib` et `ksp-app-backfill-desk` au **backfill multi-source/multi-stratégie** à partir de la même matrice d'acquisition auditée en `0.3.9`. Conserver la stratégie actuelle `getSignaturesForAddress + getTransaction` comme première voie HTTP valide, puis ajouter seulement les voies historiques/catch-up/gap-repair réellement pertinentes et sûres, sans supposer qu'une source live WS constitue un historique universel.
|
||||||
@@ -119,7 +119,7 @@ RAW -> STRUCTURAL -> DECODED -> DOMAIN
|
|||||||
|
|
||||||
- [ ] **TODO** — maintenir la matrice d’admission HTTP/WS/gRPC/provider lors de toute nouvelle famille D1 : plusieurs sources ne convergent vers un même struct que si elles satisfont la même sémantique sans perte.
|
- [ ] **TODO** — maintenir la matrice d’admission HTTP/WS/gRPC/provider lors de toute nouvelle famille D1 : plusieurs sources ne convergent vers un même struct que si elles satisfont la même sémantique sans perte.
|
||||||
- [X] **TODO `0.3.9`** — matrice RAW Transaction unique produite et consolidée dans `docs/architecture/011-RAW_TRANSACTION_ACQUISITION.md`, avec séparation possibilités/support/preuve, capabilities orthogonales aux producteurs, provenance/déduplication/continuité et handoffs désormais scindés `0.3.11`–`0.3.14` Worker live / `0.3.16` Backfill historique.
|
- [X] **TODO `0.3.9`** — matrice RAW Transaction unique produite et consolidée dans `docs/architecture/011-RAW_TRANSACTION_ACQUISITION.md`, avec séparation possibilités/support/preuve, capabilities orthogonales aux producteurs, provenance/déduplication/continuité et handoffs désormais scindés `0.3.11`–`0.3.14` Worker live / `0.3.16` Backfill historique.
|
||||||
- [ ] **TODO Helius `0.3.13`** — ajouter uniquement les profils/capabilities Helius réellement nécessaires au Worker live après revalidation des surfaces/tier courants ; réutiliser exclusivement `KSP_SECRET_HELIUS_API_KEY` via Config et la surface `transactionSubscribe` déjà Transport-owned, sans SDK provider ni second client parallèle.
|
- [X] **TODO Helius `0.3.13`** — la voie Worker Helius `transactionSubscribe` réutilise la surface Transport et les profils Config Helius déjà existants avec `KSP_SECRET_HELIUS_API_KEY`; aucun nouveau profil, secret, SDK provider, tier codé ou second client parallèle n’a été nécessaire. Le payload riche reste Transport-owned et la voie Worker hydrate via `getTransaction observed` tant que le RAW complet n’est pas prouvé directement.
|
||||||
- [X] **TODO réseau** — identité KSP canonique fixée à `mainnet` dans Config/Store/Transport/tests ; `mainnet-beta` reste uniquement un alias legacy/externe lorsque la frontière provider l'exige. Les données D1 RAW antérieures restent non autoritaires pendant cette phase et aucune compatibilité de base de test n'impose l'ancien libellé.
|
- [X] **TODO réseau** — identité KSP canonique fixée à `mainnet` dans Config/Store/Transport/tests ; `mainnet-beta` reste uniquement un alias legacy/externe lorsque la frontière provider l'exige. Les données D1 RAW antérieures restent non autoritaires pendant cette phase et aucune compatibilité de base de test n'impose l'ancien libellé.
|
||||||
- [X] `RawAccountState` + observation — contrat commun stabilisé en `0.3.1` avec bytes complets + slot, provenance séparée et enrichissements source-specific optionnels ; la persistence PostgreSQL physique est complétée en `0.3.4` avec les quatre capabilities account et la conformance RAW 10/10.
|
- [X] `RawAccountState` + observation — contrat commun stabilisé en `0.3.1` avec bytes complets + slot, provenance séparée et enrichissements source-specific optionnels ; la persistence PostgreSQL physique est complétée en `0.3.4` avec les quatre capabilities account et la conformance RAW 10/10.
|
||||||
- [ ] **TODO** — statut/commitment transactionnel restant : `0.3.5` couvre uniquement le fait passif d’exécution `slot + signature + outcome`; réauditer séparément `signatureSubscribe` et `getSignatureStatuses` lorsqu’un consumer de commitment/snapshot réel apparaît, sans fusionner snapshot, transition et execution update dans un modèle Option-soup.
|
- [ ] **TODO** — statut/commitment transactionnel restant : `0.3.5` couvre uniquement le fait passif d’exécution `slot + signature + outcome`; réauditer séparément `signatureSubscribe` et `getSignatureStatuses` lorsqu’un consumer de commitment/snapshot réel apparaît, sans fusionner snapshot, transition et execution update dans un modèle Option-soup.
|
||||||
|
|||||||
@@ -1,5 +1,5 @@
|
|||||||
// file: crates/ksp-onchain-transport-lib/src/grpc_subscribe.rs
|
// file: crates/ksp-onchain-transport-lib/src/grpc_subscribe.rs
|
||||||
// version: 8
|
// version: 9
|
||||||
|
|
||||||
const MAX_GRPC_BLOCKHASH_TEXT_LENGTH_BYTES: usize = 128;
|
const MAX_GRPC_BLOCKHASH_TEXT_LENGTH_BYTES: usize = 128;
|
||||||
const MAX_GRPC_BLOCK_VECTOR_COUNT: usize = 65_536;
|
const MAX_GRPC_BLOCK_VECTOR_COUNT: usize = 65_536;
|
||||||
@@ -2529,13 +2529,34 @@ impl YellowstoneSubscribeEntryFilter {
|
|||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
|
/// Opaque deterministic identity material for one complete Yellowstone Subscribe request.
|
||||||
|
///
|
||||||
|
/// The encoded bytes remain private. `Hash` feeds those canonical bytes to a caller-provided hasher while `Debug` exposes only their length.
|
||||||
|
#[derive(Clone, Eq, PartialEq)]
|
||||||
|
pub struct YellowstoneSubscribeRequestIdentity {
|
||||||
|
bytes: std::vec::Vec<u8>,
|
||||||
|
}
|
||||||
|
|
||||||
|
impl std::hash::Hash for crate::YellowstoneSubscribeRequestIdentity {
|
||||||
|
fn hash<H: std::hash::Hasher>(&self, state: &mut H) {
|
||||||
|
state.write(&(self.bytes.len() as u64).to_be_bytes());
|
||||||
|
state.write(self.bytes.as_slice());
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
impl std::fmt::Debug for crate::YellowstoneSubscribeRequestIdentity {
|
||||||
|
fn fmt(&self, formatter: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
|
||||||
|
return formatter.debug_struct("YellowstoneSubscribeRequestIdentity").field("byte_len", &self.bytes.len()).finish();
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
/// Provider-neutral standard Yellowstone subscribe request owned by KSP.
|
/// Provider-neutral standard Yellowstone subscribe request owned by KSP.
|
||||||
///
|
///
|
||||||
/// The seven upstream maps are represented independently and retain named empty entries. An entirely empty map is the logical KSP representation of no active
|
/// The seven upstream maps are represented independently and retain named empty entries. An entirely empty map is the logical KSP representation of no active
|
||||||
/// filter in that family; protobuf map encoding does not distinguish an omitted map from an empty map. Filter-group names are globally unique across all seven
|
/// filter in that family; protobuf map encoding does not distinguish an omitted map from an empty map. Filter-group names are globally unique across all seven
|
||||||
/// maps so the names echoed by `SubscribeUpdate.filters` remain unambiguous. `Debug` exposes only counts and common scalar options, never filter names or
|
/// maps so the names echoed by `SubscribeUpdate.filters` remain unambiguous. `Debug` exposes only counts and common scalar options, never filter names or
|
||||||
/// future
|
/// future filter payloads.
|
||||||
/// filter payloads.
|
|
||||||
#[derive(Clone, Eq, PartialEq)]
|
#[derive(Clone, Eq, PartialEq)]
|
||||||
pub struct YellowstoneSubscribeRequest {
|
pub struct YellowstoneSubscribeRequest {
|
||||||
accounts: std::collections::BTreeMap<crate::YellowstoneSubscribeFilterName, crate::YellowstoneSubscribeAccountFilter>,
|
accounts: std::collections::BTreeMap<crate::YellowstoneSubscribeFilterName, crate::YellowstoneSubscribeAccountFilter>,
|
||||||
@@ -2551,7 +2572,7 @@ pub struct YellowstoneSubscribeRequest {
|
|||||||
from_slot: std::option::Option<u64>,
|
from_slot: std::option::Option<u64>,
|
||||||
}
|
}
|
||||||
|
|
||||||
impl YellowstoneSubscribeRequest {
|
impl crate::YellowstoneSubscribeRequest {
|
||||||
/// Creates an empty subscribe request. Empty requests are valid because later bidi lifecycle code uses request mutations to clear filters or carry ping
|
/// Creates an empty subscribe request. Empty requests are valid because later bidi lifecycle code uses request mutations to clear filters or carry ping
|
||||||
/// state.
|
/// state.
|
||||||
#[must_use]
|
#[must_use]
|
||||||
@@ -2762,6 +2783,40 @@ impl YellowstoneSubscribeRequest {
|
|||||||
return self.from_slot;
|
return self.from_slot;
|
||||||
}
|
}
|
||||||
|
|
||||||
|
/// Builds one opaque deterministic identity for the complete logical Subscribe request.
|
||||||
|
///
|
||||||
|
/// The identity preserves filter-family separation, globally sorted filter names, exact filter wire payloads and common request options. Its Debug surface
|
||||||
|
/// exposes only the encoded byte length. Callers may hash the opaque value but cannot recover the underlying identity bytes through this API.
|
||||||
|
pub fn identity(&self) -> ksp_core_lib::Result<crate::YellowstoneSubscribeRequestIdentity> {
|
||||||
|
let validation = self.validate();
|
||||||
|
if let std::result::Result::Err(error) = validation {
|
||||||
|
return std::result::Result::Err(error);
|
||||||
|
}
|
||||||
|
let mut bytes = std::vec::Vec::new();
|
||||||
|
append_subscribe_identity_map(&mut bytes, b"accounts", &self.accounts, |filter| return filter.to_wire());
|
||||||
|
append_subscribe_identity_map(&mut bytes, b"blocks", &self.blocks, |filter| return filter.to_wire());
|
||||||
|
append_subscribe_identity_map(&mut bytes, b"blocks_meta", &self.blocks_meta, |filter| return filter.to_wire());
|
||||||
|
append_subscribe_identity_map(&mut bytes, b"entry", &self.entry, |filter| return filter.to_wire());
|
||||||
|
append_subscribe_identity_map(&mut bytes, b"slots", &self.slots, |filter| return filter.to_wire());
|
||||||
|
append_subscribe_identity_map(&mut bytes, b"transactions", &self.transactions, |filter| return filter.to_wire());
|
||||||
|
append_subscribe_identity_map(&mut bytes, b"transactions_status", &self.transactions_status, |filter| return filter.to_wire());
|
||||||
|
let mut common = match self.to_wire() {
|
||||||
|
std::result::Result::Ok(value) => value,
|
||||||
|
std::result::Result::Err(error) => return std::result::Result::Err(error),
|
||||||
|
};
|
||||||
|
common.accounts.clear();
|
||||||
|
common.blocks.clear();
|
||||||
|
common.blocks_meta.clear();
|
||||||
|
common.entry.clear();
|
||||||
|
common.slots.clear();
|
||||||
|
common.transactions.clear();
|
||||||
|
common.transactions_status.clear();
|
||||||
|
let common = yellowstone_grpc_proto::prost::Message::encode_to_vec(&common);
|
||||||
|
append_subscribe_identity_component(&mut bytes, b"common");
|
||||||
|
append_subscribe_identity_component(&mut bytes, common.as_slice());
|
||||||
|
return std::result::Result::Ok(crate::YellowstoneSubscribeRequestIdentity { bytes });
|
||||||
|
}
|
||||||
|
|
||||||
/// Validates all deterministic common subscribe-request bounds before any network I/O.
|
/// Validates all deterministic common subscribe-request bounds before any network I/O.
|
||||||
pub fn validate(&self) -> ksp_core_lib::Result<()> {
|
pub fn validate(&self) -> ksp_core_lib::Result<()> {
|
||||||
if self.total_filter_count() > MAX_GRPC_SUBSCRIBE_FILTER_GROUP_COUNT {
|
if self.total_filter_count() > MAX_GRPC_SUBSCRIBE_FILTER_GROUP_COUNT {
|
||||||
@@ -3710,13 +3765,38 @@ fn commitment_to_wire(commitment: std::option::Option<crate::SolanaCommitment>)
|
|||||||
});
|
});
|
||||||
}
|
}
|
||||||
|
|
||||||
impl std::default::Default for YellowstoneSubscribeRequest {
|
fn append_subscribe_identity_component(output: &mut std::vec::Vec<u8>, value: &[u8]) {
|
||||||
|
output.extend_from_slice(&(value.len() as u64).to_be_bytes());
|
||||||
|
output.extend_from_slice(value);
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
|
||||||
|
fn append_subscribe_identity_map<V, W, F>(
|
||||||
|
output: &mut std::vec::Vec<u8>,
|
||||||
|
family: &[u8],
|
||||||
|
values: &std::collections::BTreeMap<crate::YellowstoneSubscribeFilterName, V>,
|
||||||
|
mut to_wire: F,
|
||||||
|
) where
|
||||||
|
W: yellowstone_grpc_proto::prost::Message,
|
||||||
|
F: FnMut(&V) -> W,
|
||||||
|
{
|
||||||
|
append_subscribe_identity_component(output, family);
|
||||||
|
output.extend_from_slice(&(values.len() as u64).to_be_bytes());
|
||||||
|
for (name, filter) in values {
|
||||||
|
append_subscribe_identity_component(output, name.as_str().as_bytes());
|
||||||
|
let wire = yellowstone_grpc_proto::prost::Message::encode_to_vec(&to_wire(filter));
|
||||||
|
append_subscribe_identity_component(output, wire.as_slice());
|
||||||
|
}
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
|
||||||
|
impl std::default::Default for crate::YellowstoneSubscribeRequest {
|
||||||
fn default() -> Self {
|
fn default() -> Self {
|
||||||
return Self::new();
|
return Self::new();
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
impl std::fmt::Debug for YellowstoneSubscribeRequest {
|
impl std::fmt::Debug for crate::YellowstoneSubscribeRequest {
|
||||||
fn fmt(&self, formatter: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
|
fn fmt(&self, formatter: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
|
||||||
return formatter
|
return formatter
|
||||||
.debug_struct("YellowstoneSubscribeRequest")
|
.debug_struct("YellowstoneSubscribeRequest")
|
||||||
|
|||||||
@@ -1,5 +1,5 @@
|
|||||||
// file: crates/ksp-onchain-transport-lib/src/lib.rs
|
// file: crates/ksp-onchain-transport-lib/src/lib.rs
|
||||||
// version: 46
|
// version: 47
|
||||||
|
|
||||||
#![warn(missing_docs)]
|
#![warn(missing_docs)]
|
||||||
#![deny(unreachable_pub)]
|
#![deny(unreachable_pub)]
|
||||||
@@ -215,6 +215,8 @@ pub use self::grpc_subscribe::YellowstoneSubscribePingUpdate;
|
|||||||
pub use self::grpc_subscribe::YellowstoneSubscribePongUpdate;
|
pub use self::grpc_subscribe::YellowstoneSubscribePongUpdate;
|
||||||
/// Provider-neutral standard Yellowstone Subscribe request.
|
/// Provider-neutral standard Yellowstone Subscribe request.
|
||||||
pub use self::grpc_subscribe::YellowstoneSubscribeRequest;
|
pub use self::grpc_subscribe::YellowstoneSubscribeRequest;
|
||||||
|
/// Opaque deterministic identity for one complete Yellowstone Subscribe request.
|
||||||
|
pub use self::grpc_subscribe::YellowstoneSubscribeRequestIdentity;
|
||||||
/// Complete slot-family filter group for standard Yellowstone Subscribe.
|
/// Complete slot-family filter group for standard Yellowstone Subscribe.
|
||||||
pub use self::grpc_subscribe::YellowstoneSubscribeSlotFilter;
|
pub use self::grpc_subscribe::YellowstoneSubscribeSlotFilter;
|
||||||
/// Complete transaction-family filter shared by transactions and transaction-status maps.
|
/// Complete transaction-family filter shared by transactions and transaction-status maps.
|
||||||
|
|||||||
@@ -1,5 +1,5 @@
|
|||||||
// file: crates/ksp-onchain-transport-lib/tests/public_api.rs
|
// file: crates/ksp-onchain-transport-lib/tests/public_api.rs
|
||||||
// version: 51
|
// version: 52
|
||||||
|
|
||||||
//! Integration tests for the public `ksp-onchain-transport-lib` consumer contract.
|
//! Integration tests for the public `ksp-onchain-transport-lib` consumer contract.
|
||||||
|
|
||||||
@@ -1032,3 +1032,15 @@ fn public_v0_3_10_pre_004_observed_get_block_surface_is_available_from_crate_roo
|
|||||||
let _ = method;
|
let _ = method;
|
||||||
return;
|
return;
|
||||||
}
|
}
|
||||||
|
|
||||||
|
#[test]
|
||||||
|
fn public_v0_3_13_pre_002_yellowstone_subscribe_identity_is_opaque_and_available_from_crate_root() {
|
||||||
|
let request = ksp_onchain_transport_lib::YellowstoneSubscribeRequest::new();
|
||||||
|
let identity = request.identity().expect("empty validated request identity must build");
|
||||||
|
let _identity_type = std::any::type_name::<ksp_onchain_transport_lib::YellowstoneSubscribeRequestIdentity>();
|
||||||
|
let debug = std::format!("{identity:?}");
|
||||||
|
assert!(debug.contains("YellowstoneSubscribeRequestIdentity"));
|
||||||
|
assert!(debug.contains("byte_len"));
|
||||||
|
assert!(!debug.contains("bytes:"));
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
|||||||
@@ -1,5 +1,5 @@
|
|||||||
// file: crates/ksp-onchain-transport-lib/tests/release_completeness.rs
|
// file: crates/ksp-onchain-transport-lib/tests/release_completeness.rs
|
||||||
// version: 43
|
// version: 44
|
||||||
|
|
||||||
//! Release-level completeness canaries for staged HTTP and WebSocket Transport coverage.
|
//! Release-level completeness canaries for staged HTTP and WebSocket Transport coverage.
|
||||||
|
|
||||||
@@ -1339,3 +1339,18 @@ fn release_v0_2_9_pre_010_adds_bounded_reconnect_replay_and_conservative_continu
|
|||||||
let _snapshot = std::any::type_name::<ksp_onchain_transport_lib::YellowstoneGrpcSubscribeSnapshot>();
|
let _snapshot = std::any::type_name::<ksp_onchain_transport_lib::YellowstoneGrpcSubscribeSnapshot>();
|
||||||
let _state = ksp_onchain_transport_lib::YellowstoneGrpcSubscribeState::Reconnecting;
|
let _state = ksp_onchain_transport_lib::YellowstoneGrpcSubscribeState::Reconnecting;
|
||||||
}
|
}
|
||||||
|
|
||||||
|
#[test]
|
||||||
|
fn release_v0_3_13_pre_002_yellowstone_subscribe_identity_remains_opaque_and_dependency_neutral() {
|
||||||
|
let source = include_str!("../src/grpc_subscribe.rs");
|
||||||
|
let root = include_str!("../src/lib.rs");
|
||||||
|
let identity_start = source.find("pub struct YellowstoneSubscribeRequestIdentity").expect("identity struct must remain present");
|
||||||
|
let request_start = source.find("/// Provider-neutral standard Yellowstone subscribe request").expect("request contract marker must remain present");
|
||||||
|
let identity_surface = &source[identity_start..request_start];
|
||||||
|
assert!(source.contains("pub fn identity(&self)"));
|
||||||
|
assert!(root.contains("pub use self::grpc_subscribe::YellowstoneSubscribeRequestIdentity;"));
|
||||||
|
assert!(!identity_surface.contains("pub fn bytes("));
|
||||||
|
assert!(!identity_surface.contains("pub fn as_bytes("));
|
||||||
|
assert!(!root.contains("pub use yellowstone_grpc_proto"));
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
|||||||
@@ -1,5 +1,5 @@
|
|||||||
// file: crates/ksp-onchain-transport-lib/unit_tests/grpc_subscribe.rs
|
// file: crates/ksp-onchain-transport-lib/unit_tests/grpc_subscribe.rs
|
||||||
// version: 5
|
// version: 6
|
||||||
|
|
||||||
fn filter_name(value: &str) -> crate::YellowstoneSubscribeFilterName {
|
fn filter_name(value: &str) -> crate::YellowstoneSubscribeFilterName {
|
||||||
return crate::YellowstoneSubscribeFilterName::new(value).expect("fixture filter name must validate");
|
return crate::YellowstoneSubscribeFilterName::new(value).expect("fixture filter name must validate");
|
||||||
@@ -138,6 +138,37 @@ fn yellowstone_subscribe_common_bounds_reject_before_wire_conversion() {
|
|||||||
assert!(filters.insert_account_filter(excess_name, crate::YellowstoneSubscribeAccountFilter::new()).is_err());
|
assert!(filters.insert_account_filter(excess_name, crate::YellowstoneSubscribeAccountFilter::new()).is_err());
|
||||||
}
|
}
|
||||||
|
|
||||||
|
#[test]
|
||||||
|
fn yellowstone_subscribe_request_identity_is_order_stable_exact_and_debug_redacted() {
|
||||||
|
let mut first = crate::YellowstoneSubscribeRequest::new();
|
||||||
|
let mut second = crate::YellowstoneSubscribeRequest::new();
|
||||||
|
let mut changed = crate::YellowstoneSubscribeRequest::new();
|
||||||
|
let mut filter_a = crate::YellowstoneSubscribeTransactionFilter::new();
|
||||||
|
filter_a.set_failed(std::option::Option::Some(false));
|
||||||
|
let mut filter_b = crate::YellowstoneSubscribeTransactionFilter::new();
|
||||||
|
filter_b.set_vote(std::option::Option::Some(false));
|
||||||
|
assert!(first.insert_transaction_filter(filter_name("identity-filter-beta-canary"), filter_b.clone()).is_ok());
|
||||||
|
assert!(first.insert_transaction_filter(filter_name("identity-filter-alpha-canary"), filter_a.clone()).is_ok());
|
||||||
|
assert!(second.insert_transaction_filter(filter_name("identity-filter-alpha-canary"), filter_a.clone()).is_ok());
|
||||||
|
assert!(second.insert_transaction_filter(filter_name("identity-filter-beta-canary"), filter_b.clone()).is_ok());
|
||||||
|
filter_a.set_failed(std::option::Option::Some(true));
|
||||||
|
assert!(changed.insert_transaction_filter(filter_name("identity-filter-alpha-canary"), filter_a).is_ok());
|
||||||
|
assert!(changed.insert_transaction_filter(filter_name("identity-filter-beta-canary"), filter_b).is_ok());
|
||||||
|
first.set_commitment(std::option::Option::Some(crate::SolanaCommitment::Confirmed));
|
||||||
|
second.set_commitment(std::option::Option::Some(crate::SolanaCommitment::Confirmed));
|
||||||
|
changed.set_commitment(std::option::Option::Some(crate::SolanaCommitment::Confirmed));
|
||||||
|
let first_identity = first.identity().expect("first request identity must build");
|
||||||
|
let second_identity = second.identity().expect("second request identity must build");
|
||||||
|
let changed_identity = changed.identity().expect("changed request identity must build");
|
||||||
|
assert_eq!(first_identity, second_identity);
|
||||||
|
assert_ne!(first_identity, changed_identity);
|
||||||
|
let debug = std::format!("{first_identity:?}");
|
||||||
|
assert!(debug.contains("byte_len"));
|
||||||
|
assert!(!debug.contains("identity-filter-alpha-canary"));
|
||||||
|
assert!(!debug.contains("identity-filter-beta-canary"));
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
|
||||||
#[test]
|
#[test]
|
||||||
fn yellowstone_subscribe_debug_omits_filter_names_and_future_payloads() {
|
fn yellowstone_subscribe_debug_omits_filter_names_and_future_payloads() {
|
||||||
let mut request = crate::YellowstoneSubscribeRequest::new();
|
let mut request = crate::YellowstoneSubscribeRequest::new();
|
||||||
|
|||||||
@@ -1,5 +1,5 @@
|
|||||||
<!-- file: crates/ksp-worker-raw-transaction-ingest-lib/README.md -->
|
<!-- file: crates/ksp-worker-raw-transaction-ingest-lib/README.md -->
|
||||||
<!-- version: 2 -->
|
<!-- version: 11 -->
|
||||||
|
|
||||||
# ksp-worker-raw-transaction-ingest-lib
|
# ksp-worker-raw-transaction-ingest-lib
|
||||||
|
|
||||||
@@ -12,22 +12,46 @@ RawTransactionIngestWorker::start
|
|||||||
-> fondation source-neutral, sans source productive
|
-> fondation source-neutral, sans source productive
|
||||||
|
|
||||||
RawTransactionIngestWorker::start_with_runtime_resources
|
RawTransactionIngestWorker::start_with_runtime_resources
|
||||||
-> même runtime + une source Yellowstone productive supervisée
|
-> même runtime + 1..32 sources productives supervisées simultanément
|
||||||
+ hydration HTTP getTransaction
|
Yellowstone, WS standard logsSubscribe, WS standard blockSubscribe, Helius transactionSubscribe et/ou HTTP block polling
|
||||||
|
+ hydration HTTP getTransaction lorsque la source produit une référence
|
||||||
```
|
```
|
||||||
|
|
||||||
Le Worker reste indépendant de Config et de tout backend Store physique. Le caller compose les ressources Transport et Store, puis les remet à la crate par ses façades publiques.
|
Le Worker reste indépendant de Config et de tout backend Store physique. Le caller compose les ressources Transport et Store, puis les remet à la crate par ses façades publiques.
|
||||||
|
|
||||||
## Pipeline productif actuel
|
## Pipeline productif actuel
|
||||||
|
|
||||||
La première verticale live est :
|
Les verticales live productives sont :
|
||||||
|
|
||||||
```text
|
```text
|
||||||
Yellowstone standard subscribe
|
Yellowstone standard subscribe
|
||||||
-> Transaction / TransactionStatus / Block
|
-> Transaction / TransactionStatus / Block
|
||||||
-> signal source-neutral (network, signature, slot, commitment, provenance sûre)
|
-> signal source-neutral (network, signature, slot, commitment, provenance sûre)
|
||||||
|
|
||||||
|
Solana standard WS logsSubscribe
|
||||||
|
-> context.slot + signature
|
||||||
|
-> signal source-neutral (network, signature, slot, commitment, provenance sûre)
|
||||||
-> coalescence bornée par (network, signature, commitment)
|
-> coalescence bornée par (network, signature, commitment)
|
||||||
-> HTTP getTransaction observed
|
-> HTTP getTransaction observed, Base64, maxSupportedTransactionVersion=1
|
||||||
|
|
||||||
|
Solana standard WS blockSubscribe
|
||||||
|
-> Full + Base64 + maxSupportedTransactionVersion=1 + showRewards=false
|
||||||
|
-> qualification explicite Legacy / V0 / V1
|
||||||
|
-> matériau Common RAW direct par transaction du bloc
|
||||||
|
|
||||||
|
Helius transactionSubscribe
|
||||||
|
-> Full + Base64 + maxSupportedTransactionVersion=1 + showRewards=false
|
||||||
|
-> signature + slot + transactionIndex uniquement dans le signal Worker
|
||||||
|
-> coalescence bornée par (network, signature, commitment)
|
||||||
|
-> HTTP getTransaction observed avant Common RAW
|
||||||
|
|
||||||
|
Solana HTTP live block polling
|
||||||
|
-> getSlot borne le run courant
|
||||||
|
-> getBlocksWithLimit découvre les blocs live
|
||||||
|
-> getBlock observed matérialise Full/Base64 Legacy/V0/V1
|
||||||
|
-> matériau Common RAW direct par transaction du bloc
|
||||||
|
|
||||||
|
les chemins productifs
|
||||||
-> ksp-raw-transaction-lib
|
-> ksp-raw-transaction-lib
|
||||||
-> admission centrale bornée
|
-> admission centrale bornée
|
||||||
-> ksp-store-lib
|
-> ksp-store-lib
|
||||||
@@ -58,7 +82,77 @@ La construction est sans I/O et refuse notamment :
|
|||||||
- une provenance provider/endpoint non représentable ;
|
- une provenance provider/endpoint non représentable ;
|
||||||
- l'absence d'une route HTTP compatible pour `getTransaction` sur le même réseau.
|
- l'absence d'une route HTTP compatible pour `getTransaction` sur le même réseau.
|
||||||
|
|
||||||
Le runtime-resource aggregate public contient exactement une source Yellowstone validée. Il n'expose ni enum provider, ni collection de sources, ni callback, ni queue d'enqueue, ni client inférieur.
|
Le runtime-resource aggregate public accepte une collection validée de 1 à 32 sources logiques et les démarre simultanément sous un supervisor privé. La collection est validée entièrement avant spawn ; aucun sous-ensemble silencieux, source primaire implicite ou standby n'est choisi. La collection interne, les `source_key`, les URLs, les filtres et les clients inférieurs ne sont pas exposés.
|
||||||
|
|
||||||
|
Le supervisor possède toutes les tâches source. Une source qui échoue est terminale pour le Worker et déclenche l'arrêt coopératif puis le join des autres sources, car cette release ne suppose aucune équivalence de coverage. Une fermeture propre d'une source alors que le Worker n'est pas en arrêt est également traitée comme une perte de source configurée et devient terminale.
|
||||||
|
|
||||||
|
Un inventaire privé `source_key -> latest processing/source state`, borné à 32 entrées, agrège la projection run-local. La frontier agrégée reste conservative : elle n'expose un `processing_frontier_slot` que lorsque toutes les sources en possèdent un, choisit le minimum des frontiers connus et le plus ancien pending. Les sources reference-bearing partagent en plus un registre global d'hydration borné : une même clé `(network, signature, commitment)` ne déclenche qu'un leader HTTP, puis chaque signal source conserve sa propre provenance lors de la finalisation.
|
||||||
|
|
||||||
|
## Contrat de source Standard Logs + HTTP
|
||||||
|
|
||||||
|
`RawTransactionIngestStandardLogsSource::new` reçoit :
|
||||||
|
|
||||||
|
```text
|
||||||
|
WsEndpointSettings kind solana_standard
|
||||||
|
SolanaLogsSubscribeFilter
|
||||||
|
SolanaCommitment Confirmed ou Finalized
|
||||||
|
HttpTransportPool
|
||||||
|
HttpRoleName d'hydration
|
||||||
|
```
|
||||||
|
|
||||||
|
La construction est sans I/O. Elle refuse un endpoint WS invalide ou non standard, `Processed`, un réseau/provenance non représentable et l'absence de route HTTP `getTransaction` compatible sur le même réseau. Le filtre `All`, `AllWithVotes` ou `Mentions(pubkey)` participe uniquement à une empreinte privée ; le pubkey d'un filtre `Mentions` n'est pas recopié dans `Debug`, snapshot ou provenance textuelle.
|
||||||
|
|
||||||
|
Au runtime, le Worker ouvre `SolanaStandardWsSession::connect`, puis `logs_subscribe`. Les lignes de logs et `err` restent dans Transport et ne sont jamais stockées dans le signal Worker. Seuls `context.slot` et `signature` sont projetés vers l'hydration commune. Reconnect, resubscribe et backpressure de la subscription restent possédés par Transport.
|
||||||
|
|
||||||
|
## Contrat de source Standard Block direct RAW
|
||||||
|
|
||||||
|
`RawTransactionIngestStandardBlockSource::new` reçoit :
|
||||||
|
|
||||||
|
```text
|
||||||
|
WsEndpointSettings kind solana_standard
|
||||||
|
SolanaBlockSubscribeFilter
|
||||||
|
SolanaCommitment Confirmed ou Finalized
|
||||||
|
```
|
||||||
|
|
||||||
|
Le runtime ouvre la `SolanaStandardWsSession` existante et demande exactement `Base64`, `Full`, `maxSupportedTransactionVersion = 1` et `showRewards = false`. Aucun `HttpTransportPool` n'est attaché à cette source : les transactions dont la version est explicitement `Legacy`, `0` ou `1` sont transformées directement en `RawTransactionMaterial` à partir du wire Base64 du bloc, avec signature embarquée, slot, block time, meta, version et index de transaction.
|
||||||
|
|
||||||
|
La qualification est fermée : une version omise/nulle ou supérieure à `1`, une transaction non Base64, `block: null`, une erreur distante de notification, un slot de contexte incohérent ou un champ transactions absent/nul termine la source par une erreur sûre. Aucun de ces cas n'est converti en bloc vide, en succès silencieux ou en progression artificielle de frontier.
|
||||||
|
|
||||||
|
Pour un bloc multi-transaction, le slot n'est projeté settled qu'après l'admission réussie de toutes ses transactions. Cette voie RAW-direct n'incrémente pas `hydration_pending`; un stop ou une erreur au milieu du bloc ne produit aucune progression artificielle. Reconnect, resubscribe et backpressure WebSocket restent possédés par Transport.
|
||||||
|
|
||||||
|
## Contrat de source Helius Transaction + HTTP
|
||||||
|
|
||||||
|
`RawTransactionIngestHeliusTransactionSource::new` reçoit :
|
||||||
|
|
||||||
|
```text
|
||||||
|
WsEndpointSettings kind helius_laserstream
|
||||||
|
HeliusTransactionSubscribeFilter
|
||||||
|
SolanaCommitment Confirmed ou Finalized
|
||||||
|
HttpTransportPool
|
||||||
|
HttpRoleName d'hydration
|
||||||
|
```
|
||||||
|
|
||||||
|
La construction est sans I/O. Elle réutilise le contrat Transport existant et impose `Full`, `Base64`, `showRewards = false` et `maxSupportedTransactionVersion = 1`. Le Worker ne lit pas Config, ne lit pas `KSP_SECRET_HELIUS_API_KEY` et ne code aucun tier provider ; l'URL résolue et le credential restent dans l'endpoint Transport fourni par le caller.
|
||||||
|
|
||||||
|
Au runtime, `HeliusLaserStreamWsSession::connect` puis `transaction_subscribe` sont utilisés. Seule une notification `Full` conforme au mode demandé est admise ; une forme `Signature`, `Unknown` ou future devient une faute source sûre. Le payload Helius `transaction` n'est jamais copié dans l'état Worker : la projection conserve uniquement signature, slot et transaction index, puis réutilise le coordinateur d'hydration commun `getTransaction observed`.
|
||||||
|
|
||||||
|
La clé logique Helius inclut réseau, identités provider/endpoint sûres, commitment et empreinte privée du filtre. Les listes de pubkeys du filtre sont normalisées avant hash afin que leur ordre ne crée pas artificiellement deux sources logiques ; le rôle HTTP d'hydration reste exclu de l'identité live.
|
||||||
|
|
||||||
|
## Contrat de source HTTP Block Polling
|
||||||
|
|
||||||
|
`RawTransactionIngestHttpBlockPollingSource::new` reçoit :
|
||||||
|
|
||||||
|
```text
|
||||||
|
HttpTransportPool
|
||||||
|
HttpRoleName de polling
|
||||||
|
SolanaCommitment Confirmed ou Finalized
|
||||||
|
```
|
||||||
|
|
||||||
|
La construction est sans I/O et vérifie que le rôle HTTP possède, sur un seul réseau, les capacités `getSlot`, `getBlocksWithLimit` et `getBlock`. La cadence est bornée entre 100 ms et 30 s, avec 1 s par défaut ; la découverte est bornée entre 1 et 1024 blocs par cycle, avec 128 par défaut. Ces réglages de cadence ne font pas partie de l'identité logique de la source.
|
||||||
|
|
||||||
|
Au démarrage, le premier `getSlot` fixe la borne inférieure du run. Le Worker ne demande aucun slot antérieur. Chaque cycle relit le tip, découvre les blocs disponibles avec `getBlocksWithLimit`, puis matérialise chaque slot listé par `getBlock observed` en `Full + Base64 + maxSupportedTransactionVersion = 1 + showRewards = false`. Seules les transactions Legacy/V0/V1 explicitement qualifiées entrent directement dans Common RAW.
|
||||||
|
|
||||||
|
Un slot listé dont `getBlock` retourne `null` reste la tête de reprise du cycle suivant ; il n'est ni considéré vide ni marqué settled. Les slots absents de la liste de découverte sont traités comme non produits/skipped pour ce run. Le slot n'est settled qu'après admission réussie de toutes ses transactions. Le polling reste run-local : aucun checkpoint durable, aucun scan avant la borne initiale et aucun Backfill implicite ne sont créés. Les retries/reroutages HTTP restent possédés par `ksp-onchain-transport-lib`.
|
||||||
|
|
||||||
## Runtime et lifecycle
|
## Runtime et lifecycle
|
||||||
|
|
||||||
@@ -71,20 +165,25 @@ Le Worker s'exécute sur le runtime Tokio courant du caller. Il ne crée pas de
|
|||||||
- utiliser la même source via `WorkerSnapshotSource` ;
|
- utiliser la même source via `WorkerSnapshotSource` ;
|
||||||
- attendre le terminal après drain et join des tâches possédées.
|
- attendre le terminal après drain et join des tâches possédées.
|
||||||
|
|
||||||
Le shutdown est borné par `shutdown_drain_timeout`. Les tâches source, hydration et persistence possédées sont drainées ou abort+join avant publication terminale. L'abandon terminal d'une hydration retire son pending run-local sans le convertir artificiellement en travail `settled`.
|
Le shutdown est borné par `shutdown_drain_timeout`. Le supervisor multi-source relaie le stop à toutes les sources et les rejoint avant de rendre son résultat au supervisor Worker ; les tâches source, hydration et persistence possédées sont ensuite drainées ou abort+join avant publication terminale. Si la deadline expire, l'abort du wrapper source détruit aussi son `JoinSet` interne et annule ses tâches imbriquées avant le terminal. Une faute déjà observée n'est pas remplacée par un stop concurrent, sauf le `drain_timeout` terminal lorsqu'une récupération bornée dépasse sa deadline. L'abandon terminal d'une hydration retire son pending run-local sans le convertir artificiellement en travail `settled`.
|
||||||
|
|
||||||
## Admission, coalescence et backpressure
|
## Admission, coalescence et backpressure
|
||||||
|
|
||||||
La queue centrale est un `tokio::sync::mpsc` privé borné par `admission_queue_capacity`. Les sources internes subissent la backpressure ; aucune queue non bornée ni silent drop n'est autorisé.
|
La queue centrale est un `tokio::sync::mpsc` privé borné par `admission_queue_capacity`. Les sources internes subissent la backpressure ; aucune queue non bornée ni silent drop n'est autorisé.
|
||||||
|
|
||||||
La source Yellowstone possède également un coordinateur d'hydration borné :
|
Le Worker possède des coordinateurs source-neutral Yellowstone, Standard Logs et Helius Transaction branchés sur un registre global d'hydration partagé. Standard Block et HTTP Block Polling n'entrent pas dans ce registre lorsqu'une transaction est direct-qualified.
|
||||||
|
|
||||||
|
Les sources reference-bearing reçoivent des quotas déterministes dont la somme reste exactement dans les bornes techniques configurées :
|
||||||
|
|
||||||
```text
|
```text
|
||||||
in-flight hydration <= persistence_concurrency
|
somme pending source signals <= admission_queue_capacity
|
||||||
pending source signals <= 65_536
|
somme hydration tasks in flight <= persistence_concurrency
|
||||||
|
source reference-bearing active => quota pending >= 1 et quota in-flight >= 1
|
||||||
```
|
```
|
||||||
|
|
||||||
Les signaux partageant le même `(network, signature, commitment)` sont coalescés avant le fan-out HTTP. Les provenances utiles restent néanmoins conservées pour les ingress produits après hydration.
|
Pour garantir simultanément ces bornes et l'absence de starvation structurelle, le démarrage échoue avant spawn si le nombre de sources reference-bearing dépasse `admission_queue_capacity` ou `persistence_concurrency`. Un sémaphore global protège en plus l'ouverture effective des hydrations HTTP.
|
||||||
|
|
||||||
|
Les signaux partageant le même `(network, signature, commitment)` sont coalescés cross-source avant le fan-out HTTP. La publication du résultat partagé notifie les followers sous le verrou de registry avant de retirer la clé : une nouvelle génération de leader ne peut donc pas s'intercaler entre retrait et notification. Après canonicalisation, une cache run-local bornée sérialise les acquisitions de même `(network, signature)` : la première passe par l'écriture atomique entity + observation, les suivantes de contenu canonique identique ajoutent uniquement leur observation déterministe. Une divergence de slot, block time, format ou hash canonique devient un content conflict terminal ; aucune majorité, préférence provider ou overwrite n'est appliqué. Le Store conserve son guard durable final.
|
||||||
|
|
||||||
Les retries/reroutages HTTP appartiennent à `ksp-onchain-transport-lib`. Le Worker ne possède pas une seconde boucle de retry autour de `getTransaction`.
|
Les retries/reroutages HTTP appartiennent à `ksp-onchain-transport-lib`. Le Worker ne possède pas une seconde boucle de retry autour de `getTransaction`.
|
||||||
|
|
||||||
@@ -114,15 +213,23 @@ Un `BlockMeta` ou `Slot` continuity-only est settled localement sans produire de
|
|||||||
|
|
||||||
Le reconnect/replay Yellowstone appartient à Transport. Le Worker n'écrit pas `from_slot` et n'interprète pas directement `SubscribeReplayInfo`.
|
Le reconnect/replay Yellowstone appartient à Transport. Le Worker n'écrit pas `from_slot` et n'interprète pas directement `SubscribeReplayInfo`.
|
||||||
|
|
||||||
Le snapshot Worker projette uniquement des informations sûres :
|
Le snapshot Worker projette uniquement des informations sûres et source-neutral :
|
||||||
|
|
||||||
```text
|
```text
|
||||||
|
source_total
|
||||||
|
source_active
|
||||||
|
source_reconnecting
|
||||||
|
source_failed
|
||||||
source_state
|
source_state
|
||||||
|
source_failure_total
|
||||||
|
backpressure_wait_total
|
||||||
source_reconnect_total
|
source_reconnect_total
|
||||||
source_replay_attempt_total
|
source_replay_attempt_total
|
||||||
source_continuity_gap_total
|
source_continuity_gap_total
|
||||||
```
|
```
|
||||||
|
|
||||||
|
Les quatre comptes de sources sont des gauges latest-value et ne contiennent aucune identité de source. `source_total` reste le nombre de sources logiques configurées pour le run. Tant que toutes les sources attendues ne sont pas `Active`, la health publique reste conservative : un reconnect transitoire projette `Degraded`, une source `Failed` projette `Unhealthy`, et le retour de toutes les sources attendues à `Active` permet de revenir à `Healthy`.
|
||||||
|
|
||||||
`RawTransactionIngestSourceState` distingue :
|
`RawTransactionIngestSourceState` distingue :
|
||||||
|
|
||||||
```text
|
```text
|
||||||
@@ -172,7 +279,7 @@ worker_raw_transaction_ingest.source_failed
|
|||||||
worker_raw_transaction_ingest.drain_timeout
|
worker_raw_transaction_ingest.drain_timeout
|
||||||
```
|
```
|
||||||
|
|
||||||
Les diagnostics et `Debug` ne recopient pas de payload RAW, signature, URL, credential, filtre provider, texte backend/provider arbitraire ou client inférieur.
|
Les diagnostics et `Debug` ne recopient pas de payload RAW, signature, URL, credential, filtre provider, texte backend/provider arbitraire ou client inférieur. Les agrégations de compteurs de continuité multi-source utilisent une arithmétique vérifiée ; un overflow devient `counter_exhausted` au lieu d'être saturé silencieusement.
|
||||||
|
|
||||||
## Dépendances
|
## Dépendances
|
||||||
|
|
||||||
@@ -195,9 +302,7 @@ La crate ne dépend pas de Config, Job, `ksp-store-api` directement, backend Sto
|
|||||||
|
|
||||||
La verticale actuelle ne possède pas :
|
La verticale actuelle ne possède pas :
|
||||||
|
|
||||||
- plusieurs sources productives simultanées dans `RawTransactionIngestRuntimeResources` ;
|
- sélection Config interne, reconfiguration dynamique ou policy de failover entre sources ;
|
||||||
- source WS/Helius-specific ou HTTP polling Worker ;
|
|
||||||
- sélection Config interne au Worker ;
|
|
||||||
- checkpoint persistent de processing frontier ;
|
- checkpoint persistent de processing frontier ;
|
||||||
- campagne de réparation historique automatique ;
|
- campagne de réparation historique automatique ;
|
||||||
- application Desk ou process autonome ;
|
- application Desk ou process autonome ;
|
||||||
|
|||||||
@@ -1,5 +1,5 @@
|
|||||||
<!-- file: crates/ksp-worker-raw-transaction-ingest-lib/USAGE.md -->
|
<!-- file: crates/ksp-worker-raw-transaction-ingest-lib/USAGE.md -->
|
||||||
<!-- version: 2 -->
|
<!-- version: 11 -->
|
||||||
|
|
||||||
# Utilisation de ksp-worker-raw-transaction-ingest-lib
|
# Utilisation de ksp-worker-raw-transaction-ingest-lib
|
||||||
|
|
||||||
@@ -101,7 +101,127 @@ let handle = match ksp_worker_raw_transaction_ingest_lib::RawTransactionIngestWo
|
|||||||
};
|
};
|
||||||
```
|
```
|
||||||
|
|
||||||
Les deux entrées exigent un runtime Tokio courant et un `Store` portant exactement le même `RawNetworkId` que les settings. Le démarrage avec ressources exige également que la source Yellowstone/HTTP cible ce même réseau.
|
Les deux entrées exigent un runtime Tokio courant et un `Store` portant exactement le même `RawNetworkId` que les settings. Le démarrage avec ressources exige également que chaque source composée cible ce même réseau. L'agrégat accepte 1 à 32 sources logiques et les lance simultanément ; les doublons d'identité et les mélanges de réseaux sont refusés avant spawn. Il n'existe pas de source primaire, standby ou fallback implicite : toute source configurée fait partie du run.
|
||||||
|
|
||||||
|
### Composer plusieurs sources simultanées
|
||||||
|
|
||||||
|
Une fois un premier `RawTransactionIngestRuntimeResources` construit, le caller ajoute les autres sources avec les méthodes `try_push_*` correspondant à leur capability. Exemple conceptuel :
|
||||||
|
|
||||||
|
```rust
|
||||||
|
let mut resources = ksp_worker_raw_transaction_ingest_lib::RawTransactionIngestRuntimeResources::new(yellowstone_source);
|
||||||
|
if let std::result::Result::Err(error) = resources.try_push_standard_logs_source(standard_logs_source) {
|
||||||
|
return std::result::Result::Err(error);
|
||||||
|
}
|
||||||
|
if let std::result::Result::Err(error) = resources.try_push_http_block_polling_source(http_polling_source) {
|
||||||
|
return std::result::Result::Err(error);
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
La validation est transactionnelle à chaque ajout : limite globale 32, réseau unique et `source_key` logique unique. Au démarrage, toutes les sources présentes sont supervisées ensemble. La défaillance d'une source est terminale pour le Worker ; les autres sources sont arrêtées et jointes, car le Worker ne suppose pas qu'elles couvrent les mêmes filtres ou le même univers de transactions.
|
||||||
|
|
||||||
|
### Source Standard Logs productive
|
||||||
|
|
||||||
|
Une source standard Solana WS se compose ainsi :
|
||||||
|
|
||||||
|
```rust
|
||||||
|
fn standard_logs_runtime_resources(
|
||||||
|
ws_endpoint: ksp_onchain_transport_lib::WsEndpointSettings,
|
||||||
|
filter: ksp_onchain_transport_lib::SolanaLogsSubscribeFilter,
|
||||||
|
commitment: ksp_onchain_transport_lib::SolanaCommitment,
|
||||||
|
http_pool: ksp_onchain_transport_lib::HttpTransportPool,
|
||||||
|
hydration_role: ksp_onchain_transport_lib::HttpRoleName,
|
||||||
|
) -> ksp_core_lib::Result<ksp_worker_raw_transaction_ingest_lib::RawTransactionIngestRuntimeResources> {
|
||||||
|
let source = match ksp_worker_raw_transaction_ingest_lib::RawTransactionIngestStandardLogsSource::new(
|
||||||
|
ws_endpoint,
|
||||||
|
filter,
|
||||||
|
commitment,
|
||||||
|
http_pool,
|
||||||
|
hydration_role,
|
||||||
|
) {
|
||||||
|
std::result::Result::Ok(value) => value,
|
||||||
|
std::result::Result::Err(error) => return std::result::Result::Err(error),
|
||||||
|
};
|
||||||
|
return std::result::Result::Ok(ksp_worker_raw_transaction_ingest_lib::RawTransactionIngestRuntimeResources::from_standard_logs_source(source));
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
`ws_endpoint` doit être un endpoint Transport valide de kind `solana_standard`. Le commitment doit être explicitement `Confirmed` ou `Finalized`. Le pool HTTP doit exposer `getTransaction` via le rôle indiqué sur le même réseau. `All`, `AllWithVotes` et `Mentions(pubkey)` sont acceptés par le contrat Transport ; la valeur du filtre reste privée dans le Worker.
|
||||||
|
|
||||||
|
### Source Standard Block productive
|
||||||
|
|
||||||
|
Une source `blockSubscribe` standard se compose sans pool HTTP :
|
||||||
|
|
||||||
|
```rust
|
||||||
|
fn standard_block_runtime_resources(
|
||||||
|
ws_endpoint: ksp_onchain_transport_lib::WsEndpointSettings,
|
||||||
|
filter: ksp_onchain_transport_lib::SolanaBlockSubscribeFilter,
|
||||||
|
commitment: ksp_onchain_transport_lib::SolanaCommitment,
|
||||||
|
) -> ksp_core_lib::Result<ksp_worker_raw_transaction_ingest_lib::RawTransactionIngestRuntimeResources> {
|
||||||
|
let source = match ksp_worker_raw_transaction_ingest_lib::RawTransactionIngestStandardBlockSource::new(ws_endpoint, filter, commitment) {
|
||||||
|
std::result::Result::Ok(value) => value,
|
||||||
|
std::result::Result::Err(error) => return std::result::Result::Err(error),
|
||||||
|
};
|
||||||
|
return std::result::Result::Ok(ksp_worker_raw_transaction_ingest_lib::RawTransactionIngestRuntimeResources::from_standard_block_source(source));
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
Le Worker demande `Base64`, `Full`, `maxSupportedTransactionVersion = 1` et `showRewards = false`. Une transaction n'est RAW-direct que si sa version est explicitement `Legacy`, `0` ou `1`. Une version omise/nulle ou supérieure, `block: null`, une erreur de bloc, un champ transactions absent/nul ou une transaction non Base64 provoque une faute sûre ; ces cas ne sont jamais assimilés à une progression vide.
|
||||||
|
|
||||||
|
### Source Helius Transaction productive
|
||||||
|
|
||||||
|
Une source Helius LaserStream `transactionSubscribe` se compose avec le même pattern caller-owned :
|
||||||
|
|
||||||
|
```rust
|
||||||
|
fn helius_transaction_runtime_resources(
|
||||||
|
ws_endpoint: ksp_onchain_transport_lib::WsEndpointSettings,
|
||||||
|
filter: ksp_onchain_transport_lib::HeliusTransactionSubscribeFilter,
|
||||||
|
commitment: ksp_onchain_transport_lib::SolanaCommitment,
|
||||||
|
http_pool: ksp_onchain_transport_lib::HttpTransportPool,
|
||||||
|
hydration_role: ksp_onchain_transport_lib::HttpRoleName,
|
||||||
|
) -> ksp_core_lib::Result<ksp_worker_raw_transaction_ingest_lib::RawTransactionIngestRuntimeResources> {
|
||||||
|
let source = match ksp_worker_raw_transaction_ingest_lib::RawTransactionIngestHeliusTransactionSource::new(
|
||||||
|
ws_endpoint,
|
||||||
|
filter,
|
||||||
|
commitment,
|
||||||
|
http_pool,
|
||||||
|
hydration_role,
|
||||||
|
) {
|
||||||
|
std::result::Result::Ok(value) => value,
|
||||||
|
std::result::Result::Err(error) => return std::result::Result::Err(error),
|
||||||
|
};
|
||||||
|
return std::result::Result::Ok(ksp_worker_raw_transaction_ingest_lib::RawTransactionIngestRuntimeResources::from_helius_transaction_source(source));
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
`ws_endpoint` doit être un endpoint Transport de kind `helius_laserstream`. Le caller supérieur résout éventuellement `KSP_SECRET_HELIUS_API_KEY` via Config avant de construire l'endpoint ; le Worker ne lit jamais l'environnement ni Config. Le commitment est limité à `Confirmed`/`Finalized` et la route HTTP doit supporter `getTransaction` sur le même réseau.
|
||||||
|
|
||||||
|
Le Worker demande la forme Helius `Full` avec `Base64`, `showRewards = false` et `maxSupportedTransactionVersion = 1`, mais ne fait pas confiance au nested payload pour construire directement le Common RAW. Il conserve seulement signature/slot/index et hydrate par `getTransaction observed`. Une notification d'une autre forme est fail-closed.
|
||||||
|
|
||||||
|
### Source HTTP Block Polling productive
|
||||||
|
|
||||||
|
Une source HTTP live peut être composée sans WebSocket ni gRPC :
|
||||||
|
|
||||||
|
```rust
|
||||||
|
fn http_block_polling_runtime_resources(
|
||||||
|
http_pool: ksp_onchain_transport_lib::HttpTransportPool,
|
||||||
|
polling_role: ksp_onchain_transport_lib::HttpRoleName,
|
||||||
|
commitment: ksp_onchain_transport_lib::SolanaCommitment,
|
||||||
|
) -> ksp_core_lib::Result<ksp_worker_raw_transaction_ingest_lib::RawTransactionIngestRuntimeResources> {
|
||||||
|
let source = match ksp_worker_raw_transaction_ingest_lib::RawTransactionIngestHttpBlockPollingSource::new(
|
||||||
|
http_pool,
|
||||||
|
polling_role,
|
||||||
|
commitment,
|
||||||
|
) {
|
||||||
|
std::result::Result::Ok(value) => value,
|
||||||
|
std::result::Result::Err(error) => return std::result::Result::Err(error),
|
||||||
|
};
|
||||||
|
return std::result::Result::Ok(ksp_worker_raw_transaction_ingest_lib::RawTransactionIngestRuntimeResources::from_http_block_polling_source(source));
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
Le rôle HTTP doit disposer, sur un même réseau, de `getSlot`, `getBlocksWithLimit` et `getBlock`. Le commitment est limité à `Confirmed`/`Finalized`. Par défaut, le Worker interroge toutes les secondes et borne la découverte à 128 blocs par cycle. `new_with_limits` permet de choisir une cadence entre 100 ms et 30 s et une limite entre 1 et 1024 blocs par cycle ; les limites de débit physiques restent celles de Transport.
|
||||||
|
|
||||||
|
Au démarrage du run, la première valeur `getSlot(commitment)` devient la borne inférieure stricte du poller. Il ne demande jamais de slot antérieur. `getBlocksWithLimit` détermine les slots réellement matérialisables, puis `getBlock observed` produit directement le Common RAW en Full/Base64 pour Legacy/V0/V1. Un slot listé dont `getBlock` retourne `null` reste la tête de reprise du prochain cycle et n'est jamais transformé en progression silencieuse.
|
||||||
|
|
||||||
## Préparer la source Yellowstone
|
## Préparer la source Yellowstone
|
||||||
|
|
||||||
@@ -118,18 +238,35 @@ Le caller ne passe pas de signature, `program_id`, plage de slots ou limite hist
|
|||||||
|
|
||||||
## Comprendre la pipeline live
|
## Comprendre la pipeline live
|
||||||
|
|
||||||
Les familles Yellowstone sont traitées ainsi :
|
Les familles productives sont traitées ainsi :
|
||||||
|
|
||||||
```text
|
```text
|
||||||
Transaction -> signal -> HTTP getTransaction -> Common RAW -> admission
|
Yellowstone Transaction -> signal -> HTTP getTransaction -> Common RAW -> admission
|
||||||
TransactionStatus -> signal -> HTTP getTransaction -> Common RAW -> admission
|
Yellowstone TransactionStatus -> signal -> HTTP getTransaction -> Common RAW -> admission
|
||||||
Block -> un signal par transaction -> HTTP getTransaction -> Common RAW -> admission
|
Yellowstone Block -> un signal par transaction -> HTTP getTransaction -> Common RAW -> admission
|
||||||
BlockMeta -> continuity-only
|
Standard WS logsSubscribe -> context.slot + signature -> HTTP getTransaction -> Common RAW -> admission
|
||||||
Slot -> continuity-only
|
Standard WS blockSubscribe -> Full/Base64 Legacy|V0|V1 -> Common RAW direct par transaction -> admission
|
||||||
Account/Ping/Pong/Entry -> sans RAW Transaction dans cette verticale
|
Helius transactionSubscribe -> Full envelope -> signature/slot/index -> HTTP getTransaction -> Common RAW -> admission
|
||||||
|
HTTP live block polling -> getSlot -> getBlocksWithLimit -> getBlock observed -> Common RAW direct Legacy|V0|V1 -> admission
|
||||||
|
Yellowstone BlockMeta -> continuity-only
|
||||||
|
Yellowstone Slot -> continuity-only
|
||||||
|
Yellowstone Account/Ping/Pong/Entry -> sans RAW Transaction dans cette verticale
|
||||||
```
|
```
|
||||||
|
|
||||||
Les signaux de même `(network, signature, commitment)` sont coalescés avant l'hydration HTTP. Le Worker ne possède pas une boucle de retry HTTP : reroutage/retry/backoff restent dans `ksp-onchain-transport-lib`.
|
Les signaux de même `(network, signature, commitment)` sont coalescés globalement avant l'hydration HTTP. Si plusieurs sources produisent ensuite la même transaction canonique, le Worker conserve une seule entité RAW et enregistre séparément les observations déterministes propres à chaque source. Le Worker ne possède pas une boucle de retry HTTP : reroutage/retry/backoff restent dans `ksp-onchain-transport-lib`.
|
||||||
|
|
||||||
|
Les sources qui nécessitent `getTransaction` partagent des quotas bornés et déterministes. Pour une composition valide :
|
||||||
|
|
||||||
|
```text
|
||||||
|
nombre de sources avec hydration <= admission_queue_capacity
|
||||||
|
nombre de sources avec hydration <= persistence_concurrency
|
||||||
|
somme de leurs pending <= admission_queue_capacity
|
||||||
|
somme de leurs tâches d'hydration actives <= persistence_concurrency
|
||||||
|
```
|
||||||
|
|
||||||
|
Ces contraintes garantissent au moins une part à chaque source reference-bearing sans introduire de scheduler pondéré. Si les settings ne permettent pas cette répartition, le démarrage échoue avant spawn avec `runtime_invalid`; le caller doit augmenter la capacité concernée ou réduire le nombre de sources nécessitant une hydration.
|
||||||
|
|
||||||
|
Pour une même identité `(network, signature)`, une divergence canonique de slot, block time, format ou hash est un `content_conflict`. Le Worker ne choisit ni majorité ni provider préféré et n'écrase pas un contenu divergent ; le Store reste l'autorité durable finale du conflit.
|
||||||
|
|
||||||
## Observer le snapshot concret
|
## Observer le snapshot concret
|
||||||
|
|
||||||
@@ -144,6 +281,10 @@ let in_flight = current.in_flight_persistence();
|
|||||||
let hydration_pending = current.hydration_pending();
|
let hydration_pending = current.hydration_pending();
|
||||||
let frontier = current.processing_frontier_slot();
|
let frontier = current.processing_frontier_slot();
|
||||||
let oldest_pending = current.oldest_pending_slot();
|
let oldest_pending = current.oldest_pending_slot();
|
||||||
|
let source_total = current.source_total();
|
||||||
|
let source_active = current.source_active();
|
||||||
|
let source_reconnecting = current.source_reconnecting();
|
||||||
|
let source_failed = current.source_failed();
|
||||||
let source_state = current.source_state();
|
let source_state = current.source_state();
|
||||||
```
|
```
|
||||||
|
|
||||||
@@ -192,7 +333,7 @@ let replay_attempts = snapshot.source_replay_attempt_total();
|
|||||||
let proven_gaps = snapshot.source_continuity_gap_total();
|
let proven_gaps = snapshot.source_continuity_gap_total();
|
||||||
```
|
```
|
||||||
|
|
||||||
`admission_queue_depth()`, `in_flight_persistence()` et `hydration_pending()` sont des gauges latest-value. Les compteurs cumulés ne wrapent jamais silencieusement ; l'épuisement est terminal avec `worker_raw_transaction_ingest.counter_exhausted`.
|
`admission_queue_depth()`, `in_flight_persistence()`, `hydration_pending()`, `source_total()`, `source_active()`, `source_reconnecting()` et `source_failed()` sont des gauges latest-value. Les compteurs cumulés et les agrégats multi-source ne wrapent ni ne saturent silencieusement ; l'épuisement est terminal avec `worker_raw_transaction_ingest.counter_exhausted`.
|
||||||
|
|
||||||
## Interpréter la processing frontier
|
## Interpréter la processing frontier
|
||||||
|
|
||||||
@@ -211,7 +352,9 @@ Un `Missing` HTTP règle le signal du point de vue source-processing sans créer
|
|||||||
|
|
||||||
## Interpréter reconnect et replay
|
## Interpréter reconnect et replay
|
||||||
|
|
||||||
`source_state()` peut retourner `Active`, `Reconnecting`, `Closing`, `Closed` ou `Failed` après démarrage de la source productive.
|
`source_state()` peut retourner `Active`, `Reconnecting`, `Closing`, `Closed` ou `Failed` comme état agrégé source-neutral. Les gauges `source_total()`, `source_active()`, `source_reconnecting()` et `source_failed()` permettent d'interpréter une composition multi-source sans exposer provider, endpoint, filtre ou `source_key`.
|
||||||
|
|
||||||
|
La health commune est conservative : pendant `Running`, au moins une source `Failed` donne `Unhealthy`; au moins une source `Reconnecting`, ou une composition dont toutes les sources attendues ne sont pas encore `Active`, donne `Degraded`; toutes les sources attendues `Active` permettent `Healthy`. Une transition Worker `Faulted` reste `Unhealthy`.
|
||||||
|
|
||||||
Les compteurs ont des sémantiques distinctes :
|
Les compteurs ont des sémantiques distinctes :
|
||||||
|
|
||||||
@@ -243,7 +386,7 @@ if accepted {
|
|||||||
}
|
}
|
||||||
```
|
```
|
||||||
|
|
||||||
`request_stop()` est idempotent. Le terminal n'est publié qu'après le drain borné et la récupération des tâches possédées.
|
`request_stop()` est idempotent. Le terminal n'est publié qu'après le drain borné et la récupération des tâches possédées. Si la deadline de drain expire, toutes les tâches source/persistence encore possédées sont abortées puis jointes avant publication terminale ; une persistence libérée après ce terminal ne peut donc pas produire une complétion tardive. Une faute source déjà observée reste prioritaire face à un stop concurrent, sauf si le drain lui-même expire et devient le terminal `drain_timeout`.
|
||||||
|
|
||||||
## Interpréter les faults
|
## Interpréter les faults
|
||||||
|
|
||||||
@@ -266,8 +409,8 @@ Le pattern attendu est :
|
|||||||
```text
|
```text
|
||||||
Config / application / service owner
|
Config / application / service owner
|
||||||
-> résout endpoints, credentials et rôles
|
-> résout endpoints, credentials et rôles
|
||||||
-> construit YellowstoneGrpcChannel + YellowstoneSubscribeRequest
|
-> construit une source Transport Yellowstone, Standard Logs, Standard Block, Helius Transaction ou HTTP Block Polling
|
||||||
-> construit HttpTransportPool + hydration role
|
-> construit HttpTransportPool + rôle HTTP adapté à la source
|
||||||
-> construit le Store
|
-> construit le Store
|
||||||
-> construit RawTransactionIngestRuntimeResources
|
-> construit RawTransactionIngestRuntimeResources
|
||||||
-> construit RawTransactionIngestSettings
|
-> construit RawTransactionIngestSettings
|
||||||
|
|||||||
@@ -1,22 +1,24 @@
|
|||||||
// file: crates/ksp-worker-raw-transaction-ingest-lib/src/lib.rs
|
// file: crates/ksp-worker-raw-transaction-ingest-lib/src/lib.rs
|
||||||
// version: 17
|
// version: 26
|
||||||
|
|
||||||
#![warn(missing_docs)]
|
#![warn(missing_docs)]
|
||||||
#![deny(unreachable_pub)]
|
#![deny(unreachable_pub)]
|
||||||
#![forbid(unsafe_code)]
|
#![forbid(unsafe_code)]
|
||||||
|
|
||||||
//! Source-neutral runtime foundation for continuous KSP RAW transaction ingestion.
|
//! Source-neutral runtime foundation for continuous KSP RAW transaction ingestion.
|
||||||
|
//! Owned source, hydration and persistence tasks are bounded and joined before terminal publication.
|
||||||
//!
|
//!
|
||||||
//! This tranche owns the concrete Worker family identity, validated technical settings
|
//! This tranche owns the concrete Worker family identity, validated technical settings
|
||||||
//! and the caller-runtime-owned lifecycle with private child-task supervision. This tranche also
|
//! and the caller-runtime-owned lifecycle with private child-task supervision. This tranche also
|
||||||
//! owns bounded source-neutral admission, common RAW canonicalization/assembly and backend-neutral
|
//! owns bounded source-neutral admission, common RAW canonicalization/assembly and backend-neutral
|
||||||
//! Store persistence in normal mode plus concrete latest-value snapshots projected onto Worker API;
|
//! Store persistence in normal mode plus concrete latest-value snapshots projected onto Worker API. The bounded 1..32 caller-composed aggregate starts
|
||||||
//! the validated Yellowstone/HTTP runtime-resource contract now drives one productive supervised source task.
|
//! all validated Yellowstone, Standard Logs, Standard Block, Helius Transaction and HTTP live block polling sources under one private supervisor. Reference-bearing
|
||||||
//! Transaction/TransactionStatus/Block updates feed bounded HTTP `getTransaction` hydration and the existing central
|
//! sources share bounded cross-source hydration and fairness budgets; direct-qualified Standard Block and HTTP polling transactions enter the existing central
|
||||||
//! admission path; BlockMeta/Slot remain continuity-only signals. Hydration is coalesced by network/signature/commitment
|
//! admission path directly. Public snapshots expose only source-neutral aggregate counts/state and conservative Worker health. Yellowstone
|
||||||
//! under bounded in-flight and pending budgets. A bounded run-local processing frontier projects hydration pending,
|
//! Transaction/TransactionStatus/Block and standard logs notifications become signature/slot references; BlockMeta/Slot remain continuity-only signals.
|
||||||
//! oldest pending slot and highest unblocked actually observed slot. The productive source now also projects safe Transport reconnect/replay state and faults
|
//! Hydration is coalesced by network/signature/commitment under bounded in-flight and pending budgets. A bounded run-local processing frontier projects
|
||||||
//! conservatively when Transport proves a replay-retention continuity gap; history remediation remains outside this crate.
|
//! hydration pending, oldest pending slot and highest unblocked actually observed slot. The productive source also projects safe Transport reconnect/replay
|
||||||
|
//! state and faults conservatively when Transport proves a replay-retention continuity gap; history remediation remains outside this crate.
|
||||||
|
|
||||||
mod admission;
|
mod admission;
|
||||||
mod error;
|
mod error;
|
||||||
@@ -49,8 +51,30 @@ pub use self::runtime::RawTransactionIngestHandle;
|
|||||||
pub use self::runtime::RawTransactionIngestTerminalFuture;
|
pub use self::runtime::RawTransactionIngestTerminalFuture;
|
||||||
/// Entry point owning synchronous validation and task launch for one RAW transaction ingest Worker run.
|
/// Entry point owning synchronous validation and task launch for one RAW transaction ingest Worker run.
|
||||||
pub use self::runtime::RawTransactionIngestWorker;
|
pub use self::runtime::RawTransactionIngestWorker;
|
||||||
/// Caller-composed runtime resources for the first Yellowstone + HTTP source family.
|
/// Default interval between HTTP live block polling cycles.
|
||||||
|
pub use self::runtime_resources::DEFAULT_RAW_TRANSACTION_INGEST_HTTP_POLL_INTERVAL;
|
||||||
|
/// Default maximum number of confirmed blocks discovered during one HTTP live block polling cycle.
|
||||||
|
pub use self::runtime_resources::DEFAULT_RAW_TRANSACTION_INGEST_HTTP_POLL_MAX_BLOCKS_PER_CYCLE;
|
||||||
|
/// Maximum interval accepted between HTTP live block polling cycles.
|
||||||
|
pub use self::runtime_resources::MAX_RAW_TRANSACTION_INGEST_HTTP_POLL_INTERVAL;
|
||||||
|
/// Maximum number of confirmed blocks accepted during one HTTP live block polling cycle.
|
||||||
|
pub use self::runtime_resources::MAX_RAW_TRANSACTION_INGEST_HTTP_POLL_MAX_BLOCKS_PER_CYCLE;
|
||||||
|
/// Maximum number of logical live sources accepted by one runtime-resource aggregate.
|
||||||
|
pub use self::runtime_resources::MAX_RAW_TRANSACTION_INGEST_LIVE_SOURCES;
|
||||||
|
/// Minimum interval accepted between HTTP live block polling cycles.
|
||||||
|
pub use self::runtime_resources::MIN_RAW_TRANSACTION_INGEST_HTTP_POLL_INTERVAL;
|
||||||
|
/// Minimum number of confirmed blocks accepted during one HTTP live block polling cycle.
|
||||||
|
pub use self::runtime_resources::MIN_RAW_TRANSACTION_INGEST_HTTP_POLL_MAX_BLOCKS_PER_CYCLE;
|
||||||
|
/// Validated Helius `transactionSubscribe` + HTTP hydration source contract owned by the continuous RAW transaction ingest Worker.
|
||||||
|
pub use self::runtime_resources::RawTransactionIngestHeliusTransactionSource;
|
||||||
|
/// Validated standard Solana HTTP live block polling source contract owned by the continuous RAW transaction ingest Worker.
|
||||||
|
pub use self::runtime_resources::RawTransactionIngestHttpBlockPollingSource;
|
||||||
|
/// Caller-composed bounded runtime resources for supported continuous RAW transaction live-source families.
|
||||||
pub use self::runtime_resources::RawTransactionIngestRuntimeResources;
|
pub use self::runtime_resources::RawTransactionIngestRuntimeResources;
|
||||||
|
/// Validated standard Solana `blockSubscribe` direct RAW source contract owned by the continuous RAW transaction ingest Worker.
|
||||||
|
pub use self::runtime_resources::RawTransactionIngestStandardBlockSource;
|
||||||
|
/// Validated standard Solana `logsSubscribe` + HTTP hydration source contract owned by the continuous RAW transaction ingest Worker.
|
||||||
|
pub use self::runtime_resources::RawTransactionIngestStandardLogsSource;
|
||||||
/// Validated Yellowstone + HTTP source contract owned by the continuous RAW transaction ingest Worker.
|
/// Validated Yellowstone + HTTP source contract owned by the continuous RAW transaction ingest Worker.
|
||||||
pub use self::runtime_resources::RawTransactionIngestYellowstoneSource;
|
pub use self::runtime_resources::RawTransactionIngestYellowstoneSource;
|
||||||
/// Default bounded admission queue capacity for one RAW transaction ingest Worker.
|
/// Default bounded admission queue capacity for one RAW transaction ingest Worker.
|
||||||
@@ -100,12 +124,16 @@ pub(crate) use self::error::store_error;
|
|||||||
pub(crate) use self::persistence::RawTransactionIngestEntityPersistence;
|
pub(crate) use self::persistence::RawTransactionIngestEntityPersistence;
|
||||||
/// Observation disposition produced by one successful Worker Store persistence attempt.
|
/// Observation disposition produced by one successful Worker Store persistence attempt.
|
||||||
pub(crate) use self::persistence::RawTransactionIngestObservationPersistence;
|
pub(crate) use self::persistence::RawTransactionIngestObservationPersistence;
|
||||||
|
/// Private bounded run-local cache serializing repeated canonical identities before Store writes.
|
||||||
|
pub(crate) use self::persistence::RawTransactionIngestPersistenceConvergence;
|
||||||
/// Classified successful outcome of one atomic Worker Store persistence attempt.
|
/// Classified successful outcome of one atomic Worker Store persistence attempt.
|
||||||
pub(crate) use self::persistence::RawTransactionIngestPersistenceOutcome;
|
pub(crate) use self::persistence::RawTransactionIngestPersistenceOutcome;
|
||||||
/// Private backend-neutral Store persistence port used by the Worker and deterministic tests.
|
/// Private backend-neutral Store persistence port used by the Worker and deterministic tests.
|
||||||
pub(crate) use self::persistence::RawTransactionIngestPersistencePort;
|
pub(crate) use self::persistence::RawTransactionIngestPersistencePort;
|
||||||
/// Persists one already-canonical Worker acquisition through the private Store port in `Normal` mode.
|
/// Persists one already-canonical Worker acquisition through the private Store port in `Normal` mode.
|
||||||
pub(crate) use self::persistence::persist_raw_transaction_ingest_acquisition;
|
pub(crate) use self::persistence::persist_raw_transaction_ingest_acquisition;
|
||||||
|
/// Persists one canonical acquisition through the bounded cross-source convergence cache.
|
||||||
|
pub(crate) use self::persistence::persist_raw_transaction_ingest_converged_acquisition;
|
||||||
/// Private latest-value processing-frontier projection emitted by the productive source task.
|
/// Private latest-value processing-frontier projection emitted by the productive source task.
|
||||||
pub(crate) use self::snapshot::RawTransactionIngestProcessingFrontierProjection;
|
pub(crate) use self::snapshot::RawTransactionIngestProcessingFrontierProjection;
|
||||||
/// Private latest-value publisher and checked counter owner shared by the Worker supervisor.
|
/// Private latest-value publisher and checked counter owner shared by the Worker supervisor.
|
||||||
|
|||||||
@@ -1,5 +1,5 @@
|
|||||||
// file: crates/ksp-worker-raw-transaction-ingest-lib/src/persistence.rs
|
// file: crates/ksp-worker-raw-transaction-ingest-lib/src/persistence.rs
|
||||||
// version: 1
|
// version: 4
|
||||||
|
|
||||||
/// Canonical entity disposition produced by one Worker Store persistence attempt.
|
/// Canonical entity disposition produced by one Worker Store persistence attempt.
|
||||||
#[derive(Clone, Copy, Debug, Eq, PartialEq)]
|
#[derive(Clone, Copy, Debug, Eq, PartialEq)]
|
||||||
@@ -56,6 +56,12 @@ pub(crate) trait RawTransactionIngestPersistencePort: std::marker::Send + std::m
|
|||||||
observation: ksp_store_lib::RawTransactionObservation,
|
observation: ksp_store_lib::RawTransactionObservation,
|
||||||
mode: ksp_store_lib::RawTransactionAcquisitionMode,
|
mode: ksp_store_lib::RawTransactionAcquisitionMode,
|
||||||
) -> ksp_store_lib::StoreApiFuture<'a, ksp_store_lib::Result<ksp_store_lib::RawAcquisitionWriteOutcome>>;
|
) -> ksp_store_lib::StoreApiFuture<'a, ksp_store_lib::Result<ksp_store_lib::RawAcquisitionWriteOutcome>>;
|
||||||
|
|
||||||
|
/// Records one additional observation for an already durable canonical RAW transaction.
|
||||||
|
fn record_observation<'a>(
|
||||||
|
&'a self,
|
||||||
|
observation: ksp_store_lib::RawTransactionObservation,
|
||||||
|
) -> ksp_store_lib::StoreApiFuture<'a, ksp_store_lib::Result<ksp_store_lib::RawObservationWriteOutcome>>;
|
||||||
}
|
}
|
||||||
|
|
||||||
impl crate::RawTransactionIngestPersistencePort for ksp_store_lib::Store {
|
impl crate::RawTransactionIngestPersistencePort for ksp_store_lib::Store {
|
||||||
@@ -71,6 +77,77 @@ impl crate::RawTransactionIngestPersistencePort for ksp_store_lib::Store {
|
|||||||
) -> ksp_store_lib::StoreApiFuture<'a, ksp_store_lib::Result<ksp_store_lib::RawAcquisitionWriteOutcome>> {
|
) -> ksp_store_lib::StoreApiFuture<'a, ksp_store_lib::Result<ksp_store_lib::RawAcquisitionWriteOutcome>> {
|
||||||
return ksp_store_lib::RawTransactionWrite::persist_raw_transaction_acquisition(self, transaction, observation, mode);
|
return ksp_store_lib::RawTransactionWrite::persist_raw_transaction_acquisition(self, transaction, observation, mode);
|
||||||
}
|
}
|
||||||
|
|
||||||
|
fn record_observation<'a>(
|
||||||
|
&'a self,
|
||||||
|
observation: ksp_store_lib::RawTransactionObservation,
|
||||||
|
) -> ksp_store_lib::StoreApiFuture<'a, ksp_store_lib::Result<ksp_store_lib::RawObservationWriteOutcome>> {
|
||||||
|
return ksp_store_lib::RawTransactionObservationWrite::record_raw_transaction_observation(self, observation);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
#[derive(Clone, Eq, Ord, PartialEq, PartialOrd)]
|
||||||
|
struct RawTransactionIngestPersistenceKey {
|
||||||
|
network: ksp_store_lib::RawNetworkId,
|
||||||
|
signature: ksp_store_lib::RawTransactionSignature,
|
||||||
|
}
|
||||||
|
|
||||||
|
#[derive(Clone, Eq, PartialEq)]
|
||||||
|
struct RawTransactionIngestCanonicalState {
|
||||||
|
block_time: std::option::Option<ksp_store_lib::RawTimestamp>,
|
||||||
|
content_hash: ksp_store_lib::RawContentHash,
|
||||||
|
format_id: ksp_store_lib::RawFormatId,
|
||||||
|
format_version: u32,
|
||||||
|
slot: u64,
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Private bounded run-local cache serializing repeated canonical identities before Store writes.
|
||||||
|
pub(crate) struct RawTransactionIngestPersistenceConvergence {
|
||||||
|
max_entries: usize,
|
||||||
|
entries: std::sync::Mutex<
|
||||||
|
std::collections::BTreeMap<
|
||||||
|
RawTransactionIngestPersistenceKey,
|
||||||
|
std::sync::Arc<tokio::sync::Mutex<std::option::Option<RawTransactionIngestCanonicalState>>>,
|
||||||
|
>,
|
||||||
|
>,
|
||||||
|
}
|
||||||
|
|
||||||
|
impl crate::RawTransactionIngestPersistenceConvergence {
|
||||||
|
/// Creates one bounded run-local convergence cache using the caller-provided effective runtime bound.
|
||||||
|
#[must_use]
|
||||||
|
pub(crate) fn new(max_entries: usize) -> Self {
|
||||||
|
return Self { max_entries, entries: std::sync::Mutex::new(std::collections::BTreeMap::new()) };
|
||||||
|
}
|
||||||
|
|
||||||
|
fn entry(
|
||||||
|
&self,
|
||||||
|
key: RawTransactionIngestPersistenceKey,
|
||||||
|
) -> std::option::Option<std::sync::Arc<tokio::sync::Mutex<std::option::Option<RawTransactionIngestCanonicalState>>>> {
|
||||||
|
let mut entries = match self.entries.lock() {
|
||||||
|
std::result::Result::Ok(value) => value,
|
||||||
|
std::result::Result::Err(poisoned) => poisoned.into_inner(),
|
||||||
|
};
|
||||||
|
if let std::option::Option::Some(entry) = entries.get(&key) {
|
||||||
|
return std::option::Option::Some(std::sync::Arc::clone(entry));
|
||||||
|
}
|
||||||
|
if entries.len() >= self.max_entries {
|
||||||
|
let removable = entries.iter().find_map(|(candidate, entry)| {
|
||||||
|
if std::sync::Arc::strong_count(entry) == 1 {
|
||||||
|
return std::option::Option::Some(candidate.clone());
|
||||||
|
}
|
||||||
|
return std::option::Option::None;
|
||||||
|
});
|
||||||
|
if let std::option::Option::Some(removable) = removable {
|
||||||
|
entries.remove(&removable);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
if entries.len() >= self.max_entries {
|
||||||
|
return std::option::Option::None;
|
||||||
|
}
|
||||||
|
let entry = std::sync::Arc::new(tokio::sync::Mutex::new(std::option::Option::None));
|
||||||
|
entries.insert(key, std::sync::Arc::clone(&entry));
|
||||||
|
return std::option::Option::Some(entry);
|
||||||
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
/// Persists one already-canonical Worker acquisition through the private Store port in `Normal` mode.
|
/// Persists one already-canonical Worker acquisition through the private Store port in `Normal` mode.
|
||||||
@@ -96,6 +173,62 @@ where
|
|||||||
};
|
};
|
||||||
}
|
}
|
||||||
|
|
||||||
|
/// Persists one canonical acquisition through the bounded cross-source convergence cache.
|
||||||
|
pub(crate) async fn persist_raw_transaction_ingest_converged_acquisition<P>(
|
||||||
|
port: &P,
|
||||||
|
acquisition: ksp_raw_transaction_lib::RawTransactionAcquisition,
|
||||||
|
convergence: &crate::RawTransactionIngestPersistenceConvergence,
|
||||||
|
) -> ksp_core_lib::Result<crate::RawTransactionIngestPersistenceOutcome>
|
||||||
|
where
|
||||||
|
P: crate::RawTransactionIngestPersistencePort + ?Sized,
|
||||||
|
{
|
||||||
|
let reference = acquisition.transaction().reference().clone();
|
||||||
|
if !port.network_matches(reference.network()) {
|
||||||
|
return std::result::Result::Err(crate::runtime_error("persistence.store_network_mismatch"));
|
||||||
|
}
|
||||||
|
if acquisition.observation().transaction() != &reference {
|
||||||
|
return std::result::Result::Err(crate::runtime_error("persistence.acquisition_reference_mismatch"));
|
||||||
|
}
|
||||||
|
let canonical_state = canonical_state(acquisition.transaction());
|
||||||
|
let key = RawTransactionIngestPersistenceKey { network: reference.network().clone(), signature: reference.signature() };
|
||||||
|
let entry = convergence.entry(key);
|
||||||
|
let entry = match entry {
|
||||||
|
std::option::Option::Some(value) => value,
|
||||||
|
std::option::Option::None => return crate::persist_raw_transaction_ingest_acquisition(port, acquisition).await,
|
||||||
|
};
|
||||||
|
let mut known_state = entry.lock().await;
|
||||||
|
if let std::option::Option::Some(known_state_value) = known_state.as_ref() {
|
||||||
|
if known_state_value != &canonical_state {
|
||||||
|
return std::result::Result::Err(crate::content_conflict_error());
|
||||||
|
}
|
||||||
|
let (_transaction, observation) = acquisition.into_parts();
|
||||||
|
let result = port.record_observation(observation).await;
|
||||||
|
return match result {
|
||||||
|
std::result::Result::Ok(outcome) => map_additional_observation_outcome(outcome),
|
||||||
|
std::result::Result::Err(error) => map_store_error(error),
|
||||||
|
};
|
||||||
|
}
|
||||||
|
let outcome = crate::persist_raw_transaction_ingest_acquisition(port, acquisition).await;
|
||||||
|
let outcome = match outcome {
|
||||||
|
std::result::Result::Ok(value) => value,
|
||||||
|
std::result::Result::Err(error) => return std::result::Result::Err(error),
|
||||||
|
};
|
||||||
|
if outcome.entity() != crate::RawTransactionIngestEntityPersistence::SkippedPurged {
|
||||||
|
*known_state = std::option::Option::Some(canonical_state);
|
||||||
|
}
|
||||||
|
return std::result::Result::Ok(outcome);
|
||||||
|
}
|
||||||
|
|
||||||
|
fn canonical_state(transaction: &ksp_store_lib::RawTransaction) -> RawTransactionIngestCanonicalState {
|
||||||
|
return RawTransactionIngestCanonicalState {
|
||||||
|
block_time: transaction.block_time(),
|
||||||
|
content_hash: transaction.payload().content_hash(),
|
||||||
|
format_id: transaction.payload().format_id().clone(),
|
||||||
|
format_version: transaction.payload().format_version(),
|
||||||
|
slot: transaction.slot(),
|
||||||
|
};
|
||||||
|
}
|
||||||
|
|
||||||
fn map_store_error(error: ksp_core_lib::Error) -> ksp_core_lib::Result<crate::RawTransactionIngestPersistenceOutcome> {
|
fn map_store_error(error: ksp_core_lib::Error) -> ksp_core_lib::Result<crate::RawTransactionIngestPersistenceOutcome> {
|
||||||
if error.code() == ksp_store_lib::ERROR_CODE_RAW_CONFLICT {
|
if error.code() == ksp_store_lib::ERROR_CODE_RAW_CONFLICT {
|
||||||
return std::result::Result::Err(crate::content_conflict_error());
|
return std::result::Result::Err(crate::content_conflict_error());
|
||||||
@@ -133,6 +266,25 @@ fn map_store_outcome(outcome: ksp_store_lib::RawAcquisitionWriteOutcome) -> ksp_
|
|||||||
return std::result::Result::Err(crate::runtime_error("persistence.store_outcome_invalid"));
|
return std::result::Result::Err(crate::runtime_error("persistence.store_outcome_invalid"));
|
||||||
}
|
}
|
||||||
|
|
||||||
|
fn map_additional_observation_outcome(
|
||||||
|
outcome: ksp_store_lib::RawObservationWriteOutcome,
|
||||||
|
) -> ksp_core_lib::Result<crate::RawTransactionIngestPersistenceOutcome> {
|
||||||
|
return match outcome {
|
||||||
|
ksp_store_lib::RawObservationWriteOutcome::Inserted => std::result::Result::Ok(crate::RawTransactionIngestPersistenceOutcome {
|
||||||
|
entity: crate::RawTransactionIngestEntityPersistence::AlreadyPresent,
|
||||||
|
observation: crate::RawTransactionIngestObservationPersistence::Inserted,
|
||||||
|
}),
|
||||||
|
ksp_store_lib::RawObservationWriteOutcome::AlreadyPresent => std::result::Result::Ok(crate::RawTransactionIngestPersistenceOutcome {
|
||||||
|
entity: crate::RawTransactionIngestEntityPersistence::AlreadyPresent,
|
||||||
|
observation: crate::RawTransactionIngestObservationPersistence::AlreadyPresent,
|
||||||
|
}),
|
||||||
|
ksp_store_lib::RawObservationWriteOutcome::NotRecorded => {
|
||||||
|
std::result::Result::Err(crate::runtime_error("persistence.additional_observation_not_recorded"))
|
||||||
|
},
|
||||||
|
_ => std::result::Result::Err(crate::runtime_error("persistence.additional_observation_outcome_invalid")),
|
||||||
|
};
|
||||||
|
}
|
||||||
|
|
||||||
#[cfg(test)]
|
#[cfg(test)]
|
||||||
#[path = "../unit_tests/persistence.rs"]
|
#[path = "../unit_tests/persistence.rs"]
|
||||||
mod tests;
|
mod tests;
|
||||||
|
|||||||
@@ -1,5 +1,5 @@
|
|||||||
// file: crates/ksp-worker-raw-transaction-ingest-lib/src/runtime.rs
|
// file: crates/ksp-worker-raw-transaction-ingest-lib/src/runtime.rs
|
||||||
// version: 11
|
// version: 17
|
||||||
|
|
||||||
type PersistencePort = std::sync::Arc<dyn crate::RawTransactionIngestPersistencePort + 'static>;
|
type PersistencePort = std::sync::Arc<dyn crate::RawTransactionIngestPersistencePort + 'static>;
|
||||||
type PersistenceTasks = tokio::task::JoinSet<ksp_core_lib::Result<crate::RawTransactionIngestPersistenceOutcome>>;
|
type PersistenceTasks = tokio::task::JoinSet<ksp_core_lib::Result<crate::RawTransactionIngestPersistenceOutcome>>;
|
||||||
@@ -97,7 +97,10 @@ impl crate::RawTransactionIngestWorker {
|
|||||||
return start_foundation(settings, runtime, std::option::Option::Some(store));
|
return start_foundation(settings, runtime, std::option::Option::Some(store));
|
||||||
}
|
}
|
||||||
|
|
||||||
/// Starts one Worker with caller-composed runtime resources and one supervised productive Yellowstone source task.
|
/// Starts one Worker with caller-composed runtime resources.
|
||||||
|
///
|
||||||
|
/// Every validated source in the bounded runtime-resource aggregate is started concurrently under one private source supervisor. Any configured source
|
||||||
|
/// failure remains terminal for the Worker because this release does not infer equivalent coverage or failover between source families.
|
||||||
pub fn start_with_runtime_resources(
|
pub fn start_with_runtime_resources(
|
||||||
settings: crate::RawTransactionIngestSettings,
|
settings: crate::RawTransactionIngestSettings,
|
||||||
store: std::sync::Arc<ksp_store_lib::Store>,
|
store: std::sync::Arc<ksp_store_lib::Store>,
|
||||||
@@ -114,7 +117,7 @@ impl crate::RawTransactionIngestWorker {
|
|||||||
if let std::result::Result::Err(error) = runtime_resources.validate_network(settings.network()) {
|
if let std::result::Result::Err(error) = runtime_resources.validate_network(settings.network()) {
|
||||||
return std::result::Result::Err(error);
|
return std::result::Result::Err(error);
|
||||||
}
|
}
|
||||||
let source = runtime_resources.into_yellowstone_source();
|
let source_total = runtime_resources.source_count();
|
||||||
let source_settings = settings.clone();
|
let source_settings = settings.clone();
|
||||||
let (processing_frontier_sender, processing_frontier_receiver) =
|
let (processing_frontier_sender, processing_frontier_receiver) =
|
||||||
tokio::sync::watch::channel(crate::RawTransactionIngestProcessingFrontierProjection::empty());
|
tokio::sync::watch::channel(crate::RawTransactionIngestProcessingFrontierProjection::empty());
|
||||||
@@ -124,9 +127,10 @@ impl crate::RawTransactionIngestWorker {
|
|||||||
runtime,
|
runtime,
|
||||||
std::option::Option::Some(port),
|
std::option::Option::Some(port),
|
||||||
std::option::Option::Some(processing_frontier_receiver),
|
std::option::Option::Some(processing_frontier_receiver),
|
||||||
|
source_total,
|
||||||
move |children, stop_receiver, admission_sender| {
|
move |children, stop_receiver, admission_sender| {
|
||||||
let _abort_handle = children.spawn(async move {
|
let _abort_handle = children.spawn(async move {
|
||||||
return source.run(source_settings, stop_receiver, admission_sender, processing_frontier_sender).await;
|
return runtime_resources.run_live_sources(source_settings, stop_receiver, admission_sender, processing_frontier_sender).await;
|
||||||
});
|
});
|
||||||
},
|
},
|
||||||
);
|
);
|
||||||
@@ -187,6 +191,7 @@ async fn drain_admission_and_persistence(
|
|||||||
lifecycle: &ksp_worker_api::WorkerLifecycle,
|
lifecycle: &ksp_worker_api::WorkerLifecycle,
|
||||||
admission: &mut crate::RawTransactionAdmission,
|
admission: &mut crate::RawTransactionAdmission,
|
||||||
persistence: &mut PersistenceTasks,
|
persistence: &mut PersistenceTasks,
|
||||||
|
persistence_convergence: &std::sync::Arc<crate::RawTransactionIngestPersistenceConvergence>,
|
||||||
port: &std::option::Option<PersistencePort>,
|
port: &std::option::Option<PersistencePort>,
|
||||||
snapshots: &mut crate::RawTransactionIngestSnapshotPublisher,
|
snapshots: &mut crate::RawTransactionIngestSnapshotPublisher,
|
||||||
) -> std::option::Option<ksp_core_lib::ErrorCode> {
|
) -> std::option::Option<ksp_core_lib::ErrorCode> {
|
||||||
@@ -205,7 +210,7 @@ async fn drain_admission_and_persistence(
|
|||||||
let backpressure_wait_observed = admission.take_backpressure_wait_observed();
|
let backpressure_wait_observed = admission.take_backpressure_wait_observed();
|
||||||
match received {
|
match received {
|
||||||
std::result::Result::Ok(std::option::Option::Some(acquisition)) => {
|
std::result::Result::Ok(std::option::Option::Some(acquisition)) => {
|
||||||
let spawned = spawn_persistence(persistence, port, acquisition);
|
let spawned = spawn_persistence(persistence, persistence_convergence, port, acquisition);
|
||||||
let published = snapshots.record_admission_success(lifecycle.state(), admission.queue_depth(), persistence.len(), backpressure_wait_observed);
|
let published = snapshots.record_admission_success(lifecycle.state(), admission.queue_depth(), persistence.len(), backpressure_wait_observed);
|
||||||
if !spawned && fault.is_none() {
|
if !spawned && fault.is_none() {
|
||||||
fault = std::option::Option::Some(crate::ERROR_CODE_RAW_TRANSACTION_INGEST_RUNTIME_INVALID);
|
fault = std::option::Option::Some(crate::ERROR_CODE_RAW_TRANSACTION_INGEST_RUNTIME_INVALID);
|
||||||
@@ -245,11 +250,12 @@ async fn drain_owned_work(
|
|||||||
children: &mut SourceTasks,
|
children: &mut SourceTasks,
|
||||||
admission: &mut crate::RawTransactionAdmission,
|
admission: &mut crate::RawTransactionAdmission,
|
||||||
persistence: &mut PersistenceTasks,
|
persistence: &mut PersistenceTasks,
|
||||||
|
persistence_convergence: &std::sync::Arc<crate::RawTransactionIngestPersistenceConvergence>,
|
||||||
port: &std::option::Option<PersistencePort>,
|
port: &std::option::Option<PersistencePort>,
|
||||||
snapshots: &mut crate::RawTransactionIngestSnapshotPublisher,
|
snapshots: &mut crate::RawTransactionIngestSnapshotPublisher,
|
||||||
) -> std::option::Option<ksp_core_lib::ErrorCode> {
|
) -> std::option::Option<ksp_core_lib::ErrorCode> {
|
||||||
let drain = async {
|
let drain = async {
|
||||||
let mut fault = drain_admission_and_persistence(settings, lifecycle, admission, persistence, port, snapshots).await;
|
let mut fault = drain_admission_and_persistence(settings, lifecycle, admission, persistence, persistence_convergence, port, snapshots).await;
|
||||||
let child_fault = drain_children(lifecycle.state(), children, snapshots).await;
|
let child_fault = drain_children(lifecycle.state(), children, snapshots).await;
|
||||||
fault = merge_fault(fault, child_fault);
|
fault = merge_fault(fault, child_fault);
|
||||||
return fault;
|
return fault;
|
||||||
@@ -337,13 +343,16 @@ fn source_completion(
|
|||||||
in_flight_persistence: usize,
|
in_flight_persistence: usize,
|
||||||
snapshots: &mut crate::RawTransactionIngestSnapshotPublisher,
|
snapshots: &mut crate::RawTransactionIngestSnapshotPublisher,
|
||||||
) -> std::option::Option<ksp_core_lib::ErrorCode> {
|
) -> std::option::Option<ksp_core_lib::ErrorCode> {
|
||||||
match joined {
|
let source_code = match joined {
|
||||||
std::result::Result::Ok(std::result::Result::Ok(())) => return std::option::Option::None,
|
std::result::Result::Ok(std::result::Result::Ok(())) => return std::option::Option::None,
|
||||||
std::result::Result::Ok(std::result::Result::Err(_)) | std::result::Result::Err(_) => {},
|
std::result::Result::Ok(std::result::Result::Err(error)) if error.code() == crate::ERROR_CODE_RAW_TRANSACTION_INGEST_COUNTER_EXHAUSTED => {
|
||||||
}
|
crate::ERROR_CODE_RAW_TRANSACTION_INGEST_COUNTER_EXHAUSTED
|
||||||
|
},
|
||||||
|
std::result::Result::Ok(std::result::Result::Err(_)) | std::result::Result::Err(_) => crate::ERROR_CODE_RAW_TRANSACTION_INGEST_SOURCE_FAILED,
|
||||||
|
};
|
||||||
let published = snapshots.record_source_failure(state, admission_queue_depth, in_flight_persistence);
|
let published = snapshots.record_source_failure(state, admission_queue_depth, in_flight_persistence);
|
||||||
return match published {
|
return match published {
|
||||||
std::result::Result::Ok(()) => std::option::Option::Some(crate::ERROR_CODE_RAW_TRANSACTION_INGEST_SOURCE_FAILED),
|
std::result::Result::Ok(()) => std::option::Option::Some(source_code),
|
||||||
std::result::Result::Err(error) => std::option::Option::Some(error.code()),
|
std::result::Result::Err(error) => std::option::Option::Some(error.code()),
|
||||||
};
|
};
|
||||||
}
|
}
|
||||||
@@ -378,6 +387,9 @@ async fn run_supervisor<Spawner>(
|
|||||||
}
|
}
|
||||||
let mut children = SourceTasks::new();
|
let mut children = SourceTasks::new();
|
||||||
let mut persistence = PersistenceTasks::new();
|
let mut persistence = PersistenceTasks::new();
|
||||||
|
let persistence_convergence = std::sync::Arc::new(crate::RawTransactionIngestPersistenceConvergence::new(
|
||||||
|
settings.admission_queue_capacity().max(settings.persistence_concurrency()),
|
||||||
|
));
|
||||||
let (source_stop_sender, source_stop_receiver) = tokio::sync::watch::channel(false);
|
let (source_stop_sender, source_stop_receiver) = tokio::sync::watch::channel(false);
|
||||||
let (mut admission, admission_sender) = crate::RawTransactionAdmission::new(settings.admission_queue_capacity());
|
let (mut admission, admission_sender) = crate::RawTransactionAdmission::new(settings.admission_queue_capacity());
|
||||||
source_spawner(&mut children, source_stop_receiver, admission_sender);
|
source_spawner(&mut children, source_stop_receiver, admission_sender);
|
||||||
@@ -389,6 +401,7 @@ async fn run_supervisor<Spawner>(
|
|||||||
&mut children,
|
&mut children,
|
||||||
&mut admission,
|
&mut admission,
|
||||||
&mut persistence,
|
&mut persistence,
|
||||||
|
&persistence_convergence,
|
||||||
&port,
|
&port,
|
||||||
&mut snapshots,
|
&mut snapshots,
|
||||||
&mut processing_frontier_receiver,
|
&mut processing_frontier_receiver,
|
||||||
@@ -397,7 +410,8 @@ async fn run_supervisor<Spawner>(
|
|||||||
source_stop_sender.send_replace(true);
|
source_stop_sender.send_replace(true);
|
||||||
let stopping_fault = begin_stopping(&mut lifecycle, &mut snapshots, admission.queue_depth(), persistence.len());
|
let stopping_fault = begin_stopping(&mut lifecycle, &mut snapshots, admission.queue_depth(), persistence.len());
|
||||||
fault = merge_fault(fault, stopping_fault);
|
fault = merge_fault(fault, stopping_fault);
|
||||||
let drain_fault = drain_owned_work(&settings, &lifecycle, &mut children, &mut admission, &mut persistence, &port, &mut snapshots).await;
|
let drain_fault =
|
||||||
|
drain_owned_work(&settings, &lifecycle, &mut children, &mut admission, &mut persistence, &persistence_convergence, &port, &mut snapshots).await;
|
||||||
match drain_fault {
|
match drain_fault {
|
||||||
std::option::Option::Some(code) if code == crate::ERROR_CODE_RAW_TRANSACTION_INGEST_DRAIN_TIMEOUT => {
|
std::option::Option::Some(code) if code == crate::ERROR_CODE_RAW_TRANSACTION_INGEST_DRAIN_TIMEOUT => {
|
||||||
fault = std::option::Option::Some(code);
|
fault = std::option::Option::Some(code);
|
||||||
@@ -416,6 +430,7 @@ async fn run_supervisor<Spawner>(
|
|||||||
|
|
||||||
fn spawn_persistence(
|
fn spawn_persistence(
|
||||||
persistence: &mut PersistenceTasks,
|
persistence: &mut PersistenceTasks,
|
||||||
|
persistence_convergence: &std::sync::Arc<crate::RawTransactionIngestPersistenceConvergence>,
|
||||||
port: &std::option::Option<PersistencePort>,
|
port: &std::option::Option<PersistencePort>,
|
||||||
acquisition: ksp_raw_transaction_lib::RawTransactionAcquisition,
|
acquisition: ksp_raw_transaction_lib::RawTransactionAcquisition,
|
||||||
) -> bool {
|
) -> bool {
|
||||||
@@ -423,8 +438,9 @@ fn spawn_persistence(
|
|||||||
std::option::Option::Some(value) => std::sync::Arc::clone(value),
|
std::option::Option::Some(value) => std::sync::Arc::clone(value),
|
||||||
std::option::Option::None => return false,
|
std::option::Option::None => return false,
|
||||||
};
|
};
|
||||||
|
let persistence_convergence = std::sync::Arc::clone(persistence_convergence);
|
||||||
let _abort_handle = persistence.spawn(async move {
|
let _abort_handle = persistence.spawn(async move {
|
||||||
return crate::persist_raw_transaction_ingest_acquisition(port.as_ref(), acquisition).await;
|
return crate::persist_raw_transaction_ingest_converged_acquisition(port.as_ref(), acquisition, persistence_convergence.as_ref()).await;
|
||||||
});
|
});
|
||||||
return true;
|
return true;
|
||||||
}
|
}
|
||||||
@@ -447,7 +463,7 @@ where
|
|||||||
Spawner:
|
Spawner:
|
||||||
FnOnce(&mut SourceTasks, tokio::sync::watch::Receiver<bool>, tokio::sync::mpsc::Sender<crate::RawTransactionIngress>) + std::marker::Send + 'static,
|
FnOnce(&mut SourceTasks, tokio::sync::watch::Receiver<bool>, tokio::sync::mpsc::Sender<crate::RawTransactionIngress>) + std::marker::Send + 'static,
|
||||||
{
|
{
|
||||||
return start_foundation_with_port_source_spawner_and_frontier(settings, runtime, port, std::option::Option::None, source_spawner);
|
return start_foundation_with_port_source_spawner_and_frontier(settings, runtime, port, std::option::Option::None, 0, source_spawner);
|
||||||
}
|
}
|
||||||
|
|
||||||
fn start_foundation_with_port_source_spawner_and_frontier<Spawner>(
|
fn start_foundation_with_port_source_spawner_and_frontier<Spawner>(
|
||||||
@@ -455,6 +471,7 @@ fn start_foundation_with_port_source_spawner_and_frontier<Spawner>(
|
|||||||
runtime: tokio::runtime::Handle,
|
runtime: tokio::runtime::Handle,
|
||||||
port: std::option::Option<PersistencePort>,
|
port: std::option::Option<PersistencePort>,
|
||||||
processing_frontier_receiver: std::option::Option<ProcessingFrontierReceiver>,
|
processing_frontier_receiver: std::option::Option<ProcessingFrontierReceiver>,
|
||||||
|
source_total: usize,
|
||||||
source_spawner: Spawner,
|
source_spawner: Spawner,
|
||||||
) -> ksp_core_lib::Result<crate::RawTransactionIngestHandle>
|
) -> ksp_core_lib::Result<crate::RawTransactionIngestHandle>
|
||||||
where
|
where
|
||||||
@@ -471,7 +488,7 @@ where
|
|||||||
}
|
}
|
||||||
let stop_token = ksp_worker_api::WorkerStopToken::new();
|
let stop_token = ksp_worker_api::WorkerStopToken::new();
|
||||||
let (stop_sender, stop_receiver) = tokio::sync::watch::channel(false);
|
let (stop_sender, stop_receiver) = tokio::sync::watch::channel(false);
|
||||||
let (snapshots, snapshot_source) = crate::RawTransactionIngestSnapshotPublisher::new(&settings, &lifecycle);
|
let (snapshots, snapshot_source) = crate::RawTransactionIngestSnapshotPublisher::new(&settings, &lifecycle, source_total);
|
||||||
let handle = crate::RawTransactionIngestHandle { snapshots: snapshot_source, stop_sender, stop_token };
|
let handle = crate::RawTransactionIngestHandle { snapshots: snapshot_source, stop_sender, stop_token };
|
||||||
std::mem::drop(runtime.spawn(run_supervisor(settings, lifecycle, port, stop_receiver, snapshots, processing_frontier_receiver, source_spawner)));
|
std::mem::drop(runtime.spawn(run_supervisor(settings, lifecycle, port, stop_receiver, snapshots, processing_frontier_receiver, source_spawner)));
|
||||||
return std::result::Result::Ok(handle);
|
return std::result::Result::Ok(handle);
|
||||||
@@ -505,6 +522,7 @@ async fn supervise_until_stop(
|
|||||||
children: &mut SourceTasks,
|
children: &mut SourceTasks,
|
||||||
admission: &mut crate::RawTransactionAdmission,
|
admission: &mut crate::RawTransactionAdmission,
|
||||||
persistence: &mut PersistenceTasks,
|
persistence: &mut PersistenceTasks,
|
||||||
|
persistence_convergence: &std::sync::Arc<crate::RawTransactionIngestPersistenceConvergence>,
|
||||||
port: &std::option::Option<PersistencePort>,
|
port: &std::option::Option<PersistencePort>,
|
||||||
snapshots: &mut crate::RawTransactionIngestSnapshotPublisher,
|
snapshots: &mut crate::RawTransactionIngestSnapshotPublisher,
|
||||||
processing_frontier_receiver: &mut std::option::Option<ProcessingFrontierReceiver>,
|
processing_frontier_receiver: &mut std::option::Option<ProcessingFrontierReceiver>,
|
||||||
@@ -576,7 +594,7 @@ async fn supervise_until_stop(
|
|||||||
match received {
|
match received {
|
||||||
std::result::Result::Ok(std::option::Option::Some(acquisition)) => {
|
std::result::Result::Ok(std::option::Option::Some(acquisition)) => {
|
||||||
let backpressure_wait_observed = admission.take_backpressure_wait_observed();
|
let backpressure_wait_observed = admission.take_backpressure_wait_observed();
|
||||||
let spawned = spawn_persistence(persistence, port, acquisition);
|
let spawned = spawn_persistence(persistence, persistence_convergence, port, acquisition);
|
||||||
let published = snapshots.record_admission_success(
|
let published = snapshots.record_admission_success(
|
||||||
lifecycle.state(),
|
lifecycle.state(),
|
||||||
admission.queue_depth(),
|
admission.queue_depth(),
|
||||||
|
|||||||
File diff suppressed because it is too large
Load Diff
@@ -1,5 +1,5 @@
|
|||||||
// file: crates/ksp-worker-raw-transaction-ingest-lib/src/snapshot.rs
|
// file: crates/ksp-worker-raw-transaction-ingest-lib/src/snapshot.rs
|
||||||
// version: 4
|
// version: 5
|
||||||
|
|
||||||
/// Runtime-neutral boxed future resolving to one newer concrete RAW transaction ingest Worker snapshot.
|
/// Runtime-neutral boxed future resolving to one newer concrete RAW transaction ingest Worker snapshot.
|
||||||
pub type RawTransactionIngestSnapshotFuture<'a> =
|
pub type RawTransactionIngestSnapshotFuture<'a> =
|
||||||
@@ -27,6 +27,10 @@ pub(crate) struct RawTransactionIngestProcessingFrontierProjection {
|
|||||||
processing_frontier_slot: std::option::Option<u64>,
|
processing_frontier_slot: std::option::Option<u64>,
|
||||||
oldest_pending_slot: std::option::Option<u64>,
|
oldest_pending_slot: std::option::Option<u64>,
|
||||||
source_state: std::option::Option<crate::RawTransactionIngestSourceState>,
|
source_state: std::option::Option<crate::RawTransactionIngestSourceState>,
|
||||||
|
source_total: usize,
|
||||||
|
source_active: usize,
|
||||||
|
source_reconnecting: usize,
|
||||||
|
source_failed: usize,
|
||||||
source_reconnect_total: u64,
|
source_reconnect_total: u64,
|
||||||
source_replay_attempt_total: u64,
|
source_replay_attempt_total: u64,
|
||||||
source_continuity_gap_total: u64,
|
source_continuity_gap_total: u64,
|
||||||
@@ -40,6 +44,10 @@ impl crate::RawTransactionIngestProcessingFrontierProjection {
|
|||||||
processing_frontier_slot: std::option::Option::None,
|
processing_frontier_slot: std::option::Option::None,
|
||||||
oldest_pending_slot: std::option::Option::None,
|
oldest_pending_slot: std::option::Option::None,
|
||||||
source_state: std::option::Option::None,
|
source_state: std::option::Option::None,
|
||||||
|
source_total: 0,
|
||||||
|
source_active: 0,
|
||||||
|
source_reconnecting: 0,
|
||||||
|
source_failed: 0,
|
||||||
source_reconnect_total: 0,
|
source_reconnect_total: 0,
|
||||||
source_replay_attempt_total: 0,
|
source_replay_attempt_total: 0,
|
||||||
source_continuity_gap_total: 0,
|
source_continuity_gap_total: 0,
|
||||||
@@ -57,6 +65,10 @@ impl crate::RawTransactionIngestProcessingFrontierProjection {
|
|||||||
processing_frontier_slot,
|
processing_frontier_slot,
|
||||||
oldest_pending_slot,
|
oldest_pending_slot,
|
||||||
source_state: std::option::Option::None,
|
source_state: std::option::Option::None,
|
||||||
|
source_total: 0,
|
||||||
|
source_active: 0,
|
||||||
|
source_reconnecting: 0,
|
||||||
|
source_failed: 0,
|
||||||
source_reconnect_total: 0,
|
source_reconnect_total: 0,
|
||||||
source_replay_attempt_total: 0,
|
source_replay_attempt_total: 0,
|
||||||
source_continuity_gap_total: 0,
|
source_continuity_gap_total: 0,
|
||||||
@@ -93,6 +105,35 @@ impl crate::RawTransactionIngestProcessingFrontierProjection {
|
|||||||
return self;
|
return self;
|
||||||
}
|
}
|
||||||
|
|
||||||
|
/// Returns a copy carrying source-neutral multi-source lifecycle counts.
|
||||||
|
pub(crate) const fn with_source_counts(mut self, source_total: usize, source_active: usize, source_reconnecting: usize, source_failed: usize) -> Self {
|
||||||
|
self.source_total = source_total;
|
||||||
|
self.source_active = source_active;
|
||||||
|
self.source_reconnecting = source_reconnecting;
|
||||||
|
self.source_failed = source_failed;
|
||||||
|
return self;
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Returns the configured logical source count carried by this private projection.
|
||||||
|
pub(crate) const fn source_total(&self) -> usize {
|
||||||
|
return self.source_total;
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Returns the number of sources currently projected Active.
|
||||||
|
pub(crate) const fn source_active(&self) -> usize {
|
||||||
|
return self.source_active;
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Returns the number of sources currently projected Reconnecting.
|
||||||
|
pub(crate) const fn source_reconnecting(&self) -> usize {
|
||||||
|
return self.source_reconnecting;
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Returns the number of sources currently projected Failed.
|
||||||
|
pub(crate) const fn source_failed(&self) -> usize {
|
||||||
|
return self.source_failed;
|
||||||
|
}
|
||||||
|
|
||||||
/// Returns the latest source-neutral lifecycle state carried by this private projection.
|
/// Returns the latest source-neutral lifecycle state carried by this private projection.
|
||||||
pub(crate) const fn source_state(&self) -> std::option::Option<crate::RawTransactionIngestSourceState> {
|
pub(crate) const fn source_state(&self) -> std::option::Option<crate::RawTransactionIngestSourceState> {
|
||||||
return self.source_state;
|
return self.source_state;
|
||||||
@@ -138,6 +179,10 @@ pub struct RawTransactionIngestSnapshot {
|
|||||||
processing_frontier_slot: std::option::Option<u64>,
|
processing_frontier_slot: std::option::Option<u64>,
|
||||||
oldest_pending_slot: std::option::Option<u64>,
|
oldest_pending_slot: std::option::Option<u64>,
|
||||||
source_state: std::option::Option<crate::RawTransactionIngestSourceState>,
|
source_state: std::option::Option<crate::RawTransactionIngestSourceState>,
|
||||||
|
source_total: usize,
|
||||||
|
source_active: usize,
|
||||||
|
source_reconnecting: usize,
|
||||||
|
source_failed: usize,
|
||||||
source_reconnect_total: u64,
|
source_reconnect_total: u64,
|
||||||
source_replay_attempt_total: u64,
|
source_replay_attempt_total: u64,
|
||||||
source_continuity_gap_total: u64,
|
source_continuity_gap_total: u64,
|
||||||
@@ -264,6 +309,30 @@ impl crate::RawTransactionIngestSnapshot {
|
|||||||
return self.oldest_pending_slot;
|
return self.oldest_pending_slot;
|
||||||
}
|
}
|
||||||
|
|
||||||
|
/// Returns the configured number of logical live sources for this Worker run.
|
||||||
|
#[must_use]
|
||||||
|
pub const fn source_total(&self) -> usize {
|
||||||
|
return self.source_total;
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Returns the latest number of sources projected Active.
|
||||||
|
#[must_use]
|
||||||
|
pub const fn source_active(&self) -> usize {
|
||||||
|
return self.source_active;
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Returns the latest number of sources projected Reconnecting.
|
||||||
|
#[must_use]
|
||||||
|
pub const fn source_reconnecting(&self) -> usize {
|
||||||
|
return self.source_reconnecting;
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Returns the latest number of sources projected Failed.
|
||||||
|
#[must_use]
|
||||||
|
pub const fn source_failed(&self) -> usize {
|
||||||
|
return self.source_failed;
|
||||||
|
}
|
||||||
|
|
||||||
/// Returns the latest source-neutral lifecycle state when the productive source has started.
|
/// Returns the latest source-neutral lifecycle state when the productive source has started.
|
||||||
#[must_use]
|
#[must_use]
|
||||||
pub const fn source_state(&self) -> std::option::Option<crate::RawTransactionIngestSourceState> {
|
pub const fn source_state(&self) -> std::option::Option<crate::RawTransactionIngestSourceState> {
|
||||||
@@ -314,6 +383,10 @@ impl std::fmt::Debug for crate::RawTransactionIngestSnapshot {
|
|||||||
.field("processing_frontier_slot", &self.processing_frontier_slot)
|
.field("processing_frontier_slot", &self.processing_frontier_slot)
|
||||||
.field("oldest_pending_slot", &self.oldest_pending_slot)
|
.field("oldest_pending_slot", &self.oldest_pending_slot)
|
||||||
.field("source_state", &self.source_state)
|
.field("source_state", &self.source_state)
|
||||||
|
.field("source_total", &self.source_total)
|
||||||
|
.field("source_active", &self.source_active)
|
||||||
|
.field("source_reconnecting", &self.source_reconnecting)
|
||||||
|
.field("source_failed", &self.source_failed)
|
||||||
.field("source_reconnect_total", &self.source_reconnect_total)
|
.field("source_reconnect_total", &self.source_reconnect_total)
|
||||||
.field("source_replay_attempt_total", &self.source_replay_attempt_total)
|
.field("source_replay_attempt_total", &self.source_replay_attempt_total)
|
||||||
.field("source_continuity_gap_total", &self.source_continuity_gap_total)
|
.field("source_continuity_gap_total", &self.source_continuity_gap_total)
|
||||||
@@ -403,6 +476,7 @@ impl crate::RawTransactionIngestSnapshotPublisher {
|
|||||||
pub(crate) fn new(
|
pub(crate) fn new(
|
||||||
settings: &crate::RawTransactionIngestSettings,
|
settings: &crate::RawTransactionIngestSettings,
|
||||||
lifecycle: &ksp_worker_api::WorkerLifecycle,
|
lifecycle: &ksp_worker_api::WorkerLifecycle,
|
||||||
|
source_total: usize,
|
||||||
) -> (crate::RawTransactionIngestSnapshotPublisher, crate::RawTransactionIngestSnapshotSource) {
|
) -> (crate::RawTransactionIngestSnapshotPublisher, crate::RawTransactionIngestSnapshotSource) {
|
||||||
let worker = ksp_worker_api::WorkerSnapshot::new(
|
let worker = ksp_worker_api::WorkerSnapshot::new(
|
||||||
lifecycle.id().clone(),
|
lifecycle.id().clone(),
|
||||||
@@ -434,6 +508,10 @@ impl crate::RawTransactionIngestSnapshotPublisher {
|
|||||||
processing_frontier_slot: std::option::Option::None,
|
processing_frontier_slot: std::option::Option::None,
|
||||||
oldest_pending_slot: std::option::Option::None,
|
oldest_pending_slot: std::option::Option::None,
|
||||||
source_state: std::option::Option::None,
|
source_state: std::option::Option::None,
|
||||||
|
source_total,
|
||||||
|
source_active: 0,
|
||||||
|
source_reconnecting: 0,
|
||||||
|
source_failed: 0,
|
||||||
source_reconnect_total: 0,
|
source_reconnect_total: 0,
|
||||||
source_replay_attempt_total: 0,
|
source_replay_attempt_total: 0,
|
||||||
source_continuity_gap_total: 0,
|
source_continuity_gap_total: 0,
|
||||||
@@ -449,7 +527,14 @@ impl crate::RawTransactionIngestSnapshotPublisher {
|
|||||||
self.snapshot.worker.kind().clone(),
|
self.snapshot.worker.kind().clone(),
|
||||||
self.snapshot.worker.sequence(),
|
self.snapshot.worker.sequence(),
|
||||||
state,
|
state,
|
||||||
health_for_state(state, self.snapshot.worker.health()),
|
health_for_state(
|
||||||
|
state,
|
||||||
|
self.snapshot.worker.health(),
|
||||||
|
self.snapshot.source_total,
|
||||||
|
self.snapshot.source_active,
|
||||||
|
self.snapshot.source_reconnecting,
|
||||||
|
self.snapshot.source_failed,
|
||||||
|
),
|
||||||
ksp_worker_api::WorkerActivity::Idle,
|
ksp_worker_api::WorkerActivity::Idle,
|
||||||
);
|
);
|
||||||
self.snapshot.worker = worker;
|
self.snapshot.worker = worker;
|
||||||
@@ -530,6 +615,12 @@ impl crate::RawTransactionIngestSnapshotPublisher {
|
|||||||
self.snapshot.processing_frontier_slot = projection.processing_frontier_slot();
|
self.snapshot.processing_frontier_slot = projection.processing_frontier_slot();
|
||||||
self.snapshot.oldest_pending_slot = projection.oldest_pending_slot();
|
self.snapshot.oldest_pending_slot = projection.oldest_pending_slot();
|
||||||
self.snapshot.source_state = projection.source_state();
|
self.snapshot.source_state = projection.source_state();
|
||||||
|
if projection.source_total() > 0 {
|
||||||
|
self.snapshot.source_total = projection.source_total();
|
||||||
|
self.snapshot.source_active = projection.source_active();
|
||||||
|
self.snapshot.source_reconnecting = projection.source_reconnecting();
|
||||||
|
self.snapshot.source_failed = projection.source_failed();
|
||||||
|
}
|
||||||
self.snapshot.source_reconnect_total = projection.source_reconnect_total();
|
self.snapshot.source_reconnect_total = projection.source_reconnect_total();
|
||||||
self.snapshot.source_replay_attempt_total = projection.source_replay_attempt_total();
|
self.snapshot.source_replay_attempt_total = projection.source_replay_attempt_total();
|
||||||
self.snapshot.source_continuity_gap_total = projection.source_continuity_gap_total();
|
self.snapshot.source_continuity_gap_total = projection.source_continuity_gap_total();
|
||||||
@@ -646,7 +737,14 @@ impl crate::RawTransactionIngestSnapshotPublisher {
|
|||||||
self.snapshot.worker.kind().clone(),
|
self.snapshot.worker.kind().clone(),
|
||||||
sequence,
|
sequence,
|
||||||
state,
|
state,
|
||||||
health_for_state(state, self.snapshot.worker.health()),
|
health_for_state(
|
||||||
|
state,
|
||||||
|
self.snapshot.worker.health(),
|
||||||
|
self.snapshot.source_total,
|
||||||
|
self.snapshot.source_active,
|
||||||
|
self.snapshot.source_reconnecting,
|
||||||
|
self.snapshot.source_failed,
|
||||||
|
),
|
||||||
activity_for_state(state, admission_queue_depth, in_flight_persistence, self.snapshot.hydration_pending, self.snapshot.source_state),
|
activity_for_state(state, admission_queue_depth, in_flight_persistence, self.snapshot.hydration_pending, self.snapshot.source_state),
|
||||||
);
|
);
|
||||||
self.snapshot.worker = worker;
|
self.snapshot.worker = worker;
|
||||||
@@ -698,8 +796,18 @@ fn checked_optional_counter(current: u64, increment: bool, field: &'static str)
|
|||||||
return checked_counter(current, field);
|
return checked_counter(current, field);
|
||||||
}
|
}
|
||||||
|
|
||||||
fn health_for_state(state: ksp_worker_api::WorkerState, previous: ksp_worker_api::WorkerHealth) -> ksp_worker_api::WorkerHealth {
|
fn health_for_state(
|
||||||
|
state: ksp_worker_api::WorkerState,
|
||||||
|
previous: ksp_worker_api::WorkerHealth,
|
||||||
|
source_total: usize,
|
||||||
|
source_active: usize,
|
||||||
|
source_reconnecting: usize,
|
||||||
|
source_failed: usize,
|
||||||
|
) -> ksp_worker_api::WorkerHealth {
|
||||||
return match state {
|
return match state {
|
||||||
|
ksp_worker_api::WorkerState::Running if source_failed > 0 => ksp_worker_api::WorkerHealth::Unhealthy,
|
||||||
|
ksp_worker_api::WorkerState::Running if source_reconnecting > 0 => ksp_worker_api::WorkerHealth::Degraded,
|
||||||
|
ksp_worker_api::WorkerState::Running if source_total > 0 && source_active < source_total => ksp_worker_api::WorkerHealth::Degraded,
|
||||||
ksp_worker_api::WorkerState::Running => ksp_worker_api::WorkerHealth::Healthy,
|
ksp_worker_api::WorkerState::Running => ksp_worker_api::WorkerHealth::Healthy,
|
||||||
ksp_worker_api::WorkerState::Stopping | ksp_worker_api::WorkerState::Stopped => previous,
|
ksp_worker_api::WorkerState::Stopping | ksp_worker_api::WorkerState::Stopped => previous,
|
||||||
ksp_worker_api::WorkerState::Faulted(_) => ksp_worker_api::WorkerHealth::Unhealthy,
|
ksp_worker_api::WorkerState::Faulted(_) => ksp_worker_api::WorkerHealth::Unhealthy,
|
||||||
|
|||||||
@@ -1,7 +1,7 @@
|
|||||||
// file: crates/ksp-worker-raw-transaction-ingest-lib/tests/cross_layer_completeness.rs
|
// file: crates/ksp-worker-raw-transaction-ingest-lib/tests/cross_layer_completeness.rs
|
||||||
// version: 1
|
// version: 2
|
||||||
|
|
||||||
//! Cross-layer completeness and security canaries for `0.3.12-pre.010`.
|
//! Cross-layer completeness and security canaries through `0.3.13-pre.012`.
|
||||||
|
|
||||||
fn dependency_names(manifest: &str) -> std::vec::Vec<&str> {
|
fn dependency_names(manifest: &str) -> std::vec::Vec<&str> {
|
||||||
let mut section = "";
|
let mut section = "";
|
||||||
@@ -190,3 +190,176 @@ fn v0_3_12_pre_010_public_roots_keep_implementation_modules_private() {
|
|||||||
}
|
}
|
||||||
return;
|
return;
|
||||||
}
|
}
|
||||||
|
|
||||||
|
#[test]
|
||||||
|
fn v0_3_13_pre_012_all_five_live_source_families_share_one_worker_common_raw_store_pipeline() {
|
||||||
|
let transport_root = include_str!("../../ksp-onchain-transport-lib/src/lib.rs");
|
||||||
|
let transport_http_transactions = include_str!("../../ksp-onchain-transport-lib/src/rpc_transactions.rs");
|
||||||
|
let transport_http_blocks = include_str!("../../ksp-onchain-transport-lib/src/rpc_blocks.rs");
|
||||||
|
let transport_ws_protocol = include_str!("../../ksp-onchain-transport-lib/src/ws_protocol_session.rs");
|
||||||
|
let transport_grpc_stream = include_str!("../../ksp-onchain-transport-lib/src/grpc_stream.rs");
|
||||||
|
let worker_resources = include_str!("../src/runtime_resources.rs");
|
||||||
|
let worker_persistence = include_str!("../src/persistence.rs");
|
||||||
|
let common_raw_root = include_str!("../../ksp-raw-transaction-lib/src/lib.rs");
|
||||||
|
let store_root = include_str!("../../ksp-store-lib/src/lib.rs");
|
||||||
|
let store = include_str!("../../ksp-store-lib/src/store.rs");
|
||||||
|
for required in [
|
||||||
|
"HeliusTransaction(crate::RawTransactionIngestHeliusTransactionSource)",
|
||||||
|
"HttpBlockPolling(crate::RawTransactionIngestHttpBlockPollingSource)",
|
||||||
|
"StandardBlock(crate::RawTransactionIngestStandardBlockSource)",
|
||||||
|
"StandardLogs(crate::RawTransactionIngestStandardLogsSource)",
|
||||||
|
"Yellowstone(crate::RawTransactionIngestYellowstoneSource)",
|
||||||
|
"RawTransactionIngestGlobalHydrationRegistry",
|
||||||
|
"run_live_sources",
|
||||||
|
"RawTransactionIngress",
|
||||||
|
] {
|
||||||
|
assert!(worker_resources.contains(required), "pre.012 Worker source/pipeline contract missing: {required}");
|
||||||
|
}
|
||||||
|
for required in ["persist_raw_transaction_ingest_converged_acquisition", "RawTransactionIngestPersistenceConvergence", "record_observation"] {
|
||||||
|
assert!(worker_persistence.contains(required), "pre.012 Worker persistence contract missing: {required}");
|
||||||
|
}
|
||||||
|
for required in ["SolanaStandardWsSession", "HeliusLaserStreamWsSession"] {
|
||||||
|
assert!(transport_ws_protocol.contains(required), "pre.012 WS Transport facade missing: {required}");
|
||||||
|
}
|
||||||
|
assert!(transport_grpc_stream.contains("pub struct SolanaYellowstoneGrpcSubscribeSession"));
|
||||||
|
assert!(transport_http_transactions.contains("pub async fn get_transaction_observed("));
|
||||||
|
assert!(transport_http_blocks.contains("pub async fn get_block_observed("));
|
||||||
|
assert!(transport_http_blocks.contains("pub async fn get_blocks_with_limit("));
|
||||||
|
for required in ["RawTransactionAcquisition", "RawSolanaMessageVersion", "RawSolanaTransactionWire"] {
|
||||||
|
assert!(common_raw_root.contains(required), "pre.012 Common RAW contract missing: {required}");
|
||||||
|
}
|
||||||
|
for required in ["RawTransactionWrite", "RawTransactionObservationWrite", "RawPayload"] {
|
||||||
|
assert!(store_root.contains(required), "pre.012 Store facade contract missing: {required}");
|
||||||
|
}
|
||||||
|
for required in ["persist_raw_transaction_acquisition", "record_raw_transaction_observation"] {
|
||||||
|
assert!(store.contains(required), "pre.012 Store dispatch contract missing: {required}");
|
||||||
|
}
|
||||||
|
assert!(!transport_root.contains("ksp_raw_transaction_lib"));
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
|
||||||
|
#[test]
|
||||||
|
fn v0_3_13_pre_012_legacy_v0_v1_is_proven_from_transport_through_worker_common_raw_to_store() {
|
||||||
|
let transport_grpc = include_str!("../../ksp-onchain-transport-lib/unit_tests/grpc_subscribe.rs");
|
||||||
|
let transport_blocks = include_str!("../../ksp-onchain-transport-lib/unit_tests/rpc_blocks.rs");
|
||||||
|
let worker = include_str!("../unit_tests/runtime_resources.rs");
|
||||||
|
let worker_resources = include_str!("../src/runtime_resources.rs");
|
||||||
|
let worker_persistence = include_str!("../src/persistence.rs");
|
||||||
|
let common_raw_wire = include_str!("../../ksp-raw-transaction-lib/unit_tests/wire.rs");
|
||||||
|
let common_raw_canonical = include_str!("../../ksp-raw-transaction-lib/unit_tests/canonical.rs");
|
||||||
|
let store_api = include_str!("../../ksp-store-api/tests/public_api.rs");
|
||||||
|
let store = include_str!("../../ksp-store-lib/src/store.rs");
|
||||||
|
assert!(transport_grpc.contains("yellowstone_transaction_update_decodes_current_storage_wire_including_v1_config_and_meta"));
|
||||||
|
assert!(transport_blocks.contains("typed_get_block_modern_full_config_preserves_rich_wire_and_simd_fields"));
|
||||||
|
for required in [
|
||||||
|
"v0_3_13_pre_004_standard_block_qualifies_legacy_v0_v1_and_rejects_ambiguous_or_future_versions",
|
||||||
|
"v0_3_13_pre_004_legacy_v0_v1_block_materials_are_direct_common_raw_with_exact_version_and_index",
|
||||||
|
"v0_3_13_pre_006_http_block_polling_qualifies_legacy_v0_v1_and_rejects_ambiguous_or_future_versions",
|
||||||
|
"RawSolanaMessageVersion::Legacy",
|
||||||
|
"RawSolanaMessageVersion::V0",
|
||||||
|
"RawSolanaMessageVersion::V1",
|
||||||
|
] {
|
||||||
|
assert!(worker.contains(required), "pre.012 Worker Legacy/V0/V1 proof missing: {required}");
|
||||||
|
}
|
||||||
|
assert!(worker_resources.contains("SolanaGetTransactionConfig::new"));
|
||||||
|
assert!(worker_resources.contains("std::option::Option::Some(1),"));
|
||||||
|
for required in [
|
||||||
|
"pre_006_legacy_v0_and_v1_wire_goldens_are_exact",
|
||||||
|
"pre_006_v1_structural_guards_reject_alt_duplicates_and_missing_config",
|
||||||
|
"RawSolanaMessageVersion::V1",
|
||||||
|
] {
|
||||||
|
assert!(common_raw_wire.contains(required), "pre.012 Common RAW V1 proof missing: {required}");
|
||||||
|
}
|
||||||
|
assert!(common_raw_canonical.contains("pre_002_canonical_raw_v1_golden_bytes_and_hash_are_exact"));
|
||||||
|
for required in ["block_time", "content_hash", "format_id", "format_version", "slot"] {
|
||||||
|
assert!(worker_persistence.contains(required), "pre.012 canonical Store identity field missing: {required}");
|
||||||
|
}
|
||||||
|
assert!(store_api.contains("public_pre_003_raw_transaction_and_observation_are_constructible_from_crate_root"));
|
||||||
|
assert!(store_api.contains("RawPayload::try_new(format, 1"));
|
||||||
|
assert!(store.contains("persist_raw_transaction_acquisition"));
|
||||||
|
assert!(store.contains("record_raw_transaction_observation"));
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
|
||||||
|
#[test]
|
||||||
|
fn v0_3_13_pre_012_yellowstone_non_regression_covers_identity_v1_reconnect_gap_and_worker_hydration() {
|
||||||
|
let transport_subscribe = include_str!("../../ksp-onchain-transport-lib/unit_tests/grpc_subscribe.rs");
|
||||||
|
let transport_stream = include_str!("../../ksp-onchain-transport-lib/unit_tests/grpc_stream.rs");
|
||||||
|
let transport_public = include_str!("../../ksp-onchain-transport-lib/tests/public_api.rs");
|
||||||
|
let worker = include_str!("../unit_tests/runtime_resources.rs");
|
||||||
|
let worker_hardening = include_str!("hardening.rs");
|
||||||
|
for required in [
|
||||||
|
"yellowstone_subscribe_request_identity_is_order_stable_exact_and_debug_redacted",
|
||||||
|
"yellowstone_transaction_update_decodes_current_storage_wire_including_v1_config_and_meta",
|
||||||
|
"yellowstone_transaction_status_update_preserves_error_and_rejects_malformed_signature",
|
||||||
|
"yellowstone_block_update_reuses_transaction_account_entry_dtos_and_preserves_server_counts",
|
||||||
|
] {
|
||||||
|
assert!(transport_subscribe.contains(required), "pre.012 Yellowstone Transport subscribe proof missing: {required}");
|
||||||
|
}
|
||||||
|
for required in [
|
||||||
|
"yellowstone_reconnect_replays_from_last_observed_slot_and_counts_duplicate_identity",
|
||||||
|
"yellowstone_replay_info_proves_and_clamps_retention_gap_without_lossless_claim",
|
||||||
|
"yellowstone_shutdown_interrupts_reconnect_backoff_and_mutation_is_rejected_during_reconnect",
|
||||||
|
] {
|
||||||
|
assert!(transport_stream.contains(required), "pre.012 Yellowstone Transport lifecycle proof missing: {required}");
|
||||||
|
}
|
||||||
|
assert!(transport_public.contains("public_v0_3_13_pre_002_yellowstone_subscribe_identity_is_opaque_and_available_from_crate_root"));
|
||||||
|
for required in [
|
||||||
|
"pre_002_source_accepts_matching_confirmed_transaction_and_get_transaction_route_without_io",
|
||||||
|
"v0_3_13_pre_002_live_source_key_is_stable_and_request_sensitive",
|
||||||
|
"pre_003_transaction_signal_fixture_preserves_exact_source_neutral_identity",
|
||||||
|
"pre_005_block_projects_transaction_signals_in_exact_source_order",
|
||||||
|
"pre_005_block_meta_and_slot_project_continuity_only_without_remote_dead_error",
|
||||||
|
"pre_004_observed_get_transaction_closes_signal_to_common_raw_ingress_with_composite_provenance",
|
||||||
|
"pre_008_reconnect_replay_and_proven_gap_are_distinct_monotone_and_frontier_preserving",
|
||||||
|
"v0_3_13_pre_008_global_hydration_registry_coalesces_cross_source_key_to_one_leader",
|
||||||
|
] {
|
||||||
|
assert!(worker.contains(required), "pre.012 Yellowstone Worker non-regression proof missing: {required}");
|
||||||
|
}
|
||||||
|
for required in [
|
||||||
|
"v0_3_12_pre_003_private_signal_debug_and_shape_do_not_expose_signature_filters_or_payload",
|
||||||
|
"v0_3_12_pre_008_reconnect_projection_is_source_neutral_bounded_and_contains_no_replay_material",
|
||||||
|
] {
|
||||||
|
assert!(worker_hardening.contains(required), "pre.012 Yellowstone Worker hardening proof missing: {required}");
|
||||||
|
}
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
|
||||||
|
#[test]
|
||||||
|
fn v0_3_13_pre_012_security_redaction_matrix_covers_all_live_sources_and_lower_layers() {
|
||||||
|
let transport_subscribe = include_str!("../../ksp-onchain-transport-lib/unit_tests/grpc_subscribe.rs");
|
||||||
|
let transport_unary = include_str!("../../ksp-onchain-transport-lib/unit_tests/grpc_unary.rs");
|
||||||
|
let transport_ws = include_str!("../../ksp-onchain-transport-lib/unit_tests/ws_helius_transactions.rs");
|
||||||
|
let worker = include_str!("hardening.rs");
|
||||||
|
let common_raw = include_str!("../../ksp-raw-transaction-lib/unit_tests/canonical.rs");
|
||||||
|
let store_api = include_str!("../../ksp-store-api/tests/security_hardening.rs");
|
||||||
|
let store = include_str!("../../ksp-store-lib/tests/hardening_completeness.rs");
|
||||||
|
let postgres = include_str!("../../ksp-store-postgres-lib/tests/hardening_completeness.rs");
|
||||||
|
for required in [
|
||||||
|
"yellowstone_subscribe_debug_omits_filter_names_and_future_payloads",
|
||||||
|
"yellowstone_transaction_filters_encode_complete_current_wire_and_redact_selectors",
|
||||||
|
] {
|
||||||
|
assert!(transport_subscribe.contains(required), "pre.012 Transport gRPC redaction proof missing: {required}");
|
||||||
|
}
|
||||||
|
assert!(transport_unary.contains("yellowstone_remote_status_does_not_copy_message_details_or_metadata"));
|
||||||
|
assert!(transport_ws.contains("helius_transaction_notification_debug_omits_raw_provider_payloads"));
|
||||||
|
for required in [
|
||||||
|
"v0_3_12_pre_003_private_signal_debug_and_shape_do_not_expose_signature_filters_or_payload",
|
||||||
|
"v0_3_13_pre_003_standard_logs_redaction_and_reference_only_contract_are_explicit",
|
||||||
|
"v0_3_13_pre_004_standard_block_redaction_version_and_null_guards_are_explicit",
|
||||||
|
"v0_3_13_pre_005_helius_transaction_redaction_full_reference_and_tier_neutrality_are_explicit",
|
||||||
|
"v0_3_13_pre_006_http_block_polling_is_bounded_run_local_stop_preemptible_and_redacted",
|
||||||
|
"v0_3_13_pre_007_multi_source_supervisor_is_fail_closed_joined_and_does_not_publish_source_identity",
|
||||||
|
"v0_3_13_pre_008_cross_source_convergence_is_bounded_conflict_checked_and_private",
|
||||||
|
"v0_3_13_pre_009_duplicate_storm_disagreement_and_starvation_guards_are_explicit",
|
||||||
|
"v0_3_13_pre_010_multi_source_health_is_conservative_counted_and_redacted",
|
||||||
|
"v0_3_13_pre_011_shutdown_races_are_bounded_joined_atomic_and_counter_safe",
|
||||||
|
] {
|
||||||
|
assert!(worker.contains(required), "pre.012 Worker security proof missing: {required}");
|
||||||
|
}
|
||||||
|
assert!(common_raw.contains("pre_002_material_and_wire_debug_do_not_render_transaction_or_meta_material"));
|
||||||
|
assert!(store_api.contains("pre_007_raw_debug_surfaces_do_not_render_payload_hash_signature_or_account_bytes"));
|
||||||
|
assert!(store.contains("pre_009_secret_canary_never_crosses_settings_or_pre_io_error_debug"));
|
||||||
|
assert!(postgres.contains("pre_009_backend_error_bridge_cannot_retain_external_error_or_secret_text"));
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
|||||||
@@ -1,5 +1,5 @@
|
|||||||
// file: crates/ksp-worker-raw-transaction-ingest-lib/tests/dependency_boundary.rs
|
// file: crates/ksp-worker-raw-transaction-ingest-lib/tests/dependency_boundary.rs
|
||||||
// version: 16
|
// version: 29
|
||||||
|
|
||||||
//! Dependency firewall canaries for the RAW transaction ingest Worker foundation.
|
//! Dependency firewall canaries for the RAW transaction ingest Worker foundation.
|
||||||
|
|
||||||
@@ -85,7 +85,6 @@ fn v0_3_12_pre_003_transaction_and_status_adapters_are_private_and_transport_fac
|
|||||||
"pub struct RawTransactionIngestSourceSignal",
|
"pub struct RawTransactionIngestSourceSignal",
|
||||||
"pub(crate) struct RawTransactionIngestSourceSignal",
|
"pub(crate) struct RawTransactionIngestSourceSignal",
|
||||||
"pub use self::runtime_resources::RawTransactionIngestSourceSignal",
|
"pub use self::runtime_resources::RawTransactionIngestSourceSignal",
|
||||||
"get_block_observed",
|
|
||||||
"ksp_store_postgres_lib::",
|
"ksp_store_postgres_lib::",
|
||||||
"reqwest::",
|
"reqwest::",
|
||||||
"tonic::",
|
"tonic::",
|
||||||
@@ -125,17 +124,9 @@ fn v0_3_12_pre_004_hydration_contract_uses_only_transport_facade_common_raw_and_
|
|||||||
] {
|
] {
|
||||||
assert!(resources.contains(required), "required pre.004 hydration contract missing: {required}");
|
assert!(resources.contains(required), "required pre.004 hydration contract missing: {required}");
|
||||||
}
|
}
|
||||||
assert!(resources.contains("fn finalize_yellowstone_hydration"));
|
assert!(resources.contains("fn finalize_hydration"));
|
||||||
assert!(resources.contains("fn fetch_yellowstone_hydration"));
|
assert!(resources.contains("fn fetch_hydration"));
|
||||||
for forbidden in [
|
for forbidden in ["ksp_config_lib::", "ksp_job_backfill_lib::", "ksp_store_postgres_lib::", "reqwest::", "tonic::", "yellowstone_grpc_proto::"] {
|
||||||
"get_block_observed",
|
|
||||||
"ksp_config_lib::",
|
|
||||||
"ksp_job_backfill_lib::",
|
|
||||||
"ksp_store_postgres_lib::",
|
|
||||||
"reqwest::",
|
|
||||||
"tonic::",
|
|
||||||
"yellowstone_grpc_proto::",
|
|
||||||
] {
|
|
||||||
assert!(!resources.contains(forbidden) && !root.contains(forbidden), "pre.004 crossed a forbidden boundary: {forbidden}");
|
assert!(!resources.contains(forbidden) && !root.contains(forbidden), "pre.004 crossed a forbidden boundary: {forbidden}");
|
||||||
}
|
}
|
||||||
return;
|
return;
|
||||||
@@ -157,15 +148,7 @@ fn v0_3_12_pre_005_block_and_continuity_adapters_remain_private_and_transport_fa
|
|||||||
] {
|
] {
|
||||||
assert!(resources.contains(required), "required pre.005 private adapter contract missing: {required}");
|
assert!(resources.contains(required), "required pre.005 private adapter contract missing: {required}");
|
||||||
}
|
}
|
||||||
for forbidden in [
|
for forbidden in ["ksp_config_lib::", "ksp_job_backfill_lib::", "ksp_store_postgres_lib::", "reqwest::", "tonic::", "yellowstone_grpc_proto::"] {
|
||||||
"get_block_observed",
|
|
||||||
"ksp_config_lib::",
|
|
||||||
"ksp_job_backfill_lib::",
|
|
||||||
"ksp_store_postgres_lib::",
|
|
||||||
"reqwest::",
|
|
||||||
"tonic::",
|
|
||||||
"yellowstone_grpc_proto::",
|
|
||||||
] {
|
|
||||||
assert!(!resources.contains(forbidden) && !root.contains(forbidden), "pre.005 crossed a forbidden boundary: {forbidden}");
|
assert!(!resources.contains(forbidden) && !root.contains(forbidden), "pre.005 crossed a forbidden boundary: {forbidden}");
|
||||||
}
|
}
|
||||||
return;
|
return;
|
||||||
@@ -175,11 +158,7 @@ fn v0_3_12_pre_005_block_and_continuity_adapters_remain_private_and_transport_fa
|
|||||||
fn v0_3_12_pre_006_productive_source_uses_transport_session_bounded_coalescence_and_existing_admission() {
|
fn v0_3_12_pre_006_productive_source_uses_transport_session_bounded_coalescence_and_existing_admission() {
|
||||||
let runtime = include_str!("../src/runtime.rs");
|
let runtime = include_str!("../src/runtime.rs");
|
||||||
let resources = include_str!("../src/runtime_resources.rs");
|
let resources = include_str!("../src/runtime_resources.rs");
|
||||||
for required in [
|
for required in ["children.spawn", ".run_live_sources(source_settings, stop_receiver, admission_sender, processing_frontier_sender)"] {
|
||||||
"runtime_resources.into_yellowstone_source()",
|
|
||||||
"children.spawn",
|
|
||||||
"source.run(source_settings, stop_receiver, admission_sender, processing_frontier_sender)",
|
|
||||||
] {
|
|
||||||
assert!(runtime.contains(required), "required pre.006 supervisor wiring missing: {required}");
|
assert!(runtime.contains(required), "required pre.006 supervisor wiring missing: {required}");
|
||||||
}
|
}
|
||||||
for required in [
|
for required in [
|
||||||
@@ -188,19 +167,20 @@ fn v0_3_12_pre_006_productive_source_uses_transport_session_bounded_coalescence_
|
|||||||
"RawTransactionIngestHydrationCoordinator",
|
"RawTransactionIngestHydrationCoordinator",
|
||||||
"std::collections::BTreeMap",
|
"std::collections::BTreeMap",
|
||||||
"tokio::task::JoinSet",
|
"tokio::task::JoinSet",
|
||||||
"MAX_RAW_TRANSACTION_INGEST_ADMISSION_QUEUE_CAPACITY",
|
"RawTransactionIngestHydrationCoordinator::with_global_registry(",
|
||||||
|
"hydration_pending_limit,",
|
||||||
|
"hydration_in_flight_limit,",
|
||||||
"get_transaction_observed",
|
"get_transaction_observed",
|
||||||
"admission_sender.send(ingress)",
|
"admission_sender.send(ingress)",
|
||||||
"tasks.abort_all()",
|
"tasks.abort_all()",
|
||||||
"session.close().await",
|
"session.close().await",
|
||||||
"commitment: commitment.as_str()",
|
"commitment: hydration.commitment.as_str()",
|
||||||
"network: signal.network.clone()",
|
"network: signal.network.clone()",
|
||||||
"signature: signal.signature",
|
"signature: signal.signature",
|
||||||
] {
|
] {
|
||||||
assert!(resources.contains(required), "required pre.006 productive-source contract missing: {required}");
|
assert!(resources.contains(required), "required pre.006 productive-source contract missing: {required}");
|
||||||
}
|
}
|
||||||
for forbidden in [
|
for forbidden in [
|
||||||
"get_block_observed",
|
|
||||||
"ksp_config_lib::",
|
"ksp_config_lib::",
|
||||||
"ksp_job_backfill_lib::",
|
"ksp_job_backfill_lib::",
|
||||||
"ksp_store_postgres_lib::",
|
"ksp_store_postgres_lib::",
|
||||||
@@ -214,6 +194,175 @@ fn v0_3_12_pre_006_productive_source_uses_transport_session_bounded_coalescence_
|
|||||||
return;
|
return;
|
||||||
}
|
}
|
||||||
|
|
||||||
|
#[test]
|
||||||
|
fn v0_3_13_pre_006_http_block_polling_reuses_transport_facades_without_becoming_backfill() {
|
||||||
|
let root = include_str!("../src/lib.rs");
|
||||||
|
let resources = include_str!("../src/runtime_resources.rs");
|
||||||
|
for required in [
|
||||||
|
"RawTransactionIngestHttpBlockPollingSource",
|
||||||
|
"get_slot(&self.polling_role",
|
||||||
|
"get_blocks_with_limit(",
|
||||||
|
"get_block_observed(&self.polling_role",
|
||||||
|
"let mut next_scan_slot = start_slot",
|
||||||
|
"next_scan_slot = slot",
|
||||||
|
"tokio::time::sleep(self.poll_interval)",
|
||||||
|
"RawAcquisitionOrigin::Live",
|
||||||
|
"block_polling_get_block",
|
||||||
|
"SolanaTransactionEncoding::Base64",
|
||||||
|
"SolanaTransactionDetails::Full",
|
||||||
|
"std::option::Option::Some(1)",
|
||||||
|
] {
|
||||||
|
assert!(resources.contains(required), "required pre.006 HTTP polling contract missing: {required}");
|
||||||
|
}
|
||||||
|
let source_impl = match resources.split_once("impl crate::RawTransactionIngestHttpBlockPollingSource {") {
|
||||||
|
std::option::Option::Some((_, tail)) => match tail.split_once("impl std::fmt::Debug for crate::RawTransactionIngestHttpBlockPollingSource") {
|
||||||
|
std::option::Option::Some((value, _)) => value,
|
||||||
|
std::option::Option::None => "",
|
||||||
|
},
|
||||||
|
std::option::Option::None => "",
|
||||||
|
};
|
||||||
|
assert_eq!(source_impl.matches("get_block_observed(").count(), 1);
|
||||||
|
for forbidden in [
|
||||||
|
"ksp_config_lib::",
|
||||||
|
"ksp_job_backfill_lib::",
|
||||||
|
"ksp_store_postgres_lib::",
|
||||||
|
"reqwest::",
|
||||||
|
"tokio_tungstenite::",
|
||||||
|
"tonic::",
|
||||||
|
"yellowstone_grpc_proto::",
|
||||||
|
"unbounded_channel",
|
||||||
|
] {
|
||||||
|
assert!(!source_impl.contains(forbidden) && !root.contains(forbidden), "pre.006 HTTP polling crossed a forbidden boundary: {forbidden}");
|
||||||
|
}
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
|
||||||
|
#[test]
|
||||||
|
fn v0_3_13_pre_003_standard_logs_source_reuses_transport_facades_and_common_hydration_only() {
|
||||||
|
let root = include_str!("../src/lib.rs");
|
||||||
|
let runtime = include_str!("../src/runtime.rs");
|
||||||
|
let resources = include_str!("../src/runtime_resources.rs");
|
||||||
|
for required in [
|
||||||
|
"RawTransactionIngestStandardLogsSource",
|
||||||
|
"SolanaStandardWsSession::connect",
|
||||||
|
".logs_subscribe(",
|
||||||
|
"SolanaLogsSubscribeFilter",
|
||||||
|
"SolanaCommitmentConfig::new",
|
||||||
|
"project_standard_logs_signal",
|
||||||
|
"RawTransactionIngestSourceFamily::Logs",
|
||||||
|
"logs_get_transaction",
|
||||||
|
"solana_ws_http",
|
||||||
|
"get_transaction_observed",
|
||||||
|
"RawTransactionIngestHydrationCoordinator::with_global_registry(",
|
||||||
|
"hydration_pending_limit,",
|
||||||
|
"hydration_in_flight_limit,",
|
||||||
|
"std::option::Option::Some(1)",
|
||||||
|
] {
|
||||||
|
assert!(resources.contains(required), "required pre.003 standard logs contract missing: {required}");
|
||||||
|
}
|
||||||
|
assert!(runtime.contains("run_live_sources"));
|
||||||
|
for forbidden in [
|
||||||
|
"ksp_config_lib::",
|
||||||
|
"ksp_job_backfill_lib::",
|
||||||
|
"ksp_store_postgres_lib::",
|
||||||
|
"reqwest::",
|
||||||
|
"tokio_tungstenite::",
|
||||||
|
"tonic::",
|
||||||
|
"yellowstone_grpc_proto::",
|
||||||
|
"unbounded_channel",
|
||||||
|
] {
|
||||||
|
assert!(
|
||||||
|
!runtime.contains(forbidden) && !resources.contains(forbidden) && !root.contains(forbidden),
|
||||||
|
"pre.003 crossed a forbidden boundary: {forbidden}",
|
||||||
|
);
|
||||||
|
}
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
|
||||||
|
#[test]
|
||||||
|
fn v0_3_13_pre_004_standard_block_source_is_direct_raw_and_transport_facade_only() {
|
||||||
|
let root = include_str!("../src/lib.rs");
|
||||||
|
let resources = include_str!("../src/runtime_resources.rs");
|
||||||
|
for required in [
|
||||||
|
"RawTransactionIngestStandardBlockSource",
|
||||||
|
"SolanaStandardWsSession::connect",
|
||||||
|
".block_subscribe(",
|
||||||
|
"SolanaBlockSubscribeConfig::new",
|
||||||
|
"SolanaTransactionEncoding::Base64",
|
||||||
|
"SolanaTransactionDetails::Full",
|
||||||
|
"std::option::Option::Some(1)",
|
||||||
|
"std::option::Option::Some(false)",
|
||||||
|
"build_standard_block_material",
|
||||||
|
"RawTransactionMaterial::binary_base64_with_embedded_signature",
|
||||||
|
"RawTransactionVersion::Number(1)",
|
||||||
|
"block_subscribe",
|
||||||
|
"source.standard_block_missing",
|
||||||
|
"source.standard_block_remote_error",
|
||||||
|
] {
|
||||||
|
assert!(resources.contains(required), "required pre.004 standard block contract missing: {required}");
|
||||||
|
}
|
||||||
|
for forbidden in [
|
||||||
|
"ksp_config_lib::",
|
||||||
|
"ksp_job_backfill_lib::",
|
||||||
|
"ksp_store_postgres_lib::",
|
||||||
|
"reqwest::",
|
||||||
|
"tokio_tungstenite::",
|
||||||
|
"tonic::",
|
||||||
|
"yellowstone_grpc_proto::",
|
||||||
|
"unbounded_channel",
|
||||||
|
] {
|
||||||
|
assert!(
|
||||||
|
!runtime_contains(forbidden) && !resources.contains(forbidden) && !root.contains(forbidden),
|
||||||
|
"pre.004 crossed a forbidden standard-block boundary: {forbidden}",
|
||||||
|
);
|
||||||
|
}
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
|
||||||
|
#[test]
|
||||||
|
fn v0_3_13_pre_005_helius_transaction_source_reuses_transport_facade_and_common_hydration_only() {
|
||||||
|
let root = include_str!("../src/lib.rs");
|
||||||
|
let runtime = include_str!("../src/runtime.rs");
|
||||||
|
let resources = include_str!("../src/runtime_resources.rs");
|
||||||
|
for required in [
|
||||||
|
"RawTransactionIngestHeliusTransactionSource",
|
||||||
|
"HeliusLaserStreamWsSession::connect",
|
||||||
|
".transaction_subscribe(",
|
||||||
|
"HeliusTransactionSubscribeOptions::new",
|
||||||
|
"HeliusTransactionSubscribeEncoding::Base64",
|
||||||
|
"SolanaTransactionDetails::Full",
|
||||||
|
"std::option::Option::Some(1)",
|
||||||
|
"project_helius_transaction_signal",
|
||||||
|
"helius_ws_http",
|
||||||
|
"get_transaction_observed",
|
||||||
|
"RawTransactionIngestHydrationCoordinator::with_global_registry(",
|
||||||
|
"hydration_pending_limit,",
|
||||||
|
"hydration_in_flight_limit,",
|
||||||
|
] {
|
||||||
|
assert!(resources.contains(required), "required pre.005 Helius transaction contract missing: {required}");
|
||||||
|
}
|
||||||
|
assert_eq!(resources.matches("get_transaction_observed(").count(), 1);
|
||||||
|
for forbidden in [
|
||||||
|
"ksp_config_lib::",
|
||||||
|
"ksp_job_backfill_lib::",
|
||||||
|
"ksp_store_postgres_lib::",
|
||||||
|
"reqwest::",
|
||||||
|
"tokio_tungstenite::",
|
||||||
|
"helius_sdk",
|
||||||
|
"unbounded_channel",
|
||||||
|
] {
|
||||||
|
assert!(
|
||||||
|
!runtime.contains(forbidden) && !resources.contains(forbidden) && !root.contains(forbidden),
|
||||||
|
"pre.005 crossed a forbidden Helius transaction boundary: {forbidden}",
|
||||||
|
);
|
||||||
|
}
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
|
||||||
|
fn runtime_contains(value: &str) -> bool {
|
||||||
|
return include_str!("../src/runtime.rs").contains(value);
|
||||||
|
}
|
||||||
|
|
||||||
#[test]
|
#[test]
|
||||||
fn v0_3_12_pre_006_source_surface_hardens_shutdown_and_faults_without_backend_edges() {
|
fn v0_3_12_pre_006_source_surface_hardens_shutdown_and_faults_without_backend_edges() {
|
||||||
let root = include_str!("../src/lib.rs");
|
let root = include_str!("../src/lib.rs");
|
||||||
@@ -321,6 +470,46 @@ fn manifest_dependency_names(section: &str) -> std::vec::Vec<&str> {
|
|||||||
return names;
|
return names;
|
||||||
}
|
}
|
||||||
|
|
||||||
|
#[test]
|
||||||
|
fn v0_3_13_pre_007_multi_source_supervisor_and_inventory_remain_private_bounded_and_source_neutral() {
|
||||||
|
let root = include_str!("../src/lib.rs");
|
||||||
|
let runtime = include_str!("../src/runtime.rs");
|
||||||
|
let resources = include_str!("../src/runtime_resources.rs");
|
||||||
|
for required in [
|
||||||
|
"RawTransactionIngestSourceInventory",
|
||||||
|
"RawTransactionIngestSourceInventoryPublisher",
|
||||||
|
"for (entry_index, source) in self.sources.into_iter().enumerate()",
|
||||||
|
"tokio::task::JoinSet::new()",
|
||||||
|
"supervise_live_source_tasks",
|
||||||
|
"drain_live_source_tasks",
|
||||||
|
"source_stop_sender.send_replace(true)",
|
||||||
|
"processing_frontier_sender.clone()",
|
||||||
|
"source.configured_source_closed",
|
||||||
|
] {
|
||||||
|
assert!(resources.contains(required), "required pre.007 multi-source supervisor contract missing: {required}");
|
||||||
|
}
|
||||||
|
assert!(runtime.contains("run_live_sources"));
|
||||||
|
assert!(!runtime.contains("validate_single_source_activation"));
|
||||||
|
assert!(!resources.contains("multi_source_activation_pending"));
|
||||||
|
for forbidden in [
|
||||||
|
"pub struct RawTransactionIngestSourceInventory",
|
||||||
|
"pub struct RawTransactionIngestSourceInventoryPublisher",
|
||||||
|
"unbounded_channel",
|
||||||
|
"ksp_config_lib::",
|
||||||
|
"ksp_job_backfill_lib::",
|
||||||
|
"ksp_store_postgres_lib::",
|
||||||
|
"reqwest::",
|
||||||
|
"tonic::",
|
||||||
|
"yellowstone_grpc_proto::",
|
||||||
|
] {
|
||||||
|
assert!(
|
||||||
|
!root.contains(forbidden) && !runtime.contains(forbidden) && !resources.contains(forbidden),
|
||||||
|
"pre.007 crossed a private/bounded boundary: {forbidden}"
|
||||||
|
);
|
||||||
|
}
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
|
||||||
#[test]
|
#[test]
|
||||||
fn v0_3_12_pre_007_processing_frontier_remains_run_local_and_backend_neutral_after_continuity_extension() {
|
fn v0_3_12_pre_007_processing_frontier_remains_run_local_and_backend_neutral_after_continuity_extension() {
|
||||||
let runtime = include_str!("../src/runtime.rs");
|
let runtime = include_str!("../src/runtime.rs");
|
||||||
@@ -385,3 +574,161 @@ fn v0_3_12_pre_008_worker_observes_transport_reconnect_replay_and_faults_only_on
|
|||||||
}
|
}
|
||||||
return;
|
return;
|
||||||
}
|
}
|
||||||
|
|
||||||
|
#[test]
|
||||||
|
fn v0_3_13_pre_008_cross_source_convergence_reuses_store_and_transport_facades_only() {
|
||||||
|
let root = include_str!("../src/lib.rs");
|
||||||
|
let persistence = include_str!("../src/persistence.rs");
|
||||||
|
let runtime = include_str!("../src/runtime.rs");
|
||||||
|
let resources = include_str!("../src/runtime_resources.rs");
|
||||||
|
for required in [
|
||||||
|
"RawTransactionIngestPersistenceConvergence",
|
||||||
|
"persist_raw_transaction_ingest_converged_acquisition",
|
||||||
|
"RawTransactionIngestPersistencePort",
|
||||||
|
"record_raw_transaction_observation",
|
||||||
|
"RawTransactionObservationWrite",
|
||||||
|
"payload().content_hash()",
|
||||||
|
"content_conflict_error()",
|
||||||
|
] {
|
||||||
|
assert!(persistence.contains(required) || root.contains(required), "required pre.008 persistence convergence contract missing: {required}");
|
||||||
|
}
|
||||||
|
for required in [
|
||||||
|
"RawTransactionIngestGlobalHydrationRegistry",
|
||||||
|
"fetch_hydration_shared",
|
||||||
|
"subscribe_or_lead",
|
||||||
|
"get_transaction_observed",
|
||||||
|
"settings.admission_queue_capacity()",
|
||||||
|
] {
|
||||||
|
assert!(resources.contains(required), "required pre.008 hydration convergence contract missing: {required}");
|
||||||
|
}
|
||||||
|
assert!(runtime.contains("settings.admission_queue_capacity().max(settings.persistence_concurrency())"));
|
||||||
|
for forbidden in ["ksp_store_postgres_lib::", "reqwest::", "tonic::", "yellowstone_grpc_proto::", "ksp_job_backfill_lib::", "unbounded_channel"] {
|
||||||
|
assert!(
|
||||||
|
!persistence.contains(forbidden) && !runtime.contains(forbidden) && !resources.contains(forbidden),
|
||||||
|
"pre.008 convergence crossed a dependency/boundedness boundary: {forbidden}"
|
||||||
|
);
|
||||||
|
}
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
|
||||||
|
#[test]
|
||||||
|
fn v0_3_13_pre_009_global_bounds_and_fairness_stay_inside_worker_facades() {
|
||||||
|
let admission = include_str!("../src/admission.rs");
|
||||||
|
let persistence = include_str!("../src/persistence.rs");
|
||||||
|
let resources = include_str!("../src/runtime_resources.rs");
|
||||||
|
for required in [
|
||||||
|
"validate_hydration_fairness_capacity",
|
||||||
|
"let hydration_pending_budget = settings.admission_queue_capacity();",
|
||||||
|
"let hydration_in_flight_budget = settings.persistence_concurrency();",
|
||||||
|
"hydration_pending_limit",
|
||||||
|
"hydration_in_flight_limit",
|
||||||
|
"tokio::sync::Semaphore",
|
||||||
|
"acquire_owned",
|
||||||
|
"RawTransactionIngestHydrationLeaderGuard",
|
||||||
|
"RawTransactionIngestCanonicalState",
|
||||||
|
"content_conflict_error()",
|
||||||
|
] {
|
||||||
|
assert!(
|
||||||
|
admission.contains(required) || persistence.contains(required) || resources.contains(required),
|
||||||
|
"required pre.009 global-bound contract missing: {required}"
|
||||||
|
);
|
||||||
|
}
|
||||||
|
for forbidden in [
|
||||||
|
"unbounded_channel",
|
||||||
|
"ksp_store_postgres_lib::",
|
||||||
|
"ksp_config_lib::",
|
||||||
|
"ksp_job_backfill_lib::",
|
||||||
|
"reqwest::",
|
||||||
|
"tokio_tungstenite::",
|
||||||
|
"tonic::",
|
||||||
|
"yellowstone_grpc_proto::",
|
||||||
|
] {
|
||||||
|
assert!(
|
||||||
|
!admission.contains(forbidden) && !persistence.contains(forbidden) && !resources.contains(forbidden),
|
||||||
|
"pre.009 crossed a Worker facade boundary: {forbidden}"
|
||||||
|
);
|
||||||
|
}
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
|
||||||
|
#[test]
|
||||||
|
fn v0_3_13_pre_010_multi_source_snapshot_health_remains_source_neutral_and_backend_free() {
|
||||||
|
let snapshot = include_str!("../src/snapshot.rs");
|
||||||
|
let resources = include_str!("../src/runtime_resources.rs");
|
||||||
|
for required in ["source_total", "source_active", "source_reconnecting", "source_failed", "WorkerHealth::Degraded", "with_source_counts"] {
|
||||||
|
assert!(snapshot.contains(required) || resources.contains(required), "required pre.010 source-neutral snapshot contract missing: {required}");
|
||||||
|
}
|
||||||
|
for forbidden in ["ksp_store_postgres_lib::", "reqwest::", "tonic::", "yellowstone_grpc_proto::", "SourceSnapshotByKey", "provider_health"] {
|
||||||
|
assert!(!snapshot.contains(forbidden), "pre.010 snapshot crossed source-neutral/backend boundary: {forbidden}");
|
||||||
|
}
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
|
||||||
|
#[test]
|
||||||
|
fn v0_3_13_pre_011_shutdown_race_hardening_stays_inside_worker_and_existing_facades() {
|
||||||
|
let runtime = include_str!("../src/runtime.rs");
|
||||||
|
let resources = include_str!("../src/runtime_resources.rs");
|
||||||
|
for required in [
|
||||||
|
"tokio::time::timeout(settings.shutdown_drain_timeout(), drain).await",
|
||||||
|
"persistence.abort_all()",
|
||||||
|
"children.abort_all()",
|
||||||
|
"while persistence.join_next().await.is_some() {}",
|
||||||
|
"while children.join_next().await.is_some() {}",
|
||||||
|
"ERROR_CODE_RAW_TRANSACTION_INGEST_COUNTER_EXHAUSTED",
|
||||||
|
] {
|
||||||
|
assert!(runtime.contains(required), "required pre.011 runtime shutdown guard missing: {required}");
|
||||||
|
}
|
||||||
|
for required in [
|
||||||
|
"RawTransactionIngestHydrationLeaderGuard",
|
||||||
|
"publish_and_remove",
|
||||||
|
"pending.remove(key)",
|
||||||
|
"source.inventory_key_mismatch",
|
||||||
|
"checked_add(projection.hydration_pending())",
|
||||||
|
"checked_add(projection.source_reconnect_total())",
|
||||||
|
] {
|
||||||
|
assert!(resources.contains(required), "required pre.011 source-race guard missing: {required}");
|
||||||
|
}
|
||||||
|
for forbidden in [
|
||||||
|
"unbounded_channel",
|
||||||
|
"ksp_store_postgres_lib::",
|
||||||
|
"ksp_config_lib::",
|
||||||
|
"ksp_job_backfill_lib::",
|
||||||
|
"reqwest::",
|
||||||
|
"tokio_tungstenite::",
|
||||||
|
"tonic::",
|
||||||
|
"yellowstone_grpc_proto::",
|
||||||
|
] {
|
||||||
|
assert!(!runtime.contains(forbidden) && !resources.contains(forbidden), "pre.011 crossed a Worker/facade boundary: {forbidden}");
|
||||||
|
}
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
|
||||||
|
#[test]
|
||||||
|
fn v0_3_13_pre_012_cross_layer_closure_does_not_expand_worker_dependency_graph() {
|
||||||
|
let manifest = include_str!("../Cargo.toml");
|
||||||
|
let dependencies = dependency_section(manifest);
|
||||||
|
let names = manifest_dependency_names(dependencies);
|
||||||
|
assert_eq!(
|
||||||
|
names,
|
||||||
|
vec![
|
||||||
|
"ksp-core-lib",
|
||||||
|
"ksp-logging-lib",
|
||||||
|
"ksp-onchain-transport-lib",
|
||||||
|
"ksp-raw-transaction-lib",
|
||||||
|
"ksp-store-lib",
|
||||||
|
"ksp-worker-api",
|
||||||
|
"sha2",
|
||||||
|
"tokio",
|
||||||
|
],
|
||||||
|
);
|
||||||
|
let cross_layer = include_str!("cross_layer_completeness.rs");
|
||||||
|
for required in [
|
||||||
|
"v0_3_13_pre_012_all_five_live_source_families_share_one_worker_common_raw_store_pipeline",
|
||||||
|
"v0_3_13_pre_012_legacy_v0_v1_is_proven_from_transport_through_worker_common_raw_to_store",
|
||||||
|
"v0_3_13_pre_012_yellowstone_non_regression_covers_identity_v1_reconnect_gap_and_worker_hydration",
|
||||||
|
"v0_3_13_pre_012_security_redaction_matrix_covers_all_live_sources_and_lower_layers",
|
||||||
|
] {
|
||||||
|
assert!(cross_layer.contains(required), "pre.012 cross-layer closure proof missing: {required}");
|
||||||
|
}
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
|||||||
@@ -1,7 +1,7 @@
|
|||||||
// file: crates/ksp-worker-raw-transaction-ingest-lib/tests/hardening.rs
|
// file: crates/ksp-worker-raw-transaction-ingest-lib/tests/hardening.rs
|
||||||
// version: 11
|
// version: 24
|
||||||
|
|
||||||
//! External public, security, redaction and release-boundary hardening canaries for `pre.010`.
|
//! External public, security, redaction and release-boundary hardening canaries through `pre.012`.
|
||||||
|
|
||||||
fn network(value: &'static str) -> std::option::Option<ksp_store_lib::RawNetworkId> {
|
fn network(value: &'static str) -> std::option::Option<ksp_store_lib::RawNetworkId> {
|
||||||
let result = ksp_store_lib::RawNetworkId::new(value);
|
let result = ksp_store_lib::RawNetworkId::new(value);
|
||||||
@@ -159,7 +159,15 @@ fn pre_010_source_visibility_contract_uses_crate_root_for_shared_items() {
|
|||||||
(include_str!("../src/runtime.rs"), &["RawTransactionIngestHandle", "RawTransactionIngestWorker"]),
|
(include_str!("../src/runtime.rs"), &["RawTransactionIngestHandle", "RawTransactionIngestWorker"]),
|
||||||
(include_str!("../src/snapshot.rs"), &["RawTransactionIngestSnapshot", "RawTransactionIngestSnapshotSource"]),
|
(include_str!("../src/snapshot.rs"), &["RawTransactionIngestSnapshot", "RawTransactionIngestSnapshotSource"]),
|
||||||
(include_str!("../src/persistence.rs"), &["RawTransactionIngestPersistenceOutcome", "RawTransactionIngestPersistencePort"]),
|
(include_str!("../src/persistence.rs"), &["RawTransactionIngestPersistenceOutcome", "RawTransactionIngestPersistencePort"]),
|
||||||
(include_str!("../src/runtime_resources.rs"), &["RawTransactionIngestYellowstoneSource", "RawTransactionIngestRuntimeResources"]),
|
(
|
||||||
|
include_str!("../src/runtime_resources.rs"),
|
||||||
|
&[
|
||||||
|
"RawTransactionIngestStandardBlockSource",
|
||||||
|
"RawTransactionIngestStandardLogsSource",
|
||||||
|
"RawTransactionIngestYellowstoneSource",
|
||||||
|
"RawTransactionIngestRuntimeResources",
|
||||||
|
],
|
||||||
|
),
|
||||||
];
|
];
|
||||||
for (source, symbols) in source_contracts {
|
for (source, symbols) in source_contracts {
|
||||||
for symbol in symbols {
|
for symbol in symbols {
|
||||||
@@ -207,8 +215,6 @@ fn pre_010_production_surface_has_no_historical_backfill_or_retriever_contract()
|
|||||||
"backfill",
|
"backfill",
|
||||||
"Checkpoint",
|
"Checkpoint",
|
||||||
"checkpoint",
|
"checkpoint",
|
||||||
"Discovery",
|
|
||||||
"discovery",
|
|
||||||
"historical",
|
"historical",
|
||||||
] {
|
] {
|
||||||
assert!(!source.contains(forbidden), "historical/retriever surface leaked into Worker production source: {forbidden}");
|
assert!(!source.contains(forbidden), "historical/retriever surface leaked into Worker production source: {forbidden}");
|
||||||
@@ -317,7 +323,8 @@ fn v0_3_12_pre_003_private_signal_debug_and_shape_do_not_expose_signature_filter
|
|||||||
fn v0_3_12_pre_004_hydration_provenance_and_remote_material_are_bounded_and_redacted() {
|
fn v0_3_12_pre_004_hydration_provenance_and_remote_material_are_bounded_and_redacted() {
|
||||||
let resources = include_str!("../src/runtime_resources.rs");
|
let resources = include_str!("../src/runtime_resources.rs");
|
||||||
for required in [
|
for required in [
|
||||||
"ys.{}:http.{}",
|
"route_prefix",
|
||||||
|
"{}.{}:http.{}",
|
||||||
"composite_provider_unrepresentable",
|
"composite_provider_unrepresentable",
|
||||||
"composite_endpoint_unrepresentable",
|
"composite_endpoint_unrepresentable",
|
||||||
"RawAcquisitionOrigin::Live",
|
"RawAcquisitionOrigin::Live",
|
||||||
@@ -390,8 +397,8 @@ fn v0_3_12_pre_006_runtime_resource_contract_opens_one_supervised_transport_sour
|
|||||||
assert!(resources.contains(required), "productive runtime-resource source behavior missing: {required}");
|
assert!(resources.contains(required), "productive runtime-resource source behavior missing: {required}");
|
||||||
}
|
}
|
||||||
assert!(runtime.contains("start_with_runtime_resources"));
|
assert!(runtime.contains("start_with_runtime_resources"));
|
||||||
assert!(runtime.contains("source.run(source_settings, stop_receiver, admission_sender, processing_frontier_sender)"));
|
assert!(runtime.contains("run_live_sources(source_settings, stop_receiver, admission_sender, processing_frontier_sender)"));
|
||||||
for forbidden in ["get_block_observed", "ksp_config_lib::", "ksp_store_postgres_lib::", "reqwest::", "tonic::", "yellowstone_grpc_proto::"] {
|
for forbidden in ["ksp_config_lib::", "ksp_store_postgres_lib::", "reqwest::", "tonic::", "yellowstone_grpc_proto::"] {
|
||||||
assert!(!resources.contains(forbidden) && !runtime.contains(forbidden), "pre.006 runtime source crossed a forbidden boundary: {forbidden}");
|
assert!(!resources.contains(forbidden) && !runtime.contains(forbidden), "pre.006 runtime source crossed a forbidden boundary: {forbidden}");
|
||||||
}
|
}
|
||||||
return;
|
return;
|
||||||
@@ -401,8 +408,11 @@ fn v0_3_12_pre_006_runtime_resource_contract_opens_one_supervised_transport_sour
|
|||||||
fn v0_3_12_pre_006_source_coalescence_is_bounded_stop_preemptible_and_redacted() {
|
fn v0_3_12_pre_006_source_coalescence_is_bounded_stop_preemptible_and_redacted() {
|
||||||
let resources = include_str!("../src/runtime_resources.rs");
|
let resources = include_str!("../src/runtime_resources.rs");
|
||||||
for required in [
|
for required in [
|
||||||
"max_in_flight: settings.persistence_concurrency()",
|
"max_in_flight: usize",
|
||||||
"max_pending_signals: crate::MAX_RAW_TRANSACTION_INGEST_ADMISSION_QUEUE_CAPACITY",
|
"max_pending_signals: usize",
|
||||||
|
"RawTransactionIngestHydrationCoordinator::with_global_registry(",
|
||||||
|
"hydration_pending_limit,",
|
||||||
|
"hydration_in_flight_limit,",
|
||||||
"pending_signal_count",
|
"pending_signal_count",
|
||||||
"stop_receiver.changed()",
|
"stop_receiver.changed()",
|
||||||
"tasks.abort_all()",
|
"tasks.abort_all()",
|
||||||
@@ -523,6 +533,168 @@ fn v0_3_12_pre_008_reconnect_projection_is_source_neutral_bounded_and_contains_n
|
|||||||
return;
|
return;
|
||||||
}
|
}
|
||||||
|
|
||||||
|
#[test]
|
||||||
|
fn v0_3_13_pre_003_standard_logs_redaction_and_reference_only_contract_are_explicit() {
|
||||||
|
let resources = include_str!("../src/runtime_resources.rs");
|
||||||
|
for required in [
|
||||||
|
"RawTransactionIngestStandardLogsSource",
|
||||||
|
".field(\"filter_kind\"",
|
||||||
|
".field(\"filter_fingerprint_bytes\"",
|
||||||
|
".field(\"source_key_bytes\"",
|
||||||
|
"project_standard_logs_signal",
|
||||||
|
"matched_filter_count: 1",
|
||||||
|
"transaction_index: std::option::Option::None",
|
||||||
|
"created_at: std::option::Option::None",
|
||||||
|
] {
|
||||||
|
assert!(resources.contains(required), "required pre.003 redaction/reference guard missing: {required}");
|
||||||
|
}
|
||||||
|
let source_struct = match resources.split_once("pub struct RawTransactionIngestStandardLogsSource {") {
|
||||||
|
std::option::Option::Some((_, tail)) => match tail.split_once("impl crate::RawTransactionIngestStandardLogsSource") {
|
||||||
|
std::option::Option::Some((value, _)) => value,
|
||||||
|
std::option::Option::None => "",
|
||||||
|
},
|
||||||
|
std::option::Option::None => "",
|
||||||
|
};
|
||||||
|
assert!(source_struct.contains("filter: ksp_onchain_transport_lib::SolanaLogsSubscribeFilter"));
|
||||||
|
for forbidden in ["logs:", "err:", "payload:", "body:", "url:"] {
|
||||||
|
assert!(!source_struct.contains(forbidden), "remote/sensitive material stored in standard logs source: {forbidden}");
|
||||||
|
}
|
||||||
|
let projection = match resources.split_once("fn project_standard_logs_signal") {
|
||||||
|
std::option::Option::Some((_, tail)) => match tail.split_once("fn route_yellowstone_update") {
|
||||||
|
std::option::Option::Some((value, _)) => value,
|
||||||
|
std::option::Option::None => "",
|
||||||
|
},
|
||||||
|
std::option::Option::None => "",
|
||||||
|
};
|
||||||
|
for forbidden in [".logs()", ".err()"] {
|
||||||
|
assert!(!projection.contains(forbidden), "logs/error material copied into standard logs projection: {forbidden}");
|
||||||
|
}
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
|
||||||
|
#[test]
|
||||||
|
fn v0_3_13_pre_004_standard_block_redaction_version_and_null_guards_are_explicit() {
|
||||||
|
let resources = include_str!("../src/runtime_resources.rs");
|
||||||
|
for required in [
|
||||||
|
"RawTransactionIngestStandardBlockSource",
|
||||||
|
".field(\"filter_kind\"",
|
||||||
|
".field(\"filter_fingerprint_bytes\"",
|
||||||
|
".field(\"source_key_bytes\"",
|
||||||
|
"source.standard_block_context_slot_mismatch",
|
||||||
|
"source.standard_block_remote_error",
|
||||||
|
"source.standard_block_missing",
|
||||||
|
"source.standard_block_transactions_missing",
|
||||||
|
"source.standard_block_transaction_version_unsupported",
|
||||||
|
"source.standard_block_transaction_version_unqualified",
|
||||||
|
"SolanaTransactionVersion::Number(0)",
|
||||||
|
"SolanaTransactionVersion::Number(1)",
|
||||||
|
] {
|
||||||
|
assert!(resources.contains(required), "required pre.004 standard block hardening guard missing: {required}");
|
||||||
|
}
|
||||||
|
let source_struct = match resources.split_once("pub struct RawTransactionIngestStandardBlockSource {") {
|
||||||
|
std::option::Option::Some((_, tail)) => match tail.split_once("impl crate::RawTransactionIngestStandardBlockSource") {
|
||||||
|
std::option::Option::Some((value, _)) => value,
|
||||||
|
std::option::Option::None => "",
|
||||||
|
},
|
||||||
|
std::option::Option::None => "",
|
||||||
|
};
|
||||||
|
for forbidden in ["err:", "block:", "transaction_data:", "url:"] {
|
||||||
|
assert!(!source_struct.contains(forbidden), "remote/raw material stored in standard block source: {forbidden}");
|
||||||
|
}
|
||||||
|
let source_impl = match resources.split_once("impl crate::RawTransactionIngestStandardBlockSource {") {
|
||||||
|
std::option::Option::Some((_, tail)) => match tail.split_once("impl std::fmt::Debug for crate::RawTransactionIngestStandardBlockSource") {
|
||||||
|
std::option::Option::Some((value, _)) => value,
|
||||||
|
std::option::Option::None => "",
|
||||||
|
},
|
||||||
|
std::option::Option::None => "",
|
||||||
|
};
|
||||||
|
assert!(!source_impl.contains("observe_pending("), "direct Standard Block source must not inflate hydration_pending");
|
||||||
|
assert!(source_impl.contains("processing_frontier.observe_settled(slot)"));
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
|
||||||
|
#[test]
|
||||||
|
fn v0_3_13_pre_005_helius_transaction_redaction_full_reference_and_tier_neutrality_are_explicit() {
|
||||||
|
let resources = include_str!("../src/runtime_resources.rs");
|
||||||
|
for required in [
|
||||||
|
"RawTransactionIngestHeliusTransactionSource",
|
||||||
|
".field(\"filter\"",
|
||||||
|
".field(\"filter_fingerprint_bytes\"",
|
||||||
|
".field(\"source_key_bytes\"",
|
||||||
|
"HeliusTransactionNotification::Full(value)",
|
||||||
|
"source.helius_transaction_notification_unqualified",
|
||||||
|
"project_helius_transaction_signal",
|
||||||
|
"transaction_index: std::option::Option::Some(response.transaction_index())",
|
||||||
|
"RAW_TRANSACTION_INGEST_HELIUS_TRANSACTION_HTTP_PROTOCOL",
|
||||||
|
] {
|
||||||
|
assert!(resources.contains(required), "required pre.005 Helius hardening guard missing: {required}");
|
||||||
|
}
|
||||||
|
let source_struct = match resources.split_once("pub struct RawTransactionIngestHeliusTransactionSource {") {
|
||||||
|
std::option::Option::Some((_, tail)) => match tail.split_once("impl crate::RawTransactionIngestHeliusTransactionSource") {
|
||||||
|
std::option::Option::Some((value, _)) => value,
|
||||||
|
std::option::Option::None => "",
|
||||||
|
},
|
||||||
|
std::option::Option::None => "",
|
||||||
|
};
|
||||||
|
for forbidden in ["url:", "api_key", "credential", "transaction:", "payload:", "tier:"] {
|
||||||
|
assert!(!source_struct.contains(forbidden), "sensitive/provider material stored in Helius transaction source: {forbidden}");
|
||||||
|
}
|
||||||
|
let projection = match resources.split_once("fn project_helius_transaction_signal") {
|
||||||
|
std::option::Option::Some((_, tail)) => match tail.split_once("trait RawTransactionIngestStandardLogsView") {
|
||||||
|
std::option::Option::Some((value, _)) => value,
|
||||||
|
std::option::Option::None => "",
|
||||||
|
},
|
||||||
|
std::option::Option::None => "",
|
||||||
|
};
|
||||||
|
assert!(!projection.contains(".transaction()"), "Helius nested full payload must not enter Worker projection");
|
||||||
|
for forbidden in ["Developer", "Business", "Professional", "paid_tier", "provider_tier"] {
|
||||||
|
assert!(!resources.contains(forbidden), "provider tier must not be coded in Worker: {forbidden}");
|
||||||
|
}
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
|
||||||
|
#[test]
|
||||||
|
fn v0_3_13_pre_006_http_block_polling_is_bounded_run_local_stop_preemptible_and_redacted() {
|
||||||
|
let resources = include_str!("../src/runtime_resources.rs");
|
||||||
|
for required in [
|
||||||
|
"DEFAULT_RAW_TRANSACTION_INGEST_HTTP_POLL_INTERVAL",
|
||||||
|
"DEFAULT_RAW_TRANSACTION_INGEST_HTTP_POLL_MAX_BLOCKS_PER_CYCLE",
|
||||||
|
"MIN_RAW_TRANSACTION_INGEST_HTTP_POLL_INTERVAL",
|
||||||
|
"MAX_RAW_TRANSACTION_INGEST_HTTP_POLL_INTERVAL",
|
||||||
|
"MIN_RAW_TRANSACTION_INGEST_HTTP_POLL_MAX_BLOCKS_PER_CYCLE",
|
||||||
|
"MAX_RAW_TRANSACTION_INGEST_HTTP_POLL_MAX_BLOCKS_PER_CYCLE",
|
||||||
|
"let mut next_scan_slot = start_slot",
|
||||||
|
"next_scan_slot = slot",
|
||||||
|
"tokio::time::sleep(self.poll_interval)",
|
||||||
|
"processing_frontier.observe_settled(slot)",
|
||||||
|
"source.http_block_polling_transaction_version_unqualified",
|
||||||
|
"source.http_block_polling_transaction_version_unsupported",
|
||||||
|
] {
|
||||||
|
assert!(resources.contains(required), "required pre.006 HTTP polling hardening guard missing: {required}");
|
||||||
|
}
|
||||||
|
let source_impl = match resources.split_once("impl crate::RawTransactionIngestHttpBlockPollingSource {") {
|
||||||
|
std::option::Option::Some((_, tail)) => match tail.split_once("impl std::fmt::Debug for crate::RawTransactionIngestHttpBlockPollingSource") {
|
||||||
|
std::option::Option::Some((value, _)) => value,
|
||||||
|
std::option::Option::None => "",
|
||||||
|
},
|
||||||
|
std::option::Option::None => "",
|
||||||
|
};
|
||||||
|
assert_eq!(source_impl.matches("get_block_observed(").count(), 1);
|
||||||
|
assert!(!source_impl.contains("tokio::spawn"), "HTTP polling must not spawn one task per tick");
|
||||||
|
assert!(!source_impl.contains("observe_pending("), "HTTP block polling is direct RAW and must not inflate hydration_pending");
|
||||||
|
let source_struct = match resources.split_once("pub struct RawTransactionIngestHttpBlockPollingSource {") {
|
||||||
|
std::option::Option::Some((_, tail)) => match tail.split_once("impl crate::RawTransactionIngestHttpBlockPollingSource") {
|
||||||
|
std::option::Option::Some((value, _)) => value,
|
||||||
|
std::option::Option::None => "",
|
||||||
|
},
|
||||||
|
std::option::Option::None => "",
|
||||||
|
};
|
||||||
|
for forbidden in ["url:", "api_key", "credential", "secret", "transaction:", "payload:", "tier:"] {
|
||||||
|
assert!(!source_struct.contains(forbidden), "sensitive/raw material stored in HTTP polling source: {forbidden}");
|
||||||
|
}
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
|
||||||
#[test]
|
#[test]
|
||||||
fn v0_3_12_pre_009_hydration_retry_ownership_and_no_orphan_cleanup_are_explicit() {
|
fn v0_3_12_pre_009_hydration_retry_ownership_and_no_orphan_cleanup_are_explicit() {
|
||||||
let resources = include_str!("../src/runtime_resources.rs");
|
let resources = include_str!("../src/runtime_resources.rs");
|
||||||
@@ -536,8 +708,252 @@ fn v0_3_12_pre_009_hydration_retry_ownership_and_no_orphan_cleanup_are_explicit(
|
|||||||
] {
|
] {
|
||||||
assert!(resources.contains(required), "required pre.009 no-orphan/backpressure guard missing: {required}");
|
assert!(resources.contains(required), "required pre.009 no-orphan/backpressure guard missing: {required}");
|
||||||
}
|
}
|
||||||
for forbidden in ["tokio::time::sleep", "tokio::time::interval", "get_block_observed", "unbounded_channel"] {
|
let hydration = match resources.split_once("struct RawTransactionIngestHydrationCoordinator {") {
|
||||||
assert!(!resources.contains(forbidden), "Worker introduced forbidden retry/unbounded behavior: {forbidden}");
|
std::option::Option::Some((_, tail)) => match tail.split_once("fn hydration_method_code(") {
|
||||||
|
std::option::Option::Some((value, _)) => value,
|
||||||
|
std::option::Option::None => "",
|
||||||
|
},
|
||||||
|
std::option::Option::None => "",
|
||||||
|
};
|
||||||
|
for forbidden in ["tokio::time::sleep", "tokio::time::interval", "get_block_observed"] {
|
||||||
|
assert!(!hydration.contains(forbidden), "hydration coordinator introduced forbidden retry behavior: {forbidden}");
|
||||||
|
}
|
||||||
|
assert!(!resources.contains("unbounded_channel"), "Worker introduced an unbounded channel");
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
|
||||||
|
#[test]
|
||||||
|
fn v0_3_13_pre_007_multi_source_supervisor_is_fail_closed_joined_and_does_not_publish_source_identity() {
|
||||||
|
let root = include_str!("../src/lib.rs");
|
||||||
|
let resources = include_str!("../src/runtime_resources.rs");
|
||||||
|
for required in [
|
||||||
|
"MAX_RAW_TRANSACTION_INGEST_LIVE_SOURCES",
|
||||||
|
"RawTransactionIngestSourceInventory",
|
||||||
|
"std::sync::Mutex",
|
||||||
|
"tokio::task::JoinSet",
|
||||||
|
"source.configured_source_closed",
|
||||||
|
"source.task_join_failed",
|
||||||
|
"source_stop_sender.send_replace(true)",
|
||||||
|
"drain_live_source_tasks",
|
||||||
|
"processing_frontier_slot = std::option::Option::None",
|
||||||
|
"saturating_add",
|
||||||
|
] {
|
||||||
|
assert!(resources.contains(required), "required pre.007 supervisor hardening guard missing: {required}");
|
||||||
|
}
|
||||||
|
for forbidden in [
|
||||||
|
"pub struct RawTransactionIngestSourceInventory",
|
||||||
|
"pub struct RawTransactionIngestSourceInventoryPublisher",
|
||||||
|
"pub fn source_key(",
|
||||||
|
"source_keys:",
|
||||||
|
"unbounded_channel",
|
||||||
|
"primary_source",
|
||||||
|
"standby_source",
|
||||||
|
"first_provider_wins",
|
||||||
|
] {
|
||||||
|
assert!(!root.contains(forbidden), "private source identity/scheduling policy leaked into public root: {forbidden}");
|
||||||
|
}
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
|
||||||
|
#[test]
|
||||||
|
fn v0_3_13_pre_008_cross_source_convergence_is_bounded_conflict_checked_and_private() {
|
||||||
|
let root = include_str!("../src/lib.rs");
|
||||||
|
let persistence = include_str!("../src/persistence.rs");
|
||||||
|
let resources = include_str!("../src/runtime_resources.rs");
|
||||||
|
for required in [
|
||||||
|
"max_entries: usize",
|
||||||
|
"entries.len() >= self.max_entries",
|
||||||
|
"std::sync::Arc::strong_count(entry) == 1",
|
||||||
|
"known_state_value != &canonical_state",
|
||||||
|
"record_observation(observation)",
|
||||||
|
"persistence.additional_observation_not_recorded",
|
||||||
|
] {
|
||||||
|
assert!(persistence.contains(required), "required pre.008 persistence hardening guard missing: {required}");
|
||||||
|
}
|
||||||
|
for required in [
|
||||||
|
"max_pending: usize",
|
||||||
|
"pending.len() >= self.max_pending",
|
||||||
|
"source.global_hydration_pending_saturated",
|
||||||
|
"tokio::sync::watch::channel",
|
||||||
|
"publish_and_remove",
|
||||||
|
] {
|
||||||
|
assert!(resources.contains(required), "required pre.008 hydration hardening guard missing: {required}");
|
||||||
|
}
|
||||||
|
for forbidden in [
|
||||||
|
"pub struct RawTransactionIngestPersistenceConvergence",
|
||||||
|
"pub struct RawTransactionIngestGlobalHydrationRegistry",
|
||||||
|
"pub fn persist_raw_transaction_ingest_converged_acquisition",
|
||||||
|
] {
|
||||||
|
assert!(!root.contains(forbidden), "pre.008 private convergence implementation leaked publicly: {forbidden}");
|
||||||
|
}
|
||||||
|
assert!(!resources.contains("unbounded_channel"));
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
|
||||||
|
#[test]
|
||||||
|
fn v0_3_13_pre_009_duplicate_storm_disagreement_and_starvation_guards_are_explicit() {
|
||||||
|
let admission = include_str!("../src/admission.rs");
|
||||||
|
let persistence = include_str!("../src/persistence.rs");
|
||||||
|
let resources = include_str!("../src/runtime_resources.rs");
|
||||||
|
for required in [
|
||||||
|
"runtime_resources.hydration_pending_capacity_insufficient",
|
||||||
|
"runtime_resources.hydration_concurrency_insufficient",
|
||||||
|
"base + usize::from(hydration_entry_index < remainder)",
|
||||||
|
"hydration_in_flight_limit",
|
||||||
|
"tokio::sync::Semaphore::new(max_in_flight)",
|
||||||
|
"RawTransactionIngestHydrationLeaderGuard",
|
||||||
|
"source.global_hydration_pending_saturated",
|
||||||
|
"block_time: transaction.block_time()",
|
||||||
|
"slot: transaction.slot()",
|
||||||
|
"content_hash: transaction.payload().content_hash()",
|
||||||
|
] {
|
||||||
|
assert!(
|
||||||
|
admission.contains(required) || persistence.contains(required) || resources.contains(required),
|
||||||
|
"required pre.009 adversarial guard missing: {required}"
|
||||||
|
);
|
||||||
|
}
|
||||||
|
for forbidden in [
|
||||||
|
"VecDeque::new()",
|
||||||
|
"unbounded_channel",
|
||||||
|
"first_provider_wins",
|
||||||
|
"provider_priority",
|
||||||
|
"majority_vote",
|
||||||
|
"preferred_provider",
|
||||||
|
"overwrite_conflict",
|
||||||
|
] {
|
||||||
|
assert!(
|
||||||
|
!admission.contains(forbidden) && !persistence.contains(forbidden) && !resources.contains(forbidden),
|
||||||
|
"pre.009 introduced forbidden unbounded/provider-preference behavior: {forbidden}"
|
||||||
|
);
|
||||||
|
}
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
|
||||||
|
#[test]
|
||||||
|
fn v0_3_13_pre_010_multi_source_health_is_conservative_counted_and_redacted() {
|
||||||
|
let snapshot = include_str!("../src/snapshot.rs");
|
||||||
|
let resources = include_str!("../src/runtime_resources.rs");
|
||||||
|
for required in [
|
||||||
|
"source_total: usize",
|
||||||
|
"source_active: usize",
|
||||||
|
"source_reconnecting: usize",
|
||||||
|
"source_failed: usize",
|
||||||
|
"source_reconnecting > 0",
|
||||||
|
"source_failed > 0",
|
||||||
|
"source_active < source_total",
|
||||||
|
"WorkerHealth::Degraded",
|
||||||
|
"WorkerHealth::Unhealthy",
|
||||||
|
] {
|
||||||
|
assert!(snapshot.contains(required), "required pre.010 health guard missing: {required}");
|
||||||
|
}
|
||||||
|
for required in ["source_total = self.source_projections.len()", "with_source_counts(source_total, source_active, source_reconnecting, source_failed)"] {
|
||||||
|
assert!(resources.contains(required), "required pre.010 inventory count guard missing: {required}");
|
||||||
|
}
|
||||||
|
for forbidden in ["source_key: [u8; 32]", "provider_url", "endpoint_url", "filter_fingerprint", "credential", "api_key", "token_header"] {
|
||||||
|
assert!(!snapshot.contains(forbidden), "pre.010 snapshot leaks source/provider material: {forbidden}");
|
||||||
|
}
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
|
||||||
|
#[test]
|
||||||
|
fn v0_3_13_pre_011_shutdown_races_are_bounded_joined_atomic_and_counter_safe() {
|
||||||
|
let runtime = include_str!("../src/runtime.rs");
|
||||||
|
let resources = include_str!("../src/runtime_resources.rs");
|
||||||
|
let supervisor = match runtime.split_once("async fn run_supervisor<Spawner>(") {
|
||||||
|
std::option::Option::Some((_, tail)) => match tail.split_once("fn spawn_persistence(") {
|
||||||
|
std::option::Option::Some((value, _)) => value,
|
||||||
|
std::option::Option::None => "",
|
||||||
|
},
|
||||||
|
std::option::Option::None => "",
|
||||||
|
};
|
||||||
|
let active_shutdown = match supervisor.split_once("let mut fault = supervise_until_stop(") {
|
||||||
|
std::option::Option::Some((_, value)) => value,
|
||||||
|
std::option::Option::None => "",
|
||||||
|
};
|
||||||
|
let stop_position = active_shutdown.find("source_stop_sender.send_replace(true);");
|
||||||
|
let stopping_position = active_shutdown.find("begin_stopping(");
|
||||||
|
let drain_position = active_shutdown.find("drain_owned_work(");
|
||||||
|
let terminal_position = active_shutdown.find("match fault {");
|
||||||
|
assert!(matches!((stop_position, stopping_position), (std::option::Option::Some(stop), std::option::Option::Some(stopping)) if stop < stopping));
|
||||||
|
assert!(matches!((stopping_position, drain_position), (std::option::Option::Some(stopping), std::option::Option::Some(drain)) if stopping < drain));
|
||||||
|
assert!(matches!((drain_position, terminal_position), (std::option::Option::Some(drain), std::option::Option::Some(terminal)) if drain < terminal));
|
||||||
|
for required in [
|
||||||
|
"tokio::time::timeout(settings.shutdown_drain_timeout(), drain).await",
|
||||||
|
"persistence.abort_all()",
|
||||||
|
"children.abort_all()",
|
||||||
|
"while persistence.join_next().await.is_some() {}",
|
||||||
|
"while children.join_next().await.is_some() {}",
|
||||||
|
] {
|
||||||
|
assert!(runtime.contains(required), "required pre.011 bounded-drain guard missing: {required}");
|
||||||
|
}
|
||||||
|
let registry_publish = match resources.split_once("fn publish_and_remove(&self, key: &RawTransactionIngestHydrationKey") {
|
||||||
|
std::option::Option::Some((_, tail)) => match tail.split_once("type RawTransactionIngestHydrationTasks") {
|
||||||
|
std::option::Option::Some((value, _)) => value,
|
||||||
|
std::option::Option::None => "",
|
||||||
|
},
|
||||||
|
std::option::Option::None => "",
|
||||||
|
};
|
||||||
|
let notify_position = registry_publish.find("sender.send_replace(std::option::Option::Some(result));");
|
||||||
|
let remove_position = registry_publish.find("pending.remove(key);");
|
||||||
|
assert!(matches!((notify_position, remove_position), (std::option::Option::Some(notify), std::option::Option::Some(remove)) if notify < remove));
|
||||||
|
let inventory = match resources.split_once("impl RawTransactionIngestSourceInventory {") {
|
||||||
|
std::option::Option::Some((_, tail)) => match tail.split_once("impl RawTransactionIngestSourceInventoryPublisher") {
|
||||||
|
std::option::Option::Some((value, _)) => value,
|
||||||
|
std::option::Option::None => "",
|
||||||
|
},
|
||||||
|
std::option::Option::None => "",
|
||||||
|
};
|
||||||
|
for required in [
|
||||||
|
"checked_add(projection.hydration_pending())",
|
||||||
|
"checked_add(projection.source_continuity_gap_total())",
|
||||||
|
"checked_add(projection.source_reconnect_total())",
|
||||||
|
"checked_add(projection.source_replay_attempt_total())",
|
||||||
|
"source.inventory_entry_missing",
|
||||||
|
"source.inventory_key_mismatch",
|
||||||
|
"source.inventory_projection_missing",
|
||||||
|
] {
|
||||||
|
assert!(inventory.contains(required), "required pre.011 inventory guard missing: {required}");
|
||||||
|
}
|
||||||
|
assert!(!inventory.contains("saturating_add"), "pre.011 source inventory must not silently saturate aggregate counters");
|
||||||
|
for source_marker in [
|
||||||
|
"impl crate::RawTransactionIngestYellowstoneSource",
|
||||||
|
"impl crate::RawTransactionIngestHeliusTransactionSource",
|
||||||
|
"impl crate::RawTransactionIngestHttpBlockPollingSource",
|
||||||
|
"impl crate::RawTransactionIngestStandardBlockSource",
|
||||||
|
"impl crate::RawTransactionIngestStandardLogsSource",
|
||||||
|
] {
|
||||||
|
let tail = match resources.split_once(source_marker) {
|
||||||
|
std::option::Option::Some((_, value)) => value,
|
||||||
|
std::option::Option::None => "",
|
||||||
|
};
|
||||||
|
assert!(tail.contains("stop_receiver.changed()"), "pre.011 source lacks stop-preemptible wait: {source_marker}");
|
||||||
|
}
|
||||||
|
assert!(!runtime.contains("unbounded_channel"));
|
||||||
|
assert!(!resources.contains("unbounded_channel"));
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
|
||||||
|
#[test]
|
||||||
|
fn v0_3_13_pre_012_cross_layer_security_closure_is_complete_and_source_neutral() {
|
||||||
|
let cross_layer = include_str!("cross_layer_completeness.rs");
|
||||||
|
for required in [
|
||||||
|
"v0_3_13_pre_012_legacy_v0_v1_is_proven_from_transport_through_worker_common_raw_to_store",
|
||||||
|
"v0_3_13_pre_012_yellowstone_non_regression_covers_identity_v1_reconnect_gap_and_worker_hydration",
|
||||||
|
"v0_3_13_pre_012_security_redaction_matrix_covers_all_live_sources_and_lower_layers",
|
||||||
|
] {
|
||||||
|
assert!(cross_layer.contains(required), "pre.012 security closure proof missing: {required}");
|
||||||
|
}
|
||||||
|
let root = include_str!("../src/lib.rs");
|
||||||
|
for forbidden in [
|
||||||
|
"SourceSnapshotByKey",
|
||||||
|
"SourceHealthByKey",
|
||||||
|
"provider_health",
|
||||||
|
"endpoint_health",
|
||||||
|
"RawTransactionIngestGlobalHydrationRegistry",
|
||||||
|
"RawTransactionIngestCanonicalState",
|
||||||
|
"source_key",
|
||||||
|
] {
|
||||||
|
assert!(!root.contains(forbidden), "pre.012 public root leaked private/source-specific material: {forbidden}");
|
||||||
}
|
}
|
||||||
return;
|
return;
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -1,5 +1,5 @@
|
|||||||
// file: crates/ksp-worker-raw-transaction-ingest-lib/tests/public_api.rs
|
// file: crates/ksp-worker-raw-transaction-ingest-lib/tests/public_api.rs
|
||||||
// version: 11
|
// version: 22
|
||||||
|
|
||||||
//! External public-surface proofs for the RAW transaction ingest Worker foundation.
|
//! External public-surface proofs for the RAW transaction ingest Worker foundation.
|
||||||
|
|
||||||
@@ -182,6 +182,137 @@ fn v0_3_12_pre_002_runtime_resource_types_are_consumable_without_client_escape_h
|
|||||||
return;
|
return;
|
||||||
}
|
}
|
||||||
|
|
||||||
|
#[test]
|
||||||
|
fn v0_3_13_pre_002_multi_source_runtime_resource_surface_is_bounded_and_source_neutral() {
|
||||||
|
let _source_count: fn(&ksp_worker_raw_transaction_ingest_lib::RawTransactionIngestRuntimeResources) -> usize =
|
||||||
|
ksp_worker_raw_transaction_ingest_lib::RawTransactionIngestRuntimeResources::source_count;
|
||||||
|
let _push_yellowstone: fn(
|
||||||
|
&mut ksp_worker_raw_transaction_ingest_lib::RawTransactionIngestRuntimeResources,
|
||||||
|
ksp_worker_raw_transaction_ingest_lib::RawTransactionIngestYellowstoneSource,
|
||||||
|
) -> ksp_core_lib::Result<()> = ksp_worker_raw_transaction_ingest_lib::RawTransactionIngestRuntimeResources::try_push_yellowstone_source;
|
||||||
|
assert_eq!(ksp_worker_raw_transaction_ingest_lib::MAX_RAW_TRANSACTION_INGEST_LIVE_SOURCES, 32);
|
||||||
|
let root = include_str!("../src/lib.rs");
|
||||||
|
assert!(!root.contains("RawTransactionIngestLiveSource"));
|
||||||
|
assert!(!root.contains("source_key"));
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
|
||||||
|
#[test]
|
||||||
|
fn v0_3_13_pre_003_standard_logs_runtime_resource_surface_is_typed_and_transport_owned() {
|
||||||
|
let _source_new: fn(
|
||||||
|
ksp_onchain_transport_lib::WsEndpointSettings,
|
||||||
|
ksp_onchain_transport_lib::SolanaLogsSubscribeFilter,
|
||||||
|
ksp_onchain_transport_lib::SolanaCommitment,
|
||||||
|
ksp_onchain_transport_lib::HttpTransportPool,
|
||||||
|
ksp_onchain_transport_lib::HttpRoleName,
|
||||||
|
) -> ksp_core_lib::Result<ksp_worker_raw_transaction_ingest_lib::RawTransactionIngestStandardLogsSource> =
|
||||||
|
ksp_worker_raw_transaction_ingest_lib::RawTransactionIngestStandardLogsSource::new;
|
||||||
|
let _resources_from_logs: fn(
|
||||||
|
ksp_worker_raw_transaction_ingest_lib::RawTransactionIngestStandardLogsSource,
|
||||||
|
) -> ksp_worker_raw_transaction_ingest_lib::RawTransactionIngestRuntimeResources =
|
||||||
|
ksp_worker_raw_transaction_ingest_lib::RawTransactionIngestRuntimeResources::from_standard_logs_source;
|
||||||
|
let _push_logs: fn(
|
||||||
|
&mut ksp_worker_raw_transaction_ingest_lib::RawTransactionIngestRuntimeResources,
|
||||||
|
ksp_worker_raw_transaction_ingest_lib::RawTransactionIngestStandardLogsSource,
|
||||||
|
) -> ksp_core_lib::Result<()> = ksp_worker_raw_transaction_ingest_lib::RawTransactionIngestRuntimeResources::try_push_standard_logs_source;
|
||||||
|
let root = include_str!("../src/lib.rs");
|
||||||
|
let resources = include_str!("../src/runtime_resources.rs");
|
||||||
|
assert!(root.contains("RawTransactionIngestStandardLogsSource"));
|
||||||
|
for forbidden in ["pub fn ws_endpoint(", "pub fn filter(", "pub fn http_pool(", "pub fn source_key("] {
|
||||||
|
assert!(!resources.contains(forbidden), "standard logs source implementation escape hatch present: {forbidden}");
|
||||||
|
}
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
|
||||||
|
#[test]
|
||||||
|
fn v0_3_13_pre_005_helius_transaction_runtime_resource_surface_is_typed_and_transport_owned() {
|
||||||
|
let _source_new: fn(
|
||||||
|
ksp_onchain_transport_lib::WsEndpointSettings,
|
||||||
|
ksp_onchain_transport_lib::HeliusTransactionSubscribeFilter,
|
||||||
|
ksp_onchain_transport_lib::SolanaCommitment,
|
||||||
|
ksp_onchain_transport_lib::HttpTransportPool,
|
||||||
|
ksp_onchain_transport_lib::HttpRoleName,
|
||||||
|
) -> ksp_core_lib::Result<ksp_worker_raw_transaction_ingest_lib::RawTransactionIngestHeliusTransactionSource> =
|
||||||
|
ksp_worker_raw_transaction_ingest_lib::RawTransactionIngestHeliusTransactionSource::new;
|
||||||
|
let _resources_from_helius: fn(
|
||||||
|
ksp_worker_raw_transaction_ingest_lib::RawTransactionIngestHeliusTransactionSource,
|
||||||
|
) -> ksp_worker_raw_transaction_ingest_lib::RawTransactionIngestRuntimeResources =
|
||||||
|
ksp_worker_raw_transaction_ingest_lib::RawTransactionIngestRuntimeResources::from_helius_transaction_source;
|
||||||
|
let _push_helius: fn(
|
||||||
|
&mut ksp_worker_raw_transaction_ingest_lib::RawTransactionIngestRuntimeResources,
|
||||||
|
ksp_worker_raw_transaction_ingest_lib::RawTransactionIngestHeliusTransactionSource,
|
||||||
|
) -> ksp_core_lib::Result<()> = ksp_worker_raw_transaction_ingest_lib::RawTransactionIngestRuntimeResources::try_push_helius_transaction_source;
|
||||||
|
let root = include_str!("../src/lib.rs");
|
||||||
|
let resources = include_str!("../src/runtime_resources.rs");
|
||||||
|
assert!(root.contains("RawTransactionIngestHeliusTransactionSource"));
|
||||||
|
for forbidden in ["pub fn ws_endpoint(", "pub fn filter(", "pub fn http_pool(", "pub fn source_key("] {
|
||||||
|
assert!(!resources.contains(forbidden), "Helius transaction source implementation escape hatch present: {forbidden}");
|
||||||
|
}
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
|
||||||
|
#[test]
|
||||||
|
fn v0_3_13_pre_004_standard_block_runtime_resource_surface_is_typed_and_transport_owned() {
|
||||||
|
let _source_new: fn(
|
||||||
|
ksp_onchain_transport_lib::WsEndpointSettings,
|
||||||
|
ksp_onchain_transport_lib::SolanaBlockSubscribeFilter,
|
||||||
|
ksp_onchain_transport_lib::SolanaCommitment,
|
||||||
|
) -> ksp_core_lib::Result<ksp_worker_raw_transaction_ingest_lib::RawTransactionIngestStandardBlockSource> =
|
||||||
|
ksp_worker_raw_transaction_ingest_lib::RawTransactionIngestStandardBlockSource::new;
|
||||||
|
let _resources_from_block: fn(
|
||||||
|
ksp_worker_raw_transaction_ingest_lib::RawTransactionIngestStandardBlockSource,
|
||||||
|
) -> ksp_worker_raw_transaction_ingest_lib::RawTransactionIngestRuntimeResources =
|
||||||
|
ksp_worker_raw_transaction_ingest_lib::RawTransactionIngestRuntimeResources::from_standard_block_source;
|
||||||
|
let _push_block: fn(
|
||||||
|
&mut ksp_worker_raw_transaction_ingest_lib::RawTransactionIngestRuntimeResources,
|
||||||
|
ksp_worker_raw_transaction_ingest_lib::RawTransactionIngestStandardBlockSource,
|
||||||
|
) -> ksp_core_lib::Result<()> = ksp_worker_raw_transaction_ingest_lib::RawTransactionIngestRuntimeResources::try_push_standard_block_source;
|
||||||
|
let root = include_str!("../src/lib.rs");
|
||||||
|
let resources = include_str!("../src/runtime_resources.rs");
|
||||||
|
assert!(root.contains("RawTransactionIngestStandardBlockSource"));
|
||||||
|
for forbidden in ["pub fn ws_endpoint(", "pub fn filter(", "pub fn source_key("] {
|
||||||
|
assert!(!resources.contains(forbidden), "standard block source implementation escape hatch present: {forbidden}");
|
||||||
|
}
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
|
||||||
|
#[test]
|
||||||
|
fn v0_3_13_pre_006_http_block_polling_runtime_resource_surface_is_bounded_and_transport_owned() {
|
||||||
|
let _source_new: fn(
|
||||||
|
ksp_onchain_transport_lib::HttpTransportPool,
|
||||||
|
ksp_onchain_transport_lib::HttpRoleName,
|
||||||
|
ksp_onchain_transport_lib::SolanaCommitment,
|
||||||
|
) -> ksp_core_lib::Result<ksp_worker_raw_transaction_ingest_lib::RawTransactionIngestHttpBlockPollingSource> =
|
||||||
|
ksp_worker_raw_transaction_ingest_lib::RawTransactionIngestHttpBlockPollingSource::new;
|
||||||
|
let _source_new_with_limits: fn(
|
||||||
|
ksp_onchain_transport_lib::HttpTransportPool,
|
||||||
|
ksp_onchain_transport_lib::HttpRoleName,
|
||||||
|
ksp_onchain_transport_lib::SolanaCommitment,
|
||||||
|
std::time::Duration,
|
||||||
|
u16,
|
||||||
|
) -> ksp_core_lib::Result<ksp_worker_raw_transaction_ingest_lib::RawTransactionIngestHttpBlockPollingSource> =
|
||||||
|
ksp_worker_raw_transaction_ingest_lib::RawTransactionIngestHttpBlockPollingSource::new_with_limits;
|
||||||
|
let _resources_from_polling: fn(
|
||||||
|
ksp_worker_raw_transaction_ingest_lib::RawTransactionIngestHttpBlockPollingSource,
|
||||||
|
) -> ksp_worker_raw_transaction_ingest_lib::RawTransactionIngestRuntimeResources =
|
||||||
|
ksp_worker_raw_transaction_ingest_lib::RawTransactionIngestRuntimeResources::from_http_block_polling_source;
|
||||||
|
let _push_polling: fn(
|
||||||
|
&mut ksp_worker_raw_transaction_ingest_lib::RawTransactionIngestRuntimeResources,
|
||||||
|
ksp_worker_raw_transaction_ingest_lib::RawTransactionIngestHttpBlockPollingSource,
|
||||||
|
) -> ksp_core_lib::Result<()> = ksp_worker_raw_transaction_ingest_lib::RawTransactionIngestRuntimeResources::try_push_http_block_polling_source;
|
||||||
|
assert_eq!(ksp_worker_raw_transaction_ingest_lib::DEFAULT_RAW_TRANSACTION_INGEST_HTTP_POLL_INTERVAL, std::time::Duration::from_secs(1));
|
||||||
|
assert_eq!(ksp_worker_raw_transaction_ingest_lib::DEFAULT_RAW_TRANSACTION_INGEST_HTTP_POLL_MAX_BLOCKS_PER_CYCLE, 128);
|
||||||
|
assert_eq!(ksp_worker_raw_transaction_ingest_lib::MIN_RAW_TRANSACTION_INGEST_HTTP_POLL_INTERVAL, std::time::Duration::from_millis(100));
|
||||||
|
assert_eq!(ksp_worker_raw_transaction_ingest_lib::MAX_RAW_TRANSACTION_INGEST_HTTP_POLL_INTERVAL, std::time::Duration::from_secs(30));
|
||||||
|
assert_eq!(ksp_worker_raw_transaction_ingest_lib::MIN_RAW_TRANSACTION_INGEST_HTTP_POLL_MAX_BLOCKS_PER_CYCLE, 1);
|
||||||
|
assert_eq!(ksp_worker_raw_transaction_ingest_lib::MAX_RAW_TRANSACTION_INGEST_HTTP_POLL_MAX_BLOCKS_PER_CYCLE, 1024);
|
||||||
|
let resources = include_str!("../src/runtime_resources.rs");
|
||||||
|
for forbidden in ["pub fn http_pool(", "pub fn polling_role(", "pub fn source_key(", "pub fn profile_fingerprint("] {
|
||||||
|
assert!(!resources.contains(forbidden), "HTTP polling source implementation escape hatch present: {forbidden}");
|
||||||
|
}
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
|
||||||
#[test]
|
#[test]
|
||||||
fn v0_3_12_pre_007_processing_frontier_snapshot_getters_are_public_and_processing_only() {
|
fn v0_3_12_pre_007_processing_frontier_snapshot_getters_are_public_and_processing_only() {
|
||||||
let _hydration_pending: fn(&ksp_worker_raw_transaction_ingest_lib::RawTransactionIngestSnapshot) -> usize =
|
let _hydration_pending: fn(&ksp_worker_raw_transaction_ingest_lib::RawTransactionIngestSnapshot) -> usize =
|
||||||
@@ -196,3 +327,104 @@ fn v0_3_12_pre_007_processing_frontier_snapshot_getters_are_public_and_processin
|
|||||||
}
|
}
|
||||||
return;
|
return;
|
||||||
}
|
}
|
||||||
|
|
||||||
|
#[test]
|
||||||
|
fn v0_3_13_pre_007_source_inventory_and_logical_keys_remain_private() {
|
||||||
|
let root = include_str!("../src/lib.rs");
|
||||||
|
for forbidden in ["RawTransactionIngestSourceInventory", "RawTransactionIngestSourceInventoryPublisher", "RawTransactionIngestLiveSource", "source_key"] {
|
||||||
|
assert!(!root.contains(forbidden), "pre.007 private multi-source implementation leaked through crate root: {forbidden}");
|
||||||
|
}
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
|
||||||
|
#[test]
|
||||||
|
fn v0_3_13_pre_008_convergence_cache_registry_and_source_keys_remain_private() {
|
||||||
|
let root = include_str!("../src/lib.rs");
|
||||||
|
for forbidden in [
|
||||||
|
"pub use self::persistence::RawTransactionIngestPersistenceConvergence",
|
||||||
|
"pub use self::persistence::persist_raw_transaction_ingest_converged_acquisition",
|
||||||
|
"RawTransactionIngestGlobalHydrationRegistry",
|
||||||
|
"RawTransactionIngestHydrationKey",
|
||||||
|
"source_key",
|
||||||
|
] {
|
||||||
|
assert!(!root.contains(forbidden), "pre.008 convergence implementation leaked through public crate root: {forbidden}");
|
||||||
|
}
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
|
||||||
|
#[test]
|
||||||
|
fn v0_3_13_pre_009_fairness_budgets_semaphore_and_canonical_state_remain_private() {
|
||||||
|
let root = include_str!("../src/lib.rs");
|
||||||
|
for private_name in [
|
||||||
|
"RawTransactionIngestCanonicalState",
|
||||||
|
"RawTransactionIngestGlobalHydrationRegistry",
|
||||||
|
"RawTransactionIngestHydrationLeaderGuard",
|
||||||
|
"validate_hydration_fairness_capacity",
|
||||||
|
"hydration_pending_limit",
|
||||||
|
"hydration_in_flight_limit",
|
||||||
|
] {
|
||||||
|
assert!(!root.contains(&std::format!("pub use self::runtime_resources::{private_name}")));
|
||||||
|
assert!(!root.contains(&std::format!("pub use self::persistence::{private_name}")));
|
||||||
|
}
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
|
||||||
|
#[test]
|
||||||
|
fn v0_3_13_pre_010_multi_source_snapshot_counts_are_public_and_source_neutral() {
|
||||||
|
let _source_total: fn(&ksp_worker_raw_transaction_ingest_lib::RawTransactionIngestSnapshot) -> usize =
|
||||||
|
ksp_worker_raw_transaction_ingest_lib::RawTransactionIngestSnapshot::source_total;
|
||||||
|
let _source_active: fn(&ksp_worker_raw_transaction_ingest_lib::RawTransactionIngestSnapshot) -> usize =
|
||||||
|
ksp_worker_raw_transaction_ingest_lib::RawTransactionIngestSnapshot::source_active;
|
||||||
|
let _source_reconnecting: fn(&ksp_worker_raw_transaction_ingest_lib::RawTransactionIngestSnapshot) -> usize =
|
||||||
|
ksp_worker_raw_transaction_ingest_lib::RawTransactionIngestSnapshot::source_reconnecting;
|
||||||
|
let _source_failed: fn(&ksp_worker_raw_transaction_ingest_lib::RawTransactionIngestSnapshot) -> usize =
|
||||||
|
ksp_worker_raw_transaction_ingest_lib::RawTransactionIngestSnapshot::source_failed;
|
||||||
|
let root = include_str!("../src/lib.rs");
|
||||||
|
for forbidden in ["SourceHealthByKey", "SourceSnapshotByKey", "provider_health", "endpoint_health"] {
|
||||||
|
assert!(!root.contains(forbidden), "pre.010 public root leaked source-specific health material: {forbidden}");
|
||||||
|
}
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
|
||||||
|
#[test]
|
||||||
|
fn v0_3_13_pre_011_race_hardening_adds_no_public_runtime_or_source_identity_surface() {
|
||||||
|
let root = include_str!("../src/lib.rs");
|
||||||
|
for forbidden in [
|
||||||
|
"pub use self::runtime_resources::RawTransactionIngestSourceInventory",
|
||||||
|
"pub use self::runtime_resources::RawTransactionIngestSourceInventoryPublisher",
|
||||||
|
"pub use self::runtime_resources::RawTransactionIngestGlobalHydrationRegistry",
|
||||||
|
"pub use self::runtime_resources::RawTransactionIngestHydrationLeaderGuard",
|
||||||
|
"publish_and_remove",
|
||||||
|
"source.inventory_key_mismatch",
|
||||||
|
] {
|
||||||
|
assert!(!root.contains(forbidden), "pre.011 private race-hardening implementation leaked publicly: {forbidden}");
|
||||||
|
}
|
||||||
|
assert_eq!(
|
||||||
|
ksp_worker_raw_transaction_ingest_lib::ERROR_CODE_RAW_TRANSACTION_INGEST_COUNTER_EXHAUSTED,
|
||||||
|
ksp_core_lib::ErrorCode::new("worker_raw_transaction_ingest", "counter_exhausted")
|
||||||
|
);
|
||||||
|
assert_eq!(
|
||||||
|
ksp_worker_raw_transaction_ingest_lib::ERROR_CODE_RAW_TRANSACTION_INGEST_DRAIN_TIMEOUT,
|
||||||
|
ksp_core_lib::ErrorCode::new("worker_raw_transaction_ingest", "drain_timeout")
|
||||||
|
);
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
|
||||||
|
#[test]
|
||||||
|
fn v0_3_13_pre_012_completeness_closure_adds_no_public_implementation_surface() {
|
||||||
|
let root = include_str!("../src/lib.rs");
|
||||||
|
assert!(!root.contains("pub mod "));
|
||||||
|
for forbidden in [
|
||||||
|
"pub use self::runtime_resources::RawTransactionIngestLiveSource",
|
||||||
|
"pub use self::runtime_resources::RawTransactionIngestSourceInventory",
|
||||||
|
"pub use self::runtime_resources::RawTransactionIngestGlobalHydrationRegistry",
|
||||||
|
"pub use self::persistence::RawTransactionIngestCanonicalState",
|
||||||
|
"pub use self::persistence::RawTransactionIngestPersistenceConvergence",
|
||||||
|
] {
|
||||||
|
assert!(!root.contains(forbidden), "pre.012 private implementation leaked through public root: {forbidden}");
|
||||||
|
}
|
||||||
|
let cross_layer = include_str!("cross_layer_completeness.rs");
|
||||||
|
assert!(cross_layer.contains("v0_3_13_pre_012_all_five_live_source_families_share_one_worker_common_raw_store_pipeline"));
|
||||||
|
assert!(cross_layer.contains("v0_3_13_pre_012_legacy_v0_v1_is_proven_from_transport_through_worker_common_raw_to_store"));
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
|||||||
@@ -1,7 +1,7 @@
|
|||||||
// file: crates/ksp-worker-raw-transaction-ingest-lib/tests/release_completeness.rs
|
// file: crates/ksp-worker-raw-transaction-ingest-lib/tests/release_completeness.rs
|
||||||
// version: 9
|
// version: 20
|
||||||
|
|
||||||
//! Release-completeness canaries through the `pre.010` public/release/security hardening tranche.
|
//! Release-completeness canaries through the `pre.012` cross-layer completeness/security tranche.
|
||||||
|
|
||||||
#[test]
|
#[test]
|
||||||
fn pre_010_production_module_inventory_is_exact() -> std::io::Result<()> {
|
fn pre_010_production_module_inventory_is_exact() -> std::io::Result<()> {
|
||||||
@@ -60,6 +60,8 @@ fn pre_010_public_root_export_inventory_is_exact() {
|
|||||||
exports,
|
exports,
|
||||||
std::vec![
|
std::vec![
|
||||||
"DEFAULT_RAW_TRANSACTION_INGEST_ADMISSION_QUEUE_CAPACITY",
|
"DEFAULT_RAW_TRANSACTION_INGEST_ADMISSION_QUEUE_CAPACITY",
|
||||||
|
"DEFAULT_RAW_TRANSACTION_INGEST_HTTP_POLL_INTERVAL",
|
||||||
|
"DEFAULT_RAW_TRANSACTION_INGEST_HTTP_POLL_MAX_BLOCKS_PER_CYCLE",
|
||||||
"DEFAULT_RAW_TRANSACTION_INGEST_PERSISTENCE_CONCURRENCY",
|
"DEFAULT_RAW_TRANSACTION_INGEST_PERSISTENCE_CONCURRENCY",
|
||||||
"DEFAULT_RAW_TRANSACTION_INGEST_SHUTDOWN_DRAIN_TIMEOUT",
|
"DEFAULT_RAW_TRANSACTION_INGEST_SHUTDOWN_DRAIN_TIMEOUT",
|
||||||
"ERROR_CODE_RAW_TRANSACTION_INGEST_CONTENT_CONFLICT",
|
"ERROR_CODE_RAW_TRANSACTION_INGEST_CONTENT_CONFLICT",
|
||||||
@@ -70,19 +72,28 @@ fn pre_010_public_root_export_inventory_is_exact() {
|
|||||||
"ERROR_CODE_RAW_TRANSACTION_INGEST_SOURCE_FAILED",
|
"ERROR_CODE_RAW_TRANSACTION_INGEST_SOURCE_FAILED",
|
||||||
"ERROR_CODE_RAW_TRANSACTION_INGEST_STORE_FAILED",
|
"ERROR_CODE_RAW_TRANSACTION_INGEST_STORE_FAILED",
|
||||||
"MAX_RAW_TRANSACTION_INGEST_ADMISSION_QUEUE_CAPACITY",
|
"MAX_RAW_TRANSACTION_INGEST_ADMISSION_QUEUE_CAPACITY",
|
||||||
|
"MAX_RAW_TRANSACTION_INGEST_HTTP_POLL_INTERVAL",
|
||||||
|
"MAX_RAW_TRANSACTION_INGEST_HTTP_POLL_MAX_BLOCKS_PER_CYCLE",
|
||||||
|
"MAX_RAW_TRANSACTION_INGEST_LIVE_SOURCES",
|
||||||
"MAX_RAW_TRANSACTION_INGEST_PERSISTENCE_CONCURRENCY",
|
"MAX_RAW_TRANSACTION_INGEST_PERSISTENCE_CONCURRENCY",
|
||||||
"MAX_RAW_TRANSACTION_INGEST_SHUTDOWN_DRAIN_TIMEOUT",
|
"MAX_RAW_TRANSACTION_INGEST_SHUTDOWN_DRAIN_TIMEOUT",
|
||||||
"MIN_RAW_TRANSACTION_INGEST_ADMISSION_QUEUE_CAPACITY",
|
"MIN_RAW_TRANSACTION_INGEST_ADMISSION_QUEUE_CAPACITY",
|
||||||
|
"MIN_RAW_TRANSACTION_INGEST_HTTP_POLL_INTERVAL",
|
||||||
|
"MIN_RAW_TRANSACTION_INGEST_HTTP_POLL_MAX_BLOCKS_PER_CYCLE",
|
||||||
"MIN_RAW_TRANSACTION_INGEST_PERSISTENCE_CONCURRENCY",
|
"MIN_RAW_TRANSACTION_INGEST_PERSISTENCE_CONCURRENCY",
|
||||||
"MIN_RAW_TRANSACTION_INGEST_SHUTDOWN_DRAIN_TIMEOUT",
|
"MIN_RAW_TRANSACTION_INGEST_SHUTDOWN_DRAIN_TIMEOUT",
|
||||||
"RAW_TRANSACTION_INGEST_WORKER_KIND_CODE",
|
"RAW_TRANSACTION_INGEST_WORKER_KIND_CODE",
|
||||||
"RawTransactionIngestHandle",
|
"RawTransactionIngestHandle",
|
||||||
|
"RawTransactionIngestHeliusTransactionSource",
|
||||||
|
"RawTransactionIngestHttpBlockPollingSource",
|
||||||
"RawTransactionIngestRuntimeResources",
|
"RawTransactionIngestRuntimeResources",
|
||||||
"RawTransactionIngestSettings",
|
"RawTransactionIngestSettings",
|
||||||
"RawTransactionIngestSnapshot",
|
"RawTransactionIngestSnapshot",
|
||||||
"RawTransactionIngestSnapshotFuture",
|
"RawTransactionIngestSnapshotFuture",
|
||||||
"RawTransactionIngestSnapshotSource",
|
"RawTransactionIngestSnapshotSource",
|
||||||
"RawTransactionIngestSourceState",
|
"RawTransactionIngestSourceState",
|
||||||
|
"RawTransactionIngestStandardBlockSource",
|
||||||
|
"RawTransactionIngestStandardLogsSource",
|
||||||
"RawTransactionIngestTerminalFuture",
|
"RawTransactionIngestTerminalFuture",
|
||||||
"RawTransactionIngestWorker",
|
"RawTransactionIngestWorker",
|
||||||
"RawTransactionIngestYellowstoneSource",
|
"RawTransactionIngestYellowstoneSource",
|
||||||
@@ -112,6 +123,15 @@ fn pre_010_external_hardening_suite_is_present_and_scoped() {
|
|||||||
"v0_3_12_pre_009_hydration_retry_ownership_and_no_orphan_cleanup_are_explicit",
|
"v0_3_12_pre_009_hydration_retry_ownership_and_no_orphan_cleanup_are_explicit",
|
||||||
"pre_010_lower_layers_have_no_dependency_return_to_concrete_worker",
|
"pre_010_lower_layers_have_no_dependency_return_to_concrete_worker",
|
||||||
"v0_3_12_pre_002_public_root_exposes_contract_types_without_transport_implementation_paths",
|
"v0_3_12_pre_002_public_root_exposes_contract_types_without_transport_implementation_paths",
|
||||||
|
"v0_3_13_pre_003_standard_logs_redaction_and_reference_only_contract_are_explicit",
|
||||||
|
"v0_3_13_pre_004_standard_block_redaction_version_and_null_guards_are_explicit",
|
||||||
|
"v0_3_13_pre_005_helius_transaction_redaction_full_reference_and_tier_neutrality_are_explicit",
|
||||||
|
"v0_3_13_pre_006_http_block_polling_is_bounded_run_local_stop_preemptible_and_redacted",
|
||||||
|
"v0_3_13_pre_007_multi_source_supervisor_is_fail_closed_joined_and_does_not_publish_source_identity",
|
||||||
|
"v0_3_13_pre_008_cross_source_convergence_is_bounded_conflict_checked_and_private",
|
||||||
|
"v0_3_13_pre_009_duplicate_storm_disagreement_and_starvation_guards_are_explicit",
|
||||||
|
"v0_3_13_pre_010_multi_source_health_is_conservative_counted_and_redacted",
|
||||||
|
"v0_3_13_pre_011_shutdown_races_are_bounded_joined_atomic_and_counter_safe",
|
||||||
] {
|
] {
|
||||||
assert!(hardening.contains(required), "required pre.010 hardening canary missing: {required}");
|
assert!(hardening.contains(required), "required pre.010 hardening canary missing: {required}");
|
||||||
}
|
}
|
||||||
@@ -125,12 +145,30 @@ fn pre_010_external_hardening_suite_is_present_and_scoped() {
|
|||||||
assert!(dependency_boundary.contains("v0_3_12_pre_005_block_and_continuity_adapters_remain_private_and_transport_facade_only"));
|
assert!(dependency_boundary.contains("v0_3_12_pre_005_block_and_continuity_adapters_remain_private_and_transport_facade_only"));
|
||||||
assert!(dependency_boundary.contains("v0_3_12_pre_007_processing_frontier_remains_run_local_and_backend_neutral_after_continuity_extension"));
|
assert!(dependency_boundary.contains("v0_3_12_pre_007_processing_frontier_remains_run_local_and_backend_neutral_after_continuity_extension"));
|
||||||
assert!(dependency_boundary.contains("v0_3_12_pre_008_worker_observes_transport_reconnect_replay_and_faults_only_on_proven_retention_gap"));
|
assert!(dependency_boundary.contains("v0_3_12_pre_008_worker_observes_transport_reconnect_replay_and_faults_only_on_proven_retention_gap"));
|
||||||
|
assert!(dependency_boundary.contains("v0_3_13_pre_003_standard_logs_source_reuses_transport_facades_and_common_hydration_only"));
|
||||||
|
assert!(dependency_boundary.contains("v0_3_13_pre_004_standard_block_source_is_direct_raw_and_transport_facade_only"));
|
||||||
|
assert!(dependency_boundary.contains("v0_3_13_pre_005_helius_transaction_source_reuses_transport_facade_and_common_hydration_only"));
|
||||||
|
assert!(dependency_boundary.contains("v0_3_13_pre_006_http_block_polling_reuses_transport_facades_without_becoming_backfill"));
|
||||||
|
assert!(dependency_boundary.contains("v0_3_13_pre_007_multi_source_supervisor_and_inventory_remain_private_bounded_and_source_neutral"));
|
||||||
|
assert!(dependency_boundary.contains("v0_3_13_pre_008_cross_source_convergence_reuses_store_and_transport_facades_only"));
|
||||||
|
assert!(dependency_boundary.contains("v0_3_13_pre_009_global_bounds_and_fairness_stay_inside_worker_facades"));
|
||||||
|
assert!(dependency_boundary.contains("v0_3_13_pre_010_multi_source_snapshot_health_remains_source_neutral_and_backend_free"));
|
||||||
|
assert!(dependency_boundary.contains("v0_3_13_pre_011_shutdown_race_hardening_stays_inside_worker_and_existing_facades"));
|
||||||
let public_api = include_str!("public_api.rs");
|
let public_api = include_str!("public_api.rs");
|
||||||
assert!(public_api.contains("pre_003_kind_code_and_settings_are_consumable_from_crate_root"));
|
assert!(public_api.contains("pre_003_kind_code_and_settings_are_consumable_from_crate_root"));
|
||||||
assert!(public_api.contains("pre_004_start_handle_and_terminal_future_are_consumable_without_public_join_handle"));
|
assert!(public_api.contains("pre_004_start_handle_and_terminal_future_are_consumable_without_public_join_handle"));
|
||||||
assert!(public_api.contains("pre_008_snapshot_surface_and_common_projection_are_public_and_stable"));
|
assert!(public_api.contains("pre_008_snapshot_surface_and_common_projection_are_public_and_stable"));
|
||||||
assert!(public_api.contains("pre_009_source_and_drain_timeout_error_codes_are_public_and_stable"));
|
assert!(public_api.contains("pre_009_source_and_drain_timeout_error_codes_are_public_and_stable"));
|
||||||
assert!(public_api.contains("v0_3_12_pre_002_runtime_resource_types_are_consumable_without_client_escape_hatch"));
|
assert!(public_api.contains("v0_3_12_pre_002_runtime_resource_types_are_consumable_without_client_escape_hatch"));
|
||||||
|
assert!(public_api.contains("v0_3_13_pre_002_multi_source_runtime_resource_surface_is_bounded_and_source_neutral"));
|
||||||
|
assert!(public_api.contains("v0_3_13_pre_003_standard_logs_runtime_resource_surface_is_typed_and_transport_owned"));
|
||||||
|
assert!(public_api.contains("v0_3_13_pre_004_standard_block_runtime_resource_surface_is_typed_and_transport_owned"));
|
||||||
|
assert!(public_api.contains("v0_3_13_pre_006_http_block_polling_runtime_resource_surface_is_bounded_and_transport_owned"));
|
||||||
|
assert!(public_api.contains("v0_3_13_pre_007_source_inventory_and_logical_keys_remain_private"));
|
||||||
|
assert!(public_api.contains("v0_3_13_pre_008_convergence_cache_registry_and_source_keys_remain_private"));
|
||||||
|
assert!(public_api.contains("v0_3_13_pre_009_fairness_budgets_semaphore_and_canonical_state_remain_private"));
|
||||||
|
assert!(public_api.contains("v0_3_13_pre_010_multi_source_snapshot_counts_are_public_and_source_neutral"));
|
||||||
|
assert!(public_api.contains("v0_3_13_pre_011_race_hardening_adds_no_public_runtime_or_source_identity_surface"));
|
||||||
assert!(public_api.contains("v0_3_12_pre_007_processing_frontier_snapshot_getters_are_public_and_processing_only"));
|
assert!(public_api.contains("v0_3_12_pre_007_processing_frontier_snapshot_getters_are_public_and_processing_only"));
|
||||||
assert!(public_api.contains("pre_008_snapshot_surface_and_common_projection_are_public_and_stable"));
|
assert!(public_api.contains("pre_008_snapshot_surface_and_common_projection_are_public_and_stable"));
|
||||||
return;
|
return;
|
||||||
@@ -177,3 +215,23 @@ fn v0_3_12_pre_010_cross_layer_completeness_suite_is_present_and_exact() -> std:
|
|||||||
}
|
}
|
||||||
return std::result::Result::Ok(());
|
return std::result::Result::Ok(());
|
||||||
}
|
}
|
||||||
|
|
||||||
|
#[test]
|
||||||
|
fn v0_3_13_pre_012_cross_layer_completeness_security_inventory_is_exact() {
|
||||||
|
let cross_layer = include_str!("cross_layer_completeness.rs");
|
||||||
|
for required in [
|
||||||
|
"v0_3_13_pre_012_all_five_live_source_families_share_one_worker_common_raw_store_pipeline",
|
||||||
|
"v0_3_13_pre_012_legacy_v0_v1_is_proven_from_transport_through_worker_common_raw_to_store",
|
||||||
|
"v0_3_13_pre_012_yellowstone_non_regression_covers_identity_v1_reconnect_gap_and_worker_hydration",
|
||||||
|
"v0_3_13_pre_012_security_redaction_matrix_covers_all_live_sources_and_lower_layers",
|
||||||
|
] {
|
||||||
|
assert!(cross_layer.contains(required), "required pre.012 cross-layer canary missing: {required}");
|
||||||
|
}
|
||||||
|
let dependency_boundary = include_str!("dependency_boundary.rs");
|
||||||
|
let hardening = include_str!("hardening.rs");
|
||||||
|
let public_api = include_str!("public_api.rs");
|
||||||
|
assert!(dependency_boundary.contains("v0_3_13_pre_012_cross_layer_closure_does_not_expand_worker_dependency_graph"));
|
||||||
|
assert!(hardening.contains("v0_3_13_pre_012_cross_layer_security_closure_is_complete_and_source_neutral"));
|
||||||
|
assert!(public_api.contains("v0_3_13_pre_012_completeness_closure_adds_no_public_implementation_surface"));
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
|||||||
@@ -1,5 +1,5 @@
|
|||||||
// file: crates/ksp-worker-raw-transaction-ingest-lib/unit_tests/admission.rs
|
// file: crates/ksp-worker-raw-transaction-ingest-lib/unit_tests/admission.rs
|
||||||
// version: 4
|
// version: 6
|
||||||
|
|
||||||
fn material(
|
fn material(
|
||||||
network: &str,
|
network: &str,
|
||||||
@@ -262,3 +262,153 @@ async fn pre_009_full_queue_dequeue_marks_source_neutral_backpressure_observatio
|
|||||||
assert!(!admission.take_backpressure_wait_observed());
|
assert!(!admission.take_backpressure_wait_observed());
|
||||||
return;
|
return;
|
||||||
}
|
}
|
||||||
|
|
||||||
|
#[tokio::test(flavor = "current_thread")]
|
||||||
|
async fn v0_3_13_pre_008_distinct_source_keys_produce_distinct_idempotent_observation_keys() {
|
||||||
|
let (network, first_material) = match material("mainnet", 51, "AQID") {
|
||||||
|
std::option::Option::Some(value) => value,
|
||||||
|
std::option::Option::None => return,
|
||||||
|
};
|
||||||
|
let (_, second_material) = match material("mainnet", 51, "AQID") {
|
||||||
|
std::option::Option::Some(value) => value,
|
||||||
|
std::option::Option::None => return,
|
||||||
|
};
|
||||||
|
let first_provenance = match provenance() {
|
||||||
|
std::option::Option::Some(value) => value,
|
||||||
|
std::option::Option::None => return,
|
||||||
|
};
|
||||||
|
let second_provenance = match provenance() {
|
||||||
|
std::option::Option::Some(value) => value,
|
||||||
|
std::option::Option::None => return,
|
||||||
|
};
|
||||||
|
let (mut admission, sender) = crate::RawTransactionAdmission::new(2);
|
||||||
|
let first_ingress = crate::RawTransactionIngress {
|
||||||
|
material: first_material,
|
||||||
|
network: network.clone(),
|
||||||
|
provenance: first_provenance,
|
||||||
|
source_key: [11_u8; 32],
|
||||||
|
};
|
||||||
|
let second_ingress = crate::RawTransactionIngress {
|
||||||
|
material: second_material,
|
||||||
|
network: network.clone(),
|
||||||
|
provenance: second_provenance,
|
||||||
|
source_key: [12_u8; 32],
|
||||||
|
};
|
||||||
|
if sender.send(first_ingress).await.is_err() || sender.send(second_ingress).await.is_err() {
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
std::mem::drop(sender);
|
||||||
|
let first = match admission.receive(&network).await {
|
||||||
|
std::result::Result::Ok(std::option::Option::Some(value)) => value,
|
||||||
|
_ => return,
|
||||||
|
};
|
||||||
|
let second = match admission.receive(&network).await {
|
||||||
|
std::result::Result::Ok(std::option::Option::Some(value)) => value,
|
||||||
|
_ => return,
|
||||||
|
};
|
||||||
|
assert_eq!(first.transaction().reference(), second.transaction().reference());
|
||||||
|
assert_eq!(first.transaction().payload().content_hash(), second.transaction().payload().content_hash());
|
||||||
|
assert_ne!(first.observation().observation_key(), second.observation().observation_key());
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
|
||||||
|
#[tokio::test(flavor = "current_thread")]
|
||||||
|
async fn v0_3_13_pre_009_duplicate_storm_cannot_starve_second_ready_source_on_bounded_admission() {
|
||||||
|
let (network, initial_material) = match material("mainnet", 60, "AQID") {
|
||||||
|
std::option::Option::Some(value) => value,
|
||||||
|
std::option::Option::None => return,
|
||||||
|
};
|
||||||
|
let (_, peer_material) = match material("mainnet", 99, "BwgJ") {
|
||||||
|
std::option::Option::Some(value) => value,
|
||||||
|
std::option::Option::None => return,
|
||||||
|
};
|
||||||
|
let initial_provenance = match provenance() {
|
||||||
|
std::option::Option::Some(value) => value,
|
||||||
|
std::option::Option::None => return,
|
||||||
|
};
|
||||||
|
let storm_provenance = match provenance() {
|
||||||
|
std::option::Option::Some(value) => value,
|
||||||
|
std::option::Option::None => return,
|
||||||
|
};
|
||||||
|
let peer_provenance = match provenance() {
|
||||||
|
std::option::Option::Some(value) => value,
|
||||||
|
std::option::Option::None => return,
|
||||||
|
};
|
||||||
|
let (mut admission, sender) = crate::RawTransactionAdmission::new(1);
|
||||||
|
assert!(
|
||||||
|
sender
|
||||||
|
.send(crate::RawTransactionIngress {
|
||||||
|
material: initial_material,
|
||||||
|
network: network.clone(),
|
||||||
|
provenance: initial_provenance,
|
||||||
|
source_key: [60_u8; 32],
|
||||||
|
})
|
||||||
|
.await
|
||||||
|
.is_ok()
|
||||||
|
);
|
||||||
|
let storm_sender = sender.clone();
|
||||||
|
let storm_network = network.clone();
|
||||||
|
let storm_task = tokio::spawn(async move {
|
||||||
|
for _ in 0..8 {
|
||||||
|
let material = ksp_raw_transaction_lib::RawTransactionMaterial::binary_base64(
|
||||||
|
storm_network.clone(),
|
||||||
|
ksp_store_lib::RawTransactionSignature::new([61_u8; 64]),
|
||||||
|
42,
|
||||||
|
std::option::Option::Some(1_700_000_000),
|
||||||
|
"BAUG",
|
||||||
|
ksp_raw_transaction_lib::RawTransactionWireField::Omitted,
|
||||||
|
ksp_raw_transaction_lib::RawTransactionWireField::Omitted,
|
||||||
|
ksp_raw_transaction_lib::RawTransactionWireField::Omitted,
|
||||||
|
);
|
||||||
|
if storm_sender
|
||||||
|
.send(crate::RawTransactionIngress {
|
||||||
|
material,
|
||||||
|
network: storm_network.clone(),
|
||||||
|
provenance: storm_provenance.clone(),
|
||||||
|
source_key: [61_u8; 32],
|
||||||
|
})
|
||||||
|
.await
|
||||||
|
.is_err()
|
||||||
|
{
|
||||||
|
return false;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
return true;
|
||||||
|
});
|
||||||
|
tokio::task::yield_now().await;
|
||||||
|
let peer_sender = sender.clone();
|
||||||
|
let peer_network = network.clone();
|
||||||
|
let peer_task = tokio::spawn(async move {
|
||||||
|
return peer_sender
|
||||||
|
.send(crate::RawTransactionIngress { material: peer_material, network: peer_network, provenance: peer_provenance, source_key: [99_u8; 32] })
|
||||||
|
.await
|
||||||
|
.is_ok();
|
||||||
|
});
|
||||||
|
tokio::task::yield_now().await;
|
||||||
|
assert_eq!(admission.queue_depth(), 1);
|
||||||
|
let first = match admission.receive(&network).await {
|
||||||
|
std::result::Result::Ok(std::option::Option::Some(value)) => value,
|
||||||
|
_ => return,
|
||||||
|
};
|
||||||
|
assert_eq!(first.transaction().reference().signature().as_bytes(), &[60_u8; 64]);
|
||||||
|
let second = match admission.receive(&network).await {
|
||||||
|
std::result::Result::Ok(std::option::Option::Some(value)) => value,
|
||||||
|
_ => return,
|
||||||
|
};
|
||||||
|
assert_eq!(second.transaction().reference().signature().as_bytes(), &[61_u8; 64]);
|
||||||
|
let third = match admission.receive(&network).await {
|
||||||
|
std::result::Result::Ok(std::option::Option::Some(value)) => value,
|
||||||
|
_ => return,
|
||||||
|
};
|
||||||
|
assert_eq!(third.transaction().reference().signature().as_bytes(), &[99_u8; 64]);
|
||||||
|
for _ in 0..7 {
|
||||||
|
let next = admission.receive(&network).await;
|
||||||
|
assert!(matches!(next, std::result::Result::Ok(std::option::Option::Some(_))));
|
||||||
|
assert!(admission.queue_depth() <= 1);
|
||||||
|
}
|
||||||
|
let peer_joined = peer_task.await;
|
||||||
|
assert!(matches!(peer_joined, std::result::Result::Ok(true)));
|
||||||
|
let storm_joined = storm_task.await;
|
||||||
|
assert!(matches!(storm_joined, std::result::Result::Ok(true)));
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
|||||||
@@ -1,5 +1,5 @@
|
|||||||
// file: crates/ksp-worker-raw-transaction-ingest-lib/unit_tests/persistence.rs
|
// file: crates/ksp-worker-raw-transaction-ingest-lib/unit_tests/persistence.rs
|
||||||
// version: 1
|
// version: 3
|
||||||
|
|
||||||
#[derive(Clone, Copy)]
|
#[derive(Clone, Copy)]
|
||||||
enum PortResponse {
|
enum PortResponse {
|
||||||
@@ -12,6 +12,8 @@ struct FakePersistencePort {
|
|||||||
calls: std::sync::atomic::AtomicUsize,
|
calls: std::sync::atomic::AtomicUsize,
|
||||||
network: ksp_store_lib::RawNetworkId,
|
network: ksp_store_lib::RawNetworkId,
|
||||||
normal_mode_seen: std::sync::atomic::AtomicBool,
|
normal_mode_seen: std::sync::atomic::AtomicBool,
|
||||||
|
observation_calls: std::sync::atomic::AtomicUsize,
|
||||||
|
observation_response: std::option::Option<ksp_store_lib::RawObservationWriteOutcome>,
|
||||||
response: PortResponse,
|
response: PortResponse,
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -21,9 +23,16 @@ impl FakePersistencePort {
|
|||||||
calls: std::sync::atomic::AtomicUsize::new(0),
|
calls: std::sync::atomic::AtomicUsize::new(0),
|
||||||
network,
|
network,
|
||||||
normal_mode_seen: std::sync::atomic::AtomicBool::new(false),
|
normal_mode_seen: std::sync::atomic::AtomicBool::new(false),
|
||||||
|
observation_calls: std::sync::atomic::AtomicUsize::new(0),
|
||||||
|
observation_response: std::option::Option::None,
|
||||||
response,
|
response,
|
||||||
};
|
};
|
||||||
}
|
}
|
||||||
|
|
||||||
|
fn with_observation_response(mut self, observation_response: ksp_store_lib::RawObservationWriteOutcome) -> Self {
|
||||||
|
self.observation_response = std::option::Option::Some(observation_response);
|
||||||
|
return self;
|
||||||
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
impl crate::RawTransactionIngestPersistencePort for FakePersistencePort {
|
impl crate::RawTransactionIngestPersistencePort for FakePersistencePort {
|
||||||
@@ -51,9 +60,50 @@ impl crate::RawTransactionIngestPersistencePort for FakePersistencePort {
|
|||||||
};
|
};
|
||||||
});
|
});
|
||||||
}
|
}
|
||||||
|
|
||||||
|
fn record_observation<'a>(
|
||||||
|
&'a self,
|
||||||
|
_observation: ksp_store_lib::RawTransactionObservation,
|
||||||
|
) -> ksp_store_lib::StoreApiFuture<'a, ksp_store_lib::Result<ksp_store_lib::RawObservationWriteOutcome>> {
|
||||||
|
self.observation_calls.fetch_add(1, std::sync::atomic::Ordering::AcqRel);
|
||||||
|
let observation_response = self.observation_response;
|
||||||
|
let response = self.response;
|
||||||
|
return std::boxed::Box::pin(async move {
|
||||||
|
if let std::option::Option::Some(outcome) = observation_response {
|
||||||
|
return std::result::Result::Ok(outcome);
|
||||||
|
}
|
||||||
|
return match response {
|
||||||
|
PortResponse::Outcome(_, observation) => std::result::Result::Ok(observation),
|
||||||
|
PortResponse::Conflict => std::result::Result::Err(ksp_core_lib::Error::new(ksp_store_lib::ERROR_CODE_RAW_CONFLICT, "synthetic conflict")),
|
||||||
|
PortResponse::StoreFailure => std::result::Result::Err(ksp_core_lib::Error::new(
|
||||||
|
ksp_core_lib::ErrorCode::new("synthetic_store", "write_failed"),
|
||||||
|
"synthetic remote failure text that must not escape",
|
||||||
|
)),
|
||||||
|
};
|
||||||
|
});
|
||||||
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
fn acquisition(network_name: &str, signature_byte: u8) -> std::option::Option<ksp_raw_transaction_lib::RawTransactionAcquisition> {
|
fn acquisition(network_name: &str, signature_byte: u8) -> std::option::Option<ksp_raw_transaction_lib::RawTransactionAcquisition> {
|
||||||
|
return acquisition_with_observation_key(network_name, signature_byte, signature_byte);
|
||||||
|
}
|
||||||
|
|
||||||
|
fn acquisition_with_observation_key(
|
||||||
|
network_name: &str,
|
||||||
|
signature_byte: u8,
|
||||||
|
observation_byte: u8,
|
||||||
|
) -> std::option::Option<ksp_raw_transaction_lib::RawTransactionAcquisition> {
|
||||||
|
return acquisition_with_shape(network_name, signature_byte, observation_byte, 42, std::option::Option::Some(1_700_000_000), "AQID");
|
||||||
|
}
|
||||||
|
|
||||||
|
fn acquisition_with_shape(
|
||||||
|
network_name: &str,
|
||||||
|
signature_byte: u8,
|
||||||
|
observation_byte: u8,
|
||||||
|
slot: u64,
|
||||||
|
block_time: std::option::Option<i64>,
|
||||||
|
transaction_data: &str,
|
||||||
|
) -> std::option::Option<ksp_raw_transaction_lib::RawTransactionAcquisition> {
|
||||||
let network = match ksp_store_lib::RawNetworkId::new(network_name) {
|
let network = match ksp_store_lib::RawNetworkId::new(network_name) {
|
||||||
std::result::Result::Ok(value) => value,
|
std::result::Result::Ok(value) => value,
|
||||||
std::result::Result::Err(_) => return std::option::Option::None,
|
std::result::Result::Err(_) => return std::option::Option::None,
|
||||||
@@ -62,9 +112,9 @@ fn acquisition(network_name: &str, signature_byte: u8) -> std::option::Option<ks
|
|||||||
let material = ksp_raw_transaction_lib::RawTransactionMaterial::binary_base64(
|
let material = ksp_raw_transaction_lib::RawTransactionMaterial::binary_base64(
|
||||||
network,
|
network,
|
||||||
signature,
|
signature,
|
||||||
42,
|
slot,
|
||||||
std::option::Option::Some(1_700_000_000),
|
block_time,
|
||||||
"AQID",
|
transaction_data,
|
||||||
ksp_raw_transaction_lib::RawTransactionWireField::Omitted,
|
ksp_raw_transaction_lib::RawTransactionWireField::Omitted,
|
||||||
ksp_raw_transaction_lib::RawTransactionWireField::Omitted,
|
ksp_raw_transaction_lib::RawTransactionWireField::Omitted,
|
||||||
ksp_raw_transaction_lib::RawTransactionWireField::Omitted,
|
ksp_raw_transaction_lib::RawTransactionWireField::Omitted,
|
||||||
@@ -92,7 +142,7 @@ fn acquisition(network_name: &str, signature_byte: u8) -> std::option::Option<ks
|
|||||||
let provenance = ksp_store_lib::RawAcquisitionProvenance::new(provider, protocol, method, ksp_store_lib::RawAcquisitionOrigin::Live, received_at);
|
let provenance = ksp_store_lib::RawAcquisitionProvenance::new(provider, protocol, method, ksp_store_lib::RawAcquisitionOrigin::Live, received_at);
|
||||||
return std::option::Option::Some(ksp_raw_transaction_lib::assemble_raw_transaction_acquisition(
|
return std::option::Option::Some(ksp_raw_transaction_lib::assemble_raw_transaction_acquisition(
|
||||||
transaction,
|
transaction,
|
||||||
ksp_store_lib::RawObservationKey::new([signature_byte; 32]),
|
ksp_store_lib::RawObservationKey::new([observation_byte; 32]),
|
||||||
provenance,
|
provenance,
|
||||||
));
|
));
|
||||||
}
|
}
|
||||||
@@ -251,3 +301,108 @@ async fn pre_007_store_network_mismatch_is_rejected_before_write() {
|
|||||||
assert_eq!(port.calls.load(std::sync::atomic::Ordering::Acquire), 0);
|
assert_eq!(port.calls.load(std::sync::atomic::Ordering::Acquire), 0);
|
||||||
return;
|
return;
|
||||||
}
|
}
|
||||||
|
|
||||||
|
#[tokio::test(flavor = "current_thread")]
|
||||||
|
async fn v0_3_13_pre_008_same_canonical_identity_uses_atomic_entity_once_then_additional_observation() {
|
||||||
|
let network = match network("mainnet") {
|
||||||
|
std::option::Option::Some(value) => value,
|
||||||
|
std::option::Option::None => return,
|
||||||
|
};
|
||||||
|
let port = FakePersistencePort::new(
|
||||||
|
network,
|
||||||
|
PortResponse::Outcome(ksp_store_lib::RawEntityWriteOutcome::Inserted, ksp_store_lib::RawObservationWriteOutcome::Inserted),
|
||||||
|
);
|
||||||
|
let convergence = crate::RawTransactionIngestPersistenceConvergence::new(8);
|
||||||
|
let first = match acquisition_with_observation_key("mainnet", 41, 1) {
|
||||||
|
std::option::Option::Some(value) => value,
|
||||||
|
std::option::Option::None => return,
|
||||||
|
};
|
||||||
|
let second = match acquisition_with_observation_key("mainnet", 41, 2) {
|
||||||
|
std::option::Option::Some(value) => value,
|
||||||
|
std::option::Option::None => return,
|
||||||
|
};
|
||||||
|
let first_outcome = crate::persist_raw_transaction_ingest_converged_acquisition(&port, first, &convergence).await;
|
||||||
|
let second_outcome = crate::persist_raw_transaction_ingest_converged_acquisition(&port, second, &convergence).await;
|
||||||
|
assert!(first_outcome.is_ok());
|
||||||
|
assert!(second_outcome.is_ok());
|
||||||
|
assert_eq!(port.calls.load(std::sync::atomic::Ordering::Acquire), 1);
|
||||||
|
assert_eq!(port.observation_calls.load(std::sync::atomic::Ordering::Acquire), 1);
|
||||||
|
let second_outcome = match second_outcome {
|
||||||
|
std::result::Result::Ok(value) => value,
|
||||||
|
std::result::Result::Err(_) => return,
|
||||||
|
};
|
||||||
|
assert_eq!(second_outcome.entity(), crate::RawTransactionIngestEntityPersistence::AlreadyPresent);
|
||||||
|
assert_eq!(second_outcome.observation(), crate::RawTransactionIngestObservationPersistence::Inserted);
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
|
||||||
|
#[tokio::test(flavor = "current_thread")]
|
||||||
|
async fn v0_3_13_pre_008_replayed_same_observation_is_idempotent_without_raw_resubmission() {
|
||||||
|
let network = match network("mainnet") {
|
||||||
|
std::option::Option::Some(value) => value,
|
||||||
|
std::option::Option::None => return,
|
||||||
|
};
|
||||||
|
let port = FakePersistencePort::new(
|
||||||
|
network,
|
||||||
|
PortResponse::Outcome(ksp_store_lib::RawEntityWriteOutcome::Inserted, ksp_store_lib::RawObservationWriteOutcome::Inserted),
|
||||||
|
)
|
||||||
|
.with_observation_response(ksp_store_lib::RawObservationWriteOutcome::AlreadyPresent);
|
||||||
|
let convergence = crate::RawTransactionIngestPersistenceConvergence::new(8);
|
||||||
|
let first = match acquisition_with_observation_key("mainnet", 42, 3) {
|
||||||
|
std::option::Option::Some(value) => value,
|
||||||
|
std::option::Option::None => return,
|
||||||
|
};
|
||||||
|
let second = match acquisition_with_observation_key("mainnet", 42, 3) {
|
||||||
|
std::option::Option::Some(value) => value,
|
||||||
|
std::option::Option::None => return,
|
||||||
|
};
|
||||||
|
let first_result = crate::persist_raw_transaction_ingest_converged_acquisition(&port, first, &convergence).await;
|
||||||
|
assert!(first_result.is_ok());
|
||||||
|
let second_result = crate::persist_raw_transaction_ingest_converged_acquisition(&port, second, &convergence).await;
|
||||||
|
let second_outcome = match second_result {
|
||||||
|
std::result::Result::Ok(value) => value,
|
||||||
|
std::result::Result::Err(_) => return,
|
||||||
|
};
|
||||||
|
assert_eq!(port.calls.load(std::sync::atomic::Ordering::Acquire), 1);
|
||||||
|
assert_eq!(port.observation_calls.load(std::sync::atomic::Ordering::Acquire), 1);
|
||||||
|
assert_eq!(second_outcome.observation(), crate::RawTransactionIngestObservationPersistence::AlreadyPresent);
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
|
||||||
|
#[tokio::test(flavor = "current_thread")]
|
||||||
|
async fn v0_3_13_pre_009_source_skew_and_provider_disagreement_fail_before_additional_observation() {
|
||||||
|
let cases = [
|
||||||
|
(43_u64, std::option::Option::Some(1_700_000_000_i64), "AQID"),
|
||||||
|
(42_u64, std::option::Option::Some(1_700_000_001_i64), "AQID"),
|
||||||
|
(42_u64, std::option::Option::Some(1_700_000_000_i64), "BAUG"),
|
||||||
|
];
|
||||||
|
for (index, (slot, block_time, transaction_data)) in cases.into_iter().enumerate() {
|
||||||
|
let network = match network("mainnet") {
|
||||||
|
std::option::Option::Some(value) => value,
|
||||||
|
std::option::Option::None => return,
|
||||||
|
};
|
||||||
|
let port = FakePersistencePort::new(
|
||||||
|
network,
|
||||||
|
PortResponse::Outcome(ksp_store_lib::RawEntityWriteOutcome::Inserted, ksp_store_lib::RawObservationWriteOutcome::Inserted),
|
||||||
|
);
|
||||||
|
let convergence = crate::RawTransactionIngestPersistenceConvergence::new(8);
|
||||||
|
let first = match acquisition_with_shape("mainnet", 51, 10, 42, std::option::Option::Some(1_700_000_000), "AQID") {
|
||||||
|
std::option::Option::Some(value) => value,
|
||||||
|
std::option::Option::None => return,
|
||||||
|
};
|
||||||
|
let divergent = match acquisition_with_shape("mainnet", 51, index as u8 + 20, slot, block_time, transaction_data) {
|
||||||
|
std::option::Option::Some(value) => value,
|
||||||
|
std::option::Option::None => return,
|
||||||
|
};
|
||||||
|
assert!(crate::persist_raw_transaction_ingest_converged_acquisition(&port, first, &convergence).await.is_ok());
|
||||||
|
let conflict = crate::persist_raw_transaction_ingest_converged_acquisition(&port, divergent, &convergence).await;
|
||||||
|
let error = match conflict {
|
||||||
|
std::result::Result::Ok(_) => return,
|
||||||
|
std::result::Result::Err(value) => value,
|
||||||
|
};
|
||||||
|
assert_eq!(error.code(), crate::ERROR_CODE_RAW_TRANSACTION_INGEST_CONTENT_CONFLICT);
|
||||||
|
assert_eq!(port.calls.load(std::sync::atomic::Ordering::Acquire), 1);
|
||||||
|
assert_eq!(port.observation_calls.load(std::sync::atomic::Ordering::Acquire), 0);
|
||||||
|
}
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
|||||||
@@ -1,5 +1,5 @@
|
|||||||
// file: crates/ksp-worker-raw-transaction-ingest-lib/unit_tests/runtime.rs
|
// file: crates/ksp-worker-raw-transaction-ingest-lib/unit_tests/runtime.rs
|
||||||
// version: 9
|
// version: 11
|
||||||
|
|
||||||
struct ActiveTaskGuard {
|
struct ActiveTaskGuard {
|
||||||
active: std::sync::Arc<std::sync::atomic::AtomicUsize>,
|
active: std::sync::Arc<std::sync::atomic::AtomicUsize>,
|
||||||
@@ -348,6 +348,36 @@ impl crate::RawTransactionIngestPersistencePort for RuntimePersistencePort {
|
|||||||
));
|
));
|
||||||
});
|
});
|
||||||
}
|
}
|
||||||
|
|
||||||
|
fn record_observation<'a>(
|
||||||
|
&'a self,
|
||||||
|
_observation: ksp_store_lib::RawTransactionObservation,
|
||||||
|
) -> ksp_store_lib::StoreApiFuture<'a, ksp_store_lib::Result<ksp_store_lib::RawObservationWriteOutcome>> {
|
||||||
|
let response = self.response;
|
||||||
|
return std::boxed::Box::pin(async move {
|
||||||
|
if matches!(response, RuntimePortResponse::StoreFailureBlocked | RuntimePortResponse::SuccessBlocked) {
|
||||||
|
let current = self.active.fetch_add(1, std::sync::atomic::Ordering::AcqRel) + 1;
|
||||||
|
let _active_guard = RuntimePortActiveGuard { active: &self.active };
|
||||||
|
self.update_max_active(current);
|
||||||
|
while !self.released.load(std::sync::atomic::Ordering::Acquire) {
|
||||||
|
self.notify.notified().await;
|
||||||
|
}
|
||||||
|
if matches!(response, RuntimePortResponse::SuccessBlocked) {
|
||||||
|
self.completed.fetch_add(1, std::sync::atomic::Ordering::AcqRel);
|
||||||
|
return std::result::Result::Ok(ksp_store_lib::RawObservationWriteOutcome::Inserted);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
if matches!(response, RuntimePortResponse::Conflict) {
|
||||||
|
self.completed.fetch_add(1, std::sync::atomic::Ordering::AcqRel);
|
||||||
|
return std::result::Result::Err(ksp_core_lib::Error::new(ksp_store_lib::ERROR_CODE_RAW_CONFLICT, "synthetic conflict"));
|
||||||
|
}
|
||||||
|
self.completed.fetch_add(1, std::sync::atomic::Ordering::AcqRel);
|
||||||
|
return std::result::Result::Err(ksp_core_lib::Error::new(
|
||||||
|
ksp_core_lib::ErrorCode::new("synthetic_store", "write_failed"),
|
||||||
|
"synthetic store failure",
|
||||||
|
));
|
||||||
|
});
|
||||||
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
fn runtime_ingress(network: &ksp_store_lib::RawNetworkId, signature_byte: u8) -> std::option::Option<crate::RawTransactionIngress> {
|
fn runtime_ingress(network: &ksp_store_lib::RawNetworkId, signature_byte: u8) -> std::option::Option<crate::RawTransactionIngress> {
|
||||||
@@ -869,3 +899,98 @@ async fn pre_009_drain_timeout_aborts_and_joins_all_owned_source_and_persistence
|
|||||||
assert_eq!(port.completed.load(std::sync::atomic::Ordering::Acquire), 0);
|
assert_eq!(port.completed.load(std::sync::atomic::Ordering::Acquire), 0);
|
||||||
return;
|
return;
|
||||||
}
|
}
|
||||||
|
|
||||||
|
#[tokio::test(flavor = "current_thread")]
|
||||||
|
async fn v0_3_13_pre_011_source_counter_exhaustion_stays_terminal_and_is_not_collapsed_to_source_failed() {
|
||||||
|
let settings = match settings("mainnet") {
|
||||||
|
std::option::Option::Some(value) => value,
|
||||||
|
std::option::Option::None => return,
|
||||||
|
};
|
||||||
|
let handle = match super::start_foundation_with_source_spawner(
|
||||||
|
settings,
|
||||||
|
tokio::runtime::Handle::current(),
|
||||||
|
std::option::Option::None,
|
||||||
|
move |children: &mut tokio::task::JoinSet<ksp_core_lib::Result<()>>, _stop_receiver, _admission_sender| {
|
||||||
|
let _abort_handle = children.spawn(async move {
|
||||||
|
return std::result::Result::Err(crate::counter_exhausted_error("source_reconnect_total"));
|
||||||
|
});
|
||||||
|
},
|
||||||
|
) {
|
||||||
|
std::result::Result::Ok(value) => value,
|
||||||
|
std::result::Result::Err(_) => return,
|
||||||
|
};
|
||||||
|
let source = handle.snapshot_source();
|
||||||
|
let terminal = match handle.wait_terminal().await {
|
||||||
|
std::result::Result::Ok(value) => value,
|
||||||
|
std::result::Result::Err(_) => return,
|
||||||
|
};
|
||||||
|
assert_eq!(terminal, ksp_worker_api::WorkerState::Faulted(crate::ERROR_CODE_RAW_TRANSACTION_INGEST_COUNTER_EXHAUSTED));
|
||||||
|
let snapshot = source.current();
|
||||||
|
assert_eq!(snapshot.source_failure_total(), 1);
|
||||||
|
assert_eq!(snapshot.worker_snapshot().state(), terminal);
|
||||||
|
assert_eq!(snapshot.worker_snapshot().health(), ksp_worker_api::WorkerHealth::Unhealthy);
|
||||||
|
let terminal_sequence = snapshot.worker_snapshot().sequence();
|
||||||
|
assert!(!handle.request_stop());
|
||||||
|
let retained = source.current();
|
||||||
|
assert_eq!(retained.worker_snapshot().state(), terminal);
|
||||||
|
assert_eq!(retained.worker_snapshot().sequence(), terminal_sequence);
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
|
||||||
|
#[tokio::test(flavor = "current_thread")]
|
||||||
|
async fn v0_3_13_pre_011_drain_timeout_prevents_late_persistence_completion_after_terminal() {
|
||||||
|
let settings = match settings_with_runtime_limits(1, 1, crate::MIN_RAW_TRANSACTION_INGEST_SHUTDOWN_DRAIN_TIMEOUT) {
|
||||||
|
std::option::Option::Some(value) => value,
|
||||||
|
std::option::Option::None => return,
|
||||||
|
};
|
||||||
|
let network = settings.network().clone();
|
||||||
|
let port = std::sync::Arc::new(RuntimePersistencePort::new(network.clone(), RuntimePortResponse::SuccessBlocked, false));
|
||||||
|
let runtime_port: super::PersistencePort = port.clone();
|
||||||
|
let source_active = std::sync::Arc::new(std::sync::atomic::AtomicUsize::new(0));
|
||||||
|
let source_active_for_task = std::sync::Arc::clone(&source_active);
|
||||||
|
let handle = match super::start_foundation_with_port_and_source_spawner(
|
||||||
|
settings,
|
||||||
|
tokio::runtime::Handle::current(),
|
||||||
|
std::option::Option::Some(runtime_port),
|
||||||
|
move |children, _stop_receiver, admission_sender| {
|
||||||
|
let _abort_handle = children.spawn(async move {
|
||||||
|
let ingress = match runtime_ingress(&network, 81) {
|
||||||
|
std::option::Option::Some(value) => value,
|
||||||
|
std::option::Option::None => return std::result::Result::Err(crate::runtime_error("test.ingress_invalid")),
|
||||||
|
};
|
||||||
|
if admission_sender.send(ingress).await.is_err() {
|
||||||
|
return std::result::Result::Err(crate::runtime_error("test.source_failed"));
|
||||||
|
}
|
||||||
|
let _guard = ActiveTaskGuard::new(source_active_for_task);
|
||||||
|
return std::future::pending::<ksp_core_lib::Result<()>>().await;
|
||||||
|
});
|
||||||
|
},
|
||||||
|
) {
|
||||||
|
std::result::Result::Ok(value) => value,
|
||||||
|
std::result::Result::Err(_) => return,
|
||||||
|
};
|
||||||
|
assert!(wait_for_max_active(&port, 1).await);
|
||||||
|
assert!(wait_for_active_count(&source_active, 1).await);
|
||||||
|
assert!(handle.request_stop());
|
||||||
|
let terminal = match handle.wait_terminal().await {
|
||||||
|
std::result::Result::Ok(value) => value,
|
||||||
|
std::result::Result::Err(_) => return,
|
||||||
|
};
|
||||||
|
assert_eq!(terminal, ksp_worker_api::WorkerState::Faulted(crate::ERROR_CODE_RAW_TRANSACTION_INGEST_DRAIN_TIMEOUT));
|
||||||
|
let snapshot = handle.snapshot_source().current();
|
||||||
|
let terminal_sequence = snapshot.worker_snapshot().sequence();
|
||||||
|
assert_eq!(snapshot.in_flight_persistence(), 0);
|
||||||
|
assert_eq!(port.active.load(std::sync::atomic::Ordering::Acquire), 0);
|
||||||
|
assert_eq!(port.completed.load(std::sync::atomic::Ordering::Acquire), 0);
|
||||||
|
assert_eq!(source_active.load(std::sync::atomic::Ordering::Acquire), 0);
|
||||||
|
port.release();
|
||||||
|
for _ in 0..64 {
|
||||||
|
tokio::task::yield_now().await;
|
||||||
|
}
|
||||||
|
assert_eq!(port.completed.load(std::sync::atomic::Ordering::Acquire), 0);
|
||||||
|
let retained = handle.snapshot_source().current();
|
||||||
|
assert_eq!(retained.worker_snapshot().state(), terminal);
|
||||||
|
assert_eq!(retained.worker_snapshot().sequence(), terminal_sequence);
|
||||||
|
assert_eq!(retained.in_flight_persistence(), 0);
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
|||||||
File diff suppressed because it is too large
Load Diff
@@ -1,7 +1,9 @@
|
|||||||
// file: crates/ksp-worker-raw-transaction-ingest-lib/unit_tests/snapshot.rs
|
// file: crates/ksp-worker-raw-transaction-ingest-lib/unit_tests/snapshot.rs
|
||||||
// version: 4
|
// version: 5
|
||||||
|
|
||||||
fn snapshot_foundation() -> std::option::Option<(crate::RawTransactionIngestSnapshotPublisher, crate::RawTransactionIngestSnapshotSource)> {
|
fn snapshot_foundation_with_source_total(
|
||||||
|
source_total: usize,
|
||||||
|
) -> std::option::Option<(crate::RawTransactionIngestSnapshotPublisher, crate::RawTransactionIngestSnapshotSource)> {
|
||||||
let network = match ksp_store_lib::RawNetworkId::new("mainnet") {
|
let network = match ksp_store_lib::RawNetworkId::new("mainnet") {
|
||||||
std::result::Result::Ok(value) => value,
|
std::result::Result::Ok(value) => value,
|
||||||
std::result::Result::Err(_) => return std::option::Option::None,
|
std::result::Result::Err(_) => return std::option::Option::None,
|
||||||
@@ -19,7 +21,11 @@ fn snapshot_foundation() -> std::option::Option<(crate::RawTransactionIngestSnap
|
|||||||
if lifecycle.start().is_err() {
|
if lifecycle.start().is_err() {
|
||||||
return std::option::Option::None;
|
return std::option::Option::None;
|
||||||
}
|
}
|
||||||
return std::option::Option::Some(crate::RawTransactionIngestSnapshotPublisher::new(&settings, &lifecycle));
|
return std::option::Option::Some(crate::RawTransactionIngestSnapshotPublisher::new(&settings, &lifecycle, source_total));
|
||||||
|
}
|
||||||
|
|
||||||
|
fn snapshot_foundation() -> std::option::Option<(crate::RawTransactionIngestSnapshotPublisher, crate::RawTransactionIngestSnapshotSource)> {
|
||||||
|
return snapshot_foundation_with_source_total(0);
|
||||||
}
|
}
|
||||||
|
|
||||||
#[test]
|
#[test]
|
||||||
@@ -54,6 +60,10 @@ fn pre_008_initial_snapshot_and_common_projection_are_exact() {
|
|||||||
assert_eq!(concrete.processing_frontier_slot(), std::option::Option::None);
|
assert_eq!(concrete.processing_frontier_slot(), std::option::Option::None);
|
||||||
assert_eq!(concrete.oldest_pending_slot(), std::option::Option::None);
|
assert_eq!(concrete.oldest_pending_slot(), std::option::Option::None);
|
||||||
assert_eq!(concrete.source_state(), std::option::Option::None);
|
assert_eq!(concrete.source_state(), std::option::Option::None);
|
||||||
|
assert_eq!(concrete.source_total(), 0);
|
||||||
|
assert_eq!(concrete.source_active(), 0);
|
||||||
|
assert_eq!(concrete.source_reconnecting(), 0);
|
||||||
|
assert_eq!(concrete.source_failed(), 0);
|
||||||
assert_eq!(concrete.source_reconnect_total(), 0);
|
assert_eq!(concrete.source_reconnect_total(), 0);
|
||||||
assert_eq!(concrete.source_replay_attempt_total(), 0);
|
assert_eq!(concrete.source_replay_attempt_total(), 0);
|
||||||
assert_eq!(concrete.source_continuity_gap_total(), 0);
|
assert_eq!(concrete.source_continuity_gap_total(), 0);
|
||||||
@@ -199,3 +209,43 @@ fn pre_008_source_continuity_projection_preserves_processing_frontier_and_distin
|
|||||||
assert_eq!(resumed.worker_snapshot().activity(), ksp_worker_api::WorkerActivity::Idle);
|
assert_eq!(resumed.worker_snapshot().activity(), ksp_worker_api::WorkerActivity::Idle);
|
||||||
return;
|
return;
|
||||||
}
|
}
|
||||||
|
|
||||||
|
#[test]
|
||||||
|
fn v0_3_13_pre_010_multi_source_counts_and_health_are_conservative_and_source_neutral() {
|
||||||
|
let (mut publisher, source) = match snapshot_foundation_with_source_total(3) {
|
||||||
|
std::option::Option::Some(value) => value,
|
||||||
|
std::option::Option::None => return,
|
||||||
|
};
|
||||||
|
let initial = source.current();
|
||||||
|
assert_eq!(initial.source_total(), 3);
|
||||||
|
assert_eq!(initial.source_active(), 0);
|
||||||
|
assert_eq!(initial.source_reconnecting(), 0);
|
||||||
|
assert_eq!(initial.source_failed(), 0);
|
||||||
|
assert_eq!(initial.worker_snapshot().health(), ksp_worker_api::WorkerHealth::Unknown);
|
||||||
|
let reconnecting = crate::RawTransactionIngestProcessingFrontierProjection::new(1, std::option::Option::Some(50), std::option::Option::Some(50))
|
||||||
|
.with_source_continuity(std::option::Option::Some(crate::RawTransactionIngestSourceState::Reconnecting), 0, 1, 0)
|
||||||
|
.with_source_counts(3, 2, 1, 0);
|
||||||
|
assert!(publisher.record_processing_frontier(ksp_worker_api::WorkerState::Running, 0, 0, reconnecting).is_ok());
|
||||||
|
let degraded = source.current();
|
||||||
|
assert_eq!(degraded.source_total(), 3);
|
||||||
|
assert_eq!(degraded.source_active(), 2);
|
||||||
|
assert_eq!(degraded.source_reconnecting(), 1);
|
||||||
|
assert_eq!(degraded.source_failed(), 0);
|
||||||
|
assert_eq!(degraded.worker_snapshot().health(), ksp_worker_api::WorkerHealth::Degraded);
|
||||||
|
assert_eq!(degraded.worker_snapshot().activity(), ksp_worker_api::WorkerActivity::Active);
|
||||||
|
let active = crate::RawTransactionIngestProcessingFrontierProjection::new(0, std::option::Option::Some(51), std::option::Option::None)
|
||||||
|
.with_source_continuity(std::option::Option::Some(crate::RawTransactionIngestSourceState::Active), 1, 1, 0)
|
||||||
|
.with_source_counts(3, 3, 0, 0);
|
||||||
|
assert!(publisher.record_processing_frontier(ksp_worker_api::WorkerState::Running, 0, 0, active).is_ok());
|
||||||
|
let healthy = source.current();
|
||||||
|
assert_eq!(healthy.worker_snapshot().health(), ksp_worker_api::WorkerHealth::Healthy);
|
||||||
|
assert_eq!(healthy.worker_snapshot().activity(), ksp_worker_api::WorkerActivity::Idle);
|
||||||
|
let failed = crate::RawTransactionIngestProcessingFrontierProjection::new(0, std::option::Option::Some(51), std::option::Option::None)
|
||||||
|
.with_source_continuity(std::option::Option::Some(crate::RawTransactionIngestSourceState::Failed), 1, 1, 0)
|
||||||
|
.with_source_counts(3, 2, 0, 1);
|
||||||
|
assert!(publisher.record_processing_frontier(ksp_worker_api::WorkerState::Running, 0, 0, failed).is_ok());
|
||||||
|
let unhealthy = source.current();
|
||||||
|
assert_eq!(unhealthy.source_failed(), 1);
|
||||||
|
assert_eq!(unhealthy.worker_snapshot().health(), ksp_worker_api::WorkerHealth::Unhealthy);
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
|||||||
274
deltas/0.3.13/pre.001.md
Normal file
274
deltas/0.3.13/pre.001.md
Normal file
@@ -0,0 +1,274 @@
|
|||||||
|
<!-- file: deltas/0.3.13/pre.001.md -->
|
||||||
|
<!-- version: 1 -->
|
||||||
|
|
||||||
|
# Delta 0.3.13-pre.001 — audit règles et convergence live multi-source
|
||||||
|
|
||||||
|
## Base requise
|
||||||
|
|
||||||
|
```text
|
||||||
|
archive : khadhroony-solana-project-v0.3.12.zip
|
||||||
|
SHA-256 : 85c41eb9f8575ee58edd9863445cbc37b79ef59c4a7cf882679ff24dc8991bf5
|
||||||
|
ZIP bytes : 8260528
|
||||||
|
ZIP entries : 1981
|
||||||
|
workspace.package.version base : 0.3.12
|
||||||
|
stable delta : deltas/0.3.12/rel.001.md
|
||||||
|
prompt : prompts/032-V0_3_13_START_PROMPT.md
|
||||||
|
```
|
||||||
|
|
||||||
|
## Objectif
|
||||||
|
|
||||||
|
Exécuter le gate `pre.001` de `0.3.13` avant tout développement : vérifier l'archive stable et les règles, réauditer les surfaces WS standard/Helius/HTTP actuelles, fermer l'architecture de convergence multi-source, les bornes, la stratégie d'observations multiples, le content conflict, les owners retry/reconnect, les smokes et le sizing.
|
||||||
|
|
||||||
|
Aucune nouvelle source réseau productive n'est implémentée dans cette tranche.
|
||||||
|
|
||||||
|
## Type de livraison
|
||||||
|
|
||||||
|
```text
|
||||||
|
0.3.13-pre.001
|
||||||
|
Cargo : 0.3.13-pre.1
|
||||||
|
archive : ksp-general-0.3.13-pre.001.zip
|
||||||
|
```
|
||||||
|
|
||||||
|
Le type `general` est requis par la synchronisation de `Cargo.toml` pour une prerelease non-fix.
|
||||||
|
|
||||||
|
## Vérification archive
|
||||||
|
|
||||||
|
Contrôlé :
|
||||||
|
|
||||||
|
```text
|
||||||
|
unzip -t : PASS
|
||||||
|
absolute entries : 0
|
||||||
|
parent traversal : 0
|
||||||
|
duplicate ZIP entries : 0
|
||||||
|
symlink entries : 0
|
||||||
|
Cargo.lock : absent
|
||||||
|
rust-toolchain.toml : absent
|
||||||
|
package lockfiles : absents
|
||||||
|
.env : absent
|
||||||
|
crate manifests : 21
|
||||||
|
workspace members : 21
|
||||||
|
crates hors workspace : 0
|
||||||
|
members sans crate : 0
|
||||||
|
workspace edition : 2024
|
||||||
|
```
|
||||||
|
|
||||||
|
## Audit règles
|
||||||
|
|
||||||
|
Les règles actives ont été relues depuis `RULES.md` et les neuf documents de `docs/rules/`.
|
||||||
|
|
||||||
|
Le script Rust stable reste vert, mais un contrôle supplémentaire d'unicité des identifiants normatifs a trouvé :
|
||||||
|
|
||||||
|
```text
|
||||||
|
rule ids : 489
|
||||||
|
unique ids : 488
|
||||||
|
collision : KSP-CONFIG-018 x2
|
||||||
|
```
|
||||||
|
|
||||||
|
La preuve historique `deltas/0.1.3/pre.014.md` attribue explicitement `KSP-CONFIG-018` à la règle d'inventaire `.env.example`. La règle desktop plus récente est donc renumérotée `KSP-CONFIG-019` sans modification de sa sémantique.
|
||||||
|
|
||||||
|
Après correction :
|
||||||
|
|
||||||
|
```text
|
||||||
|
rule ids : 489
|
||||||
|
unique ids : 489
|
||||||
|
duplicates : 0
|
||||||
|
```
|
||||||
|
|
||||||
|
Aucune autre contradiction normative active n'a été identifiée.
|
||||||
|
|
||||||
|
## Audit architecture/dépendances
|
||||||
|
|
||||||
|
Confirmé :
|
||||||
|
|
||||||
|
```text
|
||||||
|
Worker -> Transport autorisé et déjà productif
|
||||||
|
Worker -> Config interdit et absent
|
||||||
|
Worker -> Job Backfill interdit et absent
|
||||||
|
Worker -> backend Store physique interdit et absent
|
||||||
|
Worker -> reqwest/tonic/yellowstone proto direct absent
|
||||||
|
Transport -> Store absent
|
||||||
|
Transport -> Common RAW absent
|
||||||
|
ksp-store-lib reste la façade de persistence Worker
|
||||||
|
Common RAW reste propriétaire de la canonicalisation
|
||||||
|
```
|
||||||
|
|
||||||
|
`solana-keypair` dans `ksp-wallet-lib` est explicitement admis par `DEP-SOL-004` et ne constitue pas une violation.
|
||||||
|
|
||||||
|
## Audit WS / Helius / HTTP courant
|
||||||
|
|
||||||
|
Décisions :
|
||||||
|
|
||||||
|
```text
|
||||||
|
logsSubscribe standard -> signature/slot -> getTransaction observed
|
||||||
|
blockSubscribe standard -> full/base64, maxSupportedTransactionVersion=1
|
||||||
|
Helius transactionSubscribe -> full/base64 -> getTransaction observed
|
||||||
|
Helius LaserStream WSS ne porte pas blockSubscribe
|
||||||
|
HTTP live -> getSlot + getBlocksWithLimit + getBlock observed
|
||||||
|
```
|
||||||
|
|
||||||
|
La documentation Solana courante demande la préparation `maxSupportedTransactionVersion = 1` pour Transaction V1. V1 n'est pas encore actif sur les clusters publics au 10 septembre 2026, donc la voie `blockSubscribe` V1 reste deterministic-test-gated avant d'être déclarée RAW-direct.
|
||||||
|
|
||||||
|
Le pricing Helius courant place `transactionSubscribe` à partir du tier Developer ; ce fait reste une qualification de smoke, jamais une constante métier KSP.
|
||||||
|
|
||||||
|
## Architecture multi-source fermée
|
||||||
|
|
||||||
|
Décisions principales :
|
||||||
|
|
||||||
|
```text
|
||||||
|
sources simultanées, pas de first-provider-wins
|
||||||
|
source identity opaque SHA-256 et provider-neutral
|
||||||
|
1..32 sources runtime
|
||||||
|
collection validée avant tout spawn
|
||||||
|
coordinator global Worker avant hydration
|
||||||
|
coalescence (network, signature, commitment)
|
||||||
|
une hydration HTTP pour les références cross-source identiques
|
||||||
|
pending global <= admission_queue_capacity effective
|
||||||
|
hydratation in-flight <= persistence_concurrency
|
||||||
|
aucune queue Worker provider privée non bornée
|
||||||
|
```
|
||||||
|
|
||||||
|
Observation/persistence :
|
||||||
|
|
||||||
|
```text
|
||||||
|
identité durable = network + signature
|
||||||
|
première observation = persist_raw_transaction_acquisition atomique
|
||||||
|
observations supplémentaires = record_raw_transaction_observation
|
||||||
|
même identité + même contenu = idempotence
|
||||||
|
même identité + contenu divergent = content conflict terminal
|
||||||
|
```
|
||||||
|
|
||||||
|
La capability Store d'observation additionnelle existe déjà ; aucun changement Store API n'est requis.
|
||||||
|
|
||||||
|
## HTTP live polling
|
||||||
|
|
||||||
|
Contrat de plan retenu :
|
||||||
|
|
||||||
|
```text
|
||||||
|
run start = getSlot(commitment)
|
||||||
|
aucun scan avant ce start slot
|
||||||
|
getBlocksWithLimit pour exclure naturellement skipped slots
|
||||||
|
getBlock observed pour chaque bloc listé
|
||||||
|
poll interval : 100 ms..30 s, default 1 s
|
||||||
|
blocks/cycle : 1..1024, default 128
|
||||||
|
timer/cadence : Worker
|
||||||
|
retry/rate-limit HTTP : Transport
|
||||||
|
```
|
||||||
|
|
||||||
|
## Health et continuité
|
||||||
|
|
||||||
|
Le Worker conservera un inventaire de source privé et borné. La surface publique restera source-neutral avec des counts agrégés seulement.
|
||||||
|
|
||||||
|
Politique `0.3.13` conservative : une source configurée qui devient terminalement `Failed` faute le Worker, car l'équivalence de coverage des autres sources n'est pas prouvée. Le failover non-terminal et le repair appartiennent à `0.3.14`.
|
||||||
|
|
||||||
|
## Sizing retenu
|
||||||
|
|
||||||
|
```text
|
||||||
|
pre.002 runtime resources multi-source
|
||||||
|
pre.003 standard logs + hydration
|
||||||
|
pre.004 standard blockSubscribe
|
||||||
|
pre.005 Helius transactionSubscribe
|
||||||
|
pre.006 HTTP live polling
|
||||||
|
pre.007 supervisor/source inventory
|
||||||
|
pre.008 convergence/observations multiples
|
||||||
|
pre.009 conflict/backpressure/fairness
|
||||||
|
pre.010 snapshots/health
|
||||||
|
pre.011 races/shutdown
|
||||||
|
pre.012 completeness/security
|
||||||
|
pre.013 gate technique/live
|
||||||
|
pre.014 réconciliation documentaire
|
||||||
|
pre.015 préparation publication
|
||||||
|
rel.001 stable
|
||||||
|
```
|
||||||
|
|
||||||
|
Décision : `0.3.13` est maintenue ; aucune rescission n'est nécessaire avant `pre.002`.
|
||||||
|
|
||||||
|
## Fichiers ajoutés
|
||||||
|
|
||||||
|
```text
|
||||||
|
docs/plans/034-V0_3_13_MULTI_SOURCE_LIVE_CONVERGENCE_PLAN.md
|
||||||
|
docs/validation/030-V0_3_13_MULTI_SOURCE_LIVE_CONVERGENCE.md
|
||||||
|
deltas/0.3.13/pre.001.md
|
||||||
|
```
|
||||||
|
|
||||||
|
## Fichiers modifiés
|
||||||
|
|
||||||
|
```text
|
||||||
|
Cargo.toml
|
||||||
|
docs/rules/RULES_KSP.md
|
||||||
|
```
|
||||||
|
|
||||||
|
## Fichiers supprimés
|
||||||
|
|
||||||
|
```text
|
||||||
|
aucun
|
||||||
|
```
|
||||||
|
|
||||||
|
## Validations exécutées avant modification
|
||||||
|
|
||||||
|
```text
|
||||||
|
python3 scripts/audit_rust_workspace_rules.py
|
||||||
|
PASS : General Rust rule audit clean
|
||||||
|
PASS : Rust export completeness audit 0 candidate
|
||||||
|
PASS : KSP workspace Rust rule audit clean
|
||||||
|
|
||||||
|
python3 scripts/audit_markdown_tables.py README.md RULES.md ROADMAP.md CHANGELOG.md docs prompts crates deltas/0.3.12
|
||||||
|
PASS : Markdown table audit clean (306 tables, 199 files)
|
||||||
|
```
|
||||||
|
|
||||||
|
La preuve Cargo stable fournie par l'opérateur montre également fmt/check/clippy/tests Worker/trees verts sur `0.3.12`; elle reste une preuve de la base et non une exécution locale de cette prerelease.
|
||||||
|
|
||||||
|
## Validations exécutées après modification
|
||||||
|
|
||||||
|
```text
|
||||||
|
python3 scripts/audit_rust_workspace_rules.py
|
||||||
|
PASS : General Rust rule audit clean
|
||||||
|
PASS : Rust export completeness audit 0 candidate
|
||||||
|
PASS : KSP workspace Rust rule audit clean
|
||||||
|
|
||||||
|
supplemental normative rule-id scan
|
||||||
|
PASS : 489 ids, 489 uniques, 0 duplicate
|
||||||
|
|
||||||
|
python3 scripts/audit_markdown_tables.py README.md RULES.md ROADMAP.md CHANGELOG.md docs prompts crates deltas
|
||||||
|
PASS : Markdown table audit clean (340 tables, 828 files)
|
||||||
|
```
|
||||||
|
|
||||||
|
## Validations non exécutées localement
|
||||||
|
|
||||||
|
Le toolchain Cargo/Rustfmt n'est pas installé dans l'environnement d'assemblage :
|
||||||
|
|
||||||
|
```text
|
||||||
|
cargo fmt --all -- --check
|
||||||
|
cargo check --workspace
|
||||||
|
cargo clippy --workspace --all-targets --all-features -- -D warnings
|
||||||
|
cargo test -p ksp-worker-raw-transaction-ingest-lib
|
||||||
|
cargo tree -p ksp-worker-raw-transaction-ingest-lib --edges normal
|
||||||
|
cargo tree -p ksp-worker-raw-transaction-ingest-lib -e features
|
||||||
|
cargo tree --duplicates
|
||||||
|
```
|
||||||
|
|
||||||
|
Statut : `NON EXÉCUTÉ LOCAL`, jamais PASS.
|
||||||
|
|
||||||
|
## Décisions prises
|
||||||
|
|
||||||
|
```text
|
||||||
|
corriger l'identifiant desktop en KSP-CONFIG-019
|
||||||
|
maintenir la release 0.3.13
|
||||||
|
aucune nouvelle dépendance externe
|
||||||
|
maxSupportedTransactionVersion=1 pour les nouvelles voies concernées
|
||||||
|
convergence/hydration globale Worker-owned
|
||||||
|
observation fanout via capability Store existante
|
||||||
|
source failure terminale conservative jusqu'au coverage/repair 0.3.14
|
||||||
|
```
|
||||||
|
|
||||||
|
## Questions ouvertes
|
||||||
|
|
||||||
|
Reportées explicitement :
|
||||||
|
|
||||||
|
```text
|
||||||
|
coverage équivalent entre sources
|
||||||
|
failover non-terminal
|
||||||
|
repair de gaps multi-source
|
||||||
|
sources EARLY
|
||||||
|
campagnes historiques multi-source
|
||||||
|
composition Desk 0.3.15
|
||||||
|
```
|
||||||
171
deltas/0.3.13/pre.002-fix.001.md
Normal file
171
deltas/0.3.13/pre.002-fix.001.md
Normal file
@@ -0,0 +1,171 @@
|
|||||||
|
<!-- file: deltas/0.3.13/pre.002-fix.001.md -->
|
||||||
|
<!-- version: 1 -->
|
||||||
|
|
||||||
|
# Delta 0.3.13-pre.002-fix.001 — normalisation rustfmt du root Worker
|
||||||
|
|
||||||
|
## Base requise
|
||||||
|
|
||||||
|
```text
|
||||||
|
delivery précédente : 0.3.13-pre.002
|
||||||
|
Cargo base : 0.3.13-pre.2
|
||||||
|
delta base : deltas/0.3.13/pre.002.md
|
||||||
|
archive delta base : ksp-general-0.3.13-pre.002.zip
|
||||||
|
SHA-256 delta base : 9e7c65d2340fe4918fcfa285cc14beabe4cccd3af1a58aa86e1d24a7ac8bf7b2
|
||||||
|
```
|
||||||
|
|
||||||
|
Le gate opérateur exécuté après application de `pre.002` a identifié un seul défaut : `cargo fmt --all -- --check` demande le tri de l'export `MAX_RAW_TRANSACTION_INGEST_LIVE_SOURCES` après les exports du module `runtime`. Les audits Rust/Markdown, `cargo check --workspace`, Clippy strict et les suites Transport/Worker exécutées ensuite sont verts.
|
||||||
|
|
||||||
|
## Objectif
|
||||||
|
|
||||||
|
Corriger strictement le défaut de format de `pre.002`, sans modification fonctionnelle :
|
||||||
|
|
||||||
|
```text
|
||||||
|
aucune API ajoutée ou supprimée
|
||||||
|
aucune signature modifiée
|
||||||
|
aucune dépendance modifiée
|
||||||
|
aucune logique runtime modifiée
|
||||||
|
aucun changement du plan pre.003+
|
||||||
|
réordonnancement rustfmt uniquement dans le root Worker
|
||||||
|
```
|
||||||
|
|
||||||
|
## Type de livraison
|
||||||
|
|
||||||
|
```text
|
||||||
|
livraison : 0.3.13-pre.002-fix.001
|
||||||
|
Cargo : 0.3.13-pre.2.fix.1
|
||||||
|
archive : ksp-general-0.3.13-pre.002-fix.001.zip
|
||||||
|
```
|
||||||
|
|
||||||
|
Conformément à `VER-ID-007` et `VER-ID-010`, le correctif touche un fichier `.rs`; `workspace.package.version` est donc synchronisé avec l'identifiant SemVer technique du fix.
|
||||||
|
|
||||||
|
## Correction
|
||||||
|
|
||||||
|
Dans `crates/ksp-worker-raw-transaction-ingest-lib/src/lib.rs`, l'export :
|
||||||
|
|
||||||
|
```text
|
||||||
|
MAX_RAW_TRANSACTION_INGEST_LIVE_SOURCES
|
||||||
|
```
|
||||||
|
|
||||||
|
est déplacé après le groupe des exports `runtime`, exactement comme demandé par `rustfmt` dans le gate opérateur.
|
||||||
|
|
||||||
|
L'ordre corrigé est :
|
||||||
|
|
||||||
|
```text
|
||||||
|
RAW_TRANSACTION_INGEST_WORKER_KIND_CODE
|
||||||
|
RawTransactionIngestHandle
|
||||||
|
RawTransactionIngestTerminalFuture
|
||||||
|
RawTransactionIngestWorker
|
||||||
|
MAX_RAW_TRANSACTION_INGEST_LIVE_SOURCES
|
||||||
|
RawTransactionIngestRuntimeResources
|
||||||
|
RawTransactionIngestYellowstoneSource
|
||||||
|
```
|
||||||
|
|
||||||
|
Le changement est purement lexical. La constante, sa visibilité, son chemin public et sa valeur restent inchangés.
|
||||||
|
|
||||||
|
## Fichiers ajoutés
|
||||||
|
|
||||||
|
```text
|
||||||
|
deltas/0.3.13/pre.002-fix.001.md
|
||||||
|
```
|
||||||
|
|
||||||
|
## Fichiers modifiés
|
||||||
|
|
||||||
|
```text
|
||||||
|
Cargo.toml
|
||||||
|
crates/ksp-worker-raw-transaction-ingest-lib/src/lib.rs
|
||||||
|
```
|
||||||
|
|
||||||
|
## Fichiers supprimés
|
||||||
|
|
||||||
|
```text
|
||||||
|
aucun
|
||||||
|
```
|
||||||
|
|
||||||
|
## Versions de fichiers incrémentées
|
||||||
|
|
||||||
|
```text
|
||||||
|
Cargo.toml : 540 -> 541
|
||||||
|
worker lib.rs : 18 -> 19
|
||||||
|
```
|
||||||
|
|
||||||
|
## Validations exécutées sur la base pre.002 par l'opérateur
|
||||||
|
|
||||||
|
Le log opérateur fourni pour `0.3.13-pre.2` confirme :
|
||||||
|
|
||||||
|
```text
|
||||||
|
cargo fmt --all -- --check : FAIL, uniquement diff de tri d'exports dans worker src/lib.rs
|
||||||
|
General Rust rule audit : clean
|
||||||
|
Rust export completeness audit : 0 candidate(s)
|
||||||
|
KSP workspace Rust rule audit : clean
|
||||||
|
Markdown table audit : clean (340 tables, 829 files)
|
||||||
|
cargo check --workspace : PASS
|
||||||
|
cargo clippy --workspace --all-targets --all-features -- -D warnings : PASS
|
||||||
|
cargo test -p ksp-onchain-transport-lib : PASS
|
||||||
|
cargo test -p ksp-worker-raw-transaction-ingest-lib : PASS
|
||||||
|
```
|
||||||
|
|
||||||
|
Suites explicitement observées :
|
||||||
|
|
||||||
|
```text
|
||||||
|
Transport unit : 389 passed
|
||||||
|
Transport public_api : 52 passed
|
||||||
|
Transport release_completeness : 44 passed
|
||||||
|
Transport doc-tests : 4 passed
|
||||||
|
smokes réseau : ignored / opt-in conformément au contrat
|
||||||
|
Worker unit : 70 passed
|
||||||
|
Worker cross_layer_completeness : 4 passed
|
||||||
|
Worker dependency_boundary : 9 passed
|
||||||
|
Worker hardening : 16 passed
|
||||||
|
Worker public_api : 10 passed
|
||||||
|
Worker release_completeness : 4 passed
|
||||||
|
Worker doc-tests : 0
|
||||||
|
```
|
||||||
|
|
||||||
|
## Validations exécutées dans l'environnement d'assemblage du fix
|
||||||
|
|
||||||
|
```text
|
||||||
|
python3 scripts/audit_rust_workspace_rules.py
|
||||||
|
python3 scripts/audit_markdown_tables.py README.md RULES.md ROADMAP.md CHANGELOG.md docs prompts crates deltas
|
||||||
|
contrôle supplémentaire des collisions d'identifiants normatifs
|
||||||
|
contrôle exhaustif du diff pre.002 -> pre.002-fix.001
|
||||||
|
contrôle du contenu et de l'intégrité ZIP
|
||||||
|
```
|
||||||
|
|
||||||
|
## Validations non exécutées localement
|
||||||
|
|
||||||
|
Le toolchain Rust n'est pas disponible dans l'environnement d'assemblage. Les commandes suivantes ne sont donc pas déclarées PASS localement :
|
||||||
|
|
||||||
|
```bash
|
||||||
|
cargo fmt --all -- --check
|
||||||
|
cargo check --workspace
|
||||||
|
cargo clippy --workspace --all-targets --all-features -- -D warnings
|
||||||
|
cargo test -p ksp-onchain-transport-lib
|
||||||
|
cargo test -p ksp-worker-raw-transaction-ingest-lib
|
||||||
|
```
|
||||||
|
|
||||||
|
Le correctif reproduit exactement le déplacement demandé par le diff `cargo fmt --all -- --check` du gate opérateur.
|
||||||
|
|
||||||
|
## Gate opérateur avant pre.003
|
||||||
|
|
||||||
|
```bash
|
||||||
|
cargo fmt --all -- --check
|
||||||
|
python3 scripts/audit_rust_workspace_rules.py
|
||||||
|
python3 scripts/audit_markdown_tables.py README.md RULES.md ROADMAP.md CHANGELOG.md docs prompts crates deltas
|
||||||
|
cargo check --workspace
|
||||||
|
cargo clippy --workspace --all-targets --all-features -- -D warnings
|
||||||
|
cargo test -p ksp-onchain-transport-lib
|
||||||
|
cargo test -p ksp-worker-raw-transaction-ingest-lib
|
||||||
|
```
|
||||||
|
|
||||||
|
## Décisions
|
||||||
|
|
||||||
|
- Le fix ne change pas le périmètre fonctionnel de `pre.002`.
|
||||||
|
- Le supervisor multi-source reste réservé à `pre.007`.
|
||||||
|
- `pre.003` reste la prochaine tranche fonctionnelle après validation de ce correctif.
|
||||||
|
- Aucun document durable n'est modifié pour une correction de format déjà entièrement décrite par ce delta.
|
||||||
|
|
||||||
|
## Questions ouvertes
|
||||||
|
|
||||||
|
```text
|
||||||
|
aucune
|
||||||
|
```
|
||||||
323
deltas/0.3.13/pre.002.md
Normal file
323
deltas/0.3.13/pre.002.md
Normal file
@@ -0,0 +1,323 @@
|
|||||||
|
<!-- file: deltas/0.3.13/pre.002.md -->
|
||||||
|
<!-- version: 1 -->
|
||||||
|
|
||||||
|
# Delta 0.3.13-pre.002 — runtime resources multi-source bornées
|
||||||
|
|
||||||
|
## Base requise
|
||||||
|
|
||||||
|
```text
|
||||||
|
delivery précédente : 0.3.13-pre.001
|
||||||
|
Cargo base : 0.3.13-pre.1
|
||||||
|
delta base : deltas/0.3.13/pre.001.md
|
||||||
|
archive delta base : ksp-general-0.3.13-pre.001.zip
|
||||||
|
SHA-256 delta base : ca57546f19bd47b5d3b832a51905159497a5e601c186460db22b04364a1835c4
|
||||||
|
```
|
||||||
|
|
||||||
|
Le gate opérateur fourni après application de `pre.001` est vert : fmt, audits Rust/Markdown, check workspace, Clippy strict, tests Worker, arbres normal/features et duplicates ont été exécutés sans anomalie signalée.
|
||||||
|
|
||||||
|
## Objectif
|
||||||
|
|
||||||
|
Matérialiser le contrat `pre.002` défini par le plan `034` sans démarrer prématurément les nouvelles familles live :
|
||||||
|
|
||||||
|
```text
|
||||||
|
collection runtime privée bornée 1..32
|
||||||
|
identité logique déterministe par source
|
||||||
|
source discriminant capability-owned
|
||||||
|
validation globale avant spawn
|
||||||
|
rejet des doublons logiques
|
||||||
|
rejet cross-network
|
||||||
|
aucun nouveau client réseau
|
||||||
|
aucune nouvelle dépendance
|
||||||
|
```
|
||||||
|
|
||||||
|
Le supervisor simultané appartient toujours à `pre.007`.
|
||||||
|
|
||||||
|
## Type de livraison
|
||||||
|
|
||||||
|
```text
|
||||||
|
0.3.13-pre.002
|
||||||
|
Cargo : 0.3.13-pre.2
|
||||||
|
archive : ksp-general-0.3.13-pre.002.zip
|
||||||
|
```
|
||||||
|
|
||||||
|
## Runtime resources multi-source
|
||||||
|
|
||||||
|
`RawTransactionIngestRuntimeResources` ne contient plus directement un unique champ Yellowstone. Il possède désormais une collection privée :
|
||||||
|
|
||||||
|
```text
|
||||||
|
Vec<RawTransactionIngestLiveSource>
|
||||||
|
```
|
||||||
|
|
||||||
|
Le discriminant privé initial est :
|
||||||
|
|
||||||
|
```text
|
||||||
|
Yellowstone(RawTransactionIngestYellowstoneSource)
|
||||||
|
```
|
||||||
|
|
||||||
|
Il est volontairement capability-owned ; aucun provider n'entre dans l'enum Worker.
|
||||||
|
|
||||||
|
Surface publique ajoutée :
|
||||||
|
|
||||||
|
```text
|
||||||
|
MAX_RAW_TRANSACTION_INGEST_LIVE_SOURCES = 32
|
||||||
|
RawTransactionIngestRuntimeResources::source_count()
|
||||||
|
RawTransactionIngestRuntimeResources::try_push_yellowstone_source(...)
|
||||||
|
```
|
||||||
|
|
||||||
|
`try_push_yellowstone_source` est transactionnel : le candidat est entièrement rejeté sans mutation de la collection si la borne, le réseau ou l'identité logique sont invalides.
|
||||||
|
|
||||||
|
## Identité logique Yellowstone
|
||||||
|
|
||||||
|
Chaque `RawTransactionIngestYellowstoneSource` possède maintenant un `source_key: [u8; 32]` privé.
|
||||||
|
|
||||||
|
Le hash SHA-256 est dérivé uniquement de données sûres :
|
||||||
|
|
||||||
|
```text
|
||||||
|
KSP domain separator
|
||||||
|
source family = yellowstone
|
||||||
|
network
|
||||||
|
provider identity sûre
|
||||||
|
endpoint identity sûre
|
||||||
|
commitment
|
||||||
|
identité opaque de YellowstoneSubscribeRequest
|
||||||
|
```
|
||||||
|
|
||||||
|
Le rôle et le pool HTTP d'hydration sont volontairement exclus du `source_key` : ils ne définissent pas une nouvelle source live Yellowstone. Ainsi, deux subscriptions identiques ne deviennent pas artificiellement distinctes par simple changement de stratégie d'hydration.
|
||||||
|
|
||||||
|
Sont explicitement absents du matériau en clair et de Debug :
|
||||||
|
|
||||||
|
```text
|
||||||
|
URL
|
||||||
|
API key / credential
|
||||||
|
header
|
||||||
|
transaction payload
|
||||||
|
remote error material
|
||||||
|
request identity bytes
|
||||||
|
source_key bytes/hash
|
||||||
|
```
|
||||||
|
|
||||||
|
Concernant `source_key`, le Debug de la source n'en publie que la longueur ; ses autres champs Debug restent les identités sûres déjà admises par le contrat stable. Le Debug de l'aggregate runtime publie seulement `source_count`.
|
||||||
|
|
||||||
|
## Identité déterministe de SubscribeRequest dans Transport
|
||||||
|
|
||||||
|
`ksp-onchain-transport-lib` expose `YellowstoneSubscribeRequestIdentity` comme valeur opaque et `YellowstoneSubscribeRequest::identity()`.
|
||||||
|
|
||||||
|
Canonicalisation de l'identité :
|
||||||
|
|
||||||
|
```text
|
||||||
|
sept familles de filtres séparées
|
||||||
|
ordre déterministe fourni par les BTreeMap KSP
|
||||||
|
nom de filtre length-framed
|
||||||
|
protobuf exact de chaque filtre length-framed
|
||||||
|
options communes protobuf encodées après vidage des sept maps
|
||||||
|
```
|
||||||
|
|
||||||
|
Les bytes internes restent privés. L'identité implémente `Hash` afin que le Worker puisse l'incorporer à son SHA-256 sans escape hatch de sérialisation.
|
||||||
|
|
||||||
|
Aucune dépendance n'est ajoutée : le codage réutilise `prost` réexporté par `yellowstone-grpc-proto`, déjà dépendance de Transport.
|
||||||
|
|
||||||
|
## Validation globale avant spawn
|
||||||
|
|
||||||
|
Avant activation, `RawTransactionIngestRuntimeResources::validate_network` impose :
|
||||||
|
|
||||||
|
```text
|
||||||
|
collection non vide
|
||||||
|
source_count <= 32
|
||||||
|
chaque source sur le réseau Worker
|
||||||
|
source_key unique dans la collection
|
||||||
|
```
|
||||||
|
|
||||||
|
Les erreurs restent mappées sur le contrat stable `ERROR_CODE_RAW_TRANSACTION_INGEST_RUNTIME_INVALID` avec conditions internes stables, sans valeurs sensibles.
|
||||||
|
|
||||||
|
## Gate volontaire d'activation multi-source
|
||||||
|
|
||||||
|
Le plan final exige que toutes les sources configurées soient démarrées simultanément. Cette responsabilité est explicitement réservée à `pre.007`.
|
||||||
|
|
||||||
|
Pour éviter un comportement faux en `pre.002` :
|
||||||
|
|
||||||
|
```text
|
||||||
|
1 source Yellowstone : voie productive stable conservée
|
||||||
|
2..32 sources : composition/validation possible
|
||||||
|
start avec 2..32 sources : fail closed avant spawn
|
||||||
|
jamais de démarrage silencieux de la première source seulement
|
||||||
|
```
|
||||||
|
|
||||||
|
Condition interne :
|
||||||
|
|
||||||
|
```text
|
||||||
|
runtime_resources.multi_source_activation_pending
|
||||||
|
```
|
||||||
|
|
||||||
|
Ce gate sera supprimé uniquement par la tranche supervisor/source inventory.
|
||||||
|
|
||||||
|
## Preuves déterministes ajoutées
|
||||||
|
|
||||||
|
Transport :
|
||||||
|
|
||||||
|
```text
|
||||||
|
identité de request stable malgré ordre d'insertion
|
||||||
|
identité différente si le filtre logique change
|
||||||
|
Debug identité redacted
|
||||||
|
surface identité disponible depuis crate root
|
||||||
|
aucun bytes()/as_bytes() public
|
||||||
|
```
|
||||||
|
|
||||||
|
Worker :
|
||||||
|
|
||||||
|
```text
|
||||||
|
source_key stable pour identité logique identique
|
||||||
|
source_key sensible au request fingerprint
|
||||||
|
source_key sensible à l'endpoint identity sûre
|
||||||
|
32 sources exactement acceptées
|
||||||
|
33e rejetée sans mutation
|
||||||
|
duplicate source identity rejetée
|
||||||
|
source cross-network rejetée
|
||||||
|
Debug aggregate limité à source_count
|
||||||
|
activation multi-source fail-closed avant pre.007
|
||||||
|
public API canary pour bound/count/push
|
||||||
|
release export inventory mis à jour
|
||||||
|
```
|
||||||
|
|
||||||
|
## Compatibilité et non-régression
|
||||||
|
|
||||||
|
La construction historique :
|
||||||
|
|
||||||
|
```text
|
||||||
|
RawTransactionIngestRuntimeResources::new(yellowstone_source)
|
||||||
|
```
|
||||||
|
|
||||||
|
reste valide et crée un aggregate d'une source.
|
||||||
|
|
||||||
|
La voie productive stable `start_with_runtime_resources` continue donc à fonctionner pour une seule source Yellowstone sans changement de Common RAW, Store, Config ni protocole réseau.
|
||||||
|
|
||||||
|
## Fichiers ajoutés
|
||||||
|
|
||||||
|
```text
|
||||||
|
deltas/0.3.13/pre.002.md
|
||||||
|
```
|
||||||
|
|
||||||
|
## Fichiers modifiés
|
||||||
|
|
||||||
|
```text
|
||||||
|
Cargo.toml
|
||||||
|
crates/ksp-onchain-transport-lib/src/grpc_subscribe.rs
|
||||||
|
crates/ksp-onchain-transport-lib/src/lib.rs
|
||||||
|
crates/ksp-onchain-transport-lib/tests/public_api.rs
|
||||||
|
crates/ksp-onchain-transport-lib/tests/release_completeness.rs
|
||||||
|
crates/ksp-onchain-transport-lib/unit_tests/grpc_subscribe.rs
|
||||||
|
crates/ksp-worker-raw-transaction-ingest-lib/src/lib.rs
|
||||||
|
crates/ksp-worker-raw-transaction-ingest-lib/src/runtime.rs
|
||||||
|
crates/ksp-worker-raw-transaction-ingest-lib/src/runtime_resources.rs
|
||||||
|
crates/ksp-worker-raw-transaction-ingest-lib/tests/public_api.rs
|
||||||
|
crates/ksp-worker-raw-transaction-ingest-lib/tests/release_completeness.rs
|
||||||
|
crates/ksp-worker-raw-transaction-ingest-lib/unit_tests/runtime_resources.rs
|
||||||
|
docs/plans/034-V0_3_13_MULTI_SOURCE_LIVE_CONVERGENCE_PLAN.md
|
||||||
|
docs/validation/030-V0_3_13_MULTI_SOURCE_LIVE_CONVERGENCE.md
|
||||||
|
```
|
||||||
|
|
||||||
|
## Fichiers supprimés
|
||||||
|
|
||||||
|
```text
|
||||||
|
aucun
|
||||||
|
```
|
||||||
|
|
||||||
|
## Versions de fichiers incrémentées
|
||||||
|
|
||||||
|
```text
|
||||||
|
grpc_subscribe.rs transport src : 8 -> 9
|
||||||
|
transport lib.rs : 46 -> 47
|
||||||
|
transport public_api.rs : 51 -> 52
|
||||||
|
transport release_completeness.rs : 43 -> 44
|
||||||
|
transport unit grpc_subscribe.rs : 5 -> 6
|
||||||
|
worker lib.rs : 17 -> 18
|
||||||
|
worker runtime.rs : 11 -> 12
|
||||||
|
worker runtime_resources.rs : 12 -> 13
|
||||||
|
worker public_api.rs : 11 -> 12
|
||||||
|
worker release_completeness.rs : 9 -> 10
|
||||||
|
worker unit runtime_resources.rs : 11 -> 12
|
||||||
|
plan 034 : 1 -> 2
|
||||||
|
validation 030 : 1 -> 2
|
||||||
|
```
|
||||||
|
|
||||||
|
## Audit intermédiaire et corrections
|
||||||
|
|
||||||
|
La première passe statique après introduction de l'identité Transport a détecté une rustdoc devenue non adjacente au `YellowstoneSubscribeRequest`. La structure documentaire a été corrigée avant poursuite.
|
||||||
|
|
||||||
|
Une passe ultérieure après ajout des canaris externes a détecté uniquement :
|
||||||
|
|
||||||
|
```text
|
||||||
|
2 fins de fichier avec newline supplémentaire
|
||||||
|
1 double ligne vide entre items Rust
|
||||||
|
```
|
||||||
|
|
||||||
|
Ces trois écarts de format ont été corrigés avant la validation finale.
|
||||||
|
|
||||||
|
Aucun état intermédiaire en échec n'est présenté comme PASS.
|
||||||
|
|
||||||
|
## Validations exécutées localement après correction finale
|
||||||
|
|
||||||
|
```text
|
||||||
|
python3 scripts/audit_rust_workspace_rules.py
|
||||||
|
PASS : General Rust rule audit clean
|
||||||
|
PASS : Rust export completeness audit 0 candidate
|
||||||
|
PASS : KSP workspace Rust rule audit clean
|
||||||
|
|
||||||
|
python3 scripts/audit_markdown_tables.py README.md RULES.md ROADMAP.md CHANGELOG.md docs prompts crates deltas
|
||||||
|
PASS : Markdown table audit clean (340 tables, 829 files)
|
||||||
|
|
||||||
|
supplemental normative definition-id scan
|
||||||
|
PASS : 489 definitions, 489 unique, 0 duplicate definition id
|
||||||
|
|
||||||
|
pre-packaging exhaustive diff scan
|
||||||
|
PASS : 14 fichiers modifiés, 1 ajouté, 0 supprimé
|
||||||
|
PASS : chaque header de version des 13 fichiers versionnés modifiés est incrémenté exactement de +1
|
||||||
|
PASS : aucune nouvelle occurrence de unsafe/unwrap/expect/panic/todo/unimplemented dans les lignes Rust production ajoutées
|
||||||
|
```
|
||||||
|
|
||||||
|
Les caches Python recréés par les scripts d'audit sont supprimés après la dernière passe et ne font pas partie de la livraison. L'archive delta est ensuite contrôlée par inventaire exact, test ZIP et scan des chemins/artefacts.
|
||||||
|
|
||||||
|
## Validations non exécutées localement
|
||||||
|
|
||||||
|
Le toolchain Rust n'est pas installé dans l'environnement d'assemblage courant :
|
||||||
|
|
||||||
|
```text
|
||||||
|
cargo fmt --all -- --check
|
||||||
|
cargo check --workspace
|
||||||
|
cargo clippy --workspace --all-targets --all-features -- -D warnings
|
||||||
|
cargo test -p ksp-onchain-transport-lib
|
||||||
|
cargo test -p ksp-worker-raw-transaction-ingest-lib
|
||||||
|
cargo tree -p ksp-worker-raw-transaction-ingest-lib --edges normal
|
||||||
|
cargo tree -p ksp-worker-raw-transaction-ingest-lib -e features
|
||||||
|
cargo tree --duplicates
|
||||||
|
```
|
||||||
|
|
||||||
|
Statut : `NON EXÉCUTÉ LOCAL`, jamais PASS.
|
||||||
|
|
||||||
|
## Décisions prises
|
||||||
|
|
||||||
|
```text
|
||||||
|
conserver 1..32 comme borne runtime P0
|
||||||
|
source identity opaque et non publique côté Worker
|
||||||
|
faire posséder l'identité exacte SubscribeRequest par Transport
|
||||||
|
ne pas ajouter prost comme dépendance Worker/Transport supplémentaire
|
||||||
|
valider toutes les sources avant spawn
|
||||||
|
rejeter duplicate identity et cross-network avant mutation
|
||||||
|
fail closed pour activation >1 jusqu'à pre.007
|
||||||
|
ne pas démarrer un sous-ensemble silencieux
|
||||||
|
ne modifier ni Common RAW ni Store API
|
||||||
|
```
|
||||||
|
|
||||||
|
## Questions ouvertes
|
||||||
|
|
||||||
|
Aucune nouvelle question bloquante pour `pre.003`.
|
||||||
|
|
||||||
|
Restent volontairement dans leurs tranches prévues :
|
||||||
|
|
||||||
|
```text
|
||||||
|
logsSubscribe standard + hydration : pre.003
|
||||||
|
blockSubscribe standard : pre.004
|
||||||
|
Helius transactionSubscribe : pre.005
|
||||||
|
HTTP polling : pre.006
|
||||||
|
supervisor simultané / source inventory : pre.007
|
||||||
|
convergence globale / observations multiples : pre.008
|
||||||
|
```
|
||||||
210
deltas/0.3.13/pre.003-fix.001.md
Normal file
210
deltas/0.3.13/pre.003-fix.001.md
Normal file
@@ -0,0 +1,210 @@
|
|||||||
|
<!-- file: deltas/0.3.13/pre.003-fix.001.md -->
|
||||||
|
<!-- version: 1 -->
|
||||||
|
|
||||||
|
# Delta 0.3.13-pre.003-fix.001 — correction des tests Worker après généralisation source-neutral
|
||||||
|
|
||||||
|
## Base requise
|
||||||
|
|
||||||
|
```text
|
||||||
|
delivery précédente : 0.3.13-pre.003
|
||||||
|
Cargo base : 0.3.13-pre.3
|
||||||
|
delta base : deltas/0.3.13/pre.003.md
|
||||||
|
archive delta base : ksp-general-0.3.13-pre.003.zip
|
||||||
|
SHA-256 delta base : 669b875410799b8a2c5806cddad81740bdd4dd78e36c68f6b268a6b0257f18f4
|
||||||
|
```
|
||||||
|
|
||||||
|
Le gate opérateur de `pre.003` confirme que le formatage, les audits et `cargo check --workspace` sont propres, mais que les cibles de tests Worker ne compilent plus après la généralisation source-neutral de `runtime_resources`. `cargo clippy --workspace --all-targets --all-features -- -D warnings` et `cargo test -p ksp-worker-raw-transaction-ingest-lib` échouent sur sept diagnostics provenant du même fichier de tests.
|
||||||
|
|
||||||
|
## Objectif
|
||||||
|
|
||||||
|
Corriger uniquement les tests devenus obsolètes par rapport au contrat production de `pre.003`, sans rouvrir l'API ni modifier la logique runtime :
|
||||||
|
|
||||||
|
```text
|
||||||
|
aucun code production modifié
|
||||||
|
aucune API publique ajoutée ou supprimée
|
||||||
|
aucune dépendance modifiée
|
||||||
|
aucune logique réseau/hydration/admission modifiée
|
||||||
|
aucun avancement vers blockSubscribe pre.004
|
||||||
|
```
|
||||||
|
|
||||||
|
## Version
|
||||||
|
|
||||||
|
```text
|
||||||
|
livraison : 0.3.13-pre.003-fix.001
|
||||||
|
workspace.package.version : 0.3.13-pre.3.fix.1
|
||||||
|
archive : ksp-general-0.3.13-pre.003-fix.001.zip
|
||||||
|
```
|
||||||
|
|
||||||
|
Conformément aux règles de versionnement KSP, le fix modifie un fichier `.rs`; le `workspace.package.version` est donc synchronisé avec l'identifiant SemVer technique du correctif.
|
||||||
|
|
||||||
|
## Diagnostic opérateur
|
||||||
|
|
||||||
|
Les sept diagnostics se répartissent en trois causes.
|
||||||
|
|
||||||
|
### Ancien extracteur mono-Yellowstone supprimé
|
||||||
|
|
||||||
|
Le test `v0_3_13_pre_002_multi_source_activation_fails_closed_until_supervisor_tranche` appelait encore :
|
||||||
|
|
||||||
|
```text
|
||||||
|
RawTransactionIngestRuntimeResources::into_yellowstone_source
|
||||||
|
```
|
||||||
|
|
||||||
|
Cette méthode a été supprimée en `pre.003` lorsque l'aggregate a été rendu source-neutral. La barrière correspondante est désormais :
|
||||||
|
|
||||||
|
```text
|
||||||
|
RawTransactionIngestRuntimeResources::validate_single_source_activation
|
||||||
|
```
|
||||||
|
|
||||||
|
Le test utilise donc le contrat actuel et continue de vérifier exactement l'erreur :
|
||||||
|
|
||||||
|
```text
|
||||||
|
runtime_resources.multi_source_activation_pending
|
||||||
|
```
|
||||||
|
|
||||||
|
Les deux erreurs d'inférence `E0282` étaient secondaires à l'absence de l'ancienne méthode et disparaissent avec cette correction.
|
||||||
|
|
||||||
|
### Contexte d'hydration manquant
|
||||||
|
|
||||||
|
Deux tests appelaient encore l'ancienne signature de :
|
||||||
|
|
||||||
|
```text
|
||||||
|
build_hydration_provenance
|
||||||
|
```
|
||||||
|
|
||||||
|
`pre.003` a ajouté en premier argument le contexte source-neutral :
|
||||||
|
|
||||||
|
```text
|
||||||
|
&RawTransactionIngestHydrationContext
|
||||||
|
```
|
||||||
|
|
||||||
|
Les tests construisent maintenant ce contexte via :
|
||||||
|
|
||||||
|
```text
|
||||||
|
source.hydration_context()
|
||||||
|
```
|
||||||
|
|
||||||
|
puis le transmettent à `build_hydration_provenance`. Aucun contrat production n'est élargi pour les tests.
|
||||||
|
|
||||||
|
### Accesseurs volontairement absents de RawTransactionMaterial
|
||||||
|
|
||||||
|
Le nouveau test Standard Logs tentait d'appeler :
|
||||||
|
|
||||||
|
```text
|
||||||
|
ingress.material.slot()
|
||||||
|
ingress.material.signature()
|
||||||
|
```
|
||||||
|
|
||||||
|
`RawTransactionMaterial` garde ces champs privés et ne fournit volontairement pas ces accesseurs. Le test ne doit pas provoquer l'ajout d'une API uniquement pour introspection.
|
||||||
|
|
||||||
|
Les deux assertions sont donc supprimées à ce niveau. La même preuve reste effectuée après passage dans l'admission centrale et canonicalisation, via :
|
||||||
|
|
||||||
|
```text
|
||||||
|
acquisition.transaction().slot() == 42
|
||||||
|
acquisition.transaction().reference().signature().as_bytes() == [0; 64]
|
||||||
|
```
|
||||||
|
|
||||||
|
Cela vérifie en plus le chemin réellement consommé par le Worker.
|
||||||
|
|
||||||
|
## Fichiers modifiés
|
||||||
|
|
||||||
|
```text
|
||||||
|
Cargo.toml
|
||||||
|
crates/ksp-worker-raw-transaction-ingest-lib/unit_tests/runtime_resources.rs
|
||||||
|
```
|
||||||
|
|
||||||
|
## Fichiers ajoutés
|
||||||
|
|
||||||
|
```text
|
||||||
|
deltas/0.3.13/pre.003-fix.001.md
|
||||||
|
```
|
||||||
|
|
||||||
|
## Fichiers supprimés
|
||||||
|
|
||||||
|
```text
|
||||||
|
aucun
|
||||||
|
```
|
||||||
|
|
||||||
|
## Versions de fichiers incrémentées
|
||||||
|
|
||||||
|
```text
|
||||||
|
Cargo.toml : 542 -> 543
|
||||||
|
worker unit_tests/runtime_resources.rs : 13 -> 14
|
||||||
|
```
|
||||||
|
|
||||||
|
## Validation opérateur de la base pre.003
|
||||||
|
|
||||||
|
Le log fourni confirme avant fix :
|
||||||
|
|
||||||
|
```text
|
||||||
|
cargo fmt --all : exécuté
|
||||||
|
cargo fmt --all -- --check : PASS / silencieux
|
||||||
|
General Rust rule audit : clean
|
||||||
|
Rust export completeness audit : 0 candidate(s)
|
||||||
|
KSP workspace Rust rule audit : clean
|
||||||
|
Markdown table audit : clean (340 tables, 831 files)
|
||||||
|
cargo check --workspace : PASS
|
||||||
|
cargo clippy --workspace --all-targets --all-features -- -D warnings : FAIL sur compilation des tests Worker
|
||||||
|
cargo test -p ksp-worker-raw-transaction-ingest-lib : FAIL sur les mêmes 7 diagnostics
|
||||||
|
```
|
||||||
|
|
||||||
|
Diagnostics observés :
|
||||||
|
|
||||||
|
```text
|
||||||
|
E0599 : into_yellowstone_source supprimé
|
||||||
|
E0282 : 2 erreurs d'inférence secondaires
|
||||||
|
E0061 : 2 appels build_hydration_provenance sans hydration context
|
||||||
|
E0599 : RawTransactionMaterial::slot absent
|
||||||
|
E0599 : RawTransactionMaterial::signature absent
|
||||||
|
```
|
||||||
|
|
||||||
|
## Validations dans l'environnement d'assemblage
|
||||||
|
|
||||||
|
Le toolchain Rust n'est pas disponible dans l'environnement d'assemblage. Les validations statiques KSP exécutables localement et le contrôle exhaustif du delta sont réalisés avant packaging.
|
||||||
|
|
||||||
|
Les commandes Cargo ne sont pas déclarées PASS localement :
|
||||||
|
|
||||||
|
```bash
|
||||||
|
cargo fmt --all -- --check
|
||||||
|
cargo check --workspace
|
||||||
|
cargo clippy --workspace --all-targets --all-features -- -D warnings
|
||||||
|
cargo test -p ksp-worker-raw-transaction-ingest-lib
|
||||||
|
```
|
||||||
|
|
||||||
|
## Résultats statiques finaux de l'assemblage
|
||||||
|
|
||||||
|
```text
|
||||||
|
General Rust rule audit: clean
|
||||||
|
Rust export completeness audit: 0 candidate(s)
|
||||||
|
KSP workspace Rust rule audit: clean
|
||||||
|
Markdown table audit: clean (340 tables, 832 files)
|
||||||
|
Normative rule definitions: 489
|
||||||
|
Unique normative IDs: 489
|
||||||
|
Duplicates: 0
|
||||||
|
```
|
||||||
|
|
||||||
|
## Gate opérateur avant pre.004
|
||||||
|
|
||||||
|
```bash
|
||||||
|
cargo fmt --all
|
||||||
|
cargo fmt --all -- --check
|
||||||
|
python3 scripts/audit_rust_workspace_rules.py
|
||||||
|
python3 scripts/audit_markdown_tables.py README.md RULES.md ROADMAP.md CHANGELOG.md docs prompts crates deltas
|
||||||
|
cargo check --workspace
|
||||||
|
cargo clippy --workspace --all-targets --all-features -- -D warnings
|
||||||
|
cargo test -p ksp-worker-raw-transaction-ingest-lib
|
||||||
|
```
|
||||||
|
|
||||||
|
`pre.004` ne doit démarrer qu'après retour vert de ce gate.
|
||||||
|
|
||||||
|
## Décisions
|
||||||
|
|
||||||
|
- Le fix conserve l'encapsulation de `RawTransactionMaterial`; aucun getter n'est ajouté pour satisfaire un test.
|
||||||
|
- Le fix conserve l'aggregate source-neutral introduit en `pre.003`; l'ancien extracteur mono-Yellowstone n'est pas restauré.
|
||||||
|
- Le fix conserve le contexte d'hydration source-neutral et adapte les tests à sa signature actuelle.
|
||||||
|
- Aucun changement fonctionnel de `pre.003` n'est introduit.
|
||||||
|
|
||||||
|
## Questions ouvertes
|
||||||
|
|
||||||
|
```text
|
||||||
|
aucune
|
||||||
|
```
|
||||||
194
deltas/0.3.13/pre.003-fix.002.md
Normal file
194
deltas/0.3.13/pre.003-fix.002.md
Normal file
@@ -0,0 +1,194 @@
|
|||||||
|
<!-- file: deltas/0.3.13/pre.003-fix.002.md -->
|
||||||
|
<!-- version: 1 -->
|
||||||
|
|
||||||
|
# Delta 0.3.13-pre.003-fix.002 — correction des canaris de dépendance après généralisation source-neutral
|
||||||
|
|
||||||
|
## Base requise
|
||||||
|
|
||||||
|
```text
|
||||||
|
delivery précédente : 0.3.13-pre.003-fix.001
|
||||||
|
Cargo base : 0.3.13-pre.3.fix.1
|
||||||
|
delta base : deltas/0.3.13/pre.003-fix.001.md
|
||||||
|
archive delta base : ksp-general-0.3.13-pre.003-fix.001.zip
|
||||||
|
```
|
||||||
|
|
||||||
|
Le gate opérateur de `pre.003-fix.001` confirme que le formatage, les audits, `cargo check --workspace`, Clippy strict et les tests unitaires Worker passent. Deux canaris historiques de `tests/dependency_boundary.rs` échouent cependant parce qu'ils vérifient encore des noms et une borne d'implémentation antérieurs à la généralisation source-neutral de `pre.003`.
|
||||||
|
|
||||||
|
## Objectif
|
||||||
|
|
||||||
|
Corriger uniquement ces deux canaris afin qu'ils vérifient le contrat production actuel, sans modifier le code runtime :
|
||||||
|
|
||||||
|
```text
|
||||||
|
aucun code production modifié
|
||||||
|
aucune API publique ajoutée ou supprimée
|
||||||
|
aucune dépendance modifiée
|
||||||
|
aucune logique réseau/hydration/admission modifiée
|
||||||
|
aucun avancement vers blockSubscribe pre.004
|
||||||
|
```
|
||||||
|
|
||||||
|
## Version
|
||||||
|
|
||||||
|
```text
|
||||||
|
livraison : 0.3.13-pre.003-fix.002
|
||||||
|
workspace.package.version : 0.3.13-pre.3.fix.2
|
||||||
|
archive : ksp-general-0.3.13-pre.003-fix.002.zip
|
||||||
|
```
|
||||||
|
|
||||||
|
Le fix modifie un fichier Rust de tests ; le `workspace.package.version` est donc incrémenté conformément aux règles KSP.
|
||||||
|
|
||||||
|
## Diagnostic opérateur
|
||||||
|
|
||||||
|
### Canary hydration historique
|
||||||
|
|
||||||
|
Le test :
|
||||||
|
|
||||||
|
```text
|
||||||
|
v0_3_12_pre_004_hydration_contract_uses_only_transport_facade_common_raw_and_existing_ingress
|
||||||
|
```
|
||||||
|
|
||||||
|
attendait encore les helpers mono-Yellowstone :
|
||||||
|
|
||||||
|
```text
|
||||||
|
fn finalize_yellowstone_hydration
|
||||||
|
fn fetch_yellowstone_hydration
|
||||||
|
```
|
||||||
|
|
||||||
|
`pre.003` a volontairement rendu l'hydration commune à plusieurs familles de sources et les helpers production actuels sont :
|
||||||
|
|
||||||
|
```text
|
||||||
|
fn finalize_hydration
|
||||||
|
async fn fetch_hydration
|
||||||
|
```
|
||||||
|
|
||||||
|
Le canary est mis à jour pour vérifier ces helpers source-neutral sans réintroduire les anciens noms.
|
||||||
|
|
||||||
|
### Canary de borne de coalescence historique
|
||||||
|
|
||||||
|
Le test :
|
||||||
|
|
||||||
|
```text
|
||||||
|
v0_3_12_pre_006_productive_source_uses_transport_session_bounded_coalescence_and_existing_admission
|
||||||
|
```
|
||||||
|
|
||||||
|
attendait encore la présence textuelle de :
|
||||||
|
|
||||||
|
```text
|
||||||
|
MAX_RAW_TRANSACTION_INGEST_ADMISSION_QUEUE_CAPACITY
|
||||||
|
```
|
||||||
|
|
||||||
|
`pre.003` a resserré le budget du coordinator commun sur la borne configurée du Worker :
|
||||||
|
|
||||||
|
```text
|
||||||
|
max_pending_signals: settings.admission_queue_capacity()
|
||||||
|
```
|
||||||
|
|
||||||
|
Le canary vérifie désormais cette borne runtime effective. Le plafond absolu n'est pas réintroduit dans l'implémentation.
|
||||||
|
|
||||||
|
## Fichiers modifiés
|
||||||
|
|
||||||
|
```text
|
||||||
|
Cargo.toml
|
||||||
|
crates/ksp-worker-raw-transaction-ingest-lib/tests/dependency_boundary.rs
|
||||||
|
```
|
||||||
|
|
||||||
|
## Fichiers ajoutés
|
||||||
|
|
||||||
|
```text
|
||||||
|
deltas/0.3.13/pre.003-fix.002.md
|
||||||
|
```
|
||||||
|
|
||||||
|
## Fichiers supprimés
|
||||||
|
|
||||||
|
```text
|
||||||
|
aucun
|
||||||
|
```
|
||||||
|
|
||||||
|
## Versions de fichiers incrémentées
|
||||||
|
|
||||||
|
```text
|
||||||
|
Cargo.toml : 543 -> 544
|
||||||
|
worker tests/dependency_boundary.rs : 17 -> 18
|
||||||
|
```
|
||||||
|
|
||||||
|
## Validation opérateur de la base pre.003-fix.001
|
||||||
|
|
||||||
|
Le log fourni confirme avant ce fix :
|
||||||
|
|
||||||
|
```text
|
||||||
|
cargo fmt --all : exécuté
|
||||||
|
cargo fmt --all -- --check : PASS / silencieux
|
||||||
|
General Rust rule audit : clean
|
||||||
|
Rust export completeness audit : 0 candidate(s)
|
||||||
|
KSP workspace Rust rule audit : clean
|
||||||
|
Markdown table audit : clean (340 tables, 832 files)
|
||||||
|
cargo check --workspace : PASS
|
||||||
|
cargo clippy --workspace --all-targets --all-features -- -D warnings : FAIL lors des tests dependency_boundary
|
||||||
|
cargo test -p ksp-worker-raw-transaction-ingest-lib : 75 unit tests PASS, puis 2/10 dependency_boundary FAIL
|
||||||
|
```
|
||||||
|
|
||||||
|
Échecs observés :
|
||||||
|
|
||||||
|
```text
|
||||||
|
v0_3_12_pre_004_hydration_contract_uses_only_transport_facade_common_raw_and_existing_ingress
|
||||||
|
v0_3_12_pre_006_productive_source_uses_transport_session_bounded_coalescence_and_existing_admission
|
||||||
|
```
|
||||||
|
|
||||||
|
Les deux échecs sont des assertions `include_str!` sur l'implémentation et non des erreurs du code production.
|
||||||
|
|
||||||
|
## Validations dans l'environnement d'assemblage
|
||||||
|
|
||||||
|
Le toolchain Rust n'est pas disponible dans l'environnement d'assemblage. Les audits statiques KSP et le contrôle exhaustif du delta sont exécutés avant packaging. Les commandes Cargo suivantes ne sont donc pas déclarées PASS localement :
|
||||||
|
|
||||||
|
```bash
|
||||||
|
cargo fmt --all -- --check
|
||||||
|
cargo check --workspace
|
||||||
|
cargo clippy --workspace --all-targets --all-features -- -D warnings
|
||||||
|
cargo test -p ksp-worker-raw-transaction-ingest-lib
|
||||||
|
```
|
||||||
|
|
||||||
|
## Résultats statiques finaux de l'assemblage
|
||||||
|
|
||||||
|
```text
|
||||||
|
General Rust rule audit: clean
|
||||||
|
Rust export completeness audit: 0 candidate(s)
|
||||||
|
KSP workspace Rust rule audit: clean
|
||||||
|
Markdown table audit: clean (340 tables, 833 files)
|
||||||
|
Normative rule definitions: 489
|
||||||
|
Unique normative IDs: 489
|
||||||
|
Duplicates: 0
|
||||||
|
```
|
||||||
|
|
||||||
|
Les trois chaînes attendues par les canaris corrigés ont également été vérifiées directement dans `runtime_resources.rs` :
|
||||||
|
|
||||||
|
```text
|
||||||
|
fn finalize_hydration : présent
|
||||||
|
fn fetch_hydration : présent
|
||||||
|
max_pending_signals: settings.admission_queue_capacity() : présent
|
||||||
|
```
|
||||||
|
|
||||||
|
## Gate opérateur avant pre.004
|
||||||
|
|
||||||
|
```bash
|
||||||
|
cargo fmt --all
|
||||||
|
cargo fmt --all -- --check
|
||||||
|
python3 scripts/audit_rust_workspace_rules.py
|
||||||
|
python3 scripts/audit_markdown_tables.py README.md RULES.md ROADMAP.md CHANGELOG.md docs prompts crates deltas
|
||||||
|
cargo check --workspace
|
||||||
|
cargo clippy --workspace --all-targets --all-features -- -D warnings
|
||||||
|
cargo test -p ksp-worker-raw-transaction-ingest-lib
|
||||||
|
```
|
||||||
|
|
||||||
|
`pre.004` ne doit démarrer qu'après retour vert de ce gate.
|
||||||
|
|
||||||
|
## Décisions
|
||||||
|
|
||||||
|
- Le fix conserve les helpers d'hydration source-neutral de `pre.003`; les anciens noms Yellowstone ne sont pas restaurés.
|
||||||
|
- Le fix conserve `settings.admission_queue_capacity()` comme borne effective du coordinator d'hydration ; le plafond absolu n'est pas réinjecté.
|
||||||
|
- Aucun code production n'est modifié.
|
||||||
|
- Aucun changement fonctionnel de `pre.003` n'est introduit.
|
||||||
|
|
||||||
|
## Questions ouvertes
|
||||||
|
|
||||||
|
```text
|
||||||
|
aucune
|
||||||
|
```
|
||||||
164
deltas/0.3.13/pre.003-fix.003.md
Normal file
164
deltas/0.3.13/pre.003-fix.003.md
Normal file
@@ -0,0 +1,164 @@
|
|||||||
|
<!-- file: deltas/0.3.13/pre.003-fix.003.md -->
|
||||||
|
<!-- version: 1 -->
|
||||||
|
|
||||||
|
# Delta 0.3.13-pre.003-fix.003 — correction du dernier canari productif historique
|
||||||
|
|
||||||
|
## Base requise
|
||||||
|
|
||||||
|
```text
|
||||||
|
delivery précédente : 0.3.13-pre.003-fix.002
|
||||||
|
Cargo base : 0.3.13-pre.3.fix.2
|
||||||
|
delta base : deltas/0.3.13/pre.003-fix.002.md
|
||||||
|
archive delta base : ksp-general-0.3.13-pre.003-fix.002.zip
|
||||||
|
```
|
||||||
|
|
||||||
|
Le gate opérateur de `pre.003-fix.002` confirme que le formatage, les audits, `cargo check --workspace`, les 75 tests unitaires Worker et 9/10 canaris `dependency_boundary` passent. Un seul canari historique reste obsolète : il recherche encore la chaîne `commitment: commitment.as_str()` alors que `pre.003` a déplacé le commitment dans le contexte d'hydration source-neutral.
|
||||||
|
|
||||||
|
## Objectif
|
||||||
|
|
||||||
|
Corriger uniquement cette assertion textuelle de test afin qu'elle vérifie le contrat production actuel :
|
||||||
|
|
||||||
|
```text
|
||||||
|
aucun code production modifié
|
||||||
|
aucune API publique ajoutée ou supprimée
|
||||||
|
aucune dépendance modifiée
|
||||||
|
aucune logique réseau/hydration/admission modifiée
|
||||||
|
aucun avancement vers blockSubscribe pre.004
|
||||||
|
```
|
||||||
|
|
||||||
|
## Version
|
||||||
|
|
||||||
|
```text
|
||||||
|
livraison : 0.3.13-pre.003-fix.003
|
||||||
|
workspace.package.version : 0.3.13-pre.3.fix.3
|
||||||
|
archive : ksp-general-0.3.13-pre.003-fix.003.zip
|
||||||
|
```
|
||||||
|
|
||||||
|
Le fix modifie un fichier Rust de tests ; le `workspace.package.version` est donc incrémenté conformément aux règles KSP.
|
||||||
|
|
||||||
|
## Diagnostic opérateur
|
||||||
|
|
||||||
|
Le test :
|
||||||
|
|
||||||
|
```text
|
||||||
|
v0_3_12_pre_006_productive_source_uses_transport_session_bounded_coalescence_and_existing_admission
|
||||||
|
```
|
||||||
|
|
||||||
|
attendait encore :
|
||||||
|
|
||||||
|
```text
|
||||||
|
commitment: commitment.as_str()
|
||||||
|
```
|
||||||
|
|
||||||
|
Le coordinator d'hydration source-neutral de `pre.003` porte désormais le commitment dans `RawTransactionIngestHydrationContext`. Le code production courant construit donc la clé avec :
|
||||||
|
|
||||||
|
```text
|
||||||
|
commitment: hydration.commitment.as_str()
|
||||||
|
```
|
||||||
|
|
||||||
|
Le canari est mis à jour pour vérifier cette forme actuelle. Aucun alias, variable ou code de compatibilité artificiel n'est ajouté au runtime.
|
||||||
|
|
||||||
|
## Fichiers modifiés
|
||||||
|
|
||||||
|
```text
|
||||||
|
Cargo.toml
|
||||||
|
crates/ksp-worker-raw-transaction-ingest-lib/tests/dependency_boundary.rs
|
||||||
|
```
|
||||||
|
|
||||||
|
## Fichiers ajoutés
|
||||||
|
|
||||||
|
```text
|
||||||
|
deltas/0.3.13/pre.003-fix.003.md
|
||||||
|
```
|
||||||
|
|
||||||
|
## Fichiers supprimés
|
||||||
|
|
||||||
|
```text
|
||||||
|
aucun
|
||||||
|
```
|
||||||
|
|
||||||
|
## Versions de fichiers incrémentées
|
||||||
|
|
||||||
|
```text
|
||||||
|
Cargo.toml : 544 -> 545
|
||||||
|
worker tests/dependency_boundary.rs : 18 -> 19
|
||||||
|
```
|
||||||
|
|
||||||
|
## Validation opérateur de la base pre.003-fix.002
|
||||||
|
|
||||||
|
Le log fourni confirme avant ce fix :
|
||||||
|
|
||||||
|
```text
|
||||||
|
cargo fmt --all : exécuté
|
||||||
|
cargo fmt --all -- --check : PASS / silencieux
|
||||||
|
General Rust rule audit : clean
|
||||||
|
Rust export completeness audit : 0 candidate(s)
|
||||||
|
KSP workspace Rust rule audit : clean
|
||||||
|
Markdown table audit : clean (340 tables, 833 files)
|
||||||
|
cargo check --workspace : PASS
|
||||||
|
cargo clippy --workspace --all-targets --all-features -- -D warnings : atteint les tests puis échoue sur le même canari dependency_boundary
|
||||||
|
cargo test -p ksp-worker-raw-transaction-ingest-lib : 75 unit tests PASS, puis 9/10 dependency_boundary PASS et 1 FAIL
|
||||||
|
```
|
||||||
|
|
||||||
|
Échec restant :
|
||||||
|
|
||||||
|
```text
|
||||||
|
required pre.006 productive-source contract missing: commitment: commitment.as_str()
|
||||||
|
```
|
||||||
|
|
||||||
|
Il s'agit d'une assertion `include_str!` obsolète sur l'implémentation, pas d'une erreur du code production.
|
||||||
|
|
||||||
|
## Validations dans l'environnement d'assemblage
|
||||||
|
|
||||||
|
Le toolchain Rust n'est pas disponible dans l'environnement d'assemblage. Les audits statiques KSP et le contrôle exhaustif du delta sont exécutés avant packaging. Les commandes Cargo suivantes ne sont donc pas déclarées PASS localement :
|
||||||
|
|
||||||
|
```bash
|
||||||
|
cargo fmt --all -- --check
|
||||||
|
cargo check --workspace
|
||||||
|
cargo clippy --workspace --all-targets --all-features -- -D warnings
|
||||||
|
cargo test -p ksp-worker-raw-transaction-ingest-lib
|
||||||
|
```
|
||||||
|
|
||||||
|
## Résultats statiques finaux de l'assemblage
|
||||||
|
|
||||||
|
```text
|
||||||
|
General Rust rule audit: clean
|
||||||
|
Rust export completeness audit: 0 candidate(s)
|
||||||
|
KSP workspace Rust rule audit: clean
|
||||||
|
Markdown table audit: clean (340 tables, 834 files)
|
||||||
|
Normative rule definitions: 489
|
||||||
|
Unique normative IDs: 489
|
||||||
|
Duplicates: 0
|
||||||
|
```
|
||||||
|
|
||||||
|
La chaîne attendue par le canari corrigé a également été vérifiée directement dans `runtime_resources.rs` :
|
||||||
|
|
||||||
|
```text
|
||||||
|
commitment: hydration.commitment.as_str() : présent
|
||||||
|
```
|
||||||
|
|
||||||
|
## Gate opérateur avant pre.004
|
||||||
|
|
||||||
|
```bash
|
||||||
|
cargo fmt --all
|
||||||
|
cargo fmt --all -- --check
|
||||||
|
python3 scripts/audit_rust_workspace_rules.py
|
||||||
|
python3 scripts/audit_markdown_tables.py README.md RULES.md ROADMAP.md CHANGELOG.md docs prompts crates deltas
|
||||||
|
cargo check --workspace
|
||||||
|
cargo clippy --workspace --all-targets --all-features -- -D warnings
|
||||||
|
cargo test -p ksp-worker-raw-transaction-ingest-lib
|
||||||
|
```
|
||||||
|
|
||||||
|
`pre.004` ne doit démarrer qu'après retour vert de ce gate.
|
||||||
|
|
||||||
|
## Décisions
|
||||||
|
|
||||||
|
- Le commitment reste porté par le contexte d'hydration source-neutral de `pre.003`.
|
||||||
|
- Le canari historique est aligné sur le contrat actuel ; aucun code production n'est modifié pour satisfaire une recherche textuelle obsolète.
|
||||||
|
- Aucun changement fonctionnel de `pre.003` n'est introduit.
|
||||||
|
|
||||||
|
## Questions ouvertes
|
||||||
|
|
||||||
|
```text
|
||||||
|
aucune
|
||||||
|
```
|
||||||
260
deltas/0.3.13/pre.003.md
Normal file
260
deltas/0.3.13/pre.003.md
Normal file
@@ -0,0 +1,260 @@
|
|||||||
|
<!-- file: deltas/0.3.13/pre.003.md -->
|
||||||
|
<!-- version: 1 -->
|
||||||
|
|
||||||
|
# Delta 0.3.13-pre.003 — Standard Solana logsSubscribe + hydration commune
|
||||||
|
|
||||||
|
## Base requise
|
||||||
|
|
||||||
|
```text
|
||||||
|
delivery précédente : 0.3.13-pre.002-fix.001
|
||||||
|
Cargo base : 0.3.13-pre.2.fix.1
|
||||||
|
delta base : deltas/0.3.13/pre.002-fix.001.md
|
||||||
|
```
|
||||||
|
|
||||||
|
Le gate opérateur de la base a été exécuté après `cargo clean` et est vert : `cargo fmt --all -- --check` silencieux, audits Rust/Markdown propres, `cargo check --workspace`, Clippy strict, 389 tests unitaires Transport, 52 tests public API Transport, 44 tests release Transport, 4 doc-tests Transport, puis 70 tests unitaires Worker et toutes ses suites d'intégration sans échec. Les smokes réseau opt-in sont restés ignorés comme prévu.
|
||||||
|
|
||||||
|
## Objectif
|
||||||
|
|
||||||
|
Ajouter la première nouvelle famille live de `0.3.13` sans dupliquer Transport ni l'admission RAW :
|
||||||
|
|
||||||
|
```text
|
||||||
|
Solana standard WS logsSubscribe
|
||||||
|
-> context.slot + signature
|
||||||
|
-> hydration HTTP getTransaction observed
|
||||||
|
-> Common RAW
|
||||||
|
-> admission centrale Worker
|
||||||
|
-> Store
|
||||||
|
```
|
||||||
|
|
||||||
|
La tranche ne démarre toujours qu'une seule source productive à la fois. La supervision simultanée de plusieurs sources reste réservée à `pre.007`.
|
||||||
|
|
||||||
|
## Version
|
||||||
|
|
||||||
|
```text
|
||||||
|
livraison : 0.3.13-pre.003
|
||||||
|
workspace.package.version : 0.3.13-pre.3
|
||||||
|
archive attendue : ksp-general-0.3.13-pre.003.zip
|
||||||
|
```
|
||||||
|
|
||||||
|
## Source Standard Logs
|
||||||
|
|
||||||
|
Nouvelle surface publique Worker :
|
||||||
|
|
||||||
|
```text
|
||||||
|
RawTransactionIngestStandardLogsSource
|
||||||
|
```
|
||||||
|
|
||||||
|
Construction caller-composed :
|
||||||
|
|
||||||
|
```text
|
||||||
|
WsEndpointSettings kind solana_standard
|
||||||
|
SolanaLogsSubscribeFilter
|
||||||
|
SolanaCommitment Confirmed ou Finalized
|
||||||
|
HttpTransportPool
|
||||||
|
HttpRoleName hydration
|
||||||
|
```
|
||||||
|
|
||||||
|
La construction ne réalise aucune I/O. Elle valide le protocole WebSocket, le commitment, le réseau, la représentation sûre provider/endpoint et l'existence d'une route HTTP `getTransaction` compatible sur le même cluster.
|
||||||
|
|
||||||
|
Au runtime, la source utilise exclusivement :
|
||||||
|
|
||||||
|
```text
|
||||||
|
SolanaStandardWsSession::connect
|
||||||
|
logs_subscribe
|
||||||
|
HttpTransportPool::get_transaction_observed
|
||||||
|
```
|
||||||
|
|
||||||
|
Le Worker ne construit aucun socket/client inférieur et ne dépend directement ni de `reqwest`, ni de `tokio-tungstenite`, ni de `tonic`, ni de `yellowstone-grpc-proto`.
|
||||||
|
|
||||||
|
## Projection et redaction
|
||||||
|
|
||||||
|
Une notification `logsSubscribe` est réduite à son matériau de référence nécessaire :
|
||||||
|
|
||||||
|
```text
|
||||||
|
context.slot
|
||||||
|
signature
|
||||||
|
commitment caller-composed
|
||||||
|
identité source/filter privée
|
||||||
|
```
|
||||||
|
|
||||||
|
Les champs distants `logs` et `err` ne sont pas copiés dans le signal Worker, le snapshot, la provenance textuelle ou `Debug`.
|
||||||
|
|
||||||
|
Les variantes :
|
||||||
|
|
||||||
|
```text
|
||||||
|
All
|
||||||
|
AllWithVotes
|
||||||
|
Mentions(pubkey)
|
||||||
|
```
|
||||||
|
|
||||||
|
participent à une empreinte SHA-256 privée. La valeur du pubkey `Mentions` n'est pas exposée par le Worker.
|
||||||
|
|
||||||
|
## Identité logique
|
||||||
|
|
||||||
|
Le `source_key` Standard Logs est dérivé de :
|
||||||
|
|
||||||
|
```text
|
||||||
|
domain KSP live-source v1
|
||||||
|
family = standard_logs
|
||||||
|
network
|
||||||
|
safe provider identity
|
||||||
|
safe endpoint identity
|
||||||
|
commitment
|
||||||
|
private filter fingerprint
|
||||||
|
```
|
||||||
|
|
||||||
|
Le rôle et le pool HTTP d'hydration n'entrent pas dans cette identité : ils décrivent la stratégie d'enrichissement, pas une nouvelle source live.
|
||||||
|
|
||||||
|
Le rejet transactionnel des doublons et le bound global `1..32` introduits en `pre.002` s'appliquent aussi à Standard Logs.
|
||||||
|
|
||||||
|
## Hydration source-neutral
|
||||||
|
|
||||||
|
Le coordinator privé précédemment utilisé par Yellowstone est généralisé en contrat d'hydration source-neutral et réutilisé par Standard Logs.
|
||||||
|
|
||||||
|
Pour `pre.003`, chaque exécution mono-source possède encore sa propre instance. Le partage réellement global entre plusieurs tâches source sera introduit avec le supervisor `pre.007`.
|
||||||
|
|
||||||
|
Bornes effectives :
|
||||||
|
|
||||||
|
```text
|
||||||
|
hydration in-flight <= persistence_concurrency
|
||||||
|
pending source signals <= admission_queue_capacity
|
||||||
|
```
|
||||||
|
|
||||||
|
Le plafond pending est donc aligné sur les settings effectifs du Worker plutôt que sur le plafond absolu maximal.
|
||||||
|
|
||||||
|
La requête commune `getTransaction observed` utilise maintenant :
|
||||||
|
|
||||||
|
```text
|
||||||
|
encoding = base64
|
||||||
|
maxSupportedTransactionVersion = 1
|
||||||
|
```
|
||||||
|
|
||||||
|
Cette adaptation s'applique également à Yellowstone. Elle prépare l'hydration aux transactions Legacy/V0/V1 mais ne qualifie aucun nouveau chemin RAW-direct V1.
|
||||||
|
|
||||||
|
## Activation runtime
|
||||||
|
|
||||||
|
Le runtime-resource aggregate peut composer Yellowstone et Standard Logs dans la collection privée bornée, mais la barrière de sûreté reste :
|
||||||
|
|
||||||
|
```text
|
||||||
|
1 source Yellowstone : productif
|
||||||
|
1 source Standard Logs : productif
|
||||||
|
2..32 sources : composition validable
|
||||||
|
start 2..32 : runtime_resources.multi_source_activation_pending avant spawn
|
||||||
|
```
|
||||||
|
|
||||||
|
Aucune source configurée n'est silencieusement ignorée.
|
||||||
|
|
||||||
|
## Preuves ajoutées
|
||||||
|
|
||||||
|
Unit tests Worker :
|
||||||
|
|
||||||
|
```text
|
||||||
|
validation standard WS / commitment / route HTTP
|
||||||
|
source_key stable et filter-sensitive
|
||||||
|
source_key indépendant du hydration role
|
||||||
|
All / AllWithVotes / Mentions distingués
|
||||||
|
Mentions/URL/source-key bytes redacted
|
||||||
|
projection reference-only
|
||||||
|
fixture signature+slot -> une hydration HTTP -> matériau Common RAW exact
|
||||||
|
getTransaction base64 + maxSupportedTransactionVersion=1
|
||||||
|
rejet duplicate Standard Logs identity
|
||||||
|
```
|
||||||
|
|
||||||
|
Canaris externes :
|
||||||
|
|
||||||
|
```text
|
||||||
|
public_api : nouvelle construction/composition accessible depuis crate root
|
||||||
|
dependency_boundary : uniquement façades Transport + Common RAW/Store existants
|
||||||
|
hardening : aucune copie logs/err/payload/url et Debug borné
|
||||||
|
release_completeness : nouvelle surface et canaris pre.003 obligatoires
|
||||||
|
```
|
||||||
|
|
||||||
|
Reconnect, resubscribe, IDs distants et backpressure WebSocket restent couverts et possédés par `ksp-onchain-transport-lib`; le Worker réutilise la façade `SolanaStandardWsSession` au lieu de reproduire ces mécanismes.
|
||||||
|
|
||||||
|
## Fichiers modifiés
|
||||||
|
|
||||||
|
```text
|
||||||
|
Cargo.toml
|
||||||
|
crates/ksp-worker-raw-transaction-ingest-lib/README.md
|
||||||
|
crates/ksp-worker-raw-transaction-ingest-lib/USAGE.md
|
||||||
|
crates/ksp-worker-raw-transaction-ingest-lib/src/lib.rs
|
||||||
|
crates/ksp-worker-raw-transaction-ingest-lib/src/runtime.rs
|
||||||
|
crates/ksp-worker-raw-transaction-ingest-lib/src/runtime_resources.rs
|
||||||
|
crates/ksp-worker-raw-transaction-ingest-lib/tests/dependency_boundary.rs
|
||||||
|
crates/ksp-worker-raw-transaction-ingest-lib/tests/hardening.rs
|
||||||
|
crates/ksp-worker-raw-transaction-ingest-lib/tests/public_api.rs
|
||||||
|
crates/ksp-worker-raw-transaction-ingest-lib/tests/release_completeness.rs
|
||||||
|
crates/ksp-worker-raw-transaction-ingest-lib/unit_tests/runtime_resources.rs
|
||||||
|
docs/plans/034-V0_3_13_MULTI_SOURCE_LIVE_CONVERGENCE_PLAN.md
|
||||||
|
docs/validation/030-V0_3_13_MULTI_SOURCE_LIVE_CONVERGENCE.md
|
||||||
|
```
|
||||||
|
|
||||||
|
## Fichiers ajoutés
|
||||||
|
|
||||||
|
```text
|
||||||
|
deltas/0.3.13/pre.003.md
|
||||||
|
```
|
||||||
|
|
||||||
|
## Fichiers supprimés
|
||||||
|
|
||||||
|
```text
|
||||||
|
aucun
|
||||||
|
```
|
||||||
|
|
||||||
|
## Non-claims
|
||||||
|
|
||||||
|
`pre.003` ne prétend pas :
|
||||||
|
|
||||||
|
```text
|
||||||
|
blockSubscribe productif
|
||||||
|
Helius transactionSubscribe productif
|
||||||
|
HTTP live block polling
|
||||||
|
supervision simultanée de plusieurs sources
|
||||||
|
fanout Store d'observations multi-source
|
||||||
|
coordinator partagé entre plusieurs tâches source simultanées
|
||||||
|
gap repair/backfill
|
||||||
|
nouvelle dépendance externe
|
||||||
|
```
|
||||||
|
|
||||||
|
## Validation dans l'environnement d'assemblage
|
||||||
|
|
||||||
|
Les contrôles réellement exécutés après finalisation de la tranche sont :
|
||||||
|
|
||||||
|
```text
|
||||||
|
python3 scripts/audit_rust_workspace_rules.py
|
||||||
|
PASS : General Rust rule audit clean
|
||||||
|
PASS : Rust export completeness audit 0 candidate
|
||||||
|
PASS : KSP workspace Rust rule audit clean
|
||||||
|
|
||||||
|
python3 scripts/audit_markdown_tables.py README.md RULES.md ROADMAP.md CHANGELOG.md docs prompts crates deltas
|
||||||
|
PASS : Markdown table audit clean (340 tables, 831 files)
|
||||||
|
|
||||||
|
supplemental normative definition-id scan
|
||||||
|
PASS : 489 definitions, 489 unique, 0 duplicate definition id
|
||||||
|
|
||||||
|
pre-packaging exhaustive diff scan
|
||||||
|
PASS : 13 fichiers modifiés, 1 ajouté, 0 supprimé
|
||||||
|
PASS : les 13 headers versionnés des fichiers modifiés sont incrémentés exactement de +1
|
||||||
|
PASS : aucune dépendance Cargo nouvelle
|
||||||
|
```
|
||||||
|
|
||||||
|
Le toolchain Rust/Cargo/Rustfmt n'est pas disponible dans cet environnement. Les commandes Cargo post-modification sont donc explicitement `NON EXÉCUTÉ LOCAL`, jamais déclarées PASS.
|
||||||
|
|
||||||
|
Les caches Python produits par les audits sont supprimés avant packaging et ne font pas partie du delta.
|
||||||
|
|
||||||
|
## Gate opérateur requis avant pre.004
|
||||||
|
|
||||||
|
```bash
|
||||||
|
cargo fmt --all -- --check
|
||||||
|
python3 scripts/audit_rust_workspace_rules.py
|
||||||
|
python3 scripts/audit_markdown_tables.py README.md RULES.md ROADMAP.md CHANGELOG.md docs prompts crates deltas
|
||||||
|
cargo check --workspace
|
||||||
|
cargo clippy --workspace --all-targets --all-features -- -D warnings
|
||||||
|
cargo test -p ksp-onchain-transport-lib
|
||||||
|
cargo test -p ksp-worker-raw-transaction-ingest-lib
|
||||||
|
cargo tree -p ksp-worker-raw-transaction-ingest-lib --edges normal
|
||||||
|
cargo tree -p ksp-worker-raw-transaction-ingest-lib -e features
|
||||||
|
cargo tree --duplicates
|
||||||
|
```
|
||||||
|
|
||||||
|
`pre.004` reste bloquée si ce gate révèle une anomalie de format, règle, compilation, API, dépendance ou test.
|
||||||
94
deltas/0.3.13/pre.004-fix.001.md
Normal file
94
deltas/0.3.13/pre.004-fix.001.md
Normal file
@@ -0,0 +1,94 @@
|
|||||||
|
<!-- file: deltas/0.3.13/pre.004-fix.001.md -->
|
||||||
|
<!-- version: 1 -->
|
||||||
|
|
||||||
|
# Delta 0.3.13-pre.004-fix.001 — retrait de la dépendance serde_json accidentelle
|
||||||
|
|
||||||
|
## Base requise
|
||||||
|
|
||||||
|
```text
|
||||||
|
livraison précédente : 0.3.13-pre.004
|
||||||
|
Cargo base : 0.3.13-pre.4
|
||||||
|
delta base : deltas/0.3.13/pre.004.md
|
||||||
|
archive delta base : ksp-general-0.3.13-pre.004.zip
|
||||||
|
```
|
||||||
|
|
||||||
|
Le gate opérateur de `pre.004` a révélé deux erreurs de compilation liées au même défaut : le Worker nommait directement `serde_json::Value` dans `runtime_resources.rs` alors que `serde_json` n'est pas une dépendance du crate, et le test de qualification Standard Block utilisait directement `serde_json::json!`.
|
||||||
|
|
||||||
|
## Objectif du fix
|
||||||
|
|
||||||
|
Supprimer cette dépendance accidentelle sans ajouter `serde_json` au manifeste du Worker et sans modifier le comportement productif de Standard Block.
|
||||||
|
|
||||||
|
Le chemin production conserve exactement le `meta` décodé par `ksp-onchain-transport-lib`, mais son type concret reste inféré depuis `SolanaBlockTransaction::meta()` et n'est plus nommé par le Worker.
|
||||||
|
|
||||||
|
Le helper de qualification reçoit désormais seulement la version, la position et une closure de construction du matériau. La closure production capture le `meta` opaque et le clone vers le Common RAW. La fixture Legacy/V0/V1 utilise un `RawTransactionWireField::Null`, car elle vérifie la signature embarquée, le slot, le `blockTime`, la version et le `transactionIndex`, pas le contenu de `meta`.
|
||||||
|
|
||||||
|
## Version
|
||||||
|
|
||||||
|
```text
|
||||||
|
livraison : 0.3.13-pre.004-fix.001
|
||||||
|
workspace.package.version : 0.3.13-pre.4.fix.1
|
||||||
|
archive : ksp-general-0.3.13-pre.004-fix.001.zip
|
||||||
|
```
|
||||||
|
|
||||||
|
`Cargo.toml` passe de la version de fichier `546` à `547`.
|
||||||
|
|
||||||
|
## Fichiers modifiés
|
||||||
|
|
||||||
|
```text
|
||||||
|
Cargo.toml
|
||||||
|
crates/ksp-worker-raw-transaction-ingest-lib/src/runtime_resources.rs
|
||||||
|
crates/ksp-worker-raw-transaction-ingest-lib/unit_tests/runtime_resources.rs
|
||||||
|
```
|
||||||
|
|
||||||
|
Les deux fichiers Rust passent de la version de fichier `15` à `16`.
|
||||||
|
|
||||||
|
## Fichiers ajoutés
|
||||||
|
|
||||||
|
```text
|
||||||
|
deltas/0.3.13/pre.004-fix.001.md
|
||||||
|
```
|
||||||
|
|
||||||
|
## Fichiers supprimés
|
||||||
|
|
||||||
|
```text
|
||||||
|
aucun
|
||||||
|
```
|
||||||
|
|
||||||
|
## Non-claims
|
||||||
|
|
||||||
|
Ce fix n'ajoute aucune dépendance, ne modifie aucune API publique et ne change ni la qualification Legacy/V0/V1, ni l'admission RAW, ni la frontier, ni le comportement réseau de `blockSubscribe`.
|
||||||
|
|
||||||
|
## Validation dans l'environnement d'assemblage
|
||||||
|
|
||||||
|
Le toolchain Rust/Cargo/Rustfmt n'est pas disponible dans l'environnement d'assemblage. Les commandes Cargo post-fix restent donc `NON EXÉCUTÉ LOCAL`. Les audits statiques KSP et le contrôle exhaustif du delta sont exécutés avant packaging.
|
||||||
|
|
||||||
|
## Gate opérateur requis avant pre.005
|
||||||
|
|
||||||
|
```bash
|
||||||
|
cargo fmt --all
|
||||||
|
cargo fmt --all -- --check
|
||||||
|
python3 scripts/audit_rust_workspace_rules.py
|
||||||
|
python3 scripts/audit_markdown_tables.py README.md RULES.md ROADMAP.md CHANGELOG.md docs prompts crates deltas
|
||||||
|
cargo check --workspace
|
||||||
|
cargo clippy --workspace --all-targets --all-features -- -D warnings
|
||||||
|
cargo test -p ksp-worker-raw-transaction-ingest-lib
|
||||||
|
```
|
||||||
|
|
||||||
|
## Résultats statiques finaux de l'assemblage
|
||||||
|
|
||||||
|
```text
|
||||||
|
General Rust rule audit: clean
|
||||||
|
Rust export completeness audit: 0 candidate(s)
|
||||||
|
KSP workspace Rust rule audit: clean
|
||||||
|
Markdown table audit: clean (340 tables, 836 files)
|
||||||
|
```
|
||||||
|
|
||||||
|
Contrôle exhaustif du delta :
|
||||||
|
|
||||||
|
```text
|
||||||
|
3 fichiers existants modifiés
|
||||||
|
1 fichier ajouté
|
||||||
|
0 fichier supprimé
|
||||||
|
aucune dépendance ajoutée
|
||||||
|
aucune référence directe serde_json dans les deux fichiers Rust corrigés
|
||||||
|
```
|
||||||
267
deltas/0.3.13/pre.004.md
Normal file
267
deltas/0.3.13/pre.004.md
Normal file
@@ -0,0 +1,267 @@
|
|||||||
|
<!-- file: deltas/0.3.13/pre.004.md -->
|
||||||
|
<!-- version: 1 -->
|
||||||
|
|
||||||
|
# Delta 0.3.13-pre.004 — Standard Solana blockSubscribe RAW-direct qualifié
|
||||||
|
|
||||||
|
## Base requise
|
||||||
|
|
||||||
|
```text
|
||||||
|
delivery précédente : 0.3.13-pre.003-fix.003
|
||||||
|
Cargo base : 0.3.13-pre.3.fix.3
|
||||||
|
delta base : deltas/0.3.13/pre.003-fix.003.md
|
||||||
|
archive delta base : ksp-general-0.3.13-pre.003-fix.003.zip
|
||||||
|
```
|
||||||
|
|
||||||
|
Le gate opérateur reçu sur cette base est vert pour toutes les commandes exécutées : `cargo fmt`, `cargo fmt --check`, audits Rust/Markdown, `cargo check --workspace`, Clippy strict et toutes les suites de `ksp-worker-raw-transaction-ingest-lib` (`75` unit, `4` cross-layer, `10` dependency-boundary, `17` hardening, `11` public-api, `4` release-completeness, `0` doc-test). Cette exécution ne contenait pas le test Transport ni les commandes `cargo tree`; ils ne sont donc pas déclarés PASS pour ce gate précis.
|
||||||
|
|
||||||
|
## Objectif
|
||||||
|
|
||||||
|
Ajouter la deuxième source Solana Standard WebSocket de `0.3.13` sans dupliquer Transport :
|
||||||
|
|
||||||
|
```text
|
||||||
|
Solana standard WS blockSubscribe
|
||||||
|
-> Full + Base64 + maxSupportedTransactionVersion=1 + showRewards=false
|
||||||
|
-> qualification explicite Legacy / V0 / V1
|
||||||
|
-> Common RAW direct par transaction
|
||||||
|
-> admission centrale Worker
|
||||||
|
-> Store
|
||||||
|
```
|
||||||
|
|
||||||
|
La source ne possède pas de fallback HTTP. Tout bloc ou transaction non qualifiable échoue explicitement et sûrement.
|
||||||
|
|
||||||
|
## Version
|
||||||
|
|
||||||
|
```text
|
||||||
|
livraison : 0.3.13-pre.004
|
||||||
|
workspace.package.version : 0.3.13-pre.4
|
||||||
|
archive : ksp-general-0.3.13-pre.004.zip
|
||||||
|
```
|
||||||
|
|
||||||
|
`Cargo.toml` passe également de la version de fichier `545` à `546`.
|
||||||
|
|
||||||
|
## Source Standard Block
|
||||||
|
|
||||||
|
Nouvelle surface publique Worker :
|
||||||
|
|
||||||
|
```text
|
||||||
|
RawTransactionIngestStandardBlockSource
|
||||||
|
RawTransactionIngestRuntimeResources::from_standard_block_source
|
||||||
|
RawTransactionIngestRuntimeResources::try_push_standard_block_source
|
||||||
|
```
|
||||||
|
|
||||||
|
Construction caller-composed :
|
||||||
|
|
||||||
|
```text
|
||||||
|
WsEndpointSettings kind solana_standard
|
||||||
|
SolanaBlockSubscribeFilter
|
||||||
|
SolanaCommitment Confirmed ou Finalized
|
||||||
|
```
|
||||||
|
|
||||||
|
La construction est sans I/O. Elle valide le protocole, le commitment, le réseau et la représentation sûre provider/endpoint avant spawn.
|
||||||
|
|
||||||
|
Au runtime, la source réutilise exclusivement :
|
||||||
|
|
||||||
|
```text
|
||||||
|
SolanaStandardWsSession::connect
|
||||||
|
SolanaStandardWsSession::block_subscribe
|
||||||
|
```
|
||||||
|
|
||||||
|
Configuration exacte :
|
||||||
|
|
||||||
|
```text
|
||||||
|
encoding = Base64
|
||||||
|
transactionDetails = Full
|
||||||
|
maxSupportedTransactionVersion = 1
|
||||||
|
showRewards = false
|
||||||
|
```
|
||||||
|
|
||||||
|
Aucun client WebSocket direct, `getBlock`, `getTransaction`, `reqwest`, `tokio-tungstenite`, `tonic` ou SDK provider n'est ajouté au Worker.
|
||||||
|
|
||||||
|
## Qualification RAW-direct
|
||||||
|
|
||||||
|
La version est fail-closed :
|
||||||
|
|
||||||
|
```text
|
||||||
|
Legacy -> RawTransactionVersion::Legacy
|
||||||
|
0 -> RawTransactionVersion::Number(0)
|
||||||
|
1 -> RawTransactionVersion::Number(1)
|
||||||
|
>1 -> source.standard_block_transaction_version_unsupported
|
||||||
|
omise/null -> source.standard_block_transaction_version_unqualified
|
||||||
|
```
|
||||||
|
|
||||||
|
Le matériau direct conserve :
|
||||||
|
|
||||||
|
```text
|
||||||
|
signature embarquée dans le wire Base64
|
||||||
|
slot
|
||||||
|
blockTime
|
||||||
|
meta
|
||||||
|
version qualifiée
|
||||||
|
transactionIndex dans le bloc
|
||||||
|
```
|
||||||
|
|
||||||
|
Les fixtures locales construisent et sérialisent des wires Legacy, V0 et V1 avec les types publics de `ksp-raw-transaction-lib`, puis vérifient le Common RAW canonique obtenu. La preuve V1 ne repose donc pas uniquement sur une étiquette `version=1`.
|
||||||
|
|
||||||
|
La parité historique `blockSubscribe` / `getBlock` Legacy reste déjà matérialisée dans `ksp-job-backfill-lib/tests/ws_raw_parity.rs`; `pre.004` rejoue localement les matérialisations Legacy/V0 et ajoute la qualification V1.
|
||||||
|
|
||||||
|
## block:null et formes ambiguës
|
||||||
|
|
||||||
|
Les cas suivants sont des fautes sûres avant progression de frontier :
|
||||||
|
|
||||||
|
```text
|
||||||
|
context.slot différent du slot de notification
|
||||||
|
notification err non null
|
||||||
|
block null
|
||||||
|
transactions omitted/null
|
||||||
|
transaction non Base64
|
||||||
|
version omise/null/>1
|
||||||
|
signature embarquée invalide
|
||||||
|
transaction index non représentable en u32
|
||||||
|
```
|
||||||
|
|
||||||
|
`block: null` n'est jamais assimilé à un bloc vide ou à un slot traité. Le décodage Transport qui distingue `block:null` et `err` est conservé tel quel.
|
||||||
|
|
||||||
|
Pour un bloc non vide, le slot n'est enregistré settled qu'après l'admission réussie de toutes ses transactions. La voie RAW-direct n'incrémente pas `hydration_pending`; le processing frontier ne peut donc pas avancer transitoirement au milieu du traitement d'un même bloc et un stop/faute partiel ne devient jamais une progression.
|
||||||
|
|
||||||
|
## Identité logique et redaction
|
||||||
|
|
||||||
|
Le `source_key` Standard Block est dérivé de :
|
||||||
|
|
||||||
|
```text
|
||||||
|
domain KSP live-source v1
|
||||||
|
family = standard_block
|
||||||
|
network
|
||||||
|
safe provider identity
|
||||||
|
safe endpoint identity
|
||||||
|
commitment
|
||||||
|
private block-filter fingerprint
|
||||||
|
```
|
||||||
|
|
||||||
|
Les filtres `All` et `MentionsAccountOrProgram(pubkey)` sont distingués par empreinte privée. Le pubkey brut n'est pas recopié dans `Debug`, snapshot ou provenance textuelle.
|
||||||
|
|
||||||
|
Le bound global `1..32`, l'invariant réseau unique et le rejet transactionnel des doublons de `pre.002` s'appliquent à cette nouvelle famille.
|
||||||
|
|
||||||
|
## Activation runtime
|
||||||
|
|
||||||
|
Le contrat reste volontairement mono-source avant `pre.007` :
|
||||||
|
|
||||||
|
```text
|
||||||
|
1 source Yellowstone : productif
|
||||||
|
1 source Standard Logs : productif
|
||||||
|
1 source Standard Block : productif
|
||||||
|
2..32 sources : composition validable
|
||||||
|
start 2..32 : runtime_resources.multi_source_activation_pending avant spawn
|
||||||
|
```
|
||||||
|
|
||||||
|
Aucune source configurée n'est silencieusement ignorée.
|
||||||
|
|
||||||
|
## Preuves ajoutées
|
||||||
|
|
||||||
|
Unit tests Worker :
|
||||||
|
|
||||||
|
```text
|
||||||
|
validation protocole/commitment Standard Block
|
||||||
|
source_key stable et filter-sensitive
|
||||||
|
redaction filtre/url/source-key
|
||||||
|
qualification exacte Legacy/V0/V1
|
||||||
|
rejet version omise/null/>1
|
||||||
|
wires Legacy/V0/V1 -> Common RAW direct avec signature/version/index exacts
|
||||||
|
rejet duplicate Standard Block identity
|
||||||
|
```
|
||||||
|
|
||||||
|
Canaris externes :
|
||||||
|
|
||||||
|
```text
|
||||||
|
public_api : construction/composition depuis crate root
|
||||||
|
dependency_boundary : façade Transport seulement, sans fallback HTTP/direct network crate
|
||||||
|
hardening : block:null, erreurs, version, encoding et redaction explicites
|
||||||
|
release_completeness : export et canaris pre.004 obligatoires
|
||||||
|
```
|
||||||
|
|
||||||
|
## Fichiers modifiés
|
||||||
|
|
||||||
|
```text
|
||||||
|
Cargo.toml
|
||||||
|
crates/ksp-worker-raw-transaction-ingest-lib/README.md
|
||||||
|
crates/ksp-worker-raw-transaction-ingest-lib/USAGE.md
|
||||||
|
crates/ksp-worker-raw-transaction-ingest-lib/src/lib.rs
|
||||||
|
crates/ksp-worker-raw-transaction-ingest-lib/src/runtime_resources.rs
|
||||||
|
crates/ksp-worker-raw-transaction-ingest-lib/tests/dependency_boundary.rs
|
||||||
|
crates/ksp-worker-raw-transaction-ingest-lib/tests/hardening.rs
|
||||||
|
crates/ksp-worker-raw-transaction-ingest-lib/tests/public_api.rs
|
||||||
|
crates/ksp-worker-raw-transaction-ingest-lib/tests/release_completeness.rs
|
||||||
|
crates/ksp-worker-raw-transaction-ingest-lib/unit_tests/runtime_resources.rs
|
||||||
|
docs/plans/034-V0_3_13_MULTI_SOURCE_LIVE_CONVERGENCE_PLAN.md
|
||||||
|
docs/validation/030-V0_3_13_MULTI_SOURCE_LIVE_CONVERGENCE.md
|
||||||
|
```
|
||||||
|
|
||||||
|
## Fichiers ajoutés
|
||||||
|
|
||||||
|
```text
|
||||||
|
deltas/0.3.13/pre.004.md
|
||||||
|
```
|
||||||
|
|
||||||
|
## Fichiers supprimés
|
||||||
|
|
||||||
|
```text
|
||||||
|
aucun
|
||||||
|
```
|
||||||
|
|
||||||
|
## Non-claims
|
||||||
|
|
||||||
|
`pre.004` ne prétend pas :
|
||||||
|
|
||||||
|
```text
|
||||||
|
Helius transactionSubscribe productif
|
||||||
|
HTTP live block polling
|
||||||
|
supervision simultanée de plusieurs sources
|
||||||
|
fanout Store d'observations multi-source
|
||||||
|
fallback HTTP getBlock/getTransaction pour Standard Block
|
||||||
|
RAW-direct pour version >1 ou version ambiguë
|
||||||
|
block:null considéré comme progression
|
||||||
|
nouvelle dépendance externe
|
||||||
|
```
|
||||||
|
|
||||||
|
## Validation dans l'environnement d'assemblage
|
||||||
|
|
||||||
|
Le toolchain Rust/Cargo/Rustfmt n'est pas disponible dans l'environnement d'assemblage. Les commandes Cargo post-`pre.004` restent donc `NON EXÉCUTÉ LOCAL`. Les audits statiques KSP, le scan des identifiants normatifs et le contrôle exhaustif du diff sont exécutés avant packaging et leurs résultats finaux sont consignés ci-dessous avant livraison.
|
||||||
|
|
||||||
|
## Gate opérateur requis avant pre.005
|
||||||
|
|
||||||
|
```bash
|
||||||
|
cargo fmt --all -- --check
|
||||||
|
python3 scripts/audit_rust_workspace_rules.py
|
||||||
|
python3 scripts/audit_markdown_tables.py README.md RULES.md ROADMAP.md CHANGELOG.md docs prompts crates deltas
|
||||||
|
cargo check --workspace
|
||||||
|
cargo clippy --workspace --all-targets --all-features -- -D warnings
|
||||||
|
cargo test -p ksp-onchain-transport-lib
|
||||||
|
cargo test -p ksp-worker-raw-transaction-ingest-lib
|
||||||
|
cargo tree -p ksp-worker-raw-transaction-ingest-lib --edges normal
|
||||||
|
cargo tree -p ksp-worker-raw-transaction-ingest-lib -e features
|
||||||
|
cargo tree --duplicates
|
||||||
|
```
|
||||||
|
|
||||||
|
`pre.005` ne doit pas commencer si ce gate révèle une anomalie.
|
||||||
|
|
||||||
|
## Résultats statiques finaux de l'assemblage
|
||||||
|
|
||||||
|
```text
|
||||||
|
General Rust rule audit: clean
|
||||||
|
Rust export completeness audit: 0 candidate(s)
|
||||||
|
KSP workspace Rust rule audit: clean
|
||||||
|
Markdown table audit: clean (340 tables, 835 files)
|
||||||
|
Normative rule definitions: 489
|
||||||
|
Unique normative IDs: 489
|
||||||
|
Duplicates: 0
|
||||||
|
```
|
||||||
|
|
||||||
|
Contrôle exhaustif avant packaging :
|
||||||
|
|
||||||
|
```text
|
||||||
|
12 fichiers existants modifiés
|
||||||
|
1 fichier ajouté
|
||||||
|
0 fichier supprimé
|
||||||
|
12/12 headers versionnés incrémentés exactement de +1
|
||||||
|
Cargo.toml hors header : uniquement workspace.package.version 0.3.13-pre.3.fix.3 -> 0.3.13-pre.4
|
||||||
|
aucune dépendance ajoutée, supprimée ou modifiée
|
||||||
|
```
|
||||||
94
deltas/0.3.13/pre.005-fix.001.md
Normal file
94
deltas/0.3.13/pre.005-fix.001.md
Normal file
@@ -0,0 +1,94 @@
|
|||||||
|
<!-- file: deltas/0.3.13/pre.005-fix.001.md -->
|
||||||
|
<!-- version: 1 -->
|
||||||
|
|
||||||
|
# Delta 0.3.13-pre.005-fix.001 — correction du canari de redaction Helius
|
||||||
|
|
||||||
|
## Base requise
|
||||||
|
|
||||||
|
```text
|
||||||
|
livraison précédente : 0.3.13-pre.005
|
||||||
|
Cargo base : 0.3.13-pre.5
|
||||||
|
delta base : deltas/0.3.13/pre.005.md
|
||||||
|
archive delta base : ksp-general-0.3.13-pre.005.zip
|
||||||
|
```
|
||||||
|
|
||||||
|
Le gate opérateur du 10 septembre 2026 sur `pre.005` est vert pour `cargo fmt`, `cargo fmt --check`, les audits Rust/Markdown, `cargo check --workspace`, Clippy strict, les `84` tests unitaires Worker et les `12` tests `dependency_boundary`. Il s'arrête ensuite sur un seul test de hardening : `v0_3_12_pre_002_production_sources_keep_transport_confined_to_runtime_resources` détecte le mot `credential` dans `runtime_resources.rs`.
|
||||||
|
|
||||||
|
L'occurrence concernée se trouve uniquement dans une Rustdoc décrivant l'encapsulation des paramètres Transport Helius. Aucun secret, aucune credential et aucune valeur sensible n'est stocké en clair dans le Worker par cette chaîne documentaire.
|
||||||
|
|
||||||
|
## Objectif du fix
|
||||||
|
|
||||||
|
Conserver le canari de hardening inchangé et reformuler la Rustdoc production afin qu'elle respecte sa politique textuelle stricte. La phrase emploie désormais `sensitive endpoint material` au lieu de `credentials`.
|
||||||
|
|
||||||
|
Aucune logique Helius, WebSocket, hydration, source identity, admission, Store, frontier ou API publique n'est modifiée.
|
||||||
|
|
||||||
|
## Version
|
||||||
|
|
||||||
|
```text
|
||||||
|
livraison : 0.3.13-pre.005-fix.001
|
||||||
|
workspace.package.version : 0.3.13-pre.5.fix.1
|
||||||
|
archive : ksp-general-0.3.13-pre.005-fix.001.zip
|
||||||
|
```
|
||||||
|
|
||||||
|
`Cargo.toml` passe de la version de fichier `548` à `549`.
|
||||||
|
|
||||||
|
## Fichiers modifiés
|
||||||
|
|
||||||
|
```text
|
||||||
|
Cargo.toml
|
||||||
|
crates/ksp-worker-raw-transaction-ingest-lib/src/runtime_resources.rs
|
||||||
|
```
|
||||||
|
|
||||||
|
`runtime_resources.rs` passe de la version de fichier `17` à `18`.
|
||||||
|
|
||||||
|
## Fichiers ajoutés
|
||||||
|
|
||||||
|
```text
|
||||||
|
deltas/0.3.13/pre.005-fix.001.md
|
||||||
|
```
|
||||||
|
|
||||||
|
## Fichiers supprimés
|
||||||
|
|
||||||
|
```text
|
||||||
|
aucun
|
||||||
|
```
|
||||||
|
|
||||||
|
## Non-claims
|
||||||
|
|
||||||
|
Ce fix ne modifie aucune dépendance, aucun code exécutable et aucun test. Il ne change pas le comportement de `transactionSubscribe`, de l'hydration `getTransaction observed`, de la redaction runtime ni de la convergence multi-source.
|
||||||
|
|
||||||
|
## Validation dans l'environnement d'assemblage
|
||||||
|
|
||||||
|
Le toolchain Rust/Cargo/Rustfmt n'est pas disponible dans l'environnement d'assemblage. Les commandes Cargo post-fix restent donc `NON EXÉCUTÉ LOCAL`. Les audits statiques KSP et le contrôle exhaustif du delta sont exécutés avant packaging.
|
||||||
|
|
||||||
|
## Gate opérateur requis avant pre.006
|
||||||
|
|
||||||
|
```bash
|
||||||
|
cargo fmt --all
|
||||||
|
cargo fmt --all -- --check
|
||||||
|
python3 scripts/audit_rust_workspace_rules.py
|
||||||
|
python3 scripts/audit_markdown_tables.py README.md RULES.md ROADMAP.md CHANGELOG.md docs prompts crates deltas
|
||||||
|
cargo check --workspace
|
||||||
|
cargo clippy --workspace --all-targets --all-features -- -D warnings
|
||||||
|
cargo test -p ksp-worker-raw-transaction-ingest-lib
|
||||||
|
```
|
||||||
|
|
||||||
|
## Résultats statiques finaux de l'assemblage
|
||||||
|
|
||||||
|
```text
|
||||||
|
General Rust rule audit: clean
|
||||||
|
Rust export completeness audit: 0 candidate(s)
|
||||||
|
KSP workspace Rust rule audit: clean
|
||||||
|
Markdown table audit: clean (340 tables, 838 files)
|
||||||
|
```
|
||||||
|
|
||||||
|
Contrôle exhaustif du delta :
|
||||||
|
|
||||||
|
```text
|
||||||
|
2 fichiers existants modifiés
|
||||||
|
1 fichier ajouté
|
||||||
|
0 fichier supprimé
|
||||||
|
aucun test modifié
|
||||||
|
aucune dépendance ajoutée/modifiée/supprimée
|
||||||
|
aucun marqueur secret-like interdit restant dans les sources Rust production du Worker
|
||||||
|
```
|
||||||
268
deltas/0.3.13/pre.005.md
Normal file
268
deltas/0.3.13/pre.005.md
Normal file
@@ -0,0 +1,268 @@
|
|||||||
|
<!-- file: deltas/0.3.13/pre.005.md -->
|
||||||
|
<!-- version: 1 -->
|
||||||
|
|
||||||
|
# Delta 0.3.13-pre.005 — Helius transactionSubscribe + hydration Common RAW
|
||||||
|
|
||||||
|
## Base requise
|
||||||
|
|
||||||
|
```text
|
||||||
|
livraison précédente : 0.3.13-pre.004-fix.001
|
||||||
|
Cargo base : 0.3.13-pre.4.fix.1
|
||||||
|
delta base : deltas/0.3.13/pre.004-fix.001.md
|
||||||
|
archive delta base : ksp-general-0.3.13-pre.004-fix.001.zip
|
||||||
|
```
|
||||||
|
|
||||||
|
Le gate opérateur reçu le 10 septembre 2026 sur cette base est vert pour toutes les commandes exécutées : `cargo fmt`, `cargo fmt --check`, audits Rust/Markdown, `cargo check --workspace`, Clippy strict et toutes les suites de `ksp-worker-raw-transaction-ingest-lib` (`79` unit, `4` cross-layer, `11` dependency-boundary, `18` hardening, `12` public-api, `4` release-completeness, `0` doc-test). Cette exécution ne contenait pas le test Transport ni les commandes `cargo tree`; ils ne sont donc pas déclarés PASS pour ce gate précis.
|
||||||
|
|
||||||
|
## Objectif
|
||||||
|
|
||||||
|
Ajouter la source Helius WebSocket prévue par la tranche sans dupliquer le chemin Common RAW :
|
||||||
|
|
||||||
|
```text
|
||||||
|
Helius LaserStream transactionSubscribe
|
||||||
|
-> Full + Base64 + maxSupportedTransactionVersion=1 + showRewards=false
|
||||||
|
-> projection privée signature + slot + transactionIndex
|
||||||
|
-> coordinateur d'hydration source-neutral existant
|
||||||
|
-> HTTP getTransaction observed
|
||||||
|
-> Common RAW canonique
|
||||||
|
-> admission centrale Worker
|
||||||
|
-> Store
|
||||||
|
```
|
||||||
|
|
||||||
|
Le nested payload transaction Helius n'est pas utilisé comme RAW-direct. Il reste possédé par Transport et n'est jamais copié dans le signal Worker.
|
||||||
|
|
||||||
|
## Version
|
||||||
|
|
||||||
|
```text
|
||||||
|
livraison : 0.3.13-pre.005
|
||||||
|
workspace.package.version : 0.3.13-pre.5
|
||||||
|
archive : ksp-general-0.3.13-pre.005.zip
|
||||||
|
```
|
||||||
|
|
||||||
|
`Cargo.toml` passe de la version de fichier `547` à `548`.
|
||||||
|
|
||||||
|
## Source Helius Transaction
|
||||||
|
|
||||||
|
Nouvelle surface publique Worker :
|
||||||
|
|
||||||
|
```text
|
||||||
|
RawTransactionIngestHeliusTransactionSource
|
||||||
|
RawTransactionIngestRuntimeResources::from_helius_transaction_source
|
||||||
|
RawTransactionIngestRuntimeResources::try_push_helius_transaction_source
|
||||||
|
```
|
||||||
|
|
||||||
|
Construction caller-composed :
|
||||||
|
|
||||||
|
```text
|
||||||
|
WsEndpointSettings kind helius_laserstream
|
||||||
|
HeliusTransactionSubscribeFilter
|
||||||
|
SolanaCommitment Confirmed ou Finalized
|
||||||
|
HttpTransportPool
|
||||||
|
HttpRoleName d'hydration
|
||||||
|
```
|
||||||
|
|
||||||
|
La construction est sans I/O. Elle refuse un endpoint invalide ou non Helius LaserStream, `Processed`, un réseau/provenance non représentable et l'absence d'une route HTTP `getTransaction` compatible sur le même réseau.
|
||||||
|
|
||||||
|
Au runtime, la source réutilise exclusivement les façades Transport existantes :
|
||||||
|
|
||||||
|
```text
|
||||||
|
HeliusLaserStreamWsSession::connect
|
||||||
|
HeliusLaserStreamWsSession::transaction_subscribe
|
||||||
|
HttpTransportPool::get_transaction_observed via le coordinateur commun
|
||||||
|
```
|
||||||
|
|
||||||
|
Aucun client WebSocket direct, SDK Helius, `reqwest`, `tokio-tungstenite`, backend Store ou accès Config n'est ajouté au Worker.
|
||||||
|
|
||||||
|
## Requête Helius qualifiée
|
||||||
|
|
||||||
|
La requête Worker est fixée à :
|
||||||
|
|
||||||
|
```text
|
||||||
|
commitment = Confirmed | Finalized
|
||||||
|
encoding = Base64
|
||||||
|
transactionDetails = Full
|
||||||
|
showRewards = false
|
||||||
|
maxSupportedTransactionVersion = 1
|
||||||
|
```
|
||||||
|
|
||||||
|
Une notification productive doit être `HeliusTransactionNotification::Full`. Une forme `Signature`, `Unknown` ou future malgré la requête `Full` devient `source.helius_transaction_notification_unqualified`; elle n'est jamais convertie en succès silencieux.
|
||||||
|
|
||||||
|
## Projection et hydration
|
||||||
|
|
||||||
|
Le signal privé issu d'une notification `Full` conserve seulement :
|
||||||
|
|
||||||
|
```text
|
||||||
|
network
|
||||||
|
signature
|
||||||
|
slot
|
||||||
|
transactionIndex
|
||||||
|
safe route identity
|
||||||
|
private filter fingerprint
|
||||||
|
commitment via hydration context
|
||||||
|
```
|
||||||
|
|
||||||
|
Le nested champ `transaction` de la notification Helius n'est pas lu par `project_helius_transaction_signal` et n'est pas copié dans Worker. La construction Common RAW reste donc unique : `getTransaction observed` en Base64 avec `maxSupportedTransactionVersion = 1`, puis canonicalisation/admission existantes.
|
||||||
|
|
||||||
|
Le coordinateur d'hydration reste borné et source-neutral :
|
||||||
|
|
||||||
|
```text
|
||||||
|
in-flight hydration <= persistence_concurrency
|
||||||
|
pending source signals <= admission_queue_capacity
|
||||||
|
coalescence key = network + signature + commitment
|
||||||
|
```
|
||||||
|
|
||||||
|
Cette voie converge avec Yellowstone et Standard Logs au lieu d'introduire un second moteur HTTP.
|
||||||
|
|
||||||
|
## Identité logique, redaction et secrets
|
||||||
|
|
||||||
|
Le `source_key` Helius est dérivé de :
|
||||||
|
|
||||||
|
```text
|
||||||
|
domain KSP live-source v1
|
||||||
|
family = helius_transaction
|
||||||
|
network
|
||||||
|
safe provider identity
|
||||||
|
safe endpoint identity
|
||||||
|
commitment
|
||||||
|
private normalized Helius filter fingerprint
|
||||||
|
SHA-256 -> [u8; 32]
|
||||||
|
```
|
||||||
|
|
||||||
|
L'empreinte privée couvre `vote`, `failed`, signature exacte, listes `accountInclude`/`accountExclude`/`accountRequired` et `tokenAccounts`. Les listes de pubkeys sont triées avant hash afin que leur ordre ne crée pas artificiellement deux identités logiques. Le rôle/pool HTTP d'hydration reste exclu du `source_key`.
|
||||||
|
|
||||||
|
Les URLs et credentials restent encapsulés par les settings Transport privés utilisés pour ouvrir les connexions ; ils ne sont exposés ni par l'API publique ni par `Debug`. Les valeurs de signature/pubkeys du filtre et les octets de `source_key` ne sont pas rendus dans les diagnostics Worker.
|
||||||
|
|
||||||
|
Les profils Config Helius et `KSP_SECRET_HELIUS_API_KEY` existaient déjà avant cette tranche. Aucun changement Config, `.env`, entitlement, quota, prix ou tier provider n'est codé dans Worker.
|
||||||
|
|
||||||
|
## Activation runtime
|
||||||
|
|
||||||
|
Le contrat reste volontairement mono-source avant `pre.007` :
|
||||||
|
|
||||||
|
```text
|
||||||
|
1 source Yellowstone : productif
|
||||||
|
1 source Standard Logs : productif
|
||||||
|
1 source Standard Block : productif
|
||||||
|
1 source Helius Transaction : productif
|
||||||
|
2..32 sources : composition validable
|
||||||
|
start 2..32 : runtime_resources.multi_source_activation_pending avant spawn
|
||||||
|
```
|
||||||
|
|
||||||
|
Aucune source configurée n'est silencieusement ignorée.
|
||||||
|
|
||||||
|
## Preuves ajoutées
|
||||||
|
|
||||||
|
Unit tests Worker :
|
||||||
|
|
||||||
|
```text
|
||||||
|
validation protocole/commitment/route HTTP Helius
|
||||||
|
requête fixe Full/Base64/maxV1/showRewards=false
|
||||||
|
source_key filter-sensitive, order-normalized et hydration-role-neutral
|
||||||
|
Debug redacted : signature/pubkeys/URL/API key/source-key absents
|
||||||
|
projection Full -> signature/slot/index uniquement
|
||||||
|
Helius reference -> un getTransaction observed -> Common RAW exact
|
||||||
|
provenance helius_ws_http + transaction_get_transaction
|
||||||
|
rejet transactionnel d'une identité Helius dupliquée
|
||||||
|
```
|
||||||
|
|
||||||
|
Canaris externes :
|
||||||
|
|
||||||
|
```text
|
||||||
|
public_api : construction/from/push depuis crate root sans escape hatch des ressources internes
|
||||||
|
dependency_boundary : façades Transport Helius + un seul getTransaction commun
|
||||||
|
hardening : nested payload non copié, secrets/redaction et absence de tier provider
|
||||||
|
release_completeness : export et canaris pre.005 obligatoires
|
||||||
|
```
|
||||||
|
|
||||||
|
## Documentation corrigée
|
||||||
|
|
||||||
|
La documentation Worker est mise à jour pour inclure la source Helius et la convergence d'hydration. Une mention héritée de `README.md` qui classait encore `blockSubscribe` et Helius parmi les sources hors périmètre est supprimée ; `USAGE.md` reste volontairement version-neutral.
|
||||||
|
|
||||||
|
## Fichiers modifiés
|
||||||
|
|
||||||
|
```text
|
||||||
|
Cargo.toml
|
||||||
|
crates/ksp-worker-raw-transaction-ingest-lib/README.md
|
||||||
|
crates/ksp-worker-raw-transaction-ingest-lib/USAGE.md
|
||||||
|
crates/ksp-worker-raw-transaction-ingest-lib/src/lib.rs
|
||||||
|
crates/ksp-worker-raw-transaction-ingest-lib/src/runtime_resources.rs
|
||||||
|
crates/ksp-worker-raw-transaction-ingest-lib/tests/dependency_boundary.rs
|
||||||
|
crates/ksp-worker-raw-transaction-ingest-lib/tests/hardening.rs
|
||||||
|
crates/ksp-worker-raw-transaction-ingest-lib/tests/public_api.rs
|
||||||
|
crates/ksp-worker-raw-transaction-ingest-lib/tests/release_completeness.rs
|
||||||
|
crates/ksp-worker-raw-transaction-ingest-lib/unit_tests/runtime_resources.rs
|
||||||
|
docs/plans/034-V0_3_13_MULTI_SOURCE_LIVE_CONVERGENCE_PLAN.md
|
||||||
|
docs/validation/030-V0_3_13_MULTI_SOURCE_LIVE_CONVERGENCE.md
|
||||||
|
```
|
||||||
|
|
||||||
|
## Fichiers ajoutés
|
||||||
|
|
||||||
|
```text
|
||||||
|
deltas/0.3.13/pre.005.md
|
||||||
|
```
|
||||||
|
|
||||||
|
## Fichiers supprimés
|
||||||
|
|
||||||
|
```text
|
||||||
|
aucun
|
||||||
|
```
|
||||||
|
|
||||||
|
## Non-claims
|
||||||
|
|
||||||
|
`pre.005` ne prétend pas :
|
||||||
|
|
||||||
|
```text
|
||||||
|
supervision simultanée de plusieurs sources
|
||||||
|
HTTP live block polling
|
||||||
|
RAW-direct depuis le nested payload Helius
|
||||||
|
SDK Helius dans Worker
|
||||||
|
secret/API key lu directement par Worker
|
||||||
|
nouveau profil Config Helius
|
||||||
|
entitlement/tier/quota/prix provider codé
|
||||||
|
modification de ksp-onchain-transport-lib
|
||||||
|
nouvelle dépendance externe
|
||||||
|
```
|
||||||
|
|
||||||
|
## Validation dans l'environnement d'assemblage
|
||||||
|
|
||||||
|
Le toolchain Rust/Cargo/Rustfmt n'est pas disponible dans l'environnement d'assemblage. Les commandes Cargo post-`pre.005` restent donc `NON EXÉCUTÉ LOCAL`. Les audits statiques KSP, le scan des identifiants normatifs et le contrôle exhaustif du diff sont exécutés avant packaging.
|
||||||
|
|
||||||
|
## Gate opérateur requis avant pre.006
|
||||||
|
|
||||||
|
```bash
|
||||||
|
cargo fmt --all
|
||||||
|
cargo fmt --all -- --check
|
||||||
|
python3 scripts/audit_rust_workspace_rules.py
|
||||||
|
python3 scripts/audit_markdown_tables.py README.md RULES.md ROADMAP.md CHANGELOG.md docs prompts crates deltas
|
||||||
|
cargo check --workspace
|
||||||
|
cargo clippy --workspace --all-targets --all-features -- -D warnings
|
||||||
|
cargo test -p ksp-onchain-transport-lib
|
||||||
|
cargo test -p ksp-worker-raw-transaction-ingest-lib
|
||||||
|
cargo tree -p ksp-worker-raw-transaction-ingest-lib --edges normal
|
||||||
|
cargo tree -p ksp-worker-raw-transaction-ingest-lib -e features
|
||||||
|
cargo tree --duplicates
|
||||||
|
```
|
||||||
|
|
||||||
|
`pre.006` ne doit pas commencer si ce gate révèle une anomalie.
|
||||||
|
|
||||||
|
## Résultats statiques finaux de l'assemblage
|
||||||
|
|
||||||
|
```text
|
||||||
|
General Rust rule audit: clean
|
||||||
|
Rust export completeness audit: 0 candidate(s)
|
||||||
|
KSP workspace Rust rule audit: clean
|
||||||
|
Markdown table audit: clean (340 tables, 837 files)
|
||||||
|
Normative rule definitions: 489
|
||||||
|
Unique normative IDs: 489
|
||||||
|
Duplicates: 0
|
||||||
|
```
|
||||||
|
|
||||||
|
## Contrôle exhaustif avant packaging
|
||||||
|
|
||||||
|
```text
|
||||||
|
12 fichiers existants modifiés
|
||||||
|
1 fichier ajouté
|
||||||
|
0 fichier supprimé
|
||||||
|
12/12 headers de fichiers existants incrémentés exactement de +1
|
||||||
|
Cargo.toml : version workspace uniquement hors header
|
||||||
|
aucune dépendance ajoutée/modifiée/supprimée
|
||||||
|
```
|
||||||
111
deltas/0.3.13/pre.006-fix.001.md
Normal file
111
deltas/0.3.13/pre.006-fix.001.md
Normal file
@@ -0,0 +1,111 @@
|
|||||||
|
<!-- file: deltas/0.3.13/pre.006-fix.001.md -->
|
||||||
|
<!-- version: 1 -->
|
||||||
|
|
||||||
|
# Delta 0.3.13-pre.006-fix.001 — correction du canari historique après live block discovery
|
||||||
|
|
||||||
|
## Base requise
|
||||||
|
|
||||||
|
```text
|
||||||
|
livraison précédente : 0.3.13-pre.006
|
||||||
|
Cargo base : 0.3.13-pre.6
|
||||||
|
delta base : deltas/0.3.13/pre.006.md
|
||||||
|
archive delta base : ksp-general-0.3.13-pre.006.zip
|
||||||
|
```
|
||||||
|
|
||||||
|
Le gate opérateur du 10 septembre 2026 sur `pre.006` est vert pour `cargo fmt`, `cargo fmt --check`, les audits Rust/Markdown, `cargo check --workspace`, Clippy strict, les `88` tests unitaires Worker et les `13` tests `dependency_boundary`. Il s'arrête ensuite sur un seul canari de hardening : `pre_010_production_surface_has_no_historical_backfill_or_retriever_contract` détecte la chaîne `Backfill` dans la Rustdoc de la nouvelle source HTTP live block polling.
|
||||||
|
|
||||||
|
La même vérification interdisait également globalement `Discovery`/`discovery`. Cette hypothèse n'est plus valide depuis `pre.006` : la découverte run-local via `getBlocksWithLimit` est une primitive légitime du live polling et ne constitue ni un retriever historique ni un Backfill.
|
||||||
|
|
||||||
|
## Objectif du fix
|
||||||
|
|
||||||
|
Conserver la séparation Worker/Backfill sans interdire la terminologie de live block discovery introduite par le poller HTTP :
|
||||||
|
|
||||||
|
```text
|
||||||
|
Rustdoc HTTP polling : suppression de la mention Backfill
|
||||||
|
canari historique : conserve les interdictions retriever/backfill/checkpoint/historical
|
||||||
|
mais ne classe plus Discovery/discovery comme marqueur historique
|
||||||
|
```
|
||||||
|
|
||||||
|
Aucune logique de polling, cadence, Transport, admission, Store, processing frontier, provenance, source identity ou API publique n'est modifiée.
|
||||||
|
|
||||||
|
## Version
|
||||||
|
|
||||||
|
```text
|
||||||
|
livraison : 0.3.13-pre.006-fix.001
|
||||||
|
workspace.package.version : 0.3.13-pre.6.fix.1
|
||||||
|
archive : ksp-general-0.3.13-pre.006-fix.001.zip
|
||||||
|
```
|
||||||
|
|
||||||
|
`Cargo.toml` passe de la version de fichier `550` à `551`.
|
||||||
|
|
||||||
|
## Fichiers modifiés
|
||||||
|
|
||||||
|
```text
|
||||||
|
Cargo.toml
|
||||||
|
crates/ksp-worker-raw-transaction-ingest-lib/src/runtime_resources.rs
|
||||||
|
crates/ksp-worker-raw-transaction-ingest-lib/tests/hardening.rs
|
||||||
|
```
|
||||||
|
|
||||||
|
Versions de fichiers :
|
||||||
|
|
||||||
|
```text
|
||||||
|
runtime_resources.rs : 19 -> 20
|
||||||
|
hardening.rs : 15 -> 16
|
||||||
|
```
|
||||||
|
|
||||||
|
## Fichiers ajoutés
|
||||||
|
|
||||||
|
```text
|
||||||
|
deltas/0.3.13/pre.006-fix.001.md
|
||||||
|
```
|
||||||
|
|
||||||
|
## Fichiers supprimés
|
||||||
|
|
||||||
|
```text
|
||||||
|
aucun
|
||||||
|
```
|
||||||
|
|
||||||
|
## Non-claims
|
||||||
|
|
||||||
|
Ce fix ne modifie aucune dépendance et n'ajoute aucune source. Il ne change ni la borne de run, ni `getSlot`, ni `getBlocksWithLimit`, ni `getBlock observed`, ni les règles Legacy/V0/V1, ni la sémantique `block:null`.
|
||||||
|
|
||||||
|
## Validation dans l'environnement d'assemblage
|
||||||
|
|
||||||
|
Le toolchain Rust/Cargo/Rustfmt n'est pas disponible dans l'environnement d'assemblage. Les commandes Cargo post-fix restent donc `NON EXÉCUTÉ LOCAL`. Les audits statiques KSP et le contrôle exhaustif du delta sont exécutés avant packaging.
|
||||||
|
|
||||||
|
## Gate opérateur requis avant pre.007
|
||||||
|
|
||||||
|
```bash
|
||||||
|
cargo fmt --all
|
||||||
|
cargo fmt --all -- --check
|
||||||
|
python3 scripts/audit_rust_workspace_rules.py
|
||||||
|
python3 scripts/audit_markdown_tables.py README.md RULES.md ROADMAP.md CHANGELOG.md docs prompts crates deltas
|
||||||
|
cargo check --workspace
|
||||||
|
cargo clippy --workspace --all-targets --all-features -- -D warnings
|
||||||
|
cargo test -p ksp-worker-raw-transaction-ingest-lib
|
||||||
|
```
|
||||||
|
|
||||||
|
## Résultats statiques finaux de l'assemblage
|
||||||
|
|
||||||
|
```text
|
||||||
|
General Rust rule audit: clean
|
||||||
|
Rust export completeness audit: 0 candidate(s)
|
||||||
|
KSP workspace Rust rule audit: clean
|
||||||
|
Markdown table audit: clean (340 tables, 840 files)
|
||||||
|
Normative rule definitions: 489
|
||||||
|
Unique normative IDs: 489
|
||||||
|
Duplicates: 0
|
||||||
|
```
|
||||||
|
|
||||||
|
Contrôle ciblé de la surface production Worker :
|
||||||
|
|
||||||
|
```text
|
||||||
|
ksp-worker-raw-retriever : 0
|
||||||
|
raw_transaction_retriever : 0
|
||||||
|
RawTransactionRetriever : 0
|
||||||
|
Backfill/backfill : 0
|
||||||
|
Checkpoint/checkpoint : 0
|
||||||
|
historical : 0
|
||||||
|
```
|
||||||
|
|
||||||
|
`Discovery`/`discovery` n'est plus un marqueur interdit global : `pre.006` l'emploie pour la découverte live run-local de slots/blocs par `getBlocksWithLimit`.
|
||||||
322
deltas/0.3.13/pre.006.md
Normal file
322
deltas/0.3.13/pre.006.md
Normal file
@@ -0,0 +1,322 @@
|
|||||||
|
<!-- file: deltas/0.3.13/pre.006.md -->
|
||||||
|
<!-- version: 1 -->
|
||||||
|
|
||||||
|
# Delta 0.3.13-pre.006 — HTTP live block polling run-local
|
||||||
|
|
||||||
|
## Base requise
|
||||||
|
|
||||||
|
```text
|
||||||
|
livraison précédente : 0.3.13-pre.005-fix.001
|
||||||
|
Cargo base : 0.3.13-pre.5.fix.1
|
||||||
|
delta base : deltas/0.3.13/pre.005-fix.001.md
|
||||||
|
archive delta base : ksp-general-0.3.13-pre.005-fix.001.zip
|
||||||
|
```
|
||||||
|
|
||||||
|
Le gate opérateur reçu le 10 septembre 2026 sur cette base est entièrement vert pour les commandes exécutées : `cargo fmt`, `cargo fmt --check`, audits Rust/Markdown, `cargo check --workspace`, Clippy strict et toutes les suites de `ksp-worker-raw-transaction-ingest-lib` (`84` unit, `4` cross-layer, `12` dependency-boundary, `19` hardening, `13` public-api, `4` release-completeness, `0` doc-test). Cette exécution ne contenait ni le test Transport ni les commandes `cargo tree`; ils ne sont donc pas déclarés PASS pour ce gate précis.
|
||||||
|
|
||||||
|
## Objectif
|
||||||
|
|
||||||
|
Ajouter la source HTTP live prévue par la tranche sans la transformer en Backfill :
|
||||||
|
|
||||||
|
```text
|
||||||
|
getSlot(commitment)
|
||||||
|
-> borne inférieure du run
|
||||||
|
getBlocksWithLimit(next_scan_slot, bounded_limit, commitment)
|
||||||
|
-> découverte des blocs disponibles
|
||||||
|
getBlock observed(slot, Full/Base64/maxV1/rewards=false)
|
||||||
|
-> Common RAW direct Legacy/V0/V1
|
||||||
|
-> admission centrale Worker
|
||||||
|
-> Store
|
||||||
|
```
|
||||||
|
|
||||||
|
Le polling ne remonte jamais avant la borne observée au démarrage et ne crée aucun checkpoint durable inter-run.
|
||||||
|
|
||||||
|
## Version
|
||||||
|
|
||||||
|
```text
|
||||||
|
livraison : 0.3.13-pre.006
|
||||||
|
workspace.package.version : 0.3.13-pre.6
|
||||||
|
archive : ksp-general-0.3.13-pre.006.zip
|
||||||
|
```
|
||||||
|
|
||||||
|
`Cargo.toml` passe également de la version de fichier `549` à `550`.
|
||||||
|
|
||||||
|
## Source HTTP Block Polling
|
||||||
|
|
||||||
|
Nouvelle surface publique Worker :
|
||||||
|
|
||||||
|
```text
|
||||||
|
RawTransactionIngestHttpBlockPollingSource
|
||||||
|
RawTransactionIngestRuntimeResources::from_http_block_polling_source
|
||||||
|
RawTransactionIngestRuntimeResources::try_push_http_block_polling_source
|
||||||
|
DEFAULT_RAW_TRANSACTION_INGEST_HTTP_POLL_INTERVAL
|
||||||
|
MIN_RAW_TRANSACTION_INGEST_HTTP_POLL_INTERVAL
|
||||||
|
MAX_RAW_TRANSACTION_INGEST_HTTP_POLL_INTERVAL
|
||||||
|
DEFAULT_RAW_TRANSACTION_INGEST_HTTP_POLL_MAX_BLOCKS_PER_CYCLE
|
||||||
|
MIN_RAW_TRANSACTION_INGEST_HTTP_POLL_MAX_BLOCKS_PER_CYCLE
|
||||||
|
MAX_RAW_TRANSACTION_INGEST_HTTP_POLL_MAX_BLOCKS_PER_CYCLE
|
||||||
|
```
|
||||||
|
|
||||||
|
La construction caller-owned reçoit un `HttpTransportPool`, un `HttpRoleName` et un commitment `Confirmed` ou `Finalized`. Elle est sans I/O et vérifie statiquement que le rôle possède des routes compatibles `getSlot`, `getBlocksWithLimit` et `getBlock` sur un même réseau.
|
||||||
|
|
||||||
|
Bornes publiques :
|
||||||
|
|
||||||
|
```text
|
||||||
|
poll interval : défaut 1 s ; min 100 ms ; max 30 s
|
||||||
|
max discovered blocks/cycle : défaut 128 ; min 1 ; max 1024
|
||||||
|
```
|
||||||
|
|
||||||
|
Les limitations physiques, la sélection d'endpoint, le rate-limit, les retries et le backoff HTTP restent possédés par `ksp-onchain-transport-lib`.
|
||||||
|
|
||||||
|
## Borne de run et progression
|
||||||
|
|
||||||
|
Au démarrage :
|
||||||
|
|
||||||
|
```text
|
||||||
|
start_slot = getSlot(commitment)
|
||||||
|
next_scan_slot = start_slot
|
||||||
|
```
|
||||||
|
|
||||||
|
Le Worker ne demande aucun slot inférieur à `start_slot`. Pour chaque cycle, il relit le tip courant, puis appelle `getBlocksWithLimit` depuis `next_scan_slot`. La réponse doit être strictement croissante et ne peut contenir aucun slot inférieur à la frontier de scan.
|
||||||
|
|
||||||
|
Chaque slot listé est matérialisé par `getBlock observed`. Si le résultat vaut `null` :
|
||||||
|
|
||||||
|
```text
|
||||||
|
next_scan_slot = slot
|
||||||
|
aucun settled
|
||||||
|
aucun Common RAW
|
||||||
|
reprise au cycle suivant
|
||||||
|
```
|
||||||
|
|
||||||
|
Le cas `null` n'est donc ni assimilé à un bloc vide ni converti en progression silencieuse.
|
||||||
|
|
||||||
|
Les slots non listés par `getBlocksWithLimit` sont traités comme non produits/skipped dans le run courant. Lorsque la liste reçue ne remplit pas le batch demandé et qu'aucun slot n'est bloqué par `null`, la frontier peut rejoindre le tip observé du cycle sans lancer de scan historique implicite.
|
||||||
|
|
||||||
|
## RAW-direct et version
|
||||||
|
|
||||||
|
Le poller demande exactement :
|
||||||
|
|
||||||
|
```text
|
||||||
|
encoding = Base64
|
||||||
|
transactionDetails = Full
|
||||||
|
maxSupportedTransactionVersion = 1
|
||||||
|
showRewards = false
|
||||||
|
commitment = Confirmed | Finalized
|
||||||
|
```
|
||||||
|
|
||||||
|
Chaque transaction qualifiée produit directement `RawTransactionMaterial` avec :
|
||||||
|
|
||||||
|
```text
|
||||||
|
signature embarquée dans le wire Base64
|
||||||
|
slot
|
||||||
|
blockTime
|
||||||
|
meta
|
||||||
|
version Legacy | 0 | 1
|
||||||
|
transactionIndex dérivé de la position dans le bloc
|
||||||
|
```
|
||||||
|
|
||||||
|
Les cas suivants sont fail-closed : transaction non Base64, transactions omises/nulles, version omise/nulle, version `>1`, signature invalide ou index non représentable en `u32`.
|
||||||
|
|
||||||
|
La voie HTTP Block Polling est RAW-direct et n'utilise pas le coordinateur d'hydration. Le slot n'est marqué `settled` qu'après l'envoi réussi de toutes les transactions du bloc vers l'admission centrale ; `hydration_pending` n'est jamais artificiellement incrémenté.
|
||||||
|
|
||||||
|
## Provenance observée
|
||||||
|
|
||||||
|
La provenance de chaque transaction reprend l'endpoint et le provider réellement gagnants de `getBlock observed` :
|
||||||
|
|
||||||
|
```text
|
||||||
|
origin = Live
|
||||||
|
protocol = solana_http
|
||||||
|
method = block_polling_get_block
|
||||||
|
endpoint = endpoint observé
|
||||||
|
provider = provider observé
|
||||||
|
commitment = source commitment
|
||||||
|
capture session = WorkerId
|
||||||
|
```
|
||||||
|
|
||||||
|
Aucun URL, header HTTP ou corps brut n'est exposé par `HttpObservedValue` ou les diagnostics Worker.
|
||||||
|
|
||||||
|
## Identité logique
|
||||||
|
|
||||||
|
Le `source_key` HTTP polling est dérivé de :
|
||||||
|
|
||||||
|
```text
|
||||||
|
domain KSP live-source v1
|
||||||
|
family = http_block_polling
|
||||||
|
network
|
||||||
|
polling role
|
||||||
|
commitment
|
||||||
|
private route-profile fingerprint
|
||||||
|
SHA-256 -> [u8; 32]
|
||||||
|
```
|
||||||
|
|
||||||
|
L'empreinte de profil est construite à partir des identités sûres cluster/provider/endpoint et des capacités pertinentes de chaque route active, après tri déterministe. La cadence et le batch de découverte n'entrent volontairement pas dans l'identité logique : modifier un réglage de timing ne crée pas une deuxième source conceptuelle.
|
||||||
|
|
||||||
|
Le bound global `1..32`, l'invariant réseau unique et le rejet transactionnel des doublons de `pre.002` s'appliquent à cette famille.
|
||||||
|
|
||||||
|
## Activation runtime
|
||||||
|
|
||||||
|
Le contrat reste volontairement mono-source avant `pre.007` :
|
||||||
|
|
||||||
|
```text
|
||||||
|
1 source Yellowstone : productif
|
||||||
|
1 source Standard Logs : productif
|
||||||
|
1 source Standard Block : productif
|
||||||
|
1 source Helius Transaction : productif
|
||||||
|
1 source HTTP Block Polling : productif
|
||||||
|
2..32 sources : composition validable
|
||||||
|
start 2..32 : runtime_resources.multi_source_activation_pending avant spawn
|
||||||
|
```
|
||||||
|
|
||||||
|
Aucune source configurée n'est ignorée silencieusement.
|
||||||
|
|
||||||
|
## Preuves ajoutées
|
||||||
|
|
||||||
|
Unit tests Worker :
|
||||||
|
|
||||||
|
```text
|
||||||
|
bornes cadence/batch et commitment
|
||||||
|
présence exacte des capacités HTTP requises
|
||||||
|
source_key stable malgré changement de timing et différent si route logique différente
|
||||||
|
redaction URL sensible dans Debug
|
||||||
|
validation stricte de la découverte croissante
|
||||||
|
qualification Legacy/V0/V1 et rejet version ambiguë/future
|
||||||
|
rejet transactionnel d'une identité HTTP polling dupliquée
|
||||||
|
```
|
||||||
|
|
||||||
|
Canaris externes :
|
||||||
|
|
||||||
|
```text
|
||||||
|
public_api : constructeurs/from/push et bornes publiques disponibles depuis crate root
|
||||||
|
dependency_boundary : Transport facade uniquement, aucun Config/Backfill/backend/direct HTTP client
|
||||||
|
hardening : run-local, timer borné, getBlock observed unique, aucun task par tick, aucun hydration_pending direct
|
||||||
|
release_completeness : exports et canaris pre.006 obligatoires
|
||||||
|
```
|
||||||
|
|
||||||
|
Les anciens canaris qui interdisaient globalement `get_block_observed` ou `tokio::time::sleep` sont resserrés sur le coordinateur d'hydration : ces primitives restent interdites dans l'hydration mais sont désormais légitimes, explicites et bornées dans la seule source HTTP polling.
|
||||||
|
|
||||||
|
## Documentation
|
||||||
|
|
||||||
|
`README.md`, le README du crate, `USAGE.md`, le plan et le journal de validation sont alignés sur la cinquième famille productive. `USAGE.md` reste version-neutral : il décrit la construction et le comportement sans journaliser le numéro de prerelease.
|
||||||
|
|
||||||
|
Une incohérence du README de crate, qui classait encore le live HTTP polling parmi les éléments hors périmètre, est corrigée dans cette tranche.
|
||||||
|
|
||||||
|
## Fichiers modifiés
|
||||||
|
|
||||||
|
```text
|
||||||
|
Cargo.toml
|
||||||
|
README.md
|
||||||
|
crates/ksp-worker-raw-transaction-ingest-lib/README.md
|
||||||
|
crates/ksp-worker-raw-transaction-ingest-lib/USAGE.md
|
||||||
|
crates/ksp-worker-raw-transaction-ingest-lib/src/lib.rs
|
||||||
|
crates/ksp-worker-raw-transaction-ingest-lib/src/runtime_resources.rs
|
||||||
|
crates/ksp-worker-raw-transaction-ingest-lib/tests/dependency_boundary.rs
|
||||||
|
crates/ksp-worker-raw-transaction-ingest-lib/tests/hardening.rs
|
||||||
|
crates/ksp-worker-raw-transaction-ingest-lib/tests/public_api.rs
|
||||||
|
crates/ksp-worker-raw-transaction-ingest-lib/tests/release_completeness.rs
|
||||||
|
crates/ksp-worker-raw-transaction-ingest-lib/unit_tests/runtime_resources.rs
|
||||||
|
docs/plans/034-V0_3_13_MULTI_SOURCE_LIVE_CONVERGENCE_PLAN.md
|
||||||
|
docs/validation/030-V0_3_13_MULTI_SOURCE_LIVE_CONVERGENCE.md
|
||||||
|
```
|
||||||
|
|
||||||
|
## Fichiers ajoutés
|
||||||
|
|
||||||
|
```text
|
||||||
|
deltas/0.3.13/pre.006.md
|
||||||
|
```
|
||||||
|
|
||||||
|
## Fichiers supprimés
|
||||||
|
|
||||||
|
```text
|
||||||
|
aucun
|
||||||
|
```
|
||||||
|
|
||||||
|
## Non-claims
|
||||||
|
|
||||||
|
`pre.006` ne prétend pas :
|
||||||
|
|
||||||
|
```text
|
||||||
|
supervision simultanée de plusieurs sources
|
||||||
|
checkpoint durable du polling
|
||||||
|
Backfill implicite
|
||||||
|
scan de slots antérieurs au start_slot du run
|
||||||
|
retry/backoff HTTP implémenté dans Worker
|
||||||
|
client reqwest direct dans Worker
|
||||||
|
Config lu dans Worker
|
||||||
|
getBlock=null assimilé à un bloc vide
|
||||||
|
transaction version >1 ou ambiguë acceptée
|
||||||
|
modification de ksp-onchain-transport-lib
|
||||||
|
nouvelle dépendance externe
|
||||||
|
```
|
||||||
|
|
||||||
|
## Validation dans l'environnement d'assemblage
|
||||||
|
|
||||||
|
Le toolchain Rust/Cargo/Rustfmt n'est pas disponible dans l'environnement d'assemblage. Les commandes Cargo post-`pre.006` restent donc `NON EXÉCUTÉ LOCAL`. Les audits statiques KSP, le scan normatif, le contrôle des versions de fichiers et le diff exhaustif sont exécutés avant packaging.
|
||||||
|
|
||||||
|
## Gate opérateur requis avant pre.007
|
||||||
|
|
||||||
|
```bash
|
||||||
|
cargo fmt --all
|
||||||
|
cargo fmt --all -- --check
|
||||||
|
python3 scripts/audit_rust_workspace_rules.py
|
||||||
|
python3 scripts/audit_markdown_tables.py README.md RULES.md ROADMAP.md CHANGELOG.md docs prompts crates deltas
|
||||||
|
cargo check --workspace
|
||||||
|
cargo clippy --workspace --all-targets --all-features -- -D warnings
|
||||||
|
cargo test -p ksp-onchain-transport-lib
|
||||||
|
cargo test -p ksp-worker-raw-transaction-ingest-lib
|
||||||
|
cargo tree -p ksp-worker-raw-transaction-ingest-lib --edges normal
|
||||||
|
cargo tree -p ksp-worker-raw-transaction-ingest-lib -e features
|
||||||
|
cargo tree --duplicates
|
||||||
|
```
|
||||||
|
|
||||||
|
`pre.007` ne doit pas commencer si ce gate révèle une anomalie.
|
||||||
|
|
||||||
|
## Résultats statiques finaux de l'assemblage
|
||||||
|
|
||||||
|
Les valeurs ci-dessous sont mises à jour après la dernière passe d'audits sur l'état exact livré.
|
||||||
|
|
||||||
|
```text
|
||||||
|
General Rust rule audit: clean
|
||||||
|
Rust export completeness audit: 0 candidate(s)
|
||||||
|
KSP workspace Rust rule audit: clean
|
||||||
|
Markdown table audit: clean (340 tables, 839 files)
|
||||||
|
Normative rule definitions: 489
|
||||||
|
Unique normative IDs: 489
|
||||||
|
Duplicates: 0
|
||||||
|
```
|
||||||
|
|
||||||
|
## Contrôle exhaustif avant packaging
|
||||||
|
|
||||||
|
Comparaison avec la base `0.3.13-pre.005-fix.001` :
|
||||||
|
|
||||||
|
```text
|
||||||
|
added : 1
|
||||||
|
deltas/0.3.13/pre.006.md
|
||||||
|
modified : 13
|
||||||
|
Cargo.toml
|
||||||
|
README.md
|
||||||
|
crates/ksp-worker-raw-transaction-ingest-lib/README.md
|
||||||
|
crates/ksp-worker-raw-transaction-ingest-lib/USAGE.md
|
||||||
|
crates/ksp-worker-raw-transaction-ingest-lib/src/lib.rs
|
||||||
|
crates/ksp-worker-raw-transaction-ingest-lib/src/runtime_resources.rs
|
||||||
|
crates/ksp-worker-raw-transaction-ingest-lib/tests/dependency_boundary.rs
|
||||||
|
crates/ksp-worker-raw-transaction-ingest-lib/tests/hardening.rs
|
||||||
|
crates/ksp-worker-raw-transaction-ingest-lib/tests/public_api.rs
|
||||||
|
crates/ksp-worker-raw-transaction-ingest-lib/tests/release_completeness.rs
|
||||||
|
crates/ksp-worker-raw-transaction-ingest-lib/unit_tests/runtime_resources.rs
|
||||||
|
docs/plans/034-V0_3_13_MULTI_SOURCE_LIVE_CONVERGENCE_PLAN.md
|
||||||
|
docs/validation/030-V0_3_13_MULTI_SOURCE_LIVE_CONVERGENCE.md
|
||||||
|
deleted : 0
|
||||||
|
```
|
||||||
|
|
||||||
|
Les `13/13` fichiers existants modifiés portent une version de fichier exactement `+1`. Le diff de `Cargo.toml` est limité au header `549 -> 550` et à `workspace.package.version = "0.3.13-pre.6"`; aucun membre workspace ni aucune dépendance n'est modifié.
|
||||||
|
|
||||||
|
La revue statique ciblée confirme dans le code Worker :
|
||||||
|
|
||||||
|
```text
|
||||||
|
get_block_observed( : 1 occurrence, source HTTP polling uniquement
|
||||||
|
get_blocks_with_limit( : 1 occurrence, source HTTP polling uniquement
|
||||||
|
tokio::time::sleep : 1 occurrence, cadence du poller uniquement
|
||||||
|
aucun reqwest/tokio-tungstenite/tonic/yellowstone-grpc-proto direct
|
||||||
|
aucun ksp-config-lib/ksp-job-backfill-lib/ksp-store-postgres-lib direct
|
||||||
|
aucun unbounded_channel
|
||||||
|
```
|
||||||
218
deltas/0.3.13/pre.007.md
Normal file
218
deltas/0.3.13/pre.007.md
Normal file
@@ -0,0 +1,218 @@
|
|||||||
|
<!-- file: deltas/0.3.13/pre.007.md -->
|
||||||
|
<!-- version: 1 -->
|
||||||
|
|
||||||
|
# Delta 0.3.13-pre.007 — supervision et inventaire multi-source
|
||||||
|
|
||||||
|
## Base requise
|
||||||
|
|
||||||
|
```text
|
||||||
|
livraison précédente : 0.3.13-pre.006-fix.001
|
||||||
|
Cargo base : 0.3.13-pre.6.fix.1
|
||||||
|
delta base : deltas/0.3.13/pre.006-fix.001.md
|
||||||
|
archive delta base : ksp-general-0.3.13-pre.006-fix.001.zip
|
||||||
|
```
|
||||||
|
|
||||||
|
Le gate opérateur communiqué le 10 septembre 2026 est vert sur toutes les commandes exécutées : `cargo fmt`, `cargo fmt --check`, audits Rust/Markdown, `cargo check --workspace`, Clippy strict et toutes les suites de `ksp-worker-raw-transaction-ingest-lib` (`88` unit, `4` cross-layer, `13` dependency-boundary, `20` hardening, `14` public-api, `4` release-completeness, `0` doc-test). Le log reçu ne contient pas les sorties séparées `cargo test -p ksp-onchain-transport-lib` ni les trois commandes `cargo tree`; elles ne sont donc pas déclarées PASS dans ce delta.
|
||||||
|
|
||||||
|
## Objectif
|
||||||
|
|
||||||
|
Activer réellement la collection `1..32` déjà composable depuis `pre.002` :
|
||||||
|
|
||||||
|
```text
|
||||||
|
RawTransactionIngestRuntimeResources
|
||||||
|
-> validation complète réseau / doublons / borne
|
||||||
|
-> spawn de toutes les sources configurées
|
||||||
|
-> inventaire privé source_key -> latest state/frontier
|
||||||
|
-> projection frontier source-neutral agrégée
|
||||||
|
-> terminalité conservatrice si une source disparaît ou échoue
|
||||||
|
```
|
||||||
|
|
||||||
|
Aucun provider n'est traité comme primaire, fallback ou standby.
|
||||||
|
|
||||||
|
## Version
|
||||||
|
|
||||||
|
```text
|
||||||
|
livraison : 0.3.13-pre.007
|
||||||
|
workspace.package.version : 0.3.13-pre.7
|
||||||
|
archive : ksp-general-0.3.13-pre.007.zip
|
||||||
|
```
|
||||||
|
|
||||||
|
`Cargo.toml` passe de la version de fichier `551` à `552`.
|
||||||
|
|
||||||
|
## Supervisor multi-source
|
||||||
|
|
||||||
|
`RawTransactionIngestWorker::start_with_runtime_resources` ne vérifie plus `validate_single_source_activation`. Après validation du réseau, le runtime délègue à `RawTransactionIngestRuntimeResources::run_live_sources`.
|
||||||
|
|
||||||
|
Le supervisor privé :
|
||||||
|
|
||||||
|
```text
|
||||||
|
crée un stop channel source-owned
|
||||||
|
crée un JoinSet borné par la collection 1..32
|
||||||
|
spawn chaque source configurée exactement une fois
|
||||||
|
clone uniquement les handles nécessaires
|
||||||
|
rejoint toutes les tasks avant de rendre son résultat
|
||||||
|
```
|
||||||
|
|
||||||
|
La vieille erreur `runtime_resources.multi_source_activation_pending` disparaît du code production.
|
||||||
|
|
||||||
|
## Terminalité conservatrice
|
||||||
|
|
||||||
|
La politique reste fail-closed :
|
||||||
|
|
||||||
|
```text
|
||||||
|
stop Worker
|
||||||
|
-> fanout stop vers toutes les sources
|
||||||
|
-> join complet
|
||||||
|
-> Ok seulement si les sources ferment sans erreur
|
||||||
|
|
||||||
|
source Err
|
||||||
|
-> stop immédiat des autres sources
|
||||||
|
-> join complet
|
||||||
|
-> faute source terminale
|
||||||
|
|
||||||
|
source Ok avant stop Worker
|
||||||
|
-> fermeture inattendue d'une source configurée
|
||||||
|
-> stop des autres sources
|
||||||
|
-> faute terminale
|
||||||
|
|
||||||
|
JoinError
|
||||||
|
-> faute terminale sûre
|
||||||
|
```
|
||||||
|
|
||||||
|
Le Worker ne suppose pas qu'une autre source couvre les mêmes filtres, le même provider universe ou la même complétude.
|
||||||
|
|
||||||
|
## Inventaire privé et processing frontier
|
||||||
|
|
||||||
|
`RawTransactionIngestSourceInventory` et `RawTransactionIngestSourceInventoryPublisher` restent privés au module runtime resources. L'inventaire est initialisé depuis les `source_key` déjà validées et possède exactement une entrée latest-value par source du run.
|
||||||
|
|
||||||
|
Chaque source conserve son propre publisher local. Un wrapper privé reporte ses projections dans l'inventaire puis publie une projection globale conservative :
|
||||||
|
|
||||||
|
```text
|
||||||
|
hydration_pending : somme saturante temporaire des sources
|
||||||
|
oldest_pending_slot : minimum global
|
||||||
|
processing_frontier_slot : None si une source n'a pas encore de frontier
|
||||||
|
sinon minimum de toutes les frontiers
|
||||||
|
source_state : Failed > Reconnecting > Closing > Active > Closed/None
|
||||||
|
reconnect/replay/gap : agrégation saturante, jamais wrap arithmétique
|
||||||
|
```
|
||||||
|
|
||||||
|
Le choix du minimum n'est pas une preuve de coverage blockchain. La frontier reste run-local et source-neutral.
|
||||||
|
|
||||||
|
## Propriété d'ownership
|
||||||
|
|
||||||
|
Les sources physiques continuent d'appartenir à leurs façades Transport existantes. Le Worker ne crée ni client reqwest, ni socket alternatif, ni SDK provider. Le supervisor ajoute uniquement l'ownership des tasks source et de leur lifecycle commun.
|
||||||
|
|
||||||
|
Une source qui termine avant le stop est explicitement marquée `Closed` ou `Failed` dans l'inventaire avant le résultat du supervisor. Les identités `source_key` restent privées et ne sont jamais projetées dans `RawTransactionIngestSnapshot` ou le crate root.
|
||||||
|
|
||||||
|
## Preuves ajoutées
|
||||||
|
|
||||||
|
Unit tests déterministes :
|
||||||
|
|
||||||
|
```text
|
||||||
|
inventaire 2 sources : pending/frontier/state/counters agrégés conservativement
|
||||||
|
stop supervisor : trois tasks source actives reçoivent le stop et sont toutes jointes
|
||||||
|
source failure : la source sœur reçoit le stop et est jointe avant retour de faute
|
||||||
|
```
|
||||||
|
|
||||||
|
Canaris externes :
|
||||||
|
|
||||||
|
```text
|
||||||
|
dependency_boundary : run_live_sources, JoinSet, inventaire privé, vieille barrière absente
|
||||||
|
hardening : stop/fault/join fail-closed, aucune policy primary/standby, aucun canal unbounded
|
||||||
|
public_api : inventaire/live-source/source_key non exportés
|
||||||
|
```
|
||||||
|
|
||||||
|
Les canaris historiques `0.3.12` qui cherchaient `run_single_live_source` sont mis à jour vers le supervisor multi-source au lieu d'être supprimés.
|
||||||
|
|
||||||
|
## Frontière de tranche
|
||||||
|
|
||||||
|
`pre.007` active la simultanéité, mais ne ferme pas encore la convergence transactionnelle cross-source :
|
||||||
|
|
||||||
|
```text
|
||||||
|
pas de coalescence globale de la même signature entre plusieurs sources
|
||||||
|
pas d'unique hydration cross-source garantie
|
||||||
|
pas de fusion de plusieurs provenance/observation seeds vers une acquisition canonique unique
|
||||||
|
pas encore de record_raw_transaction_observation pour les observations supplémentaires convergées
|
||||||
|
pas encore de fairness durcie duplicate-storm
|
||||||
|
pas encore de source_total/source_active/source_failed publics
|
||||||
|
```
|
||||||
|
|
||||||
|
Les coordinators d'hydration des sources reference-bearing restent donc source-local pendant cette tranche. La fermeture de la coalescence globale et des observations multiples appartient à `pre.008`, puis les bornes/fairness renforcées à `pre.009`.
|
||||||
|
|
||||||
|
## Documentation
|
||||||
|
|
||||||
|
Le README du crate décrit désormais le supervisor 1..32, la terminalité conservative et la frontier agrégée. `USAGE.md` reste version-neutral et montre comment composer plusieurs sources via les `try_push_*` existants sans mentionner le numéro de prerelease.
|
||||||
|
|
||||||
|
Le plan et la validation consignent le gate opérateur réellement reçu et distinguent explicitement ce qui reste reporté à `pre.008+`.
|
||||||
|
|
||||||
|
## Fichiers modifiés
|
||||||
|
|
||||||
|
```text
|
||||||
|
Cargo.toml
|
||||||
|
crates/ksp-worker-raw-transaction-ingest-lib/README.md
|
||||||
|
crates/ksp-worker-raw-transaction-ingest-lib/USAGE.md
|
||||||
|
crates/ksp-worker-raw-transaction-ingest-lib/src/runtime.rs
|
||||||
|
crates/ksp-worker-raw-transaction-ingest-lib/src/runtime_resources.rs
|
||||||
|
crates/ksp-worker-raw-transaction-ingest-lib/tests/dependency_boundary.rs
|
||||||
|
crates/ksp-worker-raw-transaction-ingest-lib/tests/hardening.rs
|
||||||
|
crates/ksp-worker-raw-transaction-ingest-lib/tests/public_api.rs
|
||||||
|
crates/ksp-worker-raw-transaction-ingest-lib/tests/release_completeness.rs
|
||||||
|
crates/ksp-worker-raw-transaction-ingest-lib/unit_tests/runtime_resources.rs
|
||||||
|
docs/plans/034-V0_3_13_MULTI_SOURCE_LIVE_CONVERGENCE_PLAN.md
|
||||||
|
docs/validation/030-V0_3_13_MULTI_SOURCE_LIVE_CONVERGENCE.md
|
||||||
|
```
|
||||||
|
|
||||||
|
## Fichiers ajoutés
|
||||||
|
|
||||||
|
```text
|
||||||
|
deltas/0.3.13/pre.007.md
|
||||||
|
```
|
||||||
|
|
||||||
|
## Fichiers supprimés
|
||||||
|
|
||||||
|
```text
|
||||||
|
aucun
|
||||||
|
```
|
||||||
|
|
||||||
|
## Validation dans l'environnement d'assemblage
|
||||||
|
|
||||||
|
Le toolchain Rust/Cargo/Rustfmt n'est pas disponible dans l'environnement d'assemblage. Les commandes Cargo post-`pre.007` restent donc `NON EXÉCUTÉ LOCAL`. Les audits statiques KSP, le scan normatif, les versions de fichiers et le diff exhaustif sont exécutés sur l'état exact avant packaging.
|
||||||
|
|
||||||
|
## Résultats statiques finaux de l'assemblage
|
||||||
|
|
||||||
|
```text
|
||||||
|
General Rust rule audit: clean
|
||||||
|
Rust export completeness audit: 0 candidate(s)
|
||||||
|
KSP workspace Rust rule audit: clean
|
||||||
|
Markdown table audit: clean (340 tables, 841 files)
|
||||||
|
Normative rule definitions: 489
|
||||||
|
Unique normative IDs: 489
|
||||||
|
Duplicates: 0
|
||||||
|
```
|
||||||
|
|
||||||
|
Contrôle ciblé du supervisor :
|
||||||
|
|
||||||
|
```text
|
||||||
|
ancienne barrière validate_single_source_activation : absente
|
||||||
|
runtime_resources.multi_source_activation_pending : absent du code production
|
||||||
|
inventaire source public : absent
|
||||||
|
source_key public : absent
|
||||||
|
unbounded_channel : absent
|
||||||
|
nouvelle dépendance : aucune
|
||||||
|
```
|
||||||
|
|
||||||
|
## Gate opérateur requis avant pre.008
|
||||||
|
|
||||||
|
```bash
|
||||||
|
cargo fmt --all
|
||||||
|
cargo fmt --all -- --check
|
||||||
|
python3 scripts/audit_rust_workspace_rules.py
|
||||||
|
python3 scripts/audit_markdown_tables.py README.md RULES.md ROADMAP.md CHANGELOG.md docs prompts crates deltas
|
||||||
|
cargo check --workspace
|
||||||
|
cargo clippy --workspace --all-targets --all-features -- -D warnings
|
||||||
|
cargo test -p ksp-onchain-transport-lib
|
||||||
|
cargo test -p ksp-worker-raw-transaction-ingest-lib
|
||||||
|
cargo tree -p ksp-worker-raw-transaction-ingest-lib --edges normal
|
||||||
|
cargo tree -p ksp-worker-raw-transaction-ingest-lib -e features
|
||||||
|
cargo tree --duplicates
|
||||||
|
```
|
||||||
85
deltas/0.3.13/pre.008-fix.001.md
Normal file
85
deltas/0.3.13/pre.008-fix.001.md
Normal file
@@ -0,0 +1,85 @@
|
|||||||
|
<!-- file: deltas/0.3.13/pre.008-fix.001.md -->
|
||||||
|
<!-- version: 1 -->
|
||||||
|
|
||||||
|
# Delta 0.3.13-pre.008-fix.001 — correction compilation convergence persistence
|
||||||
|
|
||||||
|
## Base requise
|
||||||
|
|
||||||
|
```text
|
||||||
|
livraison précédente : 0.3.13-pre.008
|
||||||
|
Cargo base : 0.3.13-pre.8
|
||||||
|
delta base : deltas/0.3.13/pre.008.md
|
||||||
|
archive delta base : ksp-general-0.3.13-pre.008.zip
|
||||||
|
```
|
||||||
|
|
||||||
|
Le gate opérateur du 10 septembre 2026 sur `pre.008` est vert pour `cargo fmt`, `cargo fmt --check` et les audits Rust/Markdown. `cargo check --workspace` met ensuite en évidence deux défauts de compilation dans `ksp-worker-raw-transaction-ingest-lib` :
|
||||||
|
|
||||||
|
```text
|
||||||
|
unused import : pub(crate) use self::persistence::persist_raw_transaction_ingest_acquisition
|
||||||
|
E0004 : match non exhaustif sur RawObservationWriteOutcome #[non_exhaustive]
|
||||||
|
```
|
||||||
|
|
||||||
|
Clippy strict reproduit les deux défauts et les tests ne peuvent pas être compilés avant leur correction.
|
||||||
|
|
||||||
|
## Objectif du fix
|
||||||
|
|
||||||
|
Corriger strictement ces deux défauts sans modifier le contrat de convergence `pre.008` :
|
||||||
|
|
||||||
|
```text
|
||||||
|
re-export crate-root : conservé conformément aux règles KSP
|
||||||
|
appels internes : via crate::persist_raw_transaction_ingest_acquisition(...)
|
||||||
|
non-exhaustive enum : wildcard fail-closed vers une erreur runtime stable
|
||||||
|
```
|
||||||
|
|
||||||
|
Le wildcard ne transforme aucune variante future en succès implicite. Toute variante `RawObservationWriteOutcome` inconnue est rejetée comme `persistence.additional_observation_outcome_invalid`.
|
||||||
|
|
||||||
|
## Version
|
||||||
|
|
||||||
|
```text
|
||||||
|
livraison : 0.3.13-pre.008-fix.001
|
||||||
|
workspace.package.version : 0.3.13-pre.8.fix.1
|
||||||
|
archive : ksp-general-0.3.13-pre.008-fix.001.zip
|
||||||
|
```
|
||||||
|
|
||||||
|
`Cargo.toml` passe de la version de fichier `553` à `554`.
|
||||||
|
|
||||||
|
## Fichiers modifiés
|
||||||
|
|
||||||
|
```text
|
||||||
|
Cargo.toml
|
||||||
|
crates/ksp-worker-raw-transaction-ingest-lib/src/persistence.rs
|
||||||
|
```
|
||||||
|
|
||||||
|
`persistence.rs` passe de la version de fichier `2` à `3`.
|
||||||
|
|
||||||
|
## Fichiers ajoutés
|
||||||
|
|
||||||
|
```text
|
||||||
|
deltas/0.3.13/pre.008-fix.001.md
|
||||||
|
```
|
||||||
|
|
||||||
|
## Fichiers supprimés
|
||||||
|
|
||||||
|
```text
|
||||||
|
aucun
|
||||||
|
```
|
||||||
|
|
||||||
|
## Non-claims
|
||||||
|
|
||||||
|
Ce fix ne modifie aucune dépendance, aucune API publique, aucun cache de convergence, aucune clé de coalescence, aucune sémantique d'hydration, aucune observation/provenance et aucune règle Store de première acquisition ou d'observation supplémentaire.
|
||||||
|
|
||||||
|
## Validation dans l'environnement d'assemblage
|
||||||
|
|
||||||
|
Le toolchain Rust/Cargo/Rustfmt n'est pas disponible dans l'environnement d'assemblage. Les commandes Cargo post-fix restent donc `NON EXÉCUTÉ LOCAL`. Les audits statiques KSP et le contrôle exhaustif du delta sont exécutés avant packaging.
|
||||||
|
|
||||||
|
## Gate opérateur requis avant pre.009
|
||||||
|
|
||||||
|
```bash
|
||||||
|
cargo fmt --all
|
||||||
|
cargo fmt --all -- --check
|
||||||
|
python3 scripts/audit_rust_workspace_rules.py
|
||||||
|
python3 scripts/audit_markdown_tables.py README.md RULES.md ROADMAP.md CHANGELOG.md docs prompts crates deltas
|
||||||
|
cargo check --workspace
|
||||||
|
cargo clippy --workspace --all-targets --all-features -- -D warnings
|
||||||
|
cargo test -p ksp-worker-raw-transaction-ingest-lib
|
||||||
|
```
|
||||||
89
deltas/0.3.13/pre.008-fix.002.md
Normal file
89
deltas/0.3.13/pre.008-fix.002.md
Normal file
@@ -0,0 +1,89 @@
|
|||||||
|
<!-- file: deltas/0.3.13/pre.008-fix.002.md -->
|
||||||
|
<!-- version: 1 -->
|
||||||
|
|
||||||
|
# Delta 0.3.13-pre.008-fix.002 — correction visibilité hydration globale et constructeur de test
|
||||||
|
|
||||||
|
## Base requise
|
||||||
|
|
||||||
|
```text
|
||||||
|
livraison précédente : 0.3.13-pre.008-fix.001
|
||||||
|
Cargo base : 0.3.13-pre.8.fix.1
|
||||||
|
delta base : deltas/0.3.13/pre.008-fix.001.md
|
||||||
|
archive delta base : ksp-general-0.3.13-pre.008-fix.001.zip
|
||||||
|
```
|
||||||
|
|
||||||
|
Le gate opérateur du 10 septembre 2026 confirme que `cargo fmt`, `cargo fmt --check`, les audits Rust/Markdown et `cargo check --workspace` passent. `cargo check` signale toutefois quatre warnings dans le Worker, puis Clippy strict les transforme en erreurs :
|
||||||
|
|
||||||
|
```text
|
||||||
|
3 x private_interfaces : trois méthodes pub(crate) run exposent RawTransactionIngestGlobalHydrationRegistry, qui reste privée au module
|
||||||
|
1 x dead_code : RawTransactionIngestHydrationCoordinator::new n'est plus utilisé en production depuis la registry globale pre.008
|
||||||
|
```
|
||||||
|
|
||||||
|
Malgré l'échec Clippy, `cargo test -p ksp-worker-raw-transaction-ingest-lib` compile et passe ensuite : `94/94` tests unitaires et toutes les suites d'intégration affichées sont vertes.
|
||||||
|
|
||||||
|
## Objectif du fix
|
||||||
|
|
||||||
|
Corriger strictement ces quatre diagnostics sans élargir l'API interne et sans modifier le contrat de convergence :
|
||||||
|
|
||||||
|
```text
|
||||||
|
YellowstoneSource::run : pub(crate) -> privé au module
|
||||||
|
HeliusTransactionSource::run : pub(crate) -> privé au module
|
||||||
|
StandardLogsSource::run : pub(crate) -> privé au module
|
||||||
|
HydrationCoordinator::new : compilé uniquement sous #[cfg(test)]
|
||||||
|
GlobalHydrationRegistry : reste privée au module
|
||||||
|
```
|
||||||
|
|
||||||
|
Les trois méthodes `run` concernées ne sont appelées que par `RawTransactionIngestLiveSource::run` dans le même module. La registry globale ne doit donc pas être rendue `pub(crate)` uniquement pour satisfaire la visibilité d'une signature.
|
||||||
|
|
||||||
|
Le constructeur `RawTransactionIngestHydrationCoordinator::new` reste disponible pour les tests unitaires historiques mais n'entre plus dans le binaire production ; le runtime `pre.008` utilise `with_global_registry` avec la registry partagée du supervisor.
|
||||||
|
|
||||||
|
## Version
|
||||||
|
|
||||||
|
```text
|
||||||
|
livraison : 0.3.13-pre.008-fix.002
|
||||||
|
workspace.package.version : 0.3.13-pre.8.fix.2
|
||||||
|
archive : ksp-general-0.3.13-pre.008-fix.002.zip
|
||||||
|
```
|
||||||
|
|
||||||
|
`Cargo.toml` passe de la version de fichier `554` à `555`.
|
||||||
|
|
||||||
|
## Fichiers modifiés
|
||||||
|
|
||||||
|
```text
|
||||||
|
Cargo.toml
|
||||||
|
crates/ksp-worker-raw-transaction-ingest-lib/src/runtime_resources.rs
|
||||||
|
```
|
||||||
|
|
||||||
|
`runtime_resources.rs` passe de la version de fichier `22` à `23`.
|
||||||
|
|
||||||
|
## Fichiers ajoutés
|
||||||
|
|
||||||
|
```text
|
||||||
|
deltas/0.3.13/pre.008-fix.002.md
|
||||||
|
```
|
||||||
|
|
||||||
|
## Fichiers supprimés
|
||||||
|
|
||||||
|
```text
|
||||||
|
aucun
|
||||||
|
```
|
||||||
|
|
||||||
|
## Non-claims
|
||||||
|
|
||||||
|
Ce fix ne modifie aucune dépendance, aucune API publique, aucune clé de convergence, aucune borne de registry/cache, aucune sémantique d'hydration, aucune observation/provenance, aucun comportement Store et aucune politique multi-source.
|
||||||
|
|
||||||
|
## Validation dans l'environnement d'assemblage
|
||||||
|
|
||||||
|
Le toolchain Rust/Cargo/Rustfmt n'est pas disponible dans l'environnement d'assemblage. Les commandes Cargo post-fix restent donc `NON EXÉCUTÉ LOCAL`. Les audits statiques KSP et le contrôle exhaustif du delta sont exécutés avant packaging.
|
||||||
|
|
||||||
|
## Gate opérateur requis avant pre.009
|
||||||
|
|
||||||
|
```bash
|
||||||
|
cargo fmt --all
|
||||||
|
cargo fmt --all -- --check
|
||||||
|
python3 scripts/audit_rust_workspace_rules.py
|
||||||
|
python3 scripts/audit_markdown_tables.py README.md RULES.md ROADMAP.md CHANGELOG.md docs prompts crates deltas
|
||||||
|
cargo check --workspace
|
||||||
|
cargo clippy --workspace --all-targets --all-features -- -D warnings
|
||||||
|
cargo test -p ksp-worker-raw-transaction-ingest-lib
|
||||||
|
```
|
||||||
198
deltas/0.3.13/pre.008.md
Normal file
198
deltas/0.3.13/pre.008.md
Normal file
@@ -0,0 +1,198 @@
|
|||||||
|
<!-- file: deltas/0.3.13/pre.008.md -->
|
||||||
|
<!-- version: 1 -->
|
||||||
|
|
||||||
|
# Delta 0.3.13-pre.008 — convergence cross-source et observations multiples
|
||||||
|
|
||||||
|
## Base requise
|
||||||
|
|
||||||
|
```text
|
||||||
|
livraison précédente : 0.3.13-pre.007
|
||||||
|
Cargo base : 0.3.13-pre.7
|
||||||
|
delta base : deltas/0.3.13/pre.007.md
|
||||||
|
archive delta base : ksp-general-0.3.13-pre.007.zip
|
||||||
|
```
|
||||||
|
|
||||||
|
Le gate opérateur communiqué le 10 septembre 2026 est vert pour toutes les commandes exécutées : `cargo fmt`, `cargo fmt --check`, audits Rust/Markdown, `cargo check --workspace`, Clippy strict et toutes les suites `ksp-worker-raw-transaction-ingest-lib` (`90` unit, `4` cross-layer, `14` dependency-boundary, `21` hardening, `15` public-api, `4` release-completeness, `0` doc-test). Le log reçu ne contient pas les sorties séparées `cargo test -p ksp-onchain-transport-lib` ni les trois commandes `cargo tree`; elles ne sont donc pas déclarées PASS ici.
|
||||||
|
|
||||||
|
## Objectif
|
||||||
|
|
||||||
|
Fermer la convergence des sources live simultanées sans dupliquer l'identité `RawTransaction` :
|
||||||
|
|
||||||
|
```text
|
||||||
|
plusieurs sources reference-bearing
|
||||||
|
-> une hydration globale par (network, signature, commitment)
|
||||||
|
-> acquisitions source-distinctes
|
||||||
|
-> canonicalisation RAW commune
|
||||||
|
-> convergence par (network, signature) + content hash
|
||||||
|
-> une entity RAW
|
||||||
|
-> plusieurs observations déterministes
|
||||||
|
```
|
||||||
|
|
||||||
|
## Version
|
||||||
|
|
||||||
|
```text
|
||||||
|
livraison : 0.3.13-pre.008
|
||||||
|
workspace.package.version : 0.3.13-pre.8
|
||||||
|
archive : ksp-general-0.3.13-pre.008.zip
|
||||||
|
```
|
||||||
|
|
||||||
|
`Cargo.toml` passe de la version de fichier `552` à `553`.
|
||||||
|
|
||||||
|
## Hydration globale cross-source
|
||||||
|
|
||||||
|
`RawTransactionIngestRuntimeResources::run_live_sources` crée un `RawTransactionIngestGlobalHydrationRegistry` privé partagé par Yellowstone, Standard Logs et Helius Transaction. Standard Block et HTTP Block Polling restent RAW-direct et n'entrent pas dans ce registre.
|
||||||
|
|
||||||
|
La clé reste exactement :
|
||||||
|
|
||||||
|
```text
|
||||||
|
(network, signature, commitment)
|
||||||
|
```
|
||||||
|
|
||||||
|
Le premier demandeur devient leader et exécute le `getTransaction observed` existant. Les suivants s'abonnent au même résultat via un `watch` privé. La registry est bornée par `admission_queue_capacity`, publie soit le résultat observed soit un `ErrorCode` sûr, puis retire la clé.
|
||||||
|
|
||||||
|
Les signaux source restent distincts : le même résultat d'hydration est finalisé séparément avec le contexte/provenance de chaque signal.
|
||||||
|
|
||||||
|
## Convergence persistence
|
||||||
|
|
||||||
|
Le runtime possède un `RawTransactionIngestPersistenceConvergence` privé et run-local. Sa capacité productive est :
|
||||||
|
|
||||||
|
```text
|
||||||
|
max(admission_queue_capacity, persistence_concurrency)
|
||||||
|
```
|
||||||
|
|
||||||
|
Chaque identité `(network, signature)` possède un verrou async local et mémorise le `RawContentHash` canonique après une première persistence réussie non purgée.
|
||||||
|
|
||||||
|
```text
|
||||||
|
première acquisition
|
||||||
|
-> persist_raw_transaction_acquisition
|
||||||
|
-> Store atomique entity + observation
|
||||||
|
|
||||||
|
même identity + même content hash
|
||||||
|
-> record_raw_transaction_observation uniquement
|
||||||
|
|
||||||
|
même identity + hash divergent
|
||||||
|
-> content conflict terminal
|
||||||
|
```
|
||||||
|
|
||||||
|
Le cache évince uniquement une entrée inactive lorsqu'il atteint sa borne. Le runtime dimensionne cette borne pour couvrir toutes les tâches persistence simultanées valides.
|
||||||
|
|
||||||
|
## Observations multiples
|
||||||
|
|
||||||
|
L'`observation_key` reste dérivée de la référence canonique et du `source_key` privé. Deux sources distinctes observant le même RAW produisent donc une seule référence/entity mais des observations déterministes distinctes.
|
||||||
|
|
||||||
|
Un replay de la même observation retourne `AlreadyPresent` sans réécriture de l'entité. Une observation supplémentaire `NotRecorded` est incohérente pour une entité déjà durable et devient une faute runtime sûre.
|
||||||
|
|
||||||
|
## Preuves ajoutées
|
||||||
|
|
||||||
|
Tests unitaires déterministes :
|
||||||
|
|
||||||
|
```text
|
||||||
|
deux source_key -> même référence/hash canonique, observation_key distinctes
|
||||||
|
registry globale -> un leader, un follower, publication partagée puis retrait
|
||||||
|
première identity -> une persistence atomique
|
||||||
|
seconde observation distincte -> record_observation seul
|
||||||
|
replay même observation -> AlreadyPresent sans nouvelle persistence entity
|
||||||
|
```
|
||||||
|
|
||||||
|
Canaris externes :
|
||||||
|
|
||||||
|
```text
|
||||||
|
dependency_boundary : Store/Transport facades uniquement, pas de backend/client direct
|
||||||
|
hardening : caches bornés, hash conflict-checked, convergence privée, aucun canal unbounded
|
||||||
|
public_api : registry/cache/hydration key/source_key non exposés
|
||||||
|
release_completeness : présence obligatoire des trois canaris pre.008
|
||||||
|
```
|
||||||
|
|
||||||
|
## Frontière de tranche
|
||||||
|
|
||||||
|
`pre.008` ne ferme pas encore :
|
||||||
|
|
||||||
|
```text
|
||||||
|
fairness adversariale sous duplicate storm prolongé
|
||||||
|
starvation entre sources
|
||||||
|
matrice complète de disagreement provider/source
|
||||||
|
stress des bornes globales
|
||||||
|
nouveaux compteurs/health publics multi-source
|
||||||
|
```
|
||||||
|
|
||||||
|
Ces points restent `pre.009` et `pre.010` selon le plan.
|
||||||
|
|
||||||
|
## Fichiers modifiés
|
||||||
|
|
||||||
|
```text
|
||||||
|
Cargo.toml
|
||||||
|
crates/ksp-worker-raw-transaction-ingest-lib/README.md
|
||||||
|
crates/ksp-worker-raw-transaction-ingest-lib/USAGE.md
|
||||||
|
crates/ksp-worker-raw-transaction-ingest-lib/src/lib.rs
|
||||||
|
crates/ksp-worker-raw-transaction-ingest-lib/src/persistence.rs
|
||||||
|
crates/ksp-worker-raw-transaction-ingest-lib/src/runtime.rs
|
||||||
|
crates/ksp-worker-raw-transaction-ingest-lib/src/runtime_resources.rs
|
||||||
|
crates/ksp-worker-raw-transaction-ingest-lib/tests/dependency_boundary.rs
|
||||||
|
crates/ksp-worker-raw-transaction-ingest-lib/tests/hardening.rs
|
||||||
|
crates/ksp-worker-raw-transaction-ingest-lib/tests/public_api.rs
|
||||||
|
crates/ksp-worker-raw-transaction-ingest-lib/tests/release_completeness.rs
|
||||||
|
crates/ksp-worker-raw-transaction-ingest-lib/unit_tests/admission.rs
|
||||||
|
crates/ksp-worker-raw-transaction-ingest-lib/unit_tests/persistence.rs
|
||||||
|
crates/ksp-worker-raw-transaction-ingest-lib/unit_tests/runtime.rs
|
||||||
|
crates/ksp-worker-raw-transaction-ingest-lib/unit_tests/runtime_resources.rs
|
||||||
|
docs/plans/034-V0_3_13_MULTI_SOURCE_LIVE_CONVERGENCE_PLAN.md
|
||||||
|
docs/validation/030-V0_3_13_MULTI_SOURCE_LIVE_CONVERGENCE.md
|
||||||
|
```
|
||||||
|
|
||||||
|
## Fichiers ajoutés
|
||||||
|
|
||||||
|
```text
|
||||||
|
deltas/0.3.13/pre.008.md
|
||||||
|
```
|
||||||
|
|
||||||
|
## Fichiers supprimés
|
||||||
|
|
||||||
|
```text
|
||||||
|
aucun
|
||||||
|
```
|
||||||
|
|
||||||
|
## Validation dans l'environnement d'assemblage
|
||||||
|
|
||||||
|
Le toolchain Rust/Cargo/Rustfmt n'est pas disponible dans l'environnement d'assemblage. Les commandes Cargo post-`pre.008` restent donc `NON EXÉCUTÉ LOCAL`. Les audits statiques KSP, le scan normatif, le contrôle exhaustif du diff, des headers et du ZIP sont exécutés avant livraison.
|
||||||
|
|
||||||
|
Résultats statiques finaux :
|
||||||
|
|
||||||
|
```text
|
||||||
|
General Rust rule audit: clean
|
||||||
|
Rust export completeness audit: 0 candidate(s)
|
||||||
|
KSP workspace Rust rule audit: clean
|
||||||
|
Markdown table audit: clean (340 tables, 842 files)
|
||||||
|
Normative rule definitions: 489
|
||||||
|
Unique normative IDs: 489
|
||||||
|
Duplicates: 0
|
||||||
|
```
|
||||||
|
|
||||||
|
Contrôle ciblé :
|
||||||
|
|
||||||
|
```text
|
||||||
|
17 fichiers existants modifiés
|
||||||
|
1 fichier ajouté
|
||||||
|
0 suppression
|
||||||
|
17/17 headers existants : +1
|
||||||
|
nouvelle dépendance : aucune
|
||||||
|
backend Store physique direct : absent
|
||||||
|
client HTTP/gRPC direct : absent
|
||||||
|
unbounded_channel : absent
|
||||||
|
convergence/registry publiques : absentes
|
||||||
|
```
|
||||||
|
|
||||||
|
## Gate opérateur requis avant pre.009
|
||||||
|
|
||||||
|
```bash
|
||||||
|
cargo fmt --all
|
||||||
|
cargo fmt --all -- --check
|
||||||
|
python3 scripts/audit_rust_workspace_rules.py
|
||||||
|
python3 scripts/audit_markdown_tables.py README.md RULES.md ROADMAP.md CHANGELOG.md docs prompts crates deltas
|
||||||
|
cargo check --workspace
|
||||||
|
cargo clippy --workspace --all-targets --all-features -- -D warnings
|
||||||
|
cargo test -p ksp-onchain-transport-lib
|
||||||
|
cargo test -p ksp-worker-raw-transaction-ingest-lib
|
||||||
|
cargo tree -p ksp-worker-raw-transaction-ingest-lib --edges normal
|
||||||
|
cargo tree -p ksp-worker-raw-transaction-ingest-lib -e features
|
||||||
|
cargo tree --duplicates
|
||||||
|
```
|
||||||
137
deltas/0.3.13/pre.009-fix.001.md
Normal file
137
deltas/0.3.13/pre.009-fix.001.md
Normal file
@@ -0,0 +1,137 @@
|
|||||||
|
<!-- file: deltas/0.3.13/pre.009-fix.001.md -->
|
||||||
|
<!-- version: 1 -->
|
||||||
|
|
||||||
|
# Delta 0.3.13-pre.009-fix.001 — alignement des canaris de quotas et correction du gate cargo tree
|
||||||
|
|
||||||
|
## Base requise
|
||||||
|
|
||||||
|
```text
|
||||||
|
livraison précédente : 0.3.13-pre.009
|
||||||
|
Cargo base : 0.3.13-pre.9
|
||||||
|
delta base : deltas/0.3.13/pre.009.md
|
||||||
|
archive delta base : ksp-general-0.3.13-pre.009.zip
|
||||||
|
```
|
||||||
|
|
||||||
|
Le gate opérateur du 10 septembre 2026 confirme :
|
||||||
|
|
||||||
|
```text
|
||||||
|
cargo fmt + --check : PASS
|
||||||
|
audits Rust : clean / export completeness 0
|
||||||
|
Markdown : clean, 340 tables / 845 files
|
||||||
|
cargo check --workspace : PASS
|
||||||
|
Clippy strict workspace/all-targets/all-features : PASS
|
||||||
|
Transport unit : 389/389 PASS
|
||||||
|
Transport public API : 52/52 PASS
|
||||||
|
Transport release completeness : 44/44 PASS
|
||||||
|
Transport doc-tests : 4/4 PASS
|
||||||
|
Transport smokes live opt-in : 5 ignored comme prévu
|
||||||
|
Worker unit : 99/99 PASS
|
||||||
|
Worker cross-layer : 4/4 PASS
|
||||||
|
Worker dependency-boundary : 13 PASS / 3 FAIL
|
||||||
|
```
|
||||||
|
|
||||||
|
La suite Worker s'arrête sur ces trois canaris `dependency_boundary`; `hardening`, `public_api`, `release_completeness` et les doc-tests Worker ne sont donc pas déclarés PASS pour ce gate.
|
||||||
|
|
||||||
|
Les trois échecs exigent encore la chaîne historique :
|
||||||
|
|
||||||
|
```text
|
||||||
|
max_pending_signals: settings.admission_queue_capacity()
|
||||||
|
```
|
||||||
|
|
||||||
|
Cette assertion n'est plus correcte depuis `pre.009`. Les sources reference-bearing reçoivent désormais des quotas `hydration_pending_limit` et `hydration_in_flight_limit` calculés à partir des budgets globaux, tandis que les preuves `pre.009` verrouillent la partition exacte des capacités configurées.
|
||||||
|
|
||||||
|
Une revue préventive trouve également le même canari obsolète dans `tests/hardening.rs`, avec l'ancienne hypothèse `max_in_flight: settings.persistence_concurrency()`. Il est corrigé dans le même fix avant qu'il ne devienne le prochain échec.
|
||||||
|
|
||||||
|
## Objectif du fix
|
||||||
|
|
||||||
|
Mettre à jour les preuves sans modifier la logique runtime :
|
||||||
|
|
||||||
|
```text
|
||||||
|
anciens canaris source-specific : vérifient with_global_registry + quotas source locaux
|
||||||
|
canari pre.009 dependency : vérifie aussi le lien budgets globaux -> settings
|
||||||
|
hardening historique : vérifie les champs bornés + quotas, sans ancienne égalité locale
|
||||||
|
runtime : inchangé
|
||||||
|
```
|
||||||
|
|
||||||
|
Les anciens canaris ne sont pas affaiblis : la relation directe entre capacités Worker et budgets globaux est désormais vérifiée par le canari `pre.009`, et les canaris historiques continuent à vérifier que chaque source utilise le coordinator borné commun.
|
||||||
|
|
||||||
|
## Correction du workflow cargo tree
|
||||||
|
|
||||||
|
Le gate opérateur avant `pre.010` ne doit pas imposer `cargo tree` : `pre.009` ne modifie aucune dépendance ni feature et `pre.010` n'est pas la fermeture technique de `0.3.13`.
|
||||||
|
|
||||||
|
La règle courante est explicitée dans le prompt `0.3.13` :
|
||||||
|
|
||||||
|
```text
|
||||||
|
cargo tree requis si le graphe dépendances/features change
|
||||||
|
ou à la fermeture technique de 0.3.13
|
||||||
|
pas à chaque prerelease sans changement de graphe
|
||||||
|
```
|
||||||
|
|
||||||
|
Le plan, la validation et le delta `pre.009` sont alignés sur cette règle pour le gate avant `pre.010`.
|
||||||
|
|
||||||
|
## Version
|
||||||
|
|
||||||
|
```text
|
||||||
|
livraison : 0.3.13-pre.009-fix.001
|
||||||
|
workspace.package.version : 0.3.13-pre.9.fix.1
|
||||||
|
archive : ksp-general-0.3.13-pre.009-fix.001.zip
|
||||||
|
```
|
||||||
|
|
||||||
|
`Cargo.toml` passe de la version de fichier `556` à `557`.
|
||||||
|
|
||||||
|
## Fichiers modifiés
|
||||||
|
|
||||||
|
```text
|
||||||
|
Cargo.toml
|
||||||
|
crates/ksp-worker-raw-transaction-ingest-lib/tests/dependency_boundary.rs
|
||||||
|
crates/ksp-worker-raw-transaction-ingest-lib/tests/hardening.rs
|
||||||
|
prompts/032-V0_3_13_START_PROMPT.md
|
||||||
|
docs/plans/034-V0_3_13_MULTI_SOURCE_LIVE_CONVERGENCE_PLAN.md
|
||||||
|
docs/validation/030-V0_3_13_MULTI_SOURCE_LIVE_CONVERGENCE.md
|
||||||
|
deltas/0.3.13/pre.009.md
|
||||||
|
```
|
||||||
|
|
||||||
|
Versions de fichiers :
|
||||||
|
|
||||||
|
```text
|
||||||
|
dependency_boundary.rs : 25 -> 26
|
||||||
|
hardening.rs : 19 -> 20
|
||||||
|
032 start prompt : 1 -> 2
|
||||||
|
plan 034 : 9 -> 10
|
||||||
|
validation 030 : 9 -> 10
|
||||||
|
pre.009.md : 1 -> 2
|
||||||
|
```
|
||||||
|
|
||||||
|
## Fichiers ajoutés
|
||||||
|
|
||||||
|
```text
|
||||||
|
deltas/0.3.13/pre.009-fix.001.md
|
||||||
|
```
|
||||||
|
|
||||||
|
## Fichiers supprimés
|
||||||
|
|
||||||
|
```text
|
||||||
|
aucun
|
||||||
|
```
|
||||||
|
|
||||||
|
## Non-claims
|
||||||
|
|
||||||
|
Ce fix ne modifie aucune source production, aucun quota calculé, aucune borne globale, aucun sémaphore, aucune registry, aucune logique de disagreement, aucune dépendance, aucune feature et aucune API publique.
|
||||||
|
|
||||||
|
## Validation dans l'environnement d'assemblage
|
||||||
|
|
||||||
|
Le toolchain Rust/Cargo/Rustfmt n'est pas disponible dans l'environnement d'assemblage. Les commandes Cargo post-fix restent donc `NON EXÉCUTÉ LOCAL`. Les audits statiques KSP et le contrôle exhaustif du delta sont exécutés avant packaging.
|
||||||
|
|
||||||
|
## Gate opérateur requis avant pre.010
|
||||||
|
|
||||||
|
```bash
|
||||||
|
cargo fmt --all
|
||||||
|
cargo fmt --all -- --check
|
||||||
|
python3 scripts/audit_rust_workspace_rules.py
|
||||||
|
python3 scripts/audit_markdown_tables.py README.md RULES.md ROADMAP.md CHANGELOG.md docs prompts crates deltas
|
||||||
|
cargo check --workspace
|
||||||
|
cargo clippy --workspace --all-targets --all-features -- -D warnings
|
||||||
|
cargo test -p ksp-worker-raw-transaction-ingest-lib
|
||||||
|
```
|
||||||
|
|
||||||
|
Aucun `cargo tree` n'est requis pour ce gate. Le test Transport n'a pas besoin d'être répété par ce fix, qui ne modifie ni Transport, ni dépendance, ni feature.
|
||||||
148
deltas/0.3.13/pre.009-fix.002.md
Normal file
148
deltas/0.3.13/pre.009-fix.002.md
Normal file
@@ -0,0 +1,148 @@
|
|||||||
|
<!-- file: deltas/0.3.13/pre.009-fix.002.md -->
|
||||||
|
<!-- version: 1 -->
|
||||||
|
|
||||||
|
# Delta 0.3.13-pre.009-fix.002 — alignement du canari de disagreement canonique
|
||||||
|
|
||||||
|
## Base requise
|
||||||
|
|
||||||
|
```text
|
||||||
|
livraison précédente : 0.3.13-pre.009-fix.001
|
||||||
|
Cargo base : 0.3.13-pre.9.fix.1
|
||||||
|
delta base : deltas/0.3.13/pre.009-fix.001.md
|
||||||
|
archive delta base : ksp-general-0.3.13-pre.009-fix.001.zip
|
||||||
|
```
|
||||||
|
|
||||||
|
Le gate opérateur du 10 septembre 2026 confirme :
|
||||||
|
|
||||||
|
```text
|
||||||
|
cargo fmt + --check : PASS
|
||||||
|
audits Rust : clean / export completeness 0
|
||||||
|
Markdown : clean, 340 tables / 846 files
|
||||||
|
cargo check --workspace : PASS
|
||||||
|
Clippy strict workspace/all-targets/all-features : PASS
|
||||||
|
Transport unit : 389/389 PASS
|
||||||
|
Transport public API : 52/52 PASS
|
||||||
|
Transport release completeness : 44/44 PASS
|
||||||
|
Transport doc-tests : 4/4 PASS
|
||||||
|
Transport smokes live opt-in : 5 ignored comme prévu
|
||||||
|
Worker unit : 99/99 PASS
|
||||||
|
Worker cross-layer : 4/4 PASS
|
||||||
|
Worker dependency-boundary : 16/16 PASS
|
||||||
|
Worker hardening : 22 PASS / 1 FAIL
|
||||||
|
```
|
||||||
|
|
||||||
|
La suite Worker s'arrête sur le canari :
|
||||||
|
|
||||||
|
```text
|
||||||
|
v0_3_13_pre_008_cross_source_convergence_is_bounded_conflict_checked_and_private
|
||||||
|
```
|
||||||
|
|
||||||
|
Il exige encore l'ancienne chaîne d'implémentation :
|
||||||
|
|
||||||
|
```text
|
||||||
|
known_hash_value != content_hash
|
||||||
|
```
|
||||||
|
|
||||||
|
Cette assertion est obsolète depuis `pre.009`, où l'état canonique de convergence compare désormais ensemble `slot`, `block_time`, `format_id`, `format_version` et `content_hash` via `RawTransactionIngestCanonicalState`.
|
||||||
|
|
||||||
|
`public_api`, `release_completeness` et les doc-tests Worker ne sont donc pas déclarés PASS pour ce gate, car l'exécution s'arrête sur `hardening`.
|
||||||
|
|
||||||
|
## Objectif du fix
|
||||||
|
|
||||||
|
Corriger uniquement le canari historique `pre.008` afin qu'il vérifie le conflit canonique actuel sans revenir à une comparaison hash-only :
|
||||||
|
|
||||||
|
```text
|
||||||
|
ancienne preuve : known_hash_value != content_hash
|
||||||
|
nouvelle preuve : known_state_value != &canonical_state
|
||||||
|
```
|
||||||
|
|
||||||
|
Le canari continue à exiger la borne du cache, l'éviction uniquement des entrées non partagées, le passage par `record_observation` et le fail-closed d'une observation additionnelle impossible.
|
||||||
|
|
||||||
|
Aucune source production n'est modifiée.
|
||||||
|
|
||||||
|
## Immutabilité des deltas
|
||||||
|
|
||||||
|
Les deltas déjà livrés sont immuables. Ce fix n'altère aucun fichier `deltas/` existant, y compris :
|
||||||
|
|
||||||
|
```text
|
||||||
|
deltas/0.3.13/pre.009.md
|
||||||
|
deltas/0.3.13/pre.009-fix.001.md
|
||||||
|
```
|
||||||
|
|
||||||
|
La correction est tracée uniquement par le nouveau fichier `deltas/0.3.13/pre.009-fix.002.md`.
|
||||||
|
|
||||||
|
La modification de `pre.009.md` qui avait été incluse dans `pre.009-fix.001` reste une exception historique déjà acceptée par l'opérateur ; elle n'est ni répétée ni réécrite dans ce fix.
|
||||||
|
|
||||||
|
## Version
|
||||||
|
|
||||||
|
```text
|
||||||
|
livraison : 0.3.13-pre.009-fix.002
|
||||||
|
workspace.package.version : 0.3.13-pre.9.fix.2
|
||||||
|
archive : ksp-general-0.3.13-pre.009-fix.002.zip
|
||||||
|
```
|
||||||
|
|
||||||
|
`Cargo.toml` passe de la version de fichier `557` à `558`.
|
||||||
|
|
||||||
|
## Fichiers modifiés
|
||||||
|
|
||||||
|
```text
|
||||||
|
Cargo.toml
|
||||||
|
crates/ksp-worker-raw-transaction-ingest-lib/tests/hardening.rs
|
||||||
|
```
|
||||||
|
|
||||||
|
`hardening.rs` passe de la version de fichier `20` à `21`.
|
||||||
|
|
||||||
|
## Fichiers ajoutés
|
||||||
|
|
||||||
|
```text
|
||||||
|
deltas/0.3.13/pre.009-fix.002.md
|
||||||
|
```
|
||||||
|
|
||||||
|
## Fichiers supprimés
|
||||||
|
|
||||||
|
```text
|
||||||
|
aucun
|
||||||
|
```
|
||||||
|
|
||||||
|
## Validations exécutées dans l'environnement d'assemblage
|
||||||
|
|
||||||
|
Le toolchain Rust/Cargo/Rustfmt n'est pas disponible dans l'environnement d'assemblage. Les commandes Cargo post-fix restent donc `NON EXÉCUTÉ LOCAL`.
|
||||||
|
|
||||||
|
Sont exécutés avant packaging :
|
||||||
|
|
||||||
|
```text
|
||||||
|
scripts/audit_rust_workspace_rules.py
|
||||||
|
audit Markdown complet
|
||||||
|
scan des définitions normatives
|
||||||
|
diff exact contre la base pre.009-fix.001
|
||||||
|
contrôle d'immutabilité byte-for-byte de tous les deltas existants
|
||||||
|
contrôle du manifest et du contenu extrait de l'archive
|
||||||
|
```
|
||||||
|
|
||||||
|
## Décisions
|
||||||
|
|
||||||
|
- le runtime `pre.009` reste inchangé ;
|
||||||
|
- le disagreement canonique reste fondé sur l'état canonique complet, pas sur le seul hash ;
|
||||||
|
- aucun delta historique n'est modifié ;
|
||||||
|
- aucune dépendance ni feature ne change ;
|
||||||
|
- aucun `cargo tree` n'est requis pour ce fix.
|
||||||
|
|
||||||
|
## Questions ouvertes
|
||||||
|
|
||||||
|
```text
|
||||||
|
aucune
|
||||||
|
```
|
||||||
|
|
||||||
|
## Gate opérateur requis avant pre.010
|
||||||
|
|
||||||
|
```bash
|
||||||
|
cargo fmt --all
|
||||||
|
cargo fmt --all -- --check
|
||||||
|
python3 scripts/audit_rust_workspace_rules.py
|
||||||
|
python3 scripts/audit_markdown_tables.py README.md RULES.md ROADMAP.md CHANGELOG.md docs prompts crates deltas
|
||||||
|
cargo check --workspace
|
||||||
|
cargo clippy --workspace --all-targets --all-features -- -D warnings
|
||||||
|
cargo test -p ksp-worker-raw-transaction-ingest-lib
|
||||||
|
```
|
||||||
|
|
||||||
|
Le test Transport n'a pas besoin d'être répété pour ce fix, qui ne modifie ni Transport, ni source production, ni dépendance, ni feature.
|
||||||
221
deltas/0.3.13/pre.009.md
Normal file
221
deltas/0.3.13/pre.009.md
Normal file
@@ -0,0 +1,221 @@
|
|||||||
|
<!-- file: deltas/0.3.13/pre.009.md -->
|
||||||
|
<!-- version: 2 -->
|
||||||
|
|
||||||
|
# Delta 0.3.13-pre.009 — disagreements, duplicate storms, bornes globales et fairness
|
||||||
|
|
||||||
|
## Base requise
|
||||||
|
|
||||||
|
```text
|
||||||
|
livraison précédente : 0.3.13-pre.008-fix.002
|
||||||
|
Cargo base : 0.3.13-pre.8.fix.2
|
||||||
|
delta base : deltas/0.3.13/pre.008-fix.002.md
|
||||||
|
archive delta base : ksp-general-0.3.13-pre.008-fix.002.zip
|
||||||
|
```
|
||||||
|
|
||||||
|
Les gates opérateur communiqués le 10 septembre 2026 autorisent cette tranche. Le gate Worker est vert pour `cargo fmt`, `cargo fmt --check`, les audits Rust/Markdown, `cargo check --workspace`, Clippy strict et toutes les suites `ksp-worker-raw-transaction-ingest-lib` : `94` unit, `4` cross-layer, `15` dependency-boundary, `22` hardening, `16` public-api, `4` release-completeness et `0` doc-test.
|
||||||
|
|
||||||
|
Le gate étendu complète cette qualification avec `cargo test -p ksp-onchain-transport-lib` : `389` unit, `52` public-api, `44` release-completeness et `4` doc-tests passent. Les cinq smokes réseau opt-in affichés restent ignorés comme prévu. Les commandes `cargo tree -p ksp-worker-raw-transaction-ingest-lib --edges normal`, `cargo tree -p ksp-worker-raw-transaction-ingest-lib -e features` et `cargo tree --duplicates` sont exécutées sans erreur ; `cargo tree --duplicates` liste les doublons existants du workspace sans introduire de promesse de graphe sans doublon.
|
||||||
|
|
||||||
|
## Objectif
|
||||||
|
|
||||||
|
Fermer les risques adversariaux qui restent après la convergence cross-source de `pre.008` :
|
||||||
|
|
||||||
|
```text
|
||||||
|
disagreement entre sources
|
||||||
|
storms de références dupliquées
|
||||||
|
borne globale des pending hydration signals
|
||||||
|
borne globale des tâches/hydrations HTTP
|
||||||
|
cleanup d'un leader global annulé
|
||||||
|
fairness minimale entre sources reference-bearing
|
||||||
|
absence de starvation structurelle
|
||||||
|
```
|
||||||
|
|
||||||
|
La tranche ne modifie pas encore la projection publique de health/snapshots multi-source ; ce point reste réservé à `pre.010`.
|
||||||
|
|
||||||
|
## Version
|
||||||
|
|
||||||
|
```text
|
||||||
|
livraison : 0.3.13-pre.009
|
||||||
|
workspace.package.version : 0.3.13-pre.9
|
||||||
|
archive : ksp-general-0.3.13-pre.009.zip
|
||||||
|
```
|
||||||
|
|
||||||
|
`Cargo.toml` passe de la version de fichier `555` à `556`.
|
||||||
|
|
||||||
|
## Budgets globaux et fairness minimale
|
||||||
|
|
||||||
|
Yellowstone, Standard Logs et Helius Transaction sont les sources reference-bearing qui nécessitent une hydration `getTransaction`. Avant tout spawn, `run_live_sources` vérifie :
|
||||||
|
|
||||||
|
```text
|
||||||
|
hydration_source_count <= admission_queue_capacity
|
||||||
|
hydration_source_count <= persistence_concurrency
|
||||||
|
```
|
||||||
|
|
||||||
|
Si une de ces relations est fausse, le démarrage échoue fail-closed avec un `runtime_invalid` stable. Aucune capacité configurée n'est agrandie silencieusement.
|
||||||
|
|
||||||
|
Lorsque la composition est valide, les deux budgets sont partitionnés statiquement par quotient/reste suivant l'ordre déjà validé des sources :
|
||||||
|
|
||||||
|
```text
|
||||||
|
somme hydration pending quotas = admission_queue_capacity
|
||||||
|
somme hydration in-flight quotas = persistence_concurrency
|
||||||
|
quota de chaque source reference-bearing >= 1
|
||||||
|
```
|
||||||
|
|
||||||
|
Une source ne peut donc pas consommer la part réservée aux autres sources reference-bearing. Ce mécanisme n'introduit ni scheduler pondéré, ni priorité provider, ni primary/standby.
|
||||||
|
|
||||||
|
Standard Block et HTTP Block Polling restent RAW-direct et continuent à utiliser l'admission centrale bornée sans passer par ces quotas d'hydration.
|
||||||
|
|
||||||
|
## Borne globale d'hydration
|
||||||
|
|
||||||
|
Le `RawTransactionIngestGlobalHydrationRegistry` reste privé et borné à `admission_queue_capacity` clés distinctes. Un duplicate storm sur une clé déjà présente rejoint le résultat global existant et ne crée ni nouvelle entrée ni second leader HTTP.
|
||||||
|
|
||||||
|
Un `tokio::sync::Semaphore` global, dimensionné à `persistence_concurrency`, protège en plus le nombre de leaders HTTP effectivement ouverts. Les coordinators locaux conservent simultanément leurs quotas `max_pending_signals` et `max_in_flight`.
|
||||||
|
|
||||||
|
Une clé distincte au-delà de la borne globale produit `source.global_hydration_pending_saturated` au lieu d'une croissance mémoire non bornée.
|
||||||
|
|
||||||
|
## Cleanup d'un leader global
|
||||||
|
|
||||||
|
Chaque leader de la registry possède un `RawTransactionIngestHydrationLeaderGuard` privé. Si la tâche est annulée ou droppée avant la publication normale du résultat, le guard publie une faute source sûre aux followers et retire la clé du registre.
|
||||||
|
|
||||||
|
Après cleanup, la même clé peut redevenir leader lors d'une acquisition ultérieure. Aucun leader orphelin ne doit survivre à un abort/shutdown.
|
||||||
|
|
||||||
|
## Disagreement canonique
|
||||||
|
|
||||||
|
Le cache run-local de convergence persistence ne compare plus uniquement `RawContentHash`. Pour une même identité durable `(network, signature)`, il mémorise maintenant un état canonique borné :
|
||||||
|
|
||||||
|
```text
|
||||||
|
slot
|
||||||
|
block_time
|
||||||
|
format_id
|
||||||
|
format_version
|
||||||
|
content_hash
|
||||||
|
```
|
||||||
|
|
||||||
|
Une divergence sur l'une de ces dimensions produit immédiatement le content conflict terminal existant avant toute observation additionnelle. Aucun byte de transaction n'est recopié dans le cache ; le hash provient de la canonicalisation Common RAW et le Store conserve son contrôle durable final sur le contenu exact.
|
||||||
|
|
||||||
|
La politique reste conservatrice : aucune majorité de sources, aucun first-provider-wins, aucune préférence provider/tier et aucun overwrite de conflit.
|
||||||
|
|
||||||
|
## Fairness et duplicate storms
|
||||||
|
|
||||||
|
La fairness minimale est prouvée sur le canal d'admission commun borné à capacité `1`. Après qu'une source en storm a rejoint la file d'attente, une seconde source déjà prête rejoint la même file et progresse avant la répétition suivante de la storm.
|
||||||
|
|
||||||
|
Cette preuve ne revendique pas une QoS pondérée. Elle verrouille uniquement l'absence de starvation indéfinie d'une source déjà prête sous le contrat FIFO du canal borné commun, tandis que les quotas statiques empêchent la starvation structurelle des sources reference-bearing en amont.
|
||||||
|
|
||||||
|
## Preuves ajoutées
|
||||||
|
|
||||||
|
Tests unitaires déterministes :
|
||||||
|
|
||||||
|
```text
|
||||||
|
budgets 8/5 répartis sur 3 sources -> [3,3,2] pending et [2,2,1] in-flight
|
||||||
|
composition sous-provisionnée -> refus avant spawn
|
||||||
|
32 duplicats d'une même clé -> un seul leader global
|
||||||
|
clé distincte au-delà de max_pending -> saturation sûre
|
||||||
|
sémaphore capacité 1 -> une seule permit simultanée
|
||||||
|
leader guard droppé -> Failed publié + clé réouvrable
|
||||||
|
queue admission capacité 1 -> seconde source prête progresse sous storm
|
||||||
|
même signature + slot divergent -> content conflict
|
||||||
|
même signature + block_time divergent -> content conflict
|
||||||
|
même signature + contenu/hash divergent -> content conflict
|
||||||
|
aucune observation additionnelle après disagreement
|
||||||
|
```
|
||||||
|
|
||||||
|
Canaris externes :
|
||||||
|
|
||||||
|
```text
|
||||||
|
dependency_boundary : bornes/fairness restent dans Worker + façades existantes
|
||||||
|
hardening : quotas, sémaphore, cleanup, disagreement et absence de provider preference
|
||||||
|
public_api : registry, leader guard, quotas et canonical state restent privés
|
||||||
|
release_completeness : présence obligatoire des trois canaris pre.009
|
||||||
|
```
|
||||||
|
|
||||||
|
## Frontière de tranche
|
||||||
|
|
||||||
|
`pre.009` ne ferme pas encore :
|
||||||
|
|
||||||
|
```text
|
||||||
|
nouveaux compteurs/health publics multi-source
|
||||||
|
projection détaillée par source
|
||||||
|
politique de dégradation non terminale
|
||||||
|
failover provider
|
||||||
|
scheduler/QoS pondéré
|
||||||
|
source primary/standby
|
||||||
|
majority vote
|
||||||
|
```
|
||||||
|
|
||||||
|
Les snapshots/health appartiennent à `pre.010`.
|
||||||
|
|
||||||
|
## Fichiers modifiés
|
||||||
|
|
||||||
|
```text
|
||||||
|
Cargo.toml
|
||||||
|
crates/ksp-worker-raw-transaction-ingest-lib/README.md
|
||||||
|
crates/ksp-worker-raw-transaction-ingest-lib/USAGE.md
|
||||||
|
crates/ksp-worker-raw-transaction-ingest-lib/src/persistence.rs
|
||||||
|
crates/ksp-worker-raw-transaction-ingest-lib/src/runtime_resources.rs
|
||||||
|
crates/ksp-worker-raw-transaction-ingest-lib/tests/dependency_boundary.rs
|
||||||
|
crates/ksp-worker-raw-transaction-ingest-lib/tests/hardening.rs
|
||||||
|
crates/ksp-worker-raw-transaction-ingest-lib/tests/public_api.rs
|
||||||
|
crates/ksp-worker-raw-transaction-ingest-lib/tests/release_completeness.rs
|
||||||
|
crates/ksp-worker-raw-transaction-ingest-lib/unit_tests/admission.rs
|
||||||
|
crates/ksp-worker-raw-transaction-ingest-lib/unit_tests/persistence.rs
|
||||||
|
crates/ksp-worker-raw-transaction-ingest-lib/unit_tests/runtime_resources.rs
|
||||||
|
docs/plans/034-V0_3_13_MULTI_SOURCE_LIVE_CONVERGENCE_PLAN.md
|
||||||
|
docs/validation/030-V0_3_13_MULTI_SOURCE_LIVE_CONVERGENCE.md
|
||||||
|
```
|
||||||
|
|
||||||
|
## Fichiers ajoutés
|
||||||
|
|
||||||
|
```text
|
||||||
|
deltas/0.3.13/pre.009.md
|
||||||
|
```
|
||||||
|
|
||||||
|
## Fichiers supprimés
|
||||||
|
|
||||||
|
```text
|
||||||
|
aucun
|
||||||
|
```
|
||||||
|
|
||||||
|
## Validation dans l'environnement d'assemblage
|
||||||
|
|
||||||
|
Le toolchain Rust/Cargo/Rustfmt n'est pas disponible dans l'environnement d'assemblage. Les commandes Cargo post-`pre.009` restent donc `NON EXÉCUTÉ LOCAL`. Les audits statiques KSP, le scan normatif, le contrôle exhaustif du diff, des headers et du ZIP sont exécutés avant livraison.
|
||||||
|
|
||||||
|
## Résultats statiques finaux
|
||||||
|
|
||||||
|
```text
|
||||||
|
General Rust rule audit: clean
|
||||||
|
Rust export completeness audit: 0 candidate(s)
|
||||||
|
KSP workspace Rust rule audit: clean
|
||||||
|
Markdown table audit: clean (340 tables, 845 files)
|
||||||
|
Normative rule definitions: 489
|
||||||
|
Unique normative IDs: 489
|
||||||
|
Duplicates: 0
|
||||||
|
```
|
||||||
|
|
||||||
|
Contrôle ciblé :
|
||||||
|
|
||||||
|
```text
|
||||||
|
14 fichiers existants modifiés
|
||||||
|
1 fichier ajouté
|
||||||
|
0 suppression
|
||||||
|
14/14 headers existants : +1
|
||||||
|
nouvelle dépendance : aucune
|
||||||
|
backend Store physique direct : absent
|
||||||
|
client HTTP/gRPC direct : absent
|
||||||
|
unbounded_channel : absent
|
||||||
|
registry/quotas/canonical state publics : absents
|
||||||
|
```
|
||||||
|
|
||||||
|
## Gate opérateur requis avant pre.010
|
||||||
|
|
||||||
|
```bash
|
||||||
|
cargo fmt --all
|
||||||
|
cargo fmt --all -- --check
|
||||||
|
python3 scripts/audit_rust_workspace_rules.py
|
||||||
|
python3 scripts/audit_markdown_tables.py README.md RULES.md ROADMAP.md CHANGELOG.md docs prompts crates deltas
|
||||||
|
cargo check --workspace
|
||||||
|
cargo clippy --workspace --all-targets --all-features -- -D warnings
|
||||||
|
cargo test -p ksp-onchain-transport-lib
|
||||||
|
cargo test -p ksp-worker-raw-transaction-ingest-lib
|
||||||
|
```
|
||||||
|
|
||||||
|
Aucun `cargo tree` n'est requis pour ce gate : `pre.009` ne modifie ni dépendance ni feature. Les graphes seront réaudités si le graphe change ou à la fermeture technique de `0.3.13`.
|
||||||
48
deltas/0.3.13/pre.010.md
Normal file
48
deltas/0.3.13/pre.010.md
Normal file
@@ -0,0 +1,48 @@
|
|||||||
|
<!-- file: deltas/0.3.13/pre.010.md -->
|
||||||
|
<!-- version: 1 -->
|
||||||
|
|
||||||
|
# Delta 0.3.13-pre.010 — snapshots/health multi-source
|
||||||
|
|
||||||
|
## Objet
|
||||||
|
|
||||||
|
Fermer la projection publique source-neutral prévue pour le runtime multi-source sans exposer les identités logiques, providers, endpoints, filtres ou matériaux Transport.
|
||||||
|
|
||||||
|
## Runtime
|
||||||
|
|
||||||
|
`RawTransactionIngestSnapshot` expose désormais quatre gauges latest-value : `source_total`, `source_active`, `source_reconnecting` et `source_failed`.
|
||||||
|
|
||||||
|
`source_total` est initialisé dès le démarrage depuis la collection `RawTransactionIngestRuntimeResources` validée. L'inventaire privé borné agrège ensuite les états locaux et publie uniquement les comptes numériques, l'état source agrégé et les compteurs de continuité déjà existants.
|
||||||
|
|
||||||
|
La health commune devient conservative pendant `Running` : une source failed donne `Unhealthy`; un reconnect ou une composition dont toutes les sources attendues ne sont pas encore actives donne `Degraded`; toutes les sources attendues actives permettent `Healthy`. `Faulted` reste `Unhealthy` et `Stopping`/`Stopped` conservent la dernière health qualifiée.
|
||||||
|
|
||||||
|
L'activity reste liée au travail concret, aux pending, à la persistence, au reconnect ou au closing. Une source simplement ouverte n'est pas artificiellement classée `Active`.
|
||||||
|
|
||||||
|
## Preuves ajoutées
|
||||||
|
|
||||||
|
Les tests couvrent les comptes d'inventaire, la health `Degraded -> Healthy -> Unhealthy`, les quatre getters publics, la redaction du snapshot, l'absence de backend/network client direct et la présence des canaris dans `release_completeness`.
|
||||||
|
|
||||||
|
## Frontière
|
||||||
|
|
||||||
|
Aucun changement de convergence, fairness, quota, Store, Transport, dépendance ou feature. Aucun failover, provider health public, snapshot par source ou coverage inference. Les races et shutdown concurrents restent `pre.011`.
|
||||||
|
|
||||||
|
## Gate reçu avant cette tranche
|
||||||
|
|
||||||
|
Le gate opérateur `0.3.13-pre.009-fix.002` est vert pour toutes les commandes exécutées : fmt, audits, workspace check, Clippy strict, Transport `389 + 52 + 44 + 4` avec `5` smokes live opt-in ignorés, puis Worker `99 + 4 + 16 + 23 + 17 + 4`, sans échec. Aucun `cargo tree` n'était requis ni exécuté.
|
||||||
|
|
||||||
|
## Validation locale d'assemblage
|
||||||
|
|
||||||
|
Le toolchain Cargo/Rustfmt n'est pas disponible dans l'environnement d'assemblage. Aucun résultat Cargo post-modification n'est déclaré PASS localement. Les audits statiques et contrôles de packaging effectivement exécutés sont les seules preuves locales consignées pour cette livraison.
|
||||||
|
|
||||||
|
## Gate opérateur avant pre.011
|
||||||
|
|
||||||
|
```bash
|
||||||
|
cargo fmt --all
|
||||||
|
cargo fmt --all -- --check
|
||||||
|
python3 scripts/audit_rust_workspace_rules.py
|
||||||
|
python3 scripts/audit_markdown_tables.py README.md RULES.md ROADMAP.md CHANGELOG.md docs prompts crates deltas
|
||||||
|
cargo check --workspace
|
||||||
|
cargo clippy --workspace --all-targets --all-features -- -D warnings
|
||||||
|
cargo test -p ksp-worker-raw-transaction-ingest-lib
|
||||||
|
```
|
||||||
|
|
||||||
|
Aucun `cargo tree` n'est requis ; aucune dépendance ni feature n'a changé. Le Transport n'est pas modifié par cette tranche snapshot/health.
|
||||||
62
deltas/0.3.13/pre.011.md
Normal file
62
deltas/0.3.13/pre.011.md
Normal file
@@ -0,0 +1,62 @@
|
|||||||
|
<!-- file: deltas/0.3.13/pre.011.md -->
|
||||||
|
<!-- version: 1 -->
|
||||||
|
|
||||||
|
# Delta 0.3.13-pre.011 — races/shutdown hardening
|
||||||
|
|
||||||
|
## Objet
|
||||||
|
|
||||||
|
Fermer les races stop/fault et l'ownership des tâches source/hydration/persistence avant la tranche de completeness/security cross-layer, sans modifier Transport, le graphe de dépendances ou les politiques de convergence/fairness déjà acquises.
|
||||||
|
|
||||||
|
## Shutdown et ownership
|
||||||
|
|
||||||
|
Le supervisor conserve l'ordre terminal explicite : signal de stop source, passage Worker à `Stopping`, drain borné, abort+join si la deadline expire, puis publication du terminal. L'abort du wrapper multi-source détruit son `JoinSet` privé et annule donc aussi les tâches source imbriquées avant retour.
|
||||||
|
|
||||||
|
Une faute source déjà observée n'est pas masquée par un stop concurrent. Le `drain_timeout` reste prioritaire lorsqu'une récupération bornée dépasse réellement sa deadline. Une persistence encore bloquée à cette échéance est abortée et jointe ; elle ne peut pas publier de succès tardif après le snapshot terminal.
|
||||||
|
|
||||||
|
## Hydration partagée
|
||||||
|
|
||||||
|
`RawTransactionIngestGlobalHydrationRegistry::publish_and_remove` notifie désormais les followers sous le mutex de registry avant de retirer la clé. Une nouvelle génération de leader ne peut donc pas s'intercaler entre le retrait de la clé et la notification des followers existants.
|
||||||
|
|
||||||
|
Le leader guard conserve son cleanup fail-closed : si un leader est aborté avant publication normale, les followers reçoivent une faute source sûre et la clé redevient ensuite disponible.
|
||||||
|
|
||||||
|
## Inventaire et compteurs
|
||||||
|
|
||||||
|
L'agrégation multi-source remplace les additions saturantes par `checked_add` pour `hydration_pending`, `source_reconnect_total`, `source_replay_attempt_total` et `source_continuity_gap_total`. Un overflow devient `worker_raw_transaction_ingest.counter_exhausted`.
|
||||||
|
|
||||||
|
Une mise à jour d'inventaire avec index absent, `source_key` incohérente ou projection absente échoue explicitement par `runtime_invalid` au lieu d'être ignorée. Lorsqu'une source remonte `counter_exhausted`, le supervisor préserve ce code terminal et ne le remappe pas en `source_failed`.
|
||||||
|
|
||||||
|
## Preuves ajoutées
|
||||||
|
|
||||||
|
Les tests couvrent l'identité/index d'inventaire invalides, les overflows d'agrégats, l'abort d'un leader hydration, l'abort du supervisor externe et de ses enfants imbriqués, la race stop/source fault, la conservation de `counter_exhausted`, le drain timeout sans completion tardive, l'ordre terminal et l'atomicité notification-avant-retrait.
|
||||||
|
|
||||||
|
Les canaris externes verrouillent l'absence de queue non bornée, backend Store direct, client Transport secondaire ou nouvelle surface publique d'identité source.
|
||||||
|
|
||||||
|
## Frontière
|
||||||
|
|
||||||
|
Aucun changement de Transport, Store API, dépendance, feature, convergence, quotas/fairness, snapshot public ou politique de failover. La completeness/security exhaustive reste `pre.012`; le gate technique/live complet et les graphes restent `pre.013`.
|
||||||
|
|
||||||
|
## Gate reçu avant cette tranche
|
||||||
|
|
||||||
|
Le gate opérateur `0.3.13-pre.010` est vert pour toutes les commandes exécutées : fmt, audits, Markdown `340/848`, workspace check, Clippy strict, puis Worker `100` unit + `4` cross-layer + `17` dependency-boundary + `24` hardening + `18` public-api + `4` release-completeness et `0` doc-test.
|
||||||
|
|
||||||
|
Le Transport n'était pas modifié par `pre.010` et n'a pas été rejoué. Aucun `cargo tree` n'était requis ni exécuté.
|
||||||
|
|
||||||
|
## Validation locale d'assemblage
|
||||||
|
|
||||||
|
Le toolchain Cargo/Rustfmt n'est pas disponible dans l'environnement d'assemblage. Aucun résultat Cargo post-modification n'est déclaré PASS localement. Les audits statiques et contrôles de packaging effectivement exécutés sont les seules preuves locales consignées pour cette livraison.
|
||||||
|
|
||||||
|
Les audits statiques finaux d'assemblage sont clean : règles Rust générales, export completeness `0`, règles KSP, Markdown `340/849`, et inventaire normatif `489/489` sans doublon.
|
||||||
|
|
||||||
|
## Gate opérateur avant pre.012
|
||||||
|
|
||||||
|
```bash
|
||||||
|
cargo fmt --all
|
||||||
|
cargo fmt --all -- --check
|
||||||
|
python3 scripts/audit_rust_workspace_rules.py
|
||||||
|
python3 scripts/audit_markdown_tables.py README.md RULES.md ROADMAP.md CHANGELOG.md docs prompts crates deltas
|
||||||
|
cargo check --workspace
|
||||||
|
cargo clippy --workspace --all-targets --all-features -- -D warnings
|
||||||
|
cargo test -p ksp-worker-raw-transaction-ingest-lib
|
||||||
|
```
|
||||||
|
|
||||||
|
Aucun `cargo tree` n'est requis ; aucune dépendance ni feature n'a changé. Le Transport n'est pas modifié par cette tranche de hardening shutdown/races.
|
||||||
75
deltas/0.3.13/pre.012.md
Normal file
75
deltas/0.3.13/pre.012.md
Normal file
@@ -0,0 +1,75 @@
|
|||||||
|
<!-- file: deltas/0.3.13/pre.012.md -->
|
||||||
|
<!-- version: 1 -->
|
||||||
|
|
||||||
|
# Delta 0.3.13-pre.012 — completeness/security cross-layer
|
||||||
|
|
||||||
|
## Objet
|
||||||
|
|
||||||
|
Fermer la matrice de preuves cross-layer avant le gate technique/live `pre.013`, sans modifier le comportement runtime, l'API publique, Transport, Common RAW, Store, les dépendances ou les features.
|
||||||
|
|
||||||
|
## Gate opérateur d'entrée
|
||||||
|
|
||||||
|
Le gate `0.3.13-pre.011` communiqué le 10 septembre 2026 est vert :
|
||||||
|
|
||||||
|
```text
|
||||||
|
fmt : PASS
|
||||||
|
audits Rust : clean / export completeness 0
|
||||||
|
Markdown : clean, 340 tables / 849 files
|
||||||
|
cargo check --workspace : PASS
|
||||||
|
clippy strict : PASS
|
||||||
|
Worker unit : 106/106 PASS
|
||||||
|
cross_layer_completeness : 4/4 PASS
|
||||||
|
dependency_boundary : 18/18 PASS
|
||||||
|
hardening : 25/25 PASS
|
||||||
|
public_api : 19/19 PASS
|
||||||
|
release_completeness : 4/4 PASS
|
||||||
|
Worker doc-tests : 0/0 PASS
|
||||||
|
```
|
||||||
|
|
||||||
|
## Modifications
|
||||||
|
|
||||||
|
La suite `cross_layer_completeness` ajoute quatre preuves obligatoires :
|
||||||
|
|
||||||
|
```text
|
||||||
|
cinq familles live -> pipeline Worker/Common RAW/Store unique
|
||||||
|
Legacy/V0/V1 -> Transport/Worker/Common RAW/Store
|
||||||
|
non-régression Yellowstone -> identity/V1/reconnect/gap/hydration
|
||||||
|
security/redaction -> Transport/Worker/Common RAW/Store API/Store/PostgreSQL
|
||||||
|
```
|
||||||
|
|
||||||
|
Les suites `dependency_boundary`, `hardening`, `public_api` et `release_completeness` verrouillent explicitement la présence de cette matrice.
|
||||||
|
|
||||||
|
## Frontières
|
||||||
|
|
||||||
|
```text
|
||||||
|
aucun code production modifié
|
||||||
|
aucune API publique ajoutée
|
||||||
|
aucune dépendance/feature modifiée
|
||||||
|
aucun changement Transport/Common RAW/Store
|
||||||
|
aucun delta historique modifié
|
||||||
|
```
|
||||||
|
|
||||||
|
## Validation locale d'assemblage
|
||||||
|
|
||||||
|
Le toolchain Cargo/Rustfmt n'est pas disponible dans l'environnement d'assemblage. Aucune commande Cargo post-modification n'est déclarée PASS localement.
|
||||||
|
|
||||||
|
Les audits statiques et les contrôles archive sont consignés uniquement après leur exécution effective.
|
||||||
|
|
||||||
|
## Gate opérateur vers pre.013
|
||||||
|
|
||||||
|
`pre.013` est le gate technique/live de fermeture ; exécuter :
|
||||||
|
|
||||||
|
```bash
|
||||||
|
cargo fmt --all
|
||||||
|
cargo fmt --all -- --check
|
||||||
|
python3 scripts/audit_rust_workspace_rules.py
|
||||||
|
python3 scripts/audit_markdown_tables.py README.md RULES.md ROADMAP.md CHANGELOG.md docs prompts crates deltas
|
||||||
|
cargo check --workspace
|
||||||
|
cargo clippy --workspace --all-targets --all-features -- -D warnings
|
||||||
|
cargo test --workspace --all-targets --all-features
|
||||||
|
cargo tree -p ksp-worker-raw-transaction-ingest-lib --edges normal
|
||||||
|
cargo tree -p ksp-worker-raw-transaction-ingest-lib -e features
|
||||||
|
cargo tree --duplicates
|
||||||
|
```
|
||||||
|
|
||||||
|
Les smokes live accessibles sont qualifiés dans `pre.013`; un smoke inaccessible reste `NON EXÉCUTÉ`.
|
||||||
64
deltas/0.3.13/pre.013.md
Normal file
64
deltas/0.3.13/pre.013.md
Normal file
@@ -0,0 +1,64 @@
|
|||||||
|
<!-- file: deltas/0.3.13/pre.013.md -->
|
||||||
|
<!-- version: 1 -->
|
||||||
|
|
||||||
|
# Delta 0.3.13-pre.013 — gate technique/live
|
||||||
|
|
||||||
|
## Objet
|
||||||
|
|
||||||
|
Matérialiser la tranche de gate technique/live prévue par le plan, sans ajouter de scope fonctionnel : enregistrer le gate déterministe workspace complet déjà communiqué et séparer strictement cette preuve des smokes live opt-in encore à exécuter.
|
||||||
|
|
||||||
|
## Gate déterministe reçu
|
||||||
|
|
||||||
|
Le gate `0.3.13-pre.012` du 10 septembre 2026 est vert pour les commandes exécutées :
|
||||||
|
|
||||||
|
```text
|
||||||
|
fmt : PASS
|
||||||
|
audits Rust : clean / export completeness 0
|
||||||
|
Markdown : clean, 340 tables / 850 files
|
||||||
|
cargo check --workspace : PASS
|
||||||
|
clippy workspace/all-targets/all-features -D warnings : PASS
|
||||||
|
cargo test --workspace --all-targets --all-features : 1 850 PASS / 0 échec / 15 ignored
|
||||||
|
Worker : 106 unit + 8 cross-layer + 19 dependency-boundary + 26 hardening + 20 public-api + 5 release-completeness, 0 échec
|
||||||
|
cargo tree Worker normal/features : exécutés sans erreur
|
||||||
|
cargo tree --duplicates : exécuté sans erreur ; inventaire multi-version affiché
|
||||||
|
```
|
||||||
|
|
||||||
|
Les tests `ignored` ne sont pas requalifiés en preuves live.
|
||||||
|
|
||||||
|
## Modifications
|
||||||
|
|
||||||
|
```text
|
||||||
|
workspace.package.version -> 0.3.13-pre.13
|
||||||
|
validation 030 : enregistrement du gate déterministe et qualification live
|
||||||
|
aucun Rust production/test modifié
|
||||||
|
aucune dépendance/feature modifiée
|
||||||
|
aucun delta historique modifié
|
||||||
|
```
|
||||||
|
|
||||||
|
## Smokes keyless requis pour fermer la partie live accessible
|
||||||
|
|
||||||
|
```bash
|
||||||
|
cargo test -p ksp-onchain-transport-lib --test transport_devnet_smoke -- --ignored --nocapture
|
||||||
|
cargo test -p ksp-onchain-transport-lib --test websocket_devnet_smoke -- --ignored --nocapture
|
||||||
|
```
|
||||||
|
|
||||||
|
Ces smokes restent séparés du gate déterministe. Les preuves Yellowstone/Helius/blockSubscribe dédié/HTTP polling Worker/multi-source Store end-to-end restent `NON EXÉCUTÉ` tant qu'un gate réel ne fournit pas les credentials, provider capabilities ou ressources nécessaires.
|
||||||
|
|
||||||
|
## Frontières
|
||||||
|
|
||||||
|
```text
|
||||||
|
aucun nouveau scope fonctionnel
|
||||||
|
aucune API publique modifiée
|
||||||
|
aucun comportement runtime modifié
|
||||||
|
aucun changement Transport/Store/Common RAW
|
||||||
|
aucun changement de dépendance ou feature
|
||||||
|
aucun delta historique modifié
|
||||||
|
```
|
||||||
|
|
||||||
|
## Validation locale d'assemblage
|
||||||
|
|
||||||
|
Le toolchain Cargo/Rustfmt n'est pas disponible dans l'environnement d'assemblage. Aucun PASS Cargo post-`pre.013` n'est revendiqué localement. Les audits statiques et contrôles archive sont déclarés uniquement après exécution effective.
|
||||||
|
|
||||||
|
## Gate opérateur
|
||||||
|
|
||||||
|
Après application du delta, exécuter les deux smokes keyless ci-dessus. En cas d'échec produit reproductible, rester sur `pre.013` et produire un fix. S'ils passent, les autres smokes non provisionnés restent explicitement `NON EXÉCUTÉ` et la release peut passer à `pre.014` pour la réconciliation documentaire.
|
||||||
78
deltas/0.3.13/pre.014.md
Normal file
78
deltas/0.3.13/pre.014.md
Normal file
@@ -0,0 +1,78 @@
|
|||||||
|
<!-- file: deltas/0.3.13/pre.014.md -->
|
||||||
|
<!-- version: 1 -->
|
||||||
|
|
||||||
|
# Delta `0.3.13-pre.014`
|
||||||
|
|
||||||
|
## Nature
|
||||||
|
|
||||||
|
Réconciliation documentaire de la verticale live multi-source `RawTransaction` après fermeture technique/live de `pre.013`.
|
||||||
|
|
||||||
|
Aucun code Rust, test, dépendance, feature ou contrat public n'est modifié.
|
||||||
|
|
||||||
|
## Gate d'entrée confirmé
|
||||||
|
|
||||||
|
Le gate déterministe `pre.012` reste vert et les deux smokes live keyless exécutés sur `0.3.13-pre.013` passent explicitement :
|
||||||
|
|
||||||
|
```text
|
||||||
|
Solana HTTP Devnet : 1/1 PASS
|
||||||
|
Solana WebSocket Devnet : 1/1 PASS
|
||||||
|
```
|
||||||
|
|
||||||
|
Le contrôle post-smoke communiqué passe également fmt, audits Rust/Markdown, `cargo check --workspace` et Clippy strict.
|
||||||
|
|
||||||
|
## Réconciliation durable
|
||||||
|
|
||||||
|
Les documents suivants sont mis en cohérence avec l'état réellement livré :
|
||||||
|
|
||||||
|
```text
|
||||||
|
docs/architecture/004-COMPONENT_INVENTORY.md
|
||||||
|
docs/architecture/005-DEPENDENCY_GRAPH.md
|
||||||
|
docs/architecture/011-RAW_TRANSACTION_ACQUISITION.md
|
||||||
|
docs/plans/002-FUNCTIONAL_RELEASE_SEQUENCE.md
|
||||||
|
docs/plans/034-V0_3_13_MULTI_SOURCE_LIVE_CONVERGENCE_PLAN.md
|
||||||
|
docs/validation/030-V0_3_13_MULTI_SOURCE_LIVE_CONVERGENCE.md
|
||||||
|
```
|
||||||
|
|
||||||
|
Les corrections principales sont :
|
||||||
|
|
||||||
|
```text
|
||||||
|
Worker RAW documenté comme composition de 1..32 sources logiques sur un même réseau
|
||||||
|
cinq familles live : Yellowstone / Standard Logs / Standard Block / Helius Transaction / HTTP Block Polling
|
||||||
|
registry globale d'hydration pour Yellowstone / Standard Logs / Helius
|
||||||
|
Standard Block et HTTP Block Polling RAW-direct Legacy/V0/V1
|
||||||
|
blockSubscribe actuel avec maxSupportedTransactionVersion = 1
|
||||||
|
convergence canonique + observations multiples + disagreement explicite
|
||||||
|
backpressure/fairness et bornes globales source-neutral
|
||||||
|
health multi-source conservative et shutdown/races bornés
|
||||||
|
reports EARLY / coverage-equivalence / repair historique maintenus hors 0.3.13
|
||||||
|
```
|
||||||
|
|
||||||
|
`README.md`, `crates/ksp-worker-raw-transaction-ingest-lib/README.md` et `USAGE.md` ont été audités et sont déjà cohérents ; ils restent byte-identiques. `USAGE.md` reste version-neutral.
|
||||||
|
|
||||||
|
## Frontières
|
||||||
|
|
||||||
|
Cette tranche ne modifie pas :
|
||||||
|
|
||||||
|
```text
|
||||||
|
CHANGELOG.md
|
||||||
|
ROADMAP.md
|
||||||
|
prompt 0.3.14
|
||||||
|
code/test Rust
|
||||||
|
Cargo dependencies/features
|
||||||
|
deltas historiques
|
||||||
|
```
|
||||||
|
|
||||||
|
La préparation publication reste réservée à `pre.015`.
|
||||||
|
|
||||||
|
## Gate opérateur avant `pre.015`
|
||||||
|
|
||||||
|
```bash
|
||||||
|
cargo fmt --all
|
||||||
|
cargo fmt --all -- --check
|
||||||
|
python3 scripts/audit_rust_workspace_rules.py
|
||||||
|
python3 scripts/audit_markdown_tables.py README.md RULES.md ROADMAP.md CHANGELOG.md docs prompts crates deltas
|
||||||
|
cargo check --workspace
|
||||||
|
cargo clippy --workspace --all-targets --all-features -- -D warnings
|
||||||
|
```
|
||||||
|
|
||||||
|
Aucun `cargo tree`, smoke live ou rerun exhaustif des tests n'est requis pour cette tranche strictement documentaire hors bump mécanique de prerelease.
|
||||||
224
deltas/0.3.13/pre.015.md
Normal file
224
deltas/0.3.13/pre.015.md
Normal file
@@ -0,0 +1,224 @@
|
|||||||
|
<!-- file: deltas/0.3.13/pre.015.md -->
|
||||||
|
<!-- version: 2 -->
|
||||||
|
|
||||||
|
# Delta `0.3.13-pre.015` — préparation de publication
|
||||||
|
|
||||||
|
## 1. Base requise
|
||||||
|
|
||||||
|
```text
|
||||||
|
0.3.13-pre.014
|
||||||
|
workspace.package.version = 0.3.13-pre.14
|
||||||
|
```
|
||||||
|
|
||||||
|
Le gate opérateur communiqué le **10 septembre 2026 à 23:15** sur `pre.014` est vert pour toutes les commandes exécutées :
|
||||||
|
|
||||||
|
```text
|
||||||
|
cargo fmt --all : PASS
|
||||||
|
cargo fmt --all -- --check : PASS
|
||||||
|
General Rust rule audit : clean
|
||||||
|
Rust export completeness audit : 0 candidate(s)
|
||||||
|
KSP workspace Rust rule audit : clean
|
||||||
|
Markdown table audit : clean, 340 tables / 852 files
|
||||||
|
cargo check --workspace : PASS
|
||||||
|
cargo clippy --workspace --all-targets --all-features -- -D warnings : PASS
|
||||||
|
```
|
||||||
|
|
||||||
|
Conformément à `pre.014`, aucun `cargo tree`, smoke live ou rerun exhaustif des tests n'était requis pour cette tranche strictement documentaire hors bump mécanique.
|
||||||
|
|
||||||
|
## 2. Objectif
|
||||||
|
|
||||||
|
`pre.015` est la dernière prerelease de préparation de publication de `0.3.13`.
|
||||||
|
|
||||||
|
Conformément à `VER-LIFECYCLE-003`, `VER-LIFECYCLE-012` et `PROMPT_STRUCTURE.md`, elle modifie fonctionnellement uniquement :
|
||||||
|
|
||||||
|
```text
|
||||||
|
prompt de démarrage 0.3.14
|
||||||
|
CHANGELOG.md
|
||||||
|
ROADMAP.md
|
||||||
|
```
|
||||||
|
|
||||||
|
Les seuls fichiers mécaniques supplémentaires sont :
|
||||||
|
|
||||||
|
```text
|
||||||
|
Cargo.toml racine
|
||||||
|
delta pre.015
|
||||||
|
```
|
||||||
|
|
||||||
|
Aucun README, USAGE, plan, validation, architecture, code, test, Config, schema, dépendance, feature ou manifest de crate n'est rouvert.
|
||||||
|
|
||||||
|
## 3. Version workspace
|
||||||
|
|
||||||
|
La prerelease non-fix synchronise Cargo :
|
||||||
|
|
||||||
|
```text
|
||||||
|
0.3.13-pre.14
|
||||||
|
->
|
||||||
|
0.3.13-pre.15
|
||||||
|
```
|
||||||
|
|
||||||
|
Le header de `Cargo.toml` passe de `563` à `564`.
|
||||||
|
|
||||||
|
## 4. Prompt suivant
|
||||||
|
|
||||||
|
Le nouveau prompt :
|
||||||
|
|
||||||
|
```text
|
||||||
|
prompts/033-V0_3_14_START_PROMPT.md
|
||||||
|
```
|
||||||
|
|
||||||
|
ouvre `0.3.14` exclusivement depuis le futur stable :
|
||||||
|
|
||||||
|
```text
|
||||||
|
v0.3.13
|
||||||
|
```
|
||||||
|
|
||||||
|
Sa mission est bornée au gap repair/hardening multi-source du run actif :
|
||||||
|
|
||||||
|
```text
|
||||||
|
replay natif réellement adressable
|
||||||
|
preuve de coverage par source redondante
|
||||||
|
scan HTTP de slots/blocs du run
|
||||||
|
hydration getTransaction de réparation
|
||||||
|
repaired vs unresolved gap explicites
|
||||||
|
health Healthy/Degraded/Unhealthy/Faulted fondée sur coverage prouvée
|
||||||
|
backpressure/fairness et shutdown pendant repair
|
||||||
|
smokes provider réellement accessibles
|
||||||
|
EARLY uniquement si pre.001 apporte une preuve actuelle suffisante
|
||||||
|
```
|
||||||
|
|
||||||
|
Le prompt interdit explicitement de transformer le Worker en campagne historique, de créer un edge Worker -> Job Backfill ou de coder le repair avant le `pre.001` d'audit/sizing. Il réserve :
|
||||||
|
|
||||||
|
```text
|
||||||
|
docs/plans/035-V0_3_14_MULTI_SOURCE_GAP_REPAIR_HARDENING_PLAN.md
|
||||||
|
docs/validation/031-V0_3_14_MULTI_SOURCE_GAP_REPAIR_HARDENING.md
|
||||||
|
```
|
||||||
|
|
||||||
|
## 5. CHANGELOG
|
||||||
|
|
||||||
|
`CHANGELOG.md` reçoit l'entrée stable `0.3.13` synthétisant :
|
||||||
|
|
||||||
|
```text
|
||||||
|
composition 1..32 sources d'un même réseau
|
||||||
|
cinq familles live productives
|
||||||
|
hydration globale Yellowstone / Standard Logs / Helius
|
||||||
|
RAW-direct Standard Block / HTTP Block Polling Legacy/V0/V1
|
||||||
|
coalescence cross-source + observations multiples
|
||||||
|
content conflict explicite sans first-provider-wins
|
||||||
|
fairness/backpressure/health source-neutral
|
||||||
|
shutdown/races hardening
|
||||||
|
gate déterministe 1 850 PASS / 0 échec / 15 ignored
|
||||||
|
smokes keyless HTTP Devnet + WebSocket Devnet PASS
|
||||||
|
preuves provider/resource-gated restantes NON EXÉCUTÉES
|
||||||
|
handoff 0.3.14 et prompt 033
|
||||||
|
```
|
||||||
|
|
||||||
|
## 6. ROADMAP
|
||||||
|
|
||||||
|
L'entrée `0.3.13` passe de `[ ]` à `[X]` et décrit l'état réellement livré. `0.3.14` reste ouverte pour le gap repair/hardening multi-source.
|
||||||
|
|
||||||
|
Le TODO Helius `0.3.13` passe également à `[X]` en documentant le résultat réel : la voie Helius Worker réutilise les profils Config et `KSP_SECRET_HELIUS_API_KEY` déjà existants ainsi que `transactionSubscribe` Transport-owned ; aucun nouveau profil, SDK, tier codé ou second client n'a été nécessaire.
|
||||||
|
|
||||||
|
## 7. Fichiers ajoutés
|
||||||
|
|
||||||
|
```text
|
||||||
|
prompts/033-V0_3_14_START_PROMPT.md
|
||||||
|
deltas/0.3.13/pre.015.md
|
||||||
|
```
|
||||||
|
|
||||||
|
## 8. Fichiers modifiés
|
||||||
|
|
||||||
|
```text
|
||||||
|
Cargo.toml
|
||||||
|
CHANGELOG.md
|
||||||
|
ROADMAP.md
|
||||||
|
```
|
||||||
|
|
||||||
|
## 9. Fichiers supprimés
|
||||||
|
|
||||||
|
```text
|
||||||
|
aucun
|
||||||
|
```
|
||||||
|
|
||||||
|
## 10. Surfaces explicitement inchangées
|
||||||
|
|
||||||
|
```text
|
||||||
|
README.md
|
||||||
|
RULES.md
|
||||||
|
docs/**
|
||||||
|
crates/**
|
||||||
|
config/**
|
||||||
|
tests/**
|
||||||
|
prompts/001-* à prompts/032-*
|
||||||
|
deltas/0.3.13/pre.001.md à pre.014.md et leurs fixes
|
||||||
|
```
|
||||||
|
|
||||||
|
Aucun delta historique n'est modifié.
|
||||||
|
|
||||||
|
## 11. Vérification complète de l'archive de base avant modification
|
||||||
|
|
||||||
|
L'archive opérateur `v0.3.13-pre.014` a été contrôlée avant assemblage :
|
||||||
|
|
||||||
|
```text
|
||||||
|
unzip -t : PASS
|
||||||
|
2 009 entrées ZIP
|
||||||
|
0 chemin absolu / traversal / entrée hors racine attendue
|
||||||
|
0 target/node_modules/dist/.git/.idea/__pycache__ embarqué
|
||||||
|
0 lockfile embarqué
|
||||||
|
rust-toolchain.toml absent
|
||||||
|
General Rust rule audit : clean
|
||||||
|
Rust export completeness audit : 0 candidate(s)
|
||||||
|
KSP workspace Rust rule audit : clean
|
||||||
|
Markdown table audit : clean, 340 tables / 852 files
|
||||||
|
5/5 tests unitaires du validateur Markdown : PASS
|
||||||
|
489 définitions de règles normatives
|
||||||
|
489 identifiants normatifs uniques
|
||||||
|
0 doublon d'identifiant normatif
|
||||||
|
headers/newline des surfaces critiques : PASS
|
||||||
|
scan high-confidence de secrets privés : aucun résultat
|
||||||
|
```
|
||||||
|
|
||||||
|
Le toolchain Cargo/Rustc n'est pas disponible dans l'environnement d'assemblage. Aucun PASS Cargo supplémentaire n'est revendiqué localement ; les PASS Cargo ci-dessus proviennent exclusivement du gate opérateur communiqué.
|
||||||
|
|
||||||
|
## 12. Validations exécutées sur l'état `pre.015`
|
||||||
|
|
||||||
|
Sur l'état exact de `pre.015` avant packaging :
|
||||||
|
|
||||||
|
```text
|
||||||
|
General Rust rule audit : clean
|
||||||
|
Rust export completeness audit : 0 candidate(s)
|
||||||
|
KSP workspace Rust rule audit : clean
|
||||||
|
Markdown table audit : clean, 340 tables / 854 files
|
||||||
|
489 définitions de règles / 489 identifiants uniques / 0 doublon
|
||||||
|
prompt 033 : 16 sections normatives présentes
|
||||||
|
diff exact pre.014 -> pre.015 : 3 fichiers existants modifiés + 2 ajoutés + 0 supprimé
|
||||||
|
headers des 3 fichiers existants : +1 exactement
|
||||||
|
Cargo.toml : hors header, seule workspace.package.version change
|
||||||
|
aucun README/USAGE/plan/validation/architecture/code/test/config/schema/dependency/feature modifié
|
||||||
|
```
|
||||||
|
|
||||||
|
Les contrôles `unzip -t`, archive safety et inventaire minimal du ZIP sont exécutés après packaging avant livraison.
|
||||||
|
|
||||||
|
Les commandes Cargo post-`pre.015` restent à exécuter par l'opérateur avant `rel.001` :
|
||||||
|
|
||||||
|
```bash
|
||||||
|
cargo fmt --all -- --check
|
||||||
|
python3 scripts/audit_rust_workspace_rules.py
|
||||||
|
python3 scripts/audit_markdown_tables.py README.md RULES.md ROADMAP.md CHANGELOG.md docs prompts crates deltas
|
||||||
|
cargo check --workspace
|
||||||
|
```
|
||||||
|
|
||||||
|
Clippy strict peut être rejoué ; aucun code/test/dépendance/feature n'étant modifié, il ne remplace pas le gate minimal ci-dessus.
|
||||||
|
|
||||||
|
## 13. Décisions prises
|
||||||
|
|
||||||
|
- `0.3.13` est fonctionnellement/documentairement fermé et prêt pour le gate de publication de `pre.015` ;
|
||||||
|
- `0.3.14` ne commence qu'après `0.3.13-rel.001` validée et le tag stable `v0.3.13` ;
|
||||||
|
- le prompt `0.3.14` conserve la séparation Worker/Backfill et impose un `pre.001` avant toute logique de repair ;
|
||||||
|
- les preuves live non exécutées de `0.3.13` restent explicitement non revendiquées ;
|
||||||
|
- aucun correctif d'un couloir technique/documentaire antérieur n'est absorbé dans cette préparation de publication.
|
||||||
|
|
||||||
|
## 14. Questions ouvertes
|
||||||
|
|
||||||
|
```text
|
||||||
|
aucune question bloquante pour la préparation de publication 0.3.13
|
||||||
|
```
|
||||||
190
deltas/0.3.13/rel.001.md
Normal file
190
deltas/0.3.13/rel.001.md
Normal file
@@ -0,0 +1,190 @@
|
|||||||
|
<!-- file: deltas/0.3.13/rel.001.md -->
|
||||||
|
<!-- version: 2 -->
|
||||||
|
|
||||||
|
# Delta `0.3.13-rel.001` — publication stable
|
||||||
|
|
||||||
|
## Base requise
|
||||||
|
|
||||||
|
Base directe attendue :
|
||||||
|
|
||||||
|
```text
|
||||||
|
0.3.13-pre.015
|
||||||
|
workspace.package.version = 0.3.13-pre.15
|
||||||
|
```
|
||||||
|
|
||||||
|
Les couloirs de fermeture précédents sont fermés :
|
||||||
|
|
||||||
|
- `pre.013` : gate technique déterministe complet, graphes Cargo et qualification explicite des smokes live ;
|
||||||
|
- smokes keyless post-`pre.013` : Solana HTTP Devnet `1/1 PASS` et WebSocket Devnet `1/1 PASS` ;
|
||||||
|
- `pre.014` : réconciliation documentaire finale de l'architecture, du plan et de la validation ;
|
||||||
|
- `pre.015` : préparation minimale de publication avec `CHANGELOG.md`, `ROADMAP.md` et `prompts/033-V0_3_14_START_PROMPT.md`.
|
||||||
|
|
||||||
|
Le gate opérateur reçu avant `pre.015`, exécuté le **10 septembre 2026 à 23:15** sur `0.3.13-pre.014`, est propre pour rustfmt, audits Rust/Markdown, `cargo check --workspace` et Clippy strict.
|
||||||
|
|
||||||
|
L'environnement d'assemblage de `pre.015` ne possède pas Cargo/Rustc. Le gate Cargo de l'état exact `0.3.13-pre.015` reste donc un **prérequis d'application** de ce delta et ne doit pas être déclaré PASS sans exécution opérateur réelle :
|
||||||
|
|
||||||
|
```bash
|
||||||
|
cargo fmt --all -- --check
|
||||||
|
python3 scripts/audit_rust_workspace_rules.py
|
||||||
|
python3 scripts/audit_markdown_tables.py README.md RULES.md ROADMAP.md CHANGELOG.md docs prompts crates deltas
|
||||||
|
cargo check --workspace
|
||||||
|
```
|
||||||
|
|
||||||
|
Si ce gate révèle un défaut, ne pas appliquer `rel.001` : ouvrir la prerelease/fix appropriée selon la responsabilité concernée.
|
||||||
|
|
||||||
|
## Objet
|
||||||
|
|
||||||
|
Publier mécaniquement la version stable :
|
||||||
|
|
||||||
|
```text
|
||||||
|
0.3.13
|
||||||
|
```
|
||||||
|
|
||||||
|
Conformément à `VER-LIFECYCLE-012`, cette tranche ne corrige ni code, ni test, ni documentation durable, ni architecture, ni configuration, ni dépendance, ni prompt.
|
||||||
|
|
||||||
|
Tout défaut nouveau renvoie vers une prerelease appropriée ; `rel.001` n'est pas une tranche de rattrapage.
|
||||||
|
|
||||||
|
## Modification
|
||||||
|
|
||||||
|
### `Cargo.toml`
|
||||||
|
|
||||||
|
Le header est incrémenté parce que le fichier est réellement modifié :
|
||||||
|
|
||||||
|
```text
|
||||||
|
564 -> 565
|
||||||
|
```
|
||||||
|
|
||||||
|
La version workspace devient :
|
||||||
|
|
||||||
|
```text
|
||||||
|
0.3.13-pre.15 -> 0.3.13
|
||||||
|
```
|
||||||
|
|
||||||
|
Aucune autre ligne du `Cargo.toml` racine n'est modifiée.
|
||||||
|
|
||||||
|
## Fichiers ajoutés
|
||||||
|
|
||||||
|
```text
|
||||||
|
deltas/0.3.13/rel.001.md
|
||||||
|
```
|
||||||
|
|
||||||
|
## Fichiers modifiés
|
||||||
|
|
||||||
|
```text
|
||||||
|
Cargo.toml
|
||||||
|
```
|
||||||
|
|
||||||
|
## Fichiers supprimés
|
||||||
|
|
||||||
|
```text
|
||||||
|
aucun
|
||||||
|
```
|
||||||
|
|
||||||
|
## Surfaces explicitement inchangées
|
||||||
|
|
||||||
|
```text
|
||||||
|
CHANGELOG.md
|
||||||
|
ROADMAP.md
|
||||||
|
README.md
|
||||||
|
RULES.md
|
||||||
|
prompts/033-V0_3_14_START_PROMPT.md
|
||||||
|
crates/**
|
||||||
|
docs/**
|
||||||
|
config/**
|
||||||
|
```
|
||||||
|
|
||||||
|
La surface préparée en `pre.015` reste byte-identique hors mécanique Cargo et ajout du présent delta.
|
||||||
|
|
||||||
|
## Surface stable publiée
|
||||||
|
|
||||||
|
`0.3.13` stabilise la convergence live multi-source de `ksp-worker-raw-transaction-ingest-lib` :
|
||||||
|
|
||||||
|
- composition caller-owned de `1` à `32` sources logiques d'un même réseau, avec identités dupliquées rejetées avant spawn ;
|
||||||
|
- cinq familles live productives : Yellowstone, Standard Logs, Standard Block, Helius Transaction et HTTP Block Polling ;
|
||||||
|
- Standard Logs et Helius Transaction convergent avec Yellowstone vers l'hydration globale `getTransaction observed` ;
|
||||||
|
- Standard Block et HTTP Block Polling utilisent le RAW-direct uniquement pour Legacy/V0/V1 qualifiés, avec `maxSupportedTransactionVersion = 1` ;
|
||||||
|
- coalescence cross-source de `(network, signature, commitment)` avant hydration et sérialisation bornée de l'acquisition canonique `(network, signature)` ;
|
||||||
|
- observations/provenances distinctes conservées pour un contenu canonique identique ; divergence convertie en `content_conflict` terminal, sans majorité, overwrite ou `first-provider-wins` ;
|
||||||
|
- backpressure, quotas et fairness source-neutral bornés entre sources reference-bearing, hydration et persistence ;
|
||||||
|
- snapshots/health agrégés sans exposition du matériau provider ; reconnexion transitoire `Degraded`, source `Failed` `Unhealthy`, retour à `Healthy` lorsque toutes les sources attendues redeviennent actives ;
|
||||||
|
- une faute source reste terminale en `0.3.13` faute de preuve d'équivalence de coverage ; le repair/failover non terminal appartient à `0.3.14` ;
|
||||||
|
- shutdown stop/fault/drain/abort+join durci contre leaders d'hydration abandonnés, Store lent, counters et publications tardives ;
|
||||||
|
- aucune dépendance Worker vers Config, Job Backfill ou backend Store physique, aucun client réseau/SDK provider parallèle et aucun second actor Transport.
|
||||||
|
|
||||||
|
Le gate technique déterministe de la release a exécuté `cargo test --workspace --all-targets --all-features` avec :
|
||||||
|
|
||||||
|
```text
|
||||||
|
1 850 PASS
|
||||||
|
0 échec
|
||||||
|
15 ignored opt-in/operator-only
|
||||||
|
```
|
||||||
|
|
||||||
|
Les smokes keyless Solana HTTP Devnet et WebSocket Devnet passent `1/1` chacun. Les preuves Yellowstone provider-gated, Helius `transactionSubscribe` live, `blockSubscribe` provider dédié, HTTP Block Polling Worker end-to-end et Worker multi-source -> Store end-to-end restent explicitement `NON EXÉCUTÉ` faute de gate provisionné ; aucune fixture ou compilation d'un test ignored ne les requalifie en PASS.
|
||||||
|
|
||||||
|
Le Job Backfill historique paramétré et le Worker Ingest continu restent deux producteurs indépendants du même Store. `0.3.13` n'introduit ni campagne historique automatique, ni checkpoint durable Worker, ni preuve de blockchain completeness.
|
||||||
|
|
||||||
|
## Suite préparée
|
||||||
|
|
||||||
|
La session suivante part exclusivement de la base stable :
|
||||||
|
|
||||||
|
```text
|
||||||
|
v0.3.13
|
||||||
|
```
|
||||||
|
|
||||||
|
et exécute :
|
||||||
|
|
||||||
|
```text
|
||||||
|
prompts/033-V0_3_14_START_PROMPT.md
|
||||||
|
```
|
||||||
|
|
||||||
|
pour ouvrir :
|
||||||
|
|
||||||
|
```text
|
||||||
|
0.3.14 — gap repair / hardening multi-source du Worker RawTransaction
|
||||||
|
```
|
||||||
|
|
||||||
|
`0.3.14-pre.001` doit commencer par lecture, audit interne/externe, brainstorming, sizing et planification avant toute implémentation de repair. Il doit distinguer reconnect, replay attempt, coverage prouvée, repair et unresolved gap ; le Worker ne doit toujours pas devenir un moteur de campagne historique ni dépendre de `ksp-job-backfill-lib`.
|
||||||
|
|
||||||
|
## Validations d'assemblage
|
||||||
|
|
||||||
|
Sur l'état candidat `rel.001`, avant packaging :
|
||||||
|
|
||||||
|
```text
|
||||||
|
General Rust rule audit : clean
|
||||||
|
Rust export completeness audit : 0 candidate(s)
|
||||||
|
KSP workspace Rust rule audit : clean
|
||||||
|
Markdown table audit : clean, 340 tables / 855 files
|
||||||
|
5/5 tests unitaires du validateur Markdown : PASS
|
||||||
|
489 définitions de règles / 489 identifiants uniques / 0 doublon
|
||||||
|
diff exact pre.015 -> rel.001 : Cargo.toml modifié + rel.001.md ajouté, 0 autre changement
|
||||||
|
Cargo.toml : exactement 2 lignes différentes, header 564 -> 565 et version 0.3.13-pre.15 -> 0.3.13
|
||||||
|
```
|
||||||
|
|
||||||
|
Les contrôles `unzip -t`, archive safety et inventaire minimal du ZIP sont exécutés après packaging avant livraison.
|
||||||
|
|
||||||
|
Aucun PASS Cargo post-bump stable n'est revendiqué localement faute de toolchain.
|
||||||
|
|
||||||
|
## Gate demandé après application
|
||||||
|
|
||||||
|
La tranche est purement mécanique. Après application sur un `pre.015` dont le gate préalable est vert :
|
||||||
|
|
||||||
|
```bash
|
||||||
|
cargo fmt --all -- --check
|
||||||
|
python3 scripts/audit_rust_workspace_rules.py
|
||||||
|
python3 scripts/audit_markdown_tables.py README.md RULES.md ROADMAP.md CHANGELOG.md docs prompts crates deltas/0.3.13
|
||||||
|
cargo check --workspace
|
||||||
|
cargo clippy --workspace --all-targets --all-features -- -D warnings
|
||||||
|
cargo test -p ksp-worker-raw-transaction-ingest-lib
|
||||||
|
cargo test -p ksp-onchain-transport-lib
|
||||||
|
cargo tree -p ksp-worker-raw-transaction-ingest-lib --edges normal
|
||||||
|
cargo tree -p ksp-worker-raw-transaction-ingest-lib -e features
|
||||||
|
```
|
||||||
|
|
||||||
|
Après gate propre :
|
||||||
|
|
||||||
|
```text
|
||||||
|
commit : v0.3.13-rel.001
|
||||||
|
tag : v0.3.13
|
||||||
|
```
|
||||||
|
|
||||||
|
Aucun tag de prerelease ou `rel.001` n'est requis.
|
||||||
@@ -1,5 +1,5 @@
|
|||||||
<!-- file: docs/architecture/004-COMPONENT_INVENTORY.md -->
|
<!-- file: docs/architecture/004-COMPONENT_INVENTORY.md -->
|
||||||
<!-- version: 39 -->
|
<!-- version: 40 -->
|
||||||
|
|
||||||
# Inventaire initial des composants KSP
|
# Inventaire initial des composants KSP
|
||||||
|
|
||||||
@@ -46,7 +46,7 @@ Ce document maintient l'inventaire synthétique des composants retenus ou presse
|
|||||||
| Store Desk | `ksp-app-store-desk` | app | Implémenté | `0.3.8` | inspection RAW read-only Transaction/Account/Observation via façade Store |
|
| Store Desk | `ksp-app-store-desk` | app | Implémenté | `0.3.8` | inspection RAW read-only Transaction/Account/Observation via façade Store |
|
||||||
| RAW transaction common | `ksp-raw-transaction-lib` | lib | Implémenté | `0.3.10` | canonicalisation/wire RAW Transaction v1 source-neutral partagé entre producteurs |
|
| RAW transaction common | `ksp-raw-transaction-lib` | lib | Implémenté | `0.3.10` | canonicalisation/wire RAW Transaction v1 source-neutral partagé entre producteurs |
|
||||||
| Worker lifecycle | `ksp-worker-api` | API | Implémenté | `0.3.9` | lifecycle/health/progression génériques des services continus |
|
| Worker lifecycle | `ksp-worker-api` | API | Implémenté | `0.3.9` | lifecycle/health/progression génériques des services continus |
|
||||||
| RAW transaction worker | `ksp-worker-raw-transaction-ingest-lib` | worker/lib | Implémenté | `0.3.11`, live `0.3.12` | fondation + Yellowstone productif, hydration HTTP, frontier/reconnect run-local |
|
| RAW transaction worker | `ksp-worker-raw-transaction-ingest-lib` | worker/lib | Implémenté | `0.3.11`–`0.3.13` | fondation + 5 familles live, convergence multi-source, fairness, health et shutdown bornés |
|
||||||
| RAW ingest Desk | `ksp-app-raw-transaction-ingest-desk` | app | Retenu | `0.3.15` | choix/supervision d’une ou plusieurs sources/méthodes sans réimplémenter le worker |
|
| RAW ingest Desk | `ksp-app-raw-transaction-ingest-desk` | app | Retenu | `0.3.15` | choix/supervision d’une ou plusieurs sources/méthodes sans réimplémenter le worker |
|
||||||
| STRUCTURAL job | nom à fixer | job/lib | Retenu | couche STRUCTURAL | normalisation Solana générique RAW -> STRUCTURAL bornée/rejouable |
|
| STRUCTURAL job | nom à fixer | job/lib | Retenu | couche STRUCTURAL | normalisation Solana générique RAW -> STRUCTURAL bornée/rejouable |
|
||||||
| STRUCTURAL worker | nom à fixer | worker/lib | Retenu | fin couche STRUCTURAL | backlog RAW -> STRUCTURAL continu |
|
| STRUCTURAL worker | nom à fixer | worker/lib | Retenu | fin couche STRUCTURAL | backlog RAW -> STRUCTURAL continu |
|
||||||
|
|||||||
@@ -1,5 +1,5 @@
|
|||||||
<!-- file: docs/architecture/005-DEPENDENCY_GRAPH.md -->
|
<!-- file: docs/architecture/005-DEPENDENCY_GRAPH.md -->
|
||||||
<!-- version: 28 -->
|
<!-- version: 29 -->
|
||||||
|
|
||||||
# Graphe de dépendances KSP
|
# Graphe de dépendances KSP
|
||||||
|
|
||||||
@@ -419,10 +419,10 @@ Il remplit RAW et ne décode aucun programme. Il ne dépend pas de Config : la c
|
|||||||
ksp-worker-api
|
ksp-worker-api
|
||||||
-> ksp-core-lib
|
-> ksp-core-lib
|
||||||
|
|
||||||
ksp-worker-raw-transaction-ingest-lib # fondation + première source live matérialisées
|
ksp-worker-raw-transaction-ingest-lib # fondation + acquisition live multi-source matérialisées
|
||||||
-> ksp-core-lib
|
-> ksp-core-lib
|
||||||
-> ksp-logging-lib
|
-> ksp-logging-lib
|
||||||
-> ksp-onchain-transport-lib # Yellowstone subscribe + HTTP getTransaction observed
|
-> ksp-onchain-transport-lib # Yellowstone, WS standard/Helius et HTTP observed/polling
|
||||||
-> ksp-raw-transaction-lib
|
-> ksp-raw-transaction-lib
|
||||||
-> ksp-store-lib # default-features = false ; aucun backend imposé
|
-> ksp-store-lib # default-features = false ; aucun backend imposé
|
||||||
-> ksp-worker-api
|
-> ksp-worker-api
|
||||||
@@ -433,9 +433,9 @@ ksp-worker-control-lib # composant retenu, non matérialis
|
|||||||
-> ksp-core-lib
|
-> ksp-core-lib
|
||||||
```
|
```
|
||||||
|
|
||||||
`ksp-worker-api` est ouvert en `0.3.9` comme contrat générique de services continus et ne connaît ni Solana, ni Transport, ni Store, ni Tauri. `ksp-worker-raw-transaction-ingest-lib` est son premier consumer concret : sa fondation `0.3.11` possède admission/persistence/snapshots/shutdown ; l'extension live `0.3.12` ouvre l'edge direct vers `ksp-onchain-transport-lib` pour une source Yellowstone standard et l'hydration HTTP `getTransaction`. Config et le backend physique restent hors du Worker.
|
`ksp-worker-api` est ouvert en `0.3.9` comme contrat générique de services continus et ne connaît ni Solana, ni Transport, ni Store, ni Tauri. `ksp-worker-raw-transaction-ingest-lib` est son premier consumer concret : sa fondation `0.3.11` possède admission/persistence/snapshots/shutdown ; `0.3.12` ouvre la première verticale Yellowstone + hydration HTTP ; `0.3.13` matérialise la composition live multi-source. Config et le backend physique restent hors du Worker.
|
||||||
|
|
||||||
La verticale actuelle n'est ni « un worker WebSocket » ni un moteur historique : `RawTransactionIngestRuntimeResources` contient exactement une source Yellowstone validée, les signaux transactionnels sont hydratés par HTTP avant Common RAW, et `BlockMeta`/`Slot` restent continuity-only. Reconnect, `from_slot` et `SubscribeReplayInfo` restent propriétaires de Transport ; le Worker observe leur projection sûre et fault sur un gap de rétention prouvé sans appeler le Job Backfill. Les extensions multi-source restent ultérieures.
|
La verticale actuelle n'est ni « un worker WebSocket » ni un moteur historique : `RawTransactionIngestRuntimeResources` contient de `1` à `32` sources logiques validées d'un même réseau parmi cinq familles — Yellowstone, Standard WS `logsSubscribe`, Standard WS `blockSubscribe`, Helius `transactionSubscribe` et HTTP live block polling. Yellowstone, Standard Logs et Helius convergent vers une registry globale d'hydration HTTP `getTransaction`; Standard Block et HTTP Block Polling qualifient directement le wire Base64 Legacy/V0/V1 vers Common RAW. Toutes les acquisitions rejoignent la même admission/persistence, la convergence canonique `(network, signature)` et des observations distinctes par provenance. Reconnect, `from_slot` et `SubscribeReplayInfo` restent propriétaires de Transport ; le Worker observe leur projection sûre, conserve une processing frontier run-local, applique des bornes/fairness globales et fault sur un gap de rétention prouvé sans appeler le Job Backfill.
|
||||||
|
|
||||||
RAW worker puis STRUCTURAL worker sont introduits à la fin de leur couche respective, lorsque persistence/backlog sont disponibles. Le traitement RAW -> STRUCTURAL borné est porté par un STRUCTURAL job distinct du service continu. Les workers DECODED/DOMAIN sont introduits avec les groupes Program concernés plutôt que tous anticipés en bloc.
|
RAW worker puis STRUCTURAL worker sont introduits à la fin de leur couche respective, lorsque persistence/backlog sont disponibles. Le traitement RAW -> STRUCTURAL borné est porté par un STRUCTURAL job distinct du service continu. Les workers DECODED/DOMAIN sont introduits avec les groupes Program concernés plutôt que tous anticipés en bloc.
|
||||||
|
|
||||||
|
|||||||
@@ -1,5 +1,5 @@
|
|||||||
<!-- file: docs/architecture/011-RAW_TRANSACTION_ACQUISITION.md -->
|
<!-- file: docs/architecture/011-RAW_TRANSACTION_ACQUISITION.md -->
|
||||||
<!-- version: 13 -->
|
<!-- version: 14 -->
|
||||||
|
|
||||||
# Acquisition et alimentation `RawTransaction`
|
# Acquisition et alimentation `RawTransaction`
|
||||||
|
|
||||||
@@ -149,7 +149,7 @@ Il peut utiliser **HTTP, WS, Yellowstone gRPC, replay provider ou archive** si c
|
|||||||
|
|
||||||
### 3.2 Worker Raw Transaction Ingest : acquisition continue start/stop
|
### 3.2 Worker Raw Transaction Ingest : acquisition continue start/stop
|
||||||
|
|
||||||
`ksp-worker-raw-transaction-ingest-lib` a pour rôle de **remplir continuellement Store à partir du moment où il est démarré**. Sa fondation runtime, l'admission, la canonicalisation Common RAW, la persistence et les snapshots sont complétés par une première source productive Yellowstone standard + hydration HTTP `getTransaction`.
|
`ksp-worker-raw-transaction-ingest-lib` a pour rôle de **remplir continuellement Store à partir du moment où il est démarré**. Sa fondation runtime, l'admission, la canonicalisation Common RAW, la persistence et les snapshots supportent désormais une composition live multi-source bornée de `1` à `32` sources logiques sur un même réseau.
|
||||||
|
|
||||||
Son contrôle métier V1 est volontairement court :
|
Son contrôle métier V1 est volontairement court :
|
||||||
|
|
||||||
@@ -161,22 +161,33 @@ snapshot / notifications
|
|||||||
|
|
||||||
Le caller ne lui fournit pas une signature, un `program_id`, une plage historique, une limite de campagne ou une requête de backfill. Les endpoints, réseaux, sources activées, capabilities et secrets proviennent de Config/composition, pas d'un payload métier de `start`.
|
Le caller ne lui fournit pas une signature, un `program_id`, une plage historique, une limite de campagne ou une requête de backfill. Les endpoints, réseaux, sources activées, capabilities et secrets proviennent de Config/composition, pas d'un payload métier de `start`.
|
||||||
|
|
||||||
Deux entrées publiques coexistent : `start` conserve la fondation sans source productive, tandis que `start_with_runtime_resources` lance une source Yellowstone supervisée. Le pipeline productif actuel est :
|
Deux entrées publiques coexistent : `start` conserve la fondation sans source productive, tandis que `start_with_runtime_resources` lance la collection de ressources live validée. Les cinq familles productives matérialisées sont :
|
||||||
|
|
||||||
```text
|
```text
|
||||||
Yellowstone Transaction / TransactionStatus / Block
|
Yellowstone Transaction / TransactionStatus / Block
|
||||||
|
Standard WS logsSubscribe
|
||||||
|
Helius transactionSubscribe
|
||||||
-> signaux transactionnels source-neutral
|
-> signaux transactionnels source-neutral
|
||||||
-> coalescence bornée (network, signature, commitment)
|
-> registry globale d'hydration bornée (network, signature, commitment)
|
||||||
-> HTTP getTransaction observed
|
-> HTTP getTransaction observed
|
||||||
-> Common RAW
|
-> Common RAW
|
||||||
-> admission centrale
|
|
||||||
|
Standard WS blockSubscribe Full/Base64 Legacy|V0|V1
|
||||||
|
HTTP live block polling getSlot -> getBlocksWithLimit -> getBlock observed
|
||||||
|
-> qualification RAW directe Legacy|V0|V1
|
||||||
|
-> Common RAW
|
||||||
|
|
||||||
|
Toutes les voies
|
||||||
|
-> admission centrale bornée
|
||||||
|
-> convergence canonique (network, signature)
|
||||||
|
-> RawTransaction + observations de provenance distinctes
|
||||||
-> Store
|
-> Store
|
||||||
|
|
||||||
Yellowstone BlockMeta / Slot
|
Yellowstone BlockMeta / Slot
|
||||||
-> continuité run-local uniquement
|
-> continuité run-local uniquement
|
||||||
```
|
```
|
||||||
|
|
||||||
La source est caller-composed : le Worker ne lit pas Config et ne reçoit pas de secret. `RawTransactionIngestRuntimeResources` contient actuellement exactement une source Yellowstone validée, pas encore une collection multi-source.
|
La composition est caller-owned : le Worker ne lit pas Config et ne reçoit pas de secret. `RawTransactionIngestRuntimeResources` accepte de `1` à `32` sources logiques d'un même réseau, refuse les identités source dupliquées et supervise toutes les sources simultanément. Une faute source reste terminale pour le Worker faute d'équivalence de coverage prouvée.
|
||||||
|
|
||||||
Il ne lance pas de campagne historique arbitraire.
|
Il ne lance pas de campagne historique arbitraire.
|
||||||
|
|
||||||
@@ -253,7 +264,7 @@ Une source concrète peut fournir plusieurs capabilities. Une capability peut ê
|
|||||||
| HTTP `getSlot` / `getFirstAvailableBlock` / `minimumLedgerSlot` | bornes de ledger | non | oui, continuité | oui, admission d'une campagne | aucune transaction directe |
|
| HTTP `getSlot` / `getFirstAvailableBlock` / `minimumLedgerSlot` | bornes de ledger | non | oui, continuité | oui, admission d'une campagne | aucune transaction directe |
|
||||||
| WS `logsSubscribe` | signature + logs | non | oui, discovery live + hydration | non pour historique pur | `mentions` standard limité à un pubkey |
|
| WS `logsSubscribe` | signature + logs | non | oui, discovery live + hydration | non pour historique pur | `mentions` standard limité à un pubkey |
|
||||||
| WS `signatureSubscribe` | statut d'une signature connue | non | oui, confirmation ciblée interne | possible pour une requête ciblée en attente | one-shot |
|
| WS `signatureSubscribe` | statut d'une signature connue | non | oui, confirmation ciblée interne | possible pour une requête ciblée en attente | one-shot |
|
||||||
| WS `blockSubscribe` full/base64, legacy-v0 | bloc + transactions | oui, parité RAW v1 prouvée | oui, direct pour le sous-ensemble qualifié | non sans mécanisme de replay historique | méthode standard instable ; capability validator-dependent |
|
| WS `blockSubscribe` full/base64, Legacy/V0/V1 | bloc + transactions | oui, Legacy/V0/V1 qualifiés | oui, direct pour le sous-ensemble qualifié | non sans mécanisme de replay historique | méthode standard instable ; capability validator-dependent |
|
||||||
| Helius `transactionSubscribe` full/base64 | transaction + meta + signature/index | non sans hydration | oui, signal riche puis hydration HTTP | non comme source historique | absence de blockTime/version dans l’enveloppe qualifiée |
|
| Helius `transactionSubscribe` full/base64 | transaction + meta + signature/index | non sans hydration | oui, signal riche puis hydration HTTP | non comme source historique | absence de blockTime/version dans l’enveloppe qualifiée |
|
||||||
| Yellowstone `transactions` | transaction exécutée + meta | oui | oui | oui si replay borné demandé/disponible | filters server-side |
|
| Yellowstone `transactions` | transaction exécutée + meta | oui | oui | oui si replay borné demandé/disponible | filters server-side |
|
||||||
| Yellowstone `blocks` avec transactions | bloc + transactions | oui | oui | oui si replay borné demandé/disponible | utile au live et au backfill |
|
| Yellowstone `blocks` avec transactions | bloc + transactions | oui | oui | oui si replay borné demandé/disponible | utile au live et au backfill |
|
||||||
@@ -274,15 +285,17 @@ Cette matrice est intentionnellement **usage-first**. HTTP n'est pas « Backfill
|
|||||||
|
|
||||||
### 6.1 Acquisition directe
|
### 6.1 Acquisition directe
|
||||||
|
|
||||||
Sources capables de produire directement un matériau transactionnel complet :
|
Sources capables de produire directement un matériau transactionnel complet dans l'architecture générale :
|
||||||
|
|
||||||
```text
|
```text
|
||||||
Yellowstone transactions
|
Yellowstone transactions/blocks lorsque l'adapter choisi qualifie directement leur wire
|
||||||
Yellowstone blocks avec transactions
|
WS blockSubscribe full/base64 Legacy/V0/V1 qualifié
|
||||||
WS blockSubscribe full/base64 legacy-v0 qualifié
|
HTTP getBlock full/base64 Legacy/V0/V1
|
||||||
provider stream compatible full transaction après parité prouvée
|
provider stream compatible full transaction après parité prouvée
|
||||||
```
|
```
|
||||||
|
|
||||||
|
Dans le Worker V1 actuel, Yellowstone reste volontairement traité comme signal puis hydraté par HTTP `getTransaction` afin de conserver un seul chemin de canonicalisation productif pour cette famille. Les voies directes effectivement matérialisées dans le Worker sont Standard Block et HTTP Block Polling.
|
||||||
|
|
||||||
Chemin logique :
|
Chemin logique :
|
||||||
|
|
||||||
```text
|
```text
|
||||||
@@ -567,7 +580,7 @@ Helius transactionSubscribe
|
|||||||
|
|
||||||
Le runtime WS possède des queues bornées et une logique de reconnect/resubscribe. Un reconnect ne constitue toutefois pas un replay adressable.
|
Le runtime WS possède des queues bornées et une logique de reconnect/resubscribe. Un reconnect ne constitue toutefois pas un replay adressable.
|
||||||
|
|
||||||
La qualification `pre.005` ferme deux cas distincts : `blockSubscribe` standard en `full/base64` avec `maxSupportedTransactionVersion = 0` produit, sur fixture identique, les mêmes bytes/hash RAW v1 que `getBlock`; Helius `transactionSubscribe` full/base64 conserve l’identité, le slot, le transaction wire, la meta et l’index mais ne transporte pas `blockTime` ni `version` dans l’enveloppe qualifiée. Helius reste donc un signal live riche à hydrater par HTTP avant persistence RAW directe.
|
La qualification actuelle ferme deux cas distincts : `blockSubscribe` standard en `full/base64` avec `maxSupportedTransactionVersion = 1` qualifie explicitement Legacy/V0/V1 et produit le matériau Common RAW directement ; Helius `transactionSubscribe` full/base64 conserve l’identité, le slot, le transaction wire, la meta et l’index mais ne transporte pas `blockTime` ni `version` dans l’enveloppe qualifiée. Helius reste donc un signal live riche à hydrater par HTTP avant persistence RAW.
|
||||||
|
|
||||||
### 12.3 Yellowstone gRPC
|
### 12.3 Yellowstone gRPC
|
||||||
|
|
||||||
@@ -721,7 +734,7 @@ RAW v1 complet -> hydration HTTP avant persistence
|
|||||||
|
|
||||||
Cette qualification cross-source a préparé le contrat sans créer d'edge Common RAW -> Transport. L'extension Worker live utilise désormais cette décision conservative : Yellowstone produit des signaux structurés dans le Worker concret, puis HTTP `getTransaction` fournit le matériau RAW complet avant canonicalisation. Common RAW reste entièrement Transport-neutral.
|
Cette qualification cross-source a préparé le contrat sans créer d'edge Common RAW -> Transport. L'extension Worker live utilise désormais cette décision conservative : Yellowstone produit des signaux structurés dans le Worker concret, puis HTTP `getTransaction` fournit le matériau RAW complet avant canonicalisation. Common RAW reste entièrement Transport-neutral.
|
||||||
|
|
||||||
## 14. État du Worker live après `0.3.12`
|
## 14. État du Worker live après `0.3.13`
|
||||||
|
|
||||||
### 14.0 Verticale matérialisée
|
### 14.0 Verticale matérialisée
|
||||||
|
|
||||||
@@ -731,20 +744,24 @@ La verticale productive possède :
|
|||||||
consumer de ksp-worker-api
|
consumer de ksp-worker-api
|
||||||
settings réseau/Worker bornés
|
settings réseau/Worker bornés
|
||||||
start/stop sur runtime Tokio caller-owned
|
start/stop sur runtime Tokio caller-owned
|
||||||
supervision privée des tâches
|
supervision privée de 1..32 sources logiques sur un même réseau
|
||||||
|
cinq familles live : Yellowstone / Standard Logs / Standard Block / Helius Transaction / HTTP Block Polling
|
||||||
mpsc central borné + backpressure
|
mpsc central borné + backpressure
|
||||||
une source Yellowstone standard caller-composed
|
registry globale d'hydration pour Yellowstone / Standard Logs / Helius
|
||||||
Transaction / TransactionStatus / Block -> signaux transactionnels
|
qualification RAW directe pour Standard Block / HTTP Block Polling
|
||||||
BlockMeta / Slot -> continuity-only
|
|
||||||
coalescence bornée par network/signature/commitment
|
coalescence bornée par network/signature/commitment
|
||||||
HTTP getTransaction observed pour hydration
|
HTTP getTransaction observed pour hydration
|
||||||
canonicalisation et assembly via ksp-raw-transaction-lib
|
canonicalisation et assembly via ksp-raw-transaction-lib
|
||||||
persistence atomique via ksp-store-lib en mode Normal
|
convergence canonique par (network, signature) + disagreement explicite
|
||||||
processing frontier run-local bornée
|
persistence atomique via ksp-store-lib en mode Normal + observations supplémentaires idempotentes
|
||||||
projection source Active/Reconnecting/Closing/Closed/Failed
|
quotas pending/in-flight par source et bornes globales exactes
|
||||||
|
fairness minimale / anti-starvation sous duplicate storm
|
||||||
|
processing frontier run-local multi-source conservative
|
||||||
|
projection source-neutral Active/Reconnecting/Closing/Closed/Failed + gauges source_total/active/reconnecting/failed
|
||||||
observation des compteurs reconnect/replay/gap Transport
|
observation des compteurs reconnect/replay/gap Transport
|
||||||
|
health conservative Healthy/Degraded/Unhealthy
|
||||||
fault sur gap de rétention prouvé
|
fault sur gap de rétention prouvé
|
||||||
shutdown deadline + abort/join sans tâche orpheline
|
shutdown deadline + abort/join sans tâche orpheline ni late persistence
|
||||||
```
|
```
|
||||||
|
|
||||||
Elle conserve explicitement les frontières suivantes :
|
Elle conserve explicitement les frontières suivantes :
|
||||||
@@ -786,21 +803,27 @@ attendre un Job pour continuer
|
|||||||
hardcoder un provider unique
|
hardcoder un provider unique
|
||||||
```
|
```
|
||||||
|
|
||||||
### 14.2 Sources Worker V1 à représenter
|
### 14.2 Sources Worker V1 matérialisées et reports
|
||||||
|
|
||||||
À implémenter autant que possible, même si certaines preuves live restent bloquées par tier :
|
Matérialisé dans `0.3.13` :
|
||||||
|
|
||||||
```text
|
```text
|
||||||
Yellowstone transactions
|
Yellowstone transactions / blocks / status + HTTP hydration
|
||||||
Yellowstone blocks
|
|
||||||
Yellowstone status + hydration
|
|
||||||
WS logsSubscribe + HTTP getTransaction
|
WS logsSubscribe + HTTP getTransaction
|
||||||
WS blockSubscribe full/base64 legacy-v0 direct qualifié
|
WS blockSubscribe Full/Base64 Legacy/V0/V1 direct qualifié
|
||||||
Helius transactionSubscribe full/base64 + HTTP hydration
|
Helius transactionSubscribe Full + HTTP hydration
|
||||||
HTTP live block polling
|
HTTP live block polling getSlot/getBlocksWithLimit/getBlock observed
|
||||||
HTTP hydration
|
HTTP hydration partagée et coalescée cross-source
|
||||||
replay Yellowstone pour continuité du run
|
replay Yellowstone conservé propriétaire de Transport pour continuité du run
|
||||||
sources EARLY via adapter extensible
|
```
|
||||||
|
|
||||||
|
Reste hors de cette verticale et nécessite une tranche dédiée :
|
||||||
|
|
||||||
|
```text
|
||||||
|
sources EARLY / pre-execution
|
||||||
|
coverage-equivalence ou failover non-terminal entre sources
|
||||||
|
repair historique multi-source
|
||||||
|
Worker multi-source -> Store live E2E avec environnement complet provisionné
|
||||||
```
|
```
|
||||||
|
|
||||||
### 14.3 Gaps Transport Worker
|
### 14.3 Gaps Transport Worker
|
||||||
@@ -858,9 +881,9 @@ Ordre conseillé :
|
|||||||
0.3.11 P0 : Worker foundation/runtime + persistence déterministe
|
0.3.11 P0 : Worker foundation/runtime + persistence déterministe
|
||||||
0.3.12 P0 : Yellowstone transactions/blocks/status + hydration + replay continuity
|
0.3.12 P0 : Yellowstone transactions/blocks/status + hydration + replay continuity
|
||||||
0.3.13 P0 : WS logs + hydration, blockSubscribe, Helius transactionSubscribe, HTTP live polling
|
0.3.13 P0 : WS logs + hydration, blockSubscribe, Helius transactionSubscribe, HTTP live polling
|
||||||
0.3.13 P1 : multi-source convergence, dedup, provenance, content conflict, backpressure
|
0.3.13 P1 : multi-source convergence, dedup, provenance, content conflict, backpressure/fairness
|
||||||
0.3.14 P0 : continuity repair complet + hardening + smokes gratuits accessibles
|
0.3.13 P2 : health source-neutral, shutdown/races, completeness/security et gate live keyless
|
||||||
0.3.14 P2 : EARLY adapters accessibles seulement si prouvés
|
0.3.14 : trajectoire suivante définie par son prompt dédié ; ne pas réintroduire implicitement un scope reporté
|
||||||
0.3.16 P0 : block scan historique
|
0.3.16 P0 : block scan historique
|
||||||
0.3.16 P0 : replay Yellowstone borné
|
0.3.16 P0 : replay Yellowstone borné
|
||||||
0.3.16 P1 : provider history/archive
|
0.3.16 P1 : provider history/archive
|
||||||
@@ -984,7 +1007,8 @@ Yellowstone pre.006 = transaction wire V1 qualifié ; RAW complet via h
|
|||||||
TR-C2 = adapter productif Transport DTO -> common réservé au Worker concret
|
TR-C2 = adapter productif Transport DTO -> common réservé au Worker concret
|
||||||
0.3.10 = common RAW + preuves cross-source
|
0.3.10 = common RAW + preuves cross-source
|
||||||
0.3.11 = fondation Worker source-neutral, persistence et observabilité
|
0.3.11 = fondation Worker source-neutral, persistence et observabilité
|
||||||
0.3.12 à 0.3.14 = sources live multi-source, continuité et hardening par responsabilités bornées
|
0.3.12 = première verticale Yellowstone + hydration/replay continuity
|
||||||
|
0.3.13 = cinq familles live + convergence/fairness/health/shutdown/completeness
|
||||||
0.3.16 = Job Backfill multi-stratégie historique
|
0.3.16 = Job Backfill multi-stratégie historique
|
||||||
```
|
```
|
||||||
|
|
||||||
|
|||||||
@@ -1,5 +1,5 @@
|
|||||||
<!-- file: docs/plans/002-FUNCTIONAL_RELEASE_SEQUENCE.md -->
|
<!-- file: docs/plans/002-FUNCTIONAL_RELEASE_SEQUENCE.md -->
|
||||||
<!-- version: 98 -->
|
<!-- version: 99 -->
|
||||||
|
|
||||||
# Séquence des releases fonctionnelles KSP
|
# Séquence des releases fonctionnelles KSP
|
||||||
|
|
||||||
@@ -583,7 +583,9 @@ La séquence effective a évolué par sizing et validation réels. La référenc
|
|||||||
0.3.9 ksp-worker-api + audit acquisition RawTransaction
|
0.3.9 ksp-worker-api + audit acquisition RawTransaction
|
||||||
0.3.10 common ksp-raw-transaction-lib + preuves cross-source
|
0.3.10 common ksp-raw-transaction-lib + preuves cross-source
|
||||||
0.3.11 fondation source-neutral ksp-worker-raw-transaction-ingest-lib
|
0.3.11 fondation source-neutral ksp-worker-raw-transaction-ingest-lib
|
||||||
0.3.12-0.3.14 sources live, convergence et continuité Worker RAW ingest
|
0.3.12 première verticale live Yellowstone + hydration/replay continuity
|
||||||
|
0.3.13 cinq familles live + convergence multi-source/fairness/health/hardening
|
||||||
|
0.3.14 tranche suivante de la trajectoire RAW selon prompt dédié
|
||||||
0.3.15 ksp-app-raw-transaction-ingest-desk
|
0.3.15 ksp-app-raw-transaction-ingest-desk
|
||||||
0.3.16 Backfill multi-source / multi-stratégie
|
0.3.16 Backfill multi-source / multi-stratégie
|
||||||
```
|
```
|
||||||
|
|||||||
1719
docs/plans/034-V0_3_13_MULTI_SOURCE_LIVE_CONVERGENCE_PLAN.md
Normal file
1719
docs/plans/034-V0_3_13_MULTI_SOURCE_LIVE_CONVERGENCE_PLAN.md
Normal file
File diff suppressed because it is too large
Load Diff
@@ -1,5 +1,5 @@
|
|||||||
<!-- file: docs/rules/RULES_KSP.md -->
|
<!-- file: docs/rules/RULES_KSP.md -->
|
||||||
<!-- version: 41 -->
|
<!-- version: 42 -->
|
||||||
|
|
||||||
# Règles spécifiques à KSP
|
# Règles spécifiques à KSP
|
||||||
|
|
||||||
@@ -45,8 +45,8 @@
|
|||||||
- **KSP-CONFIG-015** — L'environnement du processus reste read-only. La surface management peut créer/modifier/supprimer uniquement des entrées KSP/KSPB du `.env`; chaque mutation rapporte séparément changement de source persistée, changement effectif courant, shadowing par le process et besoin de reload.
|
- **KSP-CONFIG-015** — L'environnement du processus reste read-only. La surface management peut créer/modifier/supprimer uniquement des entrées KSP/KSPB du `.env`; chaque mutation rapporte séparément changement de source persistée, changement effectif courant, shadowing par le process et besoin de reload.
|
||||||
- **KSP-CONFIG-016** — Les rapports management ordinaires n'exposent que des valeurs sûres/redacted. L'accès en clair à une valeur d'environnement passe par un appel `reveal_*` explicite; l'authentification/autorisation de l'utilisateur final appartient à l'application et cette révélation n'autorise jamais le secret dans les logs/`Debug`/diagnostics génériques.
|
- **KSP-CONFIG-016** — Les rapports management ordinaires n'exposent que des valeurs sûres/redacted. L'accès en clair à une valeur d'environnement passe par un appel `reveal_*` explicite; l'authentification/autorisation de l'utilisateur final appartient à l'application et cette révélation n'autorise jamais le secret dans les logs/`Debug`/diagnostics génériques.
|
||||||
- **KSP-CONFIG-017** — Les frontières d'ownership Config sont vérifiées par des audits exécutables du workspace : Core/Logging ne dépendent pas de Config, les crates hors `ksp-config-lib` ne lisent pas directement les variables KSP/KSPB via `std::env::var*`/énumération de l'environnement et ne codent pas en dur les noms physiques des fichiers gérés lorsqu'un contrat Config existe.
|
- **KSP-CONFIG-017** — Les frontières d'ownership Config sont vérifiées par des audits exécutables du workspace : Core/Logging ne dépendent pas de Config, les crates hors `ksp-config-lib` ne lisent pas directement les variables KSP/KSPB via `std::env::var*`/énumération de l'environnement et ne codent pas en dur les noms physiques des fichiers gérés lorsqu'un contrat Config existe.
|
||||||
- **KSP-CONFIG-018** — Dans un runtime desktop packagé, `ksp-config-lib` possède la préparation de la racine KSP writable à partir des resources applicatives : les documents Config packagés ne sont seedés que lorsqu'ils sont absents, les JSON Schemas possédés par le package courant sont resynchronisés à chaque lancement, et `.env` n'est jamais embarqué ni seedé. La localisation physique writable est résolue par une primitive plateforme dédiée et n'est pas codée en dur dans les applications.
|
|
||||||
- **KSP-CONFIG-018** — L'inventaire `.env.example` est vérifié automatiquement contre les variables KSP/KSPB concrètes utilisées par les JSON sous `config/` et le code Rust production. Toute clé runtime détectée doit posséder une entrée d'inventaire précédée d'un commentaire explicatif.
|
- **KSP-CONFIG-018** — L'inventaire `.env.example` est vérifié automatiquement contre les variables KSP/KSPB concrètes utilisées par les JSON sous `config/` et le code Rust production. Toute clé runtime détectée doit posséder une entrée d'inventaire précédée d'un commentaire explicatif.
|
||||||
|
- **KSP-CONFIG-019** — Dans un runtime desktop packagé, `ksp-config-lib` possède la préparation de la racine KSP writable à partir des resources applicatives : les documents Config packagés ne sont seedés que lorsqu'ils sont absents, les JSON Schemas possédés par le package courant sont resynchronisés à chaque lancement, et `.env` n'est jamais embarqué ni seedé. La localisation physique writable est résolue par une primitive plateforme dédiée et n'est pas codée en dur dans les applications.
|
||||||
|
|
||||||
## Programmes et exécution
|
## Programmes et exécution
|
||||||
|
|
||||||
|
|||||||
1785
docs/validation/030-V0_3_13_MULTI_SOURCE_LIVE_CONVERGENCE.md
Normal file
1785
docs/validation/030-V0_3_13_MULTI_SOURCE_LIVE_CONVERGENCE.md
Normal file
File diff suppressed because it is too large
Load Diff
@@ -1,5 +1,5 @@
|
|||||||
<!-- file: prompts/032-V0_3_13_START_PROMPT.md -->
|
<!-- file: prompts/032-V0_3_13_START_PROMPT.md -->
|
||||||
<!-- version: 1 -->
|
<!-- version: 2 -->
|
||||||
|
|
||||||
# Prompt de démarrage `0.3.13` — WS standard / Helius / HTTP live + convergence multi-source du Worker `RawTransaction`
|
# Prompt de démarrage `0.3.13` — WS standard / Helius / HTTP live + convergence multi-source du Worker `RawTransaction`
|
||||||
|
|
||||||
@@ -555,7 +555,7 @@ Si Config/profils Helius sont modifiés :
|
|||||||
cargo test -p ksp-config-lib
|
cargo test -p ksp-config-lib
|
||||||
```
|
```
|
||||||
|
|
||||||
Graphes à maintenir/auditer :
|
Graphes à auditer uniquement si le graphe de dépendances/features change, ou à la fermeture technique :
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
cargo tree -p ksp-worker-raw-transaction-ingest-lib --edges normal
|
cargo tree -p ksp-worker-raw-transaction-ingest-lib --edges normal
|
||||||
|
|||||||
668
prompts/033-V0_3_14_START_PROMPT.md
Normal file
668
prompts/033-V0_3_14_START_PROMPT.md
Normal file
@@ -0,0 +1,668 @@
|
|||||||
|
<!-- file: prompts/033-V0_3_14_START_PROMPT.md -->
|
||||||
|
<!-- version: 2 -->
|
||||||
|
|
||||||
|
# Prompt de démarrage `0.3.14` — gap repair / hardening multi-source du Worker `RawTransaction`
|
||||||
|
|
||||||
|
## 1. Identité de la release et base exacte requise
|
||||||
|
|
||||||
|
Ouvrir **uniquement** `0.3.14` depuis la release stable/taggée :
|
||||||
|
|
||||||
|
```text
|
||||||
|
v0.3.13
|
||||||
|
```
|
||||||
|
|
||||||
|
La base de travail fournie par l'opérateur est autoritaire sur les souvenirs, snippets, anciennes archives et deltas intermédiaires. Avant toute modification, vérifier au minimum :
|
||||||
|
|
||||||
|
```text
|
||||||
|
workspace.package.version = 0.3.13
|
||||||
|
deltas/0.3.13/rel.001.md présent
|
||||||
|
ksp-worker-raw-transaction-ingest-lib présent avec composition 1..32 sources d'un même réseau
|
||||||
|
cinq familles live productives présentes : Yellowstone / Standard Logs / Standard Block / Helius Transaction / HTTP Block Polling
|
||||||
|
Yellowstone / Standard Logs / Helius partagent l'hydration globale getTransaction observed
|
||||||
|
Standard Block / HTTP Block Polling restent RAW-direct sur Legacy/V0/V1 qualifiés
|
||||||
|
convergence canonique network/signature + observations multiples + content conflict explicite
|
||||||
|
source failure encore terminale faute d'équivalence de coverage prouvée
|
||||||
|
processing frontier encore run-local, sans checkpoint durable ni campagne historique
|
||||||
|
Worker sans dépendance Config/Job/backend Store direct
|
||||||
|
ksp-store-lib reste la seule façade Store du Worker
|
||||||
|
```
|
||||||
|
|
||||||
|
Release ouverte :
|
||||||
|
|
||||||
|
```text
|
||||||
|
0.3.14
|
||||||
|
```
|
||||||
|
|
||||||
|
Première livraison attendue :
|
||||||
|
|
||||||
|
```text
|
||||||
|
0.3.14-pre.001
|
||||||
|
```
|
||||||
|
|
||||||
|
`pre.001` est obligatoirement un gate de **lecture + audit interne/externe + brainstorming + sizing + planification**. Il ne commence pas directement un moteur de repair, une politique degraded/failover ou un adapter EARLY. Si le périmètre réel n'est pas clôturable dans une seule session ou si une tranche paraît dépasser environ 15–20 minutes de travail effectif, rescinder avant l'implémentation lourde.
|
||||||
|
|
||||||
|
## 2. Mission et résultat attendu
|
||||||
|
|
||||||
|
### 2.1 Mission de `0.3.14`
|
||||||
|
|
||||||
|
Fermer le Worker continu `RawTransaction` par la **réparation de continuité limitée au run actif** et le hardening multi-source qui restaient volontairement hors `0.3.13` :
|
||||||
|
|
||||||
|
```text
|
||||||
|
replay natif lorsqu'il est réellement adressable par Transport/provider
|
||||||
|
preuve de couverture par source live redondante
|
||||||
|
scan HTTP de slots/blocs pour réparer une plage manquante du run
|
||||||
|
hydration getTransaction des références manquantes lorsque nécessaire
|
||||||
|
réconciliation explicite des gaps avant reprise normale
|
||||||
|
unresolved gaps observables et bornés
|
||||||
|
politiques Healthy / Degraded / Unhealthy / Faulted fondées sur des preuves de coverage
|
||||||
|
backpressure/fairness pendant repair
|
||||||
|
shutdown/fault pendant replay/scan/hydration/persistence
|
||||||
|
smokes provider réellement accessibles
|
||||||
|
adapter EARLY uniquement si pre.001 apporte une preuve actuelle suffisante et un périmètre borné
|
||||||
|
```
|
||||||
|
|
||||||
|
Le Worker ne devient pas un moteur historique paramétré. Une demande arbitraire telle que « récupère le programme X depuis le slot Y » reste la responsabilité indépendante de `ksp-job-backfill-lib` et de la trajectoire `0.3.16`.
|
||||||
|
|
||||||
|
### 2.2 Pipeline durable à préserver
|
||||||
|
|
||||||
|
Le chemin nominal `0.3.13` reste le cœur unique :
|
||||||
|
|
||||||
|
```text
|
||||||
|
source live
|
||||||
|
-> signal ou matériau source/protocole
|
||||||
|
-> hydration si nécessaire
|
||||||
|
-> ksp-raw-transaction-lib
|
||||||
|
-> RawTransaction + RawTransactionObservation
|
||||||
|
-> admission centrale Worker
|
||||||
|
-> ksp-store-lib
|
||||||
|
```
|
||||||
|
|
||||||
|
Le repair ajoute un chemin de continuité autour de ce cœur, pas un second pipeline :
|
||||||
|
|
||||||
|
```text
|
||||||
|
preuve de gap du run
|
||||||
|
-> qualification de la plage et des capabilities disponibles
|
||||||
|
-> replay Transport OU coverage redondante OU scan HTTP borné
|
||||||
|
-> hydration éventuelle
|
||||||
|
-> même Common RAW / même admission / même Store
|
||||||
|
-> preuve de réconciliation OU unresolved gap explicite
|
||||||
|
-> reprise live
|
||||||
|
```
|
||||||
|
|
||||||
|
Ordre architectural déjà acquis pour un gap du run, sous réserve des capabilities réellement prouvées :
|
||||||
|
|
||||||
|
```text
|
||||||
|
1. replay adressable du stream depuis le frontier connu
|
||||||
|
2. source live redondante ayant réellement couvert la plage
|
||||||
|
3. HTTP getBlock/getTransaction pour les slots/références manquants
|
||||||
|
4. reprise live après réconciliation
|
||||||
|
```
|
||||||
|
|
||||||
|
Aucune étape ne reçoit de requête historique arbitraire du caller.
|
||||||
|
|
||||||
|
## 3. Sources de vérité internes obligatoires — ordre de lecture
|
||||||
|
|
||||||
|
### 3.1 Gouvernance générale
|
||||||
|
|
||||||
|
Lire intégralement, dans cet ordre :
|
||||||
|
|
||||||
|
```text
|
||||||
|
RULES.md
|
||||||
|
ROADMAP.md
|
||||||
|
CHANGELOG.md
|
||||||
|
docs/000-README.md
|
||||||
|
|
||||||
|
docs/rules/RULES_GENERAL.md
|
||||||
|
docs/rules/RULES_KSP.md
|
||||||
|
docs/rules/RULES_RUST.md
|
||||||
|
docs/rules/RULES_DEPENDENCIES.md
|
||||||
|
docs/rules/RULES_DOCUMENTATION.md
|
||||||
|
docs/rules/FILE_CONTRACTS.md
|
||||||
|
docs/rules/VERSION_WORKFLOW.md
|
||||||
|
docs/rules/PROMPT_STRUCTURE.md
|
||||||
|
```
|
||||||
|
|
||||||
|
Le prompt complète ces règles ; il ne les remplace pas.
|
||||||
|
|
||||||
|
Rappels Rust bloquants :
|
||||||
|
|
||||||
|
```text
|
||||||
|
Rust 2024
|
||||||
|
unsafe interdit
|
||||||
|
unwrap / expect / panic interdits selon les règles KSP
|
||||||
|
? interdit en production
|
||||||
|
retours explicites ; clippy::implicit_return deny
|
||||||
|
#![warn(missing_docs)]
|
||||||
|
#![deny(unreachable_pub)]
|
||||||
|
#![forbid(unsafe_code)]
|
||||||
|
|
||||||
|
pas de pub mod
|
||||||
|
pub/pub(crate) partagés reexportés jusqu'à la crate root
|
||||||
|
accès partagés via crate::Item, y compris intra-crate
|
||||||
|
item strictement module-local => private
|
||||||
|
unit tests sous unit_tests/
|
||||||
|
integration tests sous tests/
|
||||||
|
```
|
||||||
|
|
||||||
|
Après toute modification Rust :
|
||||||
|
|
||||||
|
```bash
|
||||||
|
cargo fmt --all
|
||||||
|
python3 scripts/audit_rust_workspace_rules.py
|
||||||
|
cargo check --workspace
|
||||||
|
cargo clippy --workspace --all-targets
|
||||||
|
```
|
||||||
|
|
||||||
|
Pour tout Markdown touché :
|
||||||
|
|
||||||
|
```bash
|
||||||
|
python3 scripts/audit_markdown_tables.py README.md RULES.md ROADMAP.md CHANGELOG.md docs prompts crates deltas
|
||||||
|
```
|
||||||
|
|
||||||
|
Une commande non exécutée n'est jamais déclarée PASS.
|
||||||
|
|
||||||
|
### 3.2 Handoff stable `0.3.13`
|
||||||
|
|
||||||
|
Lire intégralement :
|
||||||
|
|
||||||
|
```text
|
||||||
|
docs/plans/034-V0_3_13_MULTI_SOURCE_LIVE_CONVERGENCE_PLAN.md
|
||||||
|
docs/validation/030-V0_3_13_MULTI_SOURCE_LIVE_CONVERGENCE.md
|
||||||
|
deltas/0.3.13/pre.013.md
|
||||||
|
deltas/0.3.13/pre.014.md
|
||||||
|
deltas/0.3.13/pre.015.md
|
||||||
|
deltas/0.3.13/rel.001.md
|
||||||
|
crates/ksp-worker-raw-transaction-ingest-lib/README.md
|
||||||
|
crates/ksp-worker-raw-transaction-ingest-lib/USAGE.md
|
||||||
|
crates/ksp-worker-raw-transaction-ingest-lib/src/
|
||||||
|
crates/ksp-worker-raw-transaction-ingest-lib/tests/
|
||||||
|
crates/ksp-worker-raw-transaction-ingest-lib/unit_tests/
|
||||||
|
```
|
||||||
|
|
||||||
|
La convergence multi-source `0.3.13` est une base à préserver, pas un prototype à remplacer.
|
||||||
|
|
||||||
|
### 3.3 Architecture RAW, continuité et séparation Worker/Job
|
||||||
|
|
||||||
|
Lire intégralement :
|
||||||
|
|
||||||
|
```text
|
||||||
|
docs/architecture/004-COMPONENT_INVENTORY.md
|
||||||
|
docs/architecture/005-DEPENDENCY_GRAPH.md
|
||||||
|
docs/architecture/009-ACQUISITION_WORKERS_AND_JOBS.md
|
||||||
|
docs/architecture/011-RAW_TRANSACTION_ACQUISITION.md
|
||||||
|
docs/plans/002-FUNCTIONAL_RELEASE_SEQUENCE.md
|
||||||
|
crates/ksp-job-backfill-lib/README.md
|
||||||
|
crates/ksp-job-backfill-lib/USAGE.md
|
||||||
|
crates/ksp-raw-transaction-lib/README.md
|
||||||
|
crates/ksp-raw-transaction-lib/USAGE.md
|
||||||
|
crates/ksp-store-api/src/
|
||||||
|
crates/ksp-store-lib/src/
|
||||||
|
```
|
||||||
|
|
||||||
|
Porter une attention particulière à :
|
||||||
|
|
||||||
|
```text
|
||||||
|
continuité Worker limitée au run courant
|
||||||
|
reconnect réussi != absence de gap
|
||||||
|
replay attempt != preuve de repair réussi
|
||||||
|
processing frontier != blockchain completeness
|
||||||
|
Store durable != coverage du réseau
|
||||||
|
Worker -X-> Job Backfill
|
||||||
|
Job Backfill -X-> Worker
|
||||||
|
aucun checkpoint partagé Worker/Job
|
||||||
|
même identité + même contenu -> idempotence + observations distinctes
|
||||||
|
même identité + contenu divergent -> content conflict explicite
|
||||||
|
```
|
||||||
|
|
||||||
|
### 3.4 Transport et capabilities de replay/repair
|
||||||
|
|
||||||
|
Lire au minimum :
|
||||||
|
|
||||||
|
```text
|
||||||
|
crates/ksp-onchain-transport-lib/Cargo.toml
|
||||||
|
crates/ksp-onchain-transport-lib/README.md
|
||||||
|
crates/ksp-onchain-transport-lib/USAGE.md
|
||||||
|
crates/ksp-onchain-transport-lib/src/yellowstone_*.rs
|
||||||
|
crates/ksp-onchain-transport-lib/src/ws_*.rs
|
||||||
|
crates/ksp-onchain-transport-lib/src/rpc_transactions.rs
|
||||||
|
crates/ksp-onchain-transport-lib/src/rpc_blocks.rs
|
||||||
|
crates/ksp-onchain-transport-lib/src/http_*.rs
|
||||||
|
crates/ksp-onchain-transport-lib/tests/
|
||||||
|
```
|
||||||
|
|
||||||
|
Réutiliser les sessions/actors Transport existants. Il est interdit de recréer dans le Worker :
|
||||||
|
|
||||||
|
```text
|
||||||
|
socket WebSocket bas niveau parallèle
|
||||||
|
client Yellowstone/Helius parallèle
|
||||||
|
client reqwest direct
|
||||||
|
reconnect/resubscribe actor concurrent
|
||||||
|
seconde boucle de retry autour des primitives Transport
|
||||||
|
SDK provider pour contourner Transport
|
||||||
|
```
|
||||||
|
|
||||||
|
Le Worker ne doit pas écrire arbitrairement `from_slot` ni interpréter un message provider brut lorsque Transport possède déjà la sémantique correspondante.
|
||||||
|
|
||||||
|
### 3.5 Config, providers et secrets
|
||||||
|
|
||||||
|
Lire :
|
||||||
|
|
||||||
|
```text
|
||||||
|
crates/ksp-config-lib/src/transport.rs
|
||||||
|
config/std.transport.json
|
||||||
|
config/examples/std.transport.example.json
|
||||||
|
config/schemas/std.transport.schema.json
|
||||||
|
.env.example
|
||||||
|
```
|
||||||
|
|
||||||
|
Config reste l'unique propriétaire des endpoints, profils, capabilities et secrets. Le Worker ne lit jamais l'environnement et ne reçoit jamais une clé API comme payload métier.
|
||||||
|
|
||||||
|
Une modification Config n'est autorisée que si `pre.001` prouve un besoin réel non satisfait par les profils existants. Aucun tier, quota ou prix provider n'est codé dans le Worker.
|
||||||
|
|
||||||
|
## 4. Sources externes normatives et fraîcheur à réauditer
|
||||||
|
|
||||||
|
Au début de `pre.001`, réauditer les surfaces courantes depuis les sources primaires réellement actuelles :
|
||||||
|
|
||||||
|
```text
|
||||||
|
Solana RPC / WebSocket
|
||||||
|
getSlot
|
||||||
|
getBlocks / getBlocksWithLimit
|
||||||
|
getBlock
|
||||||
|
getTransaction
|
||||||
|
logsSubscribe / blockSubscribe et sémantique de reconnexion pertinente
|
||||||
|
|
||||||
|
Yellowstone gRPC upstream
|
||||||
|
Subscribe
|
||||||
|
from_slot
|
||||||
|
SubscribeReplayInfo / first_available lorsque présents dans la version réellement utilisée
|
||||||
|
limites et sémantique de replay réellement exposées
|
||||||
|
|
||||||
|
Providers réellement candidats/configurés
|
||||||
|
profondeur de replay actuelle
|
||||||
|
réseaux disponibles
|
||||||
|
auth/tier/quota actuels
|
||||||
|
comportement de first_available / rétention
|
||||||
|
éventuelles APIs historiques distinctes du live
|
||||||
|
|
||||||
|
Helius et autres surfaces EARLY seulement si elles sont réellement reconsidérées
|
||||||
|
matériau disponible
|
||||||
|
finalité/exécution prouvable
|
||||||
|
nécessité d'hydration
|
||||||
|
disponibilité/tier actuel
|
||||||
|
```
|
||||||
|
|
||||||
|
Les prix, profondeurs de replay, quotas et entitlements historiques de `docs/architecture/011-RAW_TRANSACTION_ACQUISITION.md` sont des traces datées, pas des constantes à recopier sans revalidation.
|
||||||
|
|
||||||
|
Si les crates/projets primaires concernés ont évolué, vérifier leurs versions stables courantes, features nécessaires et contraintes transitives avant toute modification.
|
||||||
|
|
||||||
|
## 5. État validé à préserver
|
||||||
|
|
||||||
|
La base stable `0.3.13` apporte déjà :
|
||||||
|
|
||||||
|
```text
|
||||||
|
RawTransactionIngestRuntimeResources : 1..32 sources logiques, même réseau, identités uniques
|
||||||
|
Yellowstone productive
|
||||||
|
Standard Logs -> getTransaction observed -> Common RAW
|
||||||
|
Standard Block -> RAW-direct Legacy/V0/V1 qualifié
|
||||||
|
Helius Transaction -> getTransaction observed -> Common RAW
|
||||||
|
HTTP Block Polling -> RAW-direct Legacy/V0/V1, borne initiale du run
|
||||||
|
registre global d'hydration Yellowstone / Standard Logs / Helius
|
||||||
|
coalescence network/signature/commitment avant hydration
|
||||||
|
sérialisation run-local des acquisitions network/signature
|
||||||
|
observations multiples conservées
|
||||||
|
content conflict explicite sans majorité ni first-provider-wins
|
||||||
|
quotas/backpressure/fairness bornés
|
||||||
|
health source-neutral conservative
|
||||||
|
shutdown/fault/drain/abort/join bornés
|
||||||
|
```
|
||||||
|
|
||||||
|
Le gate technique `0.3.13` a qualifié le workspace déterministe et les smokes keyless HTTP/WebSocket Devnet. Les smokes provider/token/resource-gated non exécutés restent non exécutés ; `0.3.14` ne doit pas les réécrire comme PASS sans nouveau résultat réel.
|
||||||
|
|
||||||
|
État de continuité à l'ouverture :
|
||||||
|
|
||||||
|
```text
|
||||||
|
reconnect/replay natif reste Transport-owned
|
||||||
|
processing_frontier_slot reste run-local
|
||||||
|
continuity gap prouvé reste terminal dans 0.3.13
|
||||||
|
aucune preuve de coverage équivalent entre sources n'autorise encore un failover non terminal
|
||||||
|
aucun moteur HTTP de repair rétroactif du run n'est encore fermé
|
||||||
|
aucun unresolved-gap model public final n'est encore stabilisé
|
||||||
|
aucun adapter EARLY n'est retenu par défaut
|
||||||
|
```
|
||||||
|
|
||||||
|
## 6. Décisions acquises et questions réellement ouvertes
|
||||||
|
|
||||||
|
### 6.1 Décisions acquises
|
||||||
|
|
||||||
|
```text
|
||||||
|
repair Worker = continuité de son run actif uniquement
|
||||||
|
Backfill = historique paramétré/borné indépendant
|
||||||
|
aucune dépendance Worker <-> Job Backfill
|
||||||
|
Transport possède reconnect/resubscribe/retry et replay natif qu'il sait adresser
|
||||||
|
Worker possède la réconciliation source-neutral de ses gaps observés
|
||||||
|
Common RAW et Store restent le chemin unique de matérialisation/persistence
|
||||||
|
content conflict reste terminal et explicite
|
||||||
|
une source redondante ne prouve un repair que si sa coverage de la plage est démontrée
|
||||||
|
un skipped/non-produced slot ne doit pas être inventé comme transaction manquante
|
||||||
|
un gap non réparé doit rester visible et ne peut pas être effacé par une reprise live
|
||||||
|
aucun exactly-once blockchain n'est revendiqué
|
||||||
|
```
|
||||||
|
|
||||||
|
### 6.2 Questions ouvertes à fermer en `pre.001`
|
||||||
|
|
||||||
|
```text
|
||||||
|
forme minimale du gap/range run-local et de son identité
|
||||||
|
preuve de coverage par famille de source sans exposer le matériau provider
|
||||||
|
preuve qu'un replay Transport a réellement couvert la plage demandée
|
||||||
|
traitement exact des skipped slots et slots temporairement indisponibles
|
||||||
|
bornes de scan HTTP et politique de retry sans doubler Transport
|
||||||
|
critère atomique « repaired » vs « unresolved »
|
||||||
|
interaction entre repair et processing frontier existante
|
||||||
|
politique required/redundant et transitions Healthy/Degraded/Unhealthy/Faulted
|
||||||
|
priorité entre plusieurs mécanismes de repair simultanément disponibles
|
||||||
|
quotas/fairness entre trafic nominal et trafic de repair
|
||||||
|
projection snapshot des gaps sans fuite d'identité provider sensible
|
||||||
|
smokes réellement possibles avec les ressources opérateur
|
||||||
|
EARLY : rejet confirmé ou adapter dédié réellement justifié/provable
|
||||||
|
```
|
||||||
|
|
||||||
|
Une question ouverte n'est pas résolue arbitrairement avant l'audit.
|
||||||
|
|
||||||
|
## 7. Objectifs, livrables et hors périmètre
|
||||||
|
|
||||||
|
### 7.1 Livrables de release
|
||||||
|
|
||||||
|
`0.3.14` doit aboutir, selon le sizing validé, à :
|
||||||
|
|
||||||
|
```text
|
||||||
|
modèle source-neutral de gap/coverage run-local
|
||||||
|
repair par replay natif lorsque Transport le prouve adressable
|
||||||
|
repair par source redondante lorsque sa coverage est démontrée
|
||||||
|
repair HTTP borné par slots/blocs/références du run
|
||||||
|
hydration de réparation via les façades Transport existantes
|
||||||
|
réconciliation explicite repaired/unresolved avant reprise
|
||||||
|
health policy multi-source fondée sur coverage réelle
|
||||||
|
backpressure/fairness bornés avec trafic de repair
|
||||||
|
observabilité source-neutral des gaps et repairs
|
||||||
|
shutdown/fault déterministe pendant toute phase de repair
|
||||||
|
canaris cross-layer/security/completeness
|
||||||
|
smokes réellement accessibles ou statut NON EXÉCUTÉ explicite
|
||||||
|
plan/validation/documentation réconciliés
|
||||||
|
prompt 0.3.15 dans la dernière prerelease
|
||||||
|
```
|
||||||
|
|
||||||
|
### 7.2 Hors périmètre
|
||||||
|
|
||||||
|
```text
|
||||||
|
campagne historique arbitraire pilotée par le Worker
|
||||||
|
appel ou orchestration automatique de ksp-job-backfill-lib
|
||||||
|
checkpoint durable partagé Worker/Job
|
||||||
|
Backfill multi-source/multi-stratégie 0.3.16
|
||||||
|
ksp-app-raw-transaction-ingest-desk 0.3.15
|
||||||
|
persistence STRUCTURAL/DECODED/DOMAIN
|
||||||
|
exactly-once réseau/provider
|
||||||
|
majorité provider ou overwrite d'un content conflict
|
||||||
|
second actor/client Transport dans Worker
|
||||||
|
provider SDK contournant ksp-onchain-transport-lib
|
||||||
|
nouveau système de secrets hors Config
|
||||||
|
EARLY sans preuve actuelle suffisante
|
||||||
|
```
|
||||||
|
|
||||||
|
## 8. Contraintes sécurité / API / architecture spécifiques
|
||||||
|
|
||||||
|
Les frontières suivantes sont bloquantes :
|
||||||
|
|
||||||
|
```text
|
||||||
|
Worker -> ksp-onchain-transport-lib : autorisé
|
||||||
|
Worker -> ksp-raw-transaction-lib : autorisé
|
||||||
|
Worker -> ksp-store-lib : autorisé
|
||||||
|
Worker -> ksp-config-lib : interdit
|
||||||
|
Worker -> ksp-job-backfill-lib : interdit
|
||||||
|
Worker -> backend Store physique : interdit
|
||||||
|
Worker -> reqwest/tokio-tungstenite/tonic/proto provider direct : interdit
|
||||||
|
```
|
||||||
|
|
||||||
|
Le caller compose les ressources déjà résolues. Le Worker ne reçoit ni endpoint brut non validé, ni token, ni API key comme paramètre métier.
|
||||||
|
|
||||||
|
Le repair doit être borné en mémoire, nombre de ranges, taille de plage, nombre de requêtes simultanées, hydrations in-flight et files d'attente. Toute nouvelle borne publique possède validation, tests de limites et diagnostics redacted.
|
||||||
|
|
||||||
|
Une source perdue ne devient pas silencieusement optionnelle. Toute transition non terminale après perte d'une source doit être justifiée par une preuve explicite que les autres mécanismes couvrent réellement le même intervalle pertinent.
|
||||||
|
|
||||||
|
Un mécanisme de repair ne contourne jamais l'idempotence/conflit Store : tout matériau réparé repasse par Common RAW et l'admission centrale.
|
||||||
|
|
||||||
|
## 9. Première mission `pre.001` — audit / brainstorming / sizing
|
||||||
|
|
||||||
|
`pre.001` doit exécuter et documenter, avant codage lourd :
|
||||||
|
|
||||||
|
1. vérification exacte de la base stable `v0.3.13` et de `deltas/0.3.13/rel.001.md` ;
|
||||||
|
2. lecture complète des sources internes listées ci-dessus ;
|
||||||
|
3. inventaire du modèle actuel de frontier/reconnect/replay/continuity counters dans Worker et Transport ;
|
||||||
|
4. audit externe courant Solana/Yellowstone/providers réellement concernés ;
|
||||||
|
5. matrice par famille live : capacité à détecter un gap, rejouer, prouver coverage, hydrater, scanner, reprendre ;
|
||||||
|
6. distinction formelle reconnect / replay attempt / replay covered / repair / unresolved gap ;
|
||||||
|
7. modèle cible minimal de gap/range/coverage run-local, privé ou public selon consumer réel ;
|
||||||
|
8. algorithme borné de sélection du mécanisme de repair sans campagne historique ;
|
||||||
|
9. sémantique skipped slots / missing block / Missing transaction / provider retention ;
|
||||||
|
10. politique de concurrence entre trafic nominal et repair, avec backpressure/fairness ;
|
||||||
|
11. politique de health required/redundant et critères de retour à Healthy ;
|
||||||
|
12. threat model : reconnect storms, overlapping gaps, stale redundant source, replay truncation, HTTP holes, duplicate repair, content disagreement, slow Store, stop/fault pendant repair ;
|
||||||
|
13. inventaire des smokes provider réellement accessibles avec les ressources opérateur ;
|
||||||
|
14. décision explicite sur EARLY : hors scope confirmé ou tranche dédiée justifiée par preuve ;
|
||||||
|
15. graphes Cargo/features cibles et éventuels changements Transport/Config strictement nécessaires ;
|
||||||
|
16. sizing de chaque tranche sous le budget 15–20 minutes ;
|
||||||
|
17. décision explicite : maintien de `0.3.14` ou rescission avant codage ;
|
||||||
|
18. création du plan et de la validation de release.
|
||||||
|
|
||||||
|
Documents attendus :
|
||||||
|
|
||||||
|
```text
|
||||||
|
docs/plans/035-V0_3_14_MULTI_SOURCE_GAP_REPAIR_HARDENING_PLAN.md
|
||||||
|
docs/validation/031-V0_3_14_MULTI_SOURCE_GAP_REPAIR_HARDENING.md
|
||||||
|
```
|
||||||
|
|
||||||
|
Critère de sortie : aucun mécanisme de repair n'est implémenté tant que sa source de preuve du gap, sa plage, ses bornes, son propriétaire de retry/reconnect, son critère de succès et son échec unresolved ne sont pas définis.
|
||||||
|
|
||||||
|
## 10. Prévision souple initiale des prereleases
|
||||||
|
|
||||||
|
Cette prévision est un point de départ à recalibrer par `pre.001`.
|
||||||
|
|
||||||
|
### `pre.001` — audit / brainstorming / sizing
|
||||||
|
|
||||||
|
Base stable, audit replay/coverage/provider courant, modèle gap/range, stratégie repair, health, threat model, smokes, graphes, plan/validation et décision de maintien/rescission.
|
||||||
|
|
||||||
|
### `pre.002` — contrats gap / range / coverage
|
||||||
|
|
||||||
|
Stabiliser les identités et invariants run-local nécessaires à la réparation, avec bornes et distinction repaired/unresolved, sans encore lancer tous les mécanismes.
|
||||||
|
|
||||||
|
### `pre.003` — replay natif + coverage redondante
|
||||||
|
|
||||||
|
Intégrer la preuve source-neutral d'un replay Transport réellement exploitable et la preuve de couverture par une source redondante, sans faire écrire `from_slot` au Worker ni supposer l'équivalence des sources.
|
||||||
|
|
||||||
|
### `pre.004` — scan HTTP de réparation
|
||||||
|
|
||||||
|
Réparer une plage du run via les primitives HTTP Transport existantes, avec découverte de slots/blocs bornée, skipped slots explicites et aucune plage historique arbitraire.
|
||||||
|
|
||||||
|
### `pre.005` — hydration de réparation
|
||||||
|
|
||||||
|
Fermer les références/signatures manquantes via `getTransaction observed`, partager les bornes/coalescences pertinentes et conserver Common RAW comme unique canonicalizer.
|
||||||
|
|
||||||
|
### `pre.006` — réconciliation et reprise live
|
||||||
|
|
||||||
|
Unifier replay/redondance/HTTP/hydration dans une machine de réparation run-local qui ne reprend le nominal qu'après preuve repaired ou publie unresolved/fault selon la politique décidée.
|
||||||
|
|
||||||
|
### `pre.007` — health policy multi-source
|
||||||
|
|
||||||
|
Fermer les rôles required/redundant réellement justifiés, les transitions Healthy/Degraded/Unhealthy/Faulted et les conditions de récupération sans masquer une perte de coverage.
|
||||||
|
|
||||||
|
### `pre.008` — backpressure et fairness pendant repair
|
||||||
|
|
||||||
|
Borner ranges, scans, hydrations et persistence sous concurrence avec le trafic nominal ; prévenir starvation, duplicate storms et repair fanout non borné.
|
||||||
|
|
||||||
|
### `pre.009` — snapshots / observabilité gaps et repair
|
||||||
|
|
||||||
|
Projeter uniquement les dimensions source-neutral nécessaires : gaps détectés, pending/repaired/unresolved, activité de repair, health et compteurs checked, sans payload provider sensible.
|
||||||
|
|
||||||
|
### `pre.010` — races / shutdown hardening
|
||||||
|
|
||||||
|
Stop/fault pendant replay, coverage wait, scan HTTP, hydration, admission et persistence ; tâches orphelines, deadlines, abort+join, counters et terminalité.
|
||||||
|
|
||||||
|
Si `pre.001` retient réellement une source EARLY, insérer **une tranche dédiée avant le gate de completeness**. Ne pas la mélanger à un fix ou à une tranche de fermeture. Si aucune preuve suffisante n'existe, EARLY reste hors release sans prerelease artificielle.
|
||||||
|
|
||||||
|
### `pre.011` — completeness/security cross-layer
|
||||||
|
|
||||||
|
Canaris Worker/Transport/Common RAW/Store, dépendances, API publique, redaction, Legacy/V0/V1, non-régression des cinq familles `0.3.13` et preuves de non-confusion Worker/Backfill.
|
||||||
|
|
||||||
|
### `pre.012` — gate technique/live
|
||||||
|
|
||||||
|
Workspace complet, Clippy strict, suites ciblées, graphes/duplicates et smokes réellement accessibles. Aucun nouveau scope.
|
||||||
|
|
||||||
|
### `pre.013` — réconciliation documentaire
|
||||||
|
|
||||||
|
README/USAGE, plan, validation et architectures/références réellement affectées. Pas de CHANGELOG/ROADMAP/prompt suivant.
|
||||||
|
|
||||||
|
### `pre.014` — préparation publication
|
||||||
|
|
||||||
|
Prompt `0.3.15`, CHANGELOG, ROADMAP et fichiers mécaniques uniquement.
|
||||||
|
|
||||||
|
### `rel.001`
|
||||||
|
|
||||||
|
Publication stable mécanique après gate validé.
|
||||||
|
|
||||||
|
Le forecast peut être allongé par une tranche EARLY réellement justifiée, des fixes ou des tranches dédiées ; il ne doit jamais être compressé en mélangeant les responsabilités de fermeture.
|
||||||
|
|
||||||
|
## 11. Versionnement, deltas, commits et tags
|
||||||
|
|
||||||
|
Règles obligatoires :
|
||||||
|
|
||||||
|
```text
|
||||||
|
livraison prerelease : 0.3.14-pre.NNN
|
||||||
|
Cargo : 0.3.14-pre.N
|
||||||
|
fix : 0.3.14-pre.N.fix.M
|
||||||
|
delta : deltas/0.3.14/pre.NNN.md ou pre.NNN-fix.NNN.md
|
||||||
|
commit : v0.3.14-pre.NNN[-fix.NNN]
|
||||||
|
tag prerelease : aucun
|
||||||
|
tag stable final : v0.3.14 seulement après rel.001 validée
|
||||||
|
```
|
||||||
|
|
||||||
|
Toute prerelease non-fix synchronise `workspace.package.version`, même documentaire. Une correction strictement doc-only portée par un fix ne bump pas la version Cargo racine. Tout fichier modifié incrémente son header de version selon les règles du dépôt.
|
||||||
|
|
||||||
|
Les archives d'échange restent des deltas minimaux.
|
||||||
|
|
||||||
|
## 12. Procédure d'application et validation opérateur
|
||||||
|
|
||||||
|
Après application d'un delta technique :
|
||||||
|
|
||||||
|
```bash
|
||||||
|
cargo fmt --all -- --check
|
||||||
|
python3 scripts/audit_rust_workspace_rules.py
|
||||||
|
python3 scripts/audit_markdown_tables.py README.md RULES.md ROADMAP.md CHANGELOG.md docs prompts crates deltas
|
||||||
|
cargo check --workspace
|
||||||
|
cargo clippy --workspace --all-targets --all-features -- -D warnings
|
||||||
|
```
|
||||||
|
|
||||||
|
Puis exécuter les tests ciblés de la tranche. Si un gate devient rouge, produire un fix strictement rattaché à la responsabilité fautive avant d'avancer.
|
||||||
|
|
||||||
|
Aucune commande non exécutée ne peut être déclarée PASS.
|
||||||
|
|
||||||
|
## 13. Validations Rust / Transport / Config / live / graphes pertinentes
|
||||||
|
|
||||||
|
Selon les couches modifiées :
|
||||||
|
|
||||||
|
```bash
|
||||||
|
cargo test -p ksp-worker-raw-transaction-ingest-lib
|
||||||
|
cargo test -p ksp-onchain-transport-lib
|
||||||
|
cargo test -p ksp-raw-transaction-lib
|
||||||
|
cargo test -p ksp-store-api
|
||||||
|
cargo test -p ksp-store-lib --no-default-features
|
||||||
|
```
|
||||||
|
|
||||||
|
Si Config/profils provider sont réellement modifiés :
|
||||||
|
|
||||||
|
```bash
|
||||||
|
cargo test -p ksp-config-lib
|
||||||
|
```
|
||||||
|
|
||||||
|
Graphes à auditer si le graphe de dépendances/features change, et à la fermeture technique :
|
||||||
|
|
||||||
|
```bash
|
||||||
|
cargo tree -p ksp-worker-raw-transaction-ingest-lib --edges normal
|
||||||
|
cargo tree -p ksp-worker-raw-transaction-ingest-lib -e features
|
||||||
|
cargo tree --duplicates
|
||||||
|
```
|
||||||
|
|
||||||
|
À la fermeture technique :
|
||||||
|
|
||||||
|
```bash
|
||||||
|
cargo test --workspace --all-targets --all-features
|
||||||
|
```
|
||||||
|
|
||||||
|
Smokes live possibles uniquement après audit `pre.001` et lorsqu'ils sont réellement provisionnés :
|
||||||
|
|
||||||
|
```text
|
||||||
|
Solana HTTP Devnet
|
||||||
|
Solana WebSocket Devnet
|
||||||
|
Yellowstone provider avec replay/from_slot si credential/tier/rétention disponibles
|
||||||
|
Helius transactionSubscribe si credential/tier disponible
|
||||||
|
blockSubscribe provider réellement accessible
|
||||||
|
Worker repair end-to-end vers Store sur environnement de test approprié
|
||||||
|
source redondante réellement composée si deux voies comparables sont disponibles
|
||||||
|
```
|
||||||
|
|
||||||
|
Un smoke indisponible est `NON EXÉCUTÉ`, pas PASS. Aucun secret n'est écrit dans une commande persistée, un log, un delta ou un fichier source.
|
||||||
|
|
||||||
|
## 14. Critères de clôture de `0.3.14`
|
||||||
|
|
||||||
|
La release peut se fermer lorsque :
|
||||||
|
|
||||||
|
```text
|
||||||
|
base multi-source 0.3.13 non régressée
|
||||||
|
gap du run possède identité/plage/bornes explicites
|
||||||
|
replay natif utilisé seulement lorsque Transport/provider le rend adressable et prouvable
|
||||||
|
coverage redondante ne vaut repair que si la plage est réellement démontrée
|
||||||
|
scan HTTP repair reste borné au run et ne devient pas Backfill
|
||||||
|
hydration de réparation repasse par Transport/Common RAW/admission/Store
|
||||||
|
skipped/missing/unavailable sont distingués sans invention de complétude
|
||||||
|
repaired et unresolved possèdent des critères explicites
|
||||||
|
reprise live n'efface jamais un unresolved gap
|
||||||
|
health policy ne masque pas une perte de coverage
|
||||||
|
backpressure/fairness restent bornés pendant repair
|
||||||
|
aucun second actor/client/retry Transport dans le Worker
|
||||||
|
aucun Worker -> Config/Job/backend physique
|
||||||
|
shutdown/fault pendant repair sans tâche orpheline ni late persistence
|
||||||
|
diagnostics redacted
|
||||||
|
EARLY absent ou réellement prouvé dans une tranche dédiée
|
||||||
|
fixtures/canaris cross-layer verts
|
||||||
|
smokes accessibles exécutés ou impossibilité qualifiée
|
||||||
|
gates workspace/clippy/tests/trees verts
|
||||||
|
documentation réconciliée
|
||||||
|
prompt 0.3.15 produit dans la dernière prerelease
|
||||||
|
```
|
||||||
|
|
||||||
|
## 15. Release suivante envisagée
|
||||||
|
|
||||||
|
`0.3.15` doit reprendre uniquement après publication stable de `0.3.14` et introduire :
|
||||||
|
|
||||||
|
```text
|
||||||
|
ksp-app-raw-transaction-ingest-desk
|
||||||
|
composition Config + Logging + Worker finalisé
|
||||||
|
sélection/supervision d'une ou plusieurs sources réellement admises
|
||||||
|
lifecycle start/stop
|
||||||
|
health et source state sûrs
|
||||||
|
rates/backpressure/reconnect/recovery/gap state
|
||||||
|
compteurs et diagnostics source-neutral
|
||||||
|
```
|
||||||
|
|
||||||
|
La Desk ne réimplémente ni discovery, hydration, déduplication, replay/repair, persistence ou logique provider. Elle reste une surface de composition/contrôle Tauri sur les APIs stables de la couche Worker/Config/Transport.
|
||||||
|
|
||||||
|
Elle doit réutiliser le gabarit Desk KSP courant : splash, fonts, style, dépendances frontend de base et tracing TypeScript des interactions significatives sans valeurs sensibles.
|
||||||
|
|
||||||
|
## 16. Instruction d'ouverture
|
||||||
|
|
||||||
|
Au début de la prochaine session :
|
||||||
|
|
||||||
|
1. vérifier que la base correspond exactement au tag stable `v0.3.13` et que `deltas/0.3.13/rel.001.md` est présent ;
|
||||||
|
2. lire les règles, le handoff `0.3.13`, l'architecture RAW acquisition et les sources Worker/Transport/Common/Store/Backfill/Config avant toute modification ;
|
||||||
|
3. réauditer les capacités actuelles Solana/Yellowstone/providers de replay, rétention et historique réellement adressable ;
|
||||||
|
4. produire `0.3.14-pre.001` avec matrice gap/replay/coverage/repair, threat model, health policy candidate, smokes accessibles, sizing, plan `035` et validation `031` ;
|
||||||
|
5. **ne pas coder de scan repair, failover/degraded policy, modification Transport/Config ni adapter EARLY avant fermeture de ce gate** ;
|
||||||
|
6. rescinder `0.3.14` immédiatement si le périmètre réel n'est pas clôturable dans une seule session.
|
||||||
Reference in New Issue
Block a user