@zkp2p/sdk 0.2.3 → 0.3.0

package/dist/react.d.mts

@@ -1,5 +1,5 @@
-import { Z as Zkp2pClient, i as SignalIntentMethodParams, ac as PreparedTransaction, af as TakerTier, f as GetTakerTierRequest, g as GetTakerTierResponse, F as FulfillIntentMethodParams, bu as SendTransactionFn, bv as SendBatchFn, bs as DelegationDepositTarget, bt as BatchResult } from './vaultUtils-DiAumiXp.mjs';
-export { bq as DelegationRoute, br as DelegationState, bw as VAULT_ZERO_ADDRESS, bk as ZERO_RATE_MANAGER_ID, bx as asErrorMessage, by as assertDelegationMethodSupport, bp as classifyDelegationState, bo as getDelegationRoute, bl as isZeroRateManagerId, bm as normalizeRateManagerId, bn as normalizeRegistry } from './vaultUtils-DiAumiXp.mjs';
+import { Z as Zkp2pClient, i as SignalIntentMethodParams, aj as PreparedTransaction, am as TakerTier, f as GetTakerTierRequest, g as GetTakerTierResponse, F as FulfillIntentMethodParams, bB as SendTransactionFn, bC as SendBatchFn, bz as DelegationDepositTarget, bA as BatchResult } from './vaultUtils-sodi4Xx-.mjs';
+export { bx as DelegationRoute, by as DelegationState, bD as VAULT_ZERO_ADDRESS, br as ZERO_RATE_MANAGER_ID, bE as asErrorMessage, bF as assertDelegationMethodSupport, bw as classifyDelegationState, bv as getDelegationRoute, bs as isZeroRateManagerId, bt as normalizeRateManagerId, bu as normalizeRegistry } from './vaultUtils-sodi4Xx-.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, i as SignalIntentMethodParams, ac as PreparedTransaction, af as TakerTier, f as GetTakerTierRequest, g as GetTakerTierResponse, F as FulfillIntentMethodParams, bu as SendTransactionFn, bv as SendBatchFn, bs as DelegationDepositTarget, bt as BatchResult } from './vaultUtils-DiAumiXp.js';
-export { bq as DelegationRoute, br as DelegationState, bw as VAULT_ZERO_ADDRESS, bk as ZERO_RATE_MANAGER_ID, bx as asErrorMessage, by as assertDelegationMethodSupport, bp as classifyDelegationState, bo as getDelegationRoute, bl as isZeroRateManagerId, bm as normalizeRateManagerId, bn as normalizeRegistry } from './vaultUtils-DiAumiXp.js';
+import { Z as Zkp2pClient, i as SignalIntentMethodParams, aj as PreparedTransaction, am as TakerTier, f as GetTakerTierRequest, g as GetTakerTierResponse, F as FulfillIntentMethodParams, bB as SendTransactionFn, bC as SendBatchFn, bz as DelegationDepositTarget, bA as BatchResult } from './vaultUtils-sodi4Xx-.js';
+export { bx as DelegationRoute, by as DelegationState, bD as VAULT_ZERO_ADDRESS, br as ZERO_RATE_MANAGER_ID, bE as asErrorMessage, bF as assertDelegationMethodSupport, bw as classifyDelegationState, bv as getDelegationRoute, bs as isZeroRateManagerId, bt as normalizeRateManagerId, bu as normalizeRegistry } from './vaultUtils-sodi4Xx-.js';
 import { Hash, Address, Hex } from 'viem';
 import '@zkp2p/indexer-schema';
 import 'abitype';

package/dist/{vaultUtils-DiAumiXp.d.mts → vaultUtils-sodi4Xx-.d.mts}

@@ -1,5 +1,5 @@
 import * as _zkp2p_indexer_schema from '@zkp2p/indexer-schema';
-import { Deposit, DepositStatus as DepositStatus$2, IntentStatus as IntentStatus$1, DepositPaymentMethod, MethodCurrency, Intent as Intent$1, RateManager, ManagerAggregateStats, RateManagerRate, ManagerStats, DepositFundActivity, DepositDailySnapshot, ManagerDailySnapshot } from '@zkp2p/indexer-schema';
+import { Deposit, DepositStatus as DepositStatus$2, IntentStatus as IntentStatus$1, DepositPaymentMethod, MethodCurrency, Intent as Intent$1, MakerProfitSnapshot, RateManager, ManagerAggregateStats, RateManagerRate, ManagerStats, DepositFundActivity, DepositDailySnapshot, ManagerDailySnapshot } from '@zkp2p/indexer-schema';
 import { Address, Hex, AccessList, AuthorizationList, Hash, WalletClient, PublicClient } from 'viem';
 import { Abi } from 'abitype';
 
@@ -485,6 +485,7 @@ type ManagerAggregateStatsEntity = WithOverrides<ManagerAggregateStats, {
 }>;
 type ManagerStatsEntity = ManagerStats;
 type ManagerDailySnapshotEntity = ManagerDailySnapshot;
+type MakerProfitSnapshotEntity = MakerProfitSnapshot;
 interface ManualRateUpdateEntity {
     id: string;
     rateManagerId: string;
@@ -570,6 +571,7 @@ declare class IndexerDepositService {
     }): Promise<DepositWithRelations[]>;
     fetchIntentsForDeposits(depositIds: string[], statuses?: IntentStatus[]): Promise<IntentEntity[]>;
     fetchIntentsByOwner(owner: string, statuses?: IntentStatus[]): Promise<IntentEntity[]>;
+    fetchIntentsByRateManager(rateManagerId: string, statuses?: IntentStatus[]): Promise<IntentEntity[]>;
     fetchIntentByHash(intentHash: string): Promise<IntentEntity | null>;
     fetchDepositWithRelations(id: string, options?: {
         includeIntents?: boolean;
@@ -609,6 +611,7 @@ declare class IndexerDepositService {
      * Fetch daily snapshots for a deposit, ordered by day ascending.
      */
     fetchDepositDailySnapshots(compositeDepositId: string, limit?: number): Promise<DepositDailySnapshotEntity[]>;
+    fetchProfitSnapshotsByDeposits(depositIds: string[]): Promise<MakerProfitSnapshotEntity[]>;
 }
 
 type OrderDirection = 'asc' | 'desc';
@@ -885,6 +888,27 @@ type QuoteRequest = {
     /** Max suggestions per direction (1-10, default: 3) */
     nearbyQuotesCount?: number;
 };
+type QuotesBestByPlatformRequest = {
+    fiatCurrency: string;
+    user: string;
+    recipient: string;
+    destinationChainId: number;
+    destinationToken: string;
+    referrer?: string;
+    referrerFeeConfig?: ReferrerFeeConfig;
+    amount: string;
+    isExactFiat?: boolean;
+    /** Optional filter: limit quotes to these escrow contracts */
+    escrowAddresses?: string[];
+    /** Minimum maker success rate in basis points (0-10000) */
+    minDepositSuccessRateBps?: number;
+    /** Whether quotes may include business accounts */
+    supportBusinessAccounts?: boolean;
+    /** Optional intent gating service address to filter by */
+    intentGatingService?: string;
+    /** Include whitelist-gated private orderbook deposits */
+    includePrivateOrderbooks?: boolean;
+};
 type FiatResponse = {
     currencyCode: string;
     currencyName: string;
@@ -1007,6 +1031,34 @@ type QuoteResponse = {
 type GetQuoteResponse = Omit<QuoteResponse, 'responseObject'> & {
     responseObject: GetQuoteResponseObject;
 };
+type PlatformQuote = {
+    platform: string;
+    supported: boolean;
+    available: boolean;
+    bestQuote?: QuoteSingleResponse;
+};
+type GetPlatformQuote = Omit<PlatformQuote, 'bestQuote'> & {
+    bestQuote?: GetQuoteSingleResponse;
+};
+type BestByPlatformResponseObject = {
+    fiat: FiatResponse;
+    token: TokenResponse;
+    fees: QuoteFeesResponse;
+    platformQuotes: PlatformQuote[];
+    quoteExpiresAt: string;
+};
+type GetBestByPlatformResponseObject = Omit<BestByPlatformResponseObject, 'platformQuotes'> & {
+    platformQuotes: GetPlatformQuote[];
+};
+type BestByPlatformResponse = {
+    message: string;
+    success: boolean;
+    responseObject: BestByPlatformResponseObject;
+    statusCode: number;
+};
+type GetBestByPlatformResponse = Omit<BestByPlatformResponse, 'responseObject'> & {
+    responseObject: GetBestByPlatformResponseObject;
+};
 /**
  * Request to fetch payee details
  * Prefer `processorName`; `platform` kept for backward compatibility.
@@ -1305,7 +1357,7 @@ type PaymentPlatformType = (typeof PAYMENT_PLATFORMS)[number];
  *   walletClient,
  *   chainId: 8453, // Base mainnet
  *   runtimeEnv: 'production',
- *   apiKey: 'your-curator-api-key',
+ *   // apiKey: 'your-curator-api-key', // Optional: auto gating-signature fetches and quote enrichment
  *   indexerApiKey: 'your-indexer-key',
  * };
  * ```
@@ -1323,7 +1375,11 @@ type Zkp2pNextOptions = {
     indexerUrl?: string;
     /** Base API URL for ZKP2P services (defaults to https://api.zkp2p.xyz) */
     baseApiUrl?: string;
-    /** Curator API key for authenticated endpoints like registerPayeeDetails, signalIntent (sent as x-api-key to curator) */
+    /**
+     * Optional curator API key (sent as `x-api-key`) for auto-fetching
+     * `signalIntent` gating signatures and authenticated quote enrichment.
+     * Not used by `registerPayeeDetails` or `getTakerTier`.
+     */
     apiKey?: string;
     /** Optional bearer token for hybrid authentication */
     authorizationToken?: string;
@@ -1492,7 +1548,6 @@ type OnchainCurrencyEntry = {
  * const client = new OfframpClient({
  *   walletClient,
  *   chainId: base.id,
- *   apiKey: 'your-api-key',
  * });
  *
  * // Step 1: Register payee details (separate from deposit creation)
@@ -1574,7 +1629,7 @@ declare class Zkp2pClient {
     readonly orchestratorRegistryAbi?: Abi;
     /** Base API URL for ZKP2P services */
     readonly baseApiUrl?: string;
-    /** API key for authenticated endpoints */
+    /** Optional curator API key (`x-api-key`) for auto gating-signature fetches and quote enrichment */
     readonly apiKey?: string;
     /** Bearer token for hybrid authentication */
     readonly authorizationToken?: string;
@@ -1798,6 +1853,10 @@ declare class Zkp2pClient {
          * Fetches all intents created by a specific owner address.
          */
         getOwnerIntents: (owner: string, statuses?: IntentStatus[]) => Promise<IntentEntity[]>;
+        /**
+         * Fetches fulfilled intents for a vault by rate manager ID.
+         */
+        getIntentsByRateManager: (rateManagerId: string, statuses?: IntentStatus[]) => Promise<IntentEntity[]>;
         /**
          * Fetches a single intent by hash.
          */
@@ -1844,6 +1903,10 @@ declare class Zkp2pClient {
             includeIntents?: boolean;
             intentStatuses?: IntentStatus[];
         }) => Promise<DepositWithRelations[]>;
+        /**
+         * Fetches maker profit snapshots for the provided deposits.
+         */
+        getProfitSnapshotsByDeposits: (depositIds: string[]) => Promise<MakerProfitSnapshotEntity[]>;
         /**
          * Fetches rate managers (vaults) with aggregate stats.
          */
@@ -2525,7 +2588,9 @@ declare class Zkp2pClient {
      * 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
@@ -2774,6 +2839,20 @@ declare class Zkp2pClient {
         baseApiUrl?: string;
         timeoutMs?: number;
     }): Promise<GetQuoteResponse>;
+    /**
+     * **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
+     */
+    getQuotesBestByPlatform(req: QuotesBestByPlatformRequest, opts?: {
+        baseApiUrl?: string;
+        timeoutMs?: number;
+    }): Promise<GetBestByPlatformResponse>;
     /**
      * **Supporting Method** - Fetches taker tier information for an address.
      *
@@ -2949,4 +3028,4 @@ type SendBatchFn = (txs: Array<{
     value?: bigint;
 }>) => Promise<string>;
 
-export { type GetDepositByIdResponse as $, type AuthorizationTokenProvider as A, type QuoteResponseObject as B, type CurrencyType as C, type DepositWithRelations as D, type QuoteSingleResponse as E, type FulfillIntentMethodParams as F, type GetPayeeDetailsRequest as G, type QuoteIntentResponse as H, type IntentEntity as I, type QuoteFeesResponse as J, type FiatResponse as K, type TokenResponse as L, type NearbySuggestions as M, type NearbyQuote as N, type ApiDeposit as O, type PostDepositDetailsRequest as P, type QuoteRequest as Q, type ReferrerFeeConfig as R, type SignalIntentReferralFee as S, type TxOverrides as T, type DepositVerifier as U, type ValidatePayeeDetailsRequest as V, type WithdrawDepositParams as W, type DepositVerifierCurrency as X, type DepositStatus as Y, Zkp2pClient as Z, type GetDepositByIdRequest as _, type ValidatePayeeDetailsResponse as a, getCurrencyInfoFromCountryCode as a$, type Intent as a0, type ApiIntentStatus as a1, type GetOwnerIntentsRequest as a2, type GetOwnerIntentsResponse as a3, type GetIntentsByDepositRequest as a4, type GetIntentsByDepositResponse as a5, type GetIntentByHashRequest as a6, type GetIntentByHashResponse as a7, type RegisterPayeeDetailsRequest as a8, type RegisterPayeeDetailsResponse as a9, type ManagerStatsEntity as aA, type ManagerDailySnapshotEntity as aB, type RateManagerListItem as aC, type RateManagerDetail as aD, type ManualRateUpdateEntity as aE, type OracleConfigUpdateEntity as aF, type DepositFundActivityEntity as aG, type DepositDailySnapshotEntity as aH, type DepositFundActivityType as aI, type DepositFilter as aJ, type PaginationOptions as aK, type DepositOrderField as aL, type OrderDirection$1 as aM, type RateManagerFilter as aN, type RateManagerPaginationOptions as aO, type RateManagerDelegationPaginationOptions as aP, type RateManagerOrderField as aQ, type OrderDirection as aR, type DeploymentEnv as aS, type FulfillmentRecord as aT, type PaymentVerifiedRecord as aU, type FulfillmentAndPaymentResponse as aV, PAYMENT_PLATFORMS as aW, type PaymentPlatformType as aX, Currency as aY, currencyInfo as aZ, getCurrencyInfoFromHash as a_, type OnchainCurrency as aa, type DepositVerifierData as ab, type PreparedTransaction as ac, type OrderStats as ad, type DepositIntentStatistics as ae, type TakerTier as af, type TakerTierStats as ag, type TakerTierLevel as ah, type PlatformLimit as ai, type PlatformRiskLevel as aj, IndexerClient as ak, defaultIndexerEndpoint as al, IndexerDepositService as am, IndexerRateManagerService as an, compareEventCursorIdsByRecency as ao, fetchFulfillmentAndPayment as ap, type DepositEntity as aq, type IntentFulfilledEntity as ar, type IntentFulfillmentAmountsEntity as as, type DepositPaymentMethodEntity as at, type MethodCurrencyEntity as au, type IntentStatus as av, type RateManagerEntity as aw, type RateManagerRateEntity as ax, type RateManagerDelegationEntity as ay, type ManagerAggregateStatsEntity as az, type PostDepositDetailsResponse as b, getCurrencyCodeFromHash as b0, isSupportedCurrencyHash as b1, mapConversionRatesToOnchainMinRate as b2, type CurrencyData as b3, getContracts as b4, getRateManagerContracts as b5, getPaymentMethodsCatalog as b6, getGatingServiceAddress as b7, type RuntimeEnv as b8, parseDepositView as b9, parseIntentView as ba, enrichPvDepositView as bb, enrichPvIntentView as bc, type PV_DepositView as bd, type PV_Deposit as be, type PV_PaymentMethodData as bf, type PV_Currency as bg, type PV_ReferralFee as bh, type PV_IntentView as bi, type PV_Intent as bj, ZERO_RATE_MANAGER_ID as bk, isZeroRateManagerId as bl, normalizeRateManagerId as bm, normalizeRegistry as bn, getDelegationRoute as bo, classifyDelegationState as bp, type DelegationRoute as bq, type DelegationState as br, type DelegationDepositTarget as bs, type BatchResult as bt, type SendTransactionFn as bu, type SendBatchFn as bv, ZERO_ADDRESS as bw, asErrorMessage as bx, assertDelegationMethodSupport as by, type GetPayeeDetailsResponse as c, type GetOwnerDepositsRequest as d, type GetOwnerDepositsResponse as e, type GetTakerTierRequest as f, type GetTakerTierResponse as g, type PaymentMethodCatalog as h, type SignalIntentMethodParams as i, type CancelIntentMethodParams as j, type Zkp2pNextOptions as k, type TimeoutConfig as l, type ActionCallback as m, type CreateDepositParams as n, type CreateDepositConversionRate as o, type Range as p, type SignalIntentParams as q, type FulfillIntentParams as r, type ReleaseFundsToPayerParams as s, type CancelIntentParams as t, type GetNearbyQuote as u, type GetNearbySuggestions as v, type GetQuoteResponse as w, type GetQuoteResponseObject as x, type GetQuoteSingleResponse as y, type QuoteResponse as z };
+export { type NearbyQuote as $, type AuthorizationTokenProvider as A, type BestByPlatformResponse as B, type CurrencyType as C, type DepositWithRelations as D, type GetNearbyQuote as E, type FulfillIntentMethodParams as F, type GetPayeeDetailsRequest as G, type GetNearbySuggestions as H, type IntentEntity as I, type GetQuoteResponse as J, type GetQuoteResponseObject as K, type GetQuoteSingleResponse as L, type QuoteResponse as M, type QuoteResponseObject as N, type QuoteSingleResponse as O, type PostDepositDetailsRequest as P, type QuotesBestByPlatformRequest as Q, type ReferrerFeeConfig as R, type SignalIntentReferralFee as S, type TxOverrides as T, type QuoteIntentResponse as U, type ValidatePayeeDetailsRequest as V, type WithdrawDepositParams as W, type QuoteFeesResponse as X, type FiatResponse as Y, Zkp2pClient as Z, type TokenResponse as _, type ValidatePayeeDetailsResponse as a, type PaymentVerifiedRecord as a$, type NearbySuggestions as a0, type ApiDeposit as a1, type DepositVerifier as a2, type DepositVerifierCurrency as a3, type DepositStatus as a4, type GetDepositByIdRequest as a5, type GetDepositByIdResponse as a6, type Intent as a7, type ApiIntentStatus as a8, type GetOwnerIntentsRequest as a9, type DepositPaymentMethodEntity as aA, type MethodCurrencyEntity as aB, type IntentStatus as aC, type RateManagerEntity as aD, type RateManagerRateEntity as aE, type RateManagerDelegationEntity as aF, type ManagerAggregateStatsEntity as aG, type ManagerStatsEntity as aH, type ManagerDailySnapshotEntity as aI, type RateManagerListItem as aJ, type RateManagerDetail as aK, type ManualRateUpdateEntity as aL, type OracleConfigUpdateEntity as aM, type DepositFundActivityEntity as aN, type DepositDailySnapshotEntity as aO, type DepositFundActivityType as aP, type DepositFilter as aQ, type PaginationOptions as aR, type DepositOrderField as aS, type OrderDirection$1 as aT, type RateManagerFilter as aU, type RateManagerPaginationOptions as aV, type RateManagerDelegationPaginationOptions as aW, type RateManagerOrderField as aX, type OrderDirection as aY, type DeploymentEnv as aZ, type FulfillmentRecord as a_, 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 OnchainCurrency as ah, type DepositVerifierData as ai, type PreparedTransaction as aj, type OrderStats as ak, type DepositIntentStatistics as al, type TakerTier as am, type TakerTierStats as an, type TakerTierLevel as ao, type PlatformLimit as ap, type PlatformRiskLevel as aq, IndexerClient as ar, defaultIndexerEndpoint as as, IndexerDepositService as at, IndexerRateManagerService as au, compareEventCursorIdsByRecency as av, fetchFulfillmentAndPayment as aw, type DepositEntity as ax, type IntentFulfilledEntity as ay, type IntentFulfillmentAmountsEntity as az, type PostDepositDetailsResponse as b, type FulfillmentAndPaymentResponse as b0, PAYMENT_PLATFORMS as b1, type PaymentPlatformType as b2, Currency as b3, currencyInfo as b4, getCurrencyInfoFromHash as b5, getCurrencyInfoFromCountryCode as b6, getCurrencyCodeFromHash as b7, isSupportedCurrencyHash as b8, mapConversionRatesToOnchainMinRate as b9, type BatchResult as bA, type SendTransactionFn as bB, type SendBatchFn as bC, ZERO_ADDRESS as bD, asErrorMessage as bE, assertDelegationMethodSupport as bF, type CurrencyData as ba, getContracts as bb, getRateManagerContracts as bc, getPaymentMethodsCatalog as bd, getGatingServiceAddress as be, type RuntimeEnv as bf, parseDepositView as bg, parseIntentView as bh, enrichPvDepositView as bi, enrichPvIntentView as bj, type PV_DepositView as bk, type PV_Deposit as bl, type PV_PaymentMethodData as bm, type PV_Currency as bn, type PV_ReferralFee as bo, type PV_IntentView as bp, type PV_Intent as bq, ZERO_RATE_MANAGER_ID as br, isZeroRateManagerId as bs, normalizeRateManagerId as bt, normalizeRegistry as bu, getDelegationRoute as bv, classifyDelegationState as bw, type DelegationRoute as bx, type DelegationState as by, type DelegationDepositTarget as bz, type GetPayeeDetailsResponse as c, type GetOwnerDepositsRequest as d, type GetOwnerDepositsResponse as e, type GetTakerTierRequest as f, type GetTakerTierResponse as g, type PaymentMethodCatalog as h, type SignalIntentMethodParams as i, type CancelIntentMethodParams as j, type Zkp2pNextOptions as k, type TimeoutConfig as l, type ActionCallback as m, type CreateDepositParams as n, type CreateDepositConversionRate as o, type Range as p, type SignalIntentParams as q, type FulfillIntentParams as r, type ReleaseFundsToPayerParams as s, type CancelIntentParams as t, type BestByPlatformResponseObject as u, type GetBestByPlatformResponse as v, type GetBestByPlatformResponseObject as w, type GetPlatformQuote as x, type PlatformQuote as y, type QuoteRequest as z };

package/dist/{vaultUtils-DiAumiXp.d.ts → vaultUtils-sodi4Xx-.d.ts}

@@ -1,5 +1,5 @@
 import * as _zkp2p_indexer_schema from '@zkp2p/indexer-schema';
-import { Deposit, DepositStatus as DepositStatus$2, IntentStatus as IntentStatus$1, DepositPaymentMethod, MethodCurrency, Intent as Intent$1, RateManager, ManagerAggregateStats, RateManagerRate, ManagerStats, DepositFundActivity, DepositDailySnapshot, ManagerDailySnapshot } from '@zkp2p/indexer-schema';
+import { Deposit, DepositStatus as DepositStatus$2, IntentStatus as IntentStatus$1, DepositPaymentMethod, MethodCurrency, Intent as Intent$1, MakerProfitSnapshot, RateManager, ManagerAggregateStats, RateManagerRate, ManagerStats, DepositFundActivity, DepositDailySnapshot, ManagerDailySnapshot } from '@zkp2p/indexer-schema';
 import { Address, Hex, AccessList, AuthorizationList, Hash, WalletClient, PublicClient } from 'viem';
 import { Abi } from 'abitype';
 
@@ -485,6 +485,7 @@ type ManagerAggregateStatsEntity = WithOverrides<ManagerAggregateStats, {
 }>;
 type ManagerStatsEntity = ManagerStats;
 type ManagerDailySnapshotEntity = ManagerDailySnapshot;
+type MakerProfitSnapshotEntity = MakerProfitSnapshot;
 interface ManualRateUpdateEntity {
     id: string;
     rateManagerId: string;
@@ -570,6 +571,7 @@ declare class IndexerDepositService {
     }): Promise<DepositWithRelations[]>;
     fetchIntentsForDeposits(depositIds: string[], statuses?: IntentStatus[]): Promise<IntentEntity[]>;
     fetchIntentsByOwner(owner: string, statuses?: IntentStatus[]): Promise<IntentEntity[]>;
+    fetchIntentsByRateManager(rateManagerId: string, statuses?: IntentStatus[]): Promise<IntentEntity[]>;
     fetchIntentByHash(intentHash: string): Promise<IntentEntity | null>;
     fetchDepositWithRelations(id: string, options?: {
         includeIntents?: boolean;
@@ -609,6 +611,7 @@ declare class IndexerDepositService {
      * Fetch daily snapshots for a deposit, ordered by day ascending.
      */
     fetchDepositDailySnapshots(compositeDepositId: string, limit?: number): Promise<DepositDailySnapshotEntity[]>;
+    fetchProfitSnapshotsByDeposits(depositIds: string[]): Promise<MakerProfitSnapshotEntity[]>;
 }
 
 type OrderDirection = 'asc' | 'desc';
@@ -885,6 +888,27 @@ type QuoteRequest = {
     /** Max suggestions per direction (1-10, default: 3) */
     nearbyQuotesCount?: number;
 };
+type QuotesBestByPlatformRequest = {
+    fiatCurrency: string;
+    user: string;
+    recipient: string;
+    destinationChainId: number;
+    destinationToken: string;
+    referrer?: string;
+    referrerFeeConfig?: ReferrerFeeConfig;
+    amount: string;
+    isExactFiat?: boolean;
+    /** Optional filter: limit quotes to these escrow contracts */
+    escrowAddresses?: string[];
+    /** Minimum maker success rate in basis points (0-10000) */
+    minDepositSuccessRateBps?: number;
+    /** Whether quotes may include business accounts */
+    supportBusinessAccounts?: boolean;
+    /** Optional intent gating service address to filter by */
+    intentGatingService?: string;
+    /** Include whitelist-gated private orderbook deposits */
+    includePrivateOrderbooks?: boolean;
+};
 type FiatResponse = {
     currencyCode: string;
     currencyName: string;
@@ -1007,6 +1031,34 @@ type QuoteResponse = {
 type GetQuoteResponse = Omit<QuoteResponse, 'responseObject'> & {
     responseObject: GetQuoteResponseObject;
 };
+type PlatformQuote = {
+    platform: string;
+    supported: boolean;
+    available: boolean;
+    bestQuote?: QuoteSingleResponse;
+};
+type GetPlatformQuote = Omit<PlatformQuote, 'bestQuote'> & {
+    bestQuote?: GetQuoteSingleResponse;
+};
+type BestByPlatformResponseObject = {
+    fiat: FiatResponse;
+    token: TokenResponse;
+    fees: QuoteFeesResponse;
+    platformQuotes: PlatformQuote[];
+    quoteExpiresAt: string;
+};
+type GetBestByPlatformResponseObject = Omit<BestByPlatformResponseObject, 'platformQuotes'> & {
+    platformQuotes: GetPlatformQuote[];
+};
+type BestByPlatformResponse = {
+    message: string;
+    success: boolean;
+    responseObject: BestByPlatformResponseObject;
+    statusCode: number;
+};
+type GetBestByPlatformResponse = Omit<BestByPlatformResponse, 'responseObject'> & {
+    responseObject: GetBestByPlatformResponseObject;
+};
 /**
  * Request to fetch payee details
  * Prefer `processorName`; `platform` kept for backward compatibility.
@@ -1305,7 +1357,7 @@ type PaymentPlatformType = (typeof PAYMENT_PLATFORMS)[number];
  *   walletClient,
  *   chainId: 8453, // Base mainnet
  *   runtimeEnv: 'production',
- *   apiKey: 'your-curator-api-key',
+ *   // apiKey: 'your-curator-api-key', // Optional: auto gating-signature fetches and quote enrichment
  *   indexerApiKey: 'your-indexer-key',
  * };
  * ```
@@ -1323,7 +1375,11 @@ type Zkp2pNextOptions = {
     indexerUrl?: string;
     /** Base API URL for ZKP2P services (defaults to https://api.zkp2p.xyz) */
     baseApiUrl?: string;
-    /** Curator API key for authenticated endpoints like registerPayeeDetails, signalIntent (sent as x-api-key to curator) */
+    /**
+     * Optional curator API key (sent as `x-api-key`) for auto-fetching
+     * `signalIntent` gating signatures and authenticated quote enrichment.
+     * Not used by `registerPayeeDetails` or `getTakerTier`.
+     */
     apiKey?: string;
     /** Optional bearer token for hybrid authentication */
     authorizationToken?: string;
@@ -1492,7 +1548,6 @@ type OnchainCurrencyEntry = {
  * const client = new OfframpClient({
  *   walletClient,
  *   chainId: base.id,
- *   apiKey: 'your-api-key',
  * });
  *
  * // Step 1: Register payee details (separate from deposit creation)
@@ -1574,7 +1629,7 @@ declare class Zkp2pClient {
     readonly orchestratorRegistryAbi?: Abi;
     /** Base API URL for ZKP2P services */
     readonly baseApiUrl?: string;
-    /** API key for authenticated endpoints */
+    /** Optional curator API key (`x-api-key`) for auto gating-signature fetches and quote enrichment */
     readonly apiKey?: string;
     /** Bearer token for hybrid authentication */
     readonly authorizationToken?: string;
@@ -1798,6 +1853,10 @@ declare class Zkp2pClient {
          * Fetches all intents created by a specific owner address.
          */
         getOwnerIntents: (owner: string, statuses?: IntentStatus[]) => Promise<IntentEntity[]>;
+        /**
+         * Fetches fulfilled intents for a vault by rate manager ID.
+         */
+        getIntentsByRateManager: (rateManagerId: string, statuses?: IntentStatus[]) => Promise<IntentEntity[]>;
         /**
          * Fetches a single intent by hash.
          */
@@ -1844,6 +1903,10 @@ declare class Zkp2pClient {
             includeIntents?: boolean;
             intentStatuses?: IntentStatus[];
         }) => Promise<DepositWithRelations[]>;
+        /**
+         * Fetches maker profit snapshots for the provided deposits.
+         */
+        getProfitSnapshotsByDeposits: (depositIds: string[]) => Promise<MakerProfitSnapshotEntity[]>;
         /**
          * Fetches rate managers (vaults) with aggregate stats.
          */
@@ -2525,7 +2588,9 @@ declare class Zkp2pClient {
      * 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
@@ -2774,6 +2839,20 @@ declare class Zkp2pClient {
         baseApiUrl?: string;
         timeoutMs?: number;
     }): Promise<GetQuoteResponse>;
+    /**
+     * **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
+     */
+    getQuotesBestByPlatform(req: QuotesBestByPlatformRequest, opts?: {
+        baseApiUrl?: string;
+        timeoutMs?: number;
+    }): Promise<GetBestByPlatformResponse>;
     /**
      * **Supporting Method** - Fetches taker tier information for an address.
      *
@@ -2949,4 +3028,4 @@ type SendBatchFn = (txs: Array<{
     value?: bigint;
 }>) => Promise<string>;
 
-export { type GetDepositByIdResponse as $, type AuthorizationTokenProvider as A, type QuoteResponseObject as B, type CurrencyType as C, type DepositWithRelations as D, type QuoteSingleResponse as E, type FulfillIntentMethodParams as F, type GetPayeeDetailsRequest as G, type QuoteIntentResponse as H, type IntentEntity as I, type QuoteFeesResponse as J, type FiatResponse as K, type TokenResponse as L, type NearbySuggestions as M, type NearbyQuote as N, type ApiDeposit as O, type PostDepositDetailsRequest as P, type QuoteRequest as Q, type ReferrerFeeConfig as R, type SignalIntentReferralFee as S, type TxOverrides as T, type DepositVerifier as U, type ValidatePayeeDetailsRequest as V, type WithdrawDepositParams as W, type DepositVerifierCurrency as X, type DepositStatus as Y, Zkp2pClient as Z, type GetDepositByIdRequest as _, type ValidatePayeeDetailsResponse as a, getCurrencyInfoFromCountryCode as a$, type Intent as a0, type ApiIntentStatus as a1, type GetOwnerIntentsRequest as a2, type GetOwnerIntentsResponse as a3, type GetIntentsByDepositRequest as a4, type GetIntentsByDepositResponse as a5, type GetIntentByHashRequest as a6, type GetIntentByHashResponse as a7, type RegisterPayeeDetailsRequest as a8, type RegisterPayeeDetailsResponse as a9, type ManagerStatsEntity as aA, type ManagerDailySnapshotEntity as aB, type RateManagerListItem as aC, type RateManagerDetail as aD, type ManualRateUpdateEntity as aE, type OracleConfigUpdateEntity as aF, type DepositFundActivityEntity as aG, type DepositDailySnapshotEntity as aH, type DepositFundActivityType as aI, type DepositFilter as aJ, type PaginationOptions as aK, type DepositOrderField as aL, type OrderDirection$1 as aM, type RateManagerFilter as aN, type RateManagerPaginationOptions as aO, type RateManagerDelegationPaginationOptions as aP, type RateManagerOrderField as aQ, type OrderDirection as aR, type DeploymentEnv as aS, type FulfillmentRecord as aT, type PaymentVerifiedRecord as aU, type FulfillmentAndPaymentResponse as aV, PAYMENT_PLATFORMS as aW, type PaymentPlatformType as aX, Currency as aY, currencyInfo as aZ, getCurrencyInfoFromHash as a_, type OnchainCurrency as aa, type DepositVerifierData as ab, type PreparedTransaction as ac, type OrderStats as ad, type DepositIntentStatistics as ae, type TakerTier as af, type TakerTierStats as ag, type TakerTierLevel as ah, type PlatformLimit as ai, type PlatformRiskLevel as aj, IndexerClient as ak, defaultIndexerEndpoint as al, IndexerDepositService as am, IndexerRateManagerService as an, compareEventCursorIdsByRecency as ao, fetchFulfillmentAndPayment as ap, type DepositEntity as aq, type IntentFulfilledEntity as ar, type IntentFulfillmentAmountsEntity as as, type DepositPaymentMethodEntity as at, type MethodCurrencyEntity as au, type IntentStatus as av, type RateManagerEntity as aw, type RateManagerRateEntity as ax, type RateManagerDelegationEntity as ay, type ManagerAggregateStatsEntity as az, type PostDepositDetailsResponse as b, getCurrencyCodeFromHash as b0, isSupportedCurrencyHash as b1, mapConversionRatesToOnchainMinRate as b2, type CurrencyData as b3, getContracts as b4, getRateManagerContracts as b5, getPaymentMethodsCatalog as b6, getGatingServiceAddress as b7, type RuntimeEnv as b8, parseDepositView as b9, parseIntentView as ba, enrichPvDepositView as bb, enrichPvIntentView as bc, type PV_DepositView as bd, type PV_Deposit as be, type PV_PaymentMethodData as bf, type PV_Currency as bg, type PV_ReferralFee as bh, type PV_IntentView as bi, type PV_Intent as bj, ZERO_RATE_MANAGER_ID as bk, isZeroRateManagerId as bl, normalizeRateManagerId as bm, normalizeRegistry as bn, getDelegationRoute as bo, classifyDelegationState as bp, type DelegationRoute as bq, type DelegationState as br, type DelegationDepositTarget as bs, type BatchResult as bt, type SendTransactionFn as bu, type SendBatchFn as bv, ZERO_ADDRESS as bw, asErrorMessage as bx, assertDelegationMethodSupport as by, type GetPayeeDetailsResponse as c, type GetOwnerDepositsRequest as d, type GetOwnerDepositsResponse as e, type GetTakerTierRequest as f, type GetTakerTierResponse as g, type PaymentMethodCatalog as h, type SignalIntentMethodParams as i, type CancelIntentMethodParams as j, type Zkp2pNextOptions as k, type TimeoutConfig as l, type ActionCallback as m, type CreateDepositParams as n, type CreateDepositConversionRate as o, type Range as p, type SignalIntentParams as q, type FulfillIntentParams as r, type ReleaseFundsToPayerParams as s, type CancelIntentParams as t, type GetNearbyQuote as u, type GetNearbySuggestions as v, type GetQuoteResponse as w, type GetQuoteResponseObject as x, type GetQuoteSingleResponse as y, type QuoteResponse as z };
+export { type NearbyQuote as $, type AuthorizationTokenProvider as A, type BestByPlatformResponse as B, type CurrencyType as C, type DepositWithRelations as D, type GetNearbyQuote as E, type FulfillIntentMethodParams as F, type GetPayeeDetailsRequest as G, type GetNearbySuggestions as H, type IntentEntity as I, type GetQuoteResponse as J, type GetQuoteResponseObject as K, type GetQuoteSingleResponse as L, type QuoteResponse as M, type QuoteResponseObject as N, type QuoteSingleResponse as O, type PostDepositDetailsRequest as P, type QuotesBestByPlatformRequest as Q, type ReferrerFeeConfig as R, type SignalIntentReferralFee as S, type TxOverrides as T, type QuoteIntentResponse as U, type ValidatePayeeDetailsRequest as V, type WithdrawDepositParams as W, type QuoteFeesResponse as X, type FiatResponse as Y, Zkp2pClient as Z, type TokenResponse as _, type ValidatePayeeDetailsResponse as a, type PaymentVerifiedRecord as a$, type NearbySuggestions as a0, type ApiDeposit as a1, type DepositVerifier as a2, type DepositVerifierCurrency as a3, type DepositStatus as a4, type GetDepositByIdRequest as a5, type GetDepositByIdResponse as a6, type Intent as a7, type ApiIntentStatus as a8, type GetOwnerIntentsRequest as a9, type DepositPaymentMethodEntity as aA, type MethodCurrencyEntity as aB, type IntentStatus as aC, type RateManagerEntity as aD, type RateManagerRateEntity as aE, type RateManagerDelegationEntity as aF, type ManagerAggregateStatsEntity as aG, type ManagerStatsEntity as aH, type ManagerDailySnapshotEntity as aI, type RateManagerListItem as aJ, type RateManagerDetail as aK, type ManualRateUpdateEntity as aL, type OracleConfigUpdateEntity as aM, type DepositFundActivityEntity as aN, type DepositDailySnapshotEntity as aO, type DepositFundActivityType as aP, type DepositFilter as aQ, type PaginationOptions as aR, type DepositOrderField as aS, type OrderDirection$1 as aT, type RateManagerFilter as aU, type RateManagerPaginationOptions as aV, type RateManagerDelegationPaginationOptions as aW, type RateManagerOrderField as aX, type OrderDirection as aY, type DeploymentEnv as aZ, type FulfillmentRecord as a_, 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 OnchainCurrency as ah, type DepositVerifierData as ai, type PreparedTransaction as aj, type OrderStats as ak, type DepositIntentStatistics as al, type TakerTier as am, type TakerTierStats as an, type TakerTierLevel as ao, type PlatformLimit as ap, type PlatformRiskLevel as aq, IndexerClient as ar, defaultIndexerEndpoint as as, IndexerDepositService as at, IndexerRateManagerService as au, compareEventCursorIdsByRecency as av, fetchFulfillmentAndPayment as aw, type DepositEntity as ax, type IntentFulfilledEntity as ay, type IntentFulfillmentAmountsEntity as az, type PostDepositDetailsResponse as b, type FulfillmentAndPaymentResponse as b0, PAYMENT_PLATFORMS as b1, type PaymentPlatformType as b2, Currency as b3, currencyInfo as b4, getCurrencyInfoFromHash as b5, getCurrencyInfoFromCountryCode as b6, getCurrencyCodeFromHash as b7, isSupportedCurrencyHash as b8, mapConversionRatesToOnchainMinRate as b9, type BatchResult as bA, type SendTransactionFn as bB, type SendBatchFn as bC, ZERO_ADDRESS as bD, asErrorMessage as bE, assertDelegationMethodSupport as bF, type CurrencyData as ba, getContracts as bb, getRateManagerContracts as bc, getPaymentMethodsCatalog as bd, getGatingServiceAddress as be, type RuntimeEnv as bf, parseDepositView as bg, parseIntentView as bh, enrichPvDepositView as bi, enrichPvIntentView as bj, type PV_DepositView as bk, type PV_Deposit as bl, type PV_PaymentMethodData as bm, type PV_Currency as bn, type PV_ReferralFee as bo, type PV_IntentView as bp, type PV_Intent as bq, ZERO_RATE_MANAGER_ID as br, isZeroRateManagerId as bs, normalizeRateManagerId as bt, normalizeRegistry as bu, getDelegationRoute as bv, classifyDelegationState as bw, type DelegationRoute as bx, type DelegationState as by, type DelegationDepositTarget as bz, type GetPayeeDetailsResponse as c, type GetOwnerDepositsRequest as d, type GetOwnerDepositsResponse as e, type GetTakerTierRequest as f, type GetTakerTierResponse as g, type PaymentMethodCatalog as h, type SignalIntentMethodParams as i, type CancelIntentMethodParams as j, type Zkp2pNextOptions as k, type TimeoutConfig as l, type ActionCallback as m, type CreateDepositParams as n, type CreateDepositConversionRate as o, type Range as p, type SignalIntentParams as q, type FulfillIntentParams as r, type ReleaseFundsToPayerParams as s, type CancelIntentParams as t, type BestByPlatformResponseObject as u, type GetBestByPlatformResponse as v, type GetBestByPlatformResponseObject as w, type GetPlatformQuote as x, type PlatformQuote as y, type QuoteRequest as z };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zkp2p/sdk",
-  "version": "0.2.3",
+  "version": "0.3.0",
   "description": "ZKP2P Client SDK - TypeScript SDK for deposit management, liquidity provision, and onramping",
   "license": "MIT",
   "main": "dist/index.cjs",
@@ -44,6 +44,7 @@
     "format": "prettier --check .",
     "format:write": "prettier --write .",
     "test": "vitest run",
+    "test:regression": "vitest run --config vitest.regression.config.mts",
     "test:coverage": "vitest run --coverage",
     "test:watch": "vitest",
     "release": "release-it",
@@ -86,8 +87,8 @@
     "node": ">=22"
   },
   "dependencies": {
-    "@zkp2p/indexer-schema": "0.2.2",
-    "@zkp2p/contracts-v2": "0.2.0",
+    "@zkp2p/indexer-schema": "0.2.3",
+    "@zkp2p/contracts-v2": "0.2.1",
     "ethers": "^6.0.0",
     "ox": "^0.11.1"
   },