v0.2.7-pre.010

This commit is contained in:
2026-08-23 00:12:39 +02:00
parent 98bf88e431
commit 1391858972
14 changed files with 838 additions and 29 deletions

View File

@@ -1,5 +1,5 @@
// file: crates/ksp-onchain-transport-lib/unit_tests/ws_transactions.rs
// version: 1
// version: 2
use futures_util::SinkExt; // rust-rules: trait-import
use futures_util::StreamExt; // rust-rules: trait-import
@@ -120,3 +120,127 @@ async fn stable_logs_wrapper_uses_exact_filter_config_notification_and_handle_un
session.close().await.expect("session close must complete");
server.await.expect("local server task must complete");
}
#[test]
fn signature_subscribe_config_and_decoder_preserve_all_documented_wire_variants() {
let config = crate::SolanaSignatureSubscribeConfig::new(std::option::Option::Some(crate::SolanaCommitment::Confirmed), std::option::Option::Some(false));
assert_eq!(config.commitment(), std::option::Option::Some(crate::SolanaCommitment::Confirmed));
assert_eq!(config.enable_received_notification(), std::option::Option::Some(false));
assert_eq!(config.to_json_value(), serde_json::json!({"commitment":"confirmed","enableReceivedNotification":false}));
let received = super::decode_signature_notification("signatureSubscribe", serde_json::json!({"context":{"slot":90},"value":"receivedSignature"}))
.expect("receivedSignature notification must decode");
assert_eq!(received.context().slot(), 90);
assert_eq!(*received.value(), crate::SolanaSignatureNotification::ReceivedSignature);
assert!(!received.value().is_terminal());
let success = super::decode_signature_notification("signatureSubscribe", serde_json::json!({"context":{"slot":91},"value":{"err":null}}))
.expect("terminal successful signature notification must decode");
assert!(success.value().is_terminal());
assert!(success.value().err().is_none());
let failure = super::decode_signature_notification(
"signatureSubscribe",
serde_json::json!({"context":{"slot":92},"value":{"err":{"InstructionError":[0,"Custom"]}}}),
)
.expect("terminal failed signature notification must decode");
assert!(failure.value().is_terminal());
assert!(failure.value().err().is_some());
assert!(super::decode_signature_notification("signatureSubscribe", serde_json::json!({"context":{"slot":93},"value":"futureVariant"})).is_err());
assert!(super::decode_signature_notification("signatureSubscribe", serde_json::json!({"context":{"slot":94},"value":{}})).is_err());
}
#[tokio::test(flavor = "current_thread")]
async fn signature_unsubscribe_before_terminal_notification_uses_current_remote_id() {
let (listener, url) = bind_local_listener().await;
let server = tokio::spawn(async move {
let (stream, _) = listener.accept().await.expect("local server must accept client");
let mut websocket = tokio_tungstenite::accept_async(stream).await.expect("local WebSocket handshake must succeed");
let subscribe = read_request(&mut websocket).await;
assert_eq!(subscribe["method"], serde_json::json!("signatureSubscribe"));
assert_eq!(subscribe["params"], serde_json::json!(["fixture-signature"]));
send_result(&mut websocket, &subscribe, serde_json::json!(301)).await;
let unsubscribe = read_request(&mut websocket).await;
assert_eq!(unsubscribe["method"], serde_json::json!("signatureUnsubscribe"));
assert_eq!(unsubscribe["params"], serde_json::json!([301]));
send_result(&mut websocket, &unsubscribe, serde_json::json!(true)).await;
wait_for_close_frame(&mut websocket).await;
});
let session = crate::WsSession::connect(local_endpoint(url.as_str())).await.expect("client handshake must succeed");
let empty_config = crate::SolanaSignatureSubscribeConfig::default();
let mut subscription =
session.signature_subscribe("fixture-signature", std::option::Option::Some(&empty_config)).await.expect("signatureSubscribe must register");
assert!(subscription.unsubscribe().await.expect("signature unsubscribe must complete"));
assert_eq!(subscription.state(), crate::WsSubscriptionState::Closed);
session.close().await.expect("session close must complete");
server.await.expect("local server task must complete");
}
#[tokio::test(flavor = "current_thread")]
async fn signature_terminal_notification_closes_handle_and_is_not_resubscribed_after_reconnect() {
let (listener, url) = bind_local_listener().await;
let (send_terminal_tx, send_terminal_rx) = tokio::sync::oneshot::channel();
let (replacement_ready_tx, replacement_ready_rx) = tokio::sync::oneshot::channel();
let server = tokio::spawn(async move {
let (stream, _) = listener.accept().await.expect("local server must accept initial client");
let mut websocket = tokio_tungstenite::accept_async(stream).await.expect("initial WebSocket handshake must succeed");
let subscribe = read_request(&mut websocket).await;
assert_eq!(subscribe["method"], serde_json::json!("signatureSubscribe"));
assert_eq!(subscribe["params"], serde_json::json!(["fixture-signature",{"commitment":"finalized","enableReceivedNotification":true}]));
send_result(&mut websocket, &subscribe, serde_json::json!(401)).await;
let received = serde_json::json!({
"jsonrpc":"2.0",
"method":"signatureNotification",
"params":{"result":{"context":{"slot":100},"value":"receivedSignature"},"subscription":401}
});
websocket
.send(tokio_tungstenite::tungstenite::Message::Text(received.to_string().into()))
.await
.expect("receivedSignature notification must send");
send_terminal_rx.await.expect("client must observe early signature notification before terminal send");
let terminal = serde_json::json!({
"jsonrpc":"2.0",
"method":"signatureNotification",
"params":{"result":{"context":{"slot":101},"value":{"err":null}},"subscription":401}
});
websocket
.send(tokio_tungstenite::tungstenite::Message::Text(terminal.to_string().into()))
.await
.expect("terminal signature notification must send");
let unexpected_cleanup = tokio::time::timeout(std::time::Duration::from_millis(100), websocket.next()).await;
assert!(unexpected_cleanup.is_err(), "server-terminal signature notification must not trigger signatureUnsubscribe");
drop(websocket);
let (replacement_stream, _) = listener.accept().await.expect("local server must accept replacement client");
let mut replacement = tokio_tungstenite::accept_async(replacement_stream).await.expect("replacement WebSocket handshake must succeed");
let unexpected = tokio::time::timeout(std::time::Duration::from_millis(100), replacement.next()).await;
assert!(unexpected.is_err(), "terminal signature subscription must not be replayed after reconnect");
replacement_ready_tx.send(()).expect("replacement-ready signal must send");
wait_for_close_frame(&mut replacement).await;
});
let session = crate::WsSession::connect(local_endpoint(url.as_str())).await.expect("client handshake must succeed");
let config = crate::SolanaSignatureSubscribeConfig::new(std::option::Option::Some(crate::SolanaCommitment::Finalized), std::option::Option::Some(true));
let mut subscription =
session.signature_subscribe("fixture-signature", std::option::Option::Some(&config)).await.expect("signatureSubscribe must register");
let received = subscription.recv().await.expect("receivedSignature must arrive").expect("receivedSignature must decode");
assert_eq!(*received.value(), crate::SolanaSignatureNotification::ReceivedSignature);
assert_eq!(subscription.state(), crate::WsSubscriptionState::Active);
send_terminal_tx.send(()).expect("terminal-send signal must reach fixture");
let terminal = subscription.recv().await.expect("terminal signature notification must arrive").expect("terminal signature notification must decode");
assert!(terminal.value().is_terminal());
assert!(terminal.value().err().is_none());
let closed = tokio::time::timeout(std::time::Duration::from_secs(1), async {
loop {
if subscription.state() == crate::WsSubscriptionState::Closed {
return;
}
tokio::task::yield_now().await;
}
})
.await;
assert!(closed.is_ok());
assert!(subscription.recv().await.is_none());
assert!(subscription.terminal_error_code().is_none());
assert!(!subscription.unsubscribe().await.expect("already terminal signature unsubscribe must be local-only"));
replacement_ready_rx.await.expect("replacement connection must be observed without signature replay");
assert_eq!(session.snapshot().subscription_count(), 0);
assert!(session.snapshot().continuity_gap_count() >= 1);
session.close().await.expect("session close must complete");
server.await.expect("local server task must complete");
}