@usdctofiat/offramp 3.0.3 → 4.0.0

package/dist/index.d.cts

@@ -1,7 +1,8 @@
 import { WalletClient } from 'viem';
-import { f as OfframpParams, n as OnProgress, j as OfframpResult, c as OfframpCreateOptions, i as OfframpQuoteInput, h as OfframpQuote, m as OfframpVaultStatus, r as PlatformEntry, a as CurrencyEntry, D as DepositInfo } from './errors-D9bV_DWE.cjs';
-export { C as CURRENCIES, b as DepositStatus, M as MakersCreateError, O as OFFRAMP_ERROR_CODES, d as OfframpError, e as OfframpErrorCode, g as OfframpProgress, k as OfframpState, l as OfframpStep, P as PLATFORMS, o as PLATFORM_LIMITS, p as PayeeDepositData, q as PeerExtensionRegistrationInfo, s as PlatformKey, t as PlatformLimits, u as PlatformTier, v as getPeerExtensionRegistrationInfo, w as getPlatformLimits, x as isPeerExtensionRegistrationError, y as isValidIBAN, z as normalizePaypalMeUsername } from './errors-D9bV_DWE.cjs';
-export { PEER_EXTENSION_CHROME_URL, PeerConnectionStatus, PeerExtensionApi, PeerExtensionOnrampParams, PeerExtensionSdk, PeerExtensionSdkOptions, PeerExtensionState, PeerExtensionWindow, PeerOnrampPreparedTransactionCallback, PeerOnrampPreparedTransactionResult, createPeerExtensionSdk, getPeerExtensionState, isPeerExtensionAvailable, openPeerExtensionInstallPage, peerExtensionSdk } from '@zkp2p/sdk';
+import { h as OfframpParams, p as OnProgress, l as OfframpResult, e as OfframpCreateOptions, k as OfframpQuoteInput, j as OfframpQuote, o as OfframpVaultStatus, t as PlatformEntry, c as CurrencyEntry, D as DepositInfo } from './errors-DYCRKcnY.cjs';
+export { C as CURRENCIES, a as CompletePeerExtensionRegistrationInput, b as CompletePeerExtensionRegistrationResult, d as DepositStatus, M as MakersCreateError, O as OFFRAMP_ERROR_CODES, f as OfframpError, g as OfframpErrorCode, i as OfframpProgress, m as OfframpState, n as OfframpStep, P as PLATFORMS, q as PLATFORM_LIMITS, r as PayeeDepositData, s as PeerExtensionRegistrationInfo, u as PlatformKey, v as PlatformLimits, w as PlatformTier, x as completePeerExtensionRegistration, y as getPeerExtensionRegistrationAuthParams, z as getPeerExtensionRegistrationInfo, A as getPlatformLimits, B as isPeerExtensionRegistrationError, E as isValidIBAN, F as normalizePaypalMeUsername } from './errors-DYCRKcnY.cjs';
+import { PeerConnectionStatus, PeerAuthenticateParams, PeerMetadataMessageCallback, SellerCredentialBundle } from '@zkp2p/sdk';
+export { PEER_EXTENSION_CHROME_URL, PeerAuthenticateParams, PeerBuyerTeePaymentCapture, PeerBuyerTeePaymentParams, PeerConnectionStatus, PeerMetadataCaptureMode, PeerMetadataMessage, PeerMetadataMessageCallback, PeerMetadataProviderConfig, PeerMetadataRow, PeerSarCredentialCapture } from '@zkp2p/sdk';
 
 type TelemetryEventName = "sdk.init" | "sdk.createDeposit.start" | "sdk.createDeposit.progress" | "sdk.createDeposit.success" | "sdk.createDeposit.error";
 interface TelemetryContext {
@@ -22,13 +23,73 @@ declare function emitEvent(name: TelemetryEventName, payload?: Record<string, un
 declare function sendTelemetryEvent(name: TelemetryEventName, payload?: Record<string, unknown>): void;
 declare function createTelemetryContext(options: CreateTelemetryContextOptions): TelemetryContext;
 
+/**
+ * Peer browser-extension surface for PayPal + Wise makers. Drive the
+ * headless metadata bridge via `usePeerExtensionRegistration` in
+ * `@usdctofiat/offramp/react`, or manually:
+ *
+ * ```ts
+ * import {
+ *   completePeerExtensionRegistration,
+ *   isPeerExtensionMetadataBridgeAvailable,
+ *   peerExtensionSdk,
+ * } from "@usdctofiat/offramp";
+ *
+ * const state = await peerExtensionSdk.getState();
+ * if (state === "needs_install" || !isPeerExtensionMetadataBridgeAvailable()) {
+ *   peerExtensionSdk.openInstallPage();
+ * } else if (state === "needs_connection") {
+ *   await peerExtensionSdk.requestConnection();
+ * } else {
+ *   peerExtensionSdk.authenticate({
+ *     actionType: "transfer_paypal",
+ *     captureMode: "sellerCredential",
+ *     platform: "paypal",
+ *   });
+ *   // Pass the captured metadata to completePeerExtensionRegistration(...), then retry.
+ * }
+ * ```
+ */
+
+type PeerSarCredentialBundle = SellerCredentialBundle;
+type PeerExtensionApi = {
+    requestConnection(): Promise<boolean>;
+    checkConnectionStatus(): Promise<PeerConnectionStatus>;
+    getVersion(): Promise<string>;
+    authenticate?: (params: PeerAuthenticateParams) => void;
+    onMetadataMessage?: (callback: PeerMetadataMessageCallback) => () => void;
+};
+type PeerExtensionWindow = Window & {
+    peer?: PeerExtensionApi;
+};
+type PeerExtensionSdkOptions = {
+    window?: PeerExtensionWindow;
+};
+type PeerExtensionSdk = {
+    requestConnection(): Promise<boolean>;
+    checkConnectionStatus(): Promise<PeerConnectionStatus>;
+    getVersion(): Promise<string>;
+    authenticate(params: PeerAuthenticateParams): void;
+    onMetadataMessage(callback: PeerMetadataMessageCallback): () => void;
+    isAvailable(): boolean;
+    openInstallPage(): void;
+    getState(): Promise<PeerExtensionState>;
+};
+type PeerExtensionState = "needs_install" | "needs_connection" | "ready";
+declare const isPeerExtensionAvailable: (options?: PeerExtensionSdkOptions) => boolean;
+declare const isPeerExtensionMetadataBridgeAvailable: (options?: PeerExtensionSdkOptions) => boolean;
+declare const openPeerExtensionInstallPage: (options?: PeerExtensionSdkOptions) => void;
+declare const getPeerExtensionState: (options?: PeerExtensionSdkOptions) => Promise<PeerExtensionState>;
+declare const createPeerExtensionSdk: (options?: PeerExtensionSdkOptions) => PeerExtensionSdk;
+declare const peerExtensionSdk: PeerExtensionSdk;
+
 /**
  * Create a USDC-to-fiat offramp deposit and delegate it to the vault.
  *
  * **Resumable**: if an existing undelegated deposit is found for this wallet,
  * the flow skips directly to delegation instead of creating a new deposit.
  */
-declare function offramp(walletClient: WalletClient, params: OfframpParams, onProgress?: OnProgress, telemetryContext?: TelemetryContext): Promise<OfframpResult>;
+declare function offramp(walletClient: WalletClient, params: OfframpParams, onProgress?: OnProgress, telemetryContext?: TelemetryContext, apiBaseUrl?: string): Promise<OfframpResult>;
 
 interface OfframpConstructorOptions extends OfframpCreateOptions {
     walletClient: WalletClient;
@@ -36,6 +97,7 @@ interface OfframpConstructorOptions extends OfframpCreateOptions {
 declare class Offramp {
     private readonly walletClient;
     private readonly telemetry;
+    private readonly apiBaseUrl?;
     constructor(options: OfframpConstructorOptions);
     createDeposit(params: OfframpParams, onProgress?: OnProgress): Promise<OfframpResult>;
     getQuote(input: OfframpQuoteInput): OfframpQuote;
@@ -82,7 +144,10 @@ interface EnableOtcResult {
  * Make a deposit private so only one taker wallet can trade against it.
  *
  * Sets the WhitelistPreIntentHook on the deposit and whitelists the taker.
- * If the deposit already has a different taker whitelisted, replaces it.
+ * The hook stores its whitelist as a membership-only mapping with no
+ * enumeration, so a taker that was previously whitelisted is NOT removed when
+ * a new one is added — both stay whitelisted. To switch to a single new taker,
+ * remove the prior one explicitly (or `disableOtc` first) before calling this.
  *
  * @param walletClient - viem WalletClient with the deposit owner's account
  * @param depositId - The numeric deposit ID (from `OfframpResult.depositId`)
@@ -106,4 +171,4 @@ declare function disableOtc(walletClient: WalletClient, depositId: string, escro
  */
 declare function getOtcLink(depositId: string, escrowAddress?: string): string;
 
-export { CurrencyEntry, DepositInfo, ESCROW_ADDRESS, type EnableOtcResult, Offramp, OfframpCreateOptions, OfframpParams, OfframpQuote, OfframpQuoteInput, OfframpResult, OfframpVaultStatus, OnProgress, PlatformEntry, close, createOfframp, createTelemetryContext, delegate, deposits, disableOtc, emitEvent, enableOtc, getOtcLink, offramp, sanitizeAttributionId, sendTelemetryEvent, undelegate };
+export { CurrencyEntry, DepositInfo, ESCROW_ADDRESS, type EnableOtcResult, Offramp, OfframpCreateOptions, OfframpParams, OfframpQuote, OfframpQuoteInput, OfframpResult, OfframpVaultStatus, OnProgress, type PeerExtensionApi, type PeerExtensionSdk, type PeerExtensionSdkOptions, type PeerExtensionState, type PeerExtensionWindow, type PeerSarCredentialBundle, PlatformEntry, close, createOfframp, createPeerExtensionSdk, createTelemetryContext, delegate, deposits, disableOtc, emitEvent, enableOtc, getOtcLink, getPeerExtensionState, isPeerExtensionAvailable, isPeerExtensionMetadataBridgeAvailable, offramp, openPeerExtensionInstallPage, peerExtensionSdk, sanitizeAttributionId, sendTelemetryEvent, undelegate };

package/dist/index.d.ts

@@ -1,7 +1,8 @@
 import { WalletClient } from 'viem';
-import { f as OfframpParams, n as OnProgress, j as OfframpResult, c as OfframpCreateOptions, i as OfframpQuoteInput, h as OfframpQuote, m as OfframpVaultStatus, r as PlatformEntry, a as CurrencyEntry, D as DepositInfo } from './errors-D9bV_DWE.js';
-export { C as CURRENCIES, b as DepositStatus, M as MakersCreateError, O as OFFRAMP_ERROR_CODES, d as OfframpError, e as OfframpErrorCode, g as OfframpProgress, k as OfframpState, l as OfframpStep, P as PLATFORMS, o as PLATFORM_LIMITS, p as PayeeDepositData, q as PeerExtensionRegistrationInfo, s as PlatformKey, t as PlatformLimits, u as PlatformTier, v as getPeerExtensionRegistrationInfo, w as getPlatformLimits, x as isPeerExtensionRegistrationError, y as isValidIBAN, z as normalizePaypalMeUsername } from './errors-D9bV_DWE.js';
-export { PEER_EXTENSION_CHROME_URL, PeerConnectionStatus, PeerExtensionApi, PeerExtensionOnrampParams, PeerExtensionSdk, PeerExtensionSdkOptions, PeerExtensionState, PeerExtensionWindow, PeerOnrampPreparedTransactionCallback, PeerOnrampPreparedTransactionResult, createPeerExtensionSdk, getPeerExtensionState, isPeerExtensionAvailable, openPeerExtensionInstallPage, peerExtensionSdk } from '@zkp2p/sdk';
+import { h as OfframpParams, p as OnProgress, l as OfframpResult, e as OfframpCreateOptions, k as OfframpQuoteInput, j as OfframpQuote, o as OfframpVaultStatus, t as PlatformEntry, c as CurrencyEntry, D as DepositInfo } from './errors-DYCRKcnY.js';
+export { C as CURRENCIES, a as CompletePeerExtensionRegistrationInput, b as CompletePeerExtensionRegistrationResult, d as DepositStatus, M as MakersCreateError, O as OFFRAMP_ERROR_CODES, f as OfframpError, g as OfframpErrorCode, i as OfframpProgress, m as OfframpState, n as OfframpStep, P as PLATFORMS, q as PLATFORM_LIMITS, r as PayeeDepositData, s as PeerExtensionRegistrationInfo, u as PlatformKey, v as PlatformLimits, w as PlatformTier, x as completePeerExtensionRegistration, y as getPeerExtensionRegistrationAuthParams, z as getPeerExtensionRegistrationInfo, A as getPlatformLimits, B as isPeerExtensionRegistrationError, E as isValidIBAN, F as normalizePaypalMeUsername } from './errors-DYCRKcnY.js';
+import { PeerConnectionStatus, PeerAuthenticateParams, PeerMetadataMessageCallback, SellerCredentialBundle } from '@zkp2p/sdk';
+export { PEER_EXTENSION_CHROME_URL, PeerAuthenticateParams, PeerBuyerTeePaymentCapture, PeerBuyerTeePaymentParams, PeerConnectionStatus, PeerMetadataCaptureMode, PeerMetadataMessage, PeerMetadataMessageCallback, PeerMetadataProviderConfig, PeerMetadataRow, PeerSarCredentialCapture } from '@zkp2p/sdk';
 
 type TelemetryEventName = "sdk.init" | "sdk.createDeposit.start" | "sdk.createDeposit.progress" | "sdk.createDeposit.success" | "sdk.createDeposit.error";
 interface TelemetryContext {
@@ -22,13 +23,73 @@ declare function emitEvent(name: TelemetryEventName, payload?: Record<string, un
 declare function sendTelemetryEvent(name: TelemetryEventName, payload?: Record<string, unknown>): void;
 declare function createTelemetryContext(options: CreateTelemetryContextOptions): TelemetryContext;
 
+/**
+ * Peer browser-extension surface for PayPal + Wise makers. Drive the
+ * headless metadata bridge via `usePeerExtensionRegistration` in
+ * `@usdctofiat/offramp/react`, or manually:
+ *
+ * ```ts
+ * import {
+ *   completePeerExtensionRegistration,
+ *   isPeerExtensionMetadataBridgeAvailable,
+ *   peerExtensionSdk,
+ * } from "@usdctofiat/offramp";
+ *
+ * const state = await peerExtensionSdk.getState();
+ * if (state === "needs_install" || !isPeerExtensionMetadataBridgeAvailable()) {
+ *   peerExtensionSdk.openInstallPage();
+ * } else if (state === "needs_connection") {
+ *   await peerExtensionSdk.requestConnection();
+ * } else {
+ *   peerExtensionSdk.authenticate({
+ *     actionType: "transfer_paypal",
+ *     captureMode: "sellerCredential",
+ *     platform: "paypal",
+ *   });
+ *   // Pass the captured metadata to completePeerExtensionRegistration(...), then retry.
+ * }
+ * ```
+ */
+
+type PeerSarCredentialBundle = SellerCredentialBundle;
+type PeerExtensionApi = {
+    requestConnection(): Promise<boolean>;
+    checkConnectionStatus(): Promise<PeerConnectionStatus>;
+    getVersion(): Promise<string>;
+    authenticate?: (params: PeerAuthenticateParams) => void;
+    onMetadataMessage?: (callback: PeerMetadataMessageCallback) => () => void;
+};
+type PeerExtensionWindow = Window & {
+    peer?: PeerExtensionApi;
+};
+type PeerExtensionSdkOptions = {
+    window?: PeerExtensionWindow;
+};
+type PeerExtensionSdk = {
+    requestConnection(): Promise<boolean>;
+    checkConnectionStatus(): Promise<PeerConnectionStatus>;
+    getVersion(): Promise<string>;
+    authenticate(params: PeerAuthenticateParams): void;
+    onMetadataMessage(callback: PeerMetadataMessageCallback): () => void;
+    isAvailable(): boolean;
+    openInstallPage(): void;
+    getState(): Promise<PeerExtensionState>;
+};
+type PeerExtensionState = "needs_install" | "needs_connection" | "ready";
+declare const isPeerExtensionAvailable: (options?: PeerExtensionSdkOptions) => boolean;
+declare const isPeerExtensionMetadataBridgeAvailable: (options?: PeerExtensionSdkOptions) => boolean;
+declare const openPeerExtensionInstallPage: (options?: PeerExtensionSdkOptions) => void;
+declare const getPeerExtensionState: (options?: PeerExtensionSdkOptions) => Promise<PeerExtensionState>;
+declare const createPeerExtensionSdk: (options?: PeerExtensionSdkOptions) => PeerExtensionSdk;
+declare const peerExtensionSdk: PeerExtensionSdk;
+
 /**
  * Create a USDC-to-fiat offramp deposit and delegate it to the vault.
  *
  * **Resumable**: if an existing undelegated deposit is found for this wallet,
  * the flow skips directly to delegation instead of creating a new deposit.
  */
-declare function offramp(walletClient: WalletClient, params: OfframpParams, onProgress?: OnProgress, telemetryContext?: TelemetryContext): Promise<OfframpResult>;
+declare function offramp(walletClient: WalletClient, params: OfframpParams, onProgress?: OnProgress, telemetryContext?: TelemetryContext, apiBaseUrl?: string): Promise<OfframpResult>;
 
 interface OfframpConstructorOptions extends OfframpCreateOptions {
     walletClient: WalletClient;
@@ -36,6 +97,7 @@ interface OfframpConstructorOptions extends OfframpCreateOptions {
 declare class Offramp {
     private readonly walletClient;
     private readonly telemetry;
+    private readonly apiBaseUrl?;
     constructor(options: OfframpConstructorOptions);
     createDeposit(params: OfframpParams, onProgress?: OnProgress): Promise<OfframpResult>;
     getQuote(input: OfframpQuoteInput): OfframpQuote;
@@ -82,7 +144,10 @@ interface EnableOtcResult {
  * Make a deposit private so only one taker wallet can trade against it.
  *
  * Sets the WhitelistPreIntentHook on the deposit and whitelists the taker.
- * If the deposit already has a different taker whitelisted, replaces it.
+ * The hook stores its whitelist as a membership-only mapping with no
+ * enumeration, so a taker that was previously whitelisted is NOT removed when
+ * a new one is added — both stay whitelisted. To switch to a single new taker,
+ * remove the prior one explicitly (or `disableOtc` first) before calling this.
  *
  * @param walletClient - viem WalletClient with the deposit owner's account
  * @param depositId - The numeric deposit ID (from `OfframpResult.depositId`)
@@ -106,4 +171,4 @@ declare function disableOtc(walletClient: WalletClient, depositId: string, escro
  */
 declare function getOtcLink(depositId: string, escrowAddress?: string): string;
 
-export { CurrencyEntry, DepositInfo, ESCROW_ADDRESS, type EnableOtcResult, Offramp, OfframpCreateOptions, OfframpParams, OfframpQuote, OfframpQuoteInput, OfframpResult, OfframpVaultStatus, OnProgress, PlatformEntry, close, createOfframp, createTelemetryContext, delegate, deposits, disableOtc, emitEvent, enableOtc, getOtcLink, offramp, sanitizeAttributionId, sendTelemetryEvent, undelegate };
+export { CurrencyEntry, DepositInfo, ESCROW_ADDRESS, type EnableOtcResult, Offramp, OfframpCreateOptions, OfframpParams, OfframpQuote, OfframpQuoteInput, OfframpResult, OfframpVaultStatus, OnProgress, type PeerExtensionApi, type PeerExtensionSdk, type PeerExtensionSdkOptions, type PeerExtensionState, type PeerExtensionWindow, type PeerSarCredentialBundle, PlatformEntry, close, createOfframp, createPeerExtensionSdk, createTelemetryContext, delegate, deposits, disableOtc, emitEvent, enableOtc, getOtcLink, getPeerExtensionState, isPeerExtensionAvailable, isPeerExtensionMetadataBridgeAvailable, offramp, openPeerExtensionInstallPage, peerExtensionSdk, sanitizeAttributionId, sendTelemetryEvent, undelegate };

package/dist/index.js

@@ -8,6 +8,7 @@ import {
   PLATFORMS,
   PLATFORM_LIMITS,
   close,
+  completePeerExtensionRegistration,
   createOfframp,
   createPeerExtensionSdk,
   createTelemetryContext,
@@ -17,10 +18,12 @@ import {
   emitEvent,
   enableOtc,
   getOtcLink,
+  getPeerExtensionRegistrationAuthParams,
   getPeerExtensionRegistrationInfo,
   getPeerExtensionState,
   getPlatformLimits,
   isPeerExtensionAvailable,
+  isPeerExtensionMetadataBridgeAvailable,
   isPeerExtensionRegistrationError,
   isValidIBAN,
   normalizePaypalMeUsername,
@@ -30,7 +33,7 @@ import {
   sanitizeAttributionId,
   sendTelemetryEvent,
   undelegate
-} from "./chunk-4KKKDDES.js";
+} from "./chunk-QMO7HTBZ.js";
 
 // src/types.ts
 var OFFRAMP_ERROR_CODES = {
@@ -42,8 +45,8 @@ var OFFRAMP_ERROR_CODES = {
    * handle in the Peer extension yet. Thrown from `offramp()` for PayPal
    * and Wise when `/v2/makers/create` returns 400 or a "creating the maker"
    * message. Recover by prompting the user through the Peer extension via
-   * `usePeerExtensionRegistration(platform)` (React) or `peerExtensionSdk`
-   * directly, then call `offramp()` again.
+   * `usePeerExtensionRegistration(platform)` (React) or
+   * `completePeerExtensionRegistration(...)`, then retrying `offramp()`.
    */
   EXTENSION_REGISTRATION_REQUIRED: "EXTENSION_REGISTRATION_REQUIRED",
   DEPOSIT_FAILED: "DEPOSIT_FAILED",
@@ -63,6 +66,7 @@ export {
   PLATFORMS,
   PLATFORM_LIMITS,
   close,
+  completePeerExtensionRegistration,
   createOfframp,
   createPeerExtensionSdk,
   createTelemetryContext,
@@ -72,10 +76,12 @@ export {
   emitEvent,
   enableOtc,
   getOtcLink,
+  getPeerExtensionRegistrationAuthParams,
   getPeerExtensionRegistrationInfo,
   getPeerExtensionState,
   getPlatformLimits,
   isPeerExtensionAvailable,
+  isPeerExtensionMetadataBridgeAvailable,
   isPeerExtensionRegistrationError,
   isValidIBAN,
   normalizePaypalMeUsername,

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/types.ts"],"sourcesContent":["import type { PlatformEntry } from \"./platforms\";\nimport type { CurrencyEntry } from \"./currencies\";\n\nexport const OFFRAMP_ERROR_CODES = {\n  VALIDATION: \"VALIDATION\",\n  APPROVAL_FAILED: \"APPROVAL_FAILED\",\n  REGISTRATION_FAILED: \"REGISTRATION_FAILED\",\n  /**\n   * Curator rejected the maker because the user has not registered this\n   * handle in the Peer extension yet. Thrown from `offramp()` for PayPal\n   * and Wise when `/v2/makers/create` returns 400 or a \"creating the maker\"\n   * message. Recover by prompting the user through the Peer extension via\n   * `usePeerExtensionRegistration(platform)` (React) or `peerExtensionSdk`\n   * directly, then call `offramp()` again.\n   */\n  EXTENSION_REGISTRATION_REQUIRED: \"EXTENSION_REGISTRATION_REQUIRED\",\n  DEPOSIT_FAILED: \"DEPOSIT_FAILED\",\n  CONFIRMATION_FAILED: \"CONFIRMATION_FAILED\",\n  DELEGATION_FAILED: \"DELEGATION_FAILED\",\n  USER_CANCELLED: \"USER_CANCELLED\",\n  UNSUPPORTED: \"UNSUPPORTED\",\n} as const;\n\nexport type OfframpErrorCode = (typeof OFFRAMP_ERROR_CODES)[keyof typeof OFFRAMP_ERROR_CODES];\n\nexport interface OfframpParams {\n  /** USDC amount as decimal string, min 1. */\n  amount: string;\n  /** Payment platform — use `PLATFORMS.REVOLUT` etc. */\n  platform: PlatformEntry;\n  /** Fiat currency — use `CURRENCIES.EUR` etc. */\n  currency: CurrencyEntry;\n  /** Platform-specific identifier (username, email, IBAN). */\n  identifier: string;\n  /** Optional: restrict the deposit to this taker wallet (OTC private order). */\n  otcTaker?: string;\n  /** Optional SDK-only referral metadata for telemetry attribution. */\n  referralId?: string;\n  /** Optional SDK-only integrator metadata for telemetry attribution. */\n  integratorId?: string;\n  /** Optional per-wallet key to replay the first successful result for 10 minutes. */\n  idempotencyKey?: string;\n}\n\nexport interface OfframpResult {\n  depositId: string;\n  txHash: string;\n  /** Whether an existing undelegated deposit was resumed. */\n  resumed: boolean;\n  /** OTC link for the taker, present when `otcTaker` was provided. */\n  otcLink?: string;\n}\n\nexport type OfframpStep =\n  | \"approving\"\n  | \"registering\"\n  | \"depositing\"\n  | \"confirming\"\n  | \"delegating\"\n  | \"restricting\"\n  | \"resuming\"\n  | \"done\";\n\nexport type OfframpState =\n  | \"idle\"\n  | \"approving\"\n  | \"registering\"\n  | \"depositing\"\n  | \"confirming\"\n  | \"delegating\"\n  | \"done\"\n  | \"error\";\n\nexport interface OfframpProgress {\n  step: OfframpStep;\n  txHash?: string;\n  depositId?: string;\n}\n\nexport type OnProgress = (progress: OfframpProgress) => void;\n\nexport type DepositStatus = \"active\" | \"empty\" | \"closed\";\n\nexport interface OfframpQuoteInput {\n  amount: string;\n  currency: CurrencyEntry;\n  platform: PlatformEntry;\n}\n\nexport interface OfframpQuote {\n  amountUsdc: number;\n  expectedFiat: number;\n  effectiveRate: number;\n  vaultSpreadBps: number;\n}\n\nexport interface OfframpVaultStatus {\n  rateManagerId: string;\n  rateManagerAddress: string;\n  feeRateBps: number;\n  escrow: string;\n  isActive: boolean;\n}\n\nexport interface OfframpCreateOptions {\n  integratorId?: string;\n  referralId?: string;\n  telemetry?: boolean;\n}\n\nexport interface DepositInfo {\n  /** Numeric deposit ID. Pass this to `close()`. */\n  depositId: string;\n  /** Composite ID (escrowAddress_depositId). */\n  compositeId: string;\n  /** Creation transaction hash. */\n  txHash?: string;\n  status: DepositStatus;\n  remainingUsdc: number;\n  outstandingUsdc: number;\n  totalTakenUsdc: number;\n  fulfilledIntents: number;\n  paymentMethods: string[];\n  currencies: string[];\n  rateSource: string;\n  delegated: boolean;\n  escrowAddress: string;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAGO,IAAM,sBAAsB;AAAA,EACjC,YAAY;AAAA,EACZ,iBAAiB;AAAA,EACjB,qBAAqB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASrB,iCAAiC;AAAA,EACjC,gBAAgB;AAAA,EAChB,qBAAqB;AAAA,EACrB,mBAAmB;AAAA,EACnB,gBAAgB;AAAA,EAChB,aAAa;AACf;","names":[]}
+{"version":3,"sources":["../src/types.ts"],"sourcesContent":["import type { PlatformEntry } from \"./platforms\";\nimport type { CurrencyEntry } from \"./currencies\";\n\nexport const OFFRAMP_ERROR_CODES = {\n  VALIDATION: \"VALIDATION\",\n  APPROVAL_FAILED: \"APPROVAL_FAILED\",\n  REGISTRATION_FAILED: \"REGISTRATION_FAILED\",\n  /**\n   * Curator rejected the maker because the user has not registered this\n   * handle in the Peer extension yet. Thrown from `offramp()` for PayPal\n   * and Wise when `/v2/makers/create` returns 400 or a \"creating the maker\"\n   * message. Recover by prompting the user through the Peer extension via\n   * `usePeerExtensionRegistration(platform)` (React) or\n   * `completePeerExtensionRegistration(...)`, then retrying `offramp()`.\n   */\n  EXTENSION_REGISTRATION_REQUIRED: \"EXTENSION_REGISTRATION_REQUIRED\",\n  DEPOSIT_FAILED: \"DEPOSIT_FAILED\",\n  CONFIRMATION_FAILED: \"CONFIRMATION_FAILED\",\n  DELEGATION_FAILED: \"DELEGATION_FAILED\",\n  USER_CANCELLED: \"USER_CANCELLED\",\n  UNSUPPORTED: \"UNSUPPORTED\",\n} as const;\n\nexport type OfframpErrorCode = (typeof OFFRAMP_ERROR_CODES)[keyof typeof OFFRAMP_ERROR_CODES];\n\nexport interface OfframpParams {\n  /** USDC amount as decimal string, min 1. */\n  amount: string;\n  /** Payment platform — use `PLATFORMS.REVOLUT` etc. */\n  platform: PlatformEntry;\n  /** Fiat currency — use `CURRENCIES.EUR` etc. */\n  currency: CurrencyEntry;\n  /** Platform-specific identifier (username, email, IBAN). */\n  identifier: string;\n  /** Optional: restrict the deposit to this taker wallet (OTC private order). */\n  otcTaker?: string;\n  /** Optional SDK-only referral metadata for telemetry attribution. */\n  referralId?: string;\n  /** Optional SDK-only integrator metadata for telemetry attribution. */\n  integratorId?: string;\n  /**\n   * Optional per-wallet key to replay the first successful result for 10 minutes.\n   *\n   * Browser-only: the replay cache is backed by `sessionStorage` and is a no-op\n   * in Node/worker runtimes (no duplicate protection there). It is honored only\n   * by the `Offramp` class (`createDeposit`) / the `useOfframp` hook — the\n   * standalone `offramp()` function ignores it. For server-side dedup, call\n   * `deposits(walletAddress)` and reuse an existing open deposit before creating\n   * a new one (the SDK's own resume behavior does this for the delegation step).\n   */\n  idempotencyKey?: string;\n}\n\nexport interface OfframpResult {\n  depositId: string;\n  txHash: string;\n  /** Whether an existing undelegated deposit was resumed. */\n  resumed: boolean;\n  /** OTC link for the taker, present when `otcTaker` was provided. */\n  otcLink?: string;\n}\n\nexport type OfframpStep =\n  | \"approving\"\n  | \"registering\"\n  | \"depositing\"\n  | \"confirming\"\n  | \"delegating\"\n  | \"restricting\"\n  | \"resuming\"\n  | \"done\";\n\nexport type OfframpState =\n  | \"idle\"\n  | \"approving\"\n  | \"registering\"\n  | \"depositing\"\n  | \"confirming\"\n  | \"delegating\"\n  | \"done\"\n  | \"error\";\n\nexport interface OfframpProgress {\n  step: OfframpStep;\n  txHash?: string;\n  depositId?: string;\n}\n\nexport type OnProgress = (progress: OfframpProgress) => void;\n\nexport type DepositStatus = \"active\" | \"empty\" | \"closed\";\n\nexport interface OfframpQuoteInput {\n  amount: string;\n  currency: CurrencyEntry;\n  platform: PlatformEntry;\n}\n\nexport interface OfframpQuote {\n  amountUsdc: number;\n  expectedFiat: number;\n  effectiveRate: number;\n  vaultSpreadBps: number;\n}\n\nexport interface OfframpVaultStatus {\n  rateManagerId: string;\n  rateManagerAddress: string;\n  /**\n   * Delegate vault manager fee in basis points (currently 10 = 0.10%). Charged\n   * by the vault's rate manager on each fill and deducted from the USDC released\n   * to the buyer; not added to the maker's deposit cost. See the README \"Fees\".\n   */\n  feeRateBps: number;\n  escrow: string;\n  isActive: boolean;\n}\n\nexport interface OfframpCreateOptions {\n  integratorId?: string;\n  referralId?: string;\n  telemetry?: boolean;\n  /**\n   * Override the curator REST base URL (default `https://api.zkp2p.xyz`) used\n   * for maker registration/validation and the SDK's REST calls. For\n   * testing/proxying/mocking only — the indexer and Base RPC always target\n   * mainnet. Honored by the `Offramp` class (`createDeposit`); absent ⇒ default\n   * behavior is unchanged.\n   */\n  apiBaseUrl?: string;\n}\n\nexport interface DepositInfo {\n  /** Numeric deposit ID. Pass this to `close()`. */\n  depositId: string;\n  /** Composite ID (escrowAddress_depositId). */\n  compositeId: string;\n  /** Creation transaction hash. */\n  txHash?: string;\n  status: DepositStatus;\n  remainingUsdc: number;\n  outstandingUsdc: number;\n  totalTakenUsdc: number;\n  fulfilledIntents: number;\n  paymentMethods: string[];\n  currencies: string[];\n  rateSource: string;\n  delegated: boolean;\n  escrowAddress: string;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAGO,IAAM,sBAAsB;AAAA,EACjC,YAAY;AAAA,EACZ,iBAAiB;AAAA,EACjB,qBAAqB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASrB,iCAAiC;AAAA,EACjC,gBAAgB;AAAA,EAChB,qBAAqB;AAAA,EACrB,mBAAmB;AAAA,EACnB,gBAAgB;AAAA,EAChB,aAAa;AACf;","names":[]}