// file: crates/ksp-onchain-transport-lib/tests/yellowstone_publicnode_smoke.rs // version: 3 //! Opt-in live PublicNode Mainnet/Testnet smokes for authenticated provider-neutral Yellowstone gRPC Subscribe. use std::io::IsTerminal; // rust-rules: trait-import static PUBLICNODE_X_TOKEN: std::sync::OnceLock = std::sync::OnceLock::new(); fn publicnode_x_token() -> &'static str { return PUBLICNODE_X_TOKEN .get_or_init(|| { assert!( !std::io::stdin().is_terminal(), "pipe the PublicNode personal x-token to this ignored smoke on stdin; never pass it as a command-line argument" ); let mut token = std::string::String::new(); std::io::stdin().read_line(&mut token).expect("PublicNode x-token must be readable from smoke stdin"); let token = token.trim().to_owned(); assert!(!token.is_empty(), "PublicNode x-token provided on smoke stdin must not be empty"); return token; }) .as_str(); } fn publicnode_endpoint( name: &str, cluster: &str, url: &str, x_token: &str, ) -> ksp_core_lib::Result { let url = match ksp_onchain_transport_lib::YellowstoneGrpcEndpointUrl::parse(url) { std::result::Result::Ok(value) => value, std::result::Result::Err(error) => return std::result::Result::Err(error), }; let session = ksp_onchain_transport_lib::YellowstoneGrpcSessionSettings::new( std::time::Duration::from_secs(10), std::time::Duration::from_secs(10), std::time::Duration::from_secs(5), ksp_onchain_transport_lib::YellowstoneGrpcReconnectSettings::new(0, std::time::Duration::from_millis(250), std::time::Duration::from_secs(2)), 8, 8, 16 * 1024 * 1024, 4 * 1024 * 1024, ); let endpoint = ksp_onchain_transport_lib::YellowstoneGrpcEndpointSettings::new( name, true, ksp_onchain_transport_lib::YellowstoneGrpcProviderName::new("publicnode"), ksp_onchain_transport_lib::YellowstoneGrpcClusterName::new(cluster), url, session, ); let metadata = ksp_onchain_transport_lib::YellowstoneGrpcMetadataEntry::secret("x-token", x_token)?; return endpoint.with_metadata(vec![metadata]); } fn slot_request() -> ksp_core_lib::Result { let mut request = ksp_onchain_transport_lib::YellowstoneSubscribeRequest::new(); let name = match ksp_onchain_transport_lib::YellowstoneSubscribeFilterName::new("slots") { std::result::Result::Ok(value) => value, std::result::Result::Err(error) => return std::result::Result::Err(error), }; request.insert_slot_filter(name, ksp_onchain_transport_lib::YellowstoneSubscribeSlotFilter::new())?; return std::result::Result::Ok(request); } async fn assert_publicnode_slot_stream(name: &str, cluster: &str, url: &str) { let endpoint = publicnode_endpoint(name, cluster, url, publicnode_x_token()) .expect("programmatic PublicNode Yellowstone settings must accept secret x-token metadata"); let endpoint_debug = format!("{endpoint:?}"); assert!(!endpoint_debug.contains(publicnode_x_token()), "PublicNode x-token must not appear in endpoint Debug"); let channel = ksp_onchain_transport_lib::YellowstoneGrpcChannel::connect(&endpoint).await.expect("PublicNode Yellowstone TLS connection must succeed"); assert_eq!(channel.endpoint_name(), name); assert_eq!(channel.provider().as_str(), "publicnode"); assert_eq!(channel.cluster().as_str(), cluster); let request = slot_request().expect("PublicNode Yellowstone slot request must be valid"); let mut session = channel.open_standard_subscribe(request).await.expect("PublicNode Yellowstone authenticated Subscribe must open"); let slot = tokio::time::timeout(std::time::Duration::from_secs(20), async { loop { match session.next_update().await.expect("PublicNode Yellowstone Subscribe update must decode") { std::option::Option::Some(ksp_onchain_transport_lib::YellowstoneSubscribeUpdate::Slot(update)) => break update.slot(), std::option::Option::Some(_) => {}, std::option::Option::None => panic!("PublicNode Yellowstone Subscribe ended before a slot update"), } } }) .await .expect("PublicNode Yellowstone Subscribe must publish a slot update before the smoke deadline"); assert!(slot > 0); session.close().await.expect("PublicNode Yellowstone Subscribe must close cleanly"); } #[tokio::test(flavor = "current_thread")] #[ignore = "opt-in live PublicNode Mainnet Yellowstone gRPC smoke; reads one personal x-token from stdin and performs an external TLS/Subscribe request"] async fn publicnode_mainnet_yellowstone_streams_slots_with_secret_x_token() { assert_publicnode_slot_stream("publicnode_mainnet_yellowstone", "mainnet-beta", "https://solana-yellowstone-grpc.publicnode.com:443").await; } #[tokio::test(flavor = "current_thread")] #[ignore = "opt-in live PublicNode Testnet Yellowstone gRPC smoke; reuses the personal x-token read from stdin and performs an external TLS/Subscribe request"] async fn publicnode_testnet_yellowstone_streams_slots_with_secret_x_token() { assert_publicnode_slot_stream("publicnode_testnet_yellowstone", "testnet", "https://solana-testnet-yellowstone-grpc.publicnode.com:443").await; }