Struct SiwxProof 

pub struct SiwxProof {

    pub address: CompactString,
    pub signature: CompactString,
    pub domain: CompactString,
    pub uri: CompactString,
    pub version: CompactString,
    pub nonce: CompactString,
    pub issued_at: CompactString,
    pub expiration_time: Option<CompactString>,
    pub not_before: Option<CompactString>,
    pub statement: Option<CompactString>,
    pub request_id: Option<CompactString>,
    pub resources: Vec<CompactString>,
    pub chain_id: CompactString,
    pub signature_type: CompactString,
    pub signature_scheme: Option<CompactString>,
}

Available on crate features server and siwx only.

Client proof carried on SIGN-IN-WITH-X (base64 JSON).

Fields

address: CompactString

Wallet address that signed the message.

signature: CompactString

Cryptographic signature (hex for EVM, Base58 for Solana).

domain: CompactString

CAIP-122 domain.

uri: CompactString

Resource URI.

version: CompactString

CAIP-122 version (always "1").

nonce: CompactString

Challenge nonce (32 hex).

issued_at: CompactString

ISO 8601 issuedAt as sent by the client (signing-string form).

expiration_time: Option<CompactString>

Optional ISO 8601 expiry, original string.

not_before: Option<CompactString>

Optional ISO 8601 not-before, original string.

statement: Option<CompactString>

Optional CAIP-122 statement.

request_id: Option<CompactString>

Optional request id.

resources: Vec<CompactString>

Optional resource URIs.

chain_id: CompactString

CAIP-2 chain identifier.

signature_type: CompactString

Signature algorithm (eip191 / ed25519).

signature_scheme: Option<CompactString>

Spec signatureScheme hint, if the client sent one.

Implementations

impl SiwxProof

pub fn parse_header(value: &str) -> Result<SiwxProof, SiwxProofError>

Decodes a SIGN-IN-WITH-X header value.

Errors

SiwxProofError when the header is not base64 JSON with the required string fields, or version is not "1".

pub fn bind_origin( &self, origin: &SiwxOrigin, path: &str, ) -> Result<(), SiwxError>

Checks domain / uri against the configured origin. Never uses Host.

Errors

SiwxError::DomainMismatch or SiwxError::UriMismatch.

pub fn validate_at( &self, origin: &SiwxOrigin, path: &str, now: OffsetDateTime, ) -> Result<(), SiwxError>

Origin, URI, and temporal checks. now is injectable for tests.

Errors

Spec invalid_siwx_* field codes.

pub fn signing_message(&self) -> Result<String, SiwxError>

Canonical CAIP-122 signing string for this proof’s fields.

Renders via EvmVerifier::format_message / Ed25519Verifier::format_message. Timestamp fields are passed through *_raw so the original RFC 3339 bytes are hashed.

Errors

SiwxError::ChainId, SiwxError::UnsupportedChain, or a field error when the proof cannot be turned into a SiwxMessage.

pub async fn verify_at( &self, origin: &SiwxOrigin, path: &str, now: OffsetDateTime, evm: &EvmVerifier, ) -> Result<(), SiwxError>

Field validation plus CAIP-122 signature verification at now.

Errors

Spec invalid_siwx_* codes.

pub async fn verify( &self, origin: &SiwxOrigin, path: &str, ) -> Result<(), SiwxError>

Self::verify_at with the current UTC time and EvmVerifier::new.

Errors

Spec invalid_siwx_* codes.

pub fn encode_header(&self) -> Result<String, SiwxProofError>

Encodes this proof as a SIGN-IN-WITH-X header value (base64 JSON).

Errors

SiwxProofError::InvalidJson when the proof cannot be serialized.

Trait Implementations

impl Clone for SiwxProof

fn clone(&self) -> SiwxProof

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SiwxProof

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

Formats the value using the given formatter.

impl Eq for SiwxProof

impl PartialEq for SiwxProof

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for SiwxProof