Struct InternalAddPeerRequest 

pub struct InternalAddPeerRequest {
    pub wg_public_key: String,
    pub overlay_ip: String,
    pub endpoint: String,
    pub service: Option<String>,
    pub service_subnet: Option<String>,
    pub candidates: Vec<NatCandidateWire>,
}

Request to add a WireGuard peer to the local overlay transport.

Sent by the leader to existing nodes when a new node joins the cluster, so that all nodes learn about the new peer without waiting for periodic reconciliation.

Fields

wg_public_key: String

New peer’s WireGuard public key (base64)

overlay_ip: String

New peer’s overlay IP (e.g. “10.200.0.3”)

endpoint: String

New peer’s WireGuard endpoint (e.g. “203.0.113.5:51820”)

service: Option<String>

When set, this peer is for the named service’s dedicated overlay rather than the global cluster overlay.

service_subnet: Option<String>

Service subnet to plumb into the dedicated peer’s AllowedIPs.

candidates: Vec<NatCandidateWire>

NAT-traversal candidates the joining node advertises (host / server-reflexive / relay addresses it can be reached on). The leader fans these out to existing nodes via /internal/add-peer; each node hands them to overlayd so NatTraversal::connect_to_peer can hole-punch / relay toward the new peer when its direct endpoint does not establish a WireGuard handshake. Empty for a pre-NAT sender; #[serde(default)] keeps such payloads decoding.

Trait Implementations

impl Clone for InternalAddPeerRequest

fn clone(&self) -> InternalAddPeerRequest

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl ComposeSchema for InternalAddPeerRequest

fn compose(generics: Vec<RefOr<Schema>>) -> RefOr<Schema>

impl Debug for InternalAddPeerRequest

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for InternalAddPeerRequest

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for InternalAddPeerRequest

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl ToSchema for InternalAddPeerRequest

fn name() -> Cow<'static, str>

Return name of the schema.

fn schemas(schemas: &mut Vec<(String, RefOr<Schema>)>)

Implement reference utoipa::openapi::schema::Schemas for this type.