@usdctofiat/offramp 1.3.0 → 2.0.1

package/dist/index.cjs

@@ -22,12 +22,15 @@ var index_exports = {};
 __export(index_exports, {
   CURRENCIES: () => CURRENCIES,
   ESCROW_ADDRESS: () => ESCROW_ADDRESS,
+  MakersCreateError: () => MakersCreateError,
   OFFRAMP_ERROR_CODES: () => OFFRAMP_ERROR_CODES,
   Offramp: () => Offramp,
   OfframpError: () => OfframpError,
+  PEER_EXTENSION_CHROME_URL: () => import_sdk7.PEER_EXTENSION_CHROME_URL,
   PLATFORMS: () => PLATFORMS,
   close: () => close,
   createOfframp: () => createOfframp,
+  createPeerExtensionSdk: () => import_sdk7.createPeerExtensionSdk,
   createTelemetryContext: () => createTelemetryContext,
   delegate: () => delegate,
   deposits: () => deposits,
@@ -35,7 +38,14 @@ __export(index_exports, {
   emitEvent: () => emitEvent,
   enableOtc: () => enableOtc,
   getOtcLink: () => getOtcLink,
+  getPeerExtensionRegistrationInfo: () => getPeerExtensionRegistrationInfo,
+  getPeerExtensionState: () => import_sdk7.getPeerExtensionState,
+  isPeerExtensionAvailable: () => import_sdk7.isPeerExtensionAvailable,
+  isPeerExtensionRegistrationError: () => isPeerExtensionRegistrationError,
+  normalizePaypalMeUsername: () => normalizePaypalMeUsername,
   offramp: () => offramp,
+  openPeerExtensionInstallPage: () => import_sdk7.openPeerExtensionInstallPage,
+  peerExtensionSdk: () => import_sdk7.peerExtensionSdk,
   sanitizeAttributionId: () => sanitizeAttributionId,
   sendTelemetryEvent: () => sendTelemetryEvent,
   undelegate: () => undelegate
@@ -166,6 +176,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",
@@ -213,7 +234,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",
@@ -234,10 +261,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",
@@ -268,6 +303,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);
@@ -294,6 +330,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;
@@ -337,34 +376,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;
@@ -1153,23 +1194,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 {
@@ -1371,11 +1428,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",
@@ -1713,22 +1780,37 @@ 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",
   USER_CANCELLED: "USER_CANCELLED",
   UNSUPPORTED: "UNSUPPORTED"
 };
+
+// src/extension.ts
+var import_sdk7 = require("@zkp2p/sdk");
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   CURRENCIES,
   ESCROW_ADDRESS,
+  MakersCreateError,
   OFFRAMP_ERROR_CODES,
   Offramp,
   OfframpError,
+  PEER_EXTENSION_CHROME_URL,
   PLATFORMS,
   close,
   createOfframp,
+  createPeerExtensionSdk,
   createTelemetryContext,
   delegate,
   deposits,
@@ -1736,7 +1818,14 @@ var OFFRAMP_ERROR_CODES = {
   emitEvent,
   enableOtc,
   getOtcLink,
+  getPeerExtensionRegistrationInfo,
+  getPeerExtensionState,
+  isPeerExtensionAvailable,
+  isPeerExtensionRegistrationError,
+  normalizePaypalMeUsername,
   offramp,
+  openPeerExtensionInstallPage,
+  peerExtensionSdk,
   sanitizeAttributionId,
   sendTelemetryEvent,
   undelegate