Struct Endpoint 

pub struct Endpoint {
    pub kind: String,
    pub url: String,
    pub priority: i32,
    pub health_hint_unix: Option<i64>,
    pub health: Option<EndpointHealth>,
}

A single way to reach a sender’s data plane.

Fields

kind: String

Transport kind. See [Endpoint::KIND_*] constants for known values. Unknown values are preserved but MUST be skipped by recipients.

url: String

Reachable address. Schema is transport-specific:

• cloudflare_quick, cloudflare_named, tailscale_funnel, frp: https://host/...
• iroh: iroh:<NodeID>@<relay_host>:<port>

priority: i32

Sender’s preference (lower = try first). Ties broken by array order.

health_hint_unix: Option<i64>

Optional last-known-good timestamp (Unix seconds) used by the control plane’s health cache. Absent on fresh endpoints.

health: Option<EndpointHealth>

Background-validator health state (ADR-0014, ADR-0021). Absent on wire payloads sent by clients; populated by the control plane after the first re-probe cycle. Recipients SHOULD skip endpoints whose health.status is Unhealthy; SDKs that don’t recognise this field are forward-compatible because health is additive.

Implementations

impl Endpoint

pub const KIND_CLOUDFLARE_QUICK: &'static str = "cloudflare_quick"

Cloudflare Quick Tunnel (*.trycloudflare.com, ephemeral).

pub const KIND_CLOUDFLARE_NAMED: &'static str = "cloudflare_named"

Cloudflare Named Tunnel (*.workers.dev or custom hostname, persistent).

pub const KIND_IROH: &'static str = "iroh"

Iroh peer-to-peer with DERP relay fallback.

pub const KIND_TAILSCALE_FUNNEL: &'static str = "tailscale_funnel"

Tailscale Funnel (public hostname on a tailnet).

pub const KIND_FRP: &'static str = "frp"

FRP self-hosted reverse proxy.

pub const KNOWN_KINDS: &'static [&'static str]

All kinds this crate knows how to reach. Adding a new transport in a later sprint adds a constant here + extends this array.

pub fn is_known_kind(&self) -> bool

True if self.kind is in Self::KNOWN_KINDS. Recipients use this to skip forward-incompatible endpoints without failing the transfer.

pub fn cloudflare_quick(url: impl Into<String>) -> Self

Convenience: Cloudflare Quick Tunnel endpoint at priority 0.

Trait Implementations

impl Clone for Endpoint

fn clone(&self) -> Endpoint

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Endpoint

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Endpoint

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for Endpoint

fn eq(&self, other: &Endpoint) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for Endpoint

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for Endpoint

impl StructuralPartialEq for Endpoint