pub struct StreamHandleImpl<T: Transport> { /* private fields */ }Expand description
E2E authenticated stream consumer, generic over transport.
Same struct on native (StreamHandle<ZmqConnection>) and WASM
(StreamHandle<WtConnection>). ECDH, key derivation, MAC verification,
and Cap’n Proto parsing are identical — only the wire transport differs.
Implementations§
Source§impl<T: Transport> StreamHandleImpl<T>
impl<T: Transport> StreamHandleImpl<T>
Sourcepub async fn open(
transport: &T,
stream_info: StreamInfo,
client_secret: &[u8; 32],
client_pubkey: &[u8; 32],
) -> Result<Self>
pub async fn open( transport: &T, stream_info: StreamInfo, client_secret: &[u8; 32], client_pubkey: &[u8; 32], ) -> Result<Self>
Full streaming setup: ECDH → derive keys → subscribe → open ctrl → create verifier.
Called by RpcClient::open_stream() after the streaming RPC returns StreamInfo.
#385 INVARIANT (S8 close-out — dhPublic authenticity):
The entire AEAD + chained-HMAC integrity envelope bootstraps from
stream_info.dh_public — the server’s ephemeral Ristretto255 DH public
key. It is trustworthy ONLY because StreamInfo arrives over the
authenticated RPC response: carrier target/path checks are insufficient;
the reply is independently wrapped in a ResponseEnvelope carrying a
COSE composite signature (EdDSA +
ML-DSA-65 under Hybrid), so dhPublic authentication reaches PQ
strength. A dh_public sourced from an unauthenticated path would let
any MITM substitute its own key, derive the stream keys itself, and forge
frames — defeating the whole envelope. This entry point is the single
library/codegen boundary that turns a StreamInfo into a live stream;
dh_public MUST therefore arrive here already authenticated. Callers
MUST NOT construct StreamInfo from untrusted input (e.g. a forwarded
relay advertisement or an unsigned lookup result). See
[crate::rpc_client::parse_stream_info] — the only producer of a
StreamInfo from wire bytes, reached solely via the authenticated
call_streaming RPC reply path.
Sourcepub async fn next_payload(&mut self) -> Result<Option<StreamPayload>>
pub async fn next_payload(&mut self) -> Result<Option<StreamPayload>>
Get next verified payload. Returns None on stream end.
Sourcepub async fn cancel(&mut self) -> Result<()>
pub async fn cancel(&mut self) -> Result<()>
Cancel the stream via ctrl channel. Sets local cancelled flag AND sends cancel message to producer.
Takes &mut self so the future is Send (holds &mut Self, which is
Send because Self: Send) rather than requiring Self: Sync. See
#670 / the StreamHandle::cancel trait method.
pub fn stream_id(&self) -> &str
pub fn topic(&self) -> &str
pub fn is_completed(&self) -> bool
Trait Implementations§
Source§impl<T: Transport> StreamHandle for StreamHandleImpl<T>
Blanket impl: any StreamHandleImpl<T> satisfies StreamHandle.
impl<T: Transport> StreamHandle for StreamHandleImpl<T>
Blanket impl: any StreamHandleImpl<T> satisfies StreamHandle.
Source§fn next_payload<'life0, 'async_trait>(
&'life0 mut self,
) -> Pin<Box<dyn Future<Output = Result<Option<StreamPayload>>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
fn next_payload<'life0, 'async_trait>(
&'life0 mut self,
) -> Pin<Box<dyn Future<Output = Result<Option<StreamPayload>>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
Source§fn cancel<'life0, 'async_trait>(
&'life0 mut self,
) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
fn cancel<'life0, 'async_trait>(
&'life0 mut self,
) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
Source§fn is_completed(&self) -> bool
fn is_completed(&self) -> bool
Auto Trait Implementations§
impl<T> Freeze for StreamHandleImpl<T>
impl<T> RefUnwindSafe for StreamHandleImpl<T>
impl<T> Send for StreamHandleImpl<T>
impl<T> Sync for StreamHandleImpl<T>
impl<T> Unpin for StreamHandleImpl<T>
impl<T> UnsafeUnpin for StreamHandleImpl<T>
impl<T> UnwindSafe for StreamHandleImpl<T>
Blanket Implementations§
Source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
Source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
§impl<T> Instrument for T
impl<T> Instrument for T
§fn instrument(self, span: Span) -> Instrumented<Self>
fn instrument(self, span: Span) -> Instrumented<Self>
§fn in_current_span(self) -> Instrumented<Self>
fn in_current_span(self) -> Instrumented<Self>
Source§impl<T> IntoEither for T
impl<T> IntoEither for T
Source§fn into_either(self, into_left: bool) -> Either<Self, Self>
fn into_either(self, into_left: bool) -> Either<Self, Self>
self into a Left variant of Either<Self, Self>
if into_left is true.
Converts self into a Right variant of Either<Self, Self>
otherwise. Read moreSource§fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
self into a Left variant of Either<Self, Self>
if into_left(&self) returns true.
Converts self into a Right variant of Either<Self, Self>
otherwise. Read more