@usdctofiat/offramp 1.3.0 → 2.0.1

package/dist/index.js

@@ -1,11 +1,14 @@
 import {
   CURRENCIES,
   ESCROW_ADDRESS,
+  MakersCreateError,
   Offramp,
   OfframpError,
+  PEER_EXTENSION_CHROME_URL,
   PLATFORMS,
   close,
   createOfframp,
+  createPeerExtensionSdk,
   createTelemetryContext,
   delegate,
   deposits,
@@ -13,17 +16,33 @@ import {
   emitEvent,
   enableOtc,
   getOtcLink,
+  getPeerExtensionRegistrationInfo,
+  getPeerExtensionState,
+  isPeerExtensionAvailable,
+  isPeerExtensionRegistrationError,
+  normalizePaypalMeUsername,
   offramp,
+  openPeerExtensionInstallPage,
+  peerExtensionSdk,
   sanitizeAttributionId,
   sendTelemetryEvent,
   undelegate
-} from "./chunk-JQBKGGI2.js";
+} from "./chunk-747S3WWB.js";
 
 // src/types.ts
 var OFFRAMP_ERROR_CODES = {
   VALIDATION: "VALIDATION",
   APPROVAL_FAILED: "APPROVAL_FAILED",
   REGISTRATION_FAILED: "REGISTRATION_FAILED",
+  /**
+   * Curator rejected the maker because the user has not registered this
+   * 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.
+   */
+  EXTENSION_REGISTRATION_REQUIRED: "EXTENSION_REGISTRATION_REQUIRED",
   DEPOSIT_FAILED: "DEPOSIT_FAILED",
   CONFIRMATION_FAILED: "CONFIRMATION_FAILED",
   DELEGATION_FAILED: "DELEGATION_FAILED",
@@ -33,12 +52,15 @@ var OFFRAMP_ERROR_CODES = {
 export {
   CURRENCIES,
   ESCROW_ADDRESS,
+  MakersCreateError,
   OFFRAMP_ERROR_CODES,
   Offramp,
   OfframpError,
+  PEER_EXTENSION_CHROME_URL,
   PLATFORMS,
   close,
   createOfframp,
+  createPeerExtensionSdk,
   createTelemetryContext,
   delegate,
   deposits,
@@ -46,7 +68,14 @@ export {
   emitEvent,
   enableOtc,
   getOtcLink,
+  getPeerExtensionRegistrationInfo,
+  getPeerExtensionState,
+  isPeerExtensionAvailable,
+  isPeerExtensionRegistrationError,
+  normalizePaypalMeUsername,
   offramp,
+  openPeerExtensionInstallPage,
+  peerExtensionSdk,
   sanitizeAttributionId,
   sendTelemetryEvent,
   undelegate

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  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,EACrB,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 `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":[]}

package/dist/react.cjs

@@ -20,7 +20,8 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/react.ts
 var react_exports = {};
 __export(react_exports, {
-  useOfframp: () => useOfframp
+  useOfframp: () => useOfframp,
+  usePeerExtensionRegistration: () => usePeerExtensionRegistration
 });
 module.exports = __toCommonJS(react_exports);
 
@@ -169,6 +170,17 @@ function resolveSupportedCurrencies(platform) {
   }
   return Array.from(codes).sort();
 }
+function normalizePaypalMeUsername(value) {
+  const trimmed = value.trim();
+  if (!trimmed) return "";
+  const withoutProtocol = trimmed.replace(/^https?:\/\//i, "").replace(/^www\./i, "");
+  if (/^paypal\.me(?:[?#].*)?$/i.test(withoutProtocol)) return "";
+  const withoutDomain = withoutProtocol.replace(/^paypal\.me\//i, "");
+  const [pathWithoutQuery] = withoutDomain.split(/[?#]/, 1);
+  const sanitizedPath = pathWithoutQuery.replace(/^\/+/, "");
+  const [username] = sanitizedPath.split("/", 1);
+  return username.replace(/^@+/, "").trim().toLowerCase();
+}
 var BLUEPRINTS = {
   venmo: {
     id: "venmo",
@@ -216,7 +228,13 @@ var BLUEPRINTS = {
     placeholder: "wisetag (no @)",
     helperText: "Your Wise @wisetag (no @)",
     validation: import_zod.z.string().min(1).regex(/^[a-zA-Z0-9_-]+$/),
-    transform: (v) => v.replace(/^@+/, "").trim()
+    transform: (v) => v.replace(/^@+/, "").trim(),
+    extensionRegistration: {
+      providerId: "wise",
+      requiredPrompt: "This Wisetag is not registered yet. Verify it in the Peer extension, then refresh and retry with the same Wisetag.",
+      ctaLabel: "Install Peer Extension",
+      minExtensionVersion: "0.4.12"
+    }
   },
   mercadopago: {
     id: "mercadopago",
@@ -237,10 +255,18 @@ var BLUEPRINTS = {
   paypal: {
     id: "paypal",
     name: "PayPal",
-    identifierLabel: "Email",
-    placeholder: "email",
-    helperText: "Email linked to PayPal account",
-    validation: import_zod.z.string().email()
+    identifierLabel: "PayPal.me Username",
+    placeholder: "paypal.me/your-username",
+    helperText: "Your PayPal.me username, not your email",
+    validation: import_zod.z.string().min(1, "PayPal.me username is required").regex(/^[a-z0-9._-]+$/i, "Use your PayPal.me username (letters, numbers, . _ -)"),
+    transform: normalizePaypalMeUsername,
+    extensionRegistration: {
+      providerId: "paypal",
+      requiredPrompt: "This PayPal username is not registered yet. Verify it in the Peer extension, then refresh and retry with the same PayPal username.",
+      ctaLabel: "Install Peer Extension",
+      ctaSubtext: "PayPal Business accounts are not supported at this time.",
+      minExtensionVersion: "0.4.14"
+    }
   },
   monzo: {
     id: "monzo",
@@ -271,6 +297,7 @@ function buildPlatformEntry(bp) {
       placeholder: bp.placeholder,
       help: bp.helperText
     },
+    ...bp.extensionRegistration ? { extensionRegistration: bp.extensionRegistration } : {},
     validate(input) {
       const transformed = bp.transform ? bp.transform(input) : input;
       const result = bp.validation.safeParse(transformed);
@@ -297,6 +324,9 @@ var PLATFORMS = {
   MONZO: buildPlatformEntry(BLUEPRINTS.monzo),
   N26: buildPlatformEntry(BLUEPRINTS.n26)
 };
+function getPlatformById(id) {
+  return Object.values(PLATFORMS).find((p) => p.id === id) ?? null;
+}
 function normalizePaymentMethodLookupName(platform) {
   const normalized = platform.trim().toLowerCase();
   if (!normalized) return null;
@@ -340,34 +370,36 @@ function getPaymentMethodHashes(platform) {
   }
   return Array.from(hashes);
 }
-function buildDepositData(platform, identifier) {
-  switch (platform) {
-    case "venmo":
-      return { venmoUsername: identifier, telegramUsername: "" };
-    case "cashapp":
-      return { cashtag: identifier, telegramUsername: "" };
-    case "chime":
-      return { chimesign: identifier.toLowerCase(), telegramUsername: "" };
-    case "revolut":
-      return { revolutUsername: identifier, telegramUsername: "" };
-    case "wise":
-      return { wisetag: identifier, telegramUsername: "" };
-    case "mercadopago":
-      return { cvu: identifier, telegramUsername: "" };
-    case "zelle":
-      return { zelleEmail: identifier, telegramUsername: "" };
-    case "paypal":
-      return { paypalEmail: identifier, telegramUsername: "" };
-    case "monzo":
-      return { monzoMeUsername: identifier, telegramUsername: "" };
-    case "n26":
-      return { iban: identifier, telegramUsername: "" };
-    default:
-      return { identifier, telegramUsername: "" };
-  }
+function buildDepositData(platform, identifier, telegramUsername = "") {
+  const offchainId = platform === "chime" ? identifier.toLowerCase() : identifier;
+  return telegramUsername ? { offchainId, telegramUsername } : { offchainId };
+}
+function getPeerExtensionRegistrationInfo(platform) {
+  const entry = getPlatformById(platform);
+  return entry?.extensionRegistration ?? null;
+}
+var EXTENSION_REGISTRATION_ERROR_PATTERNS = ["creating the maker", "create the maker"];
+function isPeerExtensionRegistrationError(platform, message, statusCode) {
+  const info = getPeerExtensionRegistrationInfo(platform);
+  if (!info) return false;
+  if (statusCode === 400) return true;
+  const normalized = (message ?? "").trim();
+  if (!normalized) return false;
+  const lower = normalized.toLowerCase();
+  return EXTENSION_REGISTRATION_ERROR_PATTERNS.some((p) => lower.includes(p));
 }
 
 // src/errors.ts
+var MakersCreateError = class extends Error {
+  status;
+  body;
+  constructor(message, status, body) {
+    super(message);
+    this.name = "MakersCreateError";
+    this.status = status;
+    this.body = body;
+  }
+};
 var OfframpError = class extends Error {
   code;
   step;
@@ -1069,23 +1101,39 @@ function extractDepositIdFromLogs(logs) {
   }
   return null;
 }
-async function registerPayeeDetails(processorName, depositData) {
+async function registerPayeeDetails(processorName, payload) {
   const controller = new AbortController();
   const timeout = setTimeout(() => controller.abort(), PAYEE_REGISTRATION_TIMEOUT_MS);
   try {
-    const res = await fetch(`${API_BASE_URL}/v1/makers/create`, {
+    const res = await fetch(`${API_BASE_URL}/v2/makers/create`, {
       method: "POST",
       headers: { "Content-Type": "application/json" },
-      body: JSON.stringify({ processorName, depositData }),
+      body: JSON.stringify({ processorName, ...payload }),
       signal: controller.signal
     });
     if (!res.ok) {
       const txt = await res.text().catch(() => "");
-      throw new Error(`makers/create failed (${res.status}): ${txt || res.statusText}`);
+      let detail = txt || res.statusText;
+      try {
+        const parsed = JSON.parse(txt);
+        if (typeof parsed.message === "string" && parsed.message.trim()) {
+          detail = parsed.message;
+        }
+      } catch {
+      }
+      throw new MakersCreateError(
+        `makers/create failed (${res.status}): ${detail}`,
+        res.status,
+        txt
+      );
     }
     const json = await res.json();
     if (!json.success || !json.responseObject?.hashedOnchainId) {
-      throw new Error(json.message || "makers/create returned no hashedOnchainId");
+      throw new MakersCreateError(
+        json.message || "makers/create returned no hashedOnchainId",
+        json.statusCode ?? null,
+        ""
+      );
     }
     return json.responseObject.hashedOnchainId;
   } finally {
@@ -1287,11 +1335,21 @@ async function offramp(walletClient, params, onProgress, telemetryContext) {
     }
     emitProgress({ step: "registering" });
     let hashedOnchainId;
+    const canonicalName = platformId.startsWith("zelle") ? "zelle" : platformId;
     try {
-      const canonicalName = platformId.startsWith("zelle") ? "zelle" : platformId;
-      const depositData = buildDepositData(platformId, normalizedIdentifier);
-      hashedOnchainId = await registerPayeeDetails(canonicalName, depositData);
+      const payeePayload = buildDepositData(canonicalName, normalizedIdentifier);
+      hashedOnchainId = await registerPayeeDetails(canonicalName, payeePayload);
     } catch (err) {
+      const status = err instanceof MakersCreateError ? err.status : null;
+      const message = err instanceof Error ? err.message : String(err);
+      if (isPeerExtensionRegistrationError(canonicalName, message, status)) {
+        throw new OfframpError(
+          `${platform.name} maker is not yet registered in the Peer extension. Verify this handle in the extension, then retry.`,
+          "EXTENSION_REGISTRATION_REQUIRED",
+          "registering",
+          err
+        );
+      }
       throw new OfframpError(
         "Payee registration failed",
         "REGISTRATION_FAILED",
@@ -1685,8 +1743,129 @@ function useOfframp(defaultOptions = {}) {
     reset
   };
 }
+
+// src/hooks/usePeerExtensionRegistration.ts
+var import_react2 = require("react");
+
+// src/extension.ts
+var import_sdk7 = require("@zkp2p/sdk");
+
+// src/hooks/usePeerExtensionRegistration.ts
+function usePeerExtensionRegistration(platform) {
+  const info = platform ? getPeerExtensionRegistrationInfo(platform.id) : null;
+  const [phase, setPhase] = (0, import_react2.useState)(
+    info ? "checking" : "unsupported"
+  );
+  const [busy, setBusy] = (0, import_react2.useState)(false);
+  const [error, setError] = (0, import_react2.useState)(null);
+  const mountedRef = (0, import_react2.useRef)(true);
+  const providerId = info?.providerId ?? null;
+  const refresh = (0, import_react2.useCallback)(async () => {
+    if (!providerId) {
+      setPhase("unsupported");
+      return;
+    }
+    try {
+      const state = await import_sdk7.peerExtensionSdk.getState();
+      if (!mountedRef.current) return;
+      setPhase(mapSdkState(state));
+    } catch {
+      if (!mountedRef.current) return;
+      setPhase("needs_install");
+    }
+  }, [providerId]);
+  (0, import_react2.useEffect)(() => {
+    mountedRef.current = true;
+    setError(null);
+    setBusy(false);
+    if (!providerId) {
+      setPhase("unsupported");
+    } else {
+      setPhase("checking");
+      refresh();
+    }
+    return () => {
+      mountedRef.current = false;
+    };
+  }, [providerId, refresh]);
+  const installExtension = (0, import_react2.useCallback)(() => {
+    setError(null);
+    try {
+      import_sdk7.peerExtensionSdk.openInstallPage();
+    } catch {
+      if (typeof window !== "undefined") {
+        window.open(import_sdk7.PEER_EXTENSION_CHROME_URL, "_blank", "noopener,noreferrer");
+      }
+    }
+  }, []);
+  const connectExtension = (0, import_react2.useCallback)(async () => {
+    if (!providerId) return false;
+    setError(null);
+    setBusy(true);
+    try {
+      const approved = await import_sdk7.peerExtensionSdk.requestConnection();
+      if (!mountedRef.current) return approved;
+      if (approved) {
+        setPhase("ready");
+        import_sdk7.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 = (0, import_react2.useCallback)(async () => {
+    if (!providerId) return;
+    setError(null);
+    const state = await import_sdk7.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 {
+      import_sdk7.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";
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  useOfframp
+  useOfframp,
+  usePeerExtensionRegistration
 });
 //# sourceMappingURL=react.cjs.map