@unifold/core 0.1.61 → 0.1.63

package/dist/index.d.mts

@@ -457,9 +457,11 @@ interface ProjectConfigResponse {
     project_name?: string;
     asset_cdn_url: string;
     transfer_crypto: {
+        enabled?: boolean;
         networks: FeaturedToken[];
     };
     connect_wallet: {
+        enabled?: boolean;
         wallets: FeaturedWallet[];
     };
     payment_networks: {
@@ -467,12 +469,21 @@ interface ProjectConfigResponse {
     };
     blocked_country_codes?: string[];
     blocked_country_subdivisions?: BlockedCountrySubdivision[];
+    connect_exchange?: {
+        enabled: boolean;
+    };
+    cash_app?: {
+        enabled: boolean;
+    };
     pay_with_exchange?: {
         enabled: boolean;
     };
     fiat_onramp?: {
         enabled: boolean;
     };
+    deposit_tracker?: {
+        enabled: boolean;
+    };
     hypercore_sponsorship?: {
         enabled: boolean;
     };
@@ -1195,6 +1206,11 @@ declare function sendHypercoreTransaction(request: SendHypercoreTransactionReque
  * formatStablecoinAmount("10000000", 6) // "10.00" (whole number)
  */
 declare function formatStablecoinAmount(baseUnits: string, decimals: number): string;
+/**
+ * Generate a KSUID-like ID without external dependencies.
+ * Format: `base62(4-byte-timestamp + 16-random-bytes)` (27 chars).
+ */
+declare function generateKSUID(): string;
 /**
  * Generate a KSUID-like prefixed ID without external dependencies.
  * Format: `{prefix}_{base62(4-byte-timestamp + 16-random-bytes)}` (27 chars after prefix).
@@ -1357,4 +1373,4 @@ declare const i18n: {
 };
 type I18nStrings = typeof i18n;
 
-export { ActionType, type AddressBalanceResponse, type AddressBalancesResponse, type AddressValidationFailureCode, type AddressValidationMetadata, type AuthenticateOAuthResult, type AutoSwapRequest, type AutoSwapResponse, type BlockedCountrySubdivision, type BuildHypercoreTransactionRequest, type BuildHypercoreTransactionResponse, type BuildSolanaTransactionRequest, type BuildSolanaTransactionResponse, type CashAppLimits, type CashAppSessionRequest, type CashAppSessionResponse, type CashAppSessionStatusResponse, type ChainType, type ConfirmIntegrationTransferResult, type CreateDepositAddressRequest, type CreateExchangeSessionRequest, type CreateExchangeSessionResponse, type CreateIntegrationTransferParams, type CreateIntegrationTransferResult, type DefaultTokenChain, type DefaultTokenMetadata, type DefaultTokenResponse, type DepositAddressResponse, type DepositEvent, DepositEventType, type DepositQuote, type DepositQuoteRequest, type DestinationToken, type DestinationTokenChain, type EvmContractCall, type ExchangeProviderInfo, type ExchangeProvidersResponse, type ExchangeSessionStartParams, type ExchangeWalletAddress, ExecutionStatus, type FeaturedToken, type FeaturedWallet, type FiatCurrenciesResponse, type FiatCurrency, type GetExchangesQuery, type HypercoreActionType, type HypercoreActivationRequest, type HypercoreActivationResponse, type I18nStrings, type IconUrl, IneligibilityReason, type IntegrationAccount, type IntegrationExchangeInfo, type IntegrationExchangesResponse, type IntegrationFeeAmount, type IntegrationHoldingsResponse, IntegrationProvider, type IpAddressResponse, type LockedQuoteLimits, type LockedQuotePreview, type LockedQuotePreviewRequest, type OnrampQuote, type OnrampQuotesRequest, type OnrampQuotesResponse, type OnrampSessionCreatedData, type OnrampSessionCreatedEvent, type OnrampSessionRequest, type OnrampSessionResponse, type PaymentIntent, type PaymentIntentDepositAddress, type PaymentIntentExecutionsResponse, type PaymentIntentStatus, type PaymentIntentType, type PaymentNetwork, type PollExecutionsRequest, type PollExecutionsResponse, type ProductType, type ProjectConfigResponse, type QueryExecutionsRequest, type QueryExecutionsResponse, type RefreshIntegrationTokenResult, SOLANA_USDC_ADDRESS, type SendHypercoreTransactionRequest, type SendHypercoreTransactionResponse, type SendSolanaTransactionRequest, type SendSolanaTransactionResponse, type SourceToken, type SourceTokenNetwork, type StartIntegrationOAuthResult, type SupportedChain, type SupportedDepositTokensResponse, type SupportedDestinationTokensResponse, type SupportedSourceTokensQuery, type SupportedSourceTokensResponse, type SupportedToken, type TokenBalance, type TokenChain, type TokenChainIconUrl, type TokenChainsResponse, type TokenIconUrl, type TokenInfo, type TokenMetadata, type TransferDefaultTokenParams, type TransferDefaultTokenResult, type UserIpInfo, type VerifyAddressRequest, type VerifyAddressResponse, type Wallet, authenticateIntegrationOAuth, buildHypercoreTransaction, buildSolanaTransaction, checkHypercoreActivation, confirmIntegrationTransfer, createCashAppSession, createDepositAddress, createExchangeSession, createIntegrationTransfer, createOnrampSession, formatStablecoinAmount, generatePrefixedKSUID, getAddressBalance, getAddressBalances, getApiBaseUrl, getCashAppLimits, getCashAppSessionStatus, getChainName, getDefaultOnrampToken, getDepositAddress, getDepositQuote, getExchangeSessionStartUrl, getExchanges, getFiatCurrencies, getIconUrl, getIconUrlWithCdn, getIntegrationExchanges, getIntegrationHoldings, getIntegrationTransferDefaultToken, getIpAddress, getOnrampQuotes, getOnrampSessionStartUrl, getPreferredIconUrl, getProjectConfig, getSupportedDepositTokens, getSupportedDestinationTokens, getTokenChains, getTokenMetadata, getWalletByChainType, i18n, listPaymentIntentExecutions, pollDirectExecutions, queryExecutions, refreshIntegrationToken, retrievePaymentIntent, revokeIntegrationToken, sendHypercoreTransaction, sendSolanaTransaction, setApiConfig, startIntegrationOAuth, useUserIp, verifyRecipientAddress };
+export { ActionType, type AddressBalanceResponse, type AddressBalancesResponse, type AddressValidationFailureCode, type AddressValidationMetadata, type AuthenticateOAuthResult, type AutoSwapRequest, type AutoSwapResponse, type BlockedCountrySubdivision, type BuildHypercoreTransactionRequest, type BuildHypercoreTransactionResponse, type BuildSolanaTransactionRequest, type BuildSolanaTransactionResponse, type CashAppLimits, type CashAppSessionRequest, type CashAppSessionResponse, type CashAppSessionStatusResponse, type ChainType, type ConfirmIntegrationTransferResult, type CreateDepositAddressRequest, type CreateExchangeSessionRequest, type CreateExchangeSessionResponse, type CreateIntegrationTransferParams, type CreateIntegrationTransferResult, type DefaultTokenChain, type DefaultTokenMetadata, type DefaultTokenResponse, type DepositAddressResponse, type DepositEvent, DepositEventType, type DepositQuote, type DepositQuoteRequest, type DestinationToken, type DestinationTokenChain, type EvmContractCall, type ExchangeProviderInfo, type ExchangeProvidersResponse, type ExchangeSessionStartParams, type ExchangeWalletAddress, ExecutionStatus, type FeaturedToken, type FeaturedWallet, type FiatCurrenciesResponse, type FiatCurrency, type GetExchangesQuery, type HypercoreActionType, type HypercoreActivationRequest, type HypercoreActivationResponse, type I18nStrings, type IconUrl, IneligibilityReason, type IntegrationAccount, type IntegrationExchangeInfo, type IntegrationExchangesResponse, type IntegrationFeeAmount, type IntegrationHoldingsResponse, IntegrationProvider, type IpAddressResponse, type LockedQuoteLimits, type LockedQuotePreview, type LockedQuotePreviewRequest, type OnrampQuote, type OnrampQuotesRequest, type OnrampQuotesResponse, type OnrampSessionCreatedData, type OnrampSessionCreatedEvent, type OnrampSessionRequest, type OnrampSessionResponse, type PaymentIntent, type PaymentIntentDepositAddress, type PaymentIntentExecutionsResponse, type PaymentIntentStatus, type PaymentIntentType, type PaymentNetwork, type PollExecutionsRequest, type PollExecutionsResponse, type ProductType, type ProjectConfigResponse, type QueryExecutionsRequest, type QueryExecutionsResponse, type RefreshIntegrationTokenResult, SOLANA_USDC_ADDRESS, type SendHypercoreTransactionRequest, type SendHypercoreTransactionResponse, type SendSolanaTransactionRequest, type SendSolanaTransactionResponse, type SourceToken, type SourceTokenNetwork, type StartIntegrationOAuthResult, type SupportedChain, type SupportedDepositTokensResponse, type SupportedDestinationTokensResponse, type SupportedSourceTokensQuery, type SupportedSourceTokensResponse, type SupportedToken, type TokenBalance, type TokenChain, type TokenChainIconUrl, type TokenChainsResponse, type TokenIconUrl, type TokenInfo, type TokenMetadata, type TransferDefaultTokenParams, type TransferDefaultTokenResult, type UserIpInfo, type VerifyAddressRequest, type VerifyAddressResponse, type Wallet, authenticateIntegrationOAuth, buildHypercoreTransaction, buildSolanaTransaction, checkHypercoreActivation, confirmIntegrationTransfer, createCashAppSession, createDepositAddress, createExchangeSession, createIntegrationTransfer, createOnrampSession, formatStablecoinAmount, generateKSUID, generatePrefixedKSUID, getAddressBalance, getAddressBalances, getApiBaseUrl, getCashAppLimits, getCashAppSessionStatus, getChainName, getDefaultOnrampToken, getDepositAddress, getDepositQuote, getExchangeSessionStartUrl, getExchanges, getFiatCurrencies, getIconUrl, getIconUrlWithCdn, getIntegrationExchanges, getIntegrationHoldings, getIntegrationTransferDefaultToken, getIpAddress, getOnrampQuotes, getOnrampSessionStartUrl, getPreferredIconUrl, getProjectConfig, getSupportedDepositTokens, getSupportedDestinationTokens, getTokenChains, getTokenMetadata, getWalletByChainType, i18n, listPaymentIntentExecutions, pollDirectExecutions, queryExecutions, refreshIntegrationToken, retrievePaymentIntent, revokeIntegrationToken, sendHypercoreTransaction, sendSolanaTransaction, setApiConfig, startIntegrationOAuth, useUserIp, verifyRecipientAddress };

package/dist/index.d.ts

@@ -457,9 +457,11 @@ interface ProjectConfigResponse {
     project_name?: string;
     asset_cdn_url: string;
     transfer_crypto: {
+        enabled?: boolean;
         networks: FeaturedToken[];
     };
     connect_wallet: {
+        enabled?: boolean;
         wallets: FeaturedWallet[];
     };
     payment_networks: {
@@ -467,12 +469,21 @@ interface ProjectConfigResponse {
     };
     blocked_country_codes?: string[];
     blocked_country_subdivisions?: BlockedCountrySubdivision[];
+    connect_exchange?: {
+        enabled: boolean;
+    };
+    cash_app?: {
+        enabled: boolean;
+    };
     pay_with_exchange?: {
         enabled: boolean;
     };
     fiat_onramp?: {
         enabled: boolean;
     };
+    deposit_tracker?: {
+        enabled: boolean;
+    };
     hypercore_sponsorship?: {
         enabled: boolean;
     };
@@ -1195,6 +1206,11 @@ declare function sendHypercoreTransaction(request: SendHypercoreTransactionReque
  * formatStablecoinAmount("10000000", 6) // "10.00" (whole number)
  */
 declare function formatStablecoinAmount(baseUnits: string, decimals: number): string;
+/**
+ * Generate a KSUID-like ID without external dependencies.
+ * Format: `base62(4-byte-timestamp + 16-random-bytes)` (27 chars).
+ */
+declare function generateKSUID(): string;
 /**
  * Generate a KSUID-like prefixed ID without external dependencies.
  * Format: `{prefix}_{base62(4-byte-timestamp + 16-random-bytes)}` (27 chars after prefix).
@@ -1357,4 +1373,4 @@ declare const i18n: {
 };
 type I18nStrings = typeof i18n;
 
-export { ActionType, type AddressBalanceResponse, type AddressBalancesResponse, type AddressValidationFailureCode, type AddressValidationMetadata, type AuthenticateOAuthResult, type AutoSwapRequest, type AutoSwapResponse, type BlockedCountrySubdivision, type BuildHypercoreTransactionRequest, type BuildHypercoreTransactionResponse, type BuildSolanaTransactionRequest, type BuildSolanaTransactionResponse, type CashAppLimits, type CashAppSessionRequest, type CashAppSessionResponse, type CashAppSessionStatusResponse, type ChainType, type ConfirmIntegrationTransferResult, type CreateDepositAddressRequest, type CreateExchangeSessionRequest, type CreateExchangeSessionResponse, type CreateIntegrationTransferParams, type CreateIntegrationTransferResult, type DefaultTokenChain, type DefaultTokenMetadata, type DefaultTokenResponse, type DepositAddressResponse, type DepositEvent, DepositEventType, type DepositQuote, type DepositQuoteRequest, type DestinationToken, type DestinationTokenChain, type EvmContractCall, type ExchangeProviderInfo, type ExchangeProvidersResponse, type ExchangeSessionStartParams, type ExchangeWalletAddress, ExecutionStatus, type FeaturedToken, type FeaturedWallet, type FiatCurrenciesResponse, type FiatCurrency, type GetExchangesQuery, type HypercoreActionType, type HypercoreActivationRequest, type HypercoreActivationResponse, type I18nStrings, type IconUrl, IneligibilityReason, type IntegrationAccount, type IntegrationExchangeInfo, type IntegrationExchangesResponse, type IntegrationFeeAmount, type IntegrationHoldingsResponse, IntegrationProvider, type IpAddressResponse, type LockedQuoteLimits, type LockedQuotePreview, type LockedQuotePreviewRequest, type OnrampQuote, type OnrampQuotesRequest, type OnrampQuotesResponse, type OnrampSessionCreatedData, type OnrampSessionCreatedEvent, type OnrampSessionRequest, type OnrampSessionResponse, type PaymentIntent, type PaymentIntentDepositAddress, type PaymentIntentExecutionsResponse, type PaymentIntentStatus, type PaymentIntentType, type PaymentNetwork, type PollExecutionsRequest, type PollExecutionsResponse, type ProductType, type ProjectConfigResponse, type QueryExecutionsRequest, type QueryExecutionsResponse, type RefreshIntegrationTokenResult, SOLANA_USDC_ADDRESS, type SendHypercoreTransactionRequest, type SendHypercoreTransactionResponse, type SendSolanaTransactionRequest, type SendSolanaTransactionResponse, type SourceToken, type SourceTokenNetwork, type StartIntegrationOAuthResult, type SupportedChain, type SupportedDepositTokensResponse, type SupportedDestinationTokensResponse, type SupportedSourceTokensQuery, type SupportedSourceTokensResponse, type SupportedToken, type TokenBalance, type TokenChain, type TokenChainIconUrl, type TokenChainsResponse, type TokenIconUrl, type TokenInfo, type TokenMetadata, type TransferDefaultTokenParams, type TransferDefaultTokenResult, type UserIpInfo, type VerifyAddressRequest, type VerifyAddressResponse, type Wallet, authenticateIntegrationOAuth, buildHypercoreTransaction, buildSolanaTransaction, checkHypercoreActivation, confirmIntegrationTransfer, createCashAppSession, createDepositAddress, createExchangeSession, createIntegrationTransfer, createOnrampSession, formatStablecoinAmount, generatePrefixedKSUID, getAddressBalance, getAddressBalances, getApiBaseUrl, getCashAppLimits, getCashAppSessionStatus, getChainName, getDefaultOnrampToken, getDepositAddress, getDepositQuote, getExchangeSessionStartUrl, getExchanges, getFiatCurrencies, getIconUrl, getIconUrlWithCdn, getIntegrationExchanges, getIntegrationHoldings, getIntegrationTransferDefaultToken, getIpAddress, getOnrampQuotes, getOnrampSessionStartUrl, getPreferredIconUrl, getProjectConfig, getSupportedDepositTokens, getSupportedDestinationTokens, getTokenChains, getTokenMetadata, getWalletByChainType, i18n, listPaymentIntentExecutions, pollDirectExecutions, queryExecutions, refreshIntegrationToken, retrievePaymentIntent, revokeIntegrationToken, sendHypercoreTransaction, sendSolanaTransaction, setApiConfig, startIntegrationOAuth, useUserIp, verifyRecipientAddress };
+export { ActionType, type AddressBalanceResponse, type AddressBalancesResponse, type AddressValidationFailureCode, type AddressValidationMetadata, type AuthenticateOAuthResult, type AutoSwapRequest, type AutoSwapResponse, type BlockedCountrySubdivision, type BuildHypercoreTransactionRequest, type BuildHypercoreTransactionResponse, type BuildSolanaTransactionRequest, type BuildSolanaTransactionResponse, type CashAppLimits, type CashAppSessionRequest, type CashAppSessionResponse, type CashAppSessionStatusResponse, type ChainType, type ConfirmIntegrationTransferResult, type CreateDepositAddressRequest, type CreateExchangeSessionRequest, type CreateExchangeSessionResponse, type CreateIntegrationTransferParams, type CreateIntegrationTransferResult, type DefaultTokenChain, type DefaultTokenMetadata, type DefaultTokenResponse, type DepositAddressResponse, type DepositEvent, DepositEventType, type DepositQuote, type DepositQuoteRequest, type DestinationToken, type DestinationTokenChain, type EvmContractCall, type ExchangeProviderInfo, type ExchangeProvidersResponse, type ExchangeSessionStartParams, type ExchangeWalletAddress, ExecutionStatus, type FeaturedToken, type FeaturedWallet, type FiatCurrenciesResponse, type FiatCurrency, type GetExchangesQuery, type HypercoreActionType, type HypercoreActivationRequest, type HypercoreActivationResponse, type I18nStrings, type IconUrl, IneligibilityReason, type IntegrationAccount, type IntegrationExchangeInfo, type IntegrationExchangesResponse, type IntegrationFeeAmount, type IntegrationHoldingsResponse, IntegrationProvider, type IpAddressResponse, type LockedQuoteLimits, type LockedQuotePreview, type LockedQuotePreviewRequest, type OnrampQuote, type OnrampQuotesRequest, type OnrampQuotesResponse, type OnrampSessionCreatedData, type OnrampSessionCreatedEvent, type OnrampSessionRequest, type OnrampSessionResponse, type PaymentIntent, type PaymentIntentDepositAddress, type PaymentIntentExecutionsResponse, type PaymentIntentStatus, type PaymentIntentType, type PaymentNetwork, type PollExecutionsRequest, type PollExecutionsResponse, type ProductType, type ProjectConfigResponse, type QueryExecutionsRequest, type QueryExecutionsResponse, type RefreshIntegrationTokenResult, SOLANA_USDC_ADDRESS, type SendHypercoreTransactionRequest, type SendHypercoreTransactionResponse, type SendSolanaTransactionRequest, type SendSolanaTransactionResponse, type SourceToken, type SourceTokenNetwork, type StartIntegrationOAuthResult, type SupportedChain, type SupportedDepositTokensResponse, type SupportedDestinationTokensResponse, type SupportedSourceTokensQuery, type SupportedSourceTokensResponse, type SupportedToken, type TokenBalance, type TokenChain, type TokenChainIconUrl, type TokenChainsResponse, type TokenIconUrl, type TokenInfo, type TokenMetadata, type TransferDefaultTokenParams, type TransferDefaultTokenResult, type UserIpInfo, type VerifyAddressRequest, type VerifyAddressResponse, type Wallet, authenticateIntegrationOAuth, buildHypercoreTransaction, buildSolanaTransaction, checkHypercoreActivation, confirmIntegrationTransfer, createCashAppSession, createDepositAddress, createExchangeSession, createIntegrationTransfer, createOnrampSession, formatStablecoinAmount, generateKSUID, generatePrefixedKSUID, getAddressBalance, getAddressBalances, getApiBaseUrl, getCashAppLimits, getCashAppSessionStatus, getChainName, getDefaultOnrampToken, getDepositAddress, getDepositQuote, getExchangeSessionStartUrl, getExchanges, getFiatCurrencies, getIconUrl, getIconUrlWithCdn, getIntegrationExchanges, getIntegrationHoldings, getIntegrationTransferDefaultToken, getIpAddress, getOnrampQuotes, getOnrampSessionStartUrl, getPreferredIconUrl, getProjectConfig, getSupportedDepositTokens, getSupportedDestinationTokens, getTokenChains, getTokenMetadata, getWalletByChainType, i18n, listPaymentIntentExecutions, pollDirectExecutions, queryExecutions, refreshIntegrationToken, retrievePaymentIntent, revokeIntegrationToken, sendHypercoreTransaction, sendSolanaTransaction, setApiConfig, startIntegrationOAuth, useUserIp, verifyRecipientAddress };

package/dist/index.js

@@ -37,6 +37,7 @@ __export(index_exports, {
   createIntegrationTransfer: () => createIntegrationTransfer,
   createOnrampSession: () => createOnrampSession,
   formatStablecoinAmount: () => formatStablecoinAmount,
+  generateKSUID: () => generateKSUID,
   generatePrefixedKSUID: () => generatePrefixedKSUID,
   getAddressBalance: () => getAddressBalance,
   getAddressBalances: () => getAddressBalances,
@@ -81,6 +82,44 @@ __export(index_exports, {
 });
 module.exports = __toCommonJS(index_exports);
 
+// src/lib/utils.ts
+function formatStablecoinAmount(baseUnits, decimals) {
+  const raw = Number(baseUnits) / 10 ** decimals;
+  const floored = Math.floor(raw * 100) / 100;
+  const ceiled = raw > floored ? floored + 0.01 : raw;
+  return ceiled.toFixed(2);
+}
+function generateKSUID() {
+  const BASE62 = "0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz";
+  const KSUID_EPOCH = 14e8;
+  const timestampSeconds = Math.floor(Date.now() / 1e3) - KSUID_EPOCH;
+  const payload = new Uint8Array(20);
+  payload[0] = timestampSeconds >>> 24 & 255;
+  payload[1] = timestampSeconds >>> 16 & 255;
+  payload[2] = timestampSeconds >>> 8 & 255;
+  payload[3] = timestampSeconds & 255;
+  if (typeof crypto !== "undefined" && crypto.getRandomValues) {
+    crypto.getRandomValues(payload.subarray(4));
+  } else {
+    for (let i = 4; i < 20; i++) {
+      payload[i] = Math.floor(Math.random() * 256);
+    }
+  }
+  let value = 0n;
+  for (const byte of payload) {
+    value = value << 8n | BigInt(byte);
+  }
+  let encoded = "";
+  while (value > 0n) {
+    encoded = BASE62[Number(value % 62n)] + encoded;
+    value = value / 62n;
+  }
+  return encoded.padStart(27, "0");
+}
+function generatePrefixedKSUID(prefix) {
+  return `${prefix}_${generateKSUID()}`;
+}
+
 // src/lib/api.ts
 var API_BASE_URL = (() => {
   try {
@@ -408,9 +447,7 @@ function getOnrampSessionStartUrl(request, publishableKey) {
   if (request.subdivision_code) {
     params.append("subdivision_code", request.subdivision_code);
   }
-  if (request.external_id) {
-    params.append("external_id", request.external_id);
-  }
+  params.append("external_id", request.external_id ?? generatePrefixedKSUID("ors"));
   if (request.email) {
     params.append("email", request.email);
   }
@@ -645,9 +682,7 @@ function getExchangeSessionStartUrl(request, publishableKey) {
   if (request.source_amount) {
     params.append("source_amount", request.source_amount);
   }
-  if (request.external_id) {
-    params.append("external_id", request.external_id);
-  }
+  params.append("external_id", request.external_id ?? generatePrefixedKSUID("exc"));
   return `${API_BASE_URL}/v1/public/onramps/exchanges/sessions/start?${params.toString()}`;
 }
 async function getIntegrationExchanges(publishableKey) {
@@ -1028,42 +1063,6 @@ async function sendHypercoreTransaction(request, publishableKey) {
   return response.json();
 }
 
-// src/lib/utils.ts
-function formatStablecoinAmount(baseUnits, decimals) {
-  const raw = Number(baseUnits) / 10 ** decimals;
-  const floored = Math.floor(raw * 100) / 100;
-  const ceiled = raw > floored ? floored + 0.01 : raw;
-  return ceiled.toFixed(2);
-}
-function generatePrefixedKSUID(prefix) {
-  const BASE62 = "0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz";
-  const KSUID_EPOCH = 14e8;
-  const timestampSeconds = Math.floor(Date.now() / 1e3) - KSUID_EPOCH;
-  const payload = new Uint8Array(20);
-  payload[0] = timestampSeconds >>> 24 & 255;
-  payload[1] = timestampSeconds >>> 16 & 255;
-  payload[2] = timestampSeconds >>> 8 & 255;
-  payload[3] = timestampSeconds & 255;
-  if (typeof crypto !== "undefined" && crypto.getRandomValues) {
-    crypto.getRandomValues(payload.subarray(4));
-  } else {
-    for (let i = 4; i < 20; i++) {
-      payload[i] = Math.floor(Math.random() * 256);
-    }
-  }
-  let value = 0n;
-  for (const byte of payload) {
-    value = value << 8n | BigInt(byte);
-  }
-  let encoded = "";
-  while (value > 0n) {
-    encoded = BASE62[Number(value % 62n)] + encoded;
-    value = value / 62n;
-  }
-  encoded = encoded.padStart(27, "0");
-  return `${prefix}_${encoded}`;
-}
-
 // src/lib/events.ts
 var DepositEventType = /* @__PURE__ */ ((DepositEventType2) => {
   DepositEventType2["ONRAMP_SESSION_CREATED"] = "onramp_session.created";
@@ -1220,6 +1219,7 @@ var i18n = en_default;
   createIntegrationTransfer,
   createOnrampSession,
   formatStablecoinAmount,
+  generateKSUID,
   generatePrefixedKSUID,
   getAddressBalance,
   getAddressBalances,

package/dist/index.mjs

@@ -1,3 +1,41 @@
+// src/lib/utils.ts
+function formatStablecoinAmount(baseUnits, decimals) {
+  const raw = Number(baseUnits) / 10 ** decimals;
+  const floored = Math.floor(raw * 100) / 100;
+  const ceiled = raw > floored ? floored + 0.01 : raw;
+  return ceiled.toFixed(2);
+}
+function generateKSUID() {
+  const BASE62 = "0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz";
+  const KSUID_EPOCH = 14e8;
+  const timestampSeconds = Math.floor(Date.now() / 1e3) - KSUID_EPOCH;
+  const payload = new Uint8Array(20);
+  payload[0] = timestampSeconds >>> 24 & 255;
+  payload[1] = timestampSeconds >>> 16 & 255;
+  payload[2] = timestampSeconds >>> 8 & 255;
+  payload[3] = timestampSeconds & 255;
+  if (typeof crypto !== "undefined" && crypto.getRandomValues) {
+    crypto.getRandomValues(payload.subarray(4));
+  } else {
+    for (let i = 4; i < 20; i++) {
+      payload[i] = Math.floor(Math.random() * 256);
+    }
+  }
+  let value = 0n;
+  for (const byte of payload) {
+    value = value << 8n | BigInt(byte);
+  }
+  let encoded = "";
+  while (value > 0n) {
+    encoded = BASE62[Number(value % 62n)] + encoded;
+    value = value / 62n;
+  }
+  return encoded.padStart(27, "0");
+}
+function generatePrefixedKSUID(prefix) {
+  return `${prefix}_${generateKSUID()}`;
+}
+
 // src/lib/api.ts
 var API_BASE_URL = (() => {
   try {
@@ -325,9 +363,7 @@ function getOnrampSessionStartUrl(request, publishableKey) {
   if (request.subdivision_code) {
     params.append("subdivision_code", request.subdivision_code);
   }
-  if (request.external_id) {
-    params.append("external_id", request.external_id);
-  }
+  params.append("external_id", request.external_id ?? generatePrefixedKSUID("ors"));
   if (request.email) {
     params.append("email", request.email);
   }
@@ -562,9 +598,7 @@ function getExchangeSessionStartUrl(request, publishableKey) {
   if (request.source_amount) {
     params.append("source_amount", request.source_amount);
   }
-  if (request.external_id) {
-    params.append("external_id", request.external_id);
-  }
+  params.append("external_id", request.external_id ?? generatePrefixedKSUID("exc"));
   return `${API_BASE_URL}/v1/public/onramps/exchanges/sessions/start?${params.toString()}`;
 }
 async function getIntegrationExchanges(publishableKey) {
@@ -945,42 +979,6 @@ async function sendHypercoreTransaction(request, publishableKey) {
   return response.json();
 }
 
-// src/lib/utils.ts
-function formatStablecoinAmount(baseUnits, decimals) {
-  const raw = Number(baseUnits) / 10 ** decimals;
-  const floored = Math.floor(raw * 100) / 100;
-  const ceiled = raw > floored ? floored + 0.01 : raw;
-  return ceiled.toFixed(2);
-}
-function generatePrefixedKSUID(prefix) {
-  const BASE62 = "0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz";
-  const KSUID_EPOCH = 14e8;
-  const timestampSeconds = Math.floor(Date.now() / 1e3) - KSUID_EPOCH;
-  const payload = new Uint8Array(20);
-  payload[0] = timestampSeconds >>> 24 & 255;
-  payload[1] = timestampSeconds >>> 16 & 255;
-  payload[2] = timestampSeconds >>> 8 & 255;
-  payload[3] = timestampSeconds & 255;
-  if (typeof crypto !== "undefined" && crypto.getRandomValues) {
-    crypto.getRandomValues(payload.subarray(4));
-  } else {
-    for (let i = 4; i < 20; i++) {
-      payload[i] = Math.floor(Math.random() * 256);
-    }
-  }
-  let value = 0n;
-  for (const byte of payload) {
-    value = value << 8n | BigInt(byte);
-  }
-  let encoded = "";
-  while (value > 0n) {
-    encoded = BASE62[Number(value % 62n)] + encoded;
-    value = value / 62n;
-  }
-  encoded = encoded.padStart(27, "0");
-  return `${prefix}_${encoded}`;
-}
-
 // src/lib/events.ts
 var DepositEventType = /* @__PURE__ */ ((DepositEventType2) => {
   DepositEventType2["ONRAMP_SESSION_CREATED"] = "onramp_session.created";
@@ -1136,6 +1134,7 @@ export {
   createIntegrationTransfer,
   createOnrampSession,
   formatStablecoinAmount,
+  generateKSUID,
   generatePrefixedKSUID,
   getAddressBalance,
   getAddressBalances,

package/package.json

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