@zkp2p/sdk 0.6.3 → 0.7.2

package/dist/{vaultUtils-CcJn5Yh6.d.mts → vaultUtils-CdYaZr3f.d.mts}

@@ -1,158 +1,9 @@
 import * as _zkp2p_indexer_schema from '@zkp2p/indexer-schema';
 import { Deposit, DepositStatus as DepositStatus$2, IntentStatus as IntentStatus$1, DepositPaymentMethod, MethodCurrency, Intent as Intent$1, MakerProfitSnapshot, RateManager, ManagerAggregateStats, RateManagerRate, ManagerStats, DepositFundActivity, DepositDailySnapshot, ManagerDailySnapshot } from '@zkp2p/indexer-schema';
-import { Address, Hex, AccessList, AuthorizationList, Hash, WalletClient, PublicClient } from 'viem';
+import { Address, Hex, AccessList, AuthorizationList, Hash, WalletClient, PublicClient, Transport } from 'viem';
 import { Abi } from 'abitype';
 import { IdentityPlatform, IdentityActionTypeByPlatform, IdentityAttestationOutputFor as IdentityAttestationOutputFor$1, IdentityParamsByPlatform } from '@zkp2p/zkp2p-attestation';
 
-/**
- * Supported fiat currency codes.
- *
- * Use these constants when specifying currencies in conversion rates:
- *
- * @example
- * ```typescript
- * import { Currency } from '@zkp2p/sdk';
- *
- * const rates = [
- *   { currency: Currency.USD, conversionRate: '1020000000000000000' },
- *   { currency: Currency.EUR, conversionRate: '1100000000000000000' },
- * ];
- * ```
- */
-declare const Currency: {
-    readonly AED: "AED";
-    readonly ARS: "ARS";
-    readonly AUD: "AUD";
-    readonly BRL: "BRL";
-    readonly CAD: "CAD";
-    readonly CHF: "CHF";
-    readonly CNY: "CNY";
-    readonly CZK: "CZK";
-    readonly DKK: "DKK";
-    readonly EUR: "EUR";
-    readonly GBP: "GBP";
-    readonly HKD: "HKD";
-    readonly HUF: "HUF";
-    readonly IDR: "IDR";
-    readonly ILS: "ILS";
-    readonly INR: "INR";
-    readonly JPY: "JPY";
-    readonly KES: "KES";
-    readonly MXN: "MXN";
-    readonly MYR: "MYR";
-    readonly NOK: "NOK";
-    readonly NZD: "NZD";
-    readonly PHP: "PHP";
-    readonly PLN: "PLN";
-    readonly RON: "RON";
-    readonly SAR: "SAR";
-    readonly SEK: "SEK";
-    readonly SGD: "SGD";
-    readonly THB: "THB";
-    readonly TRY: "TRY";
-    readonly UGX: "UGX";
-    readonly USD: "USD";
-    readonly VND: "VND";
-    readonly ZAR: "ZAR";
-};
-/**
- * Union type of all supported currency codes.
- */
-type CurrencyType = (typeof Currency)[keyof typeof Currency];
-/**
- * Complete currency information including name, symbol, and hash.
- */
-type CurrencyData = {
-    currency: CurrencyType;
-    currencyCode: string;
-    currencyName: string;
-    currencySymbol: string;
-    currencyCodeHash: string;
-    countryCode: string;
-};
-/**
- * Lookup table containing metadata for all supported currencies.
- *
- * Includes currency name, symbol, keccak256 hash (for on-chain use),
- * and ISO country code for flag display.
- *
- * @example
- * ```typescript
- * import { currencyInfo, Currency } from '@zkp2p/sdk';
- *
- * const usd = currencyInfo[Currency.USD];
- * console.log(usd.currencyName);   // "United States Dollar"
- * console.log(usd.currencySymbol); // "$"
- * console.log(usd.currencyCodeHash); // "0x..."
- * ```
- */
-declare const currencyInfo: Record<CurrencyType, CurrencyData>;
-/**
- * UI-friendly currency rate structure used in SDK methods.
- */
-type UICurrencyRate = {
-    currency: CurrencyType;
-    conversionRate: string;
-};
-/**
- * On-chain currency structure with minimum conversion rate (V3 escrow format).
- */
-type OnchainCurrencyMinRate = {
-    code: `0x${string}`;
-    minConversionRate: bigint;
-};
-/**
- * Maps UI currency rates to on-chain V3 escrow format with minConversionRate.
- *
- * @param groups - Nested array of currency rates per payment method
- * @param expectedGroups - Expected number of groups (for validation)
- * @returns On-chain formatted currency arrays for V3 escrow
- * @throws Error if groups structure is invalid or lengths don't match
- */
-declare function mapConversionRatesToOnchainMinRate(groups: UICurrencyRate[][], expectedGroups?: number): OnchainCurrencyMinRate[][];
-/**
- * Looks up currency info by its keccak256 hash.
- *
- * @param hash - The currency code hash (0x-prefixed)
- * @returns Currency data if found, undefined otherwise
- *
- * @example
- * ```typescript
- * const info = getCurrencyInfoFromHash('0x...');
- * if (info) {
- *   console.log(info.currencyCode); // "USD"
- * }
- * ```
- */
-declare function getCurrencyInfoFromHash(hash: string): CurrencyData | undefined;
-/**
- * Looks up currency info by ISO country code.
- *
- * @param code - The ISO country code (e.g., 'US', 'GB')
- * @returns Currency data if found, undefined otherwise
- */
-declare function getCurrencyInfoFromCountryCode(code: string): CurrencyData | undefined;
-/**
- * Converts a currency hash to its ISO currency code.
- *
- * @param hash - The currency code hash (0x-prefixed)
- * @returns Currency code string (e.g., 'USD') or undefined if not found
- *
- * @example
- * ```typescript
- * const code = getCurrencyCodeFromHash('0x...');
- * console.log(code); // "USD"
- * ```
- */
-declare function getCurrencyCodeFromHash(hash: string): string | undefined;
-/**
- * Checks if a currency hash is recognized by the SDK.
- *
- * @param hash - The currency code hash to check
- * @returns true if the hash corresponds to a supported currency
- */
-declare function isSupportedCurrencyHash(hash: string): boolean;
-
 /**
  * Contract resolution utilities for the SDK.
  *
@@ -229,7 +80,7 @@ type RuntimeEnv = 'production' | 'preproduction' | 'staging';
  * Retrieves deployed contract addresses and ABIs for a given chain and environment.
  *
  * @param chainId - The chain ID (8453 for Base)
- * @param env - Runtime environment ('production' or 'staging')
+ * @param env - Runtime environment ('production', 'preproduction', or 'staging')
  * @returns Object containing addresses and ABIs
  *
  * @example
@@ -295,95 +146,6 @@ declare function getRateManagerContracts(chainId: number, env?: RuntimeEnv): {
     };
 };
 
-type PV_ReferralFee = {
-    recipient: `0x${string}`;
-    fee: bigint;
-};
-type PV_Deposit = {
-    depositor: string;
-    delegate: string;
-    token: string;
-    amount: bigint;
-    intentAmountRange: {
-        min: bigint;
-        max: bigint;
-    };
-    acceptingIntents: boolean;
-    remainingDeposits: bigint;
-    outstandingIntentAmount: bigint;
-    makerProtocolFee: bigint;
-    reservedMakerFees: bigint;
-    accruedMakerFees: bigint;
-    accruedReferrerFees: bigint;
-    intentGuardian: string;
-    retainOnEmpty: boolean;
-    referrer: string;
-    referrerFee: bigint;
-};
-type PV_Currency = {
-    code: string;
-    minConversionRate: bigint;
-};
-type PV_PaymentMethodData = {
-    paymentMethod: string;
-    verificationData: {
-        intentGatingService: string;
-        payeeDetails: string;
-        data: string;
-    };
-    currencies: PV_Currency[];
-};
-type PV_DepositView = {
-    depositId: bigint;
-    deposit: PV_Deposit;
-    availableLiquidity: bigint;
-    paymentMethods: PV_PaymentMethodData[];
-    intentHashes: string[];
-};
-type PV_Intent = {
-    owner: string;
-    to: string;
-    escrow: string;
-    depositId: bigint;
-    amount: bigint;
-    timestamp: bigint;
-    paymentMethod: string;
-    fiatCurrency: string;
-    conversionRate: bigint;
-    referralFees: PV_ReferralFee[];
-    postIntentHook: string;
-    data: string;
-};
-type PV_IntentView = {
-    intentHash: string;
-    intent: PV_Intent;
-    deposit: Omit<PV_DepositView, 'intentHashes'>;
-};
-declare function parseDepositView(raw: any): PV_DepositView;
-declare function parseIntentView(raw: any): PV_IntentView;
-
-declare function enrichPvDepositView(view: PV_DepositView, chainId: number, env?: RuntimeEnv): {
-    paymentMethods: {
-        processorName: string | undefined;
-        currencies: {
-            currencyInfo: CurrencyData | undefined;
-            code: string;
-            minConversionRate: bigint;
-        }[];
-        paymentMethod: string;
-        verificationData: {
-            intentGatingService: string;
-            payeeDetails: string;
-            data: string;
-        };
-    }[];
-    depositId: bigint;
-    deposit: PV_Deposit;
-    availableLiquidity: bigint;
-    intentHashes: string[];
-};
-declare function enrichPvIntentView(view: PV_IntentView, chainId: number, env?: RuntimeEnv): any;
-
 /**
  * Minimal fetch-based GraphQL client for the ZKP2P indexer.
  * No external GraphQL dependencies; works in Node and browser.
@@ -415,299 +177,12 @@ type DeploymentEnv = 'PRODUCTION' | 'PREPRODUCTION' | 'STAGING' | 'DEV' | 'LOCAL
 declare function defaultIndexerEndpoint(env?: DeploymentEnv): string;
 
 /**
- * Indexer entity types sourced from @zkp2p/indexer-schema.
+ * Type definitions for the ZKP2P indexer GraphQL schema
  */
-
-type WithOverrides<TBase, TOverrides> = Omit<TBase, keyof TOverrides> & TOverrides;
-type DepositStatus$1 = `${DepositStatus$2}`;
-type IntentStatus = `${IntentStatus$1}`;
-type DepositEntity$1 = WithOverrides<Deposit, {
-    status: DepositStatus$1;
-    retainOnEmpty?: boolean;
-    whitelistHookAddress?: string | null;
-}>;
-type DepositPaymentMethodEntity$1 = DepositPaymentMethod;
-type MethodCurrencyEntity$1 = MethodCurrency;
-type IntentEntity$1 = WithOverrides<Intent$1, {
-    status: IntentStatus;
-}>;
-interface DepositWithRelations extends DepositEntity$1 {
-    paymentMethods?: DepositPaymentMethodEntity$1[];
-    currencies?: MethodCurrencyEntity$1[];
-    intents?: IntentEntity$1[];
-}
-type DepositFundActivityType$1 = 'DEPOSIT_RECEIVED' | 'FUNDS_ADDED' | 'WITHDRAWN' | 'CLOSED';
 /**
- * Chronological fund-movement log for a deposit.
- * One row per on-chain fund event (deposit, add, withdraw, close).
+ * Core deposit entity from the indexer
  */
-type DepositFundActivityEntity$1 = WithOverrides<DepositFundActivity, {
-    activityType: DepositFundActivityType$1;
-}>;
-/**
- * Per-deposit daily rollup snapshot.
- * One row per deposit per day (UTC-aligned, 86400s buckets).
- */
-type DepositDailySnapshotEntity$1 = DepositDailySnapshot;
-interface DepositEventEntity$1 {
-    id: string;
-    depositId: string;
-    depositor: string;
-    amount: string;
-}
-interface DepositEventsResponse$1 {
-    deposits: DepositEventEntity$1[];
-    fundsAdded: DepositEventEntity$1[];
-    withdrawals: DepositEventEntity$1[];
-}
-interface IntentFulfilledEntity {
-    intentHash: string;
-    amount: string;
-    isManualRelease: boolean;
-    fundsTransferredTo?: string | null;
-}
-interface IntentFulfillmentAmountsEntity {
-    intentHash: string;
-    releasedAmount?: string | null;
-    takerAmountNetFees?: string | null;
-}
-type RateManagerEntity = RateManager;
-type RateManagerRateEntity = RateManagerRate;
-interface RateManagerDelegationEntity {
-    id: string;
-    chainId: number;
-    rateManagerId: string;
-    rateManagerAddress?: string | null;
-    depositId: string;
-    delegatedAt?: string | null;
-    createdAt: string;
-    updatedAt: string;
-}
-type ManagerAggregateStatsEntity = WithOverrides<ManagerAggregateStats, {
-    rateManagerAddress?: string | null;
-}>;
-type ManagerStatsEntity = ManagerStats;
-type ManagerDailySnapshotEntity = ManagerDailySnapshot;
-type MakerProfitSnapshotEntity$1 = MakerProfitSnapshot;
-interface ManualRateUpdateEntity {
-    id: string;
-    rateManagerId: string;
-    paymentMethod: string;
-    /** Canonical V2.2 field. */
-    currencyCode?: string;
-    currency: string;
-    /** Canonical V2.2 field. */
-    rate?: string;
-    minRate: string;
-}
-interface OracleConfigUpdateEntity {
-    id: string;
-    rateManagerId: string;
-    escrow?: string;
-    depositIdOnContract?: string;
-    paymentMethod: string;
-    /** Canonical V2.2 field. */
-    currencyCode?: string;
-    currency: string;
-    /** Canonical V2.2 floor field. */
-    floorFixed?: string;
-    /** Canonical V2.2 floor field. */
-    floorSpreadBps?: number;
-    /** Canonical V2.2 floor field. */
-    oracleAdapter?: string;
-    adapter?: string;
-    spreadBps?: number;
-    maxStaleness?: string;
-    adapterConfig?: string;
-    enabled?: boolean;
-}
-interface RateManagerListItem {
-    manager: RateManagerEntity;
-    aggregate?: ManagerAggregateStatsEntity | null;
-}
-interface RateManagerDetail {
-    manager: RateManagerEntity;
-    rates: RateManagerRateEntity[];
-    aggregate?: ManagerAggregateStatsEntity | null;
-    recentStats: ManagerStatsEntity[];
-    delegations: RateManagerDelegationEntity[];
-}
-
-type DepositOrderField = 'remainingDeposits' | 'outstandingIntentAmount' | 'totalAmountTaken' | 'totalWithdrawn' | 'updatedAt' | 'timestamp';
-type OrderDirection$1 = 'asc' | 'desc';
-type DepositFilter = Partial<{
-    status: 'ACTIVE' | 'CLOSED';
-    depositor: string;
-    delegate: string;
-    /** True to only include deposits with a non-zero delegate, false for zero delegate. */
-    delegateIsSet: boolean;
-    chainId: number;
-    escrowAddress: string;
-    escrowAddresses: string[];
-    minLiquidity: string;
-    acceptingIntents: boolean;
-}>;
-type PaginationOptions = Partial<{
-    limit: number;
-    offset: number;
-    orderBy: DepositOrderField;
-    orderDirection: OrderDirection$1;
-}>;
-declare class IndexerDepositService {
-    private client;
-    constructor(client: IndexerClient);
-    private queryWithLegacyFallback;
-    private buildDepositWhere;
-    private buildOrderBy;
-    private fetchRelations;
-    private fetchIntents;
-    private attachRelations;
-    fetchDeposits(filter?: DepositFilter, pagination?: PaginationOptions): Promise<DepositEntity$1[]>;
-    fetchDepositsWithRelations(filter?: DepositFilter, pagination?: PaginationOptions, options?: {
-        includeIntents?: boolean;
-        intentStatuses?: IntentStatus[];
-    }): Promise<DepositWithRelations[]>;
-    fetchDepositsByIds(ids: string[]): Promise<DepositEntity$1[]>;
-    fetchDepositsByIdsWithRelations(ids: string[], options?: {
-        includeIntents?: boolean;
-        intentStatuses?: IntentStatus[];
-    }): Promise<DepositWithRelations[]>;
-    fetchIntentsForDeposits(depositIds: string[], statuses?: IntentStatus[]): Promise<IntentEntity$1[]>;
-    fetchIntentsByOwner(owner: string, statuses?: IntentStatus[]): Promise<IntentEntity$1[]>;
-    fetchIntentsByRateManager(rateManagerId: string, statuses?: IntentStatus[]): Promise<IntentEntity$1[]>;
-    fetchIntentByHash(intentHash: string): Promise<IntentEntity$1 | null>;
-    fetchDepositWithRelations(id: string, options?: {
-        includeIntents?: boolean;
-        intentStatuses?: IntentStatus[];
-    }): Promise<DepositWithRelations | null>;
-    fetchExpiredIntents(params: {
-        now: bigint | string;
-        depositIds: string[];
-        limit?: number;
-    }): Promise<IntentEntity$1[]>;
-    fetchFulfilledIntentEvents(intentHashes: string[]): Promise<IntentFulfilledEntity[]>;
-    fetchIntentFulfillmentAmounts(intentHash: string): Promise<IntentFulfillmentAmountsEntity | null>;
-    resolvePayeeHash(params: {
-        escrowAddress?: string | null;
-        depositId?: string | number | bigint | null;
-        paymentMethodHash?: string | null;
-    }): Promise<string | null>;
-    fetchDepositEvents(depositIdOnContract: string, options?: {
-        escrowAddress?: string | null;
-        depositor?: string | null;
-    }): Promise<DepositEventsResponse$1>;
-    fetchDepositsByPayeeHash(payeeHash: string, options?: {
-        paymentMethodHash?: string;
-        limit?: number;
-        includeIntents?: boolean;
-        intentStatuses?: IntentStatus[];
-    }): Promise<DepositWithRelations[]>;
-    /**
-     * Fetch chronological fund activities for a deposit.
-     */
-    fetchDepositFundActivities(compositeDepositId: string): Promise<DepositFundActivityEntity$1[]>;
-    /**
-     * Fetch fund activities across all deposits for a maker address.
-     */
-    fetchMakerFundActivities(depositor: string, limit?: number): Promise<DepositFundActivityEntity$1[]>;
-    /**
-     * Fetch daily snapshots for a deposit, ordered by day ascending.
-     */
-    fetchDepositDailySnapshots(compositeDepositId: string, limit?: number): Promise<DepositDailySnapshotEntity$1[]>;
-    fetchProfitSnapshotsByDeposits(depositIds: string[]): Promise<MakerProfitSnapshotEntity$1[]>;
-}
-
-type OrderDirection = 'asc' | 'desc';
-type RateManagerOrderField = 'createdAt' | 'updatedAt' | 'fee' | 'maxFee' | 'rateManagerId' | 'currentDelegatedBalance' | 'totalFilledVolume';
-type RateManagerFilter = Partial<{
-    manager: string;
-    name: string;
-    hasHook: boolean;
-    maxFee: string;
-    rateManagerIds: string[];
-}>;
-type RateManagerPaginationOptions = Partial<{
-    limit: number;
-    offset: number;
-    orderBy: RateManagerOrderField;
-    orderDirection: OrderDirection;
-}>;
-type RateManagerDelegationPaginationOptions = Partial<{
-    limit: number;
-    offset: number;
-    orderBy: 'createdAt' | 'updatedAt' | 'depositId' | 'delegatedAt';
-    orderDirection: OrderDirection;
-    rateManagerAddress: string;
-}>;
-declare function compareEventCursorIdsByRecency(leftId?: string | null, rightId?: string | null): number;
-declare class IndexerRateManagerService {
-    private client;
-    constructor(client: IndexerClient);
-    private buildRateManagerScopeWhere;
-    private buildWhere;
-    private buildAggregateWhere;
-    private buildLegacyAggregateWhere;
-    private buildOrderBy;
-    private toRateManagerListItems;
-    private applyHookFilter;
-    private queryRateManagerList;
-    private buildDelegationOrderBy;
-    private buildLegacyDelegationOrderBy;
-    private fetchCurrentRateManagerDepositScopes;
-    private fetchHistoricalRateManagerDepositScopes;
-    fetchRateManagers(pagination?: RateManagerPaginationOptions, filter?: RateManagerFilter): Promise<RateManagerListItem[]>;
-    fetchRateManagerDetail(rateManagerId: string, options?: {
-        statsLimit?: number;
-        rateManagerAddress?: string | null;
-    }): Promise<RateManagerDetail | null>;
-    fetchRateManagerDelegations(rateManagerId: string, pagination?: RateManagerDelegationPaginationOptions): Promise<RateManagerDelegationEntity[]>;
-    fetchManagerDailySnapshots(rateManagerId: string, options?: {
-        limit?: number;
-        rateManagerAddress?: string | null;
-    }): Promise<ManagerDailySnapshotEntity[]>;
-    fetchDelegationForDeposit(depositId: string, options?: {
-        escrowAddress?: string | null;
-    }): Promise<RateManagerDelegationEntity | null>;
-    fetchManualRateUpdates(rateManagerId: string, options?: {
-        limit?: number;
-        rateManagerAddress?: string | null;
-    }): Promise<ManualRateUpdateEntity[]>;
-    fetchOracleConfigUpdates(rateManagerId: string, options?: {
-        limit?: number;
-        rateManagerAddress?: string | null;
-    }): Promise<OracleConfigUpdateEntity[]>;
-}
-
-type FulfillmentRecord = {
-    id: string;
-    intentHash: string;
-    amount: string;
-    isManualRelease: boolean;
-    fundsTransferredTo: string | null;
-};
-type PaymentVerifiedRecord = {
-    id: string;
-    intentHash: string;
-    method: string;
-    currency: string;
-    amount: string;
-    timestamp: string;
-    paymentId: string | null;
-    payeeId: string | null;
-};
-type FulfillmentAndPaymentResponse = {
-    Orchestrator_V21_IntentFulfilled: FulfillmentRecord[];
-    UnifiedVerifier_V21_PaymentVerified: PaymentVerifiedRecord[];
-};
-declare function fetchFulfillmentAndPayment(client: IndexerClient, intentHash: string): Promise<FulfillmentAndPaymentResponse>;
-
-/**
- * Type definitions for the ZKP2P indexer GraphQL schema
- */
-/**
- * Core deposit entity from the indexer
- */
-interface DepositEntity {
+interface DepositEntity$1 {
     id: string;
     chainId: number;
     escrowAddress: string;
@@ -742,7 +217,7 @@ interface DepositEntity {
 /**
  * Payment method configuration for a deposit
  */
-interface DepositPaymentMethodEntity {
+interface DepositPaymentMethodEntity$1 {
     id: string;
     chainId: number;
     depositIdOnContract: string;
@@ -755,7 +230,7 @@ interface DepositPaymentMethodEntity {
 /**
  * Currency configuration for a payment method
  */
-interface MethodCurrencyEntity {
+interface MethodCurrencyEntity$1 {
     id: string;
     chainId: number;
     depositIdOnContract: string;
@@ -784,7 +259,7 @@ interface MethodCurrencyEntity {
 /**
  * Intent/swap entity
  */
-interface IntentEntity {
+interface IntentEntity$1 {
     id: string;
     intentHash: string;
     depositId: string;
@@ -817,17 +292,17 @@ interface IntentEntity {
     releasedAmount?: string | null;
     takerAmountNetFees?: string | null;
 }
-type DepositFundActivityType = "DEPOSIT_RECEIVED" | "FUNDS_ADDED" | "WITHDRAWN" | "CLOSED";
+type DepositFundActivityType$1 = "DEPOSIT_RECEIVED" | "FUNDS_ADDED" | "WITHDRAWN" | "CLOSED";
 /**
  * Chronological fund-movement log for a deposit.
  * One row per on-chain fund event (deposit, add, withdraw, close).
  */
-interface DepositFundActivityEntity {
+interface DepositFundActivityEntity$1 {
     id: string;
     chainId: number;
     depositId: string;
     depositor: string;
-    activityType: DepositFundActivityType;
+    activityType: DepositFundActivityType$1;
     amount: string;
     blockNumber: string;
     timestamp: string;
@@ -837,7 +312,7 @@ interface DepositFundActivityEntity {
  * Per-deposit daily rollup snapshot.
  * One row per deposit per day (UTC-aligned, 86400s buckets).
  */
-interface DepositDailySnapshotEntity {
+interface DepositDailySnapshotEntity$1 {
     id: string;
     chainId: number;
     depositId: string;
@@ -857,18 +332,18 @@ interface DepositDailySnapshotEntity {
     cumulativePnlUsdCents: string;
     updatedAt: string;
 }
-interface DepositEventEntity {
+interface DepositEventEntity$1 {
     id: string;
     depositId: string;
     depositor: string;
     amount: string;
 }
-interface DepositEventsResponse {
-    deposits: DepositEventEntity[];
-    fundsAdded: DepositEventEntity[];
-    withdrawals: DepositEventEntity[];
-}
-interface MakerProfitSnapshotEntity {
+interface DepositEventsResponse$1 {
+    deposits: DepositEventEntity$1[];
+    fundsAdded: DepositEventEntity$1[];
+    withdrawals: DepositEventEntity$1[];
+}
+interface MakerProfitSnapshotEntity$1 {
     id: string;
     chainId: number;
     maker: string;
@@ -893,18 +368,167 @@ type DepositBundleRequest = {
     escrowAddress: string;
     dailySnapshotLimit?: number;
 };
-type DepositBundleDeposit = DepositEntity & {
-    paymentMethods: DepositPaymentMethodEntity[];
-    currencies: MethodCurrencyEntity[];
+type DepositBundleDeposit = DepositEntity$1 & {
+    paymentMethods: DepositPaymentMethodEntity$1[];
+    currencies: MethodCurrencyEntity$1[];
 };
 type DepositBundleResponse = {
     deposit: DepositBundleDeposit;
-    intents: IntentEntity[];
-    events: DepositEventsResponse;
-    profitSnapshots: MakerProfitSnapshotEntity[];
-    fundActivities: DepositFundActivityEntity[];
-    dailySnapshots: DepositDailySnapshotEntity[];
+    intents: IntentEntity$1[];
+    events: DepositEventsResponse$1;
+    profitSnapshots: MakerProfitSnapshotEntity$1[];
+    fundActivities: DepositFundActivityEntity$1[];
+    dailySnapshots: DepositDailySnapshotEntity$1[];
+};
+
+/**
+ * Supported fiat currency codes.
+ *
+ * Use these constants when specifying currencies in conversion rates:
+ *
+ * @example
+ * ```typescript
+ * import { Currency } from '@zkp2p/sdk';
+ *
+ * const rates = [
+ *   { currency: Currency.USD, conversionRate: '1020000000000000000' },
+ *   { currency: Currency.EUR, conversionRate: '1100000000000000000' },
+ * ];
+ * ```
+ */
+declare const Currency: {
+    readonly AED: "AED";
+    readonly ARS: "ARS";
+    readonly AUD: "AUD";
+    readonly BRL: "BRL";
+    readonly CAD: "CAD";
+    readonly CHF: "CHF";
+    readonly CNY: "CNY";
+    readonly CZK: "CZK";
+    readonly DKK: "DKK";
+    readonly EUR: "EUR";
+    readonly GBP: "GBP";
+    readonly HKD: "HKD";
+    readonly HUF: "HUF";
+    readonly IDR: "IDR";
+    readonly ILS: "ILS";
+    readonly INR: "INR";
+    readonly JPY: "JPY";
+    readonly KES: "KES";
+    readonly MXN: "MXN";
+    readonly MYR: "MYR";
+    readonly NOK: "NOK";
+    readonly NZD: "NZD";
+    readonly PHP: "PHP";
+    readonly PLN: "PLN";
+    readonly RON: "RON";
+    readonly SAR: "SAR";
+    readonly SEK: "SEK";
+    readonly SGD: "SGD";
+    readonly THB: "THB";
+    readonly TRY: "TRY";
+    readonly UGX: "UGX";
+    readonly USD: "USD";
+    readonly VND: "VND";
+    readonly ZAR: "ZAR";
+};
+/**
+ * Union type of all supported currency codes.
+ */
+type CurrencyType = (typeof Currency)[keyof typeof Currency];
+/**
+ * Complete currency information including name, symbol, and hash.
+ */
+type CurrencyData = {
+    currency: CurrencyType;
+    currencyCode: string;
+    currencyName: string;
+    currencySymbol: string;
+    currencyCodeHash: string;
+    countryCode: string;
 };
+/**
+ * Lookup table containing metadata for all supported currencies.
+ *
+ * Includes currency name, symbol, keccak256 hash (for on-chain use),
+ * and ISO country code for flag display.
+ *
+ * @example
+ * ```typescript
+ * import { currencyInfo, Currency } from '@zkp2p/sdk';
+ *
+ * const usd = currencyInfo[Currency.USD];
+ * console.log(usd.currencyName);   // "United States Dollar"
+ * console.log(usd.currencySymbol); // "$"
+ * console.log(usd.currencyCodeHash); // "0x..."
+ * ```
+ */
+declare const currencyInfo: Record<CurrencyType, CurrencyData>;
+/**
+ * UI-friendly currency rate structure used in SDK methods.
+ */
+type UICurrencyRate = {
+    currency: CurrencyType;
+    conversionRate: string;
+};
+/**
+ * On-chain currency structure with minimum conversion rate (V3 escrow format).
+ */
+type OnchainCurrencyMinRate = {
+    code: `0x${string}`;
+    minConversionRate: bigint;
+};
+/**
+ * Maps UI currency rates to on-chain V3 escrow format with minConversionRate.
+ *
+ * @param groups - Nested array of currency rates per payment method
+ * @param expectedGroups - Expected number of groups (for validation)
+ * @returns On-chain formatted currency arrays for V3 escrow
+ * @throws Error if groups structure is invalid or lengths don't match
+ */
+declare function mapConversionRatesToOnchainMinRate(groups: UICurrencyRate[][], expectedGroups?: number): OnchainCurrencyMinRate[][];
+/**
+ * Looks up currency info by its keccak256 hash.
+ *
+ * @param hash - The currency code hash (0x-prefixed)
+ * @returns Currency data if found, undefined otherwise
+ *
+ * @example
+ * ```typescript
+ * const info = getCurrencyInfoFromHash('0x...');
+ * if (info) {
+ *   console.log(info.currencyCode); // "USD"
+ * }
+ * ```
+ */
+declare function getCurrencyInfoFromHash(hash: string): CurrencyData | undefined;
+/**
+ * Looks up currency info by ISO country code.
+ *
+ * @param code - The ISO country code (e.g., 'US', 'GB')
+ * @returns Currency data if found, undefined otherwise
+ */
+declare function getCurrencyInfoFromCountryCode(code: string): CurrencyData | undefined;
+/**
+ * Converts a currency hash to its ISO currency code.
+ *
+ * @param hash - The currency code hash (0x-prefixed)
+ * @returns Currency code string (e.g., 'USD') or undefined if not found
+ *
+ * @example
+ * ```typescript
+ * const code = getCurrencyCodeFromHash('0x...');
+ * console.log(code); // "USD"
+ * ```
+ */
+declare function getCurrencyCodeFromHash(hash: string): string | undefined;
+/**
+ * Checks if a currency hash is recognized by the SDK.
+ *
+ * @param hash - The currency code hash to check
+ * @returns true if the hash corresponds to a supported currency
+ */
+declare function isSupportedCurrencyHash(hash: string): boolean;
 
 /**
  * A prepared transaction ready for submission.
@@ -949,9 +573,10 @@ type IdentityAttestationOutput = {
 }[IdentityPlatform];
 /**
  * Timeout configuration for different operation types
+ * @deprecated Legacy shape from the pre-0.6 API; use `Zkp2pNextOptions['timeouts']`. Will be removed in 0.8.
  */
 type TimeoutConfig = {
-    /** API call timeout in milliseconds (default: 30000) */
+    /** API call timeout in milliseconds (default: 15000) */
     api?: number;
     /** Transaction timeout in milliseconds (default: 60000) */
     transaction?: number;
@@ -959,6 +584,8 @@ type TimeoutConfig = {
 type ApiAdapterOptions = {
     baseApiUrl: string;
     timeoutMs?: number;
+    /** Optional bearer token for authenticated curator endpoints. */
+    authorizationToken?: string;
 };
 type AuthorizationTokenProvider = () => string | null | undefined | Promise<string | null | undefined>;
 /**
@@ -966,6 +593,7 @@ type AuthorizationTokenProvider = () => string | null | undefined | Promise<stri
  * @param params - Transaction callback parameters
  * @param params.hash - Transaction hash
  * @param params.data - Optional additional data from the transaction
+ * @deprecated Legacy shape from the pre-0.6 API; use the per-method callbacks on `<X>MethodParams`. Will be removed in 0.8.
  */
 type ActionCallback = (params: {
     hash: Hash;
@@ -994,6 +622,71 @@ type ReferrerFeeConfig = {
     recipient: `0x${string}`;
     feeBps: number;
 };
+type ReferralRedemption = {
+    code: string;
+    referrerWalletAddress: string;
+    redeemedAt: string;
+};
+type ReferralDashboardResponse = {
+    code: string;
+    redemption: ReferralRedemption | null;
+    l1FeeBps: number;
+    l2FeeBps: number;
+    l1RefereeCount: number;
+    l2RefereeCount: number;
+    totalFeesWei: string | null;
+    l1FeesWei: string | null;
+    l2FeesWei: string | null;
+    distributionCount: number;
+    lastEarnedAt: string | null;
+};
+type ReferralEarningsResponse = {
+    totalWei: string | null;
+    l1Wei: string | null;
+    l2Wei: string | null;
+    unattributedWei: string | null;
+    distributionCount: number;
+    lastEarnedAt: string | null;
+};
+type ReferralSignatureBody = {
+    walletAddress: Address;
+    signature: `0x${string}`;
+    issuedAt: number;
+    audience: string;
+    referrer?: Address;
+    oldCode?: string;
+};
+type ReferralReadRequest = {
+    /** Public wallet-address read target. Omit to use bearer-authenticated caller mode. */
+    address?: Address;
+};
+type ReferralCodeLookupResponse = {
+    code: string;
+    referrerWalletAddress: Address;
+    isActive: boolean;
+};
+type CreateReferralCodeRequest = {
+    signature?: ReferralSignatureBody;
+};
+type CreateReferralCodeResponse = {
+    code: string;
+};
+type RedeemReferralCodeRequest = {
+    code: string;
+    signature?: ReferralSignatureBody;
+};
+type RedeemReferralCodeResponse = {
+    redeemedAt: string;
+    referrerWalletAddress: Address;
+};
+type UpdateReferralCodeRequest = {
+    code: string;
+    signature?: ReferralSignatureBody;
+};
+type UpdateReferralCodeResponse = {
+    code: string;
+};
+/** @deprecated any-typed; becomes Record<string, unknown> in 0.8. */
 type CuratorMetadata = Record<string, any>;
 type CuratorPayeeData = {
     offchainId: string;
@@ -1007,6 +700,7 @@ type CuratorPayeeDataInput = {
 };
 /**
  * Parameters for fulfilling an intent with payment attestation
+ * @deprecated Legacy shape from the pre-0.6 API; use FulfillIntentMethodParams. Will be removed in 0.8.
  */
 type FulfillIntentParams = {
     /** Hash of the intent to fulfill */
@@ -1036,6 +730,7 @@ type FulfillIntentParams = {
 };
 /**
  * Parameters for releasing funds back to the payer
+ * @deprecated Legacy shape from the pre-0.6 API; use the params of `Zkp2pClient.releaseFundsToPayer`. Will be removed in 0.8.
  */
 type ReleaseFundsToPayerParams = {
     /** Hash of the intent to release funds for */
@@ -1049,6 +744,7 @@ type ReleaseFundsToPayerParams = {
 };
 /**
  * Parameters for signaling an intent to use a deposit
+ * @deprecated Legacy shape from the pre-0.6 API; use SignalIntentMethodParams. Will be removed in 0.8.
  */
 type SignalIntentParams = {
     /** Payment processor name (e.g., 'wise', 'revolut') */
@@ -1659,6 +1355,7 @@ type CreateDepositConversionRate = {
     currency: CurrencyType;
     conversionRate: string;
 };
+/** @deprecated Legacy shape from the pre-0.6 API; use the params of `Zkp2pClient.createDeposit`. Will be removed in 0.8. */
 type CreateDepositParams = {
     token: Address;
     amount: bigint;
@@ -1680,20 +1377,24 @@ type CreateDepositParams = {
     onError?: (error: Error) => void;
     onMined?: ActionCallback;
 };
+/** @deprecated Legacy shape from the pre-0.6 API; use the params of `Zkp2pClient.withdrawDeposit`. Will be removed in 0.8. */
 type WithdrawDepositParams = {
     depositId: string | number | bigint;
     onSuccess?: ActionCallback;
     onError?: (error: Error) => void;
     onMined?: ActionCallback;
 };
+/** @deprecated Legacy shape from the pre-0.6 API; use CancelIntentMethodParams. Will be removed in 0.8. */
 type CancelIntentParams = {
     intentHash: Hash;
     onSuccess?: ActionCallback;
     onError?: (error: Error) => void;
     onMined?: ActionCallback;
 };
-type DepositStatus = 'ACTIVE' | 'WITHDRAWN' | 'CLOSED';
+type DepositStatus$1 = 'ACTIVE' | 'WITHDRAWN' | 'CLOSED';
+/** @deprecated No corresponding SDK method; will be removed in 0.8. */
 type ApiIntentStatus = 'SIGNALED' | 'FULFILLED' | 'PRUNED' | 'MANUALLY_RELEASED';
+/** @deprecated No corresponding SDK method; will be removed in 0.8. */
 type Intent = {
     id: number;
     intentHash: string;
@@ -1716,6 +1417,7 @@ type Intent = {
     createdAt: Date;
     updatedAt: Date;
 };
+/** @deprecated No corresponding SDK method; will be removed in 0.8. */
 type GetOwnerIntentsRequest = {
     ownerAddress: string;
     escrowAddress: string;
@@ -1723,12 +1425,14 @@ type GetOwnerIntentsRequest = {
     orchestratorAddresses?: string[];
     status?: ApiIntentStatus | ApiIntentStatus[];
 };
+/** @deprecated No corresponding SDK method; will be removed in 0.8. */
 type GetOwnerIntentsResponse = {
     success: boolean;
     message: string;
     responseObject: Intent[];
     statusCode: number;
 };
+/** @deprecated No corresponding SDK method; will be removed in 0.8. */
 type GetIntentsByDepositRequest = {
     depositId: string;
     escrowAddress: string;
@@ -1736,18 +1440,21 @@ type GetIntentsByDepositRequest = {
     orchestratorAddresses?: string[];
     status?: ApiIntentStatus | ApiIntentStatus[];
 };
+/** @deprecated No corresponding SDK method; will be removed in 0.8. */
 type GetIntentsByDepositResponse = {
     success: boolean;
     message: string;
     responseObject: Intent[];
     statusCode: number;
 };
+/** @deprecated No corresponding SDK method; will be removed in 0.8. */
 type GetIntentByHashRequest = {
     intentHash: string;
     escrowAddress?: string;
     escrowAddresses?: string[];
     orchestratorAddresses?: string[];
 };
+/** @deprecated No corresponding SDK method; will be removed in 0.8. */
 type GetIntentByHashResponse = {
     success: boolean;
     message: string;
@@ -1808,7 +1515,7 @@ type GetOwnerDepositsRequest = {
     escrowAddress: string;
     escrowAddresses?: string[];
     /** Optional status filter: 'ACTIVE' | 'WITHDRAWN' | 'CLOSED' */
-    status?: DepositStatus;
+    status?: DepositStatus$1;
 };
 type GetOwnerDepositsResponse = {
     success: boolean;
@@ -1816,17 +1523,20 @@ type GetOwnerDepositsResponse = {
     responseObject: ApiDeposit[];
     statusCode: number;
 };
+/** @deprecated No corresponding SDK method; will be removed in 0.8. */
 type GetDepositByIdRequest = {
     depositId: string;
     escrowAddress: string;
     escrowAddresses?: string[];
 };
+/** @deprecated No corresponding SDK method; will be removed in 0.8. */
 type GetDepositByIdResponse = {
     success: boolean;
     message: string;
     responseObject: ApiDeposit;
     statusCode: number;
 };
+/** @deprecated No corresponding SDK method; will be removed in 0.8. */
 type OrderStats = {
     id: number;
     totalIntents: number;
@@ -1834,6 +1544,7 @@ type OrderStats = {
     fulfilledIntents: number;
     prunedIntents: number;
 };
+/** @deprecated No corresponding SDK method; will be removed in 0.8. */
 type DepositIntentStatistics = OrderStats;
 type TakerTierStats = {
     lifetimeSignaledCount: number;
@@ -1885,110 +1596,523 @@ type TakerTierSource = 'computed' | 'fallback' | 'override' | 'blocklist' | 'pee
 type TakerTier = {
     owner: string;
     chainId: number;
-    tier: TakerTierLevel;
-    /** Legacy base cap. Current curator responses expose enforced caps in platformLimits. */
-    perIntentCapBaseUnits?: string;
-    /** Legacy formatted base cap. */
-    perIntentCapDisplay?: string;
-    lastUpdated: string;
-    source: TakerTierSource;
-    stats: TakerTierStats | null;
-    cooldownHours: number;
-    cooldownSeconds: number;
-    cooldownActive: boolean;
-    cooldownRemainingSeconds: number;
-    nextIntentAvailableAt: string | null;
+    tier: TakerTierLevel;
+    /** Legacy base cap. Current curator responses expose enforced caps in platformLimits. */
+    perIntentCapBaseUnits?: string;
+    /** Legacy formatted base cap. */
+    perIntentCapDisplay?: string;
+    lastUpdated: string;
+    source: TakerTierSource;
+    stats: TakerTierStats | null;
+    cooldownHours: number;
+    cooldownSeconds: number;
+    cooldownActive: boolean;
+    cooldownRemainingSeconds: number;
+    nextIntentAvailableAt: string | null;
+    /**
+     * Server-authoritative platform cap grid. Use this for enforced caps; do not
+     * derive platform caps from top-level tier caps or risk multipliers.
+     */
+    platformLimits?: PlatformLimit[];
+    /**
+     * Server-authoritative tier fields (curator PR #461/#463/#478 contract). All
+     * optional because the current production deployment still serves the older
+     * payload that omits them — read them when present and fall back gracefully.
+     * Amounts are USDC base-unit strings (6 decimals).
+     */
+    /** Base per-intent cap before platform risk multipliers (alias of perIntentCapBaseUnits). */
+    maxOrderSize?: string;
+    maxOrderSizeDisplay?: string;
+    /** Peer Pay volume floor that qualifies the current tier. */
+    minVolumeForTier?: string;
+    minVolumeForTierDisplay?: string;
+    /** Next tier up the volume ladder, or null at the top / off-ladder tiers. */
+    nextTier?: TakerTierLevel | null;
+    /** Remaining Peer Pay volume to reach `nextTier`. */
+    volumeToNextTier?: string | null;
+    volumeToNextTierDisplay?: string | null;
+    nextTierMaxOrderSize?: string | null;
+    nextTierMaxOrderSizeDisplay?: string | null;
+    /**
+     * Compatibility name retained by curator. Current semantics preserve
+     * historical maker tiers through July 1, 2026 UTC, then add forward Peer Pay
+     * volume only. Present on deployments with the PR #461/#463 progression
+     * contract.
+     */
+    peerPayVolume?: string;
+    /** Auditable tier progression inputs. Current curator may return a synthetic Peer Pay row. */
+    volumeBreakdown?: TakerTierVolumeBreakdown[];
+};
+type GetTakerTierRequest = {
+    owner: string;
+    chainId: number;
+};
+type GetTakerTierResponse = {
+    success: boolean;
+    message: string;
+    responseObject: TakerTier;
+    statusCode?: number;
+};
+type GetDepositBundleParams = DepositBundleRequest;
+type GetDepositBundleResponse = DepositBundleResponse;
+type GetOrderbookParams = {
+    currency: string;
+    paymentPlatform?: string;
+    publicOnly?: boolean;
+    sortBy?: 'price' | 'available' | 'limits';
+    sortDirection?: 'asc' | 'desc';
+    sellerAutomatedRelease?: 'include' | 'exclude' | 'only';
+    limit?: number;
+    chainId?: number;
+    token?: string;
+};
+type OrderbookEntry = {
+    depositIdOnContract?: string;
+    depositId: string;
+    depositor: string;
+    price: string;
+    availableTokenAmount: string;
+    availableFiatAmount: string;
+    intentAmountMin: string;
+    intentAmountMax: string;
+    paymentPlatform: string;
+    currency: string;
+    paymentMethodHash: string;
+    payeeDetailsHash: string;
+    sellerAutomatedReleaseAvailable?: boolean;
+    escrowAddress: string;
+    chainId: number;
+    offchainId?: string;
+    telegramUsername?: string;
+};
+type GetOrderbookResponse = {
+    chainId: number;
+    token: string;
+    currency: string;
+    paymentPlatform: string | null;
+    sortBy: string;
+    sortDirection: string;
+    sellerAutomatedRelease?: 'include' | 'exclude' | 'only';
+    internalDetailsIncluded: boolean;
+    generatedAt: string;
+    entries: OrderbookEntry[];
+};
+
+declare const PAYMENT_PLATFORMS: readonly ["wise", "venmo", "revolut", "cashapp", "mercadopago", "zelle", "paypal", "monzo", "chime", "luxon", "n26"];
+type PaymentPlatformType = (typeof PAYMENT_PLATFORMS)[number];
+
+type ReferralReadOptions$1 = {
+    baseApiUrl?: string;
+    timeoutMs?: number;
+    /** Public wallet-address read target. Omit to use bearer-authenticated caller mode. */
+    address?: Address;
+    authorizationToken?: string;
+    getAuthorizationToken?: IndexerAuthTokenProvider;
+};
+type ReferralBearerWriteOptions$1 = {
+    baseApiUrl?: string;
+    timeoutMs?: number;
+    authorizationToken?: string;
+    getAuthorizationToken?: IndexerAuthTokenProvider;
+};
+type ReferralSignatureOptions$1 = {
+    baseApiUrl?: string;
+    timeoutMs?: number;
+    /** Defaults to base_production for production/preproduction, base_staging for staging. */
+    audience?: string;
+    /** Unix timestamp in seconds. Defaults to now. */
+    issuedAt?: number;
+};
+type RedeemReferralCodeSignatureOptions$1 = ReferralSignatureOptions$1 & {
+    /** Expected owner wallet for the code. If omitted, the SDK looks it up before signing. */
+    referrerWalletAddress?: Address;
+};
+type UpdateReferralCodeSignatureOptions$1 = ReferralSignatureOptions$1 & {
+    /** Current code, signed to prevent stale rename replay. */
+    oldCode: string;
+};
+
+type PV_ReferralFee = {
+    recipient: `0x${string}`;
+    fee: bigint;
+};
+type PV_Deposit = {
+    depositor: string;
+    delegate: string;
+    token: string;
+    amount: bigint;
+    intentAmountRange: {
+        min: bigint;
+        max: bigint;
+    };
+    acceptingIntents: boolean;
+    remainingDeposits: bigint;
+    outstandingIntentAmount: bigint;
+    makerProtocolFee: bigint;
+    reservedMakerFees: bigint;
+    accruedMakerFees: bigint;
+    accruedReferrerFees: bigint;
+    intentGuardian: string;
+    retainOnEmpty: boolean;
+    referrer: string;
+    referrerFee: bigint;
+};
+type PV_Currency = {
+    code: string;
+    minConversionRate: bigint;
+};
+type PV_PaymentMethodData = {
+    paymentMethod: string;
+    verificationData: {
+        intentGatingService: string;
+        payeeDetails: string;
+        data: string;
+    };
+    currencies: PV_Currency[];
+};
+type PV_DepositView = {
+    depositId: bigint;
+    deposit: PV_Deposit;
+    availableLiquidity: bigint;
+    paymentMethods: PV_PaymentMethodData[];
+    intentHashes: string[];
+};
+type PV_Intent = {
+    owner: string;
+    to: string;
+    escrow: string;
+    depositId: bigint;
+    amount: bigint;
+    timestamp: bigint;
+    paymentMethod: string;
+    fiatCurrency: string;
+    conversionRate: bigint;
+    referralFees: PV_ReferralFee[];
+    postIntentHook: string;
+    data: string;
+};
+type PV_IntentView = {
+    intentHash: string;
+    intent: PV_Intent;
+    deposit: Omit<PV_DepositView, 'intentHashes'>;
+};
+declare function parseDepositView(raw: any): PV_DepositView;
+declare function parseIntentView(raw: any): PV_IntentView;
+
+declare function enrichPvDepositView(view: PV_DepositView, chainId: number, env?: RuntimeEnv): {
+    paymentMethods: {
+        processorName: string | undefined;
+        currencies: {
+            currencyInfo: CurrencyData | undefined;
+            code: string;
+            minConversionRate: bigint;
+        }[];
+        paymentMethod: string;
+        verificationData: {
+            intentGatingService: string;
+            payeeDetails: string;
+            data: string;
+        };
+    }[];
+    depositId: bigint;
+    deposit: PV_Deposit;
+    availableLiquidity: bigint;
+    intentHashes: string[];
+};
+declare function enrichPvIntentView(view: PV_IntentView, chainId: number, env?: RuntimeEnv): any;
+
+/**
+ * Indexer entity types sourced from @zkp2p/indexer-schema.
+ */
+
+type WithOverrides<TBase, TOverrides> = Omit<TBase, keyof TOverrides> & TOverrides;
+type DepositStatus = `${DepositStatus$2}`;
+type IntentStatus = `${IntentStatus$1}`;
+type DepositEntity = WithOverrides<Deposit, {
+    status: DepositStatus;
+    retainOnEmpty?: boolean;
+    whitelistHookAddress?: string | null;
+}>;
+type DepositPaymentMethodEntity = DepositPaymentMethod;
+type MethodCurrencyEntity = MethodCurrency;
+type IntentEntity = WithOverrides<Intent$1, {
+    status: IntentStatus;
+}>;
+interface DepositWithRelations extends DepositEntity {
+    paymentMethods?: DepositPaymentMethodEntity[];
+    currencies?: MethodCurrencyEntity[];
+    intents?: IntentEntity[];
+}
+type DepositFundActivityType = 'DEPOSIT_RECEIVED' | 'FUNDS_ADDED' | 'WITHDRAWN' | 'CLOSED';
+/**
+ * Chronological fund-movement log for a deposit.
+ * One row per on-chain fund event (deposit, add, withdraw, close).
+ */
+type DepositFundActivityEntity = WithOverrides<DepositFundActivity, {
+    activityType: DepositFundActivityType;
+}>;
+/**
+ * Per-deposit daily rollup snapshot.
+ * One row per deposit per day (UTC-aligned, 86400s buckets).
+ */
+type DepositDailySnapshotEntity = DepositDailySnapshot;
+interface DepositEventEntity {
+    id: string;
+    depositId: string;
+    depositor: string;
+    amount: string;
+}
+interface DepositEventsResponse {
+    deposits: DepositEventEntity[];
+    fundsAdded: DepositEventEntity[];
+    withdrawals: DepositEventEntity[];
+}
+interface IntentFulfilledEntity {
+    intentHash: string;
+    amount: string;
+    isManualRelease: boolean;
+    fundsTransferredTo?: string | null;
+}
+interface IntentFulfillmentAmountsEntity {
+    intentHash: string;
+    releasedAmount?: string | null;
+    takerAmountNetFees?: string | null;
+}
+type RateManagerEntity = RateManager;
+type RateManagerRateEntity = RateManagerRate;
+interface RateManagerDelegationEntity {
+    id: string;
+    chainId: number;
+    rateManagerId: string;
+    rateManagerAddress?: string | null;
+    depositId: string;
+    delegatedAt?: string | null;
+    createdAt: string;
+    updatedAt: string;
+}
+type ManagerAggregateStatsEntity = WithOverrides<ManagerAggregateStats, {
+    rateManagerAddress?: string | null;
+}>;
+type ManagerStatsEntity = ManagerStats;
+type ManagerDailySnapshotEntity = ManagerDailySnapshot;
+type MakerProfitSnapshotEntity = MakerProfitSnapshot;
+interface ManualRateUpdateEntity {
+    id: string;
+    rateManagerId: string;
+    paymentMethod: string;
+    /** Canonical V2.2 field. */
+    currencyCode?: string;
+    currency: string;
+    /** Canonical V2.2 field. */
+    rate?: string;
+    minRate: string;
+}
+interface OracleConfigUpdateEntity {
+    id: string;
+    rateManagerId: string;
+    escrow?: string;
+    depositIdOnContract?: string;
+    paymentMethod: string;
+    /** Canonical V2.2 field. */
+    currencyCode?: string;
+    currency: string;
+    /** Canonical V2.2 floor field. */
+    floorFixed?: string;
+    /** Canonical V2.2 floor field. */
+    floorSpreadBps?: number;
+    /** Canonical V2.2 floor field. */
+    oracleAdapter?: string;
+    adapter?: string;
+    spreadBps?: number;
+    maxStaleness?: string;
+    adapterConfig?: string;
+    enabled?: boolean;
+}
+interface RateManagerListItem {
+    manager: RateManagerEntity;
+    aggregate?: ManagerAggregateStatsEntity | null;
+}
+interface RateManagerDetail {
+    manager: RateManagerEntity;
+    rates: RateManagerRateEntity[];
+    aggregate?: ManagerAggregateStatsEntity | null;
+    recentStats: ManagerStatsEntity[];
+    delegations: RateManagerDelegationEntity[];
+}
+
+type DepositOrderField = 'remainingDeposits' | 'outstandingIntentAmount' | 'totalAmountTaken' | 'totalWithdrawn' | 'updatedAt' | 'timestamp';
+type OrderDirection$1 = 'asc' | 'desc';
+type DepositFilter = Partial<{
+    status: 'ACTIVE' | 'CLOSED';
+    depositor: string;
+    delegate: string;
+    /** True to only include deposits with a non-zero delegate, false for zero delegate. */
+    delegateIsSet: boolean;
+    chainId: number;
+    escrowAddress: string;
+    escrowAddresses: string[];
+    minLiquidity: string;
+    acceptingIntents: boolean;
+}>;
+type PaginationOptions = Partial<{
+    limit: number;
+    offset: number;
+    orderBy: DepositOrderField;
+    orderDirection: OrderDirection$1;
+}>;
+declare class IndexerDepositService {
+    private client;
+    constructor(client: IndexerClient);
+    private queryWithLegacyFallback;
+    private buildDepositWhere;
+    private buildOrderBy;
+    private fetchRelations;
+    private fetchIntents;
+    private attachRelations;
+    fetchDeposits(filter?: DepositFilter, pagination?: PaginationOptions): Promise<DepositEntity[]>;
+    fetchDepositsWithRelations(filter?: DepositFilter, pagination?: PaginationOptions, options?: {
+        includeIntents?: boolean;
+        intentStatuses?: IntentStatus[];
+    }): Promise<DepositWithRelations[]>;
+    fetchDepositsByIds(ids: string[]): Promise<DepositEntity[]>;
+    fetchDepositsByIdsWithRelations(ids: string[], options?: {
+        includeIntents?: boolean;
+        intentStatuses?: IntentStatus[];
+    }): Promise<DepositWithRelations[]>;
+    fetchIntentsForDeposits(depositIds: string[], statuses?: IntentStatus[]): Promise<IntentEntity[]>;
+    fetchIntentsByOwner(owner: string, statuses?: IntentStatus[]): Promise<IntentEntity[]>;
+    fetchIntentsByRateManager(rateManagerId: string, statuses?: IntentStatus[]): Promise<IntentEntity[]>;
+    fetchIntentByHash(intentHash: string): Promise<IntentEntity | null>;
+    fetchDepositWithRelations(id: string, options?: {
+        includeIntents?: boolean;
+        intentStatuses?: IntentStatus[];
+    }): Promise<DepositWithRelations | null>;
+    fetchExpiredIntents(params: {
+        now: bigint | string;
+        depositIds: string[];
+        limit?: number;
+    }): Promise<IntentEntity[]>;
+    fetchFulfilledIntentEvents(intentHashes: string[]): Promise<IntentFulfilledEntity[]>;
+    fetchIntentFulfillmentAmounts(intentHash: string): Promise<IntentFulfillmentAmountsEntity | null>;
+    resolvePayeeHash(params: {
+        escrowAddress?: string | null;
+        depositId?: string | number | bigint | null;
+        paymentMethodHash?: string | null;
+    }): Promise<string | null>;
+    fetchDepositEvents(depositIdOnContract: string, options?: {
+        escrowAddress?: string | null;
+        depositor?: string | null;
+    }): Promise<DepositEventsResponse>;
+    fetchDepositsByPayeeHash(payeeHash: string, options?: {
+        paymentMethodHash?: string;
+        limit?: number;
+        includeIntents?: boolean;
+        intentStatuses?: IntentStatus[];
+    }): Promise<DepositWithRelations[]>;
     /**
-     * Server-authoritative platform cap grid. Use this for enforced caps; do not
-     * derive platform caps from top-level tier caps or risk multipliers.
+     * Fetch chronological fund activities for a deposit.
      */
-    platformLimits?: PlatformLimit[];
+    fetchDepositFundActivities(compositeDepositId: string): Promise<DepositFundActivityEntity[]>;
     /**
-     * Server-authoritative tier fields (curator PR #461/#463/#478 contract). All
-     * optional because the current production deployment still serves the older
-     * payload that omits them — read them when present and fall back gracefully.
-     * Amounts are USDC base-unit strings (6 decimals).
+     * Fetch fund activities across all deposits for a maker address.
      */
-    /** Base per-intent cap before platform risk multipliers (alias of perIntentCapBaseUnits). */
-    maxOrderSize?: string;
-    maxOrderSizeDisplay?: string;
-    /** Weighted maker-volume floor that qualifies the current tier. */
-    minVolumeForTier?: string;
-    minVolumeForTierDisplay?: string;
-    /** Next tier up the volume ladder, or null at the top / off-ladder tiers. */
-    nextTier?: TakerTierLevel | null;
-    /** Remaining weighted maker volume to reach `nextTier`. */
-    volumeToNextTier?: string | null;
-    volumeToNextTierDisplay?: string | null;
-    nextTierMaxOrderSize?: string | null;
-    nextTierMaxOrderSizeDisplay?: string | null;
+    fetchMakerFundActivities(depositor: string, limit?: number): Promise<DepositFundActivityEntity[]>;
     /**
-     * Compatibility name retained by curator: now contains weighted all-maker
-     * volume driving tier qualification. Present on deployments with the
-     * PR #461/#463 progression contract; PR #478 changes its source semantics.
+     * Fetch daily snapshots for a deposit, ordered by day ascending.
      */
-    peerPayVolume?: string;
-    /** Auditable per-platform weighted-volume inputs. Present on PR #478+ deployments. */
-    volumeBreakdown?: TakerTierVolumeBreakdown[];
-};
-type GetTakerTierRequest = {
-    owner: string;
-    chainId: number;
-};
-type GetTakerTierResponse = {
-    success: boolean;
-    message: string;
-    responseObject: TakerTier;
-    statusCode?: number;
-};
-type GetDepositBundleParams = DepositBundleRequest;
-type GetDepositBundleResponse = DepositBundleResponse;
-type GetOrderbookParams = {
-    currency: string;
-    paymentPlatform?: string;
-    publicOnly?: boolean;
-    sortBy?: 'price' | 'available' | 'limits';
-    sortDirection?: 'asc' | 'desc';
-    sellerAutomatedRelease?: 'include' | 'exclude' | 'only';
-    limit?: number;
-    chainId?: number;
-    token?: string;
+    fetchDepositDailySnapshots(compositeDepositId: string, limit?: number): Promise<DepositDailySnapshotEntity[]>;
+    fetchProfitSnapshotsByDeposits(depositIds: string[]): Promise<MakerProfitSnapshotEntity[]>;
+}
+
+type OrderDirection = 'asc' | 'desc';
+type RateManagerOrderField = 'createdAt' | 'updatedAt' | 'fee' | 'maxFee' | 'rateManagerId' | 'currentDelegatedBalance' | 'totalFilledVolume';
+type RateManagerFilter = Partial<{
+    manager: string;
+    name: string;
+    hasHook: boolean;
+    maxFee: string;
+    rateManagerIds: string[];
+}>;
+type RateManagerPaginationOptions = Partial<{
+    limit: number;
+    offset: number;
+    orderBy: RateManagerOrderField;
+    orderDirection: OrderDirection;
+}>;
+type RateManagerDelegationPaginationOptions = Partial<{
+    limit: number;
+    offset: number;
+    orderBy: 'createdAt' | 'updatedAt' | 'depositId' | 'delegatedAt';
+    orderDirection: OrderDirection;
+    rateManagerAddress: string;
+}>;
+declare function compareEventCursorIdsByRecency(leftId?: string | null, rightId?: string | null): number;
+declare class IndexerRateManagerService {
+    private client;
+    constructor(client: IndexerClient);
+    private buildRateManagerScopeWhere;
+    private buildWhere;
+    private buildAggregateWhere;
+    private buildLegacyAggregateWhere;
+    private buildOrderBy;
+    private toRateManagerListItems;
+    private applyHookFilter;
+    private queryRateManagerList;
+    private buildDelegationOrderBy;
+    private buildLegacyDelegationOrderBy;
+    private fetchCurrentRateManagerDepositScopes;
+    private fetchHistoricalRateManagerDepositScopes;
+    fetchRateManagers(pagination?: RateManagerPaginationOptions, filter?: RateManagerFilter): Promise<RateManagerListItem[]>;
+    fetchRateManagerDetail(rateManagerId: string, options?: {
+        statsLimit?: number;
+        rateManagerAddress?: string | null;
+    }): Promise<RateManagerDetail | null>;
+    fetchRateManagerDelegations(rateManagerId: string, pagination?: RateManagerDelegationPaginationOptions): Promise<RateManagerDelegationEntity[]>;
+    fetchManagerDailySnapshots(rateManagerId: string, options?: {
+        limit?: number;
+        rateManagerAddress?: string | null;
+    }): Promise<ManagerDailySnapshotEntity[]>;
+    fetchDelegationForDeposit(depositId: string, options?: {
+        escrowAddress?: string | null;
+    }): Promise<RateManagerDelegationEntity | null>;
+    fetchManualRateUpdates(rateManagerId: string, options?: {
+        limit?: number;
+        rateManagerAddress?: string | null;
+    }): Promise<ManualRateUpdateEntity[]>;
+    fetchOracleConfigUpdates(rateManagerId: string, options?: {
+        limit?: number;
+        rateManagerAddress?: string | null;
+    }): Promise<OracleConfigUpdateEntity[]>;
+}
+
+type FulfillmentRecord = {
+    id: string;
+    intentHash: string;
+    amount: string;
+    isManualRelease: boolean;
+    fundsTransferredTo: string | null;
 };
-type OrderbookEntry = {
-    depositIdOnContract?: string;
-    depositId: string;
-    depositor: string;
-    price: string;
-    availableTokenAmount: string;
-    availableFiatAmount: string;
-    intentAmountMin: string;
-    intentAmountMax: string;
-    paymentPlatform: string;
+type PaymentVerifiedRecord = {
+    id: string;
+    intentHash: string;
+    method: string;
     currency: string;
-    paymentMethodHash: string;
-    payeeDetailsHash: string;
-    sellerAutomatedReleaseAvailable?: boolean;
-    escrowAddress: string;
-    chainId: number;
-    offchainId?: string;
-    telegramUsername?: string;
+    amount: string;
+    timestamp: string;
+    paymentId: string | null;
+    payeeId: string | null;
 };
-type GetOrderbookResponse = {
-    chainId: number;
-    token: string;
-    currency: string;
-    paymentPlatform: string | null;
-    sortBy: string;
-    sortDirection: string;
-    sellerAutomatedRelease?: 'include' | 'exclude' | 'only';
-    internalDetailsIncluded: boolean;
-    generatedAt: string;
-    entries: OrderbookEntry[];
+type FulfillmentAndPaymentResponse = {
+    Orchestrator_V21_IntentFulfilled: FulfillmentRecord[];
+    UnifiedVerifier_V21_PaymentVerified: PaymentVerifiedRecord[];
 };
+declare function fetchFulfillmentAndPayment(client: IndexerClient, intentHash: string): Promise<FulfillmentAndPaymentResponse>;
 
-declare const PAYMENT_PLATFORMS: readonly ["wise", "venmo", "revolut", "cashapp", "mercadopago", "zelle", "paypal", "monzo", "chime", "luxon", "n26"];
-type PaymentPlatformType = (typeof PAYMENT_PLATFORMS)[number];
-
+type RedeemReferralCodeSignatureOptions = RedeemReferralCodeSignatureOptions$1;
+type ReferralBearerWriteOptions = ReferralBearerWriteOptions$1;
+type ReferralReadOptions = ReferralReadOptions$1;
+type ReferralSignatureOptions = ReferralSignatureOptions$1;
+type UpdateReferralCodeSignatureOptions = UpdateReferralCodeSignatureOptions$1;
 /**
  * Configuration options for creating a Zkp2pClient instance.
  *
@@ -2010,6 +2134,8 @@ type Zkp2pNextOptions = {
     chainId: number;
     /** Optional RPC URL override (defaults to wallet's chain RPC) */
     rpcUrl?: string;
+    /** Optional viem transport override for RPC reads */
+    rpcTransport?: Transport;
     /** Runtime environment: 'production', 'preproduction', or 'staging' (defaults to 'production') */
     runtimeEnv?: RuntimeEnv;
     /** Optional indexer URL override */
@@ -2021,9 +2147,9 @@ type Zkp2pNextOptions = {
      * Not used by public curator endpoints such as quotes, maker reads, or intent signing.
      */
     apiKey?: string;
-    /** Optional bearer token for indexer authentication */
+    /** Optional bearer token for indexer authentication and authenticated curator account APIs */
     authorizationToken?: string;
-    /** Optional async token provider for indexer auth in long-lived clients */
+    /** Optional async token provider for indexer auth and authenticated curator account APIs */
     getAuthorizationToken?: IndexerAuthTokenProvider;
     /** Optional API key for indexer proxy authentication (sent as x-api-key header) */
     indexerApiKey?: string;
@@ -2140,11 +2266,7 @@ type CurrencyOracleRateConfig = {
     maxStaleness: number;
 };
 /** On-chain currency tuple shape passed to EscrowV2 contract methods. */
-type OnchainCurrencyEntry = {
-    code: `0x${string}`;
-    minConversionRate: bigint;
-    oracleRateConfig?: CurrencyOracleRateConfig;
-};
+type OnchainCurrencyEntry = OnchainCurrency;
 /**
  * SDK client for ZKP2P liquidity providers (offramp peers).
  *
@@ -2191,7 +2313,7 @@ type OnchainCurrencyEntry = {
  *   transport: http(),
  * });
  *
- * const client = new OfframpClient({
+ * const client = new Zkp2pClient({
  *   walletClient,
  *   chainId: base.id,
  * });
@@ -2227,7 +2349,7 @@ declare class Zkp2pClient {
     readonly publicClient: PublicClient;
     /** The chain ID this client is configured for */
     readonly chainId: number;
-    /** Runtime environment ('production' or 'staging') */
+    /** Runtime environment ('production', 'preproduction', or 'staging') */
     readonly runtimeEnv: RuntimeEnv;
     /** Escrow contract address */
     readonly escrowAddress: Address;
@@ -2277,8 +2399,10 @@ declare class Zkp2pClient {
     readonly baseApiUrl?: string;
     /** Optional internal curator API key (`x-api-key`) for internal seller verification */
     readonly apiKey?: string;
-    /** Bearer token for indexer authentication */
+    /** Bearer token for indexer authentication and authenticated curator account APIs */
     readonly authorizationToken?: string;
+    /** Optional bearer token provider for indexer and authenticated curator account APIs */
+    readonly getAuthorizationToken?: IndexerAuthTokenProvider;
     /** API timeout in milliseconds */
     readonly apiTimeoutMs: number;
     private _usdcAddress?;
@@ -2289,6 +2413,7 @@ declare class Zkp2pClient {
     private readonly _pvReader;
     private readonly _vaultOps;
     private readonly _intentOps;
+    private readonly _referralOps;
     private _rateManagerInitError?;
     /**
      * Creates a new Zkp2pClient instance.
@@ -2303,8 +2428,6 @@ declare class Zkp2pClient {
     private parseRawDepositId;
     private stripTrailingSlash;
     private defaultAttestationServiceForBaseApiUrl;
-    private normalizeOracleRateConfig;
-    private escrowCurrencyHasOracleConfig;
     /**
      * Normalizes currency tuples by appending an empty `oracleRateConfig` when the ABI
      * requires it and the caller hasn't provided one.
@@ -2313,11 +2436,7 @@ declare class Zkp2pClient {
     supportsInlineOracleRateConfig(params?: {
         escrowAddress?: Address;
     }): boolean;
-    private parseManagerFeeFromRead;
-    private getAbiFunction;
     private resolveAbiFunctionName;
-    private abiTupleHasComponent;
-    private abiFunctionHasInput;
     private resolveEscrowAddressOrThrow;
     private prepareCreateRateManagerTransaction;
     private prepareSetVaultRateTransaction;
@@ -2338,6 +2457,12 @@ declare class Zkp2pClient {
     private lookupIntentEscrowOnchain;
     private warnOrchestratorFallback;
     private resolveOrchestratorContext;
+    /**
+     * Spread helper for viem requests.
+     * justified: TxOverrides mixes legacy gasPrice with EIP-1559 fee fields, which
+     * viem's discriminated request unions reject; keep the suppression in one place.
+     */
+    private applyTxOverrides;
     /**
      * Simulate a contract call (validation only) and send with ERC-8021 attribution.
      * Referrer codes are stripped from overrides for simulation and appended to calldata.
@@ -2479,7 +2604,7 @@ declare class Zkp2pClient {
          * Fetches deposits from the indexer with optional filtering and pagination.
          * Use for advanced queries across all deposits, not just by owner.
          */
-        getDeposits: (filter?: DepositFilter, pagination?: PaginationOptions) => Promise<DepositEntity$1[]>;
+        getDeposits: (filter?: DepositFilter, pagination?: PaginationOptions) => Promise<DepositEntity[]>;
         /**
          * Fetches deposits with their related payment methods and optionally intents.
          */
@@ -2498,19 +2623,19 @@ declare class Zkp2pClient {
         /**
          * Fetches intents for multiple deposits.
          */
-        getIntentsForDeposits: (depositIds: string[], statuses?: IntentStatus[]) => Promise<IntentEntity$1[]>;
+        getIntentsForDeposits: (depositIds: string[], statuses?: IntentStatus[]) => Promise<IntentEntity[]>;
         /**
          * Fetches all intents created by a specific owner address.
          */
-        getOwnerIntents: (owner: string, statuses?: IntentStatus[]) => Promise<IntentEntity$1[]>;
+        getOwnerIntents: (owner: string, statuses?: IntentStatus[]) => Promise<IntentEntity[]>;
         /**
          * Fetches fulfilled intents for a vault by rate manager ID.
          */
-        getIntentsByRateManager: (rateManagerId: string, statuses?: IntentStatus[]) => Promise<IntentEntity$1[]>;
+        getIntentsByRateManager: (rateManagerId: string, statuses?: IntentStatus[]) => Promise<IntentEntity[]>;
         /**
          * Fetches a single intent by hash.
          */
-        getIntentByHash: (intentHash: string) => Promise<IntentEntity$1 | null>;
+        getIntentByHash: (intentHash: string) => Promise<IntentEntity | null>;
         /**
          * Fetches intents that have expired.
          */
@@ -2518,7 +2643,7 @@ declare class Zkp2pClient {
             now: bigint | string;
             depositIds: string[];
             limit?: number;
-        }) => Promise<IntentEntity$1[]>;
+        }) => Promise<IntentEntity[]>;
         /**
          * Fetches fulfillment events for completed intents. `amount` is the net
          * USDC transferred to the taker after protocol/referrer fees.
@@ -2546,7 +2671,7 @@ declare class Zkp2pClient {
          * Fetches deposits by their composite IDs.
          * @param ids - Array of composite IDs in format "chainId_escrowAddress_depositId"
          */
-        getDepositsByIds: (ids: string[]) => Promise<DepositEntity$1[]>;
+        getDepositsByIds: (ids: string[]) => Promise<DepositEntity[]>;
         /**
          * Fetches deposits by their composite IDs with all related data.
          * @param ids - Array of composite IDs in format "chainId_escrowAddress_depositId"
@@ -2558,7 +2683,7 @@ declare class Zkp2pClient {
         /**
          * Fetches maker profit snapshots for the provided deposits.
          */
-        getProfitSnapshotsByDeposits: (depositIds: string[]) => Promise<MakerProfitSnapshotEntity$1[]>;
+        getProfitSnapshotsByDeposits: (depositIds: string[]) => Promise<MakerProfitSnapshotEntity[]>;
         /**
          * Fetches rate managers (vaults) with aggregate stats.
          */
@@ -2598,15 +2723,15 @@ declare class Zkp2pClient {
         /**
          * Fetches chronological fund activities for a specific deposit.
          */
-        getDepositFundActivities: (depositId: string) => Promise<DepositFundActivityEntity$1[]>;
+        getDepositFundActivities: (depositId: string) => Promise<DepositFundActivityEntity[]>;
         /**
          * Fetches fund activities across all deposits for a maker address.
          */
-        getMakerFundActivities: (depositor: string, limit?: number) => Promise<DepositFundActivityEntity$1[]>;
+        getMakerFundActivities: (depositor: string, limit?: number) => Promise<DepositFundActivityEntity[]>;
         /**
          * Fetches daily snapshots for a deposit, ordered by day ascending.
          */
-        getDepositDailySnapshots: (depositId: string, limit?: number) => Promise<DepositDailySnapshotEntity$1[]>;
+        getDepositDailySnapshots: (depositId: string, limit?: number) => Promise<DepositDailySnapshotEntity[]>;
         /**
          * Performs a raw GraphQL query against the indexer.
          */
@@ -2851,12 +2976,7 @@ declare class Zkp2pClient {
         depositId: bigint | number | string;
         paymentMethodHash: `0x${string}`;
         currencyHash: `0x${string}`;
-        config: {
-            adapter: Address;
-            adapterConfig: `0x${string}`;
-            spreadBps: number;
-            maxStaleness: number;
-        };
+        config: CurrencyOracleRateConfig;
         escrowAddress?: Address;
         txOverrides?: TxOverrides;
     }, Hash>;
@@ -2879,12 +2999,7 @@ declare class Zkp2pClient {
         depositId: bigint | number | string;
         paymentMethods: `0x${string}`[];
         currencies: `0x${string}`[][];
-        configs: Array<Array<{
-            adapter: Address;
-            adapterConfig: `0x${string}`;
-            spreadBps: number;
-            maxStaleness: number;
-        }>>;
+        configs: CurrencyOracleRateConfig[][];
         escrowAddress?: Address;
         txOverrides?: TxOverrides;
     }, Hash>;
@@ -2898,12 +3013,7 @@ declare class Zkp2pClient {
             code: `0x${string}`;
             minConversionRate: bigint | string;
             updateOracle: boolean;
-            oracleRateConfig: {
-                adapter: Address;
-                adapterConfig: `0x${string}`;
-                spreadBps: number;
-                maxStaleness: number;
-            };
+            oracleRateConfig: CurrencyOracleRateConfig;
         }>>;
         escrowAddress?: Address;
         txOverrides?: TxOverrides;
@@ -3443,7 +3553,6 @@ declare class Zkp2pClient {
      * Includes fetching intent inputs and calling attestation service.
      */
     private prepareFulfillIntent;
-    private defaultAttestationService;
     /**
      * **Supporting Method** - Fetches quotes for available liquidity.
      *
@@ -3516,6 +3625,49 @@ declare class Zkp2pClient {
         baseApiUrl?: string;
         timeoutMs?: number;
     }): Promise<GetTakerTierResponse>;
+    /**
+     * Fetch a referral dashboard. Pass `address` for a public wallet-keyed read;
+     * omit it to use the authenticated caller mode.
+     */
+    getReferralDashboard(opts?: ReferralReadOptions): Promise<ReferralDashboardResponse>;
+    /**
+     * Fetch referral earnings. Pass `address` for a public wallet-keyed read;
+     * omit it to use the authenticated caller mode.
+     */
+    getReferralEarnings(opts?: ReferralReadOptions): Promise<ReferralEarningsResponse>;
+    /**
+     * Publicly look up a referral code's owner wallet and active status.
+     */
+    lookupReferralCode(code: string, opts?: {
+        baseApiUrl?: string;
+        timeoutMs?: number;
+    }): Promise<ReferralCodeLookupResponse>;
+    /**
+     * Create or fetch the authenticated caller's referral code with bearer auth.
+     */
+    createReferralCode(opts?: ReferralBearerWriteOptions): Promise<CreateReferralCodeResponse>;
+    /**
+     * Create or fetch the wallet's referral code with EIP-712 signature auth.
+     */
+    createReferralCodeWithSignature(opts?: ReferralSignatureOptions): Promise<CreateReferralCodeResponse>;
+    /**
+     * Apply another user's referral code with bearer auth.
+     */
+    redeemReferralCode(code: string, opts?: ReferralBearerWriteOptions): Promise<RedeemReferralCodeResponse>;
+    /**
+     * Apply another user's referral code with EIP-712 signature auth. If
+     * `referrerWalletAddress` is omitted, the SDK looks up the code first and signs
+     * the current owner wallet into the redeem payload.
+     */
+    redeemReferralCodeWithSignature(code: string, opts?: RedeemReferralCodeSignatureOptions): Promise<RedeemReferralCodeResponse>;
+    /**
+     * Customize the authenticated caller's referral code with bearer auth.
+     */
+    updateReferralCode(code: string, opts?: ReferralBearerWriteOptions): Promise<UpdateReferralCodeResponse>;
+    /**
+     * Customize the wallet's referral code with EIP-712 signature auth.
+     */
+    updateReferralCodeWithSignature(code: string, opts: UpdateReferralCodeSignatureOptions): Promise<UpdateReferralCodeResponse>;
     /**
      * The signed `credentialValidatedAt` field is an upload-time freshness witness minted by
      * attestation-service. `credentialExpiresAt` carries an upstream session expiry hint when one
@@ -3572,18 +3724,10 @@ declare class Zkp2pClient {
     }): Promise<CuratorSellerVerifyResponse>;
     private requireProtocolViewer;
     private protocolViewerFunctionInputCount;
-    /**
-     * Returns the input count for a function on a specific PV entry's ABI.
-     * Used to branch between 1-input (V1) and 2-input (V2) PV call signatures.
-     */
-    private pvEntryFunctionInputCount;
-    private isZeroAddressValue;
-    private toBigIntOrZero;
     private buildProtocolViewerContexts;
     private isProtocolViewerDepositPopulated;
     private isProtocolViewerIntentPopulated;
     private buildDepositViewFromEscrowDeposit;
-    private convertIndexerDepositToPvView;
     private getPvAccountDepositsFromIndexer;
     /**
      * Fetches a deposit directly from on-chain ProtocolViewer contract.
@@ -3733,4 +3877,4 @@ type SendBatchFn = (txs: Array<{
     value?: bigint;
 }>) => Promise<string>;
 
-export { type ReleaseFundsToPayerParams as $, type AttestationServiceIdentityResponse as A, type BuyerTeeVerifyPaymentBody as B, type CuratorSellerCredentialUploadResponse as C, type DepositWithRelations as D, type SignalIntentMethodParams as E, type FulfillIntentMethodParams as F, type GoogleOAuthSellerCredentialPlatform as G, type CancelIntentMethodParams as H, type IntentEntity$1 as I, type Zkp2pNextOptions as J, type AuthorizationTokenProvider as K, type TimeoutConfig as L, type ActionCallback as M, type CreateDepositParams as N, type CreateDepositConversionRate as O, type PostDepositDetailsRequest as P, type QuotesBestByPlatformRequest as Q, type ReferrerFeeConfig as R, type SellerCredentialBundle as S, type TakerTierLevel as T, type UploadSellerCredentialBundleParams as U, type ValidatePayeeDetailsRequest as V, type Range as W, type WithdrawDepositParams as X, type SignalIntentParams as Y, Zkp2pClient as Z, type FulfillIntentParams as _, type IdentityAttestationRequestBody as a, type SellerCredentialProbeResponse as a$, type CancelIntentParams as a0, type BestByPlatformResponseObject as a1, type GetBestByPlatformResponse as a2, type GetBestByPlatformResponseObject as a3, type GetPlatformQuote as a4, type PlatformQuote as a5, type QuoteRequest as a6, type GetNearbyQuote as a7, type GetNearbySuggestions as a8, type GetQuoteResponse as a9, type RegisterPayeeDetailsResponse as aA, type SellerPlatform as aB, type VenmoSessionMaterial as aC, type CashAppSessionMaterial as aD, type WiseSessionMaterial as aE, type WiseProfileInfo as aF, type WiseProfileSelectionRequired as aG, type WiseProfileNotFound as aH, type PayPalGoogleOAuthSellerCredentialUploadBody as aI, type VenmoGoogleOAuthSellerCredentialUploadBody as aJ, type VenmoCredentialUploadInput as aK, type CashAppCredentialUploadInput as aL, type WiseCredentialUploadInput as aM, type SellerCredentialUploadInputByPlatform as aN, type SellerCiphertextBundle as aO, type SellerSignedCiphertextBundle as aP, type SellerVerifyIntentDetails as aQ, type SellerVerifyInput as aR, type SellerProbeInput as aS, type SellerCredentialBundleUpload as aT, type SellerCredentialStatusValue as aU, type SellerCredentialStatus as aV, type SellerVerifyProxyBody as aW, type SellerTypedDataField as aX, type SellerTypedDataSpec as aY, type SellerPaymentTypedDataValue as aZ, type SellerAttestationOutput as a_, type GetQuoteResponseObject as aa, type GetQuoteSingleResponse as ab, type QuoteResponse as ac, type QuoteResponseObject as ad, type QuoteSingleResponse as ae, type QuoteIntentResponse as af, type QuoteFeesResponse as ag, type FiatResponse as ah, type TokenResponse as ai, type NearbyQuote as aj, type NearbySuggestions as ak, type ApiDeposit as al, type DepositVerifier as am, type DepositVerifierCurrency as an, type DepositStatus as ao, type GetDepositByIdRequest as ap, type GetDepositByIdResponse as aq, type Intent as ar, type ApiIntentStatus as as, type GetOwnerIntentsRequest as at, type GetOwnerIntentsResponse as au, type GetIntentsByDepositRequest as av, type GetIntentsByDepositResponse as aw, type GetIntentByHashRequest as ax, type GetIntentByHashResponse as ay, type RegisterPayeeDetailsRequest as az, type AttestationServiceSellerVerifyResponse as b, type RateManagerFilter as b$, type FulfillIntentAttestationResponse as b0, type AttestationServiceSellerCredentialProbeResponse as b1, type BuyerTeePaymentParams as b2, type BuyerTeePaymentProofInput as b3, type BuyerTeeSessionMaterial as b4, type CuratorSellerCredentialStatusResponse as b5, type CuratorSellerVerifyResponse as b6, type RegisteredSellerCredentialPlatform as b7, type UploadSellerCredentialParams as b8, type RegisteredUploadSellerCredentialParams as b9, IndexerDepositService as bA, IndexerRateManagerService as bB, compareEventCursorIdsByRecency as bC, fetchFulfillmentAndPayment as bD, type DepositEntity$1 as bE, type IntentFulfilledEntity as bF, type IntentFulfillmentAmountsEntity as bG, type DepositPaymentMethodEntity$1 as bH, type MethodCurrencyEntity$1 as bI, type IntentStatus as bJ, type RateManagerEntity as bK, type RateManagerRateEntity as bL, type RateManagerDelegationEntity as bM, type ManagerAggregateStatsEntity as bN, type ManagerStatsEntity as bO, type ManagerDailySnapshotEntity as bP, type RateManagerListItem as bQ, type RateManagerDetail as bR, type ManualRateUpdateEntity as bS, type OracleConfigUpdateEntity as bT, type DepositFundActivityEntity$1 as bU, type DepositDailySnapshotEntity$1 as bV, type DepositFundActivityType$1 as bW, type DepositFilter as bX, type PaginationOptions as bY, type DepositOrderField as bZ, type OrderDirection$1 as b_, type UploadSellerCredentialOptions as ba, type GetSellerCredentialStatusParams as bb, type UploadPayPalGoogleOAuthSellerCredentialParams as bc, type UploadVenmoGoogleOAuthSellerCredentialParams as bd, type UploadGoogleOAuthSellerCredentialParams as be, type VerifySellerPaymentParams as bf, type IdentityAttestationActionType as bg, type IdentityAttestationOutput as bh, type IdentityAttestationOutputFor as bi, type IdentityAttestationParams as bj, type MakerIdentityAttestationRequestBody as bk, type MakerIdentityPlatform as bl, type OnchainCurrency as bm, type DepositVerifierData as bn, type PreparedTransaction as bo, type OrderStats as bp, type DepositIntentStatistics as bq, type TakerTier as br, type TakerTierVolumeBreakdown as bs, type TakerTierStats as bt, type TakerTierSource as bu, type PlatformLimit as bv, type PlatformRiskLevel as bw, type OrderbookEntry as bx, IndexerClient as by, defaultIndexerEndpoint as bz, type SellerCredentialUploadInput as c, type RateManagerPaginationOptions as c0, type RateManagerDelegationPaginationOptions as c1, type RateManagerOrderField as c2, type OrderDirection as c3, type DeploymentEnv as c4, type FulfillmentRecord as c5, type PaymentVerifiedRecord as c6, type FulfillmentAndPaymentResponse as c7, PAYMENT_PLATFORMS as c8, type PaymentPlatformType as c9, normalizeRateManagerId as cA, normalizeRegistry as cB, getDelegationRoute as cC, classifyDelegationState as cD, type DelegationRoute as cE, type DelegationState as cF, type DelegationDepositTarget as cG, type BatchResult as cH, type SendTransactionFn as cI, type SendBatchFn as cJ, ZERO_ADDRESS as cK, asErrorMessage as cL, assertDelegationMethodSupport as cM, Currency as ca, currencyInfo as cb, getCurrencyInfoFromHash as cc, getCurrencyInfoFromCountryCode as cd, getCurrencyCodeFromHash as ce, isSupportedCurrencyHash as cf, mapConversionRatesToOnchainMinRate as cg, type CurrencyData as ch, getContracts as ci, getRateManagerContracts as cj, getPaymentMethodsCatalog as ck, getGatingServiceAddress as cl, type RuntimeEnv as cm, parseDepositView as cn, parseIntentView as co, enrichPvDepositView as cp, enrichPvIntentView as cq, type PV_DepositView as cr, type PV_Deposit as cs, type PV_PaymentMethodData as ct, type PV_Currency as cu, type PV_ReferralFee as cv, type PV_IntentView as cw, type PV_Intent as cx, ZERO_RATE_MANAGER_ID as cy, isZeroRateManagerId as cz, type SellerCredentialUploadPlatform as d, type SellerCredentialAttestationRuntime as e, type AttestationServiceSellerCredentialUploadResponse as f, type BuyerTeeSessionMaterialEncryptionInput as g, type GoogleOAuthSellerCredentialUploadBodyByPlatform as h, type BestByPlatformResponse as i, type ValidatePayeeDetailsResponse as j, type PostDepositDetailsResponse as k, type GetPayeeDetailsRequest as l, type GetPayeeDetailsResponse as m, type GetOwnerDepositsRequest as n, type GetOwnerDepositsResponse as o, type GetTakerTierRequest as p, type GetTakerTierResponse as q, type GetDepositBundleParams as r, type ApiAdapterOptions as s, type GetDepositBundleResponse as t, type GetOrderbookParams as u, type GetOrderbookResponse as v, type CurrencyType as w, type PaymentMethodCatalog as x, type TxOverrides as y, type SignalIntentReferralFee as z };
+export { type SignalIntentReferralFee as $, type AttestationServiceIdentityResponse as A, type BuyerTeeVerifyPaymentBody as B, type CuratorSellerCredentialUploadResponse as C, type DepositWithRelations as D, type GetTakerTierRequest as E, type GetTakerTierResponse as F, type GoogleOAuthSellerCredentialPlatform as G, type GetDepositBundleParams as H, type IntentEntity as I, type GetDepositBundleResponse as J, type GetOrderbookParams as K, type GetOrderbookResponse as L, type CurrencyType as M, type PaymentMethodCatalog as N, type TxOverrides as O, type PostDepositDetailsRequest as P, type QuotesBestByPlatformRequest as Q, type ReferrerFeeConfig as R, type SellerCredentialBundle as S, type TakerTierLevel as T, type UploadSellerCredentialBundleParams as U, type ValidatePayeeDetailsRequest as V, type ReferralBearerWriteOptions as W, type ReferralReadOptions as X, type ReferralSignatureOptions as Y, Zkp2pClient as Z, type RedeemReferralCodeSignatureOptions as _, type IdentityAttestationRequestBody as a, type VenmoCredentialUploadInput as a$, type SignalIntentMethodParams as a0, type FulfillIntentMethodParams as a1, type CancelIntentMethodParams as a2, type UpdateReferralCodeSignatureOptions as a3, type Zkp2pNextOptions as a4, type AuthorizationTokenProvider as a5, type TimeoutConfig as a6, type ActionCallback as a7, type ReferralRedemption as a8, type ReferralSignatureBody as a9, type NearbyQuote as aA, type NearbySuggestions as aB, type ApiDeposit as aC, type DepositVerifier as aD, type DepositVerifierCurrency as aE, type DepositStatus$1 as aF, type GetDepositByIdRequest as aG, type GetDepositByIdResponse as aH, type Intent as aI, type ApiIntentStatus as aJ, type GetOwnerIntentsRequest as aK, type GetOwnerIntentsResponse as aL, type GetIntentsByDepositRequest as aM, type GetIntentsByDepositResponse as aN, type GetIntentByHashRequest as aO, type GetIntentByHashResponse as aP, type RegisterPayeeDetailsRequest as aQ, type RegisterPayeeDetailsResponse as aR, type SellerPlatform as aS, type VenmoSessionMaterial as aT, type CashAppSessionMaterial as aU, type WiseSessionMaterial as aV, type WiseProfileInfo as aW, type WiseProfileSelectionRequired as aX, type WiseProfileNotFound as aY, type PayPalGoogleOAuthSellerCredentialUploadBody as aZ, type VenmoGoogleOAuthSellerCredentialUploadBody as a_, type CreateDepositParams as aa, type CreateDepositConversionRate as ab, type Range as ac, type WithdrawDepositParams as ad, type SignalIntentParams as ae, type FulfillIntentParams as af, type ReleaseFundsToPayerParams as ag, type CancelIntentParams as ah, type BestByPlatformResponseObject as ai, type GetBestByPlatformResponse as aj, type GetBestByPlatformResponseObject as ak, type GetPlatformQuote as al, type PlatformQuote as am, type QuoteRequest as an, type GetNearbyQuote as ao, type GetNearbySuggestions as ap, type GetQuoteResponse as aq, type GetQuoteResponseObject as ar, type GetQuoteSingleResponse as as, type QuoteResponse as at, type QuoteResponseObject as au, type QuoteSingleResponse as av, type QuoteIntentResponse as aw, type QuoteFeesResponse as ax, type FiatResponse as ay, type TokenResponse as az, type AttestationServiceSellerVerifyResponse as b, type RateManagerEntity as b$, type CashAppCredentialUploadInput as b0, type WiseCredentialUploadInput as b1, type SellerCredentialUploadInputByPlatform as b2, type SellerCiphertextBundle as b3, type SellerSignedCiphertextBundle as b4, type SellerVerifyIntentDetails as b5, type SellerVerifyInput as b6, type SellerProbeInput as b7, type SellerCredentialBundleUpload as b8, type SellerCredentialStatusValue as b9, type IdentityAttestationParams as bA, type MakerIdentityAttestationRequestBody as bB, type MakerIdentityPlatform as bC, type OnchainCurrency as bD, type DepositVerifierData as bE, type PreparedTransaction as bF, type OrderStats as bG, type DepositIntentStatistics as bH, type TakerTier as bI, type TakerTierVolumeBreakdown as bJ, type TakerTierStats as bK, type TakerTierSource as bL, type PlatformLimit as bM, type PlatformRiskLevel as bN, type OrderbookEntry as bO, IndexerClient as bP, defaultIndexerEndpoint as bQ, IndexerDepositService as bR, IndexerRateManagerService as bS, compareEventCursorIdsByRecency as bT, fetchFulfillmentAndPayment as bU, type DepositEntity as bV, type IntentFulfilledEntity as bW, type IntentFulfillmentAmountsEntity as bX, type DepositPaymentMethodEntity as bY, type MethodCurrencyEntity as bZ, type IntentStatus as b_, type SellerCredentialStatus as ba, type SellerVerifyProxyBody as bb, type SellerTypedDataField as bc, type SellerTypedDataSpec as bd, type SellerPaymentTypedDataValue as be, type SellerAttestationOutput as bf, type SellerCredentialProbeResponse as bg, type FulfillIntentAttestationResponse as bh, type AttestationServiceSellerCredentialProbeResponse as bi, type BuyerTeePaymentParams as bj, type BuyerTeePaymentProofInput as bk, type BuyerTeeSessionMaterial as bl, type CuratorSellerCredentialStatusResponse as bm, type CuratorSellerVerifyResponse as bn, type RegisteredSellerCredentialPlatform as bo, type UploadSellerCredentialParams as bp, type RegisteredUploadSellerCredentialParams as bq, type UploadSellerCredentialOptions as br, type GetSellerCredentialStatusParams as bs, type UploadPayPalGoogleOAuthSellerCredentialParams as bt, type UploadVenmoGoogleOAuthSellerCredentialParams as bu, type UploadGoogleOAuthSellerCredentialParams as bv, type VerifySellerPaymentParams as bw, type IdentityAttestationActionType as bx, type IdentityAttestationOutput as by, type IdentityAttestationOutputFor as bz, type SellerCredentialUploadInput as c, ZERO_ADDRESS as c$, type RateManagerRateEntity as c0, type RateManagerDelegationEntity as c1, type ManagerAggregateStatsEntity as c2, type ManagerStatsEntity as c3, type ManagerDailySnapshotEntity as c4, type RateManagerListItem as c5, type RateManagerDetail as c6, type ManualRateUpdateEntity as c7, type OracleConfigUpdateEntity as c8, type DepositFundActivityEntity as c9, getRateManagerContracts as cA, getPaymentMethodsCatalog as cB, getGatingServiceAddress as cC, type RuntimeEnv as cD, parseDepositView as cE, parseIntentView as cF, enrichPvDepositView as cG, enrichPvIntentView as cH, type PV_DepositView as cI, type PV_Deposit as cJ, type PV_PaymentMethodData as cK, type PV_Currency as cL, type PV_ReferralFee as cM, type PV_IntentView as cN, type PV_Intent as cO, ZERO_RATE_MANAGER_ID as cP, isZeroRateManagerId as cQ, normalizeRateManagerId as cR, normalizeRegistry as cS, getDelegationRoute as cT, classifyDelegationState as cU, type DelegationRoute as cV, type DelegationState as cW, type DelegationDepositTarget as cX, type BatchResult as cY, type SendTransactionFn as cZ, type SendBatchFn as c_, type DepositDailySnapshotEntity as ca, type DepositFundActivityType as cb, type DepositFilter as cc, type PaginationOptions as cd, type DepositOrderField as ce, type OrderDirection$1 as cf, type RateManagerFilter as cg, type RateManagerPaginationOptions as ch, type RateManagerDelegationPaginationOptions as ci, type RateManagerOrderField as cj, type OrderDirection as ck, type DeploymentEnv as cl, type FulfillmentRecord as cm, type PaymentVerifiedRecord as cn, type FulfillmentAndPaymentResponse as co, PAYMENT_PLATFORMS as cp, type PaymentPlatformType as cq, Currency as cr, currencyInfo as cs, getCurrencyInfoFromHash as ct, getCurrencyInfoFromCountryCode as cu, getCurrencyCodeFromHash as cv, isSupportedCurrencyHash as cw, mapConversionRatesToOnchainMinRate as cx, type CurrencyData as cy, getContracts as cz, type SellerCredentialUploadPlatform as d, asErrorMessage as d0, assertDelegationMethodSupport as d1, type SellerCredentialAttestationRuntime as e, type AttestationServiceSellerCredentialUploadResponse as f, type BuyerTeeSessionMaterialEncryptionInput as g, type CreateReferralCodeRequest as h, type ApiAdapterOptions as i, type CreateReferralCodeResponse as j, type ReferralReadRequest as k, type ReferralDashboardResponse as l, type ReferralEarningsResponse as m, type ReferralCodeLookupResponse as n, type RedeemReferralCodeRequest as o, type RedeemReferralCodeResponse as p, type UpdateReferralCodeRequest as q, type UpdateReferralCodeResponse as r, type GoogleOAuthSellerCredentialUploadBodyByPlatform as s, type BestByPlatformResponse as t, type ValidatePayeeDetailsResponse as u, type PostDepositDetailsResponse as v, type GetPayeeDetailsRequest as w, type GetPayeeDetailsResponse as x, type GetOwnerDepositsRequest as y, type GetOwnerDepositsResponse as z };