@unifold/core 0.1.80 → 0.1.82

package/dist/index.d.mts

@@ -258,6 +258,21 @@ declare function getSupportedDestinationTokens(publishableKey?: string, options?
      */
     source_chain_type?: ChainType;
 }): Promise<SupportedDestinationTokensResponse>;
+/**
+ * Fiat currency a stablecoin is pegged to (lowercase ISO 4217). Mirrors the
+ * API's `FiatCurrency` enum; kept as a local union here because the SDK cannot
+ * import server-side types across the package boundary. Named distinctly from
+ * the onramp `FiatCurrency` object interface below.
+ *
+ * This is intentionally an OPEN union: `'usd'` and `'eur'` are listed for
+ * editor autocomplete, but the `(string & Record<never, never>)` member keeps
+ * the type forward-compatible. If the backend later adds a new fiat currency
+ * (e.g. `'gbp'`), an older SDK build still type-checks — the new value is a
+ * valid `string`, so consumers can compare/handle it without a TS error and
+ * without needing to upgrade. Always treat unknown values defensively rather
+ * than assuming USD.
+ */
+type StablecoinFiatCurrency = 'usd' | 'eur' | (string & Record<never, never>);
 interface SupportedToken {
     symbol: string;
     /** Slugged `symbol` (e.g. "usdc", "usdc_e", "usdc_perp"). */
@@ -266,6 +281,12 @@ interface SupportedToken {
     icon_url: string;
     is_newly_added: boolean;
     is_stablecoin: boolean;
+    /**
+     * Fiat currency a stablecoin tracks (e.g. "usd", "eur"). Present only for
+     * stablecoins. Consumers must not assume a stablecoin is USD-denominated —
+     * check this before treating a token amount as a USD amount.
+     */
+    stablecoin_fiat_currency?: StablecoinFiatCurrency;
     chains: SupportedChain[];
 }
 interface SupportedDepositTokensResponse {
@@ -297,6 +318,8 @@ interface TokenMetadata {
     chain_id: string;
     token_address: string;
     decimals: number;
+    /** Catalog classification from `/v1/public/tokens/token`. */
+    is_stablecoin?: boolean;
     chain_icon_url: string;
     chain_icon_urls: IconUrl[];
 }
@@ -400,6 +423,8 @@ interface OnrampQuote {
     institution_name: string | null;
     low_kyc: boolean;
     partner_fee: number | null;
+    /** Seconds. Same unit as token `estimated_processing_time`. */
+    estimated_processing_time: number;
 }
 interface OnrampQuotesRequest {
     country_code: string;
@@ -963,7 +988,7 @@ interface VerifyAddressRequest {
  * Standard error codes for address validation failures.
  * Used by frontend to display localized error messages.
  */
-type AddressValidationFailureCode = 'token_not_supported' | 'not_opted_in' | 'insufficient_balance' | 'account_not_found' | 'validation_error';
+type AddressValidationFailureCode = 'token_not_supported' | 'not_opted_in' | 'insufficient_balance' | 'account_not_found' | 'destination_tag_required' | 'validation_error';
 interface AddressValidationMetadata {
     chain_name?: string;
     token_symbol?: string;
@@ -1900,6 +1925,7 @@ interface StripeQuotesResponse {
     destination_network: string;
     service_provider: string;
     service_provider_display_name: string;
+    estimated_processing_time: number;
     destination_network_quotes: Record<string, unknown[]>;
 }
 /**
@@ -2897,6 +2923,8 @@ interface OnrampProviderQuote {
     iconUrl: string;
     iconUrls: IconUrl[];
     institutionName: string | null;
+    /** Seconds. Same unit as token `estimatedProcessingTime`. */
+    estimatedProcessingTime: number;
 }
 /** Map a wire {@link OnrampQuote} to the SDK-facing {@link OnrampProviderQuote}. */
 declare function mapOnrampQuote(quote: OnrampQuote): OnrampProviderQuote;

package/dist/index.d.ts

@@ -258,6 +258,21 @@ declare function getSupportedDestinationTokens(publishableKey?: string, options?
      */
     source_chain_type?: ChainType;
 }): Promise<SupportedDestinationTokensResponse>;
+/**
+ * Fiat currency a stablecoin is pegged to (lowercase ISO 4217). Mirrors the
+ * API's `FiatCurrency` enum; kept as a local union here because the SDK cannot
+ * import server-side types across the package boundary. Named distinctly from
+ * the onramp `FiatCurrency` object interface below.
+ *
+ * This is intentionally an OPEN union: `'usd'` and `'eur'` are listed for
+ * editor autocomplete, but the `(string & Record<never, never>)` member keeps
+ * the type forward-compatible. If the backend later adds a new fiat currency
+ * (e.g. `'gbp'`), an older SDK build still type-checks — the new value is a
+ * valid `string`, so consumers can compare/handle it without a TS error and
+ * without needing to upgrade. Always treat unknown values defensively rather
+ * than assuming USD.
+ */
+type StablecoinFiatCurrency = 'usd' | 'eur' | (string & Record<never, never>);
 interface SupportedToken {
     symbol: string;
     /** Slugged `symbol` (e.g. "usdc", "usdc_e", "usdc_perp"). */
@@ -266,6 +281,12 @@ interface SupportedToken {
     icon_url: string;
     is_newly_added: boolean;
     is_stablecoin: boolean;
+    /**
+     * Fiat currency a stablecoin tracks (e.g. "usd", "eur"). Present only for
+     * stablecoins. Consumers must not assume a stablecoin is USD-denominated —
+     * check this before treating a token amount as a USD amount.
+     */
+    stablecoin_fiat_currency?: StablecoinFiatCurrency;
     chains: SupportedChain[];
 }
 interface SupportedDepositTokensResponse {
@@ -297,6 +318,8 @@ interface TokenMetadata {
     chain_id: string;
     token_address: string;
     decimals: number;
+    /** Catalog classification from `/v1/public/tokens/token`. */
+    is_stablecoin?: boolean;
     chain_icon_url: string;
     chain_icon_urls: IconUrl[];
 }
@@ -400,6 +423,8 @@ interface OnrampQuote {
     institution_name: string | null;
     low_kyc: boolean;
     partner_fee: number | null;
+    /** Seconds. Same unit as token `estimated_processing_time`. */
+    estimated_processing_time: number;
 }
 interface OnrampQuotesRequest {
     country_code: string;
@@ -963,7 +988,7 @@ interface VerifyAddressRequest {
  * Standard error codes for address validation failures.
  * Used by frontend to display localized error messages.
  */
-type AddressValidationFailureCode = 'token_not_supported' | 'not_opted_in' | 'insufficient_balance' | 'account_not_found' | 'validation_error';
+type AddressValidationFailureCode = 'token_not_supported' | 'not_opted_in' | 'insufficient_balance' | 'account_not_found' | 'destination_tag_required' | 'validation_error';
 interface AddressValidationMetadata {
     chain_name?: string;
     token_symbol?: string;
@@ -1900,6 +1925,7 @@ interface StripeQuotesResponse {
     destination_network: string;
     service_provider: string;
     service_provider_display_name: string;
+    estimated_processing_time: number;
     destination_network_quotes: Record<string, unknown[]>;
 }
 /**
@@ -2897,6 +2923,8 @@ interface OnrampProviderQuote {
     iconUrl: string;
     iconUrls: IconUrl[];
     institutionName: string | null;
+    /** Seconds. Same unit as token `estimatedProcessingTime`. */
+    estimatedProcessingTime: number;
 }
 /** Map a wire {@link OnrampQuote} to the SDK-facing {@link OnrampProviderQuote}. */
 declare function mapOnrampQuote(quote: OnrampQuote): OnrampProviderQuote;

package/dist/index.js

@@ -192,7 +192,7 @@ function generatePrefixedKSUID(prefix) {
 }
 
 // src/lib/client-headers.ts
-var SDK_VERSION = true ? "0.1.80" : "0.0.0-dev";
+var SDK_VERSION = true ? "0.1.82" : "0.0.0-dev";
 var CLIENT_VERSION_HEADER = "x-unifold-client-version";
 var CLIENT_USER_AGENT_HEADER = "x-unifold-client-user-agent";
 function detectRuntime() {
@@ -355,6 +355,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}`);
   }
@@ -2156,7 +2161,8 @@ function mapOnrampQuote(quote) {
     lowKyc: quote.low_kyc,
     iconUrl: quote.icon_url,
     iconUrls: quote.icon_urls,
-    institutionName: quote.institution_name
+    institutionName: quote.institution_name,
+    estimatedProcessingTime: quote.estimated_processing_time
   };
 }
 function mapDefaultOnrampToken(response) {

package/dist/index.mjs

@@ -41,7 +41,7 @@ function generatePrefixedKSUID(prefix) {
 }
 
 // src/lib/client-headers.ts
-var SDK_VERSION = true ? "0.1.80" : "0.0.0-dev";
+var SDK_VERSION = true ? "0.1.82" : "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}`);
   }
@@ -2005,7 +2010,8 @@ function mapOnrampQuote(quote) {
     lowKyc: quote.low_kyc,
     iconUrl: quote.icon_url,
     iconUrls: quote.icon_urls,
-    institutionName: quote.institution_name
+    institutionName: quote.institution_name,
+    estimatedProcessingTime: quote.estimated_processing_time
   };
 }
 function mapDefaultOnrampToken(response) {

package/package.json

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