ap-proxy-client

A client library for connecting to an ap-proxy WebSocket server.

Overview

ap-proxy-client provides ProxyProtocolClient for connecting to a proxy server, authenticating with cryptographic identities, and exchanging messages with other clients. It uses rustls for TLS.

Quick Start

Add to your Cargo.toml:

[dependencies]
ap-proxy-client = "0.1.0"

Basic client example:

use ap_proxy_client::{ProxyClientConfig, ProxyProtocolClient, IncomingMessage};

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let config = ProxyClientConfig {
        proxy_url: "ws://localhost:8080".to_string(),
        identity_keypair: None, // Generates a new identity
    };

    let mut client = ProxyProtocolClient::new(config);
    let mut incoming = client.connect().await?;

    println!("Connected! Fingerprint: {:?}", client.fingerprint());

    // Handle incoming messages
    tokio::spawn(async move {
        while let Some(msg) = incoming.recv().await {
            match msg {
                IncomingMessage::Send { source, payload, .. } => {
                    println!("Message from {:?}: {:?}", source, payload);
                }
                IncomingMessage::RendezvousInfo(code) => {
                    println!("Your pairing token: {}", code.as_str());
                }
                IncomingMessage::IdentityInfo { identity, .. } => {
                    println!("Found peer: {:?}", identity.fingerprint());
                }
            }
        }
    });

    // Request a pairing token for others to find you
    client.request_rendezvous().await?;

    Ok(())
}