Errors¶

Exception types raised by the Auths SDK.

AuthsError(message: str, code: str, **context: object)

Bases: Exception

Base error for all Auths SDK operations.

VerificationError(message: str, code: str, **context: object)

Attestation or chain verification failed.

Codes: invalid_signature, expired_attestation, revoked_device, broken_chain, missing_attestation, unknown_signer.

CryptoError(message: str, code: str, **context: object)

Cryptographic operation failed (bad key, signing error).

Codes: invalid_key, signing_failed, key_not_found.

KeychainError(message: str, code: str, **context: object)

Keychain access failed.

Codes: keychain_locked, key_not_found, permission_denied.

StorageError(message: str, code: str, **context: object)

Git storage operation failed.

Codes: repo_not_found, ref_conflict, corrupt_data, duplicate_attestation.

NetworkError(message: str, code: str, should_retry: bool = False, **context: object)

Network operation failed (token exchange, registry sync).

Codes: connection_failed, timeout, server_error, auth_failed.

IdentityError(message: str, code: str, **context: object)

Identity lifecycle operation failed.

Codes: identity_exists, identity_not_found, invalid_did.

OrgError(message: str, code: str, **context: object)

Organization operation failed.

Codes: org_error, admin_not_found, member_not_found, already_revoked, invalid_capability, invalid_role.

PairingError(message: str, code: str, should_retry: bool = False, **context)

Device pairing operation failed.

Codes: pairing_error, timeout, connection_failed, session_expired.