fastn-net 0.1.1

Network utilities for fastn
Documentation

fastn-net

Crates.io Documentation License

Network utilities and P2P communication for the fastn ecosystem.

Overview

fastn-net provides P2P networking capabilities for fastn entities using Iroh. Each fastn instance is called an "entity" in the P2P network, identified by a unique ID52 (52-character encoded Ed25519 public key).

Features

  • P2P networking between fastn entities with NAT traversal
  • HTTP and TCP proxying between entities
  • Connection pooling for HTTP clients
  • Protocol multiplexing (HTTP, TCP, SOCKS5, Ping) over single connections
  • Entity identification via ID52 encoding

Installation

[dependencies]
fastn-net = "0.1"

Usage

use fastn_net::{global_iroh_endpoint, ping, PONG, Protocol};

// Get the global Iroh endpoint for entity connections
let endpoint = global_iroh_endpoint().await;

// Connect to another entity and open a stream
let connection = endpoint.connect(entity_node_id, "").await?;
let (mut send, mut recv) = connection.open_bi().await?;

// Send a ping to test connectivity between entities
ping(&mut send).await?;
let response = fastn_net::next_string(&mut recv).await?;
assert_eq!(response, PONG);

Supported Protocols

  • Protocol::Ping - Connectivity testing
  • Protocol::Http - HTTP request proxying
  • Protocol::Tcp - TCP tunneling
  • Protocol::Socks5 - SOCKS5 proxy
  • Protocol::HttpProxy - HTTP proxy protocol

License

UPL-1.0