Struct PssApi 

pub struct PssApi { /* private fields */ }

Handle exposing the PSS endpoints. Cheap to clone.

Implementations

impl PssApi

pub async fn send( &self, batch_id: &BatchId, topic: &Topic, target: &str, data: impl Into<Bytes>, recipient: Option<&PublicKey>, ) -> Result<(), Error>

POST /pss/send/{topic}/{target} — send a PSS message.

• batch_id is mandatory (Bee 2.7+ rejects requests without Swarm-Postage-Batch-Id).
• target is a routing prefix as hex (e.g. "1234"), not a full overlay address. Bee uses it as a partial XOR target so gossip can reach the recipient without revealing the full address.
• recipient is optional; when provided, the message is end-to-end encrypted with the recipient’s public key.

pub async fn subscribe(&self, topic: &Topic) -> Result<Subscription, Error>

GET /pss/subscribe/{topic} over a WebSocket. Returns a Subscription yielding decoded message bytes via Subscription::recv.

pub async fn receive( &self, topic: &Topic, timeout: Duration, ) -> Result<Bytes, Error>

One-shot helper: subscribe, wait for the next message (with timeout), close the subscription, return the bytes.

Trait Implementations

impl Clone for PssApi

fn clone(&self) -> PssApi

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for PssApi

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.