@usdctofiat/offramp 3.0.2 → 3.1.0

package/dist/react.d.cts

@@ -1,5 +1,5 @@
 import { WalletClient } from 'viem';
-import { m as OfframpState, n as OfframpStep, j as OfframpError, O as OfframpParams, b as OfframpResult, D as DepositInfo, c as OfframpCreateOptions, q as PeerExtensionRegistrationInfo, P as PlatformEntry } from './errors-DKQ2N_ih.cjs';
+import { m as OfframpState, n as OfframpStep, f as OfframpError, h as OfframpParams, l as OfframpResult, D as DepositInfo, e as OfframpCreateOptions, x as PeerExtensionRegistrationInfo, F as PeerMetadataMessage, p as OnProgress, L as PlatformEntry } from './errors-DzTiflBh.cjs';
 import '@zkp2p/sdk';
 
 interface UseOfframpReturn {
@@ -27,8 +27,8 @@ declare function useOfframp(defaultOptions?: OfframpCreateOptions): UseOfframpRe
  *   yet approved; call `connectExtension()` to trigger the Peer approval
  *   prompt
  * - `ready` — extension installed and origin approved; call
- *   `openVerifySidebar()` to send the user into the `/verify/<providerId>`
- *   handler, or just retry the `offramp(...)` call
+ *   `startRegistrationCapture()` to launch headless metadata capture, or just
+ *   retry the `offramp(...)` call
  * - `unsupported` — the provided platform does not require extension
  *   registration; the hook is a no-op for it
  */
@@ -44,9 +44,11 @@ interface UsePeerExtensionRegistrationReturn {
     info: PeerExtensionRegistrationInfo | null;
     /** True while a `requestConnection()` or initial state check is in flight. */
     busy: boolean;
-    /** Last error from `requestConnection()` / `openSidebar()`, if any. */
+    /** Last error from `requestConnection()` / `authenticate()`, if any. */
     error: string | null;
-    /** Re-poll `peerExtensionSdk.getState()`. Call after the user confirms they've finished the verify flow. */
+    /** Last metadata payload captured for this platform. */
+    capturedMetadata: PeerMetadataMessage | null;
+    /** Re-poll `peerExtensionSdk.getState()`. Call after the user finishes metadata capture. */
     refresh: () => Promise<void>;
     /**
      * Open the Chrome Web Store listing for the Peer extension. Falls back to
@@ -56,20 +58,28 @@ interface UsePeerExtensionRegistrationReturn {
     installExtension: () => void;
     /**
      * Request an origin connection. Triggers the Peer extension's approval
-     * prompt. Returns `true` if the user approved, `false` otherwise. On
-     * approval the hook auto-advances to `ready` and opens the verify sidebar.
+     * prompt. Returns `true` if the user approved, `false` otherwise.
      */
     connectExtension: () => Promise<boolean>;
     /**
-     * Open `/verify/<providerId>` in the Peer extension sidebar so the user
-     * can finish registering their handle. Safe to call from any phase — the
-     * hook will fall back to install/connect if those steps aren't done yet.
+     * Launch headless Peer metadata capture for this provider. Safe to call from
+     * any phase — the hook will fall back to install/connect if those steps
+     * aren't done yet.
+     */
+    startRegistrationCapture: () => Promise<void>;
+    /**
+     * Deprecated compatibility alias for `startRegistrationCapture()`.
      */
     openVerifySidebar: () => Promise<void>;
+    completeRegistration: (walletClient: WalletClient, params: OfframpParams, options?: {
+        capturedMetadata?: PeerMetadataMessage;
+        onProgress?: OnProgress;
+        attestationServiceUrl?: string | null;
+    }) => Promise<OfframpResult>;
 }
 /**
  * React hook that drives the Peer extension handshake required for PayPal
- * and Wise makers. Mirrors the CTA state machine used in usdctofiat.xyz.
+ * and Wise makers.
  *
  * ```tsx
  * import { PLATFORMS } from "@usdctofiat/offramp";
@@ -93,7 +103,7 @@ interface UsePeerExtensionRegistrationReturn {
  *         </button>
  *       )}
  *       {needsExtension && peer.phase === "ready" && (
- *         <button onClick={peer.openVerifySidebar}>Verify in Peer</button>
+ *         <button onClick={peer.startRegistrationCapture}>Register with Peer</button>
  *       )}
  *     </>
  *   );
@@ -102,4 +112,4 @@ interface UsePeerExtensionRegistrationReturn {
  */
 declare function usePeerExtensionRegistration(platform: PlatformEntry | null | undefined): UsePeerExtensionRegistrationReturn;
 
-export { type PeerExtensionRegistrationPhase, type UseOfframpReturn, type UsePeerExtensionRegistrationReturn, useOfframp, usePeerExtensionRegistration };
+export { type PeerExtensionRegistrationPhase, PeerMetadataMessage, type UseOfframpReturn, type UsePeerExtensionRegistrationReturn, useOfframp, usePeerExtensionRegistration };

package/dist/react.d.ts

@@ -1,5 +1,5 @@
 import { WalletClient } from 'viem';
-import { m as OfframpState, n as OfframpStep, j as OfframpError, O as OfframpParams, b as OfframpResult, D as DepositInfo, c as OfframpCreateOptions, q as PeerExtensionRegistrationInfo, P as PlatformEntry } from './errors-DKQ2N_ih.js';
+import { m as OfframpState, n as OfframpStep, f as OfframpError, h as OfframpParams, l as OfframpResult, D as DepositInfo, e as OfframpCreateOptions, x as PeerExtensionRegistrationInfo, F as PeerMetadataMessage, p as OnProgress, L as PlatformEntry } from './errors-DzTiflBh.js';
 import '@zkp2p/sdk';
 
 interface UseOfframpReturn {
@@ -27,8 +27,8 @@ declare function useOfframp(defaultOptions?: OfframpCreateOptions): UseOfframpRe
  *   yet approved; call `connectExtension()` to trigger the Peer approval
  *   prompt
  * - `ready` — extension installed and origin approved; call
- *   `openVerifySidebar()` to send the user into the `/verify/<providerId>`
- *   handler, or just retry the `offramp(...)` call
+ *   `startRegistrationCapture()` to launch headless metadata capture, or just
+ *   retry the `offramp(...)` call
  * - `unsupported` — the provided platform does not require extension
  *   registration; the hook is a no-op for it
  */
@@ -44,9 +44,11 @@ interface UsePeerExtensionRegistrationReturn {
     info: PeerExtensionRegistrationInfo | null;
     /** True while a `requestConnection()` or initial state check is in flight. */
     busy: boolean;
-    /** Last error from `requestConnection()` / `openSidebar()`, if any. */
+    /** Last error from `requestConnection()` / `authenticate()`, if any. */
     error: string | null;
-    /** Re-poll `peerExtensionSdk.getState()`. Call after the user confirms they've finished the verify flow. */
+    /** Last metadata payload captured for this platform. */
+    capturedMetadata: PeerMetadataMessage | null;
+    /** Re-poll `peerExtensionSdk.getState()`. Call after the user finishes metadata capture. */
     refresh: () => Promise<void>;
     /**
      * Open the Chrome Web Store listing for the Peer extension. Falls back to
@@ -56,20 +58,28 @@ interface UsePeerExtensionRegistrationReturn {
     installExtension: () => void;
     /**
      * Request an origin connection. Triggers the Peer extension's approval
-     * prompt. Returns `true` if the user approved, `false` otherwise. On
-     * approval the hook auto-advances to `ready` and opens the verify sidebar.
+     * prompt. Returns `true` if the user approved, `false` otherwise.
      */
     connectExtension: () => Promise<boolean>;
     /**
-     * Open `/verify/<providerId>` in the Peer extension sidebar so the user
-     * can finish registering their handle. Safe to call from any phase — the
-     * hook will fall back to install/connect if those steps aren't done yet.
+     * Launch headless Peer metadata capture for this provider. Safe to call from
+     * any phase — the hook will fall back to install/connect if those steps
+     * aren't done yet.
+     */
+    startRegistrationCapture: () => Promise<void>;
+    /**
+     * Deprecated compatibility alias for `startRegistrationCapture()`.
      */
     openVerifySidebar: () => Promise<void>;
+    completeRegistration: (walletClient: WalletClient, params: OfframpParams, options?: {
+        capturedMetadata?: PeerMetadataMessage;
+        onProgress?: OnProgress;
+        attestationServiceUrl?: string | null;
+    }) => Promise<OfframpResult>;
 }
 /**
  * React hook that drives the Peer extension handshake required for PayPal
- * and Wise makers. Mirrors the CTA state machine used in usdctofiat.xyz.
+ * and Wise makers.
  *
  * ```tsx
  * import { PLATFORMS } from "@usdctofiat/offramp";
@@ -93,7 +103,7 @@ interface UsePeerExtensionRegistrationReturn {
  *         </button>
  *       )}
  *       {needsExtension && peer.phase === "ready" && (
- *         <button onClick={peer.openVerifySidebar}>Verify in Peer</button>
+ *         <button onClick={peer.startRegistrationCapture}>Register with Peer</button>
  *       )}
  *     </>
  *   );
@@ -102,4 +112,4 @@ interface UsePeerExtensionRegistrationReturn {
  */
 declare function usePeerExtensionRegistration(platform: PlatformEntry | null | undefined): UsePeerExtensionRegistrationReturn;
 
-export { type PeerExtensionRegistrationPhase, type UseOfframpReturn, type UsePeerExtensionRegistrationReturn, useOfframp, usePeerExtensionRegistration };
+export { type PeerExtensionRegistrationPhase, PeerMetadataMessage, type UseOfframpReturn, type UsePeerExtensionRegistrationReturn, useOfframp, usePeerExtensionRegistration };

package/dist/react.js

@@ -2,11 +2,15 @@ import {
   OfframpError,
   PEER_EXTENSION_CHROME_URL,
   close,
+  completePeerExtensionRegistration,
   createOfframp,
   deposits,
+  getPeerExtensionRegistrationAuthParams,
   getPeerExtensionRegistrationInfo,
+  isPeerExtensionMetadataBridgeAvailable,
+  offramp,
   peerExtensionSdk
-} from "./chunk-F7DVUBMT.js";
+} from "./chunk-XQ7HOLLB.js";
 
 // src/hooks/useOfframp.ts
 import { useCallback, useRef, useState } from "react";
@@ -32,7 +36,7 @@ function useOfframp(defaultOptions = {}) {
     setIsLoading(false);
     lockRef.current = false;
   }, []);
-  const offramp = useCallback(
+  const offramp2 = useCallback(
     async (walletClient, params) => {
       if (lockRef.current) throw new OfframpError("Deposit already in progress", "VALIDATION");
       lockRef.current = true;
@@ -82,7 +86,7 @@ function useOfframp(defaultOptions = {}) {
     lastError,
     error: lastError,
     isLoading,
-    offramp,
+    offramp: offramp2,
     deposits,
     close,
     reset
@@ -90,16 +94,23 @@ function useOfframp(defaultOptions = {}) {
 }
 
 // src/hooks/usePeerExtensionRegistration.ts
-import { useCallback as useCallback2, useEffect, useRef as useRef2, useState as useState2 } from "react";
+import { useCallback as useCallback2, useEffect, useMemo, useRef as useRef2, useState as useState2 } from "react";
 function usePeerExtensionRegistration(platform) {
-  const info = platform ? getPeerExtensionRegistrationInfo(platform.id) : null;
+  const platformId = platform?.id ?? null;
+  const info = platformId ? getPeerExtensionRegistrationInfo(platformId) : null;
+  const authParams = useMemo(
+    () => platformId ? getPeerExtensionRegistrationAuthParams(platformId) : null,
+    [platformId]
+  );
   const [phase, setPhase] = useState2(
     info ? "checking" : "unsupported"
   );
   const [busy, setBusy] = useState2(false);
   const [error, setError] = useState2(null);
+  const [capturedMetadata, setCapturedMetadata] = useState2(null);
   const mountedRef = useRef2(true);
   const providerId = info?.providerId ?? null;
+  const metadataPlatform = authParams?.platform ?? null;
   const refresh = useCallback2(async () => {
     if (!providerId) {
       setPhase("unsupported");
@@ -108,6 +119,10 @@ function usePeerExtensionRegistration(platform) {
     try {
       const state = await peerExtensionSdk.getState();
       if (!mountedRef.current) return;
+      if (state === "ready" && !isPeerExtensionMetadataBridgeAvailable()) {
+        setPhase("needs_install");
+        return;
+      }
       setPhase(mapSdkState(state));
     } catch {
       if (!mountedRef.current) return;
@@ -118,6 +133,7 @@ function usePeerExtensionRegistration(platform) {
     mountedRef.current = true;
     setError(null);
     setBusy(false);
+    setCapturedMetadata(null);
     if (!providerId) {
       setPhase("unsupported");
     } else {
@@ -128,6 +144,21 @@ function usePeerExtensionRegistration(platform) {
       mountedRef.current = false;
     };
   }, [providerId, refresh]);
+  useEffect(() => {
+    setCapturedMetadata(null);
+    if (!metadataPlatform) return;
+    try {
+      return peerExtensionSdk.onMetadataMessage((message) => {
+        if (!mountedRef.current || message.platform !== metadataPlatform) return;
+        setCapturedMetadata(message);
+        if (message.errorMessage) {
+          setError(message.errorMessage);
+        }
+      });
+    } catch {
+      return;
+    }
+  }, [metadataPlatform, phase]);
   const installExtension = useCallback2(() => {
     setError(null);
     try {
@@ -139,15 +170,14 @@ function usePeerExtensionRegistration(platform) {
     }
   }, []);
   const connectExtension = useCallback2(async () => {
-    if (!providerId) return false;
+    if (!authParams) return false;
     setError(null);
     setBusy(true);
     try {
       const approved = await peerExtensionSdk.requestConnection();
       if (!mountedRef.current) return approved;
       if (approved) {
-        setPhase("ready");
-        peerExtensionSdk.openSidebar(`/verify/${providerId}`);
+        setPhase(isPeerExtensionMetadataBridgeAvailable() ? "ready" : "needs_install");
       } else {
         setError("Connection was not approved. Try again once you've approved Peer.");
       }
@@ -162,40 +192,89 @@ function usePeerExtensionRegistration(platform) {
     } finally {
       if (mountedRef.current) setBusy(false);
     }
-  }, [providerId, refresh]);
-  const openVerifySidebar = useCallback2(async () => {
-    if (!providerId) return;
+  }, [authParams, refresh]);
+  const startRegistrationCapture = useCallback2(async () => {
+    if (!authParams) return;
     setError(null);
-    const state = await peerExtensionSdk.getState().catch(() => "needs_install");
-    if (!mountedRef.current) return;
-    const nextPhase = mapSdkState(state);
-    setPhase(nextPhase);
-    if (nextPhase === "needs_install") {
-      installExtension();
-      return;
-    }
-    if (nextPhase === "needs_connection") {
-      await connectExtension();
-      return;
-    }
+    setBusy(true);
     try {
-      peerExtensionSdk.openSidebar(`/verify/${providerId}`);
+      const state = await peerExtensionSdk.getState().catch(() => "needs_install");
+      if (!mountedRef.current) return;
+      const nextPhase = state === "ready" && !isPeerExtensionMetadataBridgeAvailable() ? "needs_install" : mapSdkState(state);
+      setPhase(nextPhase);
+      if (nextPhase === "needs_install") {
+        installExtension();
+        return;
+      }
+      if (nextPhase === "needs_connection") {
+        const approved = await peerExtensionSdk.requestConnection();
+        if (!mountedRef.current) return;
+        if (!approved) {
+          setError("Connection was not approved. Try again once you've approved Peer.");
+          return;
+        }
+        if (!isPeerExtensionMetadataBridgeAvailable()) {
+          setPhase("needs_install");
+          installExtension();
+          return;
+        }
+        setPhase("ready");
+      }
+      setCapturedMetadata(null);
+      peerExtensionSdk.authenticate(authParams);
     } catch (err) {
       setError(
-        err instanceof Error ? err.message : "Couldn't open the Peer extension. Make sure it's enabled."
+        err instanceof Error ? err.message : "Couldn't start Peer extension registration. Make sure Peer is enabled."
       );
       refresh();
+    } finally {
+      if (mountedRef.current) setBusy(false);
     }
-  }, [connectExtension, installExtension, providerId, refresh]);
+  }, [authParams, installExtension, refresh]);
+  const openVerifySidebar = useCallback2(
+    async () => startRegistrationCapture(),
+    [startRegistrationCapture]
+  );
+  const completeRegistration = useCallback2(
+    async (walletClient, params, options = {}) => {
+      const metadata = options.capturedMetadata ?? capturedMetadata;
+      if (!metadata) {
+        const message = "No Peer metadata captured yet. Start registration first.";
+        setError(message);
+        throw new Error(message);
+      }
+      setError(null);
+      setBusy(true);
+      try {
+        await completePeerExtensionRegistration({
+          platform: params.platform,
+          identifier: params.identifier,
+          capturedMetadata: metadata
+        });
+        return await offramp(walletClient, params, options.onProgress);
+      } catch (err) {
+        setError(
+          err instanceof Error ? err.message : "Couldn't complete Peer extension registration. Try capturing metadata again."
+        );
+        throw err;
+      } finally {
+        if (mountedRef.current) setBusy(false);
+      }
+    },
+    [capturedMetadata]
+  );
   return {
     phase,
     info,
     busy,
     error,
+    capturedMetadata,
     refresh,
     installExtension,
     connectExtension,
-    openVerifySidebar
+    startRegistrationCapture,
+    openVerifySidebar,
+    completeRegistration
   };
 }
 function mapSdkState(state) {

package/dist/react.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/hooks/useOfframp.ts","../src/hooks/usePeerExtensionRegistration.ts"],"sourcesContent":["import { useCallback, useRef, useState } from \"react\";\nimport type { WalletClient } from \"viem\";\nimport type {\n  OfframpCreateOptions,\n  OfframpParams,\n  OfframpResult,\n  OfframpState,\n  OfframpStep,\n  DepositInfo,\n} from \"../types\";\nimport { createOfframp } from \"../offramp\";\nimport { deposits as depositsFn, close as closeFn } from \"../queries\";\nimport { OfframpError } from \"../errors\";\n\nexport interface UseOfframpReturn {\n  state: OfframpState;\n  step: OfframpStep | null;\n  txHash: string | null;\n  depositId: string | null;\n  lastError: OfframpError | null;\n  /** @deprecated Use `lastError` instead. */\n  error: OfframpError | null;\n  isLoading: boolean;\n  offramp: (walletClient: WalletClient, params: OfframpParams) => Promise<OfframpResult>;\n  deposits: (walletAddress: string) => Promise<DepositInfo[]>;\n  close: (walletClient: WalletClient, depositId: string, escrowAddress?: string) => Promise<string>;\n  reset: () => void;\n}\n\nfunction mapStepToState(step: OfframpStep): OfframpState {\n  if (step === \"resuming\" || step === \"restricting\") return \"delegating\";\n  if (step === \"done\") return \"done\";\n  return step;\n}\n\nexport function useOfframp(defaultOptions: OfframpCreateOptions = {}): UseOfframpReturn {\n  const [state, setState] = useState<OfframpState>(\"idle\");\n  const [step, setStep] = useState<OfframpStep | null>(null);\n  const [txHash, setTxHash] = useState<string | null>(null);\n  const [depositId, setDepositId] = useState<string | null>(null);\n  const [lastError, setLastError] = useState<OfframpError | null>(null);\n  const [isLoading, setIsLoading] = useState(false);\n  const lockRef = useRef(false);\n\n  const reset = useCallback(() => {\n    setState(\"idle\");\n    setStep(null);\n    setTxHash(null);\n    setDepositId(null);\n    setLastError(null);\n    setIsLoading(false);\n    lockRef.current = false;\n  }, []);\n\n  const offramp = useCallback(\n    async (walletClient: WalletClient, params: OfframpParams): Promise<OfframpResult> => {\n      if (lockRef.current) throw new OfframpError(\"Deposit already in progress\", \"VALIDATION\");\n      lockRef.current = true;\n      setIsLoading(true);\n      setState(\"idle\");\n      setLastError(null);\n      setStep(null);\n      setTxHash(null);\n      setDepositId(null);\n\n      try {\n        const sdk = createOfframp({\n          walletClient,\n          integratorId: params.integratorId ?? defaultOptions.integratorId,\n          referralId: params.referralId ?? defaultOptions.referralId,\n          telemetry: defaultOptions.telemetry,\n        });\n        const result = await sdk.createDeposit(params, (progress) => {\n          setStep(progress.step);\n          setState(mapStepToState(progress.step));\n          if (progress.txHash) setTxHash(progress.txHash);\n          if (progress.depositId) setDepositId(progress.depositId);\n        });\n        setState(\"done\");\n        setDepositId(result.depositId);\n        setTxHash(result.txHash);\n        return result;\n      } catch (err) {\n        const offrampError =\n          err instanceof OfframpError\n            ? err\n            : new OfframpError(\n                err instanceof Error ? err.message : \"Offramp failed\",\n                \"DEPOSIT_FAILED\",\n              );\n        setLastError(offrampError);\n        setState(\"error\");\n        throw offrampError;\n      } finally {\n        setIsLoading(false);\n        lockRef.current = false;\n      }\n    },\n    [defaultOptions.integratorId, defaultOptions.referralId, defaultOptions.telemetry],\n  );\n\n  return {\n    state,\n    step,\n    txHash,\n    depositId,\n    lastError,\n    error: lastError,\n    isLoading,\n    offramp,\n    deposits: depositsFn,\n    close: closeFn,\n    reset,\n  };\n}\n","import { useCallback, useEffect, useRef, useState } from \"react\";\nimport { peerExtensionSdk, type PeerExtensionState, PEER_EXTENSION_CHROME_URL } from \"../extension\";\nimport {\n  getPeerExtensionRegistrationInfo,\n  type PeerExtensionRegistrationInfo,\n  type PlatformEntry,\n} from \"../platforms\";\n\n/**\n * Phase surfaced to callers:\n * - `checking` — polling the extension state on mount\n * - `needs_install` — the Peer extension is not installed; call\n *   `installExtension()` or surface the install URL\n * - `needs_connection` — the extension is installed but this origin is not\n *   yet approved; call `connectExtension()` to trigger the Peer approval\n *   prompt\n * - `ready` — extension installed and origin approved; call\n *   `openVerifySidebar()` to send the user into the `/verify/<providerId>`\n *   handler, or just retry the `offramp(...)` call\n * - `unsupported` — the provided platform does not require extension\n *   registration; the hook is a no-op for it\n */\nexport type PeerExtensionRegistrationPhase =\n  | \"checking\"\n  | \"needs_install\"\n  | \"needs_connection\"\n  | \"ready\"\n  | \"unsupported\";\n\nexport interface UsePeerExtensionRegistrationReturn {\n  /** Current handshake phase. */\n  phase: PeerExtensionRegistrationPhase;\n  /**\n   * Registration metadata for this platform (prompt copy, CTA label, min\n   * extension version). `null` for platforms that don't require extension\n   * registration, in which case `phase === \"unsupported\"`.\n   */\n  info: PeerExtensionRegistrationInfo | null;\n  /** True while a `requestConnection()` or initial state check is in flight. */\n  busy: boolean;\n  /** Last error from `requestConnection()` / `openSidebar()`, if any. */\n  error: string | null;\n  /** Re-poll `peerExtensionSdk.getState()`. Call after the user confirms they've finished the verify flow. */\n  refresh: () => Promise<void>;\n  /**\n   * Open the Chrome Web Store listing for the Peer extension. Falls back to\n   * `window.open(PEER_EXTENSION_CHROME_URL)` outside of browsers where\n   * `openInstallPage()` would throw.\n   */\n  installExtension: () => void;\n  /**\n   * Request an origin connection. Triggers the Peer extension's approval\n   * prompt. Returns `true` if the user approved, `false` otherwise. On\n   * approval the hook auto-advances to `ready` and opens the verify sidebar.\n   */\n  connectExtension: () => Promise<boolean>;\n  /**\n   * Open `/verify/<providerId>` in the Peer extension sidebar so the user\n   * can finish registering their handle. Safe to call from any phase — the\n   * hook will fall back to install/connect if those steps aren't done yet.\n   */\n  openVerifySidebar: () => Promise<void>;\n}\n\n/**\n * React hook that drives the Peer extension handshake required for PayPal\n * and Wise makers. Mirrors the CTA state machine used in usdctofiat.xyz.\n *\n * ```tsx\n * import { PLATFORMS } from \"@usdctofiat/offramp\";\n * import { useOfframp, usePeerExtensionRegistration } from \"@usdctofiat/offramp/react\";\n *\n * function PayPalSellButton() {\n *   const { offramp, lastError } = useOfframp();\n *   const peer = usePeerExtensionRegistration(PLATFORMS.PAYPAL);\n *\n *   const needsExtension = lastError?.code === \"EXTENSION_REGISTRATION_REQUIRED\";\n *\n *   return (\n *     <>\n *       <button onClick={() => offramp(walletClient, params)}>Sell USDC</button>\n *       {needsExtension && peer.phase === \"needs_install\" && (\n *         <button onClick={peer.installExtension}>Install Peer Extension</button>\n *       )}\n *       {needsExtension && peer.phase === \"needs_connection\" && (\n *         <button onClick={peer.connectExtension} disabled={peer.busy}>\n *           Connect Peer Extension\n *         </button>\n *       )}\n *       {needsExtension && peer.phase === \"ready\" && (\n *         <button onClick={peer.openVerifySidebar}>Verify in Peer</button>\n *       )}\n *     </>\n *   );\n * }\n * ```\n */\nexport function usePeerExtensionRegistration(\n  platform: PlatformEntry | null | undefined,\n): UsePeerExtensionRegistrationReturn {\n  const info = platform ? getPeerExtensionRegistrationInfo(platform.id) : null;\n  const [phase, setPhase] = useState<PeerExtensionRegistrationPhase>(\n    info ? \"checking\" : \"unsupported\",\n  );\n  const [busy, setBusy] = useState(false);\n  const [error, setError] = useState<string | null>(null);\n  const mountedRef = useRef(true);\n  // Close over the current provider id so state refreshes triggered after\n  // `platform` swaps don't race with the previous one.\n  const providerId = info?.providerId ?? null;\n\n  const refresh = useCallback(async () => {\n    if (!providerId) {\n      setPhase(\"unsupported\");\n      return;\n    }\n    try {\n      const state = await peerExtensionSdk.getState();\n      if (!mountedRef.current) return;\n      setPhase(mapSdkState(state));\n    } catch {\n      if (!mountedRef.current) return;\n      setPhase(\"needs_install\");\n    }\n  }, [providerId]);\n\n  useEffect(() => {\n    mountedRef.current = true;\n    setError(null);\n    setBusy(false);\n    if (!providerId) {\n      setPhase(\"unsupported\");\n    } else {\n      setPhase(\"checking\");\n      refresh();\n    }\n    return () => {\n      mountedRef.current = false;\n    };\n  }, [providerId, refresh]);\n\n  const installExtension = useCallback(() => {\n    setError(null);\n    try {\n      peerExtensionSdk.openInstallPage();\n    } catch {\n      if (typeof window !== \"undefined\") {\n        window.open(PEER_EXTENSION_CHROME_URL, \"_blank\", \"noopener,noreferrer\");\n      }\n    }\n  }, []);\n\n  const connectExtension = useCallback(async (): Promise<boolean> => {\n    if (!providerId) return false;\n    setError(null);\n    setBusy(true);\n    try {\n      const approved = await peerExtensionSdk.requestConnection();\n      if (!mountedRef.current) return approved;\n      if (approved) {\n        setPhase(\"ready\");\n        peerExtensionSdk.openSidebar(`/verify/${providerId}`);\n      } else {\n        setError(\"Connection was not approved. Try again once you've approved Peer.\");\n      }\n      return approved;\n    } catch (err) {\n      if (!mountedRef.current) return false;\n      setError(\n        err instanceof Error\n          ? err.message\n          : \"Couldn't request a Peer extension connection. Make sure Peer is installed and enabled.\",\n      );\n      // Re-check state in case the user installed or disabled something.\n      refresh();\n      return false;\n    } finally {\n      if (mountedRef.current) setBusy(false);\n    }\n  }, [providerId, refresh]);\n\n  const openVerifySidebar = useCallback(async () => {\n    if (!providerId) return;\n    setError(null);\n    // Resync state before opening — the user may have installed or\n    // disconnected while the hook was idle.\n    const state = await peerExtensionSdk.getState().catch(() => \"needs_install\" as const);\n    if (!mountedRef.current) return;\n    const nextPhase = mapSdkState(state);\n    setPhase(nextPhase);\n    if (nextPhase === \"needs_install\") {\n      installExtension();\n      return;\n    }\n    if (nextPhase === \"needs_connection\") {\n      await connectExtension();\n      return;\n    }\n    try {\n      peerExtensionSdk.openSidebar(`/verify/${providerId}`);\n    } catch (err) {\n      setError(\n        err instanceof Error\n          ? err.message\n          : \"Couldn't open the Peer extension. Make sure it's enabled.\",\n      );\n      refresh();\n    }\n  }, [connectExtension, installExtension, providerId, refresh]);\n\n  return {\n    phase,\n    info,\n    busy,\n    error,\n    refresh,\n    installExtension,\n    connectExtension,\n    openVerifySidebar,\n  };\n}\n\nfunction mapSdkState(state: PeerExtensionState): PeerExtensionRegistrationPhase {\n  if (state === \"needs_install\") return \"needs_install\";\n  if (state === \"needs_connection\") return \"needs_connection\";\n  return \"ready\";\n}\n"],"mappings":"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","names":["useCallback","useRef","useState","useState","useRef","useCallback"]}
+{"version":3,"sources":["../src/hooks/useOfframp.ts","../src/hooks/usePeerExtensionRegistration.ts"],"sourcesContent":["import { useCallback, useRef, useState } from \"react\";\nimport type { WalletClient } from \"viem\";\nimport type {\n  OfframpCreateOptions,\n  OfframpParams,\n  OfframpResult,\n  OfframpState,\n  OfframpStep,\n  DepositInfo,\n} from \"../types\";\nimport { createOfframp } from \"../offramp\";\nimport { deposits as depositsFn, close as closeFn } from \"../queries\";\nimport { OfframpError } from \"../errors\";\n\nexport interface UseOfframpReturn {\n  state: OfframpState;\n  step: OfframpStep | null;\n  txHash: string | null;\n  depositId: string | null;\n  lastError: OfframpError | null;\n  /** @deprecated Use `lastError` instead. */\n  error: OfframpError | null;\n  isLoading: boolean;\n  offramp: (walletClient: WalletClient, params: OfframpParams) => Promise<OfframpResult>;\n  deposits: (walletAddress: string) => Promise<DepositInfo[]>;\n  close: (walletClient: WalletClient, depositId: string, escrowAddress?: string) => Promise<string>;\n  reset: () => void;\n}\n\nfunction mapStepToState(step: OfframpStep): OfframpState {\n  if (step === \"resuming\" || step === \"restricting\") return \"delegating\";\n  if (step === \"done\") return \"done\";\n  return step;\n}\n\nexport function useOfframp(defaultOptions: OfframpCreateOptions = {}): UseOfframpReturn {\n  const [state, setState] = useState<OfframpState>(\"idle\");\n  const [step, setStep] = useState<OfframpStep | null>(null);\n  const [txHash, setTxHash] = useState<string | null>(null);\n  const [depositId, setDepositId] = useState<string | null>(null);\n  const [lastError, setLastError] = useState<OfframpError | null>(null);\n  const [isLoading, setIsLoading] = useState(false);\n  const lockRef = useRef(false);\n\n  const reset = useCallback(() => {\n    setState(\"idle\");\n    setStep(null);\n    setTxHash(null);\n    setDepositId(null);\n    setLastError(null);\n    setIsLoading(false);\n    lockRef.current = false;\n  }, []);\n\n  const offramp = useCallback(\n    async (walletClient: WalletClient, params: OfframpParams): Promise<OfframpResult> => {\n      if (lockRef.current) throw new OfframpError(\"Deposit already in progress\", \"VALIDATION\");\n      lockRef.current = true;\n      setIsLoading(true);\n      setState(\"idle\");\n      setLastError(null);\n      setStep(null);\n      setTxHash(null);\n      setDepositId(null);\n\n      try {\n        const sdk = createOfframp({\n          walletClient,\n          integratorId: params.integratorId ?? defaultOptions.integratorId,\n          referralId: params.referralId ?? defaultOptions.referralId,\n          telemetry: defaultOptions.telemetry,\n        });\n        const result = await sdk.createDeposit(params, (progress) => {\n          setStep(progress.step);\n          setState(mapStepToState(progress.step));\n          if (progress.txHash) setTxHash(progress.txHash);\n          if (progress.depositId) setDepositId(progress.depositId);\n        });\n        setState(\"done\");\n        setDepositId(result.depositId);\n        setTxHash(result.txHash);\n        return result;\n      } catch (err) {\n        const offrampError =\n          err instanceof OfframpError\n            ? err\n            : new OfframpError(\n                err instanceof Error ? err.message : \"Offramp failed\",\n                \"DEPOSIT_FAILED\",\n              );\n        setLastError(offrampError);\n        setState(\"error\");\n        throw offrampError;\n      } finally {\n        setIsLoading(false);\n        lockRef.current = false;\n      }\n    },\n    [defaultOptions.integratorId, defaultOptions.referralId, defaultOptions.telemetry],\n  );\n\n  return {\n    state,\n    step,\n    txHash,\n    depositId,\n    lastError,\n    error: lastError,\n    isLoading,\n    offramp,\n    deposits: depositsFn,\n    close: closeFn,\n    reset,\n  };\n}\n","import { useCallback, useEffect, useMemo, useRef, useState } from \"react\";\nimport type { WalletClient } from \"viem\";\nimport { offramp as createDeposit } from \"../deposit\";\nimport {\n  peerExtensionSdk,\n  isPeerExtensionMetadataBridgeAvailable,\n  type PeerExtensionState,\n  PEER_EXTENSION_CHROME_URL,\n  type PeerMetadataMessage,\n} from \"../extension\";\nimport {\n  completePeerExtensionRegistration,\n  getPeerExtensionRegistrationAuthParams,\n  getPeerExtensionRegistrationInfo,\n  type PeerExtensionRegistrationInfo,\n  type PlatformEntry,\n} from \"../platforms\";\nimport type { OfframpParams, OfframpResult, OnProgress } from \"../types\";\n\n/**\n * Phase surfaced to callers:\n * - `checking` — polling the extension state on mount\n * - `needs_install` — the Peer extension is not installed; call\n *   `installExtension()` or surface the install URL\n * - `needs_connection` — the extension is installed but this origin is not\n *   yet approved; call `connectExtension()` to trigger the Peer approval\n *   prompt\n * - `ready` — extension installed and origin approved; call\n *   `startRegistrationCapture()` to launch headless metadata capture, or just\n *   retry the `offramp(...)` call\n * - `unsupported` — the provided platform does not require extension\n *   registration; the hook is a no-op for it\n */\nexport type PeerExtensionRegistrationPhase =\n  | \"checking\"\n  | \"needs_install\"\n  | \"needs_connection\"\n  | \"ready\"\n  | \"unsupported\";\n\nexport interface UsePeerExtensionRegistrationReturn {\n  /** Current handshake phase. */\n  phase: PeerExtensionRegistrationPhase;\n  /**\n   * Registration metadata for this platform (prompt copy, CTA label, min\n   * extension version). `null` for platforms that don't require extension\n   * registration, in which case `phase === \"unsupported\"`.\n   */\n  info: PeerExtensionRegistrationInfo | null;\n  /** True while a `requestConnection()` or initial state check is in flight. */\n  busy: boolean;\n  /** Last error from `requestConnection()` / `authenticate()`, if any. */\n  error: string | null;\n  /** Last metadata payload captured for this platform. */\n  capturedMetadata: PeerMetadataMessage | null;\n  /** Re-poll `peerExtensionSdk.getState()`. Call after the user finishes metadata capture. */\n  refresh: () => Promise<void>;\n  /**\n   * Open the Chrome Web Store listing for the Peer extension. Falls back to\n   * `window.open(PEER_EXTENSION_CHROME_URL)` outside of browsers where\n   * `openInstallPage()` would throw.\n   */\n  installExtension: () => void;\n  /**\n   * Request an origin connection. Triggers the Peer extension's approval\n   * prompt. Returns `true` if the user approved, `false` otherwise.\n   */\n  connectExtension: () => Promise<boolean>;\n  /**\n   * Launch headless Peer metadata capture for this provider. Safe to call from\n   * any phase — the hook will fall back to install/connect if those steps\n   * aren't done yet.\n   */\n  startRegistrationCapture: () => Promise<void>;\n  /**\n   * Deprecated compatibility alias for `startRegistrationCapture()`.\n   */\n  openVerifySidebar: () => Promise<void>;\n  completeRegistration: (\n    walletClient: WalletClient,\n    params: OfframpParams,\n    options?: {\n      capturedMetadata?: PeerMetadataMessage;\n      onProgress?: OnProgress;\n      attestationServiceUrl?: string | null;\n    },\n  ) => Promise<OfframpResult>;\n}\n\n/**\n * React hook that drives the Peer extension handshake required for PayPal\n * and Wise makers.\n *\n * ```tsx\n * import { PLATFORMS } from \"@usdctofiat/offramp\";\n * import { useOfframp, usePeerExtensionRegistration } from \"@usdctofiat/offramp/react\";\n *\n * function PayPalSellButton() {\n *   const { offramp, lastError } = useOfframp();\n *   const peer = usePeerExtensionRegistration(PLATFORMS.PAYPAL);\n *\n *   const needsExtension = lastError?.code === \"EXTENSION_REGISTRATION_REQUIRED\";\n *\n *   return (\n *     <>\n *       <button onClick={() => offramp(walletClient, params)}>Sell USDC</button>\n *       {needsExtension && peer.phase === \"needs_install\" && (\n *         <button onClick={peer.installExtension}>Install Peer Extension</button>\n *       )}\n *       {needsExtension && peer.phase === \"needs_connection\" && (\n *         <button onClick={peer.connectExtension} disabled={peer.busy}>\n *           Connect Peer Extension\n *         </button>\n *       )}\n *       {needsExtension && peer.phase === \"ready\" && (\n *         <button onClick={peer.startRegistrationCapture}>Register with Peer</button>\n *       )}\n *     </>\n *   );\n * }\n * ```\n */\nexport function usePeerExtensionRegistration(\n  platform: PlatformEntry | null | undefined,\n): UsePeerExtensionRegistrationReturn {\n  const platformId = platform?.id ?? null;\n  const info = platformId ? getPeerExtensionRegistrationInfo(platformId) : null;\n  const authParams = useMemo(\n    () => (platformId ? getPeerExtensionRegistrationAuthParams(platformId) : null),\n    [platformId],\n  );\n  const [phase, setPhase] = useState<PeerExtensionRegistrationPhase>(\n    info ? \"checking\" : \"unsupported\",\n  );\n  const [busy, setBusy] = useState(false);\n  const [error, setError] = useState<string | null>(null);\n  const [capturedMetadata, setCapturedMetadata] = useState<PeerMetadataMessage | null>(null);\n  const mountedRef = useRef(true);\n  const providerId = info?.providerId ?? null;\n  const metadataPlatform = authParams?.platform ?? null;\n\n  const refresh = useCallback(async () => {\n    if (!providerId) {\n      setPhase(\"unsupported\");\n      return;\n    }\n    try {\n      const state = await peerExtensionSdk.getState();\n      if (!mountedRef.current) return;\n      if (state === \"ready\" && !isPeerExtensionMetadataBridgeAvailable()) {\n        setPhase(\"needs_install\");\n        return;\n      }\n      setPhase(mapSdkState(state));\n    } catch {\n      if (!mountedRef.current) return;\n      setPhase(\"needs_install\");\n    }\n  }, [providerId]);\n\n  useEffect(() => {\n    mountedRef.current = true;\n    setError(null);\n    setBusy(false);\n    setCapturedMetadata(null);\n    if (!providerId) {\n      setPhase(\"unsupported\");\n    } else {\n      setPhase(\"checking\");\n      refresh();\n    }\n    return () => {\n      mountedRef.current = false;\n    };\n  }, [providerId, refresh]);\n\n  useEffect(() => {\n    setCapturedMetadata(null);\n    if (!metadataPlatform) return;\n\n    try {\n      return peerExtensionSdk.onMetadataMessage((message) => {\n        if (!mountedRef.current || message.platform !== metadataPlatform) return;\n        setCapturedMetadata(message);\n        if (message.errorMessage) {\n          setError(message.errorMessage);\n        }\n      });\n    } catch {\n      return;\n    }\n  }, [metadataPlatform, phase]);\n\n  const installExtension = useCallback(() => {\n    setError(null);\n    try {\n      peerExtensionSdk.openInstallPage();\n    } catch {\n      if (typeof window !== \"undefined\") {\n        window.open(PEER_EXTENSION_CHROME_URL, \"_blank\", \"noopener,noreferrer\");\n      }\n    }\n  }, []);\n\n  const connectExtension = useCallback(async (): Promise<boolean> => {\n    if (!authParams) return false;\n    setError(null);\n    setBusy(true);\n    try {\n      const approved = await peerExtensionSdk.requestConnection();\n      if (!mountedRef.current) return approved;\n      if (approved) {\n        setPhase(isPeerExtensionMetadataBridgeAvailable() ? \"ready\" : \"needs_install\");\n      } else {\n        setError(\"Connection was not approved. Try again once you've approved Peer.\");\n      }\n      return approved;\n    } catch (err) {\n      if (!mountedRef.current) return false;\n      setError(\n        err instanceof Error\n          ? err.message\n          : \"Couldn't request a Peer extension connection. Make sure Peer is installed and enabled.\",\n      );\n      refresh();\n      return false;\n    } finally {\n      if (mountedRef.current) setBusy(false);\n    }\n  }, [authParams, refresh]);\n\n  const startRegistrationCapture = useCallback(async () => {\n    if (!authParams) return;\n    setError(null);\n    setBusy(true);\n    try {\n      const state = await peerExtensionSdk.getState().catch(() => \"needs_install\" as const);\n      if (!mountedRef.current) return;\n      const nextPhase =\n        state === \"ready\" && !isPeerExtensionMetadataBridgeAvailable()\n          ? \"needs_install\"\n          : mapSdkState(state);\n      setPhase(nextPhase);\n      if (nextPhase === \"needs_install\") {\n        installExtension();\n        return;\n      }\n      if (nextPhase === \"needs_connection\") {\n        const approved = await peerExtensionSdk.requestConnection();\n        if (!mountedRef.current) return;\n        if (!approved) {\n          setError(\"Connection was not approved. Try again once you've approved Peer.\");\n          return;\n        }\n        if (!isPeerExtensionMetadataBridgeAvailable()) {\n          setPhase(\"needs_install\");\n          installExtension();\n          return;\n        }\n        setPhase(\"ready\");\n      }\n      setCapturedMetadata(null);\n      peerExtensionSdk.authenticate(authParams);\n    } catch (err) {\n      setError(\n        err instanceof Error\n          ? err.message\n          : \"Couldn't start Peer extension registration. Make sure Peer is enabled.\",\n      );\n      refresh();\n    } finally {\n      if (mountedRef.current) setBusy(false);\n    }\n  }, [authParams, installExtension, refresh]);\n\n  const openVerifySidebar = useCallback(\n    async () => startRegistrationCapture(),\n    [startRegistrationCapture],\n  );\n\n  const completeRegistration = useCallback(\n    async (\n      walletClient: WalletClient,\n      params: OfframpParams,\n      options: {\n        capturedMetadata?: PeerMetadataMessage;\n        onProgress?: OnProgress;\n        attestationServiceUrl?: string | null;\n      } = {},\n    ): Promise<OfframpResult> => {\n      const metadata = options.capturedMetadata ?? capturedMetadata;\n      if (!metadata) {\n        const message = \"No Peer metadata captured yet. Start registration first.\";\n        setError(message);\n        throw new Error(message);\n      }\n\n      setError(null);\n      setBusy(true);\n      try {\n        await completePeerExtensionRegistration({\n          platform: params.platform,\n          identifier: params.identifier,\n          capturedMetadata: metadata,\n        });\n        return await createDeposit(walletClient, params, options.onProgress);\n      } catch (err) {\n        setError(\n          err instanceof Error\n            ? err.message\n            : \"Couldn't complete Peer extension registration. Try capturing metadata again.\",\n        );\n        throw err;\n      } finally {\n        if (mountedRef.current) setBusy(false);\n      }\n    },\n    [capturedMetadata],\n  );\n\n  return {\n    phase,\n    info,\n    busy,\n    error,\n    capturedMetadata,\n    refresh,\n    installExtension,\n    connectExtension,\n    startRegistrationCapture,\n    openVerifySidebar,\n    completeRegistration,\n  };\n}\n\nfunction mapSdkState(state: PeerExtensionState): PeerExtensionRegistrationPhase {\n  if (state === \"needs_install\") return \"needs_install\";\n  if (state === \"needs_connection\") return \"needs_connection\";\n  return \"ready\";\n}\n"],"mappings":"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","names":["offramp","useCallback","useRef","useState","useState","useRef","useCallback"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@usdctofiat/offramp",
-  "version": "3.0.2",
+  "version": "3.1.0",
   "description": "USDC-to-fiat offramp SDK — create delegated deposits in one function call",
   "license": "MIT",
   "author": "Galleon Labs",
@@ -51,14 +51,16 @@
     "test": "vitest run"
   },
   "dependencies": {
-    "@zkp2p/sdk": "0.4.0-rc.4",
+    "@zkp2p/contracts-v2": "0.2.2",
+    "@zkp2p/sdk": "0.4.3",
     "zod": "^4.3.6"
   },
   "devDependencies": {
+    "@types/react": "^19.2.9",
     "tsup": "^8.5.0",
     "typescript": "^6.0.3",
     "viem": "^2.48.8",
-    "vitest": "^4.1.2"
+    "vitest": "^4.1.7"
   },
   "peerDependencies": {
     "react": ">=18.0.0",