/**
 * Typed error model for the Passkey Kit SDK.
 *
 * Every error the kit throws is a {@link PasskeyKitError} (or subclass) carrying
 * a numeric {@link PasskeyKitErrorCode}, optional structured `context`, and an
 * optional `cause`. Callers branch on `error.code` (or `instanceof`) instead of
 * matching on message strings.
 *
 * Submission methods are the one exception to "throw on failure": they return a
 * discriminated {@link import("./types.js").TransactionResult} whose failure arm
 * carries one of these typed errors (see `contract-errors.ts`).
 *
 * @packageDocumentation
 */
/**
 * Error codes for Passkey Kit operations, grouped by concern.
 *
 * Ranges (per SDK architecture spec #599 §5, extended with validation/storage):
 * - 1xxx configuration
 * - 2xxx wallet state
 * - 3xxx WebAuthn
 * - 4xxx signing
 * - 5xxx transaction (simulation/submission)
 * - 6xxx indexer
 * - 7xxx relayer
 * - 8xxx validation
 * - 9xxx storage
 * - 10000 contract-level failure decoded from on-chain diagnostics (the raw
 *   contract code 1-9 is carried separately on {@link ContractError}).
 */
export declare enum PasskeyKitErrorCode {
    INVALID_CONFIG = 1001,
    MISSING_CONFIG = 1002,
    WALLET_NOT_CONNECTED = 2001,
    WALLET_ALREADY_EXISTS = 2002,
    WALLET_NOT_FOUND = 2003,
    WALLET_OWNERSHIP_MISMATCH = 2004,
    WEBAUTHN_REGISTRATION_FAILED = 3001,
    WEBAUTHN_AUTHENTICATION_FAILED = 3002,
    WEBAUTHN_NOT_SUPPORTED = 3003,
    WEBAUTHN_CANCELLED = 3004,
    PUBLIC_KEY_EXTRACTION_FAILED = 3005,
    SIGNING_FAILED = 4001,
    SIGNER_NOT_FOUND = 4002,
    INVALID_SIGNER = 4003,
    INVALID_SIGNATURE_EXPIRATION = 4004,
    UNSUPPORTED_CREDENTIALS = 4005,
    SIMULATION_FAILED = 5001,
    SUBMISSION_FAILED = 5002,
    TRANSACTION_TIMEOUT = 5003,
    RESTORE_REQUIRED = 5004,
    INDEXER_NOT_CONFIGURED = 6001,
    INDEXER_REQUEST_FAILED = 6002,
    RELAYER_NOT_CONFIGURED = 7001,
    RELAYER_REQUEST_FAILED = 7002,
    /** Submitted but not yet in a terminal state — keep polling getTransaction. */
    RELAYER_PENDING = 7003,
    INVALID_ADDRESS = 8001,
    INVALID_AMOUNT = 8002,
    INVALID_INPUT = 8003,
    INVALID_PUBLIC_KEY = 8004,
    STORAGE_READ_FAILED = 9001,
    STORAGE_WRITE_FAILED = 9002,
    CONTRACT_ERROR = 10000
}
/**
 * Base error class for all Passkey Kit errors.
 */
export declare class PasskeyKitError extends Error {
    /** Error code for programmatic handling. */
    readonly code: PasskeyKitErrorCode;
    /** Structured context about the error. */
    readonly context?: Record<string, unknown>;
    /** The underlying error that caused this one, if any. */
    readonly cause?: Error;
    constructor(message: string, code: PasskeyKitErrorCode, options?: {
        context?: Record<string, unknown>;
        cause?: Error;
    });
    /** Format the error with its code, context, and cause for logging. */
    toDetailedString(): string;
}
/** Thrown when the client is misconfigured. */
export declare class ConfigurationError extends PasskeyKitError {
    constructor(message: string, code?: PasskeyKitErrorCode.INVALID_CONFIG | PasskeyKitErrorCode.MISSING_CONFIG, context?: Record<string, unknown>);
}
/** Thrown when an operation requires a connected wallet but none is connected. */
export declare class WalletNotConnectedError extends PasskeyKitError {
    constructor(operation?: string);
}
/**
 * Thrown when a connected wallet does not actually own the credential used to
 * connect (connectWallet ownership verification, #601 F7).
 */
export declare class WalletOwnershipError extends PasskeyKitError {
    constructor(message: string, context?: Record<string, unknown>);
}
/** Thrown when a WebAuthn ceremony fails. */
export declare class WebAuthnError extends PasskeyKitError {
    constructor(message: string, code: PasskeyKitErrorCode.WEBAUTHN_REGISTRATION_FAILED | PasskeyKitErrorCode.WEBAUTHN_AUTHENTICATION_FAILED | PasskeyKitErrorCode.WEBAUTHN_NOT_SUPPORTED | PasskeyKitErrorCode.WEBAUTHN_CANCELLED | PasskeyKitErrorCode.PUBLIC_KEY_EXTRACTION_FAILED, cause?: Error);
}
/** Thrown when signing an authorization entry fails. */
export declare class SigningError extends PasskeyKitError {
    constructor(message: string, code?: PasskeyKitErrorCode.SIGNING_FAILED | PasskeyKitErrorCode.INVALID_SIGNER | PasskeyKitErrorCode.INVALID_SIGNATURE_EXPIRATION | PasskeyKitErrorCode.UNSUPPORTED_CREDENTIALS, context?: Record<string, unknown>);
}
/** Thrown when a requested signer cannot be found. */
export declare class SignerNotFoundError extends PasskeyKitError {
    constructor(identifier: string, hint?: string);
}
/** Thrown when transaction simulation fails. */
export declare class SimulationError extends PasskeyKitError {
    constructor(message: string, context?: Record<string, unknown>);
}
/** Thrown when transaction submission fails. */
export declare class SubmissionError extends PasskeyKitError {
    constructor(message: string, hash?: string, context?: Record<string, unknown>);
}
/** Thrown when input validation fails. */
export declare class ValidationError extends PasskeyKitError {
    constructor(message: string, code?: PasskeyKitErrorCode.INVALID_ADDRESS | PasskeyKitErrorCode.INVALID_AMOUNT | PasskeyKitErrorCode.INVALID_INPUT | PasskeyKitErrorCode.INVALID_PUBLIC_KEY, context?: Record<string, unknown>);
}
/** Thrown when an indexer request fails or the indexer is not configured. */
export declare class IndexerError extends PasskeyKitError {
    constructor(message: string, code?: PasskeyKitErrorCode.INDEXER_NOT_CONFIGURED | PasskeyKitErrorCode.INDEXER_REQUEST_FAILED, context?: Record<string, unknown>, cause?: Error);
}
/** Thrown when a relayer request fails or the relayer is not configured. */
export declare class RelayerError extends PasskeyKitError {
    constructor(message: string, code?: PasskeyKitErrorCode.RELAYER_NOT_CONFIGURED | PasskeyKitErrorCode.RELAYER_REQUEST_FAILED | PasskeyKitErrorCode.RELAYER_PENDING, context?: Record<string, unknown>, cause?: Error);
}
/**
 * Error decoded from an on-chain smart-wallet failure code.
 *
 * Produced by `decodeContractError` when a simulation/submission diagnostic
 * reports an `Error(Contract, #N)`. Carries the raw contract code and its enum
 * variant name so callers can branch on the exact failure.
 *
 * @example
 * ```typescript
 * const result = await server.send(tx);
 * if (!result.success && result.error instanceof ContractError) {
 *   if (result.error.contractErrorName === "SignerExpired") { ... }
 * }
 * ```
 */
export declare class ContractError extends PasskeyKitError {
    /** Raw contract error code (e.g. 4). */
    readonly contractCode: number;
    /** Enum variant name from the contract (e.g. "SignerExpired"). */
    readonly contractErrorName: string;
    /** Contract family the code belongs to (e.g. "SmartWallet"). */
    readonly family: string;
    constructor(contractCode: number, contractErrorName: string, family: string, message: string, options?: {
        context?: Record<string, unknown>;
        cause?: Error;
    });
}
/**
 * Wrap an unknown thrown value in a {@link PasskeyKitError}.
 *
 * Passes through values that are already {@link PasskeyKitError}s.
 */
export declare function wrapError(err: unknown, defaultCode?: PasskeyKitErrorCode): PasskeyKitError;
//# sourceMappingURL=errors.d.ts.map