Struct HttpAuthRequest 

pub struct HttpAuthRequest {
    pub url: Url,
    pub method: HttpMethod,
    pub payload_hash: Option<[u8; 32]>,
}

Typed bundle for a kind: 27235 HTTP-auth event.

Fields

url: Url

Absolute request URL (the u tag).

method: HttpMethod

HTTP method (the method tag).

payload_hash: Option<[u8; 32]>

Optional SHA-256 over the request body (the payload tag). None matches a body-less request.

Implementations

impl HttpAuthRequest

pub const fn new(url: Url, method: HttpMethod) -> Self

Construct a body-less request bundle.

pub const fn payload_hash(self, hash: [u8; 32]) -> Self

Attach a SHA-256 hash of the request body.

pub fn payload(self, body: &[u8]) -> Self

Convenience: hash body with SHA-256 and attach the digest.

Use this when the caller already has the body bytes in hand.

pub fn to_tags(&self) -> Vec<Tag>

Render to the tag list of a kind: 27235 event.

pub fn from_event(event: &Event) -> Result<Self, HttpAuthError>

Parse a kind: 27235 event back into a typed bundle.

Errors

• HttpAuthError::WrongKind for any other kind.
• HttpAuthError::MissingUrl / MissingMethod when a required tag is absent.
• HttpAuthError::InvalidUrl / InvalidPayloadHash when a tag value is malformed.

pub fn from_tags(tags: &Tags) -> Result<Self, HttpAuthError>

Parse from a tag list (without enforcing the wrapping kind).

Errors

See Self::from_event.

pub fn validate( &self, signed_at: Timestamp, now: Timestamp, skew_secs: u64, request_url: &Url, request_method: &HttpMethod, body: Option<&[u8]>, ) -> Result<(), HttpAuthError>

Server-side validation per NIP-98 §“Servers MUST perform the following checks”:

1. Event kind is 27235 (already enforced when the bundle came from Self::from_event).
2. created_at is within ±skew of now. Default skew is DEFAULT_TIMESTAMP_SKEW_SECS.
3. The bundle’s Self::url equals request_url byte-for-byte.
4. The bundle’s Self::method equals request_method.

When body is Some, the SHA-256 over those bytes must equal the bundle’s Self::payload_hash.

A body == None + payload_hash == Some(_) mismatch fails validation; a body == Some + payload_hash == None is allowed (spec uses “SHOULD include”, not “MUST”), but most servers will want to reject it themselves with a higher-level rule.

Errors

One of the variants of HttpAuthError tagged with Validation*.

Trait Implementations

impl Clone for HttpAuthRequest

fn clone(&self) -> HttpAuthRequest

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for HttpAuthRequest

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

Formats the value using the given formatter.

impl Eq for HttpAuthRequest

impl PartialEq for HttpAuthRequest

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for HttpAuthRequest