Struct Po 

pub struct Po { /* private fields */ }

A PO node — the main entry point for the protocol.

Wraps all the complexity of QUIC, crypto handshake, and encryption behind a dead-simple API.

Implementations

impl Po

pub async fn connect(addr: &str) -> Result<Self, PoError>

Connect to a remote PO node.

This will:

1. Establish a QUIC connection
2. Perform the E2EE handshake (Ed25519 + X25519 + ChaCha20)
3. Return a ready-to-use encrypted connection

let mut po = Po::connect("192.168.1.5:4433").await?;
po.send(b"encrypted hello!").await?;

pub async fn bind(port: u16) -> Result<Self, PoError>

Listen for an incoming connection on the given port.

This will:

1. Start a QUIC listener
2. Accept the first incoming connection
3. Perform the E2EE handshake
4. Return a ready-to-use encrypted connection

let mut po = Po::bind(4433).await?;
let data = po.recv().await?;

pub async fn send(&mut self, data: &[u8]) -> Result<(), PoError>

Send encrypted data to the connected peer.

pub async fn recv(&mut self) -> Result<Option<(u32, Vec<u8>)>, PoError>

Receive the next message from the connected peer.

Returns Some((channel_id, data)) or None if the connection closed.

pub fn node_id(&self) -> String

Get our node ID.

pub fn public_key(&self) -> [u8; 32]

Get our Ed25519 public key bytes (32 bytes).

pub fn peer_node_id(&self) -> Option<String>

Get the peer’s node ID (if connected).

pub fn peer_info(&self) -> Option<&PeerInfo>

Get information about the connected peer.

pub async fn close(&mut self) -> Result<(), PoError>

Gracefully close the connection.