@unifold/core 0.1.81 → 0.1.83

package/dist/index.mjs

@@ -41,7 +41,7 @@ function generatePrefixedKSUID(prefix) {
 }
 
 // src/lib/client-headers.ts
-var SDK_VERSION = true ? "0.1.81" : "0.0.0-dev";
+var SDK_VERSION = true ? "0.1.83" : "0.0.0-dev";
 var CLIENT_VERSION_HEADER = "x-unifold-client-version";
 var CLIENT_USER_AGENT_HEADER = "x-unifold-client-user-agent";
 function detectRuntime() {
@@ -204,6 +204,11 @@ async function createDepositAddress(overrides, publishableKey) {
         const firstError = Array.isArray(body.details?.errors) ? body.details?.errors[0] : void 0;
         throw new DepositAddressValidationError(firstError ?? "Invalid recipient address");
       }
+      if (body?.error_type === "xrpl_destination_tag_required") {
+        throw new DepositAddressValidationError(
+          body.message ?? "Recipient address requires a destination tag"
+        );
+      }
     }
     throw new Error(`Failed to create EOA: ${response.statusText}`);
   }
@@ -469,11 +474,13 @@ async function getBankTransferProviders(publishableKey, options = {}) {
   }
   const queryString = params.toString();
   const url = `${API_BASE_URL}/v1/public/onramps/bank_transfer/providers${queryString ? `?${queryString}` : ""}`;
+  const LATEST_API_VERSION = "2026-08-15";
   const response = await apiFetch(url, {
     method: "GET",
     headers: {
       accept: "application/json",
-      "x-publishable-key": pk
+      "x-publishable-key": pk,
+      "x-unifold-version": LATEST_API_VERSION
     }
   });
   if (!response.ok) {
@@ -1298,6 +1305,173 @@ async function getCashAppSessionStatus(externalId, publishableKey) {
   }
   return response.json();
 }
+var HEADLESS_INTERAC_BASE = "/v1/public/onramps/headless/interac";
+var InteracApiResponseError = class extends Error {
+  constructor(message, statusCode, errorType, providerMessage) {
+    super(message);
+    this.statusCode = statusCode;
+    this.errorType = errorType;
+    this.providerMessage = providerMessage;
+    this.name = "InteracApiResponseError";
+  }
+};
+function throwInteracError(prefix, response, error) {
+  const providerMessage = error.details?.paytrie_error?.message;
+  const detailMessage = providerMessage || error.message || response.statusText;
+  throw new InteracApiResponseError(
+    `${prefix}: ${detailMessage}`,
+    response.status,
+    error.error_type,
+    providerMessage
+  );
+}
+async function interacFetch(prefix, path, publishableKey, init = {}, accessToken) {
+  const pk = publishableKey || DEFAULT_PUBLISHABLE_KEY;
+  validatePublishableKey(pk);
+  const response = await apiFetch(`${API_BASE_URL}${HEADLESS_INTERAC_BASE}${path}`, {
+    ...init,
+    headers: {
+      accept: "application/json",
+      "x-publishable-key": pk,
+      ...init.body ? { "Content-Type": "application/json" } : {},
+      ...accessToken ? { "x-interac-token": accessToken } : {},
+      ...init.headers
+    }
+  });
+  if (!response.ok) {
+    const error = await response.json().catch(() => ({ message: response.statusText }));
+    throwInteracError(prefix, response, error);
+  }
+  return response;
+}
+async function startInterac(email, publishableKey) {
+  const response = await interacFetch("Failed to start Interac flow", "/start", publishableKey, {
+    method: "POST",
+    body: JSON.stringify({ email })
+  });
+  return response.json();
+}
+async function getInteracStatus(email, publishableKey, accessToken) {
+  const response = await interacFetch(
+    "Failed to resolve Interac status",
+    "/status",
+    publishableKey,
+    // With a token, the token itself identifies the account — no email.
+    { method: "POST", body: JSON.stringify(email ? { email } : {}) },
+    accessToken
+  );
+  return response.json();
+}
+async function createInteracUser(request, publishableKey) {
+  const response = await interacFetch("Failed to create Interac user", "/users", publishableKey, {
+    method: "POST",
+    body: JSON.stringify(request)
+  });
+  return response.json();
+}
+async function requestInteracOtp(email, publishableKey) {
+  await interacFetch("Failed to request Interac login code", "/otp", publishableKey, {
+    method: "POST",
+    body: JSON.stringify({ email })
+  });
+}
+async function verifyInteracOtp(email, code, publishableKey) {
+  const response = await interacFetch(
+    "Failed to verify Interac login code",
+    "/otp/verify",
+    publishableKey,
+    { method: "POST", body: JSON.stringify({ email, code }) }
+  );
+  return response.json();
+}
+async function updateInteracUser(request, publishableKey, accessToken) {
+  const response = await interacFetch(
+    "Failed to update Interac user",
+    "/users",
+    publishableKey,
+    { method: "PUT", body: JSON.stringify(request) },
+    accessToken
+  );
+  return response.json();
+}
+async function sendInteracPhoneVerification(phone, publishableKey, accessToken) {
+  await interacFetch(
+    "Failed to send phone verification code",
+    "/phone",
+    publishableKey,
+    { method: "POST", body: JSON.stringify({ phone }) },
+    accessToken
+  );
+}
+async function verifyInteracPhone(email, code, publishableKey, accessToken) {
+  const response = await interacFetch(
+    "Failed to verify phone code",
+    "/phone/verify",
+    publishableKey,
+    { method: "POST", body: JSON.stringify(email ? { email, code } : { code }) },
+    accessToken
+  );
+  return response.json();
+}
+async function getInteracKycUrl(email, publishableKey, accessToken) {
+  const response = await interacFetch(
+    "Failed to get verification link",
+    "/kyc_url",
+    publishableKey,
+    { method: "POST", body: JSON.stringify(email ? { email } : {}) },
+    accessToken
+  );
+  return response.json();
+}
+async function getInteracQuote(sourceAmount, destinationNetwork, publishableKey) {
+  const query = new URLSearchParams({
+    source_amount: String(sourceAmount),
+    destination_network: destinationNetwork
+  });
+  const response = await interacFetch(
+    "Failed to get Interac quote",
+    `/quotes?${query.toString()}`,
+    publishableKey,
+    { method: "GET" }
+  );
+  return response.json();
+}
+async function getInteracLimits(publishableKey) {
+  const response = await interacFetch("Failed to get Interac limits", "/limits", publishableKey, {
+    method: "GET"
+  });
+  return response.json();
+}
+async function createInteracSession(request, publishableKey, accessToken) {
+  const response = await interacFetch(
+    "Failed to create Interac session",
+    "/sessions",
+    publishableKey,
+    { method: "POST", body: JSON.stringify(request) },
+    accessToken
+  );
+  return response.json();
+}
+async function cancelInteracSession(sessionId, publishableKey, accessToken) {
+  const response = await interacFetch(
+    "Failed to cancel Interac session",
+    `/sessions/${encodeURIComponent(sessionId)}/cancel`,
+    publishableKey,
+    { method: "POST" },
+    accessToken
+  );
+  return response.json();
+}
+async function getInteracSession(sessionId, publishableKey, accessToken) {
+  const response = await interacFetch(
+    "Failed to get Interac session",
+    `/sessions/${encodeURIComponent(sessionId)}`,
+    publishableKey,
+    { method: "GET" },
+    accessToken
+  );
+  return response.json();
+}
 async function stripeGetDefaultToken(params, publishableKey) {
   const pk = publishableKey || DEFAULT_PUBLISHABLE_KEY;
   validatePublishableKey(pk);
@@ -1667,7 +1841,142 @@ async function jsonOrThrow(response, label) {
   }
   return response.json();
 }
-async function createOnrampVerificationSession(request, publishableKey) {
+var IDENTITY_BASE = "/v1/public/identity";
+var BANK_TRANSFER_BASE = "/v1/public/onramps/bank_transfer";
+var ONRAMP_TOS_BASE = "/v1/public/onramps/terms_of_service";
+function identityHeaders(pk, json = false, onrampToken) {
+  return {
+    accept: "application/json",
+    "x-publishable-key": pk,
+    ...json ? { "Content-Type": "application/json" } : {},
+    ...onrampToken ? { "x-onramp-token": onrampToken } : {}
+  };
+}
+async function patchIdentityInformation(request, publishableKey, onrampToken) {
+  const pk = publishableKey || DEFAULT_PUBLISHABLE_KEY;
+  validatePublishableKey(pk);
+  const response = await apiFetch(`${API_BASE_URL}${IDENTITY_BASE}/information`, {
+    method: "PATCH",
+    headers: identityHeaders(pk, true, onrampToken),
+    body: JSON.stringify(request)
+  });
+  return jsonOrThrow(response, "Failed to submit identity information");
+}
+async function createIdentityVerificationSession(ctx, publishableKey, onrampToken) {
+  const pk = publishableKey || DEFAULT_PUBLISHABLE_KEY;
+  validatePublishableKey(pk);
+  const response = await apiFetch(`${API_BASE_URL}${IDENTITY_BASE}/verification_sessions`, {
+    method: "POST",
+    headers: identityHeaders(pk, true, onrampToken),
+    body: JSON.stringify(ctx)
+  });
+  return jsonOrThrow(
+    response,
+    "Failed to create identity verification session"
+  );
+}
+var BankTransferCapabilityStatus = /* @__PURE__ */ ((BankTransferCapabilityStatus2) => {
+  BankTransferCapabilityStatus2["IDENTITY_REQUIRED"] = "identity_required";
+  BankTransferCapabilityStatus2["TOS_REQUIRED"] = "tos_required";
+  BankTransferCapabilityStatus2["UNDER_REVIEW"] = "under_review";
+  BankTransferCapabilityStatus2["AWAITING_QUESTIONNAIRE"] = "awaiting_questionnaire";
+  BankTransferCapabilityStatus2["INCOMPLETE"] = "incomplete";
+  BankTransferCapabilityStatus2["PREPARING"] = "preparing";
+  BankTransferCapabilityStatus2["ACTIVE"] = "active";
+  BankTransferCapabilityStatus2["REJECTED"] = "rejected";
+  return BankTransferCapabilityStatus2;
+})(BankTransferCapabilityStatus || {});
+var BankTransferSessionStatus = /* @__PURE__ */ ((BankTransferSessionStatus2) => {
+  BankTransferSessionStatus2["AWAITING_FUNDS"] = "awaiting_funds";
+  BankTransferSessionStatus2["PROCESSING"] = "processing";
+  BankTransferSessionStatus2["COMPLETED"] = "completed";
+  BankTransferSessionStatus2["FAILED"] = "failed";
+  BankTransferSessionStatus2["EXPIRED"] = "expired";
+  return BankTransferSessionStatus2;
+})(BankTransferSessionStatus || {});
+async function createBankTransferCapability(request, publishableKey, onrampToken) {
+  const pk = publishableKey || DEFAULT_PUBLISHABLE_KEY;
+  validatePublishableKey(pk);
+  const response = await apiFetch(`${API_BASE_URL}${BANK_TRANSFER_BASE}/capabilities`, {
+    method: "POST",
+    headers: identityHeaders(pk, true, onrampToken),
+    body: JSON.stringify(request)
+  });
+  return jsonOrThrow(
+    response,
+    "Failed to resolve bank-transfer capability"
+  );
+}
+async function createBankTransferVirtualAccount(request, publishableKey, onrampToken) {
+  const pk = publishableKey || DEFAULT_PUBLISHABLE_KEY;
+  validatePublishableKey(pk);
+  const response = await apiFetch(`${API_BASE_URL}${BANK_TRANSFER_BASE}/virtual_accounts`, {
+    method: "POST",
+    headers: identityHeaders(pk, true, onrampToken),
+    body: JSON.stringify(request)
+  });
+  return jsonOrThrow(
+    response,
+    "Failed to open bank-transfer virtual account"
+  );
+}
+async function getBankTransferVirtualAccount(id, publishableKey, onrampToken) {
+  const pk = publishableKey || DEFAULT_PUBLISHABLE_KEY;
+  validatePublishableKey(pk);
+  const response = await apiFetch(
+    `${API_BASE_URL}${BANK_TRANSFER_BASE}/virtual_accounts/${encodeURIComponent(id)}`,
+    {
+      method: "GET",
+      headers: identityHeaders(pk, false, onrampToken)
+    }
+  );
+  return jsonOrThrow(
+    response,
+    "Failed to fetch bank-transfer virtual account"
+  );
+}
+async function createBankTransferSession(request, publishableKey, onrampToken) {
+  const pk = publishableKey || DEFAULT_PUBLISHABLE_KEY;
+  validatePublishableKey(pk);
+  const response = await apiFetch(`${API_BASE_URL}${BANK_TRANSFER_BASE}/sessions`, {
+    method: "POST",
+    headers: identityHeaders(pk, true, onrampToken),
+    body: JSON.stringify(request)
+  });
+  return jsonOrThrow(response, "Failed to create bank-transfer session");
+}
+async function getBankTransferSession(id, publishableKey, onrampToken) {
+  const pk = publishableKey || DEFAULT_PUBLISHABLE_KEY;
+  validatePublishableKey(pk);
+  const response = await apiFetch(
+    `${API_BASE_URL}${BANK_TRANSFER_BASE}/sessions/${encodeURIComponent(id)}`,
+    {
+      method: "GET",
+      headers: identityHeaders(pk, false, onrampToken)
+    }
+  );
+  return jsonOrThrow(response, "Failed to fetch bank-transfer session");
+}
+async function getOnrampTos(publishableKey) {
+  const pk = publishableKey || DEFAULT_PUBLISHABLE_KEY;
+  validatePublishableKey(pk);
+  const response = await apiFetch(`${API_BASE_URL}${ONRAMP_TOS_BASE}`, {
+    method: "GET",
+    headers: identityHeaders(pk)
+  });
+  return jsonOrThrow(response, "Failed to fetch terms of service");
+}
+async function acceptOnrampTos(request, publishableKey, onrampToken) {
+  const pk = publishableKey || DEFAULT_PUBLISHABLE_KEY;
+  validatePublishableKey(pk);
+  const response = await apiFetch(`${API_BASE_URL}${ONRAMP_TOS_BASE}`, {
+    method: "POST",
+    headers: identityHeaders(pk, true, onrampToken),
+    body: JSON.stringify(request)
+  });
+  return jsonOrThrow(response, "Failed to accept terms of service");
+}
+async function createOnrampVerificationSession(request, publishableKey, priorToken) {
   const pk = publishableKey || DEFAULT_PUBLISHABLE_KEY;
   validatePublishableKey(pk);
   const response = await apiFetch(`${API_BASE_URL}${VERIFICATION_BASE}`, {
@@ -1675,7 +1984,8 @@ async function createOnrampVerificationSession(request, publishableKey) {
     headers: {
       accept: "application/json",
       "x-publishable-key": pk,
-      "Content-Type": "application/json"
+      "Content-Type": "application/json",
+      ...priorToken ? { "x-onramp-token": priorToken } : {}
     },
     body: JSON.stringify(request)
   });
@@ -3894,6 +4204,8 @@ var en_default = {
 var i18n = en_default;
 export {
   ActionType,
+  BankTransferCapabilityStatus,
+  BankTransferSessionStatus,
   CheckoutEventType,
   DETECTION_ARM_DELAY_MS,
   DETECTION_POLL_INTERVAL_MS,
@@ -3907,6 +4219,7 @@ export {
   IneligibilityReason,
   IntegrationProvider,
   IntegrationTransferError,
+  InteracApiResponseError,
   LOOKBACK_MS,
   OnrampSession,
   OnrampSessionEventType,
@@ -3917,19 +4230,27 @@ export {
   StripeApiResponseError,
   UnifoldClient,
   WithdrawEventType,
+  acceptOnrampTos,
   authenticateIntegrationOAuth,
   buildHypercoreTransaction,
   buildSolanaTransaction,
+  cancelInteracSession,
   checkHypercoreActivation,
   confirmIntegrationTransfer,
+  createBankTransferCapability,
+  createBankTransferSession,
+  createBankTransferVirtualAccount,
   createCashAppSession,
   createCoinbaseApplePaySession,
   createCoinbaseGooglePaySession,
   createCoinbaseWalletPaySession,
   createDepositAddress,
   createExchangeSession,
+  createIdentityVerificationSession,
   createIntegrationExchangeSession,
   createIntegrationTransfer,
+  createInteracSession,
+  createInteracUser,
   createOnrampSession,
   createOnrampVerificationSession,
   createUnifoldClient,
@@ -3943,6 +4264,8 @@ export {
   getApplePayLimitUpgradeStatus,
   getApplePayProviders,
   getBankTransferProviders,
+  getBankTransferSession,
+  getBankTransferVirtualAccount,
   getCashAppLimits,
   getCashAppSessionStatus,
   getChainName,
@@ -3965,10 +4288,16 @@ export {
   getIntegrationExchanges,
   getIntegrationHoldings,
   getIntegrationTransferDefaultToken,
+  getInteracKycUrl,
+  getInteracLimits,
+  getInteracQuote,
+  getInteracSession,
+  getInteracStatus,
   getIpAddress,
   getOnrampQuotes,
   getOnrampSessionStartUrl,
   getOnrampSessionStatus,
+  getOnrampTos,
   getOnrampVerificationSession,
   getPreferredIconUrl,
   getProjectConfig,
@@ -3992,18 +4321,22 @@ export {
   mapDirectExecution,
   mapOnrampQuote,
   mapWalletToDepositAddress,
+  patchIdentityInformation,
   pollDirectExecutions,
   queryExecutions,
   refreshIntegrationToken,
   requestCoinbaseApplePayLimitUpgrade,
   requestCoinbaseWalletPayLimitUpgrade,
+  requestInteracOtp,
   retrievePaymentIntent,
   revokeIntegrationToken,
   sendHypercoreTransaction,
+  sendInteracPhoneVerification,
   sendOnrampVerificationOtp,
   sendSolanaTransaction,
   setApiConfig,
   startIntegrationOAuth,
+  startInterac,
   stripeConfirmSession,
   stripeCreateAuthIntent,
   stripeCreateSession,
@@ -4018,7 +4351,10 @@ export {
   stripeListWallets,
   stripeRefreshQuote,
   stripeRefreshToken,
+  updateInteracUser,
   useUserIp,
+  verifyInteracOtp,
+  verifyInteracPhone,
   verifyOnrampVerificationOtp,
   verifyRecipientAddress
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unifold/core",
-  "version": "0.1.81",
+  "version": "0.1.83",
   "description": "Unifold Core SDK - Core types, API client, and business logic",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",