@zkp2p/sdk 0.1.0-rc.8 → 0.1.0

package/dist/index.d.mts

@@ -1,7 +1,8 @@
-import { 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-CZKrvm9v.mjs';
-export { l as ActionCallback, B as ApiDeposit, O as ApiIntentStatus, A as AuthorizationTokenProvider, bl as BatchResult, i as CancelIntentMethodParams, r as CancelIntentParams, n as CreateDepositConversionRate, m as CreateDepositParams, aQ as Currency, aX as CurrencyData, bk as DelegationDepositTarget, bi as DelegationRoute, bj as DelegationState, b7 as Deposit, b9 as DepositCurrency, a7 as DepositIntentStatistics, J as DepositStatus, E as DepositVerifier, H as DepositVerifierCurrency, a4 as DepositVerifierData, b6 as DepositView, x as FiatResponse, F as FulfillIntentMethodParams, p as FulfillIntentParams, K as GetDepositByIdRequest, L as GetDepositByIdResponse, $ as GetIntentByHashRequest, a0 as GetIntentByHashResponse, Y as GetIntentsByDepositRequest, _ as GetIntentsByDepositResponse, U as GetOwnerIntentsRequest, X as GetOwnerIntentsResponse, b0 as HISTORICAL_ESCROW_ADDRESSES, ad as IndexerClient, aK as IndexerDeploymentEnv, ai as IndexerDeposit, az as IndexerDepositDailySnapshot, aB as IndexerDepositFilter, ay as IndexerDepositFundActivity, aA as IndexerDepositFundActivityType, aE as IndexerDepositOrderDirection, aD as IndexerDepositOrderField, aC as IndexerDepositPagination, al as IndexerDepositPaymentMethod, af as IndexerDepositService, aN as IndexerFulfillmentAndPaymentResponse, aL as IndexerFulfillmentRecord, aj as IndexerIntentFulfilled, ak as IndexerIntentFulfillmentAmounts, an as IndexerIntentStatus, ar as IndexerManagerAggregateStats, at as IndexerManagerDailySnapshot, as as IndexerManagerStats, aw as IndexerManualRateUpdate, am as IndexerMethodCurrency, ax as IndexerOracleConfigUpdate, aM as IndexerPaymentVerifiedRecord, ao as IndexerRateManager, aq as IndexerRateManagerDelegation, aH as IndexerRateManagerDelegationPagination, av as IndexerRateManagerDetail, aF as IndexerRateManagerFilter, au as IndexerRateManagerListItem, aJ as IndexerRateManagerOrderDirection, aI as IndexerRateManagerOrderField, aG as IndexerRateManagerPagination, ap as IndexerRateManagerRate, ag as IndexerRateManagerService, M as Intent, ba as IntentView, N as NearbyQuote, z as NearbySuggestions, Z as OfframpClient, a3 as OnchainCurrency, bb as OnchainIntent, a6 as OrderStats, aO as PAYMENT_PLATFORMS, b8 as PaymentMethodData, aP as PaymentPlatformType, ab as PlatformLimit, ac as PlatformRiskLevel, a5 as PreparedTransaction, w as QuoteFeesResponse, v as QuoteIntentResponse, Q as QuoteRequest, s as QuoteResponse, t as QuoteResponseObject, u as QuoteSingleResponse, R as Range, a1 as RegisterPayeeDetailsRequest, a2 as RegisterPayeeDetailsResponse, q as ReleaseFundsToPayerParams, b1 as RuntimeEnv, bn as SendBatchFn, bm as SendTransactionFn, S as SignalIntentMethodParams, o as SignalIntentParams, a8 as TakerTier, aa as TakerTierLevel, a9 as TakerTierStats, k as TimeoutConfig, y as TokenResponse, W as WithdrawDepositParams, bc as ZERO_RATE_MANAGER_ID, Z as Zkp2pClient, j as Zkp2pClientOptions, bh as classifyDelegationState, aR as currencyInfo, ae as defaultIndexerEndpoint, b4 as enrichPvDepositView, b5 as enrichPvIntentView, ah as fetchIndexerFulfillmentAndPayment, aY as getContracts, aU as getCurrencyCodeFromHash, aT as getCurrencyInfoFromCountryCode, aS as getCurrencyInfoFromHash, bg as getDelegationRoute, a$ as getGatingServiceAddress, a_ as getPaymentMethodsCatalog, aZ as getRateManagerContracts, aV as isSupportedCurrencyHash, bd as isZeroRateManagerId, aW as mapConversionRatesToOnchainMinRate, be as normalizeRateManagerId, bf as normalizeRegistry, b2 as parseDepositView, b3 as parseIntentView } from './vaultUtils-CZKrvm9v.mjs';
+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-J1WboG1T.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, aX as Currency, b2 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, b7 as HISTORICAL_ESCROW_ADDRESSES, ak as IndexerClient, aR as IndexerDeploymentEnv, ap as IndexerDeposit, aG as IndexerDepositDailySnapshot, aI as IndexerDepositFilter, aF as IndexerDepositFundActivity, aH as IndexerDepositFundActivityType, aL as IndexerDepositOrderDirection, aK as IndexerDepositOrderField, aJ as IndexerDepositPagination, as as IndexerDepositPaymentMethod, am as IndexerDepositService, aU as IndexerFulfillmentAndPaymentResponse, aS as IndexerFulfillmentRecord, aq as IndexerIntentFulfilled, ar as IndexerIntentFulfillmentAmounts, au as IndexerIntentStatus, ay as IndexerManagerAggregateStats, aA as IndexerManagerDailySnapshot, az as IndexerManagerStats, aD as IndexerManualRateUpdate, at as IndexerMethodCurrency, aE as IndexerOracleConfigUpdate, aT as IndexerPaymentVerifiedRecord, av as IndexerRateManager, ax as IndexerRateManagerDelegation, aO as IndexerRateManagerDelegationPagination, aC as IndexerRateManagerDetail, aM as IndexerRateManagerFilter, aB as IndexerRateManagerListItem, aQ as IndexerRateManagerOrderDirection, aP as IndexerRateManagerOrderField, aN as IndexerRateManagerPagination, aw 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, aV as PAYMENT_PLATFORMS, bf as PaymentMethodData, aW 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, aY as currencyInfo, al as defaultIndexerEndpoint, bb as enrichPvDepositView, bc as enrichPvIntentView, ao as fetchIndexerFulfillmentAndPayment, b3 as getContracts, a$ as getCurrencyCodeFromHash, a_ as getCurrencyInfoFromCountryCode, aZ as getCurrencyInfoFromHash, bo as getDelegationRoute, b6 as getGatingServiceAddress, b5 as getPaymentMethodsCatalog, b4 as getRateManagerContracts, b0 as isSupportedCurrencyHash, bl as isZeroRateManagerId, b1 as mapConversionRatesToOnchainMinRate, bm as normalizeRateManagerId, bn as normalizeRegistry, b9 as parseDepositView, ba as parseIntentView } from './vaultUtils-J1WboG1T.mjs';
 import { Address, Hex, WalletClient, Hash } from 'viem';
 import { Abi } from 'abitype';
+import '@zkp2p/indexer-schema';
 
 interface EscrowRange {
     min: bigint;
@@ -61,6 +62,12 @@ interface EscrowIntentView {
     deposit: EscrowDepositView;
 }
 
+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 parseReferrerFeeConfig: (recipient: string | null | undefined, feeBpsValue: string | number | null | undefined) => ReferrerFeeConfig | null;
+declare const referrerFeeConfigToPreciseUnits: (config: ReferrerFeeConfig) => bigint;
+
 interface EscrowContractContext {
     address: Address;
     abi: Abi;
@@ -130,29 +137,32 @@ declare class ContractRouter {
 }
 
 type PeerConnectionStatus = 'connected' | 'disconnected' | 'pending';
-type PeerProofCompleteStatus = 'success' | 'failure' | 'cancelled' | 'timeout';
-type PeerProofCompleteResult = {
-    intentHash: string;
-    status: PeerProofCompleteStatus;
-    proofId?: string;
-    proof?: {
-        attestation: string;
-        signature: string;
-        timestamp: number;
-        platform: string;
-    };
-    error?: {
-        code: string;
-        message: string;
+type PeerIntentFulfilledBridgeStatus = 'not_required' | 'pending';
+type PeerIntentFulfilledResult = {
+    intentHash: `0x${string}`;
+    status: 'fulfilled';
+    fulfillTxHash: `0x${string}`;
+    recipientAddress: string | null;
+    destinationToken: string | null;
+    bridge: {
+        required: boolean;
+        status: PeerIntentFulfilledBridgeStatus;
+        trackingUrl?: string | null;
+        txHashes?: Array<{
+            txHash: `0x${string}`;
+            chainId: number;
+        }>;
+        outputAmount?: string | null;
+        expectedOutputAmount?: string | null;
     };
 };
-type PeerProofCompleteCallback = (result: PeerProofCompleteResult) => void;
+type PeerIntentFulfilledCallback = (result: PeerIntentFulfilledResult) => void;
 type PeerExtensionApi = {
     requestConnection(): Promise<boolean>;
     checkConnectionStatus(): Promise<PeerConnectionStatus>;
     openSidebar(route: string): void;
     onramp(queryString: string): void;
-    onProofComplete(callback: PeerProofCompleteCallback): () => void;
+    onIntentFulfilled(callback: PeerIntentFulfilledCallback): () => void;
     getVersion(): Promise<string>;
 };
 type PeerExtensionOnrampParams = {
@@ -164,7 +174,6 @@ type PeerExtensionOnrampParams = {
     toToken?: string;
     amountUsdc?: string | number | bigint;
     recipientAddress?: string;
-    callbackUrl?: string;
     intentHash?: string;
 };
 type PeerExtensionWindow = Window & {
@@ -178,7 +187,7 @@ type PeerExtensionSdk = {
     checkConnectionStatus(): Promise<PeerConnectionStatus>;
     openSidebar(route: string): void;
     onramp(params?: PeerExtensionOnrampParams): void;
-    onProofComplete(callback: PeerProofCompleteCallback): () => void;
+    onIntentFulfilled(callback: PeerIntentFulfilledCallback): () => void;
     getVersion(): Promise<string>;
     isAvailable(): boolean;
     openInstallPage(): void;
@@ -204,20 +213,42 @@ declare function apiGetOwnerDeposits(req: GetOwnerDepositsRequest, apiKey: strin
 /**
  * Get taker tier information for a specific address.
  */
-declare function apiGetTakerTier(req: GetTakerTierRequest, apiKey: string | undefined, baseApiUrl: string, authToken?: string, timeoutMs?: number): Promise<GetTakerTierResponse>;
+declare function apiGetTakerTier(req: GetTakerTierRequest, apiKey: string | undefined, baseApiUrl: string, timeoutMs?: number): Promise<GetTakerTierResponse>;
 
+/** Minimal interface for the publicClient parameter, avoids viem version coupling. */
+interface MulticallClient {
+    multicall(args: {
+        contracts: ReadonlyArray<{
+            address: Address;
+            abi: readonly unknown[];
+            functionName: string;
+            args: readonly unknown[];
+        }>;
+        allowFailure: true;
+    }): Promise<ReadonlyArray<{
+        status: 'success' | 'failure';
+        result?: unknown;
+        error?: unknown;
+    }>>;
+}
 /**
  * Chainlink adapter currently used by V2.2 oracle floor configs.
  */
 declare const CHAINLINK_ORACLE_ADAPTER: "0xfc81d1b5841e697973af3072fc8e03af76cb39ef";
 /**
- * Pyth adapter used by V2.2 oracle floor configs.
+ * Deprecated: retained for SDK compatibility after contracts-v2 rc.12 removed
+ * Pyth feed metadata from the package.
  */
 declare const PYTH_ORACLE_ADAPTER: "0xaa2bBDa3072bD37af76613846268Ec48bd0bB885";
 /**
  * Default max staleness window for oracle-backed floors.
  */
 declare const DEFAULT_ORACLE_MAX_STALENESS_SECONDS = 86400;
+/**
+ * Deprecated: retained for SDK compatibility after contracts-v2 rc.12 removed
+ * Pyth feed metadata from the package.
+ */
+declare const PYTH_CONTRACT_BASE: "0xff1a0f4744e8582DF1aE09D5611b887B6a12925C";
 type OracleKind = 'oracle_chainlink' | 'oracle_pyth';
 type SpreadOracleFeedConfig = {
     feed: Address;
@@ -246,30 +277,38 @@ type SpreadOracleConfig = {
 };
 /**
  * Currency -> Chainlink feed mapping used for spread/floor configuration.
- *
- * Feed pairs are quoted as <FIAT>/USD, so non-USD currencies use invert=true
- * to derive fiat-per-USDC rates from USD-denominated feeds.
+ * Sourced from @zkp2p/contracts-v2/oracleFeeds/chainlink.json.
  */
 declare const CHAINLINK_ORACLE_FEEDS: Partial<Record<CurrencyType, SpreadOracleFeedConfig>>;
 /** @deprecated Use CHAINLINK_ORACLE_FEEDS instead. */
 declare const SPREAD_ORACLE_FEEDS: Partial<Record<CurrencyType, SpreadOracleFeedConfig>>;
 /**
- * Currency -> Pyth feed mapping used for spread/floor configuration.
- *
- * All Pyth FX feeds use 8 decimals.
- * - XXX/USD feeds (EUR, GBP, AUD, NZD): invert=true on-chain to derive USD/XXX.
- * - USD/XXX feeds (JPY, CAD, etc.): invert=false — already in desired direction.
- *
- * Verified active on Hermes 2026-03-03.
+ * Deprecated: contracts-v2 rc.12 no longer ships Pyth feed metadata, so this
+ * now remains empty and currencies without Chainlink feeds fall back to
+ * fixed-rate behavior.
  */
 declare const PYTH_ORACLE_FEEDS: Partial<Record<CurrencyType, PythFeedConfig>>;
 declare function encodeSpreadOracleAdapterConfig(config: SpreadOracleFeedConfig): Hex;
+/**
+ * Deprecated: retained for SDK consumers that still build custom Pyth configs.
+ */
 declare function encodePythAdapterConfig(config: PythFeedConfig): Hex;
 interface OracleAdapterOverrides {
     chainlinkOracleAdapter?: Address;
     pythOracleAdapter?: Address;
 }
 declare function getSpreadOracleConfig(currency: CurrencyType, adapters?: OracleAdapterOverrides): SpreadOracleConfig | null;
+/**
+ * Validates which oracle feeds are actually live on-chain.
+ *
+ * - Chainlink: calls `latestRoundData()` on each feed contract.
+ * - USD passthrough (zero-address Chainlink) is always included.
+ *
+ * Returns the set of CurrencyType values with working on-chain feeds.
+ * Currencies that `getSpreadOracleConfig` would resolve are only
+ * considered available if they pass this check.
+ */
+declare function validateOracleFeedsOnChain(publicClient: MulticallClient, _pythContract?: Address): Promise<Set<CurrencyType>>;
 
 /**
  * SDK Constants
@@ -451,7 +490,7 @@ declare function resolveFiatCurrencyBytes32(codeOrBytes: string): `0x${string}`;
  * with on-chain registrations.
  *
  * If the processor is not found in the catalog, falls back to the known
- * payment method hashes from @zkp2p/core before throwing an error.
+ * protocol payment method hashes before throwing an error.
  *
  * @param processorName - Payment platform name ('wise', 'revolut', etc.)
  * @param catalog - Payment method catalog from `getPaymentMethodsCatalog()`
@@ -673,4 +712,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, NetworkError, type OracleAdapterOverrides, type OracleKind, type OrchestratorContractContext, PEER_EXTENSION_CHROME_URL, PLATFORM_METADATA, PYTH_ORACLE_ADAPTER, PYTH_ORACLE_FEEDS, PaymentMethodCatalog, type PeerConnectionStatus, type PeerExtensionApi, type PeerExtensionOnrampParams, type PeerExtensionSdk, type PeerExtensionSdkOptions, type PeerExtensionState, type PeerExtensionWindow, type PeerProofCompleteCallback, type PeerProofCompleteResult, type PeerProofCompleteStatus, PostDepositDetailsRequest, PostDepositDetailsResponse, type PythFeedConfig, 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, convertDepositsForLiquidity, convertIndexerDepositToEscrowView, convertIndexerIntentsToEscrowViews, createCompositeDepositId, createPeerExtensionSdk, encodePythAdapterConfig, encodeSpreadOracleAdapterConfig, encodeWithAttribution, ensureBytes32, getAttributionDataSuffix, getPeerExtensionState, getSpreadOracleConfig, isPeerExtensionAvailable, logger, openPeerExtensionInstallPage, peerExtensionSdk, resolveFiatCurrencyBytes32, resolvePaymentMethodHash, resolvePaymentMethodHashFromCatalog, resolvePaymentMethodNameFromHash, sendTransactionWithAttribution, setLogLevel };
+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 };

package/dist/index.d.ts

@@ -1,7 +1,8 @@
-import { 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-CZKrvm9v.js';
-export { l as ActionCallback, B as ApiDeposit, O as ApiIntentStatus, A as AuthorizationTokenProvider, bl as BatchResult, i as CancelIntentMethodParams, r as CancelIntentParams, n as CreateDepositConversionRate, m as CreateDepositParams, aQ as Currency, aX as CurrencyData, bk as DelegationDepositTarget, bi as DelegationRoute, bj as DelegationState, b7 as Deposit, b9 as DepositCurrency, a7 as DepositIntentStatistics, J as DepositStatus, E as DepositVerifier, H as DepositVerifierCurrency, a4 as DepositVerifierData, b6 as DepositView, x as FiatResponse, F as FulfillIntentMethodParams, p as FulfillIntentParams, K as GetDepositByIdRequest, L as GetDepositByIdResponse, $ as GetIntentByHashRequest, a0 as GetIntentByHashResponse, Y as GetIntentsByDepositRequest, _ as GetIntentsByDepositResponse, U as GetOwnerIntentsRequest, X as GetOwnerIntentsResponse, b0 as HISTORICAL_ESCROW_ADDRESSES, ad as IndexerClient, aK as IndexerDeploymentEnv, ai as IndexerDeposit, az as IndexerDepositDailySnapshot, aB as IndexerDepositFilter, ay as IndexerDepositFundActivity, aA as IndexerDepositFundActivityType, aE as IndexerDepositOrderDirection, aD as IndexerDepositOrderField, aC as IndexerDepositPagination, al as IndexerDepositPaymentMethod, af as IndexerDepositService, aN as IndexerFulfillmentAndPaymentResponse, aL as IndexerFulfillmentRecord, aj as IndexerIntentFulfilled, ak as IndexerIntentFulfillmentAmounts, an as IndexerIntentStatus, ar as IndexerManagerAggregateStats, at as IndexerManagerDailySnapshot, as as IndexerManagerStats, aw as IndexerManualRateUpdate, am as IndexerMethodCurrency, ax as IndexerOracleConfigUpdate, aM as IndexerPaymentVerifiedRecord, ao as IndexerRateManager, aq as IndexerRateManagerDelegation, aH as IndexerRateManagerDelegationPagination, av as IndexerRateManagerDetail, aF as IndexerRateManagerFilter, au as IndexerRateManagerListItem, aJ as IndexerRateManagerOrderDirection, aI as IndexerRateManagerOrderField, aG as IndexerRateManagerPagination, ap as IndexerRateManagerRate, ag as IndexerRateManagerService, M as Intent, ba as IntentView, N as NearbyQuote, z as NearbySuggestions, Z as OfframpClient, a3 as OnchainCurrency, bb as OnchainIntent, a6 as OrderStats, aO as PAYMENT_PLATFORMS, b8 as PaymentMethodData, aP as PaymentPlatformType, ab as PlatformLimit, ac as PlatformRiskLevel, a5 as PreparedTransaction, w as QuoteFeesResponse, v as QuoteIntentResponse, Q as QuoteRequest, s as QuoteResponse, t as QuoteResponseObject, u as QuoteSingleResponse, R as Range, a1 as RegisterPayeeDetailsRequest, a2 as RegisterPayeeDetailsResponse, q as ReleaseFundsToPayerParams, b1 as RuntimeEnv, bn as SendBatchFn, bm as SendTransactionFn, S as SignalIntentMethodParams, o as SignalIntentParams, a8 as TakerTier, aa as TakerTierLevel, a9 as TakerTierStats, k as TimeoutConfig, y as TokenResponse, W as WithdrawDepositParams, bc as ZERO_RATE_MANAGER_ID, Z as Zkp2pClient, j as Zkp2pClientOptions, bh as classifyDelegationState, aR as currencyInfo, ae as defaultIndexerEndpoint, b4 as enrichPvDepositView, b5 as enrichPvIntentView, ah as fetchIndexerFulfillmentAndPayment, aY as getContracts, aU as getCurrencyCodeFromHash, aT as getCurrencyInfoFromCountryCode, aS as getCurrencyInfoFromHash, bg as getDelegationRoute, a$ as getGatingServiceAddress, a_ as getPaymentMethodsCatalog, aZ as getRateManagerContracts, aV as isSupportedCurrencyHash, bd as isZeroRateManagerId, aW as mapConversionRatesToOnchainMinRate, be as normalizeRateManagerId, bf as normalizeRegistry, b2 as parseDepositView, b3 as parseIntentView } from './vaultUtils-CZKrvm9v.js';
+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-J1WboG1T.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, aX as Currency, b2 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, b7 as HISTORICAL_ESCROW_ADDRESSES, ak as IndexerClient, aR as IndexerDeploymentEnv, ap as IndexerDeposit, aG as IndexerDepositDailySnapshot, aI as IndexerDepositFilter, aF as IndexerDepositFundActivity, aH as IndexerDepositFundActivityType, aL as IndexerDepositOrderDirection, aK as IndexerDepositOrderField, aJ as IndexerDepositPagination, as as IndexerDepositPaymentMethod, am as IndexerDepositService, aU as IndexerFulfillmentAndPaymentResponse, aS as IndexerFulfillmentRecord, aq as IndexerIntentFulfilled, ar as IndexerIntentFulfillmentAmounts, au as IndexerIntentStatus, ay as IndexerManagerAggregateStats, aA as IndexerManagerDailySnapshot, az as IndexerManagerStats, aD as IndexerManualRateUpdate, at as IndexerMethodCurrency, aE as IndexerOracleConfigUpdate, aT as IndexerPaymentVerifiedRecord, av as IndexerRateManager, ax as IndexerRateManagerDelegation, aO as IndexerRateManagerDelegationPagination, aC as IndexerRateManagerDetail, aM as IndexerRateManagerFilter, aB as IndexerRateManagerListItem, aQ as IndexerRateManagerOrderDirection, aP as IndexerRateManagerOrderField, aN as IndexerRateManagerPagination, aw 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, aV as PAYMENT_PLATFORMS, bf as PaymentMethodData, aW 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, aY as currencyInfo, al as defaultIndexerEndpoint, bb as enrichPvDepositView, bc as enrichPvIntentView, ao as fetchIndexerFulfillmentAndPayment, b3 as getContracts, a$ as getCurrencyCodeFromHash, a_ as getCurrencyInfoFromCountryCode, aZ as getCurrencyInfoFromHash, bo as getDelegationRoute, b6 as getGatingServiceAddress, b5 as getPaymentMethodsCatalog, b4 as getRateManagerContracts, b0 as isSupportedCurrencyHash, bl as isZeroRateManagerId, b1 as mapConversionRatesToOnchainMinRate, bm as normalizeRateManagerId, bn as normalizeRegistry, b9 as parseDepositView, ba as parseIntentView } from './vaultUtils-J1WboG1T.js';
 import { Address, Hex, WalletClient, Hash } from 'viem';
 import { Abi } from 'abitype';
+import '@zkp2p/indexer-schema';
 
 interface EscrowRange {
     min: bigint;
@@ -61,6 +62,12 @@ interface EscrowIntentView {
     deposit: EscrowDepositView;
 }
 
+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 parseReferrerFeeConfig: (recipient: string | null | undefined, feeBpsValue: string | number | null | undefined) => ReferrerFeeConfig | null;
+declare const referrerFeeConfigToPreciseUnits: (config: ReferrerFeeConfig) => bigint;
+
 interface EscrowContractContext {
     address: Address;
     abi: Abi;
@@ -130,29 +137,32 @@ declare class ContractRouter {
 }
 
 type PeerConnectionStatus = 'connected' | 'disconnected' | 'pending';
-type PeerProofCompleteStatus = 'success' | 'failure' | 'cancelled' | 'timeout';
-type PeerProofCompleteResult = {
-    intentHash: string;
-    status: PeerProofCompleteStatus;
-    proofId?: string;
-    proof?: {
-        attestation: string;
-        signature: string;
-        timestamp: number;
-        platform: string;
-    };
-    error?: {
-        code: string;
-        message: string;
+type PeerIntentFulfilledBridgeStatus = 'not_required' | 'pending';
+type PeerIntentFulfilledResult = {
+    intentHash: `0x${string}`;
+    status: 'fulfilled';
+    fulfillTxHash: `0x${string}`;
+    recipientAddress: string | null;
+    destinationToken: string | null;
+    bridge: {
+        required: boolean;
+        status: PeerIntentFulfilledBridgeStatus;
+        trackingUrl?: string | null;
+        txHashes?: Array<{
+            txHash: `0x${string}`;
+            chainId: number;
+        }>;
+        outputAmount?: string | null;
+        expectedOutputAmount?: string | null;
     };
 };
-type PeerProofCompleteCallback = (result: PeerProofCompleteResult) => void;
+type PeerIntentFulfilledCallback = (result: PeerIntentFulfilledResult) => void;
 type PeerExtensionApi = {
     requestConnection(): Promise<boolean>;
     checkConnectionStatus(): Promise<PeerConnectionStatus>;
     openSidebar(route: string): void;
     onramp(queryString: string): void;
-    onProofComplete(callback: PeerProofCompleteCallback): () => void;
+    onIntentFulfilled(callback: PeerIntentFulfilledCallback): () => void;
     getVersion(): Promise<string>;
 };
 type PeerExtensionOnrampParams = {
@@ -164,7 +174,6 @@ type PeerExtensionOnrampParams = {
     toToken?: string;
     amountUsdc?: string | number | bigint;
     recipientAddress?: string;
-    callbackUrl?: string;
     intentHash?: string;
 };
 type PeerExtensionWindow = Window & {
@@ -178,7 +187,7 @@ type PeerExtensionSdk = {
     checkConnectionStatus(): Promise<PeerConnectionStatus>;
     openSidebar(route: string): void;
     onramp(params?: PeerExtensionOnrampParams): void;
-    onProofComplete(callback: PeerProofCompleteCallback): () => void;
+    onIntentFulfilled(callback: PeerIntentFulfilledCallback): () => void;
     getVersion(): Promise<string>;
     isAvailable(): boolean;
     openInstallPage(): void;
@@ -204,20 +213,42 @@ declare function apiGetOwnerDeposits(req: GetOwnerDepositsRequest, apiKey: strin
 /**
  * Get taker tier information for a specific address.
  */
-declare function apiGetTakerTier(req: GetTakerTierRequest, apiKey: string | undefined, baseApiUrl: string, authToken?: string, timeoutMs?: number): Promise<GetTakerTierResponse>;
+declare function apiGetTakerTier(req: GetTakerTierRequest, apiKey: string | undefined, baseApiUrl: string, timeoutMs?: number): Promise<GetTakerTierResponse>;
 
+/** Minimal interface for the publicClient parameter, avoids viem version coupling. */
+interface MulticallClient {
+    multicall(args: {
+        contracts: ReadonlyArray<{
+            address: Address;
+            abi: readonly unknown[];
+            functionName: string;
+            args: readonly unknown[];
+        }>;
+        allowFailure: true;
+    }): Promise<ReadonlyArray<{
+        status: 'success' | 'failure';
+        result?: unknown;
+        error?: unknown;
+    }>>;
+}
 /**
  * Chainlink adapter currently used by V2.2 oracle floor configs.
  */
 declare const CHAINLINK_ORACLE_ADAPTER: "0xfc81d1b5841e697973af3072fc8e03af76cb39ef";
 /**
- * Pyth adapter used by V2.2 oracle floor configs.
+ * Deprecated: retained for SDK compatibility after contracts-v2 rc.12 removed
+ * Pyth feed metadata from the package.
  */
 declare const PYTH_ORACLE_ADAPTER: "0xaa2bBDa3072bD37af76613846268Ec48bd0bB885";
 /**
  * Default max staleness window for oracle-backed floors.
  */
 declare const DEFAULT_ORACLE_MAX_STALENESS_SECONDS = 86400;
+/**
+ * Deprecated: retained for SDK compatibility after contracts-v2 rc.12 removed
+ * Pyth feed metadata from the package.
+ */
+declare const PYTH_CONTRACT_BASE: "0xff1a0f4744e8582DF1aE09D5611b887B6a12925C";
 type OracleKind = 'oracle_chainlink' | 'oracle_pyth';
 type SpreadOracleFeedConfig = {
     feed: Address;
@@ -246,30 +277,38 @@ type SpreadOracleConfig = {
 };
 /**
  * Currency -> Chainlink feed mapping used for spread/floor configuration.
- *
- * Feed pairs are quoted as <FIAT>/USD, so non-USD currencies use invert=true
- * to derive fiat-per-USDC rates from USD-denominated feeds.
+ * Sourced from @zkp2p/contracts-v2/oracleFeeds/chainlink.json.
  */
 declare const CHAINLINK_ORACLE_FEEDS: Partial<Record<CurrencyType, SpreadOracleFeedConfig>>;
 /** @deprecated Use CHAINLINK_ORACLE_FEEDS instead. */
 declare const SPREAD_ORACLE_FEEDS: Partial<Record<CurrencyType, SpreadOracleFeedConfig>>;
 /**
- * Currency -> Pyth feed mapping used for spread/floor configuration.
- *
- * All Pyth FX feeds use 8 decimals.
- * - XXX/USD feeds (EUR, GBP, AUD, NZD): invert=true on-chain to derive USD/XXX.
- * - USD/XXX feeds (JPY, CAD, etc.): invert=false — already in desired direction.
- *
- * Verified active on Hermes 2026-03-03.
+ * Deprecated: contracts-v2 rc.12 no longer ships Pyth feed metadata, so this
+ * now remains empty and currencies without Chainlink feeds fall back to
+ * fixed-rate behavior.
  */
 declare const PYTH_ORACLE_FEEDS: Partial<Record<CurrencyType, PythFeedConfig>>;
 declare function encodeSpreadOracleAdapterConfig(config: SpreadOracleFeedConfig): Hex;
+/**
+ * Deprecated: retained for SDK consumers that still build custom Pyth configs.
+ */
 declare function encodePythAdapterConfig(config: PythFeedConfig): Hex;
 interface OracleAdapterOverrides {
     chainlinkOracleAdapter?: Address;
     pythOracleAdapter?: Address;
 }
 declare function getSpreadOracleConfig(currency: CurrencyType, adapters?: OracleAdapterOverrides): SpreadOracleConfig | null;
+/**
+ * Validates which oracle feeds are actually live on-chain.
+ *
+ * - Chainlink: calls `latestRoundData()` on each feed contract.
+ * - USD passthrough (zero-address Chainlink) is always included.
+ *
+ * Returns the set of CurrencyType values with working on-chain feeds.
+ * Currencies that `getSpreadOracleConfig` would resolve are only
+ * considered available if they pass this check.
+ */
+declare function validateOracleFeedsOnChain(publicClient: MulticallClient, _pythContract?: Address): Promise<Set<CurrencyType>>;
 
 /**
  * SDK Constants
@@ -451,7 +490,7 @@ declare function resolveFiatCurrencyBytes32(codeOrBytes: string): `0x${string}`;
  * with on-chain registrations.
  *
  * If the processor is not found in the catalog, falls back to the known
- * payment method hashes from @zkp2p/core before throwing an error.
+ * protocol payment method hashes before throwing an error.
  *
  * @param processorName - Payment platform name ('wise', 'revolut', etc.)
  * @param catalog - Payment method catalog from `getPaymentMethodsCatalog()`
@@ -673,4 +712,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, NetworkError, type OracleAdapterOverrides, type OracleKind, type OrchestratorContractContext, PEER_EXTENSION_CHROME_URL, PLATFORM_METADATA, PYTH_ORACLE_ADAPTER, PYTH_ORACLE_FEEDS, PaymentMethodCatalog, type PeerConnectionStatus, type PeerExtensionApi, type PeerExtensionOnrampParams, type PeerExtensionSdk, type PeerExtensionSdkOptions, type PeerExtensionState, type PeerExtensionWindow, type PeerProofCompleteCallback, type PeerProofCompleteResult, type PeerProofCompleteStatus, PostDepositDetailsRequest, PostDepositDetailsResponse, type PythFeedConfig, 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, convertDepositsForLiquidity, convertIndexerDepositToEscrowView, convertIndexerIntentsToEscrowViews, createCompositeDepositId, createPeerExtensionSdk, encodePythAdapterConfig, encodeSpreadOracleAdapterConfig, encodeWithAttribution, ensureBytes32, getAttributionDataSuffix, getPeerExtensionState, getSpreadOracleConfig, isPeerExtensionAvailable, logger, openPeerExtensionInstallPage, peerExtensionSdk, resolveFiatCurrencyBytes32, resolvePaymentMethodHash, resolvePaymentMethodHashFromCatalog, resolvePaymentMethodNameFromHash, sendTransactionWithAttribution, setLogLevel };
+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 };