@usdctofiat/offramp 1.1.4 → 2.0.0

package/dist/react.d.cts

@@ -1,11 +1,14 @@
 import { WalletClient } from 'viem';
-import { h as OfframpStep, e as OfframpError, O as OfframpParams, b as OfframpResult, D as DepositInfo } from './errors-Dtzrl98J.cjs';
+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-Deoi_xYZ.cjs';
 import '@zkp2p/sdk';
 
 interface UseOfframpReturn {
+    state: OfframpState;
     step: OfframpStep | null;
     txHash: string | null;
     depositId: string | null;
+    lastError: OfframpError | null;
+    /** @deprecated Use `lastError` instead. */
     error: OfframpError | null;
     isLoading: boolean;
     offramp: (walletClient: WalletClient, params: OfframpParams) => Promise<OfframpResult>;
@@ -13,6 +16,90 @@ interface UseOfframpReturn {
     close: (walletClient: WalletClient, depositId: string, escrowAddress?: string) => Promise<string>;
     reset: () => void;
 }
-declare function useOfframp(): UseOfframpReturn;
+declare function useOfframp(defaultOptions?: OfframpCreateOptions): UseOfframpReturn;
 
-export { type UseOfframpReturn, useOfframp };
+/**
+ * Phase surfaced to callers:
+ * - `checking` — polling the extension state on mount
+ * - `needs_install` — the Peer extension is not installed; call
+ *   `installExtension()` or surface the install URL
+ * - `needs_connection` — the extension is installed but this origin is not
+ *   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
+ * - `unsupported` — the provided platform does not require extension
+ *   registration; the hook is a no-op for it
+ */
+type PeerExtensionRegistrationPhase = "checking" | "needs_install" | "needs_connection" | "ready" | "unsupported";
+interface UsePeerExtensionRegistrationReturn {
+    /** Current handshake phase. */
+    phase: PeerExtensionRegistrationPhase;
+    /**
+     * Registration metadata for this platform (prompt copy, CTA label, min
+     * extension version). `null` for platforms that don't require extension
+     * registration, in which case `phase === "unsupported"`.
+     */
+    info: PeerExtensionRegistrationInfo | null;
+    /** True while a `requestConnection()` or initial state check is in flight. */
+    busy: boolean;
+    /** Last error from `requestConnection()` / `openSidebar()`, if any. */
+    error: string | null;
+    /** Re-poll `peerExtensionSdk.getState()`. Call after the user confirms they've finished the verify flow. */
+    refresh: () => Promise<void>;
+    /**
+     * Open the Chrome Web Store listing for the Peer extension. Falls back to
+     * `window.open(PEER_EXTENSION_CHROME_URL)` outside of browsers where
+     * `openInstallPage()` would throw.
+     */
+    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.
+     */
+    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.
+     */
+    openVerifySidebar: () => Promise<void>;
+}
+/**
+ * React hook that drives the Peer extension handshake required for PayPal
+ * and Wise makers. Mirrors the CTA state machine used in usdctofiat.xyz.
+ *
+ * ```tsx
+ * import { PLATFORMS, useOfframp } from "@usdctofiat/offramp";
+ * import { usePeerExtensionRegistration } from "@usdctofiat/offramp/react";
+ *
+ * function PayPalSellButton() {
+ *   const { offramp, lastError } = useOfframp();
+ *   const peer = usePeerExtensionRegistration(PLATFORMS.PAYPAL);
+ *
+ *   const needsExtension = lastError?.code === "EXTENSION_REGISTRATION_REQUIRED";
+ *
+ *   return (
+ *     <>
+ *       <button onClick={() => offramp(walletClient, params)}>Sell USDC</button>
+ *       {needsExtension && peer.phase === "needs_install" && (
+ *         <button onClick={peer.installExtension}>Install Peer Extension</button>
+ *       )}
+ *       {needsExtension && peer.phase === "needs_connection" && (
+ *         <button onClick={peer.connectExtension} disabled={peer.busy}>
+ *           Connect Peer Extension
+ *         </button>
+ *       )}
+ *       {needsExtension && peer.phase === "ready" && (
+ *         <button onClick={peer.openVerifySidebar}>Verify in Peer</button>
+ *       )}
+ *     </>
+ *   );
+ * }
+ * ```
+ */
+declare function usePeerExtensionRegistration(platform: PlatformEntry | null | undefined): UsePeerExtensionRegistrationReturn;
+
+export { type PeerExtensionRegistrationPhase, type UseOfframpReturn, type UsePeerExtensionRegistrationReturn, useOfframp, usePeerExtensionRegistration };

package/dist/react.d.ts

@@ -1,11 +1,14 @@
 import { WalletClient } from 'viem';
-import { h as OfframpStep, e as OfframpError, O as OfframpParams, b as OfframpResult, D as DepositInfo } from './errors-Dtzrl98J.js';
+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-Deoi_xYZ.js';
 import '@zkp2p/sdk';
 
 interface UseOfframpReturn {
+    state: OfframpState;
     step: OfframpStep | null;
     txHash: string | null;
     depositId: string | null;
+    lastError: OfframpError | null;
+    /** @deprecated Use `lastError` instead. */
     error: OfframpError | null;
     isLoading: boolean;
     offramp: (walletClient: WalletClient, params: OfframpParams) => Promise<OfframpResult>;
@@ -13,6 +16,90 @@ interface UseOfframpReturn {
     close: (walletClient: WalletClient, depositId: string, escrowAddress?: string) => Promise<string>;
     reset: () => void;
 }
-declare function useOfframp(): UseOfframpReturn;
+declare function useOfframp(defaultOptions?: OfframpCreateOptions): UseOfframpReturn;
 
-export { type UseOfframpReturn, useOfframp };
+/**
+ * Phase surfaced to callers:
+ * - `checking` — polling the extension state on mount
+ * - `needs_install` — the Peer extension is not installed; call
+ *   `installExtension()` or surface the install URL
+ * - `needs_connection` — the extension is installed but this origin is not
+ *   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
+ * - `unsupported` — the provided platform does not require extension
+ *   registration; the hook is a no-op for it
+ */
+type PeerExtensionRegistrationPhase = "checking" | "needs_install" | "needs_connection" | "ready" | "unsupported";
+interface UsePeerExtensionRegistrationReturn {
+    /** Current handshake phase. */
+    phase: PeerExtensionRegistrationPhase;
+    /**
+     * Registration metadata for this platform (prompt copy, CTA label, min
+     * extension version). `null` for platforms that don't require extension
+     * registration, in which case `phase === "unsupported"`.
+     */
+    info: PeerExtensionRegistrationInfo | null;
+    /** True while a `requestConnection()` or initial state check is in flight. */
+    busy: boolean;
+    /** Last error from `requestConnection()` / `openSidebar()`, if any. */
+    error: string | null;
+    /** Re-poll `peerExtensionSdk.getState()`. Call after the user confirms they've finished the verify flow. */
+    refresh: () => Promise<void>;
+    /**
+     * Open the Chrome Web Store listing for the Peer extension. Falls back to
+     * `window.open(PEER_EXTENSION_CHROME_URL)` outside of browsers where
+     * `openInstallPage()` would throw.
+     */
+    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.
+     */
+    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.
+     */
+    openVerifySidebar: () => Promise<void>;
+}
+/**
+ * React hook that drives the Peer extension handshake required for PayPal
+ * and Wise makers. Mirrors the CTA state machine used in usdctofiat.xyz.
+ *
+ * ```tsx
+ * import { PLATFORMS, useOfframp } from "@usdctofiat/offramp";
+ * import { usePeerExtensionRegistration } from "@usdctofiat/offramp/react";
+ *
+ * function PayPalSellButton() {
+ *   const { offramp, lastError } = useOfframp();
+ *   const peer = usePeerExtensionRegistration(PLATFORMS.PAYPAL);
+ *
+ *   const needsExtension = lastError?.code === "EXTENSION_REGISTRATION_REQUIRED";
+ *
+ *   return (
+ *     <>
+ *       <button onClick={() => offramp(walletClient, params)}>Sell USDC</button>
+ *       {needsExtension && peer.phase === "needs_install" && (
+ *         <button onClick={peer.installExtension}>Install Peer Extension</button>
+ *       )}
+ *       {needsExtension && peer.phase === "needs_connection" && (
+ *         <button onClick={peer.connectExtension} disabled={peer.busy}>
+ *           Connect Peer Extension
+ *         </button>
+ *       )}
+ *       {needsExtension && peer.phase === "ready" && (
+ *         <button onClick={peer.openVerifySidebar}>Verify in Peer</button>
+ *       )}
+ *     </>
+ *   );
+ * }
+ * ```
+ */
+declare function usePeerExtensionRegistration(platform: PlatformEntry | null | undefined): UsePeerExtensionRegistrationReturn;
+
+export { type PeerExtensionRegistrationPhase, type UseOfframpReturn, type UsePeerExtensionRegistrationReturn, useOfframp, usePeerExtensionRegistration };

package/dist/react.js

@@ -1,42 +1,61 @@
 import {
   OfframpError,
+  PEER_EXTENSION_CHROME_URL,
   close,
+  createOfframp,
   deposits,
-  offramp
-} from "./chunk-OJY6DE3I.js";
+  getPeerExtensionRegistrationInfo,
+  peerExtensionSdk
+} from "./chunk-HBR3Z6HX.js";
 
 // src/hooks/useOfframp.ts
 import { useCallback, useRef, useState } from "react";
-function useOfframp() {
+function mapStepToState(step) {
+  if (step === "resuming" || step === "restricting") return "delegating";
+  if (step === "done") return "done";
+  return step;
+}
+function useOfframp(defaultOptions = {}) {
+  const [state, setState] = useState("idle");
   const [step, setStep] = useState(null);
   const [txHash, setTxHash] = useState(null);
   const [depositId, setDepositId] = useState(null);
-  const [error, setError] = useState(null);
+  const [lastError, setLastError] = useState(null);
   const [isLoading, setIsLoading] = useState(false);
   const lockRef = useRef(false);
   const reset = useCallback(() => {
+    setState("idle");
     setStep(null);
     setTxHash(null);
     setDepositId(null);
-    setError(null);
+    setLastError(null);
     setIsLoading(false);
     lockRef.current = false;
   }, []);
-  const offramp2 = useCallback(
+  const offramp = useCallback(
     async (walletClient, params) => {
       if (lockRef.current) throw new OfframpError("Deposit already in progress", "VALIDATION");
       lockRef.current = true;
       setIsLoading(true);
-      setError(null);
+      setState("idle");
+      setLastError(null);
       setStep(null);
       setTxHash(null);
       setDepositId(null);
       try {
-        const result = await offramp(walletClient, params, (progress) => {
+        const sdk = createOfframp({
+          walletClient,
+          integratorId: params.integratorId ?? defaultOptions.integratorId,
+          referralId: params.referralId ?? defaultOptions.referralId,
+          telemetry: defaultOptions.telemetry
+        });
+        const result = await sdk.createDeposit(params, (progress) => {
           setStep(progress.step);
+          setState(mapStepToState(progress.step));
           if (progress.txHash) setTxHash(progress.txHash);
           if (progress.depositId) setDepositId(progress.depositId);
         });
+        setState("done");
         setDepositId(result.depositId);
         setTxHash(result.txHash);
         return result;
@@ -45,28 +64,147 @@ function useOfframp() {
           err instanceof Error ? err.message : "Offramp failed",
           "DEPOSIT_FAILED"
         );
-        setError(offrampError);
-        throw err;
+        setLastError(offrampError);
+        setState("error");
+        throw offrampError;
       } finally {
         setIsLoading(false);
         lockRef.current = false;
       }
     },
-    []
+    [defaultOptions.integratorId, defaultOptions.referralId, defaultOptions.telemetry]
   );
   return {
+    state,
     step,
     txHash,
     depositId,
-    error,
+    lastError,
+    error: lastError,
     isLoading,
-    offramp: offramp2,
+    offramp,
     deposits,
     close,
     reset
   };
 }
+
+// src/hooks/usePeerExtensionRegistration.ts
+import { useCallback as useCallback2, useEffect, useRef as useRef2, useState as useState2 } from "react";
+function usePeerExtensionRegistration(platform) {
+  const info = platform ? getPeerExtensionRegistrationInfo(platform.id) : null;
+  const [phase, setPhase] = useState2(
+    info ? "checking" : "unsupported"
+  );
+  const [busy, setBusy] = useState2(false);
+  const [error, setError] = useState2(null);
+  const mountedRef = useRef2(true);
+  const providerId = info?.providerId ?? null;
+  const refresh = useCallback2(async () => {
+    if (!providerId) {
+      setPhase("unsupported");
+      return;
+    }
+    try {
+      const state = await peerExtensionSdk.getState();
+      if (!mountedRef.current) return;
+      setPhase(mapSdkState(state));
+    } catch {
+      if (!mountedRef.current) return;
+      setPhase("needs_install");
+    }
+  }, [providerId]);
+  useEffect(() => {
+    mountedRef.current = true;
+    setError(null);
+    setBusy(false);
+    if (!providerId) {
+      setPhase("unsupported");
+    } else {
+      setPhase("checking");
+      refresh();
+    }
+    return () => {
+      mountedRef.current = false;
+    };
+  }, [providerId, refresh]);
+  const installExtension = useCallback2(() => {
+    setError(null);
+    try {
+      peerExtensionSdk.openInstallPage();
+    } catch {
+      if (typeof window !== "undefined") {
+        window.open(PEER_EXTENSION_CHROME_URL, "_blank", "noopener,noreferrer");
+      }
+    }
+  }, []);
+  const connectExtension = useCallback2(async () => {
+    if (!providerId) 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}`);
+      } else {
+        setError("Connection was not approved. Try again once you've approved Peer.");
+      }
+      return approved;
+    } catch (err) {
+      if (!mountedRef.current) return false;
+      setError(
+        err instanceof Error ? err.message : "Couldn't request a Peer extension connection. Make sure Peer is installed and enabled."
+      );
+      refresh();
+      return false;
+    } finally {
+      if (mountedRef.current) setBusy(false);
+    }
+  }, [providerId, refresh]);
+  const openVerifySidebar = useCallback2(async () => {
+    if (!providerId) 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;
+    }
+    try {
+      peerExtensionSdk.openSidebar(`/verify/${providerId}`);
+    } catch (err) {
+      setError(
+        err instanceof Error ? err.message : "Couldn't open the Peer extension. Make sure it's enabled."
+      );
+      refresh();
+    }
+  }, [connectExtension, installExtension, providerId, refresh]);
+  return {
+    phase,
+    info,
+    busy,
+    error,
+    refresh,
+    installExtension,
+    connectExtension,
+    openVerifySidebar
+  };
+}
+function mapSdkState(state) {
+  if (state === "needs_install") return "needs_install";
+  if (state === "needs_connection") return "needs_connection";
+  return "ready";
+}
 export {
-  useOfframp
+  useOfframp,
+  usePeerExtensionRegistration
 };
 //# sourceMappingURL=react.js.map

package/dist/react.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/hooks/useOfframp.ts"],"sourcesContent":["import { useCallback, useRef, useState } from \"react\";\nimport type { WalletClient } from \"viem\";\nimport type { OfframpParams, OfframpResult, OfframpStep, DepositInfo } from \"../types\";\nimport { offramp as offrampFn } from \"../deposit\";\nimport { deposits as depositsFn, close as closeFn } from \"../queries\";\nimport { OfframpError } from \"../errors\";\n\nexport interface UseOfframpReturn {\n  step: OfframpStep | null;\n  txHash: string | null;\n  depositId: string | null;\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\nexport function useOfframp(): UseOfframpReturn {\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 [error, setError] = useState<OfframpError | null>(null);\n  const [isLoading, setIsLoading] = useState(false);\n  const lockRef = useRef(false);\n\n  const reset = useCallback(() => {\n    setStep(null);\n    setTxHash(null);\n    setDepositId(null);\n    setError(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      setError(null);\n      setStep(null);\n      setTxHash(null);\n      setDepositId(null);\n\n      try {\n        const result = await offrampFn(walletClient, params, (progress) => {\n          setStep(progress.step);\n          if (progress.txHash) setTxHash(progress.txHash);\n          if (progress.depositId) setDepositId(progress.depositId);\n        });\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        setError(offrampError);\n        throw err;\n      } finally {\n        setIsLoading(false);\n        lockRef.current = false;\n      }\n    },\n    [],\n  );\n\n  return {\n    step,\n    txHash,\n    depositId,\n    error,\n    isLoading,\n    offramp,\n    deposits: depositsFn,\n    close: closeFn,\n    reset,\n  };\n}\n"],"mappings":";;;;;;;;AAAA,SAAS,aAAa,QAAQ,gBAAgB;AAmBvC,SAAS,aAA+B;AAC7C,QAAM,CAAC,MAAM,OAAO,IAAI,SAA6B,IAAI;AACzD,QAAM,CAAC,QAAQ,SAAS,IAAI,SAAwB,IAAI;AACxD,QAAM,CAAC,WAAW,YAAY,IAAI,SAAwB,IAAI;AAC9D,QAAM,CAAC,OAAO,QAAQ,IAAI,SAA8B,IAAI;AAC5D,QAAM,CAAC,WAAW,YAAY,IAAI,SAAS,KAAK;AAChD,QAAM,UAAU,OAAO,KAAK;AAE5B,QAAM,QAAQ,YAAY,MAAM;AAC9B,YAAQ,IAAI;AACZ,cAAU,IAAI;AACd,iBAAa,IAAI;AACjB,aAAS,IAAI;AACb,iBAAa,KAAK;AAClB,YAAQ,UAAU;AAAA,EACpB,GAAG,CAAC,CAAC;AAEL,QAAMA,WAAU;AAAA,IACd,OAAO,cAA4B,WAAkD;AACnF,UAAI,QAAQ,QAAS,OAAM,IAAI,aAAa,+BAA+B,YAAY;AACvF,cAAQ,UAAU;AAClB,mBAAa,IAAI;AACjB,eAAS,IAAI;AACb,cAAQ,IAAI;AACZ,gBAAU,IAAI;AACd,mBAAa,IAAI;AAEjB,UAAI;AACF,cAAM,SAAS,MAAM,QAAU,cAAc,QAAQ,CAAC,aAAa;AACjE,kBAAQ,SAAS,IAAI;AACrB,cAAI,SAAS,OAAQ,WAAU,SAAS,MAAM;AAC9C,cAAI,SAAS,UAAW,cAAa,SAAS,SAAS;AAAA,QACzD,CAAC;AACD,qBAAa,OAAO,SAAS;AAC7B,kBAAU,OAAO,MAAM;AACvB,eAAO;AAAA,MACT,SAAS,KAAK;AACZ,cAAM,eACJ,eAAe,eACX,MACA,IAAI;AAAA,UACF,eAAe,QAAQ,IAAI,UAAU;AAAA,UACrC;AAAA,QACF;AACN,iBAAS,YAAY;AACrB,cAAM;AAAA,MACR,UAAE;AACA,qBAAa,KAAK;AAClB,gBAAQ,UAAU;AAAA,MACpB;AAAA,IACF;AAAA,IACA,CAAC;AAAA,EACH;AAEA,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA,SAAAA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF;AACF;","names":["offramp"]}
+{"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, useOfframp } from \"@usdctofiat/offramp\";\n * import { 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"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@usdctofiat/offramp",
-  "version": "1.1.4",
+  "version": "2.0.0",
   "description": "USDC-to-fiat offramp SDK — create delegated deposits in one function call",
   "license": "MIT",
   "author": "Galleon Labs",
@@ -11,7 +11,8 @@
   },
   "files": [
     "dist",
-    "README.md"
+    "README.md",
+    "CHANGELOG.md"
   ],
   "type": "module",
   "main": "./dist/index.cjs",
@@ -39,27 +40,37 @@
       }
     }
   },
+  "publishConfig": {
+    "access": "public"
+  },
   "scripts": {
     "build": "tsup",
     "typecheck": "tsgo --noEmit",
     "prepublishOnly": "tsup",
-    "lint": "oxlint -c ../../.oxlintrc.json ."
+    "lint": "oxlint -c ../../.oxlintrc.json .",
+    "test": "vitest run"
   },
   "dependencies": {
-    "@zkp2p/sdk": "0.3.1",
-    "viem": "^2.45.0",
+    "@zkp2p/sdk": "0.3.2",
     "zod": "^4.3.6"
   },
   "devDependencies": {
     "tsup": "^8.5.0",
-    "typescript": "^6.0.2"
+    "typescript": "^6.0.2",
+    "viem": "^2.45.0",
+    "vitest": "^4.1.2"
   },
   "peerDependencies": {
-    "react": ">=18.0.0"
+    "react": ">=18.0.0",
+    "react-dom": ">=18.0.0",
+    "viem": "^2"
   },
   "peerDependenciesMeta": {
     "react": {
       "optional": true
+    },
+    "react-dom": {
+      "optional": true
     }
   },
   "engines": {