@wirexapp/wpay-baas-sdk 0.1.4 → 0.1.7

package/dist/index-DETvmzdr.d.ts

@@ -0,0 +1,1715 @@
+import { c as HttpClient, L as Logger, i as SDKModule, e as ModuleContext } from './types-IKGr4nyf.js';
+import { W as WithdrawalApi } from './withdrawal.api-DsvQPbRN.js';
+
+/**
+ * Activity Feed endpoints - Types match API spec
+ */
+type ActivityType = 'Deposit' | 'Withdrawal' | 'Exchange' | 'Sepa' | 'FasterPayment' | 'AchPull' | 'AchPush' | 'Swift' | 'CardTransaction' | 'ExternalCardTransaction' | 'Crypto' | 'Spei' | 'CardFeesPayment' | 'YieldClaim' | 'CardTransfer' | 'Pix' | 'FpsHk' | 'Imps' | 'Instapay' | 'BiFast' | 'Nip' | 'Ipp' | 'Pse';
+type ActivitySortOrder = 'name' | 'usage';
+type ActivityStatus = 'Pending' | 'Completed' | 'Failed';
+type ActivityDirection = 'Inbound' | 'Outbound' | 'Internal';
+type ActivityStepType = 'Initiated' | 'CryptoIn' | 'CryptoOut' | 'BankIn' | 'BankOut' | 'CardIn' | 'CardOut' | 'Review' | 'Reversal' | 'Completed' | 'SyntheticWrap' | 'SyntheticUnwrap';
+type ActivitySubjectType = 'Wallet' | 'Cards' | 'Merchant' | 'SepaBankAccount' | 'FasterPaymentBankAccount' | 'AchBankAccount' | 'SwiftBankAccount' | 'SpeiBankAccount' | 'ExternalCard' | 'ExternalWallet';
+type ActivityRewardType = 'Cashback' | 'Bonus';
+interface ActivityAmount {
+    amount: number;
+    currency?: string;
+    token_symbol?: string;
+    token_address?: string;
+}
+interface ActivityRate {
+    ticker: string;
+    rate: number;
+}
+interface ActivitySubjectWallet {
+    address: string;
+}
+interface ActivitySubjectCard {
+    id?: string;
+    pan_last?: string;
+    payment_system?: string;
+}
+interface ActivitySubjectMerchant {
+    id?: string;
+    name?: string;
+    logo_url?: string;
+    website_url?: string;
+    phone_number?: string;
+    full_address?: string;
+    latitude?: string;
+    longitude?: string;
+    category?: string;
+}
+interface ActivitySubjectBankAccount {
+    account_number?: string;
+    sort_code?: string;
+    routing_number?: string;
+    iban?: string;
+    bic?: string;
+    owner_name?: string;
+    is_business?: boolean;
+}
+interface ActivitySubject {
+    type?: ActivitySubjectType;
+    wallet?: ActivitySubjectWallet;
+    card?: ActivitySubjectCard;
+    merchant?: ActivitySubjectMerchant;
+    bank_account?: ActivitySubjectBankAccount;
+}
+interface ActivityStep {
+    created_at: string;
+    completed_at?: string;
+    status: ActivityStatus;
+    status_reason?: string;
+    type: ActivityStepType;
+}
+interface ActivityRecipient {
+    id?: string;
+    name: string;
+}
+interface ActivityReward {
+    id?: string;
+    amount?: ActivityAmount;
+    destination?: ActivitySubject;
+    status?: string;
+    type?: string;
+}
+interface ActivityOperation {
+    hash: string;
+    operation_amount: ActivityAmount;
+    transaction_amount: ActivityAmount;
+    rate?: ActivityRate;
+}
+interface ActivityItem {
+    id: string;
+    created_at: string;
+    user_address?: string;
+    source: ActivitySubject;
+    destination: ActivitySubject;
+    source_amount?: ActivityAmount;
+    destination_amount?: ActivityAmount;
+    direction: ActivityDirection;
+    status: ActivityStatus;
+    status_reason?: string;
+    sub_type?: string;
+    type: ActivityType;
+    rate?: ActivityRate;
+    reference?: string;
+    activity_steps?: ActivityStep[];
+    operations?: ActivityOperation[];
+    recipient?: ActivityRecipient;
+    reward?: ActivityReward;
+}
+interface StatementBalance {
+    opening?: number;
+    closing?: number;
+    debit?: number;
+    credit?: number;
+    currency?: string;
+}
+interface StatementPeriod {
+    start: number;
+    end: number;
+}
+interface StatementTransaction {
+    amount?: number;
+    created_at?: number;
+    [key: string]: unknown;
+}
+interface StatementUserData {
+    legal_name?: string;
+    residence_address?: string;
+    [key: string]: unknown;
+}
+interface StatementBankAccountsResponse {
+    data?: unknown[];
+}
+interface GetActivityFeedRequest {
+    page_number?: number;
+    page_size?: number;
+    sort?: ActivitySortOrder;
+    /** Filter by subject (wallet address, card ID, or account reference). Do not use together with types. */
+    subject?: string;
+    /** Filter by activity types. Do not use together with subject. */
+    types?: ActivityType[];
+}
+interface GetActivityByIdRequest {
+    id: string;
+}
+interface GetFullStatementRequest {
+    start: number;
+    end: number;
+}
+interface ActivityFeedResponse {
+    data: ActivityItem[];
+}
+interface ActivityFullStatementResponse {
+    balances?: StatementBalance[];
+    chain_id?: number;
+    created_at?: number;
+    owner?: string;
+    period?: StatementPeriod;
+    transactions?: StatementTransaction[];
+    user_bank_accounts?: StatementBankAccountsResponse;
+    user_data?: StatementUserData;
+}
+interface RequestedErcWithdrawalResponse {
+    account_address: string;
+    amount: number;
+    call_data: string;
+    hash: string;
+    to_address: string;
+    token_address: string;
+    valid_after: string;
+    valid_before: string;
+}
+interface RequestedErcWithdrawalsResponse {
+    data: RequestedErcWithdrawalResponse[];
+}
+
+interface PrivyAuth {
+    accessToken: string;
+    identityToken: string;
+}
+interface LoginUserParams {
+    privy?: PrivyAuth;
+    authorizationToken?: string;
+    userWallet?: string;
+}
+interface LoginCompanyParams {
+    privy?: PrivyAuth;
+    authorizationToken?: string;
+    /** Required for Privy auth. Optional for partner token auth. */
+    companyAddress?: string;
+}
+interface UserProfile {
+    date_of_birth: string;
+    email: string;
+    first_name: string;
+    last_name: string;
+    nationality: string;
+    phone_number: string;
+}
+interface ResidenceAddress {
+    city: string;
+    country: string;
+    line1: string;
+    line2?: string;
+    post_code: string;
+    state?: string;
+}
+interface InitialData {
+    profile: UserProfile;
+    residence_address: ResidenceAddress;
+}
+interface RegisterUserParams {
+    privy?: PrivyAuth;
+    authorizationToken?: string;
+    userWallet?: string;
+    country: string;
+    initialData?: InitialData;
+}
+interface RegisterCompanyParams {
+    privy?: PrivyAuth;
+    authorizationToken?: string;
+    companyAddress: string;
+    companyName: string;
+    registrationCountry: string;
+    registrationNumber: string;
+}
+interface AuthResponse {
+    access_token: string;
+    expires_at: number;
+}
+interface RegisterUserResponse {
+    id: string;
+}
+interface ValidateUserParams {
+    privy: PrivyAuth;
+    email?: string;
+    phoneNumber?: string;
+}
+interface ValidateUserResponse {
+    valid: boolean;
+    errors?: string[];
+}
+interface SendVerificationLinkRequest {
+    email: string;
+}
+interface VerifyTokenRequest {
+    token: string;
+}
+interface VerifyTokenResponse {
+    valid: boolean;
+    userId?: string;
+}
+
+declare class AuthService {
+    private static instance;
+    private readonly httpClient;
+    private readonly logger?;
+    private readonly chainId;
+    private state;
+    private constructor();
+    static initialize(config: {
+        httpClient: HttpClient;
+        chainId: number;
+        logger?: Logger;
+    }): AuthService;
+    static getInstance(): AuthService;
+    static resetInstance(): void;
+    static buildAuthHeaders(params: LoginUserParams): Record<string, string>;
+    login(params: LoginUserParams): Promise<AuthResponse>;
+    loginCompany(params: LoginCompanyParams): Promise<AuthResponse>;
+    registerUser(params: RegisterUserParams): Promise<RegisterUserResponse>;
+    registerCompany(params: RegisterCompanyParams): Promise<void>;
+    setAuthState(response: AuthResponse, userWallet?: string): void;
+    setUserWallet(wallet: string): void;
+    getAccessToken(): string | null;
+    isAuthenticated(): boolean;
+    getUserWallet(): string | null;
+    private isTokenExpired;
+    clearAuth(): void;
+    ensureAuthenticated(): void;
+    getAuthHeaders(): Record<string, string>;
+}
+
+/**
+ * Activity Service – activity feed and statement endpoints.
+ * Auth is handled by HttpClient (no per-call auth or headers).
+ */
+declare class ActivityService {
+    private readonly httpClient;
+    private readonly authService;
+    private readonly logger?;
+    constructor(config: {
+        httpClient: HttpClient;
+        authService: AuthService;
+        logger?: Logger;
+    });
+    /**
+     * Retrieves activity feed with optional pagination and filters.
+     */
+    getFeed(request?: GetActivityFeedRequest): Promise<ActivityFeedResponse>;
+    /**
+     * Retrieves a single activity item by id.
+     */
+    getById(request: GetActivityByIdRequest): Promise<ActivityItem>;
+    /**
+     * Retrieves full statement for the given date range (Unix timestamps).
+     */
+    getFullStatement(request: GetFullStatementRequest): Promise<ActivityFullStatementResponse>;
+    /**
+     * Retrieves requested ERC withdrawals for the authenticated account.
+     */
+    getRequestedErcWithdrawals(): Promise<RequestedErcWithdrawalsResponse>;
+}
+
+/**
+ * Bank endpoints - Types match API spec
+ */
+type BankAccountType = 'Sepa' | 'Swift' | 'FasterPayment' | 'Ach' | 'Spei';
+type BankAccountStatus = 'Active' | 'Pending' | 'Blocked' | 'Closed';
+type BankSortOrder = 'name' | 'usage';
+interface LegalAddress {
+    city: string;
+    country: string;
+    line1: string;
+    line2?: string;
+    state?: string;
+    zip_code: string;
+}
+interface RecipientInfo {
+    first_name?: string;
+    last_name?: string;
+    company_name?: string;
+}
+interface RecipientAccount {
+    account_number?: string;
+    sort_code?: string;
+    routing_number?: string;
+    iban?: string;
+    bic?: string;
+    clabe?: string;
+    bank_name?: string;
+    legal_address?: LegalAddress;
+}
+interface BankAccountDetails {
+    account_number?: string;
+    sort_code?: string;
+    routing_number?: string;
+    iban?: string;
+    bic?: string;
+    clabe?: string;
+    mandatory_reference?: string;
+}
+interface EstimatedAmount {
+    amount: number;
+    precise_amount: string;
+    token_address: string;
+    token_symbol: string;
+    rate: number;
+}
+interface GetBankAccountsRequest {
+    page_number?: number;
+    page_size?: number;
+    sort?: BankSortOrder;
+}
+interface ActivateBankAccountRequest {
+    account_type: BankAccountType;
+}
+interface EstimateTransferRequest {
+    account_id: string;
+    amount: number;
+    tokens?: string[];
+}
+interface ExecuteTransferRequest {
+    account_id: string;
+    token_address: string;
+    recipient: RecipientInfo;
+    recipient_account: RecipientAccount;
+    reference?: string;
+    amount?: number;
+    estimation_id?: string;
+}
+interface CorridorEstimateRequest {
+    account_id?: string;
+    corridor: string;
+    destination_amount: number;
+    destination_currency?: string;
+    recipient_id: string;
+    recipient_payment_details_id: string;
+    source_tokens?: string[];
+}
+interface CorridorTransferRequest {
+    corridor: string;
+    estimation_id: string;
+    sourceTokenAddress: string;
+}
+interface BankAccount {
+    id: string;
+    currency: string;
+    status: BankAccountStatus;
+    account_holder?: string;
+    account_type: BankAccountType;
+    details?: BankAccountDetails;
+}
+interface BankAccountsResponse {
+    data: BankAccount[];
+}
+interface ActivateBankAccountResponse {
+    details_id: string;
+}
+interface EstimateTransferResponse {
+    id: string;
+    expires_at: number;
+    amount: number;
+    currency: string;
+    estimated_amounts: EstimatedAmount[];
+}
+interface ExecuteTransferResponse {
+    id: string;
+}
+interface BankCorridorEstimateResponse {
+    amount: number;
+    currency: string;
+    estimated_amounts: EstimatedAmount[];
+    expires_at: number;
+    id: string;
+}
+interface BankCorridorExecuteResponse {
+    id: string;
+}
+
+/**
+ * Bank Service – bank accounts and transfer endpoints.
+ * Auth is handled by HttpClient (no per-call auth or headers).
+ */
+declare class BankService {
+    private readonly httpClient;
+    private readonly authService;
+    private readonly logger?;
+    constructor(config: {
+        httpClient: HttpClient;
+        authService: AuthService;
+        logger?: Logger;
+    });
+    /**
+     * Retrieves a list of bank accounts that belong to the user.
+     */
+    getAccounts(request?: GetBankAccountsRequest): Promise<BankAccountsResponse>;
+    /**
+     * Activates bank account details for the specified account type.
+     */
+    activateAccount(request: ActivateBankAccountRequest): Promise<ActivateBankAccountResponse>;
+    /**
+     * Estimates the amounts that would be charged for a bank transfer according to the current market rates.
+     */
+    estimateTransfer(request: EstimateTransferRequest): Promise<EstimateTransferResponse>;
+    /**
+     * Executes the bank transfer either according to the estimation made previously or using current market rates.
+     */
+    executeTransfer(request: ExecuteTransferRequest): Promise<ExecuteTransferResponse>;
+    /**
+     * Estimates the amounts for a bank transfer via specified corridor.
+     */
+    estimateCorridorTransferV2(corridor: string, request: CorridorEstimateRequest): Promise<BankCorridorEstimateResponse>;
+    /**
+     * Executes transfer using estimation_id. All recipient details resolved from stored estimation.
+     */
+    executeCorridorTransferV2(corridor: string, request: CorridorTransferRequest): Promise<BankCorridorExecuteResponse>;
+}
+
+/**
+ * Cards endpoints - Types match API spec
+ */
+type CardSortOrder = 'name' | 'usage';
+type CardActionType = 'Activate' | 'Block' | 'Unblock' | 'Close' | 'SetLimit' | 'GetDetails' | 'GetCvv' | 'GetPin' | 'SetActiveBalance';
+type CardFormat = 'Plastic' | 'Virtual' | 'Metal';
+type CardGeneration = 'Gen1' | 'Gen2';
+type CardPaymentSystem = 'Visa' | 'MasterCard';
+type CardProvider = 'Wirex' | 'Bridge';
+type CardStatus = 'Requested' | 'NotActivated' | 'Active' | 'Closed' | 'Blocked';
+type CardTransactionDirection = 'Inbound' | 'Outbound';
+type CardTransactionStatus = 'Pending' | 'Completed' | 'Failed';
+type CardTransactionType = 'POS' | 'ePOS' | 'ATM';
+interface GetCardsRequest {
+    page_number?: number;
+    page_size?: number;
+    sort?: CardSortOrder;
+}
+interface GetCardTransactionsRequest {
+    page_number?: number;
+    page_size?: number;
+    sort?: CardSortOrder;
+}
+interface CardActivateRequestBody {
+    card_number_last4: string;
+    expiry_date: string;
+}
+interface CardDeliveryAddress {
+    city: string;
+    country: string;
+    line1: string;
+    line2?: string;
+    state?: string;
+    zip_code: string;
+}
+interface CardDetailsGetCvvRequestBody {
+    action_token: string;
+}
+interface CardDetailsGetDetailsRequestBody {
+    action_token: string;
+}
+interface CardDetailsGetPinRequestBody {
+    action_token: string;
+}
+interface CardFeesCreateInvoiceRequestBody {
+    /**
+     * Courier type that should be used to deliver the card
+     * MUST be present if card type IS NOT Virtual
+     */
+    delivery_provider?: string;
+    token_address: string;
+}
+interface CardIssuePlasticRequest {
+    card_name?: string;
+    delivery_address: CardDeliveryAddress;
+    delivery_provider?: string;
+    name_on_card?: string;
+    /**
+     * Transaction hash in bounds of which the card issuance fees were paid
+     * MUST be provided in case order/delivery fees are in place
+     */
+    payment_transaction_hash?: string;
+}
+interface CardIssueVirtualRequest {
+    card_name?: string;
+    name_on_card?: string;
+    /**
+     * Transaction hash in bounds of which the card issuance fees were paid
+     * MUST be provided in case order/delivery fees are in place
+     */
+    payment_transaction_hash?: string;
+}
+interface CardLimitChangeRequestBody {
+    limit: number;
+}
+interface CardNameChangeRequestBody {
+    name: string;
+}
+interface CardTransferEstimateRequest {
+    amount: number;
+    currency?: string;
+    external_card_id: string;
+    tokens: string[];
+}
+interface CardTransferExecuteRequest {
+    estimation_id: string;
+    token_address: string;
+}
+interface CardWithdrawalEstimateRequestBody {
+    amount: number;
+    correlation_id: string;
+    currency: string;
+    destinationAddress: string;
+}
+interface CardWithdrawalExecuteRequestBody {
+    estimation_id: string;
+}
+interface CardAction {
+    relative_path: string;
+    type: CardActionType;
+}
+interface CardBalance {
+    balance: number;
+    is_active: boolean;
+    reference_balance: number;
+    reference_currency: string;
+    token_address: string;
+    token_symbol: string;
+}
+interface CardData {
+    card_name: string;
+    card_number_first_4?: string;
+    card_number_last_4?: string;
+    expiry_date?: string;
+    format: CardFormat;
+    name_on_card: string;
+    payment_system: CardPaymentSystem;
+}
+interface DeliveryAddress {
+    city: string;
+    country: string;
+    line1: string;
+    line2?: string;
+    state?: string;
+    zip_code: string;
+}
+interface CardLimit {
+    currency: string;
+    daily_limit: number;
+    daily_usage: number;
+}
+interface EstimatedAmountResponse {
+    amount: number;
+    precise_amount: string;
+    rate: number;
+    token_address: string;
+    token_symbol: string;
+}
+interface CardResponse {
+    allowed_actions: CardAction[];
+    balances?: CardBalance[];
+    card_data: CardData;
+    card_wallet_address: string;
+    created_at: string;
+    delivery_address?: DeliveryAddress;
+    generation: CardGeneration;
+    id: string;
+    limit?: CardLimit;
+    previous_status?: CardStatus;
+    provider: CardProvider;
+    status: CardStatus;
+    status_reason?: string;
+    updated_at?: string;
+}
+interface CardsResponse {
+    data: CardResponse[];
+}
+interface CardDeliveryMethod {
+    currency: string;
+    estimated_payment_amounts?: EstimatedAmountResponse[];
+    fee: number;
+    provider: string;
+}
+interface CardDetailsCvvResponse {
+    cvv: string;
+}
+interface CardDetailsPanExpiryResponse {
+    card_number: string;
+    expiry_date: string;
+}
+interface CardDetailsPinResponse {
+    pin: string;
+}
+interface CardFeesInvoiceResponse {
+    payment_amount: EstimatedAmountResponse;
+    recipient_address: string;
+}
+interface CardFeesOrderResponse {
+    currency: string;
+    estimated_payment_amounts?: EstimatedAmountResponse[];
+    order_fee: number;
+}
+interface CardIssueResponse {
+    id: string;
+}
+interface CardTransactionConfirmationResponse {
+    amount: string;
+    card_id: string;
+    card_last_4: string;
+    currency: string;
+    merchant_name: string;
+    owner: string;
+    transaction_id: string;
+}
+interface CardTransactionResponseCardAmount {
+    amount: number;
+    currency: string;
+}
+interface CardTransactionResponseMerchantAmount {
+    amount: number;
+    currency: string;
+}
+interface CardTransactionResponseMerchantDetails {
+    full_address?: string;
+    latitude?: string;
+    logo_url?: string;
+    longitude?: string;
+    name: string;
+    website?: string;
+}
+interface CardTransactionResponse {
+    card_amount?: CardTransactionResponseCardAmount;
+    card_id: string;
+    comment?: string;
+    created_at: string;
+    direction: CardTransactionDirection;
+    id: string;
+    merchant_amount?: CardTransactionResponseMerchantAmount;
+    merchant_details?: CardTransactionResponseMerchantDetails;
+    status: CardTransactionStatus;
+    status_reason?: string;
+    type: CardTransactionType;
+    updated_at?: string;
+}
+interface CardTransactionsResponse {
+    data: CardTransactionResponse[];
+}
+interface CardTransferEstimateResponse {
+    amount: number;
+    currency: string;
+    estimated_amounts: EstimatedAmountResponse[];
+    estimation_id: string;
+    expires_at: number;
+    fee_amount: number;
+}
+interface CardTransferExecuteResponse {
+    id: string;
+}
+interface CardWithdrawalEstimateResponse {
+    amount: number;
+    currency: string;
+    estimation_id: string;
+    expires_at: number;
+    fee_amount: number;
+}
+interface CardWithdrawalExecuteResponse {
+    id: string;
+}
+
+interface ApiResponse<T> {
+    data: T;
+    success: boolean;
+    message?: string;
+}
+interface PaginatedResponse<T> {
+    data: T[];
+    total: number;
+    page: number;
+    limit: number;
+    hasMore: boolean;
+}
+interface ApiError {
+    code: string;
+    message: string;
+    details?: Record<string, unknown>;
+}
+type EmptyResponse = Record<string, never>;
+
+/**
+ * Cards Service – card issuance, management, and transfers.
+ */
+declare class CardsService {
+    private readonly httpClient;
+    private readonly authService;
+    private readonly logger?;
+    constructor(config: {
+        httpClient: HttpClient;
+        authService: AuthService;
+        logger?: Logger;
+    });
+    /**
+     * Retrieves list of cards that belong to the user.
+     */
+    getCards(request?: GetCardsRequest): Promise<CardsResponse>;
+    /**
+     * Retrieves a page of card transactions associated with the user.
+     */
+    getCardTransactions(request?: GetCardTransactionsRequest): Promise<CardTransactionsResponse>;
+    /**
+     * Retrieves single card by its id.
+     */
+    getCard(cardId: string): Promise<CardResponse>;
+    /**
+     * Retrieves active 3DS requests that need to be either approved or declined.
+     */
+    getActive3dsRequests(): Promise<CardTransactionConfirmationResponse[]>;
+    /**
+     * Approves 3DS request allowing the transaction to proceed.
+     */
+    approve3dsRequest(transactionId: string): Promise<EmptyResponse>;
+    /**
+     * Declines 3DS request blocking the transaction from proceeding.
+     */
+    decline3dsRequest(transactionId: string): Promise<EmptyResponse>;
+    /**
+     * Retrieves list of countries where the card can be delivered for the current corporation.
+     */
+    getDeliveryCountries(): Promise<string[]>;
+    /**
+     * Retrieves list of courier providers that can deliver the card to the specified country.
+     */
+    getDeliveryMethods(country: string): Promise<CardDeliveryMethod[]>;
+    /**
+     * Issues a plastic card for the specified user and sends it to the provided address.
+     */
+    issuePlasticCard(request: CardIssuePlasticRequest): Promise<CardIssueResponse>;
+    /**
+     * Issues a virtual card for the specified user.
+     */
+    issueVirtualCard(request: CardIssueVirtualRequest): Promise<CardIssueResponse>;
+    /**
+     * Activates a card that has been issued to a user and is currently in NotActivated state.
+     */
+    activateCard(cardId: string, request: CardActivateRequestBody): Promise<EmptyResponse>;
+    /**
+     * Blocks selected card making it impossible to use it for any transactions.
+     */
+    blockCard(cardId: string): Promise<EmptyResponse>;
+    /**
+     * Unblocks selected card allowing it to be used for transactions once again.
+     */
+    unblockCard(cardId: string): Promise<EmptyResponse>;
+    /**
+     * Closes the card. This action cannot be undone and the card will be permanently closed.
+     */
+    closeCard(cardId: string): Promise<EmptyResponse>;
+    /**
+     * Retrieves card PAN and expiry date using the action confirmation token.
+     */
+    getCardDetails(cardId: string, request: CardDetailsGetDetailsRequestBody): Promise<CardDetailsPanExpiryResponse>;
+    /**
+     * Retrieves CVV code for the card using the action confirmation token.
+     */
+    getCardCvv(cardId: string, request: CardDetailsGetCvvRequestBody): Promise<CardDetailsCvvResponse>;
+    /**
+     * Retrieves card Pin code using the action confirmation token.
+     */
+    getCardPin(cardId: string, request: CardDetailsGetPinRequestBody): Promise<CardDetailsPinResponse>;
+    /**
+     * Updates maximum amount that can be spent using the card within a day.
+     */
+    changeCardLimit(cardId: string, request: CardLimitChangeRequestBody): Promise<EmptyResponse>;
+    /**
+     * Updates the display name of the card.
+     */
+    changeCardName(cardId: string, request: CardNameChangeRequestBody): Promise<EmptyResponse>;
+    /**
+     * Creates a new card transfer estimation.
+     */
+    estimateCardTransfer(request: CardTransferEstimateRequest): Promise<CardTransferEstimateResponse>;
+    /**
+     * Executes the estimated card transfer request.
+     */
+    executeCardTransfer(request: CardTransferExecuteRequest): Promise<CardTransferExecuteResponse>;
+    /**
+     * Creates a new withdrawal estimation for the card.
+     */
+    estimateCardWithdrawal(cardId: string, request: CardWithdrawalEstimateRequestBody): Promise<CardWithdrawalEstimateResponse>;
+    /**
+     * Executes the estimated withdrawal request for the card.
+     */
+    executeCardWithdrawal(cardId: string, request: CardWithdrawalExecuteRequestBody): Promise<CardWithdrawalExecuteResponse>;
+    /**
+     * Retrieves estimation of fees that should be paid for the card order.
+     */
+    getOrderFees(type: CardFormat, country: string): Promise<CardFeesOrderResponse>;
+    /**
+     * Creates an invoice for payment of the card order fees.
+     */
+    createOrderFeesInvoice(type: CardFormat, country: string, request: CardFeesCreateInvoiceRequestBody): Promise<CardFeesInvoiceResponse>;
+}
+
+interface ConfigAnalytics {
+    amplitudeApiKey?: string;
+    googleAnalyticsId?: string;
+    googleTagManagerId?: string;
+}
+interface ConfigApi {
+    apiUrl?: string;
+    socketIo?: string;
+}
+interface ConfigAuth {
+    crossmintApiKey?: string;
+    crossmintAppId?: string;
+    googleApiKey?: string;
+    privyAppId?: string;
+    privyClientId?: string;
+    rhinoApiKey?: string;
+}
+interface ConfigChain {
+    id?: number;
+    name?: string;
+    rpcUrl?: string;
+    rpcWsUrl?: string;
+    blockExplorerUrl?: string;
+    bridgeUrl?: string;
+    bundlerUrl?: string;
+    paymasterUrl?: string;
+    contractRegistry?: string;
+}
+interface ConfigSupport {
+    chatUrl?: string;
+    widgetId?: string;
+}
+interface ClientAppConfig {
+    analytics?: ConfigAnalytics;
+    api?: ConfigApi;
+    auth?: ConfigAuth;
+    chains?: Record<string, ConfigChain>;
+    defaultChain?: ConfigChain;
+    defaultCompanyId?: string;
+    support?: ConfigSupport;
+}
+
+/**
+ * Config Service - application configuration endpoints.
+ */
+declare class ConfigService {
+    private readonly httpClient;
+    private readonly authService;
+    private readonly logger?;
+    constructor(config: {
+        httpClient: HttpClient;
+        authService: AuthService;
+        logger?: Logger;
+    });
+    /**
+     * Retrieves application configuration values for a partner application.
+     */
+    getConfig(): Promise<ClientAppConfig>;
+}
+
+/**
+ * Confirmation endpoints - Types match API spec
+ */
+type ConfirmationActionType = 'GetCardDetails' | '3dsChallenge' | 'VerifyPhone';
+interface ActionConfirmationCreateSmsRequest {
+    action_type: ConfirmationActionType;
+}
+/**
+ * Payload for exchanging a wallet signature for an action-confirmation token
+ * (`POST api/v1/confirmation/signature/verify`).
+ *
+ * The signed message must follow the canonical template:
+ * `By signing this I confirm that I am executing action {action_type} at {nonce}`
+ */
+interface ActionConfirmationCreateTokenRequest {
+    action_type: ConfirmationActionType;
+    /**
+     * Signature of the canonical payload, produced with the user's main-wallet
+     * private key:
+     * `By signing this I confirm that I am executing action {action_type} at {nonce}`
+     */
+    message_signature: string;
+    /** Unix timestamp in **seconds** used when forming the signed payload. */
+    nonce: number;
+}
+interface ActionConfirmationVerifySmsRequest {
+    code: string;
+    session_id: string;
+}
+interface ActionConfirmationSmsSessionResponse {
+    attempts_left: number;
+    code_length: number;
+    expires_at: string;
+    resend_at: string;
+    session_id: string;
+}
+interface ActionTokenResponse {
+    /**
+     * Signed JWT used to confirm the requested action. The token's expiry
+     * (TTL, ~5 min) is encoded inside the JWT itself — the backend does not
+     * return a separate `expires_at` field.
+     */
+    action_token: string;
+}
+interface TokenResponse {
+    token: string;
+}
+
+/**
+ * Confirmation Service - action confirmation endpoints.
+ * Auth is handled by HttpClient (no per-call auth or headers).
+ */
+declare class ConfirmationService {
+    private readonly httpClient;
+    private readonly authService;
+    private readonly logger?;
+    constructor(config: {
+        httpClient: HttpClient;
+        authService: AuthService;
+        logger?: Logger;
+    });
+    /**
+     * Exchanges wallet signature for an action token.
+     */
+    verifySignature(request: ActionConfirmationCreateTokenRequest): Promise<ActionTokenResponse>;
+    /**
+     * Sends SMS with OTP code to the user.
+     */
+    requestSms(request: ActionConfirmationCreateSmsRequest): Promise<ActionConfirmationSmsSessionResponse>;
+    /**
+     * Exchanges SMS OTP code for an action token.
+     */
+    verifySms(request: ActionConfirmationVerifySmsRequest): Promise<TokenResponse>;
+}
+
+/**
+ * Recipients endpoints - Types match API spec
+ */
+type RecipientSortOrder = 'name' | 'usage';
+type RecipientDetailsType = 'Crypto' | 'Sepa' | 'FasterPayment' | 'Ach' | 'Swift' | 'Spei' | 'Card' | 'Pix' | 'FpsHk' | 'Imps' | 'Instapay' | 'BiFast' | 'Nip' | 'Ipp' | 'Pse';
+interface GetRecipientsRequest {
+    page_number?: number;
+    page_size?: number;
+    sort?: RecipientSortOrder;
+}
+interface GetRecipientsByCatalogRequest extends GetRecipientsRequest {
+    catalog_index: string;
+}
+interface GetRecipientsByCurrencyRequest extends GetRecipientsRequest {
+    currency: string;
+}
+interface GetRecipientsByNameRequest extends GetRecipientsRequest {
+    name: string;
+}
+interface GetRecipientsByTypeRequest extends GetRecipientsRequest {
+    type: RecipientDetailsType;
+}
+interface RecipientCreateRequest {
+    first_name?: string;
+    last_name?: string;
+    company_name?: string;
+    is_business: boolean;
+    nick_name?: string;
+}
+interface RecipientCreateRequestV2 {
+    first_name?: string;
+    last_name?: string;
+    company_name?: string;
+    is_business: boolean;
+    nick_name?: string;
+    type: RecipientDetailsType;
+    currencies: string[];
+    ach?: RecipientPaymentDetailsAch;
+    bi_fast?: RecipientPaymentDetailsBiFast;
+    card?: RecipientPaymentDetailsCard;
+    crypto?: RecipientPaymentDetailsCrypto;
+    faster_payments?: RecipientPaymentDetailsFasterPayment;
+    fps_hk?: RecipientPaymentDetailsFpsHk;
+    imps?: RecipientPaymentDetailsImps;
+    instapay?: RecipientPaymentDetailsInstapay;
+    ipp?: RecipientPaymentDetailsIpp;
+    nip?: RecipientPaymentDetailsNip;
+    pix?: RecipientPaymentDetailsPix;
+    pse?: RecipientPaymentDetailsPse;
+    sepa?: RecipientPaymentDetailsSepa;
+    spei?: RecipientPaymentDetailsSpei;
+    swift?: RecipientPaymentDetailsSwift;
+}
+interface RecipientUpdateRequestBody {
+    first_name?: string;
+    last_name?: string;
+    company_name?: string;
+    is_business: boolean;
+    nick_name?: string;
+}
+interface RecipientPaymentDetailsLegalAddress {
+    city: string;
+    country: string;
+    line1: string;
+    line2?: string;
+    state?: string;
+    zip_code: string;
+}
+interface RecipientPaymentDetailsAch {
+    account_number: string;
+    bank_name?: string;
+    legal_address: RecipientPaymentDetailsLegalAddress;
+    routing_number: string;
+}
+interface RecipientPaymentDetailsBiFast {
+    account_number: string;
+    bank_code: string;
+    bank_name?: string;
+    destination_country: string;
+    recipient_name: string;
+}
+interface RecipientPaymentDetailsCard {
+    card_id: string;
+    card_pan_last: string;
+}
+interface RecipientPaymentDetailsCrypto {
+    address: string;
+    network: string;
+}
+interface RecipientPaymentDetailsFasterPayment {
+    account_number: string;
+    sort_code: string;
+}
+interface RecipientPaymentDetailsFpsHk {
+    bank_code: string;
+    fps_id: string;
+    fps_id_type: string;
+    recipient_name: string;
+}
+interface RecipientPaymentDetailsImps {
+    account_number: string;
+    bank_name?: string;
+    destination_country: string;
+    ifsc_code: string;
+    recipient_name: string;
+}
+interface RecipientPaymentDetailsInstapay {
+    account_number: string;
+    bank_code: string;
+    bank_name?: string;
+    destination_country: string;
+    recipient_name: string;
+}
+interface RecipientPaymentDetailsIpp {
+    bank_name?: string;
+    destination_country: string;
+    iban: string;
+    recipient_name: string;
+}
+interface RecipientPaymentDetailsNip {
+    account_number: string;
+    bank_code: string;
+    bank_name?: string;
+    destination_country: string;
+    recipient_name: string;
+}
+interface RecipientPaymentDetailsPix {
+    pix_key: string;
+    pix_key_type: string;
+    recipient_name: string;
+}
+interface RecipientPaymentDetailsPse {
+    account_number: string;
+    account_type: string;
+    bank_code: string;
+    destination_country: string;
+    document_number: string;
+    document_type: string;
+    recipient_name: string;
+}
+interface RecipientPaymentDetailsSepa {
+    bic: string;
+    iban: string;
+}
+interface RecipientPaymentDetailsSpei {
+    clabe: string;
+}
+interface RecipientPaymentDetailsSwift {
+    bic: string;
+    iban: string;
+    legal_address: RecipientPaymentDetailsLegalAddress;
+}
+interface RecipientCreateDetailsRequestBody {
+    type: RecipientDetailsType;
+    currencies: string[];
+    ach?: RecipientPaymentDetailsAch;
+    bi_fast?: RecipientPaymentDetailsBiFast;
+    card?: RecipientPaymentDetailsCard;
+    crypto?: RecipientPaymentDetailsCrypto;
+    faster_payments?: RecipientPaymentDetailsFasterPayment;
+    fps_hk?: RecipientPaymentDetailsFpsHk;
+    imps?: RecipientPaymentDetailsImps;
+    instapay?: RecipientPaymentDetailsInstapay;
+    ipp?: RecipientPaymentDetailsIpp;
+    nip?: RecipientPaymentDetailsNip;
+    pix?: RecipientPaymentDetailsPix;
+    pse?: RecipientPaymentDetailsPse;
+    sepa?: RecipientPaymentDetailsSepa;
+    spei?: RecipientPaymentDetailsSpei;
+    swift?: RecipientPaymentDetailsSwift;
+}
+type RecipientUpdateDetailsRequestBody = RecipientCreateDetailsRequestBody;
+interface RecipientPersonalInfo {
+    first_name?: string;
+    last_name?: string;
+    company_name?: string;
+    is_business: boolean;
+    nick_name?: string;
+}
+interface RecipientPaymentDetailsResponse {
+    id: string;
+    type: RecipientDetailsType;
+    currencies: string[];
+    ach?: RecipientPaymentDetailsAch;
+    bi_fast?: RecipientPaymentDetailsBiFast;
+    card?: RecipientPaymentDetailsCard;
+    crypto?: RecipientPaymentDetailsCrypto;
+    faster_payment?: RecipientPaymentDetailsFasterPayment;
+    fps_hk?: RecipientPaymentDetailsFpsHk;
+    imps?: RecipientPaymentDetailsImps;
+    instapay?: RecipientPaymentDetailsInstapay;
+    ipp?: RecipientPaymentDetailsIpp;
+    nip?: RecipientPaymentDetailsNip;
+    pix?: RecipientPaymentDetailsPix;
+    pse?: RecipientPaymentDetailsPse;
+    sepa?: RecipientPaymentDetailsSepa;
+    spei?: RecipientPaymentDetailsSpei;
+    swift?: RecipientPaymentDetailsSwift;
+}
+interface RecipientResponse {
+    id: string;
+    personal_info: RecipientPersonalInfo;
+    payment_details?: RecipientPaymentDetailsResponse[];
+}
+interface RecipientsResponse {
+    data: RecipientResponse[];
+}
+
+/**
+ * Recipients Service – recipients and payment details endpoints.
+ */
+declare class RecipientsService {
+    private readonly httpClient;
+    private readonly authService;
+    private readonly logger?;
+    constructor(config: {
+        httpClient: HttpClient;
+        authService: AuthService;
+        logger?: Logger;
+    });
+    /**
+     * Retrieves all recipients with optional pagination and sorting.
+     */
+    getRecipients(request?: GetRecipientsRequest): Promise<RecipientsResponse>;
+    /**
+     * Retrieves recipients filtered by catalog index (first letter of full name).
+     */
+    getRecipientsByCatalog(request: GetRecipientsByCatalogRequest): Promise<RecipientsResponse>;
+    /**
+     * Retrieves recipients filtered by currency.
+     */
+    getRecipientsByCurrency(request: GetRecipientsByCurrencyRequest): Promise<RecipientsResponse>;
+    /**
+     * Retrieves recipients filtered by name substring.
+     */
+    getRecipientsByName(request: GetRecipientsByNameRequest): Promise<RecipientsResponse>;
+    /**
+     * Retrieves recipients filtered by payment details type.
+     */
+    getRecipientsByType(request: GetRecipientsByTypeRequest): Promise<RecipientsResponse>;
+    /**
+     * Creates a new recipient with provided personal information.
+     */
+    createRecipient(request: RecipientCreateRequest): Promise<RecipientResponse>;
+    /**
+     * Creates a recipient with personal info and payment details in a single call.
+     */
+    createRecipientV2(request: RecipientCreateRequestV2): Promise<RecipientResponse>;
+    /**
+     * Retrieves a single recipient by its ID.
+     */
+    getRecipientById(recipientId: string): Promise<RecipientResponse>;
+    /**
+     * Updates recipient with provided personal information.
+     */
+    updateRecipient(recipientId: string, request: RecipientUpdateRequestBody): Promise<EmptyResponse>;
+    /**
+     * Deletes selected recipient.
+     */
+    deleteRecipient(recipientId: string): Promise<EmptyResponse>;
+    /**
+     * Creates new payment details for existing recipient.
+     */
+    createRecipientPaymentDetails(recipientId: string, request: RecipientCreateDetailsRequestBody): Promise<RecipientPaymentDetailsResponse>;
+    /**
+     * Updates existing payment details for existing recipient.
+     */
+    updateRecipientPaymentDetails(recipientId: string, paymentDetailsId: string, request: RecipientUpdateDetailsRequestBody): Promise<EmptyResponse>;
+    /**
+     * Deletes payment details from existing recipient.
+     */
+    deleteRecipientPaymentDetails(recipientId: string, paymentDetailsId: string): Promise<EmptyResponse>;
+    /**
+     * Increments usage index on specified recipient.
+     */
+    incrementRecipientUsage(recipientId: string): Promise<EmptyResponse>;
+}
+
+interface GetRatesRequest {
+    tickers: string[];
+}
+interface Rate {
+    ticker: string;
+    ask: number;
+    bid: number;
+}
+interface RatesResponse {
+    data: Rate[];
+}
+
+/**
+ * Rates Service - exchange rates endpoints.
+ */
+declare class RatesService {
+    private readonly httpClient;
+    private readonly authService;
+    private readonly logger?;
+    constructor(config: {
+        httpClient: HttpClient;
+        authService: AuthService;
+        logger?: Logger;
+    });
+    /**
+     * Retrieves real-time exchange rates for a list of provided tickers.
+     */
+    getRates(request: GetRatesRequest): Promise<RatesResponse>;
+}
+
+/**
+ * FX (swap) endpoints - Types match API spec.
+ * Powered by Circle FX stablecoin swaps: estimate (issues a deposit address) → execute.
+ */
+interface SwapEstimateRequestBase {
+    /** Contract address of the token to swap from (e.g. USDC). */
+    source_asset_address: string;
+    /** Contract address of the token to receive (e.g. EURC). */
+    destination_asset_address: string;
+    /** Optional client-provided identifier for tracking the request. */
+    correlation_id?: string;
+}
+interface SwapEstimateRequestBySourceAmount extends SwapEstimateRequestBase {
+    /** Amount of source token to swap. Mutually exclusive with destination_asset_amount. */
+    source_asset_amount: string;
+    destination_asset_amount?: never;
+}
+interface SwapEstimateRequestByDestinationAmount extends SwapEstimateRequestBase {
+    /** Desired amount of destination token. Mutually exclusive with source_asset_amount. */
+    destination_asset_amount: string;
+    source_asset_amount?: never;
+}
+/**
+ * Send exactly one of source_asset_amount / destination_asset_amount.
+ */
+type SwapEstimateRequest = SwapEstimateRequestBySourceAmount | SwapEstimateRequestByDestinationAmount;
+interface SwapExecuteRequest {
+    /** Estimation id returned by the estimate endpoint. */
+    estimation_id: string;
+    /** Blockchain transaction hash of the payment sent to the deposit address. */
+    payment_transaction_hash: string;
+}
+interface SwapEstimateResponse {
+    /** Unique identifier for this estimation, used when executing the swap. */
+    estimation_id: string;
+    /** Address where the client must send the source tokens. Preferred field. */
+    destination_address: string;
+    /**
+     * @deprecated Mirrors destination_address for backward compatibility. Read destination_address.
+     */
+    deposit_address: string;
+    source_asset_address: string;
+    source_asset_amount: string;
+    destination_asset_address: string;
+    destination_asset_amount: string;
+    /** Exchange rate applied to the swap. */
+    trade_rate: string;
+    /** RFC3339 timestamp after which this estimation expires. */
+    expiration_time: string;
+}
+interface SwapExecuteResponse {
+    /** Unique identifier for the executed trade. */
+    trade_id: string;
+}
+
+/**
+ * Swap Service – Circle FX stablecoin swaps.
+ * Two-step flow: estimate (issues a deposit address) → on-chain payment → execute.
+ * Auth is handled by HttpClient (no per-call auth or headers).
+ */
+declare class SwapService {
+    private readonly httpClient;
+    private readonly authService;
+    private readonly logger?;
+    constructor(config: {
+        httpClient: HttpClient;
+        authService: AuthService;
+        logger?: Logger;
+    });
+    /**
+     * Creates a swap estimation with a deposit address for a Circle FX stablecoin swap.
+     * Send exactly one of source_asset_amount / destination_asset_amount.
+     */
+    estimate(request: SwapEstimateRequest): Promise<SwapEstimateResponse>;
+    /**
+     * Executes the swap after the source tokens have been sent to the deposit address.
+     */
+    execute(request: SwapExecuteRequest): Promise<SwapExecuteResponse>;
+}
+
+interface OAuth2TokenRequest {
+    grant_type: string;
+    client_id: string;
+    client_secret: string;
+    audience?: string;
+}
+interface OAuth2TokenResponse {
+    access_token: string;
+    expires_at: number;
+    token_type: string;
+}
+
+/**
+ * Token Service - OAuth2 token endpoint.
+ */
+declare class TokenService {
+    private readonly httpClient;
+    private readonly authService;
+    private readonly logger?;
+    constructor(config: {
+        httpClient: HttpClient;
+        authService: AuthService;
+        logger?: Logger;
+    });
+    /**
+     * Exchanges client credentials for a Wirex Partner access token.
+     */
+    getToken(request: OAuth2TokenRequest): Promise<OAuth2TokenResponse>;
+}
+
+/**
+ * User Management endpoints - Types match API spec
+ */
+type UserVerificationStatus = 'None' | 'Pending' | 'Approved' | 'Rejected' | 'Canceled' | 'Applied' | 'InReview';
+type UserStatus = 'Active' | 'Blocked' | 'Deleted' | 'Pending';
+type VerificationLevel = 'N/A' | 'BDD' | 'SDD' | 'EDD';
+type CapabilityStatus = 'Active' | 'Inactive' | 'Pending' | string;
+type CapabilityType = 'SepaAccount' | 'AchAccount' | 'FasterPaymentsAccount' | 'SpeiAccount' | string;
+interface Capability {
+    type?: CapabilityType;
+    status?: CapabilityStatus;
+    status_reason?: string;
+    prerequisites?: CapabilityType[];
+}
+type UserActionType = 'ConfirmPhone' | 'IssuePlasticCard' | 'IssueVirtualCard' | 'Verify' | 'SendAchTransfer' | 'ReceiveAchDeposit' | string;
+interface UserPersonalInfo {
+    first_name?: string;
+    last_name?: string;
+    nationality?: string;
+}
+interface UserPhoneNumberData {
+    phone_number?: string;
+    is_confirmed?: boolean;
+}
+interface UserResidenceAddress {
+    city?: string;
+    country?: string;
+    line1?: string;
+    line2?: string;
+    state?: string;
+    zip_code?: string;
+}
+interface UserAction {
+    relative_path: string;
+    type: UserActionType;
+}
+/** V1 User response from GET /api/v1/user */
+interface User {
+    id?: string;
+    email?: string;
+    freshdesk_id?: string;
+    capabilities?: Capability[];
+    personal_info?: UserPersonalInfo;
+    phone_number_data?: UserPhoneNumberData;
+    residence_address?: UserResidenceAddress;
+    user_actions?: UserAction[];
+    user_status?: UserStatus;
+    verification_status?: UserVerificationStatus;
+}
+interface UpdatePhoneNumberRequest {
+    phone_number: string;
+}
+interface ConfirmPhoneNumberRequest {
+    /**
+     * Action token obtained from the Confirmation SMS OTP flow
+     * (`confirmation.requestSms` → `confirmation.verifySms`), not the raw SMS code.
+     */
+    action_token: string;
+}
+interface GetSharingTokenRequest {
+    sumsub_client_id: string;
+}
+interface GetSharingTokenResponse {
+    token: string;
+}
+interface UpdateFreshdeskIdRequest {
+    freshdesk_id: string;
+}
+interface GetVerificationTokenResponse {
+    token: string;
+}
+interface CreateUserRequest {
+    country: string;
+    email: string;
+    wallet_address: string;
+}
+interface CreateUserResponse {
+    id: string;
+}
+interface SetSharingTokenRequest {
+    sharing_token: string;
+}
+interface SetSharingTokenResponse {
+    token: string;
+}
+interface CreateRetailUserRequest {
+    country: string;
+}
+interface CreateRetailUserResponse {
+    id: string;
+}
+interface UserDescriptor {
+    email: string;
+    id: string;
+    wallet_address?: string;
+}
+interface ValidateRetailUserResponse {
+    users: UserDescriptor[];
+}
+interface GetVerificationLinkResponse {
+    redirect_uri: string;
+}
+interface AuthorizeUserResponse {
+    access_token: string;
+    expires_at: number;
+}
+interface UserProfileV2 {
+    email?: string;
+    first_name?: string;
+    last_name?: string;
+    date_of_birth?: string;
+    nationality?: string;
+    phone_number?: string;
+}
+interface UserResidenceAddressV2 extends Omit<UserResidenceAddress, 'zip_code'> {
+    post_code?: string;
+}
+interface UserDocumentV2 {
+    id?: string;
+    type?: string;
+    file_type?: string;
+    added_date?: string;
+}
+interface UserVerificationLevelV2 {
+    type?: VerificationLevel;
+    name?: string;
+    status?: UserVerificationStatus;
+}
+interface UserVerificationV2 {
+    status?: UserVerificationStatus;
+    levels?: UserVerificationLevelV2[];
+    documents?: UserDocumentV2[];
+}
+interface UserExternalProviderV2 {
+    type?: string;
+    account_id?: string;
+}
+/** V2 User response from GET /api/v2/user */
+interface UserV2 {
+    id?: string;
+    owner?: string;
+    chain_id?: number;
+    profile?: UserProfileV2;
+    residence_address?: UserResidenceAddressV2;
+    verification?: UserVerificationV2;
+    capabilities?: Capability[];
+    external_providers?: UserExternalProviderV2[];
+}
+
+/**
+ * User Service - User Management
+ *
+ * Handles user management operations with automatic authentication
+ */
+declare class UserService {
+    private readonly httpClient;
+    private readonly authService;
+    private readonly logger?;
+    constructor(config: {
+        httpClient: HttpClient;
+        authService: AuthService;
+        logger?: Logger;
+    });
+    /**
+     * Initiates a phone number update for the authenticated user.
+     */
+    updatePhoneNumber(request: UpdatePhoneNumberRequest): Promise<void>;
+    /**
+     * Confirms and completes the phone number update with SMS verification code.
+     */
+    confirmPhoneNumber(request: ConfirmPhoneNumberRequest): Promise<void>;
+    /**
+     * Uploads a KYC verification document using multipart/form-data.
+     */
+    uploadDocument(formData: FormData): Promise<void>;
+    /**
+     * Fetches the complete profile for the authenticated user (V1).
+     */
+    getUser(): Promise<User>;
+    /**
+     * Associates a Freshdesk customer ID with the user's account.
+     */
+    updateFreshdeskId(request: UpdateFreshdeskIdRequest): Promise<void>;
+    /**
+     * Generates a temporary token for secure user data sharing with SumSub.
+     */
+    getSharingToken(request: GetSharingTokenRequest): Promise<GetSharingTokenResponse>;
+    /**
+     * Generates an access token for SumSub KYC identity verification.
+     */
+    getVerificationToken(): Promise<GetVerificationTokenResponse>;
+    createUser(request: CreateUserRequest): Promise<CreateUserResponse>;
+    /**
+     * Sets a KYC sharing token to ingest user data from SumSub.
+     */
+    setSharingToken(request: SetSharingTokenRequest): Promise<SetSharingTokenResponse>;
+    /**
+     * Creates a new retail user in the Wirex system using client-side Privy SDK authorization.
+     */
+    createRetailUser(request: CreateRetailUserRequest): Promise<CreateRetailUserResponse>;
+    /**
+     * Validates a retail user in the Wirex system using client-side Privy SDK authorization.
+     */
+    validateRetailUser(): Promise<ValidateRetailUserResponse>;
+    /**
+     * Generates a verification link for the user to complete KYC via SumSub.
+     */
+    getVerificationLink(): Promise<GetVerificationLinkResponse>;
+    /**
+     * Retrieves an access token for a specific user to interact with all other APIs on their behalf.
+     */
+    authorizeUser(params: LoginUserParams): Promise<AuthorizeUserResponse>;
+    /**
+     * Retrieves extended user account information (V2).
+     */
+    getUserV2(): Promise<UserV2>;
+}
+
+/**
+ * Wallet endpoints - Types match API spec
+ */
+type WalletStatus = 'Unknown' | 'Confirmed' | 'Rejected';
+type WalletType = 'Primary' | 'Secondary' | 'Global' | 'Card';
+interface GetWalletRequest {
+    wallet_address?: string;
+}
+interface WalletCreateGlobalRequest {
+    wallet_address: string;
+}
+interface WalletBalance {
+    balance?: number;
+    reference_balance?: number;
+    reference_currency?: string;
+    token_address?: string;
+    token_symbol?: string;
+}
+interface WalletResponse {
+    wallet_address: string;
+    wallet_name?: string;
+    wallet_status?: WalletStatus;
+    wallet_type?: WalletType;
+    balances?: WalletBalance[];
+}
+
+/**
+ * Wallet Service – wallet endpoints.
+ */
+declare class WalletService {
+    private readonly httpClient;
+    private readonly authService;
+    private readonly logger?;
+    constructor(config: {
+        httpClient: HttpClient;
+        authService: AuthService;
+        logger?: Logger;
+    });
+    /**
+     * Retrieves a wallet and its balances. Optionally filtered by wallet address.
+     */
+    getWallet(request?: GetWalletRequest): Promise<WalletResponse>;
+    /**
+     * Retrieves user wallets and their balances.
+     */
+    getWallets(): Promise<WalletResponse>;
+    /**
+     * Creates a global wallet for the user account.
+     */
+    createGlobalWallet(request: WalletCreateGlobalRequest): Promise<EmptyResponse>;
+}
+
+declare class BaasModule implements SDKModule {
+    readonly name = "baas";
+    private readonly context;
+    private readonly logger;
+    private _userService?;
+    private _activityService?;
+    private _bankService?;
+    private _cardsService?;
+    private _configService?;
+    private _confirmationService?;
+    private _recipientsService?;
+    private _ratesService?;
+    private _swapService?;
+    private _tokenService?;
+    private _walletService?;
+    private _initialized;
+    constructor(context: ModuleContext);
+    initialize(): Promise<void>;
+    isInitialized(): boolean;
+    get user(): UserService;
+    get activity(): ActivityService;
+    get bank(): BankService;
+    get cards(): CardsService;
+    get config(): ConfigService;
+    get confirmation(): ConfirmationService;
+    get recipients(): RecipientsService;
+    get rates(): RatesService;
+    get swap(): SwapService;
+    get token(): TokenService;
+    get wallet(): WalletService;
+}
+
+declare class ApiModule implements SDKModule {
+    readonly name = "api";
+    private readonly context;
+    private readonly logger;
+    private readonly httpClient;
+    private _withdrawal?;
+    private _baas?;
+    private _initialized;
+    constructor(context: ModuleContext);
+    initialize(): Promise<void>;
+    isInitialized(): boolean;
+    get baas(): BaasModule;
+    get withdrawal(): WithdrawalApi;
+}
+
+export { type OAuth2TokenResponse as $, ApiModule as A, BaasModule as B, type CardActivateRequestBody as C, type CorridorTransferRequest as D, type CreateUserRequest as E, type EstimateTransferRequest as F, type ExecuteTransferRequest as G, type GetActivityByIdRequest as H, type GetActivityFeedRequest as I, type GetBankAccountsRequest as J, type GetCardTransactionsRequest as K, type GetCardsRequest as L, type GetFullStatementRequest as M, type GetRatesRequest as N, type GetRecipientsByCatalogRequest as O, type GetRecipientsByCurrencyRequest as P, type GetRecipientsByNameRequest as Q, type GetRecipientsByTypeRequest as R, type GetRecipientsRequest as S, type GetSharingTokenResponse as T, type GetVerificationTokenResponse as U, type GetWalletRequest as V, type WalletBalance as W, type InitialData as X, type LoginCompanyParams as Y, type LoginUserParams as Z, type OAuth2TokenRequest as _, AuthService as a, type ActivityRecipient as a$, type PrivyAuth as a0, type RatesResponse as a1, type RecipientCreateDetailsRequestBody as a2, type RecipientCreateRequest as a3, type RecipientCreateRequestV2 as a4, type RecipientDetailsType as a5, type RecipientPaymentDetailsAch as a6, type RecipientPaymentDetailsBiFast as a7, type RecipientPaymentDetailsCard as a8, type RecipientPaymentDetailsCrypto as a9, type SwapEstimateRequest as aA, type SwapEstimateRequestByDestinationAmount as aB, type SwapEstimateRequestBySourceAmount as aC, type SwapEstimateResponse as aD, type SwapExecuteRequest as aE, type SwapExecuteResponse as aF, type TokenResponse as aG, type UpdateFreshdeskIdRequest as aH, type UpdatePhoneNumberRequest as aI, type UserDescriptor as aJ, type UserProfile as aK, type ValidateUserParams as aL, type ValidateUserResponse as aM, type VerifyTokenRequest as aN, type VerifyTokenResponse as aO, type WalletCreateGlobalRequest as aP, type WalletResponse as aQ, type WalletStatus as aR, type WalletType as aS, type ActivateBankAccountResponse as aT, type ActivityAmount as aU, type ActivityDirection as aV, type ActivityFeedResponse as aW, type ActivityFullStatementResponse as aX, type ActivityItem as aY, type ActivityOperation as aZ, type ActivityRate as a_, type RecipientPaymentDetailsFasterPayment as aa, type RecipientPaymentDetailsFpsHk as ab, type RecipientPaymentDetailsImps as ac, type RecipientPaymentDetailsInstapay as ad, type RecipientPaymentDetailsIpp as ae, type RecipientPaymentDetailsLegalAddress as af, type RecipientPaymentDetailsNip as ag, type RecipientPaymentDetailsPix as ah, type RecipientPaymentDetailsPse as ai, type RecipientPaymentDetailsResponse as aj, type RecipientPaymentDetailsSepa as ak, type RecipientPaymentDetailsSpei as al, type RecipientPaymentDetailsSwift as am, type RecipientPersonalInfo as an, type RecipientResponse as ao, type RecipientSortOrder as ap, type RecipientUpdateDetailsRequestBody as aq, type RecipientUpdateRequestBody as ar, type RecipientsResponse as as, type RegisterCompanyParams as at, type RegisterUserParams as au, type RegisterUserResponse as av, type RequestedErcWithdrawalResponse as aw, type RequestedErcWithdrawalsResponse as ax, type ResidenceAddress as ay, type SendVerificationLinkRequest as az, type ActionConfirmationCreateSmsRequest as b, type ConfigApi as b$, type ActivityReward as b0, type ActivityRewardType as b1, ActivityService as b2, type ActivitySortOrder as b3, type ActivityStatus as b4, type ActivityStep as b5, type ActivityStepType as b6, type ActivitySubject as b7, type ActivitySubjectBankAccount as b8, type ActivitySubjectCard as b9, type CardDetailsPinResponse as bA, type CardFeesInvoiceResponse as bB, type CardFeesOrderResponse as bC, type CardFormat as bD, type CardGeneration as bE, type CardIssueResponse as bF, type CardLimit as bG, type CardPaymentSystem as bH, type CardProvider as bI, type CardResponse as bJ, type CardSortOrder as bK, type CardStatus as bL, type CardTransactionConfirmationResponse as bM, type CardTransactionDirection as bN, type CardTransactionResponseCardAmount as bO, type CardTransactionResponseMerchantAmount as bP, type CardTransactionResponseMerchantDetails as bQ, type CardTransactionStatus as bR, type CardTransactionType as bS, type CardTransferEstimateResponse as bT, type CardTransferExecuteResponse as bU, type CardWithdrawalEstimateResponse as bV, type CardWithdrawalExecuteResponse as bW, type CardsResponse as bX, CardsService as bY, type ClientAppConfig as bZ, type ConfigAnalytics as b_, type ActivitySubjectMerchant as ba, type ActivitySubjectType as bb, type ActivitySubjectWallet as bc, type ActivityType as bd, type ApiError as be, type ApiResponse as bf, type BankAccount as bg, type BankAccountDetails as bh, type BankAccountStatus as bi, type BankAccountType as bj, type BankAccountsResponse as bk, type BankCorridorEstimateResponse as bl, type BankCorridorExecuteResponse as bm, BankService as bn, type BankSortOrder as bo, type Capability as bp, type CapabilityStatus as bq, type CapabilityType as br, type CardAction as bs, type CardActionType as bt, type CardBalance as bu, type CardData as bv, type CardDeliveryAddress as bw, type CardDeliveryMethod as bx, type CardDetailsCvvResponse as by, type CardDetailsPanExpiryResponse as bz, type ActionConfirmationCreateTokenRequest as c, type ConfigAuth as c0, type ConfigChain as c1, ConfigService as c2, type ConfigSupport as c3, ConfirmationService as c4, type CreateRetailUserRequest as c5, type CreateRetailUserResponse as c6, type CreateUserResponse as c7, type DeliveryAddress as c8, type EstimateTransferResponse as c9, type UserPersonalInfo as cA, type UserPhoneNumberData as cB, type UserProfileV2 as cC, type UserResidenceAddress as cD, type UserResidenceAddressV2 as cE, UserService as cF, type UserStatus as cG, type UserV2 as cH, type UserVerificationLevelV2 as cI, type UserVerificationStatus as cJ, type UserVerificationV2 as cK, type ValidateRetailUserResponse as cL, type VerificationLevel as cM, WalletService as cN, type EstimatedAmount as ca, type EstimatedAmountResponse as cb, type ExecuteTransferResponse as cc, type GetSharingTokenRequest as cd, type GetVerificationLinkResponse as ce, type LegalAddress as cf, type PaginatedResponse as cg, type Rate as ch, RatesService as ci, type RecipientAccount as cj, type RecipientInfo as ck, RecipientsService as cl, type SetSharingTokenRequest as cm, type SetSharingTokenResponse as cn, type StatementBalance as co, type StatementBankAccountsResponse as cp, type StatementPeriod as cq, type StatementTransaction as cr, type StatementUserData as cs, SwapService as ct, TokenService as cu, type User as cv, type UserAction as cw, type UserActionType as cx, type UserDocumentV2 as cy, type UserExternalProviderV2 as cz, type ActionConfirmationSmsSessionResponse as d, type ActionConfirmationVerifySmsRequest as e, type ActionTokenResponse as f, type ActivateBankAccountRequest as g, type AuthResponse as h, type AuthorizeUserResponse as i, type CardDetailsGetCvvRequestBody as j, type CardDetailsGetDetailsRequestBody as k, type CardDetailsGetPinRequestBody as l, type CardFeesCreateInvoiceRequestBody as m, type CardIssuePlasticRequest as n, type CardIssueVirtualRequest as o, type CardLimitChangeRequestBody as p, type CardNameChangeRequestBody as q, type CardTransactionResponse as r, type CardTransactionsResponse as s, type CardTransferEstimateRequest as t, type CardTransferExecuteRequest as u, type CardWithdrawalEstimateRequestBody as v, type CardWithdrawalExecuteRequestBody as w, type ConfirmPhoneNumberRequest as x, type ConfirmationActionType as y, type CorridorEstimateRequest as z };