@zkp2p/sdk 0.6.3 → 0.7.1

package/dist/react.d.mts

@@ -1,5 +1,5 @@
-import { Z as Zkp2pClient, P as PostDepositDetailsRequest, E as SignalIntentMethodParams, bo as PreparedTransaction, br as TakerTier, p as GetTakerTierRequest, q as GetTakerTierResponse, F as FulfillIntentMethodParams, cI as SendTransactionFn, cJ as SendBatchFn, cG as DelegationDepositTarget, cH as BatchResult } from './vaultUtils-CcJn5Yh6.mjs';
-export { cE as DelegationRoute, cF as DelegationState, cK as VAULT_ZERO_ADDRESS, cy as ZERO_RATE_MANAGER_ID, cL as asErrorMessage, cM as assertDelegationMethodSupport, cD as classifyDelegationState, cC as getDelegationRoute, cz as isZeroRateManagerId, cA as normalizeRateManagerId, cB as normalizeRegistry } from './vaultUtils-CcJn5Yh6.mjs';
+import { Z as Zkp2pClient, P as PostDepositDetailsRequest, M as SignalIntentMethodParams, bu as PreparedTransaction, bx as TakerTier, w as GetTakerTierRequest, x as GetTakerTierResponse, N as FulfillIntentMethodParams, cO as SendTransactionFn, cP as SendBatchFn, cM as DelegationDepositTarget, cN as BatchResult } from './vaultUtils-DI-r1LAg.mjs';
+export { cK as DelegationRoute, cL as DelegationState, cQ as VAULT_ZERO_ADDRESS, cE as ZERO_RATE_MANAGER_ID, cR as asErrorMessage, cS as assertDelegationMethodSupport, cJ as classifyDelegationState, cI as getDelegationRoute, cF as isZeroRateManagerId, cG as normalizeRateManagerId, cH as normalizeRegistry } from './vaultUtils-DI-r1LAg.mjs';
 import { Hash, Address, Hex } from 'viem';
 import '@zkp2p/indexer-schema';
 import 'abitype';

package/dist/react.d.ts

@@ -1,5 +1,5 @@
-import { Z as Zkp2pClient, P as PostDepositDetailsRequest, E as SignalIntentMethodParams, bo as PreparedTransaction, br as TakerTier, p as GetTakerTierRequest, q as GetTakerTierResponse, F as FulfillIntentMethodParams, cI as SendTransactionFn, cJ as SendBatchFn, cG as DelegationDepositTarget, cH as BatchResult } from './vaultUtils-CcJn5Yh6.js';
-export { cE as DelegationRoute, cF as DelegationState, cK as VAULT_ZERO_ADDRESS, cy as ZERO_RATE_MANAGER_ID, cL as asErrorMessage, cM as assertDelegationMethodSupport, cD as classifyDelegationState, cC as getDelegationRoute, cz as isZeroRateManagerId, cA as normalizeRateManagerId, cB as normalizeRegistry } from './vaultUtils-CcJn5Yh6.js';
+import { Z as Zkp2pClient, P as PostDepositDetailsRequest, M as SignalIntentMethodParams, bu as PreparedTransaction, bx as TakerTier, w as GetTakerTierRequest, x as GetTakerTierResponse, N as FulfillIntentMethodParams, cO as SendTransactionFn, cP as SendBatchFn, cM as DelegationDepositTarget, cN as BatchResult } from './vaultUtils-DI-r1LAg.js';
+export { cK as DelegationRoute, cL as DelegationState, cQ as VAULT_ZERO_ADDRESS, cE as ZERO_RATE_MANAGER_ID, cR as asErrorMessage, cS as assertDelegationMethodSupport, cJ as classifyDelegationState, cI as getDelegationRoute, cF as isZeroRateManagerId, cG as normalizeRateManagerId, cH as normalizeRegistry } from './vaultUtils-DI-r1LAg.js';
 import { Hash, Address, Hex } from 'viem';
 import '@zkp2p/indexer-schema';
 import 'abitype';

package/dist/react.mjs

@@ -1,5 +1,5 @@
-import { getNextTakerTier, TAKER_TIER_CAPS, asErrorMessage, ZERO_ADDRESS, getDelegationRoute, assertDelegationMethodSupport, prepareClearDelegationTx, normalizeRateManagerId, normalizeRegistry, isZeroRateManagerId, assertAtomicDelegationSwitchSupport, prepareSetDelegationTx } from './chunk-WFDRBAV3.mjs';
-export { ZERO_ADDRESS as VAULT_ZERO_ADDRESS, ZERO_RATE_MANAGER_ID, asErrorMessage, assertDelegationMethodSupport, classifyDelegationState, getDelegationRoute, isZeroRateManagerId, normalizeRateManagerId, normalizeRegistry } from './chunk-WFDRBAV3.mjs';
+import { getNextTakerTier, TAKER_TIER_CAPS, asErrorMessage, ZERO_ADDRESS, getDelegationRoute, assertDelegationMethodSupport, prepareClearDelegationTx, normalizeRateManagerId, normalizeRegistry, isZeroRateManagerId, assertAtomicDelegationSwitchSupport, prepareSetDelegationTx } from './chunk-BQINCOSO.mjs';
+export { ZERO_ADDRESS as VAULT_ZERO_ADDRESS, ZERO_RATE_MANAGER_ID, asErrorMessage, assertDelegationMethodSupport, classifyDelegationState, getDelegationRoute, isZeroRateManagerId, normalizeRateManagerId, normalizeRegistry } from './chunk-BQINCOSO.mjs';
 import './chunk-J5LGTIGS.mjs';
 import { useState, useCallback, useMemo, useEffect } from 'react';
 import { formatUnits } from 'viem';

package/dist/{vaultUtils-CcJn5Yh6.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;
@@ -1912,23 +1947,24 @@ type TakerTier = {
     /** Base per-intent cap before platform risk multipliers (alias of perIntentCapBaseUnits). */
     maxOrderSize?: string;
     maxOrderSizeDisplay?: string;
-    /** Weighted 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 weighted maker volume to reach `nextTier`. */
+    /** Remaining Peer Pay volume to reach `nextTier`. */
     volumeToNextTier?: string | null;
     volumeToNextTierDisplay?: string | null;
     nextTierMaxOrderSize?: string | null;
     nextTierMaxOrderSizeDisplay?: string | null;
     /**
-     * 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.
+     * 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 per-platform weighted-volume inputs. Present on PR #478+ deployments. */
+    /** Auditable tier progression inputs. Current curator may return a synthetic Peer Pay row. */
     volumeBreakdown?: TakerTierVolumeBreakdown[];
 };
 type GetTakerTierRequest = {
@@ -2021,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;
@@ -2277,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?;
@@ -2303,6 +2341,7 @@ declare class Zkp2pClient {
     private parseRawDepositId;
     private stripTrailingSlash;
     private defaultAttestationServiceForBaseApiUrl;
+    private resolveAuthorizationToken;
     private normalizeOracleRateConfig;
     private escrowCurrencyHasOracleConfig;
     /**
@@ -3516,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
@@ -3733,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 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 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-CcJn5Yh6.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;
@@ -1912,23 +1947,24 @@ type TakerTier = {
     /** Base per-intent cap before platform risk multipliers (alias of perIntentCapBaseUnits). */
     maxOrderSize?: string;
     maxOrderSizeDisplay?: string;
-    /** Weighted 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 weighted maker volume to reach `nextTier`. */
+    /** Remaining Peer Pay volume to reach `nextTier`. */
     volumeToNextTier?: string | null;
     volumeToNextTierDisplay?: string | null;
     nextTierMaxOrderSize?: string | null;
     nextTierMaxOrderSizeDisplay?: string | null;
     /**
-     * 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.
+     * 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 per-platform weighted-volume inputs. Present on PR #478+ deployments. */
+    /** Auditable tier progression inputs. Current curator may return a synthetic Peer Pay row. */
     volumeBreakdown?: TakerTierVolumeBreakdown[];
 };
 type GetTakerTierRequest = {
@@ -2021,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;
@@ -2277,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?;
@@ -2303,6 +2341,7 @@ declare class Zkp2pClient {
     private parseRawDepositId;
     private stripTrailingSlash;
     private defaultAttestationServiceForBaseApiUrl;
+    private resolveAuthorizationToken;
     private normalizeOracleRateConfig;
     private escrowCurrencyHasOracleConfig;
     /**
@@ -3516,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
@@ -3733,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 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 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.3",
+  "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-WFDRBAV3.mjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/takerTiers.ts","../src/react/hooks/vaultUtils.ts"],"names":[],"mappings":"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","file":"chunk-WFDRBAV3.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 live qualification signal is **weighted all-maker volume**, not raw taker\n * fulfilled volume and no longer Peer-Pay-only. Curator keeps the response\n * field name `peerPayVolume` for compatibility, but PR #478 changed its\n * semantics to weighted maker volume.\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. Caps ($100/$250/$1k/$2.5k/$5k) are unchanged.\n * Read the live per-user values from the API: curator can change qualification\n * inputs behind the compatibility fields without changing this reference table.\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 weighted maker volume (USD) that qualifies for this tier. */\n  minVolumeUsd: number;\n  /** Inclusive upper bound of weighted maker 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"]}