v0.3.15-pre.008-fix.004

crates/ksp-app-raw-transaction-ingest-desk/README.md

@@ -1,5 +1,5 @@
 <!-- file: crates/ksp-app-raw-transaction-ingest-desk/README.md -->
-<!-- version: 8 -->
+<!-- version: 9 -->
 
 # `ksp-app-raw-transaction-ingest-desk`
 
@@ -50,6 +50,8 @@ Les profils standard publics committés déclarent `Block` en plus de `Logs`; `s
 
 Une route `Configured` est uniquement **composable depuis Config**. La disponibilité réelle du Store et du Worker est revalidée lors du Start avant publication de l'accusé runtime. Les états spontanés après Start ne sont pas encore streamés vers le frontend ; l'observabilité continue est ajoutée par la tranche monitoring dédiée.
 
+Pour `yellowstone-hydrated`, le Start utilise désormais le HTTP du **même profil Transport Yellowstone** que le gRPC. Sur Mainnet, le profil `publicnode_mainnet` hydrate donc via `https://solana-rpc.publicnode.com` au lieu de retomber sur `api.mainnet.solana.com`. Le profil PublicNode ne réutilise plus la limite locale Solana-public de `5 req/s`; il conserve une concurrence locale bornée et laisse les réponses `429` piloter le cooldown Transport. Cette correction ne supprime pas encore le coût structurel d'une hydration `getTransaction` par transaction : la réduction de cette dépendance, le pool HTTP multi-provider et le multi-route appartiennent à `pre.009`.
+
 ## Ports de développement
 
 ```text

crates/ksp-app-raw-transaction-ingest-desk/USAGE.md

@@ -1,5 +1,5 @@
 <!-- file: crates/ksp-app-raw-transaction-ingest-desk/USAGE.md -->
-<!-- version: 7 -->
+<!-- version: 8 -->
 
 # Utilisation de `ksp-app-raw-transaction-ingest-desk`
 
@@ -44,6 +44,8 @@ Un seul Worker peut être actif ou en démarrage dans cette tranche. Un second S
 
 Le frontend n'effectue aucun polling runtime continu dans cette tranche. Une terminaison spontanée est nettoyée côté backend ; sa projection temps réel vers l'UI appartient au monitoring ultérieur.
 
+Sur Mainnet, `yellowstone-hydrated` compose le gRPC et l'HTTP depuis la source `transport.yellowstone` déclarée par le composite. Avec le profil committé `publicnode_mainnet`, les notifications Yellowstone PublicNode sont donc hydratées par le RPC HTTP PublicNode du même profil. Ce mode reste une route hydratée : il peut encore être limité par le débit `getTransaction`. La combinaison de plusieurs endpoints HTTP/providers et le chemin Yellowstone direct sans hydration systématique sont volontairement reportés à `pre.009`.
+
 ## 3. Raisons d'indisponibilité
 
 Les reasons exposées sont des codes applicatifs bornés, par exemple :

crates/ksp-app-raw-transaction-ingest-desk/src/route_start.rs

@@ -1,5 +1,5 @@
 // file: crates/ksp-app-raw-transaction-ingest-desk/src/route_start.rs
-// version: 2
+// version: 3
 
 //! Start-time Config revalidation and exact Transport/Store resource reconstruction for route validation and runtime launch.
 
@@ -97,7 +97,7 @@ pub(crate) fn prepare_route_start(
     }
     let commitment = request.commitment.into_transport();
     let runtime_resources = match request.route_id {
-        crate::RawIngestRouteId::YellowstoneHydrated => prepare_yellowstone(management, &environment, &composite, &transport, network, commitment),
+        crate::RawIngestRouteId::YellowstoneHydrated => prepare_yellowstone(management, &environment, &composite, network, commitment),
         crate::RawIngestRouteId::StandardLogsHydrated => prepare_standard_logs(&transport, network, commitment),
         crate::RawIngestRouteId::StandardBlockDirect => prepare_standard_block(&transport, network, commitment),
         crate::RawIngestRouteId::HeliusTransactionHydrated => prepare_helius(management, &environment, &composite, &transport, network, commitment),
@@ -260,7 +260,6 @@ fn prepare_yellowstone(
     management: &ksp_config_lib::ConfigManagement,
     environment: &ksp_config_lib::ConfigEnvironment,
     composite: &ksp_config_lib::ResolvedConfigComposite,
-    base_transport: &ksp_config_lib::ResolvedTransportConfig,
     network: &str,
     commitment: ksp_onchain_transport_lib::SolanaCommitment,
 ) -> ksp_core_lib::Result<ksp_worker_raw_transaction_ingest_lib::RawTransactionIngestRuntimeResources> {
@@ -290,12 +289,12 @@ fn prepare_yellowstone(
         return std::result::Result::Err(error);
     }
     request.set_commitment(std::option::Option::Some(commitment));
-    let role = single_http_role(base_transport.http_settings(), network, &["getTransaction"]);
+    let role = single_http_role(transport.http_settings(), network, &["getTransaction"]);
     let role = match role {
         std::result::Result::Ok(value) => value,
         std::result::Result::Err(error) => return std::result::Result::Err(error),
     };
-    let pool = ksp_onchain_transport_lib::HttpTransportPool::new(base_transport.http_settings().clone());
+    let pool = ksp_onchain_transport_lib::HttpTransportPool::new(transport.http_settings().clone());
     let pool = match pool {
         std::result::Result::Ok(value) => value,
         std::result::Result::Err(error) => return std::result::Result::Err(error),

crates/ksp-app-raw-transaction-ingest-desk/tests/release_completeness.rs

@@ -1,5 +1,5 @@
 // file: crates/ksp-app-raw-transaction-ingest-desk/tests/release_completeness.rs
-// version: 6
+// version: 7
 
 //! Release-completeness canaries for Raw Transaction Ingest Desk Start-resource reconstruction.
 
@@ -106,3 +106,21 @@ fn pre_008_mono_route_slot_blocks_second_start_until_terminal_store_cleanup() {
         assert!(runtime.contains(required), "missing mono-route ownership marker {required}");
     }
 }
+
+#[test]
+fn pre_008_fix_004_yellowstone_hydration_uses_its_declared_transport_source_not_base_transport() {
+    let route_start = read_text(app_root().join("src/route_start.rs").as_path());
+    let start = route_start.find("fn prepare_yellowstone(");
+    let end = route_start.find("fn prepare_http_polling(");
+    assert!(start.is_some());
+    assert!(end.is_some());
+    let yellowstone = match (start, end) {
+        (std::option::Option::Some(start), std::option::Option::Some(end)) if start < end => &route_start[start..end],
+        _ => "",
+    };
+    assert!(yellowstone.contains("resolve_optional_transport"));
+    assert!(yellowstone.contains("COMPOSITE_COMPONENT_ID_TRANSPORT_YELLOWSTONE"));
+    assert!(yellowstone.contains("single_http_role(transport.http_settings(), network, &[\"getTransaction\"])"));
+    assert!(yellowstone.contains("HttpTransportPool::new(transport.http_settings().clone())"));
+    assert!(!yellowstone.contains("base_transport"));
+}

crates/ksp-config-lib/USAGE.md

@@ -1,5 +1,5 @@
 <!-- file: crates/ksp-config-lib/USAGE.md -->
-<!-- version: 18 -->
+<!-- version: 19 -->
 
 # Utilisation de ksp-config-lib
 
@@ -158,7 +158,7 @@ secret_metadata = metadata dont la valeur doit avoir une provenance KSP_SECRET_*
 
 `protocol` n'est pas un nouveau `WsProtocolKind` et ne transforme pas PublicNode en protocole. Config résout les placeholders, vérifie la classe de sensibilité des metadata puis construit `YellowstoneGrpcTransportSettings`. Transport ne lit jamais l'environnement. Les valeurs de `secret_metadata` sont disponibles au runtime mais redacted dans `safe_value` et dans les représentations `Debug`.
 
-Les profils versionnés `publicnode_mainnet` et `publicnode_testnet` représentent leurs endpoints Yellowstone sous la forme URL TLS requise par Transport et conservent le `x-token` dans `secret_metadata`. Ils restent des sources Transport network-scoped et ne définissent jamais l’identité du réseau applicatif.
+Les profils versionnés `publicnode_mainnet` et `publicnode_testnet` représentent leurs endpoints Yellowstone sous la forme URL TLS requise par Transport et conservent le `x-token` dans `secret_metadata`. Ils restent des sources Transport network-scoped et ne définissent jamais l’identité du réseau applicatif. `publicnode_mainnet` expose en plus le RPC HTTP Mainnet PublicNode utilisé par les consumers qui doivent hydrater une source Yellowstone same-provider ; ce rôle HTTP ne recopie pas une limite numérique Solana-public qui ne fait pas partie du contrat PublicNode committé.
 
 L'accesseur historique `into_transport_settings()` conserve volontairement son tuple `(HTTP, Option<WS>)`. Un consumer ayant besoin des trois backends utilise `into_all_transport_settings()` ou les accesseurs séparés afin de ne pas casser silencieusement les consumers V2.
 

crates/ksp-config-lib/unit_tests/transport.rs

@@ -1,5 +1,5 @@
 // file: crates/ksp-config-lib/unit_tests/transport.rs
-// version: 16
+// version: 17
 
 #[test]
 fn fixture_transport_profile_maps_complete_runtime_contract() {
@@ -273,6 +273,19 @@ fn committed_v3_publicnode_profiles_map_provider_neutral_yellowstone_grpc_with_n
             std::result::Result::Err(_) => continue,
         };
         assert_eq!(resolved.profile_id(), profile_id);
+        if profile_id == "publicnode_mainnet" {
+            assert_eq!(resolved.settings().endpoints().len(), 1);
+            let http = &resolved.settings().endpoints()[0];
+            assert_eq!(http.name(), "publicnode_solana_mainnet_rpc");
+            assert_eq!(http.provider().as_str(), "publicnode");
+            assert_eq!(http.cluster().as_str(), "mainnet");
+            assert_eq!(http.url().as_str(), "https://solana-rpc.publicnode.com");
+            assert_eq!(http.roles().len(), 1);
+            let limits = http.roles()[0].limits();
+            assert!(limits.requests_per_second().is_none());
+            assert!(limits.burst_capacity().is_none());
+            assert_eq!(limits.max_concurrent_requests().map(std::num::NonZeroU32::get), std::option::Option::Some(8));
+        }
         assert!(resolved.ws_settings().is_some());
         let grpc = resolved.grpc_settings();
         assert!(grpc.is_some(), "PublicNode profile {profile_id} should expose Yellowstone gRPC settings");