@zkp2p/sdk 0.2.4 → 0.3.0

package/dist/index.d.mts

@@ -1,5 +1,5 @@
-import { R as ReferrerFeeConfig, D as DepositWithRelations, I as IntentEntity, V as ValidatePayeeDetailsRequest, a as ValidatePayeeDetailsResponse, P as PostDepositDetailsRequest, b as PostDepositDetailsResponse, G as GetPayeeDetailsRequest, c as GetPayeeDetailsResponse, d as GetOwnerDepositsRequest, e as GetOwnerDepositsResponse, f as GetTakerTierRequest, g as GetTakerTierResponse, C as CurrencyType, h as PaymentMethodCatalog, T as TxOverrides } from './vaultUtils-C2wT1ZYY.mjs';
-export { m as ActionCallback, O as ApiDeposit, a1 as ApiIntentStatus, A as AuthorizationTokenProvider, bt as BatchResult, j as CancelIntentMethodParams, t as CancelIntentParams, o as CreateDepositConversionRate, n as CreateDepositParams, aY as Currency, b3 as CurrencyData, bs as DelegationDepositTarget, bq as DelegationRoute, br as DelegationState, be as Deposit, bg as DepositCurrency, ae as DepositIntentStatistics, Y as DepositStatus, U as DepositVerifier, X as DepositVerifierCurrency, ab as DepositVerifierData, bd as DepositView, K as FiatResponse, F as FulfillIntentMethodParams, r as FulfillIntentParams, _ as GetDepositByIdRequest, $ as GetDepositByIdResponse, a6 as GetIntentByHashRequest, a7 as GetIntentByHashResponse, a4 as GetIntentsByDepositRequest, a5 as GetIntentsByDepositResponse, u as GetNearbyQuote, v as GetNearbySuggestions, a2 as GetOwnerIntentsRequest, a3 as GetOwnerIntentsResponse, w as GetQuoteResponse, x as GetQuoteResponseObject, y as GetQuoteSingleResponse, ak as IndexerClient, aS as IndexerDeploymentEnv, aq as IndexerDeposit, aH as IndexerDepositDailySnapshot, aJ as IndexerDepositFilter, aG as IndexerDepositFundActivity, aI as IndexerDepositFundActivityType, aM as IndexerDepositOrderDirection, aL as IndexerDepositOrderField, aK as IndexerDepositPagination, at as IndexerDepositPaymentMethod, am as IndexerDepositService, aV as IndexerFulfillmentAndPaymentResponse, aT as IndexerFulfillmentRecord, ar as IndexerIntentFulfilled, as as IndexerIntentFulfillmentAmounts, av as IndexerIntentStatus, az as IndexerManagerAggregateStats, aB as IndexerManagerDailySnapshot, aA as IndexerManagerStats, aE as IndexerManualRateUpdate, au as IndexerMethodCurrency, aF as IndexerOracleConfigUpdate, aU as IndexerPaymentVerifiedRecord, aw as IndexerRateManager, ay as IndexerRateManagerDelegation, aP as IndexerRateManagerDelegationPagination, aD as IndexerRateManagerDetail, aN as IndexerRateManagerFilter, aC as IndexerRateManagerListItem, aR as IndexerRateManagerOrderDirection, aQ as IndexerRateManagerOrderField, aO as IndexerRateManagerPagination, ax as IndexerRateManagerRate, an as IndexerRateManagerService, a0 as Intent, bi as IntentView, N as NearbyQuote, M as NearbySuggestions, Z as OfframpClient, aa as OnchainCurrency, bj as OnchainIntent, ad as OrderStats, aW as PAYMENT_PLATFORMS, bf as PaymentMethodData, aX as PaymentPlatformType, ai as PlatformLimit, aj as PlatformRiskLevel, ac as PreparedTransaction, J as QuoteFeesResponse, H as QuoteIntentResponse, Q as QuoteRequest, z as QuoteResponse, B as QuoteResponseObject, E as QuoteSingleResponse, p as Range, bh as ReferralFee, a8 as RegisterPayeeDetailsRequest, a9 as RegisterPayeeDetailsResponse, s as ReleaseFundsToPayerParams, b8 as RuntimeEnv, bv as SendBatchFn, bu as SendTransactionFn, i as SignalIntentMethodParams, q as SignalIntentParams, S as SignalIntentReferralFee, af as TakerTier, ah as TakerTierLevel, ag as TakerTierStats, l as TimeoutConfig, L as TokenResponse, W as WithdrawDepositParams, bk as ZERO_RATE_MANAGER_ID, Z as Zkp2pClient, k as Zkp2pClientOptions, bp as classifyDelegationState, ao as compareEventCursorIdsByRecency, aZ as currencyInfo, al as defaultIndexerEndpoint, bb as enrichPvDepositView, bc as enrichPvIntentView, ap as fetchIndexerFulfillmentAndPayment, b4 as getContracts, b0 as getCurrencyCodeFromHash, a$ as getCurrencyInfoFromCountryCode, a_ as getCurrencyInfoFromHash, bo as getDelegationRoute, b7 as getGatingServiceAddress, b6 as getPaymentMethodsCatalog, b5 as getRateManagerContracts, b1 as isSupportedCurrencyHash, bl as isZeroRateManagerId, b2 as mapConversionRatesToOnchainMinRate, bm as normalizeRateManagerId, bn as normalizeRegistry, b9 as parseDepositView, ba as parseIntentView } from './vaultUtils-C2wT1ZYY.mjs';
+import { R as ReferrerFeeConfig, D as DepositWithRelations, I as IntentEntity, Q as QuotesBestByPlatformRequest, B as BestByPlatformResponse, V as ValidatePayeeDetailsRequest, a as ValidatePayeeDetailsResponse, P as PostDepositDetailsRequest, b as PostDepositDetailsResponse, G as GetPayeeDetailsRequest, c as GetPayeeDetailsResponse, d as GetOwnerDepositsRequest, e as GetOwnerDepositsResponse, f as GetTakerTierRequest, g as GetTakerTierResponse, C as CurrencyType, h as PaymentMethodCatalog, T as TxOverrides } from './vaultUtils-sodi4Xx-.mjs';
+export { m as ActionCallback, a1 as ApiDeposit, a8 as ApiIntentStatus, A as AuthorizationTokenProvider, bA as BatchResult, u as BestByPlatformResponseObject, j as CancelIntentMethodParams, t as CancelIntentParams, o as CreateDepositConversionRate, n as CreateDepositParams, b3 as Currency, ba as CurrencyData, bz as DelegationDepositTarget, bx as DelegationRoute, by as DelegationState, bl as Deposit, bn as DepositCurrency, al as DepositIntentStatistics, a4 as DepositStatus, a2 as DepositVerifier, a3 as DepositVerifierCurrency, ai as DepositVerifierData, bk as DepositView, Y as FiatResponse, F as FulfillIntentMethodParams, r as FulfillIntentParams, v as GetBestByPlatformResponse, w as GetBestByPlatformResponseObject, a5 as GetDepositByIdRequest, a6 as GetDepositByIdResponse, ad as GetIntentByHashRequest, ae as GetIntentByHashResponse, ab as GetIntentsByDepositRequest, ac as GetIntentsByDepositResponse, E as GetNearbyQuote, H as GetNearbySuggestions, a9 as GetOwnerIntentsRequest, aa as GetOwnerIntentsResponse, x as GetPlatformQuote, J as GetQuoteResponse, K as GetQuoteResponseObject, L as GetQuoteSingleResponse, ar as IndexerClient, aZ as IndexerDeploymentEnv, ax as IndexerDeposit, aO as IndexerDepositDailySnapshot, aQ as IndexerDepositFilter, aN as IndexerDepositFundActivity, aP as IndexerDepositFundActivityType, aT as IndexerDepositOrderDirection, aS as IndexerDepositOrderField, aR as IndexerDepositPagination, aA as IndexerDepositPaymentMethod, at as IndexerDepositService, b0 as IndexerFulfillmentAndPaymentResponse, a_ as IndexerFulfillmentRecord, ay as IndexerIntentFulfilled, az as IndexerIntentFulfillmentAmounts, aC as IndexerIntentStatus, aG as IndexerManagerAggregateStats, aI as IndexerManagerDailySnapshot, aH as IndexerManagerStats, aL as IndexerManualRateUpdate, aB as IndexerMethodCurrency, aM as IndexerOracleConfigUpdate, a$ as IndexerPaymentVerifiedRecord, aD as IndexerRateManager, aF as IndexerRateManagerDelegation, aW as IndexerRateManagerDelegationPagination, aK as IndexerRateManagerDetail, aU as IndexerRateManagerFilter, aJ as IndexerRateManagerListItem, aY as IndexerRateManagerOrderDirection, aX as IndexerRateManagerOrderField, aV as IndexerRateManagerPagination, aE as IndexerRateManagerRate, au as IndexerRateManagerService, a7 as Intent, bp as IntentView, $ as NearbyQuote, a0 as NearbySuggestions, Z as OfframpClient, ah as OnchainCurrency, bq as OnchainIntent, ak as OrderStats, b1 as PAYMENT_PLATFORMS, bm as PaymentMethodData, b2 as PaymentPlatformType, ap as PlatformLimit, y as PlatformQuote, aq as PlatformRiskLevel, aj as PreparedTransaction, X as QuoteFeesResponse, U as QuoteIntentResponse, z as QuoteRequest, M as QuoteResponse, N as QuoteResponseObject, O as QuoteSingleResponse, p as Range, bo as ReferralFee, af as RegisterPayeeDetailsRequest, ag as RegisterPayeeDetailsResponse, s as ReleaseFundsToPayerParams, bf as RuntimeEnv, bC as SendBatchFn, bB as SendTransactionFn, i as SignalIntentMethodParams, q as SignalIntentParams, S as SignalIntentReferralFee, am as TakerTier, ao as TakerTierLevel, an as TakerTierStats, l as TimeoutConfig, _ as TokenResponse, W as WithdrawDepositParams, br as ZERO_RATE_MANAGER_ID, Z as Zkp2pClient, k as Zkp2pClientOptions, bw as classifyDelegationState, av as compareEventCursorIdsByRecency, b4 as currencyInfo, as as defaultIndexerEndpoint, bi as enrichPvDepositView, bj as enrichPvIntentView, aw as fetchIndexerFulfillmentAndPayment, bb as getContracts, b7 as getCurrencyCodeFromHash, b6 as getCurrencyInfoFromCountryCode, b5 as getCurrencyInfoFromHash, bv as getDelegationRoute, be as getGatingServiceAddress, bd as getPaymentMethodsCatalog, bc as getRateManagerContracts, b8 as isSupportedCurrencyHash, bs as isZeroRateManagerId, b9 as mapConversionRatesToOnchainMinRate, bt as normalizeRateManagerId, bu as normalizeRegistry, bg as parseDepositView, bh as parseIntentView } from './vaultUtils-sodi4Xx-.mjs';
 import { Address, Hex, WalletClient, Hash } from 'viem';
 import { Abi } from 'abitype';
 import '@zkp2p/indexer-schema';
@@ -65,7 +65,7 @@ interface EscrowIntentView {
 
 declare const isValidReferrerFeeRecipient: (value: string) => value is `0x${string}`;
 declare const isValidReferrerFeeBps: (value: number) => boolean;
-declare const assertValidReferrerFeeConfig: (config: ReferrerFeeConfig | undefined, context: "getQuote" | "signalIntent") => ReferrerFeeConfig | undefined;
+declare const assertValidReferrerFeeConfig: (config: ReferrerFeeConfig | undefined, context: "getQuote" | "getQuotesBestByPlatform" | "signalIntent") => ReferrerFeeConfig | undefined;
 declare const parseReferrerFeeConfig: (recipient: string | null | undefined, feeBpsValue: string | number | null | undefined) => ReferrerFeeConfig | null;
 declare const referrerFeeConfigToPreciseUnits: (config: ReferrerFeeConfig) => bigint;
 
@@ -192,10 +192,14 @@ declare const peerExtensionSdk: PeerExtensionSdk;
 
 declare function createCompositeDepositId(escrowAddress: string, depositId: string | bigint): string;
 declare function convertIndexerDepositToEscrowView(deposit: DepositWithRelations, _chainId: number, _escrowAddress: string): EscrowDepositView;
-declare function convertDepositsForLiquidity(deposits: DepositWithRelations[], chainId: number, escrowAddress: string): EscrowDepositView[];
+interface ConvertLiquidityOptions {
+    includePrivateOrderbooks?: boolean;
+}
+declare function convertDepositsForLiquidity(deposits: DepositWithRelations[], chainId: number, escrowAddress: string, options?: ConvertLiquidityOptions): EscrowDepositView[];
 declare function convertIndexerIntentsToEscrowViews(intents: IntentEntity[], depositViewsById: Map<string, EscrowDepositView>): EscrowIntentView[];
 
-declare function apiPostDepositDetails(req: PostDepositDetailsRequest, baseApiUrl: string, timeoutMs?: number, apiKey?: string, authToken?: string): Promise<PostDepositDetailsResponse>;
+declare function apiPostDepositDetails(req: PostDepositDetailsRequest, baseApiUrl: string, timeoutMs?: number, _apiKey?: string, _authToken?: string): Promise<PostDepositDetailsResponse>;
+declare function apiGetQuotesBestByPlatform(req: QuotesBestByPlatformRequest, baseApiUrl: string, timeoutMs?: number, apiKey?: string, authToken?: string): Promise<BestByPlatformResponse>;
 declare function apiGetPayeeDetails(req: GetPayeeDetailsRequest, apiKey: string | undefined, baseApiUrl: string, authToken?: string, timeoutMs?: number): Promise<GetPayeeDetailsResponse>;
 declare function apiValidatePayeeDetails(req: ValidatePayeeDetailsRequest, baseApiUrl: string, timeoutMs?: number): Promise<ValidatePayeeDetailsResponse>;
 declare function apiGetOwnerDeposits(req: GetOwnerDepositsRequest, apiKey: string | undefined, baseApiUrl: string, authToken?: string, timeoutMs?: number): Promise<GetOwnerDepositsResponse>;
@@ -701,4 +705,4 @@ declare class ContractError extends ZKP2PError {
     constructor(message: string, details?: unknown);
 }
 
-export { APIError, BASE_BUILDER_CODE, CHAINLINK_ORACLE_ADAPTER, CHAINLINK_ORACLE_FEEDS, ContractError, ContractRouter, type ContractRouterConfig, CurrencyType, DEFAULT_ORACLE_MAX_STALENESS_SECONDS, ErrorCode, type EscrowContractContext, type EscrowDepositView, type EscrowIntentView, GetOwnerDepositsRequest, GetOwnerDepositsResponse, GetPayeeDetailsRequest, GetPayeeDetailsResponse, GetTakerTierRequest, GetTakerTierResponse, DepositWithRelations as IndexerDepositWithRelations, IntentEntity as IndexerIntent, type LogLevel, type MulticallClient, NetworkError, type OracleAdapterOverrides, type OracleKind, type OrchestratorContractContext, PEER_EXTENSION_CHROME_URL, PLATFORM_METADATA, PYTH_CONTRACT_BASE, PYTH_ORACLE_ADAPTER, PYTH_ORACLE_FEEDS, PaymentMethodCatalog, type PeerConnectionStatus, type PeerExtensionApi, type PeerExtensionOnrampParams, type PeerExtensionSdk, type PeerExtensionSdkOptions, type PeerExtensionState, type PeerExtensionWindow, type PeerIntentFulfilledBridgeStatus, type PeerIntentFulfilledCallback, type PeerIntentFulfilledResult, PostDepositDetailsRequest, PostDepositDetailsResponse, type PythFeedConfig, ReferrerFeeConfig, SPREAD_ORACLE_FEEDS, SUPPORTED_CHAIN_IDS, type SpreadOracleConfig, type SpreadOracleFeedConfig, type SupportedChainId, TOKEN_METADATA, TxOverrides, ValidatePayeeDetailsRequest, ValidatePayeeDetailsResponse, ValidationError, ZKP2PError, ZKP2P_ANDROID_REFERRER, ZKP2P_IOS_REFERRER, apiGetOwnerDeposits, apiGetPayeeDetails, apiGetTakerTier, apiPostDepositDetails, apiValidatePayeeDetails, appendAttributionToCalldata, asciiToBytes32, assertValidReferrerFeeConfig, convertDepositsForLiquidity, convertIndexerDepositToEscrowView, convertIndexerIntentsToEscrowViews, createCompositeDepositId, createPeerExtensionSdk, encodePythAdapterConfig, encodeSpreadOracleAdapterConfig, encodeWithAttribution, ensureBytes32, getAttributionDataSuffix, getPeerExtensionState, getSpreadOracleConfig, isPeerExtensionAvailable, isValidReferrerFeeBps, isValidReferrerFeeRecipient, logger, openPeerExtensionInstallPage, parseReferrerFeeConfig, peerExtensionSdk, referrerFeeConfigToPreciseUnits, resolveFiatCurrencyBytes32, resolvePaymentMethodHash, resolvePaymentMethodHashFromCatalog, resolvePaymentMethodNameFromHash, sendTransactionWithAttribution, setLogLevel, validateOracleFeedsOnChain };
+export { APIError, BASE_BUILDER_CODE, BestByPlatformResponse, CHAINLINK_ORACLE_ADAPTER, CHAINLINK_ORACLE_FEEDS, ContractError, ContractRouter, type ContractRouterConfig, CurrencyType, DEFAULT_ORACLE_MAX_STALENESS_SECONDS, ErrorCode, type EscrowContractContext, type EscrowDepositView, type EscrowIntentView, GetOwnerDepositsRequest, GetOwnerDepositsResponse, GetPayeeDetailsRequest, GetPayeeDetailsResponse, GetTakerTierRequest, GetTakerTierResponse, DepositWithRelations as IndexerDepositWithRelations, IntentEntity as IndexerIntent, type LogLevel, type MulticallClient, NetworkError, type OracleAdapterOverrides, type OracleKind, type OrchestratorContractContext, PEER_EXTENSION_CHROME_URL, PLATFORM_METADATA, PYTH_CONTRACT_BASE, PYTH_ORACLE_ADAPTER, PYTH_ORACLE_FEEDS, PaymentMethodCatalog, type PeerConnectionStatus, type PeerExtensionApi, type PeerExtensionOnrampParams, type PeerExtensionSdk, type PeerExtensionSdkOptions, type PeerExtensionState, type PeerExtensionWindow, type PeerIntentFulfilledBridgeStatus, type PeerIntentFulfilledCallback, type PeerIntentFulfilledResult, PostDepositDetailsRequest, PostDepositDetailsResponse, type PythFeedConfig, QuotesBestByPlatformRequest, ReferrerFeeConfig, SPREAD_ORACLE_FEEDS, SUPPORTED_CHAIN_IDS, type SpreadOracleConfig, type SpreadOracleFeedConfig, type SupportedChainId, TOKEN_METADATA, TxOverrides, ValidatePayeeDetailsRequest, ValidatePayeeDetailsResponse, ValidationError, ZKP2PError, ZKP2P_ANDROID_REFERRER, ZKP2P_IOS_REFERRER, apiGetOwnerDeposits, apiGetPayeeDetails, apiGetQuotesBestByPlatform, apiGetTakerTier, apiPostDepositDetails, apiValidatePayeeDetails, appendAttributionToCalldata, asciiToBytes32, assertValidReferrerFeeConfig, convertDepositsForLiquidity, convertIndexerDepositToEscrowView, convertIndexerIntentsToEscrowViews, createCompositeDepositId, createPeerExtensionSdk, encodePythAdapterConfig, encodeSpreadOracleAdapterConfig, encodeWithAttribution, ensureBytes32, getAttributionDataSuffix, getPeerExtensionState, getSpreadOracleConfig, isPeerExtensionAvailable, isValidReferrerFeeBps, isValidReferrerFeeRecipient, logger, openPeerExtensionInstallPage, parseReferrerFeeConfig, peerExtensionSdk, referrerFeeConfigToPreciseUnits, resolveFiatCurrencyBytes32, resolvePaymentMethodHash, resolvePaymentMethodHashFromCatalog, resolvePaymentMethodNameFromHash, sendTransactionWithAttribution, setLogLevel, validateOracleFeedsOnChain };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { R as ReferrerFeeConfig, D as DepositWithRelations, I as IntentEntity, V as ValidatePayeeDetailsRequest, a as ValidatePayeeDetailsResponse, P as PostDepositDetailsRequest, b as PostDepositDetailsResponse, G as GetPayeeDetailsRequest, c as GetPayeeDetailsResponse, d as GetOwnerDepositsRequest, e as GetOwnerDepositsResponse, f as GetTakerTierRequest, g as GetTakerTierResponse, C as CurrencyType, h as PaymentMethodCatalog, T as TxOverrides } from './vaultUtils-C2wT1ZYY.js';
-export { m as ActionCallback, O as ApiDeposit, a1 as ApiIntentStatus, A as AuthorizationTokenProvider, bt as BatchResult, j as CancelIntentMethodParams, t as CancelIntentParams, o as CreateDepositConversionRate, n as CreateDepositParams, aY as Currency, b3 as CurrencyData, bs as DelegationDepositTarget, bq as DelegationRoute, br as DelegationState, be as Deposit, bg as DepositCurrency, ae as DepositIntentStatistics, Y as DepositStatus, U as DepositVerifier, X as DepositVerifierCurrency, ab as DepositVerifierData, bd as DepositView, K as FiatResponse, F as FulfillIntentMethodParams, r as FulfillIntentParams, _ as GetDepositByIdRequest, $ as GetDepositByIdResponse, a6 as GetIntentByHashRequest, a7 as GetIntentByHashResponse, a4 as GetIntentsByDepositRequest, a5 as GetIntentsByDepositResponse, u as GetNearbyQuote, v as GetNearbySuggestions, a2 as GetOwnerIntentsRequest, a3 as GetOwnerIntentsResponse, w as GetQuoteResponse, x as GetQuoteResponseObject, y as GetQuoteSingleResponse, ak as IndexerClient, aS as IndexerDeploymentEnv, aq as IndexerDeposit, aH as IndexerDepositDailySnapshot, aJ as IndexerDepositFilter, aG as IndexerDepositFundActivity, aI as IndexerDepositFundActivityType, aM as IndexerDepositOrderDirection, aL as IndexerDepositOrderField, aK as IndexerDepositPagination, at as IndexerDepositPaymentMethod, am as IndexerDepositService, aV as IndexerFulfillmentAndPaymentResponse, aT as IndexerFulfillmentRecord, ar as IndexerIntentFulfilled, as as IndexerIntentFulfillmentAmounts, av as IndexerIntentStatus, az as IndexerManagerAggregateStats, aB as IndexerManagerDailySnapshot, aA as IndexerManagerStats, aE as IndexerManualRateUpdate, au as IndexerMethodCurrency, aF as IndexerOracleConfigUpdate, aU as IndexerPaymentVerifiedRecord, aw as IndexerRateManager, ay as IndexerRateManagerDelegation, aP as IndexerRateManagerDelegationPagination, aD as IndexerRateManagerDetail, aN as IndexerRateManagerFilter, aC as IndexerRateManagerListItem, aR as IndexerRateManagerOrderDirection, aQ as IndexerRateManagerOrderField, aO as IndexerRateManagerPagination, ax as IndexerRateManagerRate, an as IndexerRateManagerService, a0 as Intent, bi as IntentView, N as NearbyQuote, M as NearbySuggestions, Z as OfframpClient, aa as OnchainCurrency, bj as OnchainIntent, ad as OrderStats, aW as PAYMENT_PLATFORMS, bf as PaymentMethodData, aX as PaymentPlatformType, ai as PlatformLimit, aj as PlatformRiskLevel, ac as PreparedTransaction, J as QuoteFeesResponse, H as QuoteIntentResponse, Q as QuoteRequest, z as QuoteResponse, B as QuoteResponseObject, E as QuoteSingleResponse, p as Range, bh as ReferralFee, a8 as RegisterPayeeDetailsRequest, a9 as RegisterPayeeDetailsResponse, s as ReleaseFundsToPayerParams, b8 as RuntimeEnv, bv as SendBatchFn, bu as SendTransactionFn, i as SignalIntentMethodParams, q as SignalIntentParams, S as SignalIntentReferralFee, af as TakerTier, ah as TakerTierLevel, ag as TakerTierStats, l as TimeoutConfig, L as TokenResponse, W as WithdrawDepositParams, bk as ZERO_RATE_MANAGER_ID, Z as Zkp2pClient, k as Zkp2pClientOptions, bp as classifyDelegationState, ao as compareEventCursorIdsByRecency, aZ as currencyInfo, al as defaultIndexerEndpoint, bb as enrichPvDepositView, bc as enrichPvIntentView, ap as fetchIndexerFulfillmentAndPayment, b4 as getContracts, b0 as getCurrencyCodeFromHash, a$ as getCurrencyInfoFromCountryCode, a_ as getCurrencyInfoFromHash, bo as getDelegationRoute, b7 as getGatingServiceAddress, b6 as getPaymentMethodsCatalog, b5 as getRateManagerContracts, b1 as isSupportedCurrencyHash, bl as isZeroRateManagerId, b2 as mapConversionRatesToOnchainMinRate, bm as normalizeRateManagerId, bn as normalizeRegistry, b9 as parseDepositView, ba as parseIntentView } from './vaultUtils-C2wT1ZYY.js';
+import { R as ReferrerFeeConfig, D as DepositWithRelations, I as IntentEntity, Q as QuotesBestByPlatformRequest, B as BestByPlatformResponse, V as ValidatePayeeDetailsRequest, a as ValidatePayeeDetailsResponse, P as PostDepositDetailsRequest, b as PostDepositDetailsResponse, G as GetPayeeDetailsRequest, c as GetPayeeDetailsResponse, d as GetOwnerDepositsRequest, e as GetOwnerDepositsResponse, f as GetTakerTierRequest, g as GetTakerTierResponse, C as CurrencyType, h as PaymentMethodCatalog, T as TxOverrides } from './vaultUtils-sodi4Xx-.js';
+export { m as ActionCallback, a1 as ApiDeposit, a8 as ApiIntentStatus, A as AuthorizationTokenProvider, bA as BatchResult, u as BestByPlatformResponseObject, j as CancelIntentMethodParams, t as CancelIntentParams, o as CreateDepositConversionRate, n as CreateDepositParams, b3 as Currency, ba as CurrencyData, bz as DelegationDepositTarget, bx as DelegationRoute, by as DelegationState, bl as Deposit, bn as DepositCurrency, al as DepositIntentStatistics, a4 as DepositStatus, a2 as DepositVerifier, a3 as DepositVerifierCurrency, ai as DepositVerifierData, bk as DepositView, Y as FiatResponse, F as FulfillIntentMethodParams, r as FulfillIntentParams, v as GetBestByPlatformResponse, w as GetBestByPlatformResponseObject, a5 as GetDepositByIdRequest, a6 as GetDepositByIdResponse, ad as GetIntentByHashRequest, ae as GetIntentByHashResponse, ab as GetIntentsByDepositRequest, ac as GetIntentsByDepositResponse, E as GetNearbyQuote, H as GetNearbySuggestions, a9 as GetOwnerIntentsRequest, aa as GetOwnerIntentsResponse, x as GetPlatformQuote, J as GetQuoteResponse, K as GetQuoteResponseObject, L as GetQuoteSingleResponse, ar as IndexerClient, aZ as IndexerDeploymentEnv, ax as IndexerDeposit, aO as IndexerDepositDailySnapshot, aQ as IndexerDepositFilter, aN as IndexerDepositFundActivity, aP as IndexerDepositFundActivityType, aT as IndexerDepositOrderDirection, aS as IndexerDepositOrderField, aR as IndexerDepositPagination, aA as IndexerDepositPaymentMethod, at as IndexerDepositService, b0 as IndexerFulfillmentAndPaymentResponse, a_ as IndexerFulfillmentRecord, ay as IndexerIntentFulfilled, az as IndexerIntentFulfillmentAmounts, aC as IndexerIntentStatus, aG as IndexerManagerAggregateStats, aI as IndexerManagerDailySnapshot, aH as IndexerManagerStats, aL as IndexerManualRateUpdate, aB as IndexerMethodCurrency, aM as IndexerOracleConfigUpdate, a$ as IndexerPaymentVerifiedRecord, aD as IndexerRateManager, aF as IndexerRateManagerDelegation, aW as IndexerRateManagerDelegationPagination, aK as IndexerRateManagerDetail, aU as IndexerRateManagerFilter, aJ as IndexerRateManagerListItem, aY as IndexerRateManagerOrderDirection, aX as IndexerRateManagerOrderField, aV as IndexerRateManagerPagination, aE as IndexerRateManagerRate, au as IndexerRateManagerService, a7 as Intent, bp as IntentView, $ as NearbyQuote, a0 as NearbySuggestions, Z as OfframpClient, ah as OnchainCurrency, bq as OnchainIntent, ak as OrderStats, b1 as PAYMENT_PLATFORMS, bm as PaymentMethodData, b2 as PaymentPlatformType, ap as PlatformLimit, y as PlatformQuote, aq as PlatformRiskLevel, aj as PreparedTransaction, X as QuoteFeesResponse, U as QuoteIntentResponse, z as QuoteRequest, M as QuoteResponse, N as QuoteResponseObject, O as QuoteSingleResponse, p as Range, bo as ReferralFee, af as RegisterPayeeDetailsRequest, ag as RegisterPayeeDetailsResponse, s as ReleaseFundsToPayerParams, bf as RuntimeEnv, bC as SendBatchFn, bB as SendTransactionFn, i as SignalIntentMethodParams, q as SignalIntentParams, S as SignalIntentReferralFee, am as TakerTier, ao as TakerTierLevel, an as TakerTierStats, l as TimeoutConfig, _ as TokenResponse, W as WithdrawDepositParams, br as ZERO_RATE_MANAGER_ID, Z as Zkp2pClient, k as Zkp2pClientOptions, bw as classifyDelegationState, av as compareEventCursorIdsByRecency, b4 as currencyInfo, as as defaultIndexerEndpoint, bi as enrichPvDepositView, bj as enrichPvIntentView, aw as fetchIndexerFulfillmentAndPayment, bb as getContracts, b7 as getCurrencyCodeFromHash, b6 as getCurrencyInfoFromCountryCode, b5 as getCurrencyInfoFromHash, bv as getDelegationRoute, be as getGatingServiceAddress, bd as getPaymentMethodsCatalog, bc as getRateManagerContracts, b8 as isSupportedCurrencyHash, bs as isZeroRateManagerId, b9 as mapConversionRatesToOnchainMinRate, bt as normalizeRateManagerId, bu as normalizeRegistry, bg as parseDepositView, bh as parseIntentView } from './vaultUtils-sodi4Xx-.js';
 import { Address, Hex, WalletClient, Hash } from 'viem';
 import { Abi } from 'abitype';
 import '@zkp2p/indexer-schema';
@@ -65,7 +65,7 @@ interface EscrowIntentView {
 
 declare const isValidReferrerFeeRecipient: (value: string) => value is `0x${string}`;
 declare const isValidReferrerFeeBps: (value: number) => boolean;
-declare const assertValidReferrerFeeConfig: (config: ReferrerFeeConfig | undefined, context: "getQuote" | "signalIntent") => ReferrerFeeConfig | undefined;
+declare const assertValidReferrerFeeConfig: (config: ReferrerFeeConfig | undefined, context: "getQuote" | "getQuotesBestByPlatform" | "signalIntent") => ReferrerFeeConfig | undefined;
 declare const parseReferrerFeeConfig: (recipient: string | null | undefined, feeBpsValue: string | number | null | undefined) => ReferrerFeeConfig | null;
 declare const referrerFeeConfigToPreciseUnits: (config: ReferrerFeeConfig) => bigint;
 
@@ -192,10 +192,14 @@ declare const peerExtensionSdk: PeerExtensionSdk;
 
 declare function createCompositeDepositId(escrowAddress: string, depositId: string | bigint): string;
 declare function convertIndexerDepositToEscrowView(deposit: DepositWithRelations, _chainId: number, _escrowAddress: string): EscrowDepositView;
-declare function convertDepositsForLiquidity(deposits: DepositWithRelations[], chainId: number, escrowAddress: string): EscrowDepositView[];
+interface ConvertLiquidityOptions {
+    includePrivateOrderbooks?: boolean;
+}
+declare function convertDepositsForLiquidity(deposits: DepositWithRelations[], chainId: number, escrowAddress: string, options?: ConvertLiquidityOptions): EscrowDepositView[];
 declare function convertIndexerIntentsToEscrowViews(intents: IntentEntity[], depositViewsById: Map<string, EscrowDepositView>): EscrowIntentView[];
 
-declare function apiPostDepositDetails(req: PostDepositDetailsRequest, baseApiUrl: string, timeoutMs?: number, apiKey?: string, authToken?: string): Promise<PostDepositDetailsResponse>;
+declare function apiPostDepositDetails(req: PostDepositDetailsRequest, baseApiUrl: string, timeoutMs?: number, _apiKey?: string, _authToken?: string): Promise<PostDepositDetailsResponse>;
+declare function apiGetQuotesBestByPlatform(req: QuotesBestByPlatformRequest, baseApiUrl: string, timeoutMs?: number, apiKey?: string, authToken?: string): Promise<BestByPlatformResponse>;
 declare function apiGetPayeeDetails(req: GetPayeeDetailsRequest, apiKey: string | undefined, baseApiUrl: string, authToken?: string, timeoutMs?: number): Promise<GetPayeeDetailsResponse>;
 declare function apiValidatePayeeDetails(req: ValidatePayeeDetailsRequest, baseApiUrl: string, timeoutMs?: number): Promise<ValidatePayeeDetailsResponse>;
 declare function apiGetOwnerDeposits(req: GetOwnerDepositsRequest, apiKey: string | undefined, baseApiUrl: string, authToken?: string, timeoutMs?: number): Promise<GetOwnerDepositsResponse>;
@@ -701,4 +705,4 @@ declare class ContractError extends ZKP2PError {
     constructor(message: string, details?: unknown);
 }
 
-export { APIError, BASE_BUILDER_CODE, CHAINLINK_ORACLE_ADAPTER, CHAINLINK_ORACLE_FEEDS, ContractError, ContractRouter, type ContractRouterConfig, CurrencyType, DEFAULT_ORACLE_MAX_STALENESS_SECONDS, ErrorCode, type EscrowContractContext, type EscrowDepositView, type EscrowIntentView, GetOwnerDepositsRequest, GetOwnerDepositsResponse, GetPayeeDetailsRequest, GetPayeeDetailsResponse, GetTakerTierRequest, GetTakerTierResponse, DepositWithRelations as IndexerDepositWithRelations, IntentEntity as IndexerIntent, type LogLevel, type MulticallClient, NetworkError, type OracleAdapterOverrides, type OracleKind, type OrchestratorContractContext, PEER_EXTENSION_CHROME_URL, PLATFORM_METADATA, PYTH_CONTRACT_BASE, PYTH_ORACLE_ADAPTER, PYTH_ORACLE_FEEDS, PaymentMethodCatalog, type PeerConnectionStatus, type PeerExtensionApi, type PeerExtensionOnrampParams, type PeerExtensionSdk, type PeerExtensionSdkOptions, type PeerExtensionState, type PeerExtensionWindow, type PeerIntentFulfilledBridgeStatus, type PeerIntentFulfilledCallback, type PeerIntentFulfilledResult, PostDepositDetailsRequest, PostDepositDetailsResponse, type PythFeedConfig, ReferrerFeeConfig, SPREAD_ORACLE_FEEDS, SUPPORTED_CHAIN_IDS, type SpreadOracleConfig, type SpreadOracleFeedConfig, type SupportedChainId, TOKEN_METADATA, TxOverrides, ValidatePayeeDetailsRequest, ValidatePayeeDetailsResponse, ValidationError, ZKP2PError, ZKP2P_ANDROID_REFERRER, ZKP2P_IOS_REFERRER, apiGetOwnerDeposits, apiGetPayeeDetails, apiGetTakerTier, apiPostDepositDetails, apiValidatePayeeDetails, appendAttributionToCalldata, asciiToBytes32, assertValidReferrerFeeConfig, convertDepositsForLiquidity, convertIndexerDepositToEscrowView, convertIndexerIntentsToEscrowViews, createCompositeDepositId, createPeerExtensionSdk, encodePythAdapterConfig, encodeSpreadOracleAdapterConfig, encodeWithAttribution, ensureBytes32, getAttributionDataSuffix, getPeerExtensionState, getSpreadOracleConfig, isPeerExtensionAvailable, isValidReferrerFeeBps, isValidReferrerFeeRecipient, logger, openPeerExtensionInstallPage, parseReferrerFeeConfig, peerExtensionSdk, referrerFeeConfigToPreciseUnits, resolveFiatCurrencyBytes32, resolvePaymentMethodHash, resolvePaymentMethodHashFromCatalog, resolvePaymentMethodNameFromHash, sendTransactionWithAttribution, setLogLevel, validateOracleFeedsOnChain };
+export { APIError, BASE_BUILDER_CODE, BestByPlatformResponse, CHAINLINK_ORACLE_ADAPTER, CHAINLINK_ORACLE_FEEDS, ContractError, ContractRouter, type ContractRouterConfig, CurrencyType, DEFAULT_ORACLE_MAX_STALENESS_SECONDS, ErrorCode, type EscrowContractContext, type EscrowDepositView, type EscrowIntentView, GetOwnerDepositsRequest, GetOwnerDepositsResponse, GetPayeeDetailsRequest, GetPayeeDetailsResponse, GetTakerTierRequest, GetTakerTierResponse, DepositWithRelations as IndexerDepositWithRelations, IntentEntity as IndexerIntent, type LogLevel, type MulticallClient, NetworkError, type OracleAdapterOverrides, type OracleKind, type OrchestratorContractContext, PEER_EXTENSION_CHROME_URL, PLATFORM_METADATA, PYTH_CONTRACT_BASE, PYTH_ORACLE_ADAPTER, PYTH_ORACLE_FEEDS, PaymentMethodCatalog, type PeerConnectionStatus, type PeerExtensionApi, type PeerExtensionOnrampParams, type PeerExtensionSdk, type PeerExtensionSdkOptions, type PeerExtensionState, type PeerExtensionWindow, type PeerIntentFulfilledBridgeStatus, type PeerIntentFulfilledCallback, type PeerIntentFulfilledResult, PostDepositDetailsRequest, PostDepositDetailsResponse, type PythFeedConfig, QuotesBestByPlatformRequest, ReferrerFeeConfig, SPREAD_ORACLE_FEEDS, SUPPORTED_CHAIN_IDS, type SpreadOracleConfig, type SpreadOracleFeedConfig, type SupportedChainId, TOKEN_METADATA, TxOverrides, ValidatePayeeDetailsRequest, ValidatePayeeDetailsResponse, ValidationError, ZKP2PError, ZKP2P_ANDROID_REFERRER, ZKP2P_IOS_REFERRER, apiGetOwnerDeposits, apiGetPayeeDetails, apiGetQuotesBestByPlatform, apiGetTakerTier, apiPostDepositDetails, apiValidatePayeeDetails, appendAttributionToCalldata, asciiToBytes32, assertValidReferrerFeeConfig, convertDepositsForLiquidity, convertIndexerDepositToEscrowView, convertIndexerIntentsToEscrowViews, createCompositeDepositId, createPeerExtensionSdk, encodePythAdapterConfig, encodeSpreadOracleAdapterConfig, encodeWithAttribution, ensureBytes32, getAttributionDataSuffix, getPeerExtensionState, getSpreadOracleConfig, isPeerExtensionAvailable, isValidReferrerFeeBps, isValidReferrerFeeRecipient, logger, openPeerExtensionInstallPage, parseReferrerFeeConfig, peerExtensionSdk, referrerFeeConfigToPreciseUnits, resolveFiatCurrencyBytes32, resolvePaymentMethodHash, resolvePaymentMethodHashFromCatalog, resolvePaymentMethodNameFromHash, sendTransactionWithAttribution, setLogLevel, validateOracleFeedsOnChain };

package/dist/index.mjs

@@ -11,16 +11,8 @@ import { AbiCoder } from 'ethers';
 import { Attribution } from 'ox/erc8021';
 import chainlinkFeeds from '@zkp2p/contracts-v2/oracleFeeds/chainlink.json';
 
-// src/client/clientUtils.ts
+// src/utils/address.ts
 var ZERO_ADDRESS = "0x0000000000000000000000000000000000000000";
-var MIN_ORACLE_SPREAD_BPS = -32768;
-var MAX_ORACLE_SPREAD_BPS = 32767;
-var EMPTY_ORACLE_RATE_CONFIG = {
-  adapter: ZERO_ADDRESS,
-  adapterConfig: "0x",
-  spreadBps: 0,
-  maxStaleness: 0
-};
 var isValidHexAddress = (addr) => {
   if (typeof addr !== "string") return false;
   return /^0x[0-9a-fA-F]{40}$/.test(addr);
@@ -29,6 +21,16 @@ var normalizeAddress = (addr) => {
   if (!isValidHexAddress(addr)) return void 0;
   return addr;
 };
+
+// src/client/clientUtils.ts
+var MIN_ORACLE_SPREAD_BPS = -32768;
+var MAX_ORACLE_SPREAD_BPS = 32767;
+var EMPTY_ORACLE_RATE_CONFIG = {
+  adapter: ZERO_ADDRESS,
+  adapterConfig: "0x",
+  spreadBps: 0,
+  maxStaleness: 0
+};
 var parseEscrowAddressFromCompositeDepositId = (depositId) => {
   if (typeof depositId !== "string") return void 0;
   const parts = depositId.split("_");
@@ -331,9 +333,6 @@ function parseAPIError(response, responseText) {
   } catch {
     if (responseText && responseText.length < 200) message = responseText;
   }
-  if (response.status === 429) {
-    message = "Too many requests. Please try again later.";
-  }
   return new APIError(message, response.status, { url: response.url });
 }
 async function withRetry(fn, maxRetries = 3, delayMs = 1e3, timeoutMs) {
@@ -397,11 +396,13 @@ async function apiSignIntentV3(request, opts) {
   const sig = json?.responseObject?.signedIntent;
   const expStr = json?.responseObject?.intentData?.signatureExpiration ?? json?.responseObject?.signatureExpiration;
   const preIntentHookData = json?.responseObject?.intentData?.preIntentHookData ?? json?.responseObject?.preIntentHookData;
+  const referralFees = json?.responseObject?.intentData?.referralFees ?? json?.responseObject?.referralFees;
   if (!sig || !expStr) throw new Error("v3/intent missing signature or expiration");
   return {
     signature: sig,
     signatureExpiration: BigInt(expStr),
-    preIntentHookData
+    preIntentHookData,
+    referralFees
   };
 }
 
@@ -820,7 +821,7 @@ var IntentOperations = class {
     const depositId = parseRawDepositId(params.depositId);
     const amount = typeof params.amount === "bigint" ? params.amount : BigInt(params.amount);
     const conversionRate = typeof params.conversionRate === "bigint" ? params.conversionRate : BigInt(params.conversionRate);
-    const referralFees = referrerFeeConfig !== void 0 ? [
+    let referralFees = referrerFeeConfig !== void 0 ? [
       {
         recipient: referrerFeeConfig.recipient,
         fee: referrerFeeConfigToPreciseUnits(referrerFeeConfig)
@@ -862,6 +863,23 @@ var IntentOperations = class {
       gatingServiceSignature = response.signature;
       signatureExpiration = response.signatureExpiration;
       preIntentHookData = response.preIntentHookData ?? preIntentHookData;
+      if (response.referralFees !== void 0) {
+        referralFees = response.referralFees.map((referralFee) => {
+          if (!isValidReferrerFeeRecipient(referralFee.recipient)) {
+            throw new Error("v3/intent returned invalid referral fee recipient");
+          }
+          let fee;
+          try {
+            fee = BigInt(referralFee.fee);
+          } catch {
+            throw new Error("v3/intent returned non-integer referral fee value");
+          }
+          return {
+            recipient: referralFee.recipient,
+            fee
+          };
+        });
+      }
     }
     if (!gatingServiceSignature || !signatureExpiration) {
       throw new Error("Missing gatingServiceSignature/signatureExpiration");
@@ -3489,9 +3507,10 @@ function convertIndexerDepositToEscrowView(deposit, _chainId, _escrowAddress) {
     verifiers
   };
 }
-function convertDepositsForLiquidity(deposits, chainId, escrowAddress) {
+function convertDepositsForLiquidity(deposits, chainId, escrowAddress, options = {}) {
+  const { includePrivateOrderbooks = false } = options;
   return deposits.filter(
-    (d) => d.depositor && d.depositor.toLowerCase() !== ZERO && normalizeAddress2(d.whitelistHookAddress).toLowerCase() === ZERO && d.acceptingIntents && toBigInt(d.remainingDeposits) > 0n && d.status === "ACTIVE"
+    (d) => d.depositor && d.depositor.toLowerCase() !== ZERO && (includePrivateOrderbooks || normalizeAddress2(d.whitelistHookAddress).toLowerCase() === ZERO) && d.acceptingIntents && toBigInt(d.remainingDeposits) > 0n && d.status === "ACTIVE"
   ).map((d) => convertIndexerDepositToEscrowView(d));
 }
 function convertIndexerIntentsToEscrowViews(intents, depositViewsById) {
@@ -4821,13 +4840,11 @@ function convertIndexerDepositToLegacyApiDeposit(deposit) {
     verifiers
   };
 }
-async function apiPostDepositDetails(req, baseApiUrl, timeoutMs, apiKey, authToken) {
+async function apiPostDepositDetails(req, baseApiUrl, timeoutMs, _apiKey, _authToken) {
   return apiFetch({
     url: `${withApiBase(baseApiUrl)}/v1/makers/create`,
     method: "POST",
     body: req,
-    apiKey,
-    authToken,
     timeoutMs
   });
 }
@@ -4837,13 +4854,25 @@ async function apiGetQuote(req, baseApiUrl, timeoutMs, apiKey, authToken) {
       throw new ValidationError("quotesToReturn must be a positive integer", "quotesToReturn");
     }
   }
+  if (!isValidHexAddress(req.user)) {
+    throw new ValidationError("user must be a valid Ethereum address", "user");
+  }
+  if (!isValidHexAddress(req.recipient)) {
+    throw new ValidationError("recipient must be a valid Ethereum address", "recipient");
+  }
+  if (!isValidHexAddress(req.destinationToken)) {
+    throw new ValidationError(
+      "destinationToken must be a valid Ethereum address",
+      "destinationToken"
+    );
+  }
   const isExactFiat = req.isExactFiat !== false;
   const endpoint = isExactFiat ? "exact-fiat" : "exact-token";
   let url = `${withApiBase(baseApiUrl)}/v2/quote/${endpoint}`;
   if (req.quotesToReturn) url += `?quotesToReturn=${req.quotesToReturn}`;
   const requestBody = {
     ...req,
-    [isExactFiat ? "exactFiatAmount" : "exactTokenAmount"]: req.amount,
+    [isExactFiat ? "exactFiatAmount" : "exactTokenAmount"]: String(req.amount),
     amount: void 0,
     isExactFiat: void 0,
     quotesToReturn: void 0
@@ -4858,6 +4887,29 @@ async function apiGetQuote(req, baseApiUrl, timeoutMs, apiKey, authToken) {
     timeoutMs
   });
 }
+async function apiGetQuotesBestByPlatform(req, baseApiUrl, timeoutMs, apiKey, authToken) {
+  const isExactFiat = req.isExactFiat !== false;
+  const endpoint = isExactFiat ? "best-by-platform" : "best-by-platform-exact-token";
+  const url = `${withApiBase(baseApiUrl)}/v2/quote/${endpoint}`;
+  const requestBody = {
+    ...req,
+    [isExactFiat ? "exactFiatAmount" : "exactTokenAmount"]: String(req.amount),
+    amount: void 0,
+    isExactFiat: void 0,
+    referrerFeeConfig: void 0
+  };
+  Object.keys(requestBody).forEach(
+    (key) => requestBody[key] === void 0 && delete requestBody[key]
+  );
+  return apiFetch({
+    url,
+    method: "POST",
+    body: requestBody,
+    apiKey,
+    authToken,
+    timeoutMs
+  });
+}
 async function apiGetPayeeDetails(req, apiKey, baseApiUrl, authToken, timeoutMs) {
   return apiFetch({
     url: `${baseApiUrl.replace(/\/$/, "")}/v1/makers/${req.processorName}/${req.hashedOnchainId}`,
@@ -4924,7 +4976,6 @@ async function apiGetTakerTier(req, apiKey, baseApiUrl, timeoutMs) {
   return apiFetch({
     url: `${withApiBase(baseApiUrl)}${endpoint}`,
     method: "GET",
-    apiKey,
     timeoutMs
   });
 }
@@ -5021,6 +5072,23 @@ var appendReferrerFeeDisplayFields = (quoteResponse, referrerFeeConfig) => {
     }
   };
 };
+var appendReferrerFeeDisplayFieldsToBestByPlatform = (quoteResponse, referrerFeeConfig) => {
+  if (!referrerFeeConfig) {
+    return quoteResponse;
+  }
+  const decimals = quoteResponse.responseObject?.token?.decimals ?? 6;
+  const enrichedPlatformQuotes = (quoteResponse.responseObject?.platformQuotes ?? []).map((platformQuote) => ({
+    ...platformQuote,
+    bestQuote: platformQuote.available && platformQuote.bestQuote ? applyReferrerFeeDisplayFieldsToQuote(platformQuote.bestQuote, referrerFeeConfig, decimals) : platformQuote.bestQuote
+  }));
+  return {
+    ...quoteResponse,
+    responseObject: {
+      ...quoteResponse.responseObject,
+      platformQuotes: enrichedPlatformQuotes
+    }
+  };
+};
 
 // src/utils/erc20.ts
 var ERC20_ABI = [
@@ -5593,7 +5661,9 @@ var Zkp2pClient = class {
      * sending fiat payment to the deposit's payee.
      *
      * If `gatingServiceSignature` is not provided, the SDK will automatically
-     * fetch one from the API (requires `apiKey` or `authorizationToken`).
+     * fetch one from curator `/v3/intent` when `apiKey` or `authorizationToken`
+     * is available. Otherwise you must provide `gatingServiceSignature` and
+     * `signatureExpiration` yourself.
      *
      * **Prepare Mode**: Use `.prepare()` to get the transaction calldata without sending:
      * ```typescript
@@ -6932,15 +7002,7 @@ var Zkp2pClient = class {
       })
     );
     const apiResponses = await Promise.all(
-      depositDetails.map(
-        (req) => apiPostDepositDetails(
-          req,
-          baseApiUrl,
-          this.apiTimeoutMs,
-          this.apiKey,
-          this.authorizationToken
-        )
-      )
+      depositDetails.map((req) => apiPostDepositDetails(req, baseApiUrl, this.apiTimeoutMs))
     );
     if (!apiResponses.every((r) => r?.success)) {
       const failed = apiResponses.find((r) => !r?.success);
@@ -7067,15 +7129,7 @@ var Zkp2pClient = class {
       } else {
         const baseApiUrl = (this.baseApiUrl ?? "https://api.zkp2p.xyz").replace(/\/$/, "");
         const apiResponses = await Promise.all(
-          depositDetails.map(
-            (req) => apiPostDepositDetails(
-              req,
-              baseApiUrl,
-              this.apiTimeoutMs,
-              this.apiKey,
-              this.authorizationToken
-            )
-          )
+          depositDetails.map((req) => apiPostDepositDetails(req, baseApiUrl, this.apiTimeoutMs))
         );
         if (!apiResponses.every((r) => r?.success)) {
           const failed = apiResponses.find((r) => !r?.success);
@@ -7278,6 +7332,57 @@ var Zkp2pClient = class {
     }
     return appendReferrerFeeDisplayFields(quote, referrerFeeConfig);
   }
+  /**
+   * **Supporting Method** - Fetches the best available quote per supported payment platform.
+   *
+   * Returns one quote per platform when available. When authenticated, the API
+   * returns payee details in each platform's best quote.
+   *
+   * @param req - Best-by-platform quote request parameters
+   * @param opts - Optional overrides for API URL and timeout
+   * @returns Best-by-platform quote response
+   */
+  async getQuotesBestByPlatform(req, opts) {
+    const referrerFeeConfig = assertValidReferrerFeeConfig(
+      req.referrerFeeConfig,
+      "getQuotesBestByPlatform"
+    );
+    const baseApiUrl = (opts?.baseApiUrl ?? this.baseApiUrl ?? "https://api.zkp2p.xyz").replace(
+      /\/$/,
+      ""
+    );
+    const timeoutMs = opts?.timeoutMs ?? this.apiTimeoutMs;
+    const reqWithEscrow = { ...req };
+    if (!reqWithEscrow.escrowAddresses || reqWithEscrow.escrowAddresses.length === 0) {
+      const configuredEscrows = this.escrowAddresses.length > 0 ? [...this.escrowAddresses] : this.escrowAddress ? [this.escrowAddress] : [];
+      if (configuredEscrows.length > 0) {
+        reqWithEscrow.escrowAddresses = configuredEscrows;
+      }
+    }
+    const quote = await apiGetQuotesBestByPlatform(
+      reqWithEscrow,
+      baseApiUrl,
+      timeoutMs,
+      this.apiKey,
+      this.authorizationToken
+    );
+    const enrichedQuote = quote ? {
+      ...quote,
+      responseObject: {
+        ...quote.responseObject,
+        platformQuotes: (quote.responseObject?.platformQuotes ?? []).map((platformQuote) => {
+          const bestQuote = platformQuote?.bestQuote;
+          const makerDepositData = bestQuote?.maker?.depositData;
+          if (!bestQuote || !makerDepositData) return platformQuote;
+          return {
+            ...platformQuote,
+            bestQuote: { ...bestQuote, payeeData: makerDepositData }
+          };
+        })
+      }
+    } : quote;
+    return appendReferrerFeeDisplayFieldsToBestByPlatform(enrichedQuote, referrerFeeConfig);
+  }
   // ───────────────────────────────────────────────────────────────────────────
   // SUPPORTING: TAKER TIER
   // (Used by frontends to display taker limits)
@@ -7297,7 +7402,7 @@ var Zkp2pClient = class {
       ""
     );
     const timeoutMs = opts?.timeoutMs ?? this.apiTimeoutMs;
-    return apiGetTakerTier(req, this.apiKey, baseApiUrl, timeoutMs);
+    return apiGetTakerTier(req, void 0, baseApiUrl, timeoutMs);
   }
   // ╔═══════════════════════════════════════════════════════════════════════════╗
   // ║ CORE: ON-CHAIN DEPOSIT VIEWS                                             ║
@@ -7666,6 +7771,6 @@ var logger = {
   }
 };
 
-export { BASE_BUILDER_CODE, CHAINLINK_ORACLE_ADAPTER, CHAINLINK_ORACLE_FEEDS, ContractRouter, DEFAULT_ORACLE_MAX_STALENESS_SECONDS, IndexerClient, IndexerDepositService, IndexerRateManagerService, Zkp2pClient as OfframpClient, PAYMENT_PLATFORMS, PEER_EXTENSION_CHROME_URL, PLATFORM_METADATA, PYTH_CONTRACT_BASE, PYTH_ORACLE_ADAPTER, PYTH_ORACLE_FEEDS, SPREAD_ORACLE_FEEDS, SUPPORTED_CHAIN_IDS, TOKEN_METADATA, ZKP2P_ANDROID_REFERRER, ZKP2P_IOS_REFERRER, Zkp2pClient, apiGetOwnerDeposits, apiGetPayeeDetails, apiGetTakerTier, apiPostDepositDetails, apiValidatePayeeDetails, appendAttributionToCalldata, assertValidReferrerFeeConfig, compareEventCursorIdsByRecency, convertDepositsForLiquidity, convertIndexerDepositToEscrowView, convertIndexerIntentsToEscrowViews, createCompositeDepositId, createPeerExtensionSdk, defaultIndexerEndpoint, encodePythAdapterConfig, encodeSpreadOracleAdapterConfig, encodeWithAttribution, fetchFulfillmentAndPayment as fetchIndexerFulfillmentAndPayment, getAttributionDataSuffix, getPeerExtensionState, getSpreadOracleConfig, isPeerExtensionAvailable, isValidReferrerFeeBps, isValidReferrerFeeRecipient, logger, openPeerExtensionInstallPage, parseReferrerFeeConfig, peerExtensionSdk, referrerFeeConfigToPreciseUnits, sendTransactionWithAttribution, setLogLevel, validateOracleFeedsOnChain };
+export { BASE_BUILDER_CODE, CHAINLINK_ORACLE_ADAPTER, CHAINLINK_ORACLE_FEEDS, ContractRouter, DEFAULT_ORACLE_MAX_STALENESS_SECONDS, IndexerClient, IndexerDepositService, IndexerRateManagerService, Zkp2pClient as OfframpClient, PAYMENT_PLATFORMS, PEER_EXTENSION_CHROME_URL, PLATFORM_METADATA, PYTH_CONTRACT_BASE, PYTH_ORACLE_ADAPTER, PYTH_ORACLE_FEEDS, SPREAD_ORACLE_FEEDS, SUPPORTED_CHAIN_IDS, TOKEN_METADATA, ZKP2P_ANDROID_REFERRER, ZKP2P_IOS_REFERRER, Zkp2pClient, apiGetOwnerDeposits, apiGetPayeeDetails, apiGetQuotesBestByPlatform, apiGetTakerTier, apiPostDepositDetails, apiValidatePayeeDetails, appendAttributionToCalldata, assertValidReferrerFeeConfig, compareEventCursorIdsByRecency, convertDepositsForLiquidity, convertIndexerDepositToEscrowView, convertIndexerIntentsToEscrowViews, createCompositeDepositId, createPeerExtensionSdk, defaultIndexerEndpoint, encodePythAdapterConfig, encodeSpreadOracleAdapterConfig, encodeWithAttribution, fetchFulfillmentAndPayment as fetchIndexerFulfillmentAndPayment, getAttributionDataSuffix, getPeerExtensionState, getSpreadOracleConfig, isPeerExtensionAvailable, isValidReferrerFeeBps, isValidReferrerFeeRecipient, logger, openPeerExtensionInstallPage, parseReferrerFeeConfig, peerExtensionSdk, referrerFeeConfigToPreciseUnits, sendTransactionWithAttribution, setLogLevel, validateOracleFeedsOnChain };
 //# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map