import { CirclesError } from '@aboutcircles/sdk-utils';
import type { Address } from '@aboutcircles/sdk-types';
/**
 * Invitation package error source
 */
export type InvitationErrorSource = 'INVITATIONS' | 'PATHFINDING' | 'VALIDATION';
/**
 * Referral error source
 */
export type ReferralErrorSource = 'REFERRALS' | 'VALIDATION' | 'ONCHAIN';
/**
 * Referral-specific errors for the Referrals service client
 */
export declare class ReferralError extends CirclesError<ReferralErrorSource> {
    readonly httpStatus?: number;
    constructor(message: string, options?: {
        code?: string | number;
        source?: ReferralErrorSource;
        cause?: unknown;
        context?: Record<string, any>;
        httpStatus?: number;
    });
    static notFoundOnChain(signer: Address): ReferralError;
    static alreadyClaimed(signer: Address): ReferralError;
    static storeFailed(reason: string): ReferralError;
    static storeBatchFailed(reason: string): ReferralError;
    static retrieveFailed(reason: string, httpStatus?: number): ReferralError;
    static listFailed(reason: string): ReferralError;
    static authRequired(): ReferralError;
}
/**
 * Base error for invitations package
 */
export declare class InvitationError extends CirclesError<InvitationErrorSource> {
    constructor(message: string, options?: {
        code?: string | number;
        source?: InvitationErrorSource;
        cause?: unknown;
        context?: Record<string, any>;
    });
    /**
     * Error when no valid invitation path is found
     */
    static noPathFound(from: Address, to: Address, reason?: string): InvitationError;
    /**
     * Error when no proxy inviters are available
     */
    static noProxyInviters(inviter: Address): InvitationError;
    /**
     * Error when balance is insufficient for the requested invitations
     */
    static insufficientBalance(requestedInvites: number, availableInvites: number, requested: bigint, available: bigint, from: Address, to: Address): InvitationError;
    /**
     * Error when invitee is already registered in Circles Hub
     */
    static inviteeAlreadyRegistered(inviter: Address, invitee: Address): InvitationError;
    /**
     * Error when no addresses are provided for invitation
     */
    static noAddressesProvided(): InvitationError;
}
//# sourceMappingURL=errors.d.ts.map