@zkp2p/sdk 0.6.2 → 0.7.1

package/dist/{vaultUtils-BwY9Z0aR.d.mts → vaultUtils-DI-r1LAg.d.mts}

@@ -959,6 +959,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>;
 /**
@@ -994,6 +996,39 @@ type ReferrerFeeConfig = {
     recipient: `0x${string}`;
     feeBps: number;
 };
+type ReferralDashboardResponse = {
+    code: string;
+    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 RedeemReferralCodeRequest = {
+    code: string;
+};
+type RedeemReferralCodeResponse = {
+    redeemedAt: string;
+    referrerWalletAddress: string;
+};
+type UpdateReferralCodeRequest = {
+    code: string;
+};
+type UpdateReferralCodeResponse = {
+    code: string;
+};
 type CuratorMetadata = Record<string, any>;
 type CuratorPayeeData = {
     offchainId: string;
@@ -1139,7 +1174,7 @@ type WiseProfileNotFound = {
     profileId: string;
     profiles: WiseProfileInfo[];
 };
-type GoogleOAuthSellerCredentialPlatform = Extract<SellerPlatform, 'paypal' | 'venmo' | 'zelle'>;
+type GoogleOAuthSellerCredentialPlatform = Extract<SellerPlatform, 'paypal' | 'venmo'>;
 type PayPalGoogleOAuthSellerCredentialUploadBody = {
     payeeEmail: string;
     authorizationCode: string;
@@ -1150,15 +1185,9 @@ type VenmoGoogleOAuthSellerCredentialUploadBody = {
     authorizationCode: string;
     redirectUri: string;
 };
-type ZelleGoogleOAuthSellerCredentialUploadBody = {
-    payeeId: string;
-    authorizationCode: string;
-    redirectUri: string;
-};
 type GoogleOAuthSellerCredentialUploadBodyByPlatform = {
     paypal: PayPalGoogleOAuthSellerCredentialUploadBody;
     venmo: VenmoGoogleOAuthSellerCredentialUploadBody;
-    zelle: ZelleGoogleOAuthSellerCredentialUploadBody;
 };
 type VenmoCredentialUploadInput = {
     payeeId: string;
@@ -1401,11 +1430,7 @@ type UploadVenmoGoogleOAuthSellerCredentialParams = GoogleOAuthSellerCredentialB
     platform: 'venmo';
     accountId: string;
 };
-type UploadZelleGoogleOAuthSellerCredentialParams = GoogleOAuthSellerCredentialBaseParams & {
-    platform: 'zelle';
-    payeeId: string;
-};
-type UploadGoogleOAuthSellerCredentialParams = UploadPayPalGoogleOAuthSellerCredentialParams | UploadVenmoGoogleOAuthSellerCredentialParams | UploadZelleGoogleOAuthSellerCredentialParams;
+type UploadGoogleOAuthSellerCredentialParams = UploadPayPalGoogleOAuthSellerCredentialParams | UploadVenmoGoogleOAuthSellerCredentialParams;
 type VerifySellerPaymentParams = {
     platform: SellerPlatform;
 } & SellerVerifyProxyBody;
@@ -1863,8 +1888,10 @@ type PlatformRiskLevel = 'LOW' | 'MEDIUM_HIGH' | 'HIGH' | 'HIGHEST';
 type PlatformLimit = {
     paymentMethodHash: string;
     platformName: string;
-    riskLevel: PlatformRiskLevel;
-    capMultiplier: number;
+    /** Legacy risk category. Current curator cap-grid responses omit this. */
+    riskLevel?: PlatformRiskLevel;
+    /** Legacy multiplier. Current curator cap-grid responses omit this. */
+    capMultiplier?: number;
     effectiveCap: string;
     effectiveCapDisplay: string;
     hasCooldown: boolean;
@@ -1879,14 +1906,25 @@ type PlatformLimit = {
      */
     reversible?: boolean;
 };
+type TakerTierVolumeBreakdown = {
+    platformName: string;
+    paymentMethodHash: string;
+    volumeBaseUnits: string;
+    volumeDisplay: string;
+    multiplierBps: number;
+    weightedVolumeBaseUnits: string;
+    weightedVolumeDisplay: string;
+};
 /** How the curator resolved the taker tier (see curator tier engine). */
 type TakerTierSource = 'computed' | 'fallback' | 'override' | 'blocklist' | 'peer_president';
 type TakerTier = {
     owner: string;
     chainId: number;
     tier: TakerTierLevel;
-    perIntentCapBaseUnits: string;
-    perIntentCapDisplay: string;
+    /** 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;
@@ -1895,9 +1933,13 @@ type TakerTier = {
     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 contract). All
+     * 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).
@@ -1905,21 +1947,25 @@ type TakerTier = {
     /** Base per-intent cap before platform risk multipliers (alias of perIntentCapBaseUnits). */
     maxOrderSize?: string;
     maxOrderSizeDisplay?: string;
-    /** Lifetime Peer-Pay maker volume floor that qualifies the current tier. */
+    /** 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 maker volume to reach `nextTier`. */
+    /** Remaining Peer Pay volume to reach `nextTier`. */
     volumeToNextTier?: string | null;
     volumeToNextTierDisplay?: string | null;
     nextTierMaxOrderSize?: string | null;
     nextTierMaxOrderSizeDisplay?: string | null;
     /**
-     * Lifetime aggregate Peer-Pay maker volume driving tier qualification. Only
-     * present on curator deployments with the PR #461/#463 contract (preprod).
+     * 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;
@@ -2011,9 +2057,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;
@@ -2267,8 +2313,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?;
@@ -2293,6 +2341,7 @@ declare class Zkp2pClient {
     private parseRawDepositId;
     private stripTrailingSlash;
     private defaultAttestationServiceForBaseApiUrl;
+    private resolveAuthorizationToken;
     private normalizeOracleRateConfig;
     private escrowCurrencyHasOracleConfig;
     /**
@@ -3506,6 +3555,43 @@ declare class Zkp2pClient {
         baseApiUrl?: string;
         timeoutMs?: number;
     }): Promise<GetTakerTierResponse>;
+    /**
+     * Fetch the authenticated user's referral dashboard, including their generated
+     * code, reward rates, referee counts, and lifetime referral fees.
+     */
+    getReferralDashboard(opts?: {
+        baseApiUrl?: string;
+        timeoutMs?: number;
+        authorizationToken?: string;
+        getAuthorizationToken?: IndexerAuthTokenProvider;
+    }): Promise<ReferralDashboardResponse>;
+    /**
+     * Fetch the authenticated user's referral earnings totals.
+     */
+    getReferralEarnings(opts?: {
+        baseApiUrl?: string;
+        timeoutMs?: number;
+        authorizationToken?: string;
+        getAuthorizationToken?: IndexerAuthTokenProvider;
+    }): Promise<ReferralEarningsResponse>;
+    /**
+     * Apply another user's referral code to the authenticated account.
+     */
+    redeemReferralCode(code: string, opts?: {
+        baseApiUrl?: string;
+        timeoutMs?: number;
+        authorizationToken?: string;
+        getAuthorizationToken?: IndexerAuthTokenProvider;
+    }): Promise<RedeemReferralCodeResponse>;
+    /**
+     * Customize the authenticated user's own referral code.
+     */
+    updateReferralCode(code: string, opts?: {
+        baseApiUrl?: string;
+        timeoutMs?: number;
+        authorizationToken?: string;
+        getAuthorizationToken?: IndexerAuthTokenProvider;
+    }): 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
@@ -3723,4 +3809,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 SellerAttestationOutput 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 ZelleGoogleOAuthSellerCredentialUploadBody as aK, type VenmoCredentialUploadInput as aL, type CashAppCredentialUploadInput as aM, type WiseCredentialUploadInput as aN, type SellerCredentialUploadInputByPlatform as aO, type SellerCiphertextBundle as aP, type SellerSignedCiphertextBundle as aQ, type SellerVerifyIntentDetails as aR, type SellerVerifyInput as aS, type SellerProbeInput as aT, type SellerCredentialBundleUpload as aU, type SellerCredentialStatusValue as aV, type SellerCredentialStatus as aW, type SellerVerifyProxyBody as aX, type SellerTypedDataField as aY, type SellerTypedDataSpec as aZ, type SellerPaymentTypedDataValue 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 OrderDirection$1 as b$, type SellerCredentialProbeResponse as b0, type FulfillIntentAttestationResponse as b1, type AttestationServiceSellerCredentialProbeResponse as b2, type BuyerTeePaymentParams as b3, type BuyerTeePaymentProofInput as b4, type BuyerTeeSessionMaterial as b5, type CuratorSellerCredentialStatusResponse as b6, type CuratorSellerVerifyResponse as b7, type RegisteredSellerCredentialPlatform as b8, type UploadSellerCredentialParams as b9, defaultIndexerEndpoint as bA, IndexerDepositService as bB, IndexerRateManagerService as bC, compareEventCursorIdsByRecency as bD, fetchFulfillmentAndPayment as bE, type DepositEntity$1 as bF, type IntentFulfilledEntity as bG, type IntentFulfillmentAmountsEntity as bH, type DepositPaymentMethodEntity$1 as bI, type MethodCurrencyEntity$1 as bJ, type IntentStatus as bK, type RateManagerEntity as bL, type RateManagerRateEntity as bM, type RateManagerDelegationEntity as bN, type ManagerAggregateStatsEntity as bO, type ManagerStatsEntity as bP, type ManagerDailySnapshotEntity as bQ, type RateManagerListItem as bR, type RateManagerDetail as bS, type ManualRateUpdateEntity as bT, type OracleConfigUpdateEntity as bU, type DepositFundActivityEntity$1 as bV, type DepositDailySnapshotEntity$1 as bW, type DepositFundActivityType$1 as bX, type DepositFilter as bY, type PaginationOptions as bZ, type DepositOrderField as b_, type RegisteredUploadSellerCredentialParams as ba, type UploadSellerCredentialOptions as bb, type GetSellerCredentialStatusParams as bc, type UploadPayPalGoogleOAuthSellerCredentialParams as bd, type UploadVenmoGoogleOAuthSellerCredentialParams as be, type UploadZelleGoogleOAuthSellerCredentialParams as bf, type UploadGoogleOAuthSellerCredentialParams as bg, type VerifySellerPaymentParams as bh, type IdentityAttestationActionType as bi, type IdentityAttestationOutput as bj, type IdentityAttestationOutputFor as bk, type IdentityAttestationParams as bl, type MakerIdentityAttestationRequestBody as bm, type MakerIdentityPlatform as bn, type OnchainCurrency as bo, type DepositVerifierData as bp, type PreparedTransaction as bq, type OrderStats as br, type DepositIntentStatistics as bs, type TakerTier as bt, type TakerTierStats as bu, type TakerTierSource as bv, type PlatformLimit as bw, type PlatformRiskLevel as bx, type OrderbookEntry as by, IndexerClient as bz, type SellerCredentialUploadInput as c, type RateManagerFilter as c0, type RateManagerPaginationOptions as c1, type RateManagerDelegationPaginationOptions as c2, type RateManagerOrderField as c3, type OrderDirection as c4, type DeploymentEnv as c5, type FulfillmentRecord as c6, type PaymentVerifiedRecord as c7, type FulfillmentAndPaymentResponse as c8, PAYMENT_PLATFORMS as c9, isZeroRateManagerId as cA, normalizeRateManagerId as cB, normalizeRegistry as cC, getDelegationRoute as cD, classifyDelegationState as cE, type DelegationRoute as cF, type DelegationState as cG, type DelegationDepositTarget as cH, type BatchResult as cI, type SendTransactionFn as cJ, type SendBatchFn as cK, ZERO_ADDRESS as cL, asErrorMessage as cM, assertDelegationMethodSupport as cN, type PaymentPlatformType as ca, Currency as cb, currencyInfo as cc, getCurrencyInfoFromHash as cd, getCurrencyInfoFromCountryCode as ce, getCurrencyCodeFromHash as cf, isSupportedCurrencyHash as cg, mapConversionRatesToOnchainMinRate as ch, type CurrencyData as ci, getContracts as cj, getRateManagerContracts as ck, getPaymentMethodsCatalog as cl, getGatingServiceAddress as cm, type RuntimeEnv as cn, parseDepositView as co, parseIntentView as cp, enrichPvDepositView as cq, enrichPvIntentView as cr, type PV_DepositView as cs, type PV_Deposit as ct, type PV_PaymentMethodData as cu, type PV_Currency as cv, type PV_ReferralFee as cw, type PV_IntentView as cx, type PV_Intent as cy, ZERO_RATE_MANAGER_ID 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 CreateDepositParams as $, type AttestationServiceIdentityResponse as A, type BuyerTeeVerifyPaymentBody as B, type CuratorSellerCredentialUploadResponse as C, type DepositWithRelations as D, type GetOrderbookParams as E, type GetOrderbookResponse as F, type GoogleOAuthSellerCredentialPlatform as G, type CurrencyType as H, type IntentEntity$1 as I, type PaymentMethodCatalog as J, type TxOverrides as K, type SignalIntentReferralFee as L, type SignalIntentMethodParams as M, type FulfillIntentMethodParams as N, type CancelIntentMethodParams 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 Zkp2pNextOptions as W, type AuthorizationTokenProvider as X, type TimeoutConfig as Y, Zkp2pClient as Z, type ActionCallback as _, type IdentityAttestationRequestBody as a, type SellerCredentialStatus as a$, type CreateDepositConversionRate as a0, type Range as a1, type WithdrawDepositParams as a2, type SignalIntentParams as a3, type FulfillIntentParams as a4, type ReleaseFundsToPayerParams as a5, type CancelIntentParams as a6, type BestByPlatformResponseObject as a7, type GetBestByPlatformResponse as a8, type GetBestByPlatformResponseObject as a9, type GetOwnerIntentsResponse as aA, type GetIntentsByDepositRequest as aB, type GetIntentsByDepositResponse as aC, type GetIntentByHashRequest as aD, type GetIntentByHashResponse as aE, type RegisterPayeeDetailsRequest as aF, type RegisterPayeeDetailsResponse as aG, type SellerPlatform as aH, type VenmoSessionMaterial as aI, type CashAppSessionMaterial as aJ, type WiseSessionMaterial as aK, type WiseProfileInfo as aL, type WiseProfileSelectionRequired as aM, type WiseProfileNotFound as aN, type PayPalGoogleOAuthSellerCredentialUploadBody as aO, type VenmoGoogleOAuthSellerCredentialUploadBody as aP, type VenmoCredentialUploadInput as aQ, type CashAppCredentialUploadInput as aR, type WiseCredentialUploadInput as aS, type SellerCredentialUploadInputByPlatform as aT, type SellerCiphertextBundle as aU, type SellerSignedCiphertextBundle as aV, type SellerVerifyIntentDetails as aW, type SellerVerifyInput as aX, type SellerProbeInput as aY, type SellerCredentialBundleUpload as aZ, type SellerCredentialStatusValue as a_, type GetPlatformQuote as aa, type PlatformQuote as ab, type QuoteRequest as ac, type GetNearbyQuote as ad, type GetNearbySuggestions as ae, type GetQuoteResponse as af, type GetQuoteResponseObject as ag, type GetQuoteSingleResponse as ah, type QuoteResponse as ai, type QuoteResponseObject as aj, type QuoteSingleResponse as ak, type QuoteIntentResponse as al, type QuoteFeesResponse as am, type FiatResponse as an, type TokenResponse as ao, type NearbyQuote as ap, type NearbySuggestions as aq, type ApiDeposit as ar, type DepositVerifier as as, type DepositVerifierCurrency as at, type DepositStatus as au, type GetDepositByIdRequest as av, type GetDepositByIdResponse as aw, type Intent as ax, type ApiIntentStatus as ay, type GetOwnerIntentsRequest as az, type AttestationServiceSellerVerifyResponse as b, type DepositDailySnapshotEntity$1 as b$, type SellerVerifyProxyBody as b0, type SellerTypedDataField as b1, type SellerTypedDataSpec as b2, type SellerPaymentTypedDataValue as b3, type SellerAttestationOutput as b4, type SellerCredentialProbeResponse as b5, type FulfillIntentAttestationResponse as b6, type AttestationServiceSellerCredentialProbeResponse as b7, type BuyerTeePaymentParams as b8, type BuyerTeePaymentProofInput as b9, type TakerTierSource as bA, type PlatformLimit as bB, type PlatformRiskLevel as bC, type OrderbookEntry as bD, IndexerClient as bE, defaultIndexerEndpoint as bF, IndexerDepositService as bG, IndexerRateManagerService as bH, compareEventCursorIdsByRecency as bI, fetchFulfillmentAndPayment as bJ, type DepositEntity$1 as bK, type IntentFulfilledEntity as bL, type IntentFulfillmentAmountsEntity as bM, type DepositPaymentMethodEntity$1 as bN, type MethodCurrencyEntity$1 as bO, type IntentStatus as bP, type RateManagerEntity as bQ, type RateManagerRateEntity as bR, type RateManagerDelegationEntity as bS, type ManagerAggregateStatsEntity as bT, type ManagerStatsEntity as bU, type ManagerDailySnapshotEntity as bV, type RateManagerListItem as bW, type RateManagerDetail as bX, type ManualRateUpdateEntity as bY, type OracleConfigUpdateEntity as bZ, type DepositFundActivityEntity$1 as b_, type BuyerTeeSessionMaterial as ba, type CuratorSellerCredentialStatusResponse as bb, type CuratorSellerVerifyResponse as bc, type RegisteredSellerCredentialPlatform as bd, type UploadSellerCredentialParams as be, type RegisteredUploadSellerCredentialParams as bf, type UploadSellerCredentialOptions as bg, type GetSellerCredentialStatusParams as bh, type UploadPayPalGoogleOAuthSellerCredentialParams as bi, type UploadVenmoGoogleOAuthSellerCredentialParams as bj, type UploadGoogleOAuthSellerCredentialParams as bk, type VerifySellerPaymentParams as bl, type IdentityAttestationActionType as bm, type IdentityAttestationOutput as bn, type IdentityAttestationOutputFor as bo, type IdentityAttestationParams as bp, type MakerIdentityAttestationRequestBody as bq, type MakerIdentityPlatform as br, type OnchainCurrency as bs, type DepositVerifierData as bt, type PreparedTransaction as bu, type OrderStats as bv, type DepositIntentStatistics as bw, type TakerTier as bx, type TakerTierVolumeBreakdown as by, type TakerTierStats as bz, type SellerCredentialUploadInput as c, type DepositFundActivityType$1 as c0, type DepositFilter as c1, type PaginationOptions as c2, type DepositOrderField as c3, type OrderDirection$1 as c4, type RateManagerFilter as c5, type RateManagerPaginationOptions as c6, type RateManagerDelegationPaginationOptions as c7, type RateManagerOrderField as c8, type OrderDirection as c9, type PV_Currency as cA, type PV_ReferralFee as cB, type PV_IntentView as cC, type PV_Intent as cD, ZERO_RATE_MANAGER_ID as cE, isZeroRateManagerId as cF, normalizeRateManagerId as cG, normalizeRegistry as cH, getDelegationRoute as cI, classifyDelegationState as cJ, type DelegationRoute as cK, type DelegationState as cL, type DelegationDepositTarget as cM, type BatchResult as cN, type SendTransactionFn as cO, type SendBatchFn as cP, ZERO_ADDRESS as cQ, asErrorMessage as cR, assertDelegationMethodSupport as cS, type DeploymentEnv as ca, type FulfillmentRecord as cb, type PaymentVerifiedRecord as cc, type FulfillmentAndPaymentResponse as cd, PAYMENT_PLATFORMS as ce, type PaymentPlatformType as cf, Currency as cg, currencyInfo as ch, getCurrencyInfoFromHash as ci, getCurrencyInfoFromCountryCode as cj, getCurrencyCodeFromHash as ck, isSupportedCurrencyHash as cl, mapConversionRatesToOnchainMinRate as cm, type CurrencyData as cn, getContracts as co, getRateManagerContracts as cp, getPaymentMethodsCatalog as cq, getGatingServiceAddress as cr, type RuntimeEnv as cs, parseDepositView as ct, parseIntentView as cu, enrichPvDepositView as cv, enrichPvIntentView as cw, type PV_DepositView as cx, type PV_Deposit as cy, type PV_PaymentMethodData as cz, type SellerCredentialUploadPlatform as d, type SellerCredentialAttestationRuntime as e, type AttestationServiceSellerCredentialUploadResponse as f, type BuyerTeeSessionMaterialEncryptionInput as g, type ApiAdapterOptions as h, type ReferralDashboardResponse as i, type ReferralEarningsResponse as j, type RedeemReferralCodeRequest as k, type RedeemReferralCodeResponse as l, type UpdateReferralCodeRequest as m, type UpdateReferralCodeResponse as n, type GoogleOAuthSellerCredentialUploadBodyByPlatform as o, type BestByPlatformResponse as p, type ValidatePayeeDetailsResponse as q, type PostDepositDetailsResponse as r, type GetPayeeDetailsRequest as s, type GetPayeeDetailsResponse as t, type GetOwnerDepositsRequest as u, type GetOwnerDepositsResponse as v, type GetTakerTierRequest as w, type GetTakerTierResponse as x, type GetDepositBundleParams as y, type GetDepositBundleResponse as z };

package/dist/{vaultUtils-BwY9Z0aR.d.ts → vaultUtils-DI-r1LAg.d.ts}

@@ -959,6 +959,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>;
 /**
@@ -994,6 +996,39 @@ type ReferrerFeeConfig = {
     recipient: `0x${string}`;
     feeBps: number;
 };
+type ReferralDashboardResponse = {
+    code: string;
+    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 RedeemReferralCodeRequest = {
+    code: string;
+};
+type RedeemReferralCodeResponse = {
+    redeemedAt: string;
+    referrerWalletAddress: string;
+};
+type UpdateReferralCodeRequest = {
+    code: string;
+};
+type UpdateReferralCodeResponse = {
+    code: string;
+};
 type CuratorMetadata = Record<string, any>;
 type CuratorPayeeData = {
     offchainId: string;
@@ -1139,7 +1174,7 @@ type WiseProfileNotFound = {
     profileId: string;
     profiles: WiseProfileInfo[];
 };
-type GoogleOAuthSellerCredentialPlatform = Extract<SellerPlatform, 'paypal' | 'venmo' | 'zelle'>;
+type GoogleOAuthSellerCredentialPlatform = Extract<SellerPlatform, 'paypal' | 'venmo'>;
 type PayPalGoogleOAuthSellerCredentialUploadBody = {
     payeeEmail: string;
     authorizationCode: string;
@@ -1150,15 +1185,9 @@ type VenmoGoogleOAuthSellerCredentialUploadBody = {
     authorizationCode: string;
     redirectUri: string;
 };
-type ZelleGoogleOAuthSellerCredentialUploadBody = {
-    payeeId: string;
-    authorizationCode: string;
-    redirectUri: string;
-};
 type GoogleOAuthSellerCredentialUploadBodyByPlatform = {
     paypal: PayPalGoogleOAuthSellerCredentialUploadBody;
     venmo: VenmoGoogleOAuthSellerCredentialUploadBody;
-    zelle: ZelleGoogleOAuthSellerCredentialUploadBody;
 };
 type VenmoCredentialUploadInput = {
     payeeId: string;
@@ -1401,11 +1430,7 @@ type UploadVenmoGoogleOAuthSellerCredentialParams = GoogleOAuthSellerCredentialB
     platform: 'venmo';
     accountId: string;
 };
-type UploadZelleGoogleOAuthSellerCredentialParams = GoogleOAuthSellerCredentialBaseParams & {
-    platform: 'zelle';
-    payeeId: string;
-};
-type UploadGoogleOAuthSellerCredentialParams = UploadPayPalGoogleOAuthSellerCredentialParams | UploadVenmoGoogleOAuthSellerCredentialParams | UploadZelleGoogleOAuthSellerCredentialParams;
+type UploadGoogleOAuthSellerCredentialParams = UploadPayPalGoogleOAuthSellerCredentialParams | UploadVenmoGoogleOAuthSellerCredentialParams;
 type VerifySellerPaymentParams = {
     platform: SellerPlatform;
 } & SellerVerifyProxyBody;
@@ -1863,8 +1888,10 @@ type PlatformRiskLevel = 'LOW' | 'MEDIUM_HIGH' | 'HIGH' | 'HIGHEST';
 type PlatformLimit = {
     paymentMethodHash: string;
     platformName: string;
-    riskLevel: PlatformRiskLevel;
-    capMultiplier: number;
+    /** Legacy risk category. Current curator cap-grid responses omit this. */
+    riskLevel?: PlatformRiskLevel;
+    /** Legacy multiplier. Current curator cap-grid responses omit this. */
+    capMultiplier?: number;
     effectiveCap: string;
     effectiveCapDisplay: string;
     hasCooldown: boolean;
@@ -1879,14 +1906,25 @@ type PlatformLimit = {
      */
     reversible?: boolean;
 };
+type TakerTierVolumeBreakdown = {
+    platformName: string;
+    paymentMethodHash: string;
+    volumeBaseUnits: string;
+    volumeDisplay: string;
+    multiplierBps: number;
+    weightedVolumeBaseUnits: string;
+    weightedVolumeDisplay: string;
+};
 /** How the curator resolved the taker tier (see curator tier engine). */
 type TakerTierSource = 'computed' | 'fallback' | 'override' | 'blocklist' | 'peer_president';
 type TakerTier = {
     owner: string;
     chainId: number;
     tier: TakerTierLevel;
-    perIntentCapBaseUnits: string;
-    perIntentCapDisplay: string;
+    /** 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;
@@ -1895,9 +1933,13 @@ type TakerTier = {
     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 contract). All
+     * 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).
@@ -1905,21 +1947,25 @@ type TakerTier = {
     /** Base per-intent cap before platform risk multipliers (alias of perIntentCapBaseUnits). */
     maxOrderSize?: string;
     maxOrderSizeDisplay?: string;
-    /** Lifetime Peer-Pay maker volume floor that qualifies the current tier. */
+    /** 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 maker volume to reach `nextTier`. */
+    /** Remaining Peer Pay volume to reach `nextTier`. */
     volumeToNextTier?: string | null;
     volumeToNextTierDisplay?: string | null;
     nextTierMaxOrderSize?: string | null;
     nextTierMaxOrderSizeDisplay?: string | null;
     /**
-     * Lifetime aggregate Peer-Pay maker volume driving tier qualification. Only
-     * present on curator deployments with the PR #461/#463 contract (preprod).
+     * 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;
@@ -2011,9 +2057,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;
@@ -2267,8 +2313,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?;
@@ -2293,6 +2341,7 @@ declare class Zkp2pClient {
     private parseRawDepositId;
     private stripTrailingSlash;
     private defaultAttestationServiceForBaseApiUrl;
+    private resolveAuthorizationToken;
     private normalizeOracleRateConfig;
     private escrowCurrencyHasOracleConfig;
     /**
@@ -3506,6 +3555,43 @@ declare class Zkp2pClient {
         baseApiUrl?: string;
         timeoutMs?: number;
     }): Promise<GetTakerTierResponse>;
+    /**
+     * Fetch the authenticated user's referral dashboard, including their generated
+     * code, reward rates, referee counts, and lifetime referral fees.
+     */
+    getReferralDashboard(opts?: {
+        baseApiUrl?: string;
+        timeoutMs?: number;
+        authorizationToken?: string;
+        getAuthorizationToken?: IndexerAuthTokenProvider;
+    }): Promise<ReferralDashboardResponse>;
+    /**
+     * Fetch the authenticated user's referral earnings totals.
+     */
+    getReferralEarnings(opts?: {
+        baseApiUrl?: string;
+        timeoutMs?: number;
+        authorizationToken?: string;
+        getAuthorizationToken?: IndexerAuthTokenProvider;
+    }): Promise<ReferralEarningsResponse>;
+    /**
+     * Apply another user's referral code to the authenticated account.
+     */
+    redeemReferralCode(code: string, opts?: {
+        baseApiUrl?: string;
+        timeoutMs?: number;
+        authorizationToken?: string;
+        getAuthorizationToken?: IndexerAuthTokenProvider;
+    }): Promise<RedeemReferralCodeResponse>;
+    /**
+     * Customize the authenticated user's own referral code.
+     */
+    updateReferralCode(code: string, opts?: {
+        baseApiUrl?: string;
+        timeoutMs?: number;
+        authorizationToken?: string;
+        getAuthorizationToken?: IndexerAuthTokenProvider;
+    }): 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
@@ -3723,4 +3809,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 SellerAttestationOutput 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 ZelleGoogleOAuthSellerCredentialUploadBody as aK, type VenmoCredentialUploadInput as aL, type CashAppCredentialUploadInput as aM, type WiseCredentialUploadInput as aN, type SellerCredentialUploadInputByPlatform as aO, type SellerCiphertextBundle as aP, type SellerSignedCiphertextBundle as aQ, type SellerVerifyIntentDetails as aR, type SellerVerifyInput as aS, type SellerProbeInput as aT, type SellerCredentialBundleUpload as aU, type SellerCredentialStatusValue as aV, type SellerCredentialStatus as aW, type SellerVerifyProxyBody as aX, type SellerTypedDataField as aY, type SellerTypedDataSpec as aZ, type SellerPaymentTypedDataValue 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 OrderDirection$1 as b$, type SellerCredentialProbeResponse as b0, type FulfillIntentAttestationResponse as b1, type AttestationServiceSellerCredentialProbeResponse as b2, type BuyerTeePaymentParams as b3, type BuyerTeePaymentProofInput as b4, type BuyerTeeSessionMaterial as b5, type CuratorSellerCredentialStatusResponse as b6, type CuratorSellerVerifyResponse as b7, type RegisteredSellerCredentialPlatform as b8, type UploadSellerCredentialParams as b9, defaultIndexerEndpoint as bA, IndexerDepositService as bB, IndexerRateManagerService as bC, compareEventCursorIdsByRecency as bD, fetchFulfillmentAndPayment as bE, type DepositEntity$1 as bF, type IntentFulfilledEntity as bG, type IntentFulfillmentAmountsEntity as bH, type DepositPaymentMethodEntity$1 as bI, type MethodCurrencyEntity$1 as bJ, type IntentStatus as bK, type RateManagerEntity as bL, type RateManagerRateEntity as bM, type RateManagerDelegationEntity as bN, type ManagerAggregateStatsEntity as bO, type ManagerStatsEntity as bP, type ManagerDailySnapshotEntity as bQ, type RateManagerListItem as bR, type RateManagerDetail as bS, type ManualRateUpdateEntity as bT, type OracleConfigUpdateEntity as bU, type DepositFundActivityEntity$1 as bV, type DepositDailySnapshotEntity$1 as bW, type DepositFundActivityType$1 as bX, type DepositFilter as bY, type PaginationOptions as bZ, type DepositOrderField as b_, type RegisteredUploadSellerCredentialParams as ba, type UploadSellerCredentialOptions as bb, type GetSellerCredentialStatusParams as bc, type UploadPayPalGoogleOAuthSellerCredentialParams as bd, type UploadVenmoGoogleOAuthSellerCredentialParams as be, type UploadZelleGoogleOAuthSellerCredentialParams as bf, type UploadGoogleOAuthSellerCredentialParams as bg, type VerifySellerPaymentParams as bh, type IdentityAttestationActionType as bi, type IdentityAttestationOutput as bj, type IdentityAttestationOutputFor as bk, type IdentityAttestationParams as bl, type MakerIdentityAttestationRequestBody as bm, type MakerIdentityPlatform as bn, type OnchainCurrency as bo, type DepositVerifierData as bp, type PreparedTransaction as bq, type OrderStats as br, type DepositIntentStatistics as bs, type TakerTier as bt, type TakerTierStats as bu, type TakerTierSource as bv, type PlatformLimit as bw, type PlatformRiskLevel as bx, type OrderbookEntry as by, IndexerClient as bz, type SellerCredentialUploadInput as c, type RateManagerFilter as c0, type RateManagerPaginationOptions as c1, type RateManagerDelegationPaginationOptions as c2, type RateManagerOrderField as c3, type OrderDirection as c4, type DeploymentEnv as c5, type FulfillmentRecord as c6, type PaymentVerifiedRecord as c7, type FulfillmentAndPaymentResponse as c8, PAYMENT_PLATFORMS as c9, isZeroRateManagerId as cA, normalizeRateManagerId as cB, normalizeRegistry as cC, getDelegationRoute as cD, classifyDelegationState as cE, type DelegationRoute as cF, type DelegationState as cG, type DelegationDepositTarget as cH, type BatchResult as cI, type SendTransactionFn as cJ, type SendBatchFn as cK, ZERO_ADDRESS as cL, asErrorMessage as cM, assertDelegationMethodSupport as cN, type PaymentPlatformType as ca, Currency as cb, currencyInfo as cc, getCurrencyInfoFromHash as cd, getCurrencyInfoFromCountryCode as ce, getCurrencyCodeFromHash as cf, isSupportedCurrencyHash as cg, mapConversionRatesToOnchainMinRate as ch, type CurrencyData as ci, getContracts as cj, getRateManagerContracts as ck, getPaymentMethodsCatalog as cl, getGatingServiceAddress as cm, type RuntimeEnv as cn, parseDepositView as co, parseIntentView as cp, enrichPvDepositView as cq, enrichPvIntentView as cr, type PV_DepositView as cs, type PV_Deposit as ct, type PV_PaymentMethodData as cu, type PV_Currency as cv, type PV_ReferralFee as cw, type PV_IntentView as cx, type PV_Intent as cy, ZERO_RATE_MANAGER_ID 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 CreateDepositParams as $, type AttestationServiceIdentityResponse as A, type BuyerTeeVerifyPaymentBody as B, type CuratorSellerCredentialUploadResponse as C, type DepositWithRelations as D, type GetOrderbookParams as E, type GetOrderbookResponse as F, type GoogleOAuthSellerCredentialPlatform as G, type CurrencyType as H, type IntentEntity$1 as I, type PaymentMethodCatalog as J, type TxOverrides as K, type SignalIntentReferralFee as L, type SignalIntentMethodParams as M, type FulfillIntentMethodParams as N, type CancelIntentMethodParams 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 Zkp2pNextOptions as W, type AuthorizationTokenProvider as X, type TimeoutConfig as Y, Zkp2pClient as Z, type ActionCallback as _, type IdentityAttestationRequestBody as a, type SellerCredentialStatus as a$, type CreateDepositConversionRate as a0, type Range as a1, type WithdrawDepositParams as a2, type SignalIntentParams as a3, type FulfillIntentParams as a4, type ReleaseFundsToPayerParams as a5, type CancelIntentParams as a6, type BestByPlatformResponseObject as a7, type GetBestByPlatformResponse as a8, type GetBestByPlatformResponseObject as a9, type GetOwnerIntentsResponse as aA, type GetIntentsByDepositRequest as aB, type GetIntentsByDepositResponse as aC, type GetIntentByHashRequest as aD, type GetIntentByHashResponse as aE, type RegisterPayeeDetailsRequest as aF, type RegisterPayeeDetailsResponse as aG, type SellerPlatform as aH, type VenmoSessionMaterial as aI, type CashAppSessionMaterial as aJ, type WiseSessionMaterial as aK, type WiseProfileInfo as aL, type WiseProfileSelectionRequired as aM, type WiseProfileNotFound as aN, type PayPalGoogleOAuthSellerCredentialUploadBody as aO, type VenmoGoogleOAuthSellerCredentialUploadBody as aP, type VenmoCredentialUploadInput as aQ, type CashAppCredentialUploadInput as aR, type WiseCredentialUploadInput as aS, type SellerCredentialUploadInputByPlatform as aT, type SellerCiphertextBundle as aU, type SellerSignedCiphertextBundle as aV, type SellerVerifyIntentDetails as aW, type SellerVerifyInput as aX, type SellerProbeInput as aY, type SellerCredentialBundleUpload as aZ, type SellerCredentialStatusValue as a_, type GetPlatformQuote as aa, type PlatformQuote as ab, type QuoteRequest as ac, type GetNearbyQuote as ad, type GetNearbySuggestions as ae, type GetQuoteResponse as af, type GetQuoteResponseObject as ag, type GetQuoteSingleResponse as ah, type QuoteResponse as ai, type QuoteResponseObject as aj, type QuoteSingleResponse as ak, type QuoteIntentResponse as al, type QuoteFeesResponse as am, type FiatResponse as an, type TokenResponse as ao, type NearbyQuote as ap, type NearbySuggestions as aq, type ApiDeposit as ar, type DepositVerifier as as, type DepositVerifierCurrency as at, type DepositStatus as au, type GetDepositByIdRequest as av, type GetDepositByIdResponse as aw, type Intent as ax, type ApiIntentStatus as ay, type GetOwnerIntentsRequest as az, type AttestationServiceSellerVerifyResponse as b, type DepositDailySnapshotEntity$1 as b$, type SellerVerifyProxyBody as b0, type SellerTypedDataField as b1, type SellerTypedDataSpec as b2, type SellerPaymentTypedDataValue as b3, type SellerAttestationOutput as b4, type SellerCredentialProbeResponse as b5, type FulfillIntentAttestationResponse as b6, type AttestationServiceSellerCredentialProbeResponse as b7, type BuyerTeePaymentParams as b8, type BuyerTeePaymentProofInput as b9, type TakerTierSource as bA, type PlatformLimit as bB, type PlatformRiskLevel as bC, type OrderbookEntry as bD, IndexerClient as bE, defaultIndexerEndpoint as bF, IndexerDepositService as bG, IndexerRateManagerService as bH, compareEventCursorIdsByRecency as bI, fetchFulfillmentAndPayment as bJ, type DepositEntity$1 as bK, type IntentFulfilledEntity as bL, type IntentFulfillmentAmountsEntity as bM, type DepositPaymentMethodEntity$1 as bN, type MethodCurrencyEntity$1 as bO, type IntentStatus as bP, type RateManagerEntity as bQ, type RateManagerRateEntity as bR, type RateManagerDelegationEntity as bS, type ManagerAggregateStatsEntity as bT, type ManagerStatsEntity as bU, type ManagerDailySnapshotEntity as bV, type RateManagerListItem as bW, type RateManagerDetail as bX, type ManualRateUpdateEntity as bY, type OracleConfigUpdateEntity as bZ, type DepositFundActivityEntity$1 as b_, type BuyerTeeSessionMaterial as ba, type CuratorSellerCredentialStatusResponse as bb, type CuratorSellerVerifyResponse as bc, type RegisteredSellerCredentialPlatform as bd, type UploadSellerCredentialParams as be, type RegisteredUploadSellerCredentialParams as bf, type UploadSellerCredentialOptions as bg, type GetSellerCredentialStatusParams as bh, type UploadPayPalGoogleOAuthSellerCredentialParams as bi, type UploadVenmoGoogleOAuthSellerCredentialParams as bj, type UploadGoogleOAuthSellerCredentialParams as bk, type VerifySellerPaymentParams as bl, type IdentityAttestationActionType as bm, type IdentityAttestationOutput as bn, type IdentityAttestationOutputFor as bo, type IdentityAttestationParams as bp, type MakerIdentityAttestationRequestBody as bq, type MakerIdentityPlatform as br, type OnchainCurrency as bs, type DepositVerifierData as bt, type PreparedTransaction as bu, type OrderStats as bv, type DepositIntentStatistics as bw, type TakerTier as bx, type TakerTierVolumeBreakdown as by, type TakerTierStats as bz, type SellerCredentialUploadInput as c, type DepositFundActivityType$1 as c0, type DepositFilter as c1, type PaginationOptions as c2, type DepositOrderField as c3, type OrderDirection$1 as c4, type RateManagerFilter as c5, type RateManagerPaginationOptions as c6, type RateManagerDelegationPaginationOptions as c7, type RateManagerOrderField as c8, type OrderDirection as c9, type PV_Currency as cA, type PV_ReferralFee as cB, type PV_IntentView as cC, type PV_Intent as cD, ZERO_RATE_MANAGER_ID as cE, isZeroRateManagerId as cF, normalizeRateManagerId as cG, normalizeRegistry as cH, getDelegationRoute as cI, classifyDelegationState as cJ, type DelegationRoute as cK, type DelegationState as cL, type DelegationDepositTarget as cM, type BatchResult as cN, type SendTransactionFn as cO, type SendBatchFn as cP, ZERO_ADDRESS as cQ, asErrorMessage as cR, assertDelegationMethodSupport as cS, type DeploymentEnv as ca, type FulfillmentRecord as cb, type PaymentVerifiedRecord as cc, type FulfillmentAndPaymentResponse as cd, PAYMENT_PLATFORMS as ce, type PaymentPlatformType as cf, Currency as cg, currencyInfo as ch, getCurrencyInfoFromHash as ci, getCurrencyInfoFromCountryCode as cj, getCurrencyCodeFromHash as ck, isSupportedCurrencyHash as cl, mapConversionRatesToOnchainMinRate as cm, type CurrencyData as cn, getContracts as co, getRateManagerContracts as cp, getPaymentMethodsCatalog as cq, getGatingServiceAddress as cr, type RuntimeEnv as cs, parseDepositView as ct, parseIntentView as cu, enrichPvDepositView as cv, enrichPvIntentView as cw, type PV_DepositView as cx, type PV_Deposit as cy, type PV_PaymentMethodData as cz, type SellerCredentialUploadPlatform as d, type SellerCredentialAttestationRuntime as e, type AttestationServiceSellerCredentialUploadResponse as f, type BuyerTeeSessionMaterialEncryptionInput as g, type ApiAdapterOptions as h, type ReferralDashboardResponse as i, type ReferralEarningsResponse as j, type RedeemReferralCodeRequest as k, type RedeemReferralCodeResponse as l, type UpdateReferralCodeRequest as m, type UpdateReferralCodeResponse as n, type GoogleOAuthSellerCredentialUploadBodyByPlatform as o, type BestByPlatformResponse as p, type ValidatePayeeDetailsResponse as q, type PostDepositDetailsResponse as r, type GetPayeeDetailsRequest as s, type GetPayeeDetailsResponse as t, type GetOwnerDepositsRequest as u, type GetOwnerDepositsResponse as v, type GetTakerTierRequest as w, type GetTakerTierResponse as x, type GetDepositBundleParams as y, type GetDepositBundleResponse as z };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zkp2p/sdk",
-  "version": "0.6.2",
+  "version": "0.7.1",
   "description": "ZKP2P Client SDK - TypeScript SDK for deposit management, liquidity provision, and onramping",
   "license": "MIT",
   "main": "dist/index.cjs",

package/dist/chunk-6WAMIVRB.mjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/takerTiers.ts","../src/react/hooks/vaultUtils.ts"],"names":[],"mappings":"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","file":"chunk-6WAMIVRB.mjs","sourcesContent":["import type { TakerTierLevel } from './types';\n\n/**\n * Canonical taker tier schedule — the single client-side source of truth for\n * per-intent caps and volume thresholds. Mirrors the curator's authoritative\n * tier engine (curator `src/common/services/tier/tierConstants.ts`), which is\n * what the backend actually enforces.\n *\n * The signal is now **lifetime Peer-Pay-consumed maker volume**, not raw taker\n * fulfilled volume (curator PR #463 removed SAR weighting).\n *\n * A user's *live* tier, cap, and progression always come from the taker-tier\n * API payload (`TakerTier.perIntentCapBaseUnits`, `minVolumeForTier`,\n * `volumeToNextTier`, `peerPayVolume`). Those values are DB-backed and\n * server-authoritative — they vary per environment (e.g. preprod runs\n * different thresholds than these). This static schedule is ONLY a\n * documented-default reference for displays that must show every tier at once\n * (the Fees & Tiers ladder) when no live payload is available; never gate or\n * compute a user's real cap from it.\n *\n * Volume bands track the live (pre-prod) tuned qualification thresholds, which\n * were re-anchored to the real maker distribution — PEER $1k, PLUS $10k,\n * PRO $50k, PLATINUM $100k (the earlier $2.5k/$20k/$75k/$300k placeholders left\n * PLATINUM literally unreachable; the top band sits in the $99k–$167k gap so the\n * same 3 whales qualify, on a round number). Caps ($100/$250/$1k/$2.5k/$5k) are\n * unchanged.\n * Production still runs the old placeholder bands until the tuned config is\n * promoted, so even this reference can disagree with a given environment — read\n * the live per-user values from the API.\n *\n * Ordered highest tier → lowest (PLATINUM first) to match UI display order.\n * PEER_PRESIDENT is invite-only and excluded from the volume ladder.\n */\nexport interface TakerTierScheduleEntry {\n  tier: TakerTierLevel;\n  /** Per-intent order cap in whole USD (base, before platform risk multipliers). */\n  perIntentCapUsd: number;\n  /** Inclusive lower bound of lifetime Peer-Pay volume (USD) that qualifies for this tier. */\n  minVolumeUsd: number;\n  /** Inclusive upper bound of lifetime Peer-Pay volume (USD); `Infinity` for the top tier. */\n  maxVolumeUsd: number;\n}\n\nexport const TAKER_TIER_SCHEDULE: readonly TakerTierScheduleEntry[] = [\n  { tier: 'PLATINUM', perIntentCapUsd: 5000, minVolumeUsd: 100000, maxVolumeUsd: Infinity },\n  { tier: 'PRO', perIntentCapUsd: 2500, minVolumeUsd: 50000, maxVolumeUsd: 99999 },\n  { tier: 'PLUS', perIntentCapUsd: 1000, minVolumeUsd: 10000, maxVolumeUsd: 49999 },\n  { tier: 'PEER', perIntentCapUsd: 250, minVolumeUsd: 1000, maxVolumeUsd: 9999 },\n  { tier: 'PEASANT', perIntentCapUsd: 100, minVolumeUsd: 0, maxVolumeUsd: 999 },\n];\n\n/** Volume-based tier order, lowest → highest, for next-tier progression. */\nexport const TAKER_TIER_ORDER: readonly TakerTierLevel[] = [\n  'PEASANT',\n  'PEER',\n  'PLUS',\n  'PRO',\n  'PLATINUM',\n];\n\n/** Per-intent caps (whole USD) keyed by tier, derived from the schedule. */\nexport const TAKER_TIER_CAPS: Readonly<Record<string, number>> = Object.fromEntries(\n  TAKER_TIER_SCHEDULE.map((entry) => [entry.tier, entry.perIntentCapUsd]),\n);\n\n/**\n * Default take-fee discount (in basis points) applied per tier, mirroring\n * curator `TIER_FEE_DISCOUNT_BPS`. The discount is subtracted from the base\n * service fee server-side at quote and sign time — it is NOT returned by the\n * tier endpoint. These are documented defaults for reference fee displays only;\n * the curator DB control-plane can override them, so prefer the fee shown on a\n * live quote when one is available.\n */\nexport const TAKER_TIER_FEE_DISCOUNT_BPS: Readonly<Record<TakerTierLevel, number>> = {\n  PEASANT: 0,\n  PEER: 5,\n  PLUS: 10,\n  PRO: 20,\n  PLATINUM: 30,\n  PEER_PRESIDENT: 30,\n};\n\n/** The default fee-discount (bps) for a tier, or 0 for unknown tiers. */\nexport function getTakerTierFeeDiscountBps(tier: string | undefined): number {\n  if (!tier) return 0;\n  return TAKER_TIER_FEE_DISCOUNT_BPS[tier as TakerTierLevel] ?? 0;\n}\n\n/** The next tier up from `currentTier`, or `null` at the top / for unknown tiers. */\nexport function getNextTakerTier(currentTier: string | undefined): TakerTierLevel | null {\n  if (!currentTier) return null;\n  const index = TAKER_TIER_ORDER.indexOf(currentTier as TakerTierLevel);\n  if (index === -1 || index >= TAKER_TIER_ORDER.length - 1) return null;\n  return TAKER_TIER_ORDER[index + 1];\n}\n","import type { Address, Hex } from 'viem';\nimport type { PreparedTransaction } from '../../types/prepared';\n\n// ---------------------------------------------------------------------------\n// Constants\n// ---------------------------------------------------------------------------\n\nexport const ZERO_ADDRESS = '0x0000000000000000000000000000000000000000' as const;\nexport const ZERO_RATE_MANAGER_ID =\n  '0x0000000000000000000000000000000000000000000000000000000000000000' as const;\n\n// ---------------------------------------------------------------------------\n// Normalizers\n// ---------------------------------------------------------------------------\n\nexport const normalizeRateManagerId = (value?: string | null): string =>\n  (value ?? ZERO_RATE_MANAGER_ID).toLowerCase();\n\nexport const normalizeRegistry = (value?: string | null): string =>\n  (value ?? ZERO_ADDRESS).toLowerCase();\n\nexport const isZeroRateManagerId = (value?: string | null): boolean => {\n  if (!value) return true;\n  const normalized = value.toLowerCase();\n  return normalized === ZERO_ADDRESS || normalized === ZERO_RATE_MANAGER_ID;\n};\n\n// ---------------------------------------------------------------------------\n// Error helper\n// ---------------------------------------------------------------------------\n\nexport const asErrorMessage = (error: unknown): string => {\n  if (!error) return 'Unknown error';\n  if (error instanceof Error) return error.message;\n  if (typeof error === 'string') return error;\n\n  const anyErr = error as Record<string, unknown>;\n  if (typeof anyErr.shortMessage === 'string') return anyErr.shortMessage;\n  if (typeof anyErr.details === 'string') return anyErr.details;\n  if (typeof anyErr.message === 'string') return anyErr.message;\n\n  try {\n    return JSON.stringify(error);\n  } catch {\n    return String(error);\n  }\n};\n\n// ---------------------------------------------------------------------------\n// Delegation state classification\n// ---------------------------------------------------------------------------\n\nexport type DelegationState = 'delegated_here' | 'delegated_elsewhere' | 'not_delegated';\n\n/**\n * Classify whether a deposit is delegated to the target vault, delegated\n * elsewhere, or not delegated at all.\n *\n * @param currentRateManagerId    The deposit's current rateManagerId (from indexer)\n * @param currentRegistry         The deposit's current rateManagerAddress / registry (from indexer)\n * @param targetRateManagerId     The vault's rateManagerId we're comparing against\n * @param targetRegistry          The vault's registry address we're comparing against\n */\nexport const classifyDelegationState = (\n  currentRateManagerId: string | null | undefined,\n  currentRegistry: string | null | undefined,\n  targetRateManagerId: string,\n  targetRegistry: string | null | undefined,\n): DelegationState => {\n  if (isZeroRateManagerId(currentRateManagerId)) {\n    return 'not_delegated';\n  }\n\n  const normalizedCurrent = normalizeRateManagerId(currentRateManagerId);\n  const normalizedTarget = targetRateManagerId.toLowerCase();\n  const normalizedCurrentRegistry = normalizeRegistry(currentRegistry);\n  const normalizedTargetRegistry = targetRegistry ? targetRegistry.toLowerCase() : '';\n\n  const idsMatch = normalizedCurrent === normalizedTarget;\n  const registryMatches = normalizedTargetRegistry\n    ? normalizedCurrentRegistry === normalizedTargetRegistry\n    : true;\n\n  if (idsMatch && registryMatches) {\n    return 'delegated_here';\n  }\n\n  return 'delegated_elsewhere';\n};\n\nexport const assertAtomicDelegationSwitchSupport = (\n  requiresSwitch: boolean,\n  canBatch: boolean,\n): void => {\n  if (!requiresSwitch || canBatch) return;\n  throw new Error(\n    'Switching delegation targets requires smart-account batching. Clear the existing delegation first.',\n  );\n};\n\n// ---------------------------------------------------------------------------\n// Contract routing\n// ---------------------------------------------------------------------------\n\nexport type DelegationRoute = 'v2';\n\nexport const getDelegationRoute = (_client: unknown, _escrow: Address): DelegationRoute => 'v2';\n\ntype DelegationMethodSupportClient = Partial<\n  Record<'setRateManager' | 'clearRateManager', { prepare?: unknown }>\n>;\n\nexport const assertDelegationMethodSupport = (\n  client: DelegationMethodSupportClient,\n  _route: DelegationRoute,\n  action: 'set' | 'clear',\n): void => {\n  const method = action === 'set' ? 'setRateManager' : 'clearRateManager';\n  if (client?.[method]?.prepare) return;\n  throw new Error(`Delegation requires SDK ${method} support`);\n};\n\n// ---------------------------------------------------------------------------\n// Types\n// ---------------------------------------------------------------------------\n\nexport interface DelegationDepositTarget {\n  compositeDepositId: string;\n  escrow: Address;\n  depositId: bigint;\n  currentRateManagerId?: string | null;\n  currentRateManagerRegistry?: string | null;\n}\n\nexport interface BatchResult {\n  hashes: string[];\n  failed: Array<{ compositeDepositId: string; error: string }>;\n}\n\n/**\n * Callback the consumer provides for sending a single prepared transaction.\n * Returns the transaction hash.\n */\nexport type SendTransactionFn = (tx: { to: Address; data: Hex; value?: bigint }) => Promise<string>;\n\n/**\n * Optional callback for batching multiple calls in a single user operation\n * (e.g. via a smart account). If not provided, transactions are sent\n * sequentially via sendTransaction.\n */\nexport type SendBatchFn = (\n  txs: Array<{ to: Address; data: Hex; value?: bigint }>,\n) => Promise<string>;\n\n// ---------------------------------------------------------------------------\n// Prepare helpers (used internally by hooks)\n// ---------------------------------------------------------------------------\n\nexport const prepareClearDelegationTx = async (\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  client: any,\n  params: { escrow: Address; depositId: bigint },\n  referrer?: string | string[],\n): Promise<PreparedTransaction> => {\n  const route = getDelegationRoute(client, params.escrow);\n  assertDelegationMethodSupport(client, route, 'clear');\n  return client.clearRateManager.prepare({\n    escrowAddress: params.escrow,\n    depositId: params.depositId,\n    ...(referrer ? { txOverrides: { referrer } } : {}),\n  });\n};\n\nexport const prepareSetDelegationTx = async (\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  client: any,\n  params: {\n    escrow: Address;\n    depositId: bigint;\n    registry: Address;\n    rateManagerId: Hex;\n  },\n  referrer?: string | string[],\n): Promise<PreparedTransaction> => {\n  const route = getDelegationRoute(client, params.escrow);\n  assertDelegationMethodSupport(client, route, 'set');\n  return client.setRateManager.prepare({\n    escrowAddress: params.escrow,\n    depositId: params.depositId,\n    rateManagerAddress: params.registry,\n    rateManagerId: params.rateManagerId,\n    ...(referrer ? { txOverrides: { referrer } } : {}),\n  });\n};\n"]}