Struct SignedClusterJoinToken 

pub struct SignedClusterJoinToken {
    pub v: u32,
    pub kid: String,
    pub claims: ClusterJoinClaims,
    pub sig: String,
    pub ca_chain: Option<CaCert>,
}

Envelope around ClusterJoinClaims carrying the Ed25519 signature.

On the wire, this struct is serialized as JSON and then base64 url-safe-no-pad encoded. The Wave 3.2 mint function produces that outer base64; the parser reverses it.

Fields

v: u32

Format version. 1 in Wave 3. Wave 9 will introduce v=2 (adds a ca_chain field for federated trust); parsers MUST reject any version they don’t understand.

kid: String

Key identifier (first 8 hex chars of SHA-256 over the verifying key bytes). Lets joining nodes pick the correct pubkey during rotation (Wave 5).

claims: ClusterJoinClaims

The payload that’s actually signed.

sig: String

Ed25519 signature over serde_json::to_vec(&claims), encoded as URL-safe no-pad base64.

ca_chain: Option<CaCert>

Optional CA chain binding the kid to a foreign cluster. Set to Some(...) only on v=2 tokens minted for cross-cluster federation; same-cluster v=2 tokens may omit it. v=1 tokens MUST have this field absent (skip_serializing_if guarantees the JSON shape stays compatible with v=1 parsers).

Trait Implementations

impl Clone for SignedClusterJoinToken

fn clone(&self) -> SignedClusterJoinToken

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl ComposeSchema for SignedClusterJoinToken

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

impl Debug for SignedClusterJoinToken

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for SignedClusterJoinToken

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for SignedClusterJoinToken

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 SignedClusterJoinToken

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.