Struct Challenge 

pub struct Challenge {
    pub id: String,
    pub authz_id: String,
    pub typ: String,
    pub token: String,
    pub status: ChallengeStatus,
    pub validated: Option<i64>,
    pub error: Option<Value>,
    pub created_at: i64,
}

An ACME challenge (RFC 8555 §8): one proof the client may offer for its authorization’s identifier.

Which types an authorization carries is decided by ChallengeRegistry::types_for — UNIQUE(authz_id, type) allows several, one per type. Whether triggering one performs a real network check or is accepted outright is the registry’s bypass setting, not this model’s business.

A failed challenge stores the problem document that explains why in error, which the client reads back from the challenge object.

Fields

id: String

authz_id: String

typ: String

token: String

status: ChallengeStatus

validated: Option<i64>

error: Option<Value>

The RFC 8555 problem document of a failed validation. None until one fails.

created_at: i64

Implementations

impl Challenge

pub async fn create( authz_id: &str, typ: &str, database: &Database, ) -> Result<Challenge, Error>

Creates a new challenge of type typ, with a fresh random token, in the pending state.

pub async fn find_by_id( id: &str, database: &Database, ) -> Result<Option<Challenge>, Error>

pub async fn find_by_authz( authz_id: &str, database: &Database, ) -> Result<Vec<Challenge>, Error>

Lists an authorization’s challenges (creation order), for the authorization object’s challenges array.

pub async fn mark_valid(&mut self, database: &Database) -> Result<(), Error>

pub async fn mark_invalid( &mut self, error: Value, database: &Database, ) -> Result<(), Error>

Records a failed validation: moves the challenge to the terminal invalid state, stores the problem document explaining why, and keeps self in sync.

validated is deliberately not stamped — RFC 8555 §8 defines it as the time the challenge was successfully validated.

pub fn to_json(&self, base_url: &str) -> Value

The RFC 8555 challenge object: type, the derived challenge url, status, token, plus validated (RFC3339) and error once set.

Trait Implementations

impl Debug for Challenge

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

Formats the value using the given formatter.