Exceptions¶

All exceptions inherit from AcmeError.

AcmeError¶

class acmeow.AcmeError[source]¶

Bases: Exception

Base exception for all ACME errors.

Parameters:: message (str) – Human-readable error description.

__init__(message)[source]¶

Parameters:: message (str)
Return type:: None

AcmeServerError¶

class acmeow.AcmeServerError[source]¶

Bases: AcmeError

ACME server returned an error response.

This exception is raised when the ACME server responds with an error status code and provides error details in the RFC 8555 format.

Parameters:

status_code (int) – HTTP status code from the server.
error_type (str) – ACME error type URN (e.g., “urn:ietf:params:acme:error:malformed”).
detail (str) – Human-readable error description from the server.

__init__(status_code, error_type, detail)[source]¶

Parameters:

status_code (int)
error_type (str)
detail (str)

Return type:

None

AcmeAuthenticationError¶

class acmeow.AcmeAuthenticationError[source]¶

Bases: AcmeError

Account authentication failed.

Raised when account creation, account key verification, or request signing fails.

AcmeAuthorizationError¶

class acmeow.AcmeAuthorizationError[source]¶

Bases: AcmeError

Challenge authorization failed.

Raised when a challenge fails validation or an authorization enters an invalid state.

Parameters:

domain (str) – The domain that failed authorization.
message (str) – Human-readable error description.

__init__(domain, message)[source]¶

Parameters:

domain (str)
message (str)

Return type:

None

AcmeOrderError¶

class acmeow.AcmeOrderError[source]¶

Bases: AcmeError

Order creation or finalization failed.

Raised when an order cannot be created, enters an invalid state, or finalization fails.

AcmeCertificateError¶

class acmeow.AcmeCertificateError[source]¶

Bases: AcmeError

Certificate download or validation failed.

Raised when the certificate cannot be downloaded, parsed, or saved to disk.

AcmeConfigurationError¶

class acmeow.AcmeConfigurationError[source]¶

Bases: AcmeError

Invalid client configuration.

Raised when the client is configured with invalid parameters, such as an invalid email address or unsupported key type.

AcmeNetworkError¶

class acmeow.AcmeNetworkError[source]¶

Bases: AcmeError

Network communication error.

Raised when network communication with the ACME server fails, including connection errors, timeouts, and TLS errors.

Parameters:

message (str) – Human-readable error description.
original_error (Exception | None) – The underlying exception that caused this error.

__init__(message, original_error=None)[source]¶

Parameters:

message (str)
original_error (Exception | None)

Return type:

None

AcmeTimeoutError¶

class acmeow.AcmeTimeoutError[source]¶

Bases: AcmeError

Operation timed out.

Raised when an operation exceeds its timeout, such as waiting for an order to become ready or a challenge to be validated.

AcmeRateLimitError¶

class acmeow.AcmeRateLimitError[source]¶

Bases: AcmeError

Rate limit exceeded.

Raised when the ACME server returns a 429 status code or a rateLimited error type.

Parameters:

message (str) – Human-readable error description.
retry_after (float | None) – Suggested wait time in seconds, if provided by server.

__init__(message, retry_after=None)[source]¶

Parameters:

message (str)
retry_after (float | None)

Return type:

None

AcmeDnsError¶

class acmeow.AcmeDnsError[source]¶

Bases: AcmeError

DNS verification failed.

Raised when DNS propagation check fails or DNS records cannot be verified.

Parameters:

domain (str) – The domain that failed DNS verification.
message (str) – Human-readable error description.

__init__(domain, message)[source]¶

Parameters:

domain (str)
message (str)

Return type:

None