@zkp2p/sdk 0.3.0 → 0.3.2-rc.0

package/dist/index.cjs

@@ -254,9 +254,6 @@ function uniqueAddresses(...values) {
   }
   return addresses;
 }
-function addressesEqual(left, right) {
-  return Boolean(left && right && left.toLowerCase() === right.toLowerCase());
-}
 function readRuntimeEnv(key) {
   try {
     const meta = ({ url: (typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('index.cjs', document.baseURI).href)) });
@@ -288,26 +285,19 @@ function getContracts(chainId, env = "production") {
     "ProtocolViewerV2"
   ]);
   const baseV2ProtocolViewerAddress = pickAddress(baseContracts, ["ProtocolViewerV2"]);
-  const baseV1ProtocolViewerAddress = pickAddress(baseContracts, ["ProtocolViewer"]);
   const baseProtocolViewerEntries = (() => {
     const entries = [];
     if (baseV2ProtocolViewerAddress && baseV2ProtocolViewerAbi) {
       entries.push({ address: baseV2ProtocolViewerAddress, abi: baseV2ProtocolViewerAbi });
     }
-    if (baseV1ProtocolViewerAddress && !addressesEqual(baseV1ProtocolViewerAddress, baseV2ProtocolViewerAddress)) {
-      entries.push({ address: baseV1ProtocolViewerAddress, abi: ProtocolViewerBase__default.default });
-    }
     return entries.length > 0 ? entries : void 0;
   })();
   const addressesByKey = {
     base: {
-      escrow: pickAddress(baseContracts, ["EscrowV2", "Escrow_V2"]) ?? pickAddress(baseContracts, ["Escrow"]) ?? "",
+      escrow: pickAddress(baseContracts, ["EscrowV2", "Escrow_V2"]) ?? "",
       escrowV2: pickAddress(baseContracts, ["EscrowV2", "Escrow_V2"]),
-      escrowAddresses: uniqueAddresses(
-        pickAddress(baseContracts, ["EscrowV2", "Escrow_V2"]),
-        pickAddress(baseContracts, ["Escrow"])
-      ),
-      orchestrator: pickAddress(baseContracts, ["OrchestratorV2", "Orchestrator_V2"]) ?? pickAddress(baseContracts, ["Orchestrator"]),
+      escrowAddresses: uniqueAddresses(pickAddress(baseContracts, ["EscrowV2", "Escrow_V2"])),
+      orchestrator: pickAddress(baseContracts, ["OrchestratorV2", "Orchestrator_V2"]),
       orchestratorV2: pickAddress(baseContracts, ["OrchestratorV2", "Orchestrator_V2"]),
       orchestratorAddresses: uniqueAddresses(
         pickAddress(baseContracts, ["OrchestratorV2", "Orchestrator_V2"])
@@ -317,7 +307,7 @@ function getContracts(chainId, env = "production") {
         "UnifiedPaymentVerifier"
       ]),
       unifiedPaymentVerifierV2: pickAddress(baseContracts, ["UnifiedPaymentVerifierV2"]),
-      protocolViewer: baseProtocolViewerEntries?.[0]?.address ?? baseV1ProtocolViewerAddress ?? baseV2ProtocolViewerAddress,
+      protocolViewer: baseProtocolViewerEntries?.[0]?.address ?? baseV2ProtocolViewerAddress,
       protocolViewerEntries: baseProtocolViewerEntries,
       usdc: baseConstants.USDC,
       rateManagerV1: pickAddress(baseContracts, ["RateManagerV1", "DepositRateManagerRegistryV1"]),
@@ -368,13 +358,13 @@ function getContracts(chainId, env = "production") {
       "VITE_BASE_STAGING_ESCROW_V2_ADDRESS",
       "VITE_ESCROW_V2_ADDRESS"
     ]);
-    const stagingEscrowCurrent = stagingEscrowV2Override ?? pickAddress(sc, ["EscrowV2", "Escrow_V2"]) ?? pickAddress(sc, ["Escrow"]);
+    const stagingEscrowCurrent = stagingEscrowV2Override ?? pickAddress(sc, ["EscrowV2", "Escrow_V2"]);
     const stagingOrchestratorV2Override = resolveRuntimeAddressOverride([
       "VITE_BASE_STAGING_ORCHESTRATOR_V2_ADDRESS",
       "VITE_ORCHESTRATOR_V2_ADDRESS",
       "VITE_ORCHESTRATORV2_ADDRESS"
     ]);
-    const stagingOrchestratorCurrent = stagingOrchestratorV2Override ?? pickAddress(sc, ["OrchestratorV2", "Orchestrator_V2"]) ?? pickAddress(sc, ["Orchestrator"]);
+    const stagingOrchestratorCurrent = stagingOrchestratorV2Override ?? pickAddress(sc, ["OrchestratorV2", "Orchestrator_V2"]);
     const stagingRateManagerV1 = pickAddress(sc, ["RateManagerV1", "DepositRateManagerRegistryV1"]);
     return {
       addresses: {
@@ -389,7 +379,7 @@ function getContracts(chainId, env = "production") {
           "UnifiedPaymentVerifier"
         ]),
         unifiedPaymentVerifierV2: pickAddress(sc, ["UnifiedPaymentVerifierV2"]),
-        protocolViewer: pickAddress(sc, ["ProtocolViewerV2", "ProtocolViewer"]),
+        protocolViewer: pickAddress(sc, ["ProtocolViewerV2"]),
         protocolViewerEntries: (() => {
           const entries = [];
           const pvV2Address = pickAddress(sc, ["ProtocolViewerV2"]);
@@ -399,11 +389,6 @@ function getContracts(chainId, env = "production") {
           if (pvV2Address && pvV2Abi) {
             entries.push({ address: pvV2Address, abi: pvV2Abi });
           }
-          const pvV1Address = pickAddress(sc, ["ProtocolViewer"]);
-          const pvV1Abi = ProtocolViewerBaseStaging__default.default;
-          if (pvV1Address && !addressesEqual(pvV1Address, pvV2Address) && pvV1Abi) {
-            entries.push({ address: pvV1Address, abi: pvV1Abi });
-          }
           return entries.length > 0 ? entries : void 0;
         })(),
         usdc: baseStagingConstants.USDC,
@@ -416,12 +401,11 @@ function getContracts(chainId, env = "production") {
       },
       abis: {
         escrow: EscrowBaseStaging__default.default,
-        escrowV2: addressesEqual(stagingEscrowCurrent, pickAddress(sc, ["Escrow"])) ? EscrowBaseStaging__default.default : pickAbi(baseStagingAbisRaw__namespace, ["EscrowV2"]) ?? EscrowBaseStaging__default.default,
+        escrowV2: pickAbi(baseStagingAbisRaw__namespace, [
+          "EscrowV2"
+        ]) ?? EscrowBaseStaging__default.default,
         orchestrator: OrchestratorBaseStaging__default.default,
-        orchestratorV2: addressesEqual(
-          stagingOrchestratorCurrent,
-          pickAddress(sc, ["Orchestrator"])
-        ) ? OrchestratorBaseStaging__default.default : pickAbi(baseStagingAbisRaw__namespace, [
+        orchestratorV2: pickAbi(baseStagingAbisRaw__namespace, [
           "OrchestratorV2"
         ]) ?? OrchestratorBaseStaging__default.default,
         unifiedPaymentVerifier: pickAbi(baseStagingAbisRaw__namespace, [
@@ -1460,7 +1444,7 @@ function createHeaders(apiKey, authorizationToken) {
   return headers2;
 }
 async function apiSignIntentV3(request, opts) {
-  const url = `${opts.baseApiUrl.replace(/\/$/, "")}/v3/intent`;
+  const url = `${opts.baseApiUrl.replace(/\/$/, "")}/v3/intent/sign`;
   const json = await withRetry(
     async () => {
       let res;
@@ -1472,7 +1456,7 @@ async function apiSignIntentV3(request, opts) {
         });
       } catch (error) {
         throw new exports.NetworkError("Failed to connect to API server", {
-          endpoint: "/v3/intent",
+          endpoint: "/v3/intent/sign",
           error
         });
       }
@@ -1490,7 +1474,7 @@ async function apiSignIntentV3(request, opts) {
   const expStr = json?.responseObject?.intentData?.signatureExpiration ?? json?.responseObject?.signatureExpiration;
   const preIntentHookData = json?.responseObject?.intentData?.preIntentHookData ?? json?.responseObject?.preIntentHookData;
   const referralFees = json?.responseObject?.intentData?.referralFees ?? json?.responseObject?.referralFees;
-  if (!sig || !expStr) throw new Error("v3/intent missing signature or expiration");
+  if (!sig || !expStr) throw new Error("v3/intent/sign missing signature or expiration");
   return {
     signature: sig,
     signatureExpiration: BigInt(expStr),
@@ -1527,6 +1511,34 @@ async function apiCreatePaymentAttestation(payload, attestationServiceUrl, platf
     return res.json();
   });
 }
+async function apiCreateSellerCredentialBundle(payload, attestationServiceUrl, platform, timeoutMs) {
+  return withRetry(
+    async () => {
+      let res;
+      try {
+        const endpoint = `/seller/credentials/${encodeURIComponent(platform)}`;
+        res = await fetch(`${attestationServiceUrl}${endpoint}`, {
+          method: "POST",
+          headers: headers(),
+          body: JSON.stringify(payload)
+        });
+      } catch (error) {
+        throw new exports.NetworkError("Failed to connect to Attestation Service", {
+          endpoint: `/seller/credentials/${platform}`,
+          error
+        });
+      }
+      if (!res.ok) {
+        const errorText = await res.text();
+        throw parseAPIError(res, errorText);
+      }
+      return res.json();
+    },
+    3,
+    1e3,
+    timeoutMs
+  );
+}
 var abiCoder = ethers.AbiCoder.defaultAbiCoder();
 function encodeVerifyPaymentData(params) {
   return abiCoder.encode(
@@ -1670,6 +1682,9 @@ var PAYMENT_PLATFORMS = [
   "n26"
 ];
 
+// src/utils/constants.ts
+var DEFAULT_BASE_API_URL = "https://api.zkp2p.xyz";
+
 // src/utils/oracles.ts
 init_currency();
 var ZERO_ADDRESS3 = "0x0000000000000000000000000000000000000000";
@@ -1916,6 +1931,13 @@ var IntentOperations = class {
       orchestratorAddress: params.orchestratorAddress,
       escrowAddress: escrowContext.address
     });
+    const currentEscrow = this.config.getEscrowV2Address();
+    const currentOrchestrator = this.config.getOrchestratorV2Address();
+    if (currentEscrow && escrowContext.address.toLowerCase() !== currentEscrow.toLowerCase() || currentOrchestrator && orchestratorContext.address.toLowerCase() !== currentOrchestrator.toLowerCase()) {
+      throw new Error(
+        "signalIntent is only supported on the current EscrowV2 / OrchestratorV2 deployment"
+      );
+    }
     const catalog = getPaymentMethodsCatalog(this.config.getChainId(), this.config.getRuntimeEnv());
     const paymentMethod = resolvePaymentMethodHashFromCatalog(params.processorName, catalog);
     const fiatCurrency = resolveFiatCurrencyBytes32(params.fiatCurrencyCode);
@@ -1967,13 +1989,13 @@ var IntentOperations = class {
       if (response.referralFees !== void 0) {
         referralFees = response.referralFees.map((referralFee) => {
           if (!isValidReferrerFeeRecipient(referralFee.recipient)) {
-            throw new Error("v3/intent returned invalid referral fee recipient");
+            throw new Error("v3/intent/sign returned invalid referral fee recipient");
           }
           let fee;
           try {
             fee = BigInt(referralFee.fee);
           } catch {
-            throw new Error("v3/intent returned non-integer referral fee value");
+            throw new Error("v3/intent/sign returned non-integer referral fee value");
           }
           return {
             recipient: referralFee.recipient,
@@ -5950,7 +5972,7 @@ function convertIndexerDepositToLegacyApiDeposit(deposit) {
 }
 async function apiPostDepositDetails(req, baseApiUrl, timeoutMs, _apiKey, _authToken) {
   return apiFetch({
-    url: `${withApiBase(baseApiUrl)}/v1/makers/create`,
+    url: `${withApiBase(baseApiUrl)}/v2/makers/create`,
     method: "POST",
     body: req,
     timeoutMs
@@ -5983,7 +6005,8 @@ async function apiGetQuote(req, baseApiUrl, timeoutMs, apiKey, authToken) {
     [isExactFiat ? "exactFiatAmount" : "exactTokenAmount"]: String(req.amount),
     amount: void 0,
     isExactFiat: void 0,
-    quotesToReturn: void 0
+    quotesToReturn: void 0,
+    includePrivateOrderbooks: req.includePrivateOrderbooks
   };
   Object.keys(requestBody).forEach((k) => requestBody[k] === void 0 && delete requestBody[k]);
   return apiFetch({
@@ -6020,7 +6043,7 @@ async function apiGetQuotesBestByPlatform(req, baseApiUrl, timeoutMs, apiKey, au
 }
 async function apiGetPayeeDetails(req, apiKey, baseApiUrl, authToken, timeoutMs) {
   return apiFetch({
-    url: `${baseApiUrl.replace(/\/$/, "")}/v1/makers/${req.processorName}/${req.hashedOnchainId}`,
+    url: `${baseApiUrl.replace(/\/$/, "")}/v2/makers/${req.processorName}/${req.hashedOnchainId}`,
     method: "GET",
     apiKey,
     authToken,
@@ -6029,7 +6052,7 @@ async function apiGetPayeeDetails(req, apiKey, baseApiUrl, authToken, timeoutMs)
 }
 async function apiValidatePayeeDetails(req, baseApiUrl, timeoutMs) {
   const data = await apiFetch({
-    url: `${baseApiUrl.replace(/\/$/, "")}/v1/makers/validate`,
+    url: `${baseApiUrl.replace(/\/$/, "")}/v2/makers/validate`,
     method: "POST",
     body: req,
     timeoutMs
@@ -6087,6 +6110,78 @@ async function apiGetTakerTier(req, apiKey, baseApiUrl, timeoutMs) {
     timeoutMs
   });
 }
+async function apiUploadSellerCredential(makerId, bundle, baseApiUrl, timeoutMs, apiKey, authToken) {
+  return apiFetch({
+    url: `${withApiBase(baseApiUrl)}/v2/makers/${makerId}/seller-credential`,
+    method: "POST",
+    body: bundle,
+    apiKey,
+    authToken,
+    timeoutMs
+  });
+}
+async function apiGetSellerCredentialStatus(makerId, baseApiUrl, timeoutMs, apiKey, authToken) {
+  return apiFetch({
+    url: `${withApiBase(baseApiUrl)}/v2/makers/${makerId}/seller-credential/status`,
+    method: "GET",
+    apiKey,
+    authToken,
+    timeoutMs
+  });
+}
+async function apiVerifySellerPayment(platform, req, baseApiUrl, timeoutMs, apiKey, authToken) {
+  return apiFetch({
+    url: `${withApiBase(baseApiUrl)}/v2/verify/seller/${encodeURIComponent(platform)}`,
+    method: "POST",
+    body: req,
+    apiKey,
+    authToken,
+    timeoutMs
+  });
+}
+async function apiGetOrderbook(params, optsOrBaseApiUrl, timeoutMs, apiKey) {
+  const opts = typeof optsOrBaseApiUrl === "string" ? {
+    baseApiUrl: optsOrBaseApiUrl,
+    timeoutMs,
+    apiKey
+  } : optsOrBaseApiUrl;
+  const query = new URLSearchParams();
+  Object.entries(params).forEach(([key, value]) => {
+    if (value === void 0 || value === null) return;
+    query.set(key, String(value));
+  });
+  const response = await apiFetch({
+    url: `${withApiBase(opts.baseApiUrl)}/v2/orderbook?${query.toString()}`,
+    method: "GET",
+    apiKey: opts.apiKey,
+    authToken: opts.authToken,
+    timeoutMs: opts.timeoutMs
+  });
+  return response.responseObject;
+}
+async function apiGetDepositBundle(params, optsOrBaseApiUrl, timeoutMs, apiKey) {
+  const opts = typeof optsOrBaseApiUrl === "string" ? {
+    baseApiUrl: optsOrBaseApiUrl,
+    timeoutMs,
+    apiKey
+  } : optsOrBaseApiUrl;
+  const escrowAddress = requireEscrowAddress(
+    params.escrowAddress,
+    "apiGetDepositBundle requires escrowAddress"
+  );
+  const query = new URLSearchParams({ escrowAddress });
+  if (params.dailySnapshotLimit !== void 0) {
+    query.set("dailySnapshotLimit", String(params.dailySnapshotLimit));
+  }
+  const response = await apiFetch({
+    url: `${withApiBase(opts.baseApiUrl)}/v2/deposits/${params.depositId}/bundle?${query.toString()}`,
+    method: "GET",
+    apiKey: opts.apiKey,
+    authToken: opts.authToken,
+    timeoutMs: opts.timeoutMs
+  });
+  return response.responseObject;
+}
 
 // src/client/Zkp2pClient.ts
 init_contracts();
@@ -6228,6 +6323,95 @@ var ERC20_ABI = [
 ];
 
 // src/client/Zkp2pClient.ts
+function isStringRecord(value) {
+  if (!value || typeof value !== "object" || Array.isArray(value)) {
+    return false;
+  }
+  return Object.values(value).every((entry) => typeof entry === "string");
+}
+function normalizeTelegramUsername(value) {
+  if (typeof value !== "string") {
+    return value === null ? null : null;
+  }
+  const normalized = value.trim();
+  return normalized.length > 0 ? normalized : null;
+}
+function extractLegacyQuotePayeeData(depositData) {
+  if (!depositData || typeof depositData !== "object" || Array.isArray(depositData)) {
+    return void 0;
+  }
+  const stringEntries = Object.entries(depositData).filter(
+    (entry) => typeof entry[1] === "string" && entry[1].trim().length > 0
+  );
+  const telegramUsername = stringEntries.find(([key]) => key === "telegramUsername")?.[1] ?? null;
+  const identifierEntries = stringEntries.filter(([key]) => key !== "telegramUsername");
+  const [primaryEntry, ...metadataEntries] = identifierEntries;
+  if (!primaryEntry) {
+    return void 0;
+  }
+  return {
+    offchainId: primaryEntry[1],
+    telegramUsername,
+    metadata: metadataEntries.length > 0 ? Object.fromEntries(metadataEntries) : null
+  };
+}
+function normalizeQuotePayeeData(maker) {
+  const legacy = extractLegacyQuotePayeeData(maker?.depositData);
+  const offchainId = typeof maker?.offchainId === "string" && maker.offchainId.trim().length > 0 ? maker.offchainId : legacy?.offchainId;
+  if (!offchainId) {
+    return void 0;
+  }
+  return {
+    offchainId,
+    telegramUsername: normalizeTelegramUsername(maker?.telegramUsername) ?? legacy?.telegramUsername ?? null,
+    metadata: isStringRecord(maker?.metadata) ? maker.metadata : legacy?.metadata ?? null
+  };
+}
+function normalizePayeeDataInputItem(raw) {
+  if (!raw || typeof raw !== "object" || Array.isArray(raw)) {
+    return null;
+  }
+  const candidate = raw;
+  if (typeof candidate.offchainId === "string" && candidate.offchainId.trim().length > 0) {
+    return candidate;
+  }
+  const legacy = extractLegacyQuotePayeeData(raw);
+  if (!legacy) {
+    return null;
+  }
+  return {
+    offchainId: legacy.offchainId,
+    telegramUsername: legacy.telegramUsername,
+    metadata: legacy.metadata
+  };
+}
+function resolvePayeeDataInput(params, methodName) {
+  const payeeData = params.payeeData ?? params.depositData;
+  if (!Array.isArray(payeeData)) {
+    throw new Error(`${methodName} requires payeeData`);
+  }
+  const normalized = payeeData.map((item, index) => {
+    const result = normalizePayeeDataInputItem(item);
+    if (!result) {
+      throw new Error(
+        `${methodName}: payeeData[${index}] must include a non-empty offchainId or a recognizable legacy identifier`
+      );
+    }
+    return result;
+  });
+  return normalized;
+}
+function toPostDepositDetailsRequest(processorName, payeeData, index) {
+  if (!payeeData || typeof payeeData.offchainId !== "string" || payeeData.offchainId.length === 0) {
+    throw new Error(`payeeData[${index}] must include a non-empty offchainId`);
+  }
+  return {
+    processorName,
+    offchainId: payeeData.offchainId,
+    telegramUsername: payeeData.telegramUsername,
+    metadata: payeeData.metadata
+  };
+}
 var Zkp2pClient = class {
   /**
    * Creates a new Zkp2pClient instance.
@@ -6774,7 +6958,7 @@ var Zkp2pClient = class {
      * sending fiat payment to the deposit's payee.
      *
      * If `gatingServiceSignature` is not provided, the SDK will automatically
-     * fetch one from curator `/v3/intent` when `apiKey` or `authorizationToken`
+     * fetch one from curator `/v3/intent/sign` when `apiKey` or `authorizationToken`
      * is available. Otherwise you must provide `gatingServiceSignature` and
      * `signatureExpiration` yourself.
      *
@@ -7213,6 +7397,7 @@ var Zkp2pClient = class {
       getProtocolViewerAbi: () => this.protocolViewerAbi,
       getIndexerClient: () => this._indexerClient,
       getIndexerService: () => this._indexerService,
+      getEscrowV2Address: () => this.escrowV2Address,
       getOrchestratorV2Address: () => this.orchestratorV2Address,
       host: {
         resolveEscrowContext: (options) => this.resolveEscrowContext(options),
@@ -7236,6 +7421,30 @@ var Zkp2pClient = class {
   parseRawDepositId(depositId) {
     return parseRawDepositId(depositId);
   }
+  stripTrailingSlash(url) {
+    return url.replace(/\/$/, "");
+  }
+  defaultAttestationServiceForBaseApiUrl(baseApiUrl) {
+    try {
+      const { hostname } = new URL(baseApiUrl);
+      if (hostname === "api-staging.zkp2p.xyz") {
+        return "https://attestation-service-staging.zkp2p.xyz";
+      }
+      if (hostname === "api-preprod.zkp2p.xyz") {
+        return "https://attestation-service.zkp2p.xyz";
+      }
+      if (hostname === "api.zkp2p.xyz") {
+        return "https://attestation-service.zkp2p.xyz";
+      }
+    } catch {
+    }
+    if (baseApiUrl === DEFAULT_BASE_API_URL) {
+      return "https://attestation-service.zkp2p.xyz";
+    }
+    throw new Error(
+      `attestationServiceUrl is required when baseApiUrl is not a supported zkp2p API host: ${baseApiUrl}`
+    );
+  }
   normalizeOracleRateConfig(config) {
     return normalizeOracleRateConfig(config);
   }
@@ -8088,31 +8297,29 @@ var Zkp2pClient = class {
    * register maker payment details with the curator service.
    *
    * @param params.processorNames - Payment platforms (e.g., ['wise', 'revolut'])
-   * @param params.depositData - Payee details per processor (e.g., [{ email: '...' }])
+   * @param params.payeeData - Payee details per processor (e.g., [{ offchainId: 'you@example.com' }]). Required when the SDK needs to register payee details with the curator.
    * @returns The posted deposit details and their corresponding hashed on-chain IDs
    *
    * @example
    * ```typescript
    * const { hashedOnchainIds } = await client.registerPayeeDetails({
    *   processorNames: ['wise'],
-   *   depositData: [{ email: 'you@example.com' }],
+   *   payeeData: [{ offchainId: 'you@example.com' }],
    * });
    * // Then pass hashedOnchainIds to createDeposit
    * ```
    */
   async registerPayeeDetails(params) {
+    const payeeData = resolvePayeeDataInput(params, "registerPayeeDetails");
     if (!Array.isArray(params.processorNames) || params.processorNames.length === 0) {
       throw new Error("processorNames must be a non-empty array");
     }
-    if (params.processorNames.length !== params.depositData.length) {
-      throw new Error("processorNames and depositData length mismatch");
+    if (params.processorNames.length !== payeeData.length) {
+      throw new Error("processorNames and payeeData length mismatch");
     }
     const baseApiUrl = (this.baseApiUrl ?? "https://api.zkp2p.xyz").replace(/\/$/, "");
     const depositDetails = params.processorNames.map(
-      (processorName, index) => ({
-        processorName,
-        depositData: params.depositData[index] || {}
-      })
+      (processorName, index) => toPostDepositDetailsRequest(processorName, payeeData[index], index)
     );
     const apiResponses = await Promise.all(
       depositDetails.map((req) => apiPostDepositDetails(req, baseApiUrl, this.apiTimeoutMs))
@@ -8139,16 +8346,17 @@ var Zkp2pClient = class {
    * @param params.amount - Total deposit amount in token units (6 decimals for USDC)
    * @param params.intentAmountRange - Min/max amount per intent
    * @param params.processorNames - Payment platforms to accept (e.g., ['wise', 'revolut'])
-   * @param params.depositData - Payee details per processor (e.g., [{ email: '...' }])
+   * @param params.payeeData - Payee details per processor (e.g., [{ offchainId: 'you@example.com' }])
    * @param params.conversionRates - Conversion rates per processor, grouped by currency
    * @param params.payeeDetailsHashes - Pre-computed hashed on-chain IDs (from registerPayeeDetails). When provided, skips the curator API call entirely.
    * @param params.delegate - Optional delegate address that can manage the deposit
    * @param params.intentGuardian - Optional guardian for intent approval
    * @param params.retainOnEmpty - Keep deposit active when balance reaches zero
    * @param params.txOverrides - Optional viem transaction overrides
-   * @returns The deposit details posted to API and the transaction hash
+   * @returns The deposit details posted to API (empty when payee registration is skipped) and the transaction hash
    *
-   * @throws Error if processorNames, depositData, and conversionRates lengths don't match
+   * @throws Error if processorNames, payeeData, and conversionRates lengths don't match
+   * @throws Error if payeeData is missing and neither payeeDetailsHashes nor full payment method overrides are provided
    * @throws Error if a currency is not supported by the specified processor
    *
    * @example
@@ -8159,7 +8367,7 @@ var Zkp2pClient = class {
    *   amount: 1000_000000n,
    *   intentAmountRange: { min: 10_000000n, max: 500_000000n },
    *   processorNames: ['wise'],
-   *   depositData: [{ email: 'you@example.com' }],
+   *   payeeData: [{ offchainId: 'you@example.com' }],
    *   conversionRates: [[
    *     { currency: 'USD', conversionRate: '1020000000000000000' }, // 1.02
    *     { currency: 'EUR', conversionRate: '1100000000000000000' }, // 1.10
@@ -8192,24 +8400,30 @@ var Zkp2pClient = class {
     };
   }
   async prepareCreateDepositInternal(params) {
+    const hasOverrides = Boolean(
+      params.paymentMethodsOverride || params.paymentMethodDataOverride || params.currenciesOverride
+    );
+    const payeeDetailsHashes = params.payeeDetailsHashes;
+    const hasPayeeHashes = payeeDetailsHashes !== void 0;
+    const shouldResolvePayeeData = params.payeeData !== void 0 || params.depositData !== void 0;
+    const payeeData = shouldResolvePayeeData ? resolvePayeeDataInput(params, "createDeposit") : null;
     if (!Array.isArray(params.processorNames) || params.processorNames.length === 0) {
       throw new Error("processorNames must be a non-empty array");
     }
     if (params.processorNames.length !== params.conversionRates.length) {
       throw new Error("processorNames and conversionRates length mismatch");
     }
-    if (params.processorNames.length !== params.depositData.length) {
-      throw new Error("processorNames and depositData length mismatch");
+    if (payeeData && params.processorNames.length !== payeeData.length) {
+      throw new Error("processorNames and payeeData length mismatch");
     }
-    const depositDetails = params.processorNames.map(
-      (processorName, index) => ({
-        processorName,
-        depositData: params.depositData[index] || {}
-      })
-    );
-    const hasOverrides = Boolean(
-      params.paymentMethodsOverride || params.paymentMethodDataOverride || params.currenciesOverride
-    );
+    if (!hasOverrides && !hasPayeeHashes && !payeeData) {
+      throw new Error(
+        "createDeposit requires payeeData unless payeeDetailsHashes or full payment method overrides are provided"
+      );
+    }
+    const depositDetails = payeeData ? params.processorNames.map(
+      (processorName, index) => toPostDepositDetailsRequest(processorName, payeeData[index], index)
+    ) : [];
     let paymentMethods;
     let paymentMethodData;
     let currencies;
@@ -8234,11 +8448,11 @@ var Zkp2pClient = class {
       );
       const intentGatingService = getGatingServiceAddress(this.chainId, this.runtimeEnv);
       let hashedOnchainIds;
-      if (params.payeeDetailsHashes) {
-        if (params.payeeDetailsHashes.length !== params.processorNames.length) {
+      if (payeeDetailsHashes !== void 0) {
+        if (payeeDetailsHashes.length !== params.processorNames.length) {
           throw new Error("payeeDetailsHashes length must match processorNames length");
         }
-        hashedOnchainIds = params.payeeDetailsHashes;
+        hashedOnchainIds = payeeDetailsHashes;
       } else {
         const baseApiUrl = (this.baseApiUrl ?? "https://api.zkp2p.xyz").replace(/\/$/, "");
         const apiResponses = await Promise.all(
@@ -8424,7 +8638,7 @@ var Zkp2pClient = class {
     const timeoutMs = opts?.timeoutMs ?? this.apiTimeoutMs;
     const reqWithEscrow = { ...req };
     if (!reqWithEscrow.escrowAddresses || reqWithEscrow.escrowAddresses.length === 0) {
-      const configuredEscrows = this.escrowAddresses.length > 0 ? this.escrowAddresses.map((address) => address) : this.escrowAddress ? [this.escrowAddress] : [];
+      const configuredEscrows = this.escrowV2Address ? [this.escrowV2Address] : this.escrowAddress ? [this.escrowAddress] : [];
       if (configuredEscrows.length > 0) {
         reqWithEscrow.escrowAddresses = configuredEscrows;
       }
@@ -8439,8 +8653,9 @@ var Zkp2pClient = class {
     const quotes = quote?.responseObject?.quotes ?? [];
     for (const q of quotes) {
       const maker = q?.maker;
-      if (maker?.depositData && typeof q === "object") {
-        q.payeeData = maker.depositData;
+      const payeeData = normalizeQuotePayeeData(maker);
+      if (payeeData && typeof q === "object") {
+        q.payeeData = payeeData;
       }
     }
     return appendReferrerFeeDisplayFields(quote, referrerFeeConfig);
@@ -8467,7 +8682,7 @@ var Zkp2pClient = class {
     const timeoutMs = opts?.timeoutMs ?? this.apiTimeoutMs;
     const reqWithEscrow = { ...req };
     if (!reqWithEscrow.escrowAddresses || reqWithEscrow.escrowAddresses.length === 0) {
-      const configuredEscrows = this.escrowAddresses.length > 0 ? [...this.escrowAddresses] : this.escrowAddress ? [this.escrowAddress] : [];
+      const configuredEscrows = this.escrowV2Address ? [this.escrowV2Address] : this.escrowAddress ? [this.escrowAddress] : [];
       if (configuredEscrows.length > 0) {
         reqWithEscrow.escrowAddresses = configuredEscrows;
       }
@@ -8485,11 +8700,11 @@ var Zkp2pClient = class {
         ...quote.responseObject,
         platformQuotes: (quote.responseObject?.platformQuotes ?? []).map((platformQuote) => {
           const bestQuote = platformQuote?.bestQuote;
-          const makerDepositData = bestQuote?.maker?.depositData;
-          if (!bestQuote || !makerDepositData) return platformQuote;
+          const payeeData = normalizeQuotePayeeData(bestQuote?.maker);
+          if (!bestQuote || !payeeData) return platformQuote;
           return {
             ...platformQuote,
-            bestQuote: { ...bestQuote, payeeData: makerDepositData }
+            bestQuote: { ...bestQuote, payeeData }
           };
         })
       }
@@ -8517,6 +8732,92 @@ var Zkp2pClient = class {
     const timeoutMs = opts?.timeoutMs ?? this.apiTimeoutMs;
     return apiGetTakerTier(req, void 0, baseApiUrl, timeoutMs);
   }
+  /**
+   * The signed `expiresAtMs` field is an upload-time freshness token minted by attestation-service.
+   * Once curator persists the bundle, seller-automated-release availability is governed by curator's
+   * probe/revalidation state rather than this timestamp.
+   *
+   * Curator accepts either a configured API key or bearer token for this endpoint.
+   *
+   * Create a signed seller credential bundle with attestation-service and store it on the maker via curator.
+   */
+  async uploadSellerCredential(params, opts) {
+    const baseApiUrl = this.stripTrailingSlash(
+      opts?.baseApiUrl ?? this.baseApiUrl ?? DEFAULT_BASE_API_URL
+    );
+    const timeoutMs = opts?.timeoutMs ?? this.apiTimeoutMs;
+    const attestationServiceUrl = this.stripTrailingSlash(
+      opts?.attestationServiceUrl ?? this.defaultAttestationServiceForBaseApiUrl(baseApiUrl)
+    );
+    const uploadPayload = {
+      payeeId: params.payeeId,
+      sessionMaterial: params.sessionMaterial
+    };
+    const bundleResponse = await apiCreateSellerCredentialBundle(
+      uploadPayload,
+      attestationServiceUrl,
+      params.platform,
+      timeoutMs
+    );
+    if (!bundleResponse.success || !bundleResponse.responseObject) {
+      throw new Error(bundleResponse.message || "Failed to create seller credential bundle");
+    }
+    return apiUploadSellerCredential(
+      params.makerId,
+      bundleResponse.responseObject,
+      baseApiUrl,
+      timeoutMs,
+      this.apiKey,
+      this.authorizationToken
+    );
+  }
+  /**
+   * Status is a coarse curator-owned signal (`active` / `inactive` / `missing`) and intentionally
+   * omits low-level diagnostics. Curator may still re-probe stale credentials during verify, so callers
+   * should continue to handle a 410 from `verifySellerPayment`.
+   *
+   * Curator accepts either a configured API key or bearer token for this endpoint.
+   *
+   * Fetch seller credential status for a maker from curator.
+   */
+  async getSellerCredentialStatus(params, opts) {
+    const baseApiUrl = this.stripTrailingSlash(
+      opts?.baseApiUrl ?? this.baseApiUrl ?? DEFAULT_BASE_API_URL
+    );
+    const timeoutMs = opts?.timeoutMs ?? this.apiTimeoutMs;
+    return apiGetSellerCredentialStatus(
+      params.makerId,
+      baseApiUrl,
+      timeoutMs,
+      this.apiKey,
+      this.authorizationToken
+    );
+  }
+  /**
+   * Internal-use endpoint. The curator route requires an internal `x-api-key`; standard SDK consumer
+   * API keys will be rejected with 401. Returns 410 GONE when curator has marked the credential inactive
+   * or a stale credential fails its synchronous re-probe.
+   *
+   * Verify a seller payment via curator's seller-credential proxy.
+   */
+  async verifySellerPayment(params, opts) {
+    const baseApiUrl = this.stripTrailingSlash(
+      opts?.baseApiUrl ?? this.baseApiUrl ?? DEFAULT_BASE_API_URL
+    );
+    const timeoutMs = opts?.timeoutMs ?? this.apiTimeoutMs;
+    return apiVerifySellerPayment(
+      params.platform,
+      {
+        txId: params.txId,
+        chainId: params.chainId,
+        intent: params.intent
+      },
+      baseApiUrl,
+      timeoutMs,
+      this.apiKey,
+      this.authorizationToken
+    );
+  }
   // ╔═══════════════════════════════════════════════════════════════════════════╗
   // ║ CORE: ON-CHAIN DEPOSIT VIEWS                                             ║
   // ╚═══════════════════════════════════════════════════════════════════════════╝
@@ -8943,6 +9244,8 @@ exports.ZERO_RATE_MANAGER_ID = ZERO_RATE_MANAGER_ID;
 exports.ZKP2P_ANDROID_REFERRER = ZKP2P_ANDROID_REFERRER;
 exports.ZKP2P_IOS_REFERRER = ZKP2P_IOS_REFERRER;
 exports.Zkp2pClient = Zkp2pClient;
+exports.apiGetDepositBundle = apiGetDepositBundle;
+exports.apiGetOrderbook = apiGetOrderbook;
 exports.apiGetOwnerDeposits = apiGetOwnerDeposits;
 exports.apiGetPayeeDetails = apiGetPayeeDetails;
 exports.apiGetQuotesBestByPlatform = apiGetQuotesBestByPlatform;