@unifold/core 0.1.19 → 0.1.21

package/dist/index.d.mts

@@ -22,7 +22,7 @@ declare function getIconUrl(iconPath: string): string;
 declare function getIconUrlWithCdn(iconPath: string, assetCdnUrl?: string): string;
 interface Wallet {
     id: string;
-    chain_type: "ethereum" | "solana" | "bitcoin";
+    chain_type: "ethereum" | "solana" | "bitcoin" | "algorand";
     address_type: string | null;
     address: string;
     destination_chain_type: string;
@@ -51,7 +51,7 @@ declare function createDepositAddress(overrides?: Partial<CreateDepositAddressRe
 /**
  * Get wallet address for a specific chain type
  */
-declare function getWalletByChainType(wallets: Wallet[], chainType: "ethereum" | "solana" | "bitcoin"): Wallet | undefined;
+declare function getWalletByChainType(wallets: Wallet[], chainType: "ethereum" | "solana" | "bitcoin" | "algorand"): Wallet | undefined;
 interface AutoSwapRequest {
     wallet_id: string;
     origin_currency: string;
@@ -157,91 +157,169 @@ interface SupportedDepositTokensResponse {
  * Get supported deposit tokens
  * @param publishableKey - Optional publishable key, defaults to configured key
  */
-declare function getSupportedDepositTokens(publishableKey?: string): Promise<SupportedDepositTokensResponse>;
-interface MeldQuote {
+declare function getSupportedDepositTokens(publishableKey?: string, options?: {
+    destination_token_address?: string;
+    destination_chain_id?: string;
+    destination_chain_type?: string;
+}): Promise<SupportedDepositTokensResponse>;
+interface TokenMetadata {
+    symbol: string;
+    name: string;
+    icon_url: string;
+    icon_urls: IconUrl[];
+    chain_name: string;
+    chain_type: string;
+    chain_id: string;
+    token_address: string;
+    decimals: number;
+    chain_icon_url: string;
+    chain_icon_urls: IconUrl[];
+}
+interface GetTokenMetadataRequest {
+    chain_type: string;
+    chain_id: string;
+    token_address: string;
+}
+/**
+ * Get token metadata for a specific token
+ * @param request - Token query parameters (chain_type, chain_id, token_address)
+ * @param publishableKey - Optional publishable key, defaults to configured key
+ */
+declare function getTokenMetadata(request: GetTokenMetadataRequest, publishableKey?: string): Promise<TokenMetadata | null>;
+/**
+ * Get the preferred icon URL from an array of icon URLs
+ * @param iconUrls - Array of icon URLs with format information
+ * @param preferredFormat - Preferred format ("svg" or "png"), defaults to "svg"
+ * @returns The URL string for the preferred format, or first available if preferred not found
+ */
+declare function getPreferredIconUrl(iconUrls: IconUrl[] | undefined, preferredFormat?: "svg" | "png"): string | undefined;
+interface FiatCurrency {
+    currency_code: string;
+    name: string;
+    icon_url: string;
+    icon_urls: IconUrl[];
+    country_codes: string[];
+    default_amount: number;
+    minimum_amount: number;
+    maximum_amount: number;
+    suggested_amounts: number[];
+}
+interface FiatCurrenciesResponse {
+    data: FiatCurrency[];
+    preferred: string[];
+}
+/**
+ * Get supported fiat currencies
+ * @param publishableKey - Optional publishable key, defaults to configured key
+ */
+declare function getFiatCurrencies(publishableKey?: string): Promise<FiatCurrenciesResponse>;
+interface OnrampQuote {
     transaction_type: string;
-    payment_method_type: string;
     source_amount: number;
     source_amount_without_fees: number;
     fiat_amount_without_fees: number;
     destination_amount_without_fees: number | null;
-    source_currency_code: string;
+    source_currency: string;
     country_code: string;
     total_fee: number;
     network_fee: number;
     transaction_fee: number;
     destination_amount: number;
-    destination_currency_code: string;
+    destination_currency: string;
+    destination_network: string;
     exchange_rate: number;
+    payment_method_type: string;
     customer_score: number;
     service_provider: string;
     service_provider_display_name: string;
+    icon_url: string;
+    icon_urls: IconUrl[];
     institution_name: string | null;
-    low_kyc: boolean | null;
+    low_kyc: boolean;
     partner_fee: number | null;
-    icon_url: string;
 }
-interface MeldQuotesRequest {
+interface OnrampQuotesRequest {
     country_code: string;
-    destination_currency_code: string;
     source_amount: string;
-    source_currency_code: string;
+    source_currency: string;
+    destination_currency: string;
+    destination_network: string;
+    subdivision_code?: string;
 }
-interface MeldQuotesResponse {
-    data: MeldQuote[];
+interface OnrampQuotesResponse {
+    data: OnrampQuote[];
 }
 /**
- * Get Meld onramp quotes
- * @param request - Meld quotes request
+ * Get unified onramp quotes from all providers
+ * @param request - Onramp quotes request
  * @param publishableKey - Optional publishable key, defaults to configured key
  */
-declare function getMeldQuotes(request: MeldQuotesRequest, publishableKey?: string): Promise<MeldQuotesResponse>;
-interface MeldSessionRequest {
+declare function getOnrampQuotes(request: OnrampQuotesRequest, publishableKey?: string): Promise<OnrampQuotesResponse>;
+interface OnrampSessionRequest {
     service_provider: string;
     country_code: string;
-    destination_currency_code: string;
-    source_currency_code: string;
-    wallet_address: string;
+    source_currency: string;
     source_amount: string;
+    destination_currency: string;
+    destination_network: string;
+    wallet_address: string;
+    subdivision_code?: string;
+    redirect_url?: string;
 }
-interface MeldSessionResponse {
-    id: string;
-    external_session_id: string | null;
-    external_customer_id: string | null;
-    customer_id: string;
-    widget_url: string;
-    service_provider_widget_url: string;
-    token: string;
+interface OnrampSessionResponse {
+    url: string;
+    service_provider: string;
 }
 /**
- * Create a Meld onramp session
- * @param request - Meld session request
+ * Create a unified onramp session
+ * @param request - Onramp session request
  * @param publishableKey - Optional publishable key, defaults to configured key
  */
-declare function createMeldSession(request: MeldSessionRequest, publishableKey?: string): Promise<MeldSessionResponse>;
+declare function createOnrampSession(request: OnrampSessionRequest, publishableKey?: string): Promise<OnrampSessionResponse>;
 /**
- * Get the preferred icon URL from an array of icon URLs
- * @param iconUrls - Array of icon URLs with format information
- * @param preferredFormat - Preferred format ("svg" or "png"), defaults to "svg"
- * @returns The URL string for the preferred format, or first available if preferred not found
+ * Generate a URL for the sessions/start endpoint that redirects to the onramp provider.
+ * This is useful for avoiding popup blockers by opening the URL directly via anchor tag.
+ * @param request - Onramp session request (same parameters as createOnrampSession)
+ * @param publishableKey - Publishable key (required)
+ * @returns URL string that can be used in an anchor tag or window.open()
  */
-declare function getPreferredIconUrl(iconUrls: IconUrl[] | undefined, preferredFormat?: "svg" | "png"): string | undefined;
-interface FiatCurrency {
-    currency_code: string;
-    name: string;
+declare function getOnrampSessionStartUrl(request: OnrampSessionRequest, publishableKey: string): string;
+interface DefaultTokenChain {
+    icon_url: string;
+    icon_urls: IconUrl[];
+    chain_id: string;
+    chain_name: string;
+    chain_type: string;
+}
+interface DefaultTokenMetadata {
     icon_url: string;
-    icon_urls?: IconUrl[];
-    country_codes?: string[];
+    icon_urls: IconUrl[];
+    decimals: number;
+    symbol: string;
+    name: string;
+    token_address: string;
+    chain_id: string;
+    chain_type: string;
+    chain_name: string;
+    chain: DefaultTokenChain;
 }
-interface FiatCurrenciesResponse {
-    data: FiatCurrency[];
-    preferred: string[];
+interface DefaultTokenResponse {
+    destination_network: string;
+    destination_currency: string;
+    destination_token_metadata: DefaultTokenMetadata;
 }
 /**
- * Get supported fiat currencies
+ * Get default onramp token for a given token/chain combination
+ * @param params - Query parameters
  * @param publishableKey - Optional publishable key, defaults to configured key
  */
-declare function getFiatCurrencies(publishableKey?: string): Promise<FiatCurrenciesResponse>;
+declare function getDefaultOnrampToken(params: {
+    country_code?: string;
+    subdivision_code?: string;
+    token_address: string;
+    chain_id: string;
+    chain_type: string;
+}, publishableKey?: string): Promise<DefaultTokenResponse>;
 interface TokenChainIconUrl {
     url: string;
     format: string;
@@ -401,4 +479,4 @@ declare const i18n: {
 };
 type I18nStrings = typeof i18n;
 
-export { type AutoSwapRequest, type AutoSwapResponse, type CreateDepositAddressRequest, type DepositAddressResponse, ExecutionStatus, type FeaturedToken, type FiatCurrenciesResponse, type FiatCurrency, type I18nStrings, type IconUrl, type IpAddressResponse, type MeldQuote, type MeldQuotesRequest, type MeldQuotesResponse, type MeldSessionRequest, type MeldSessionResponse, type PaymentNetwork, type ProjectConfigResponse, type QueryExecutionsRequest, type QueryExecutionsResponse, SOLANA_USDC_ADDRESS, type SupportedChain, type SupportedDepositTokensResponse, type SupportedToken, type TokenChain, type TokenChainIconUrl, type TokenChainsResponse, type UserIpInfo, type Wallet, createDepositAddress, createMeldSession, getApiBaseUrl, getChainName, getFiatCurrencies, getIconUrl, getIconUrlWithCdn, getIpAddress, getMeldQuotes, getPreferredIconUrl, getProjectConfig, getSupportedDepositTokens, getTokenChains, getWalletByChainType, i18n, queryExecutions, setApiConfig, useUserIp };
+export { type AutoSwapRequest, type AutoSwapResponse, type CreateDepositAddressRequest, type DefaultTokenChain, type DefaultTokenMetadata, type DefaultTokenResponse, type DepositAddressResponse, ExecutionStatus, type FeaturedToken, type FiatCurrenciesResponse, type FiatCurrency, type I18nStrings, type IconUrl, type IpAddressResponse, type OnrampQuote, type OnrampQuotesRequest, type OnrampQuotesResponse, type OnrampSessionRequest, type OnrampSessionResponse, type PaymentNetwork, type ProjectConfigResponse, type QueryExecutionsRequest, type QueryExecutionsResponse, SOLANA_USDC_ADDRESS, type SupportedChain, type SupportedDepositTokensResponse, type SupportedToken, type TokenChain, type TokenChainIconUrl, type TokenChainsResponse, type TokenMetadata, type UserIpInfo, type Wallet, createDepositAddress, createOnrampSession, getApiBaseUrl, getChainName, getDefaultOnrampToken, getFiatCurrencies, getIconUrl, getIconUrlWithCdn, getIpAddress, getOnrampQuotes, getOnrampSessionStartUrl, getPreferredIconUrl, getProjectConfig, getSupportedDepositTokens, getTokenChains, getTokenMetadata, getWalletByChainType, i18n, queryExecutions, setApiConfig, useUserIp };

package/dist/index.d.ts

@@ -22,7 +22,7 @@ declare function getIconUrl(iconPath: string): string;
 declare function getIconUrlWithCdn(iconPath: string, assetCdnUrl?: string): string;
 interface Wallet {
     id: string;
-    chain_type: "ethereum" | "solana" | "bitcoin";
+    chain_type: "ethereum" | "solana" | "bitcoin" | "algorand";
     address_type: string | null;
     address: string;
     destination_chain_type: string;
@@ -51,7 +51,7 @@ declare function createDepositAddress(overrides?: Partial<CreateDepositAddressRe
 /**
  * Get wallet address for a specific chain type
  */
-declare function getWalletByChainType(wallets: Wallet[], chainType: "ethereum" | "solana" | "bitcoin"): Wallet | undefined;
+declare function getWalletByChainType(wallets: Wallet[], chainType: "ethereum" | "solana" | "bitcoin" | "algorand"): Wallet | undefined;
 interface AutoSwapRequest {
     wallet_id: string;
     origin_currency: string;
@@ -157,91 +157,169 @@ interface SupportedDepositTokensResponse {
  * Get supported deposit tokens
  * @param publishableKey - Optional publishable key, defaults to configured key
  */
-declare function getSupportedDepositTokens(publishableKey?: string): Promise<SupportedDepositTokensResponse>;
-interface MeldQuote {
+declare function getSupportedDepositTokens(publishableKey?: string, options?: {
+    destination_token_address?: string;
+    destination_chain_id?: string;
+    destination_chain_type?: string;
+}): Promise<SupportedDepositTokensResponse>;
+interface TokenMetadata {
+    symbol: string;
+    name: string;
+    icon_url: string;
+    icon_urls: IconUrl[];
+    chain_name: string;
+    chain_type: string;
+    chain_id: string;
+    token_address: string;
+    decimals: number;
+    chain_icon_url: string;
+    chain_icon_urls: IconUrl[];
+}
+interface GetTokenMetadataRequest {
+    chain_type: string;
+    chain_id: string;
+    token_address: string;
+}
+/**
+ * Get token metadata for a specific token
+ * @param request - Token query parameters (chain_type, chain_id, token_address)
+ * @param publishableKey - Optional publishable key, defaults to configured key
+ */
+declare function getTokenMetadata(request: GetTokenMetadataRequest, publishableKey?: string): Promise<TokenMetadata | null>;
+/**
+ * Get the preferred icon URL from an array of icon URLs
+ * @param iconUrls - Array of icon URLs with format information
+ * @param preferredFormat - Preferred format ("svg" or "png"), defaults to "svg"
+ * @returns The URL string for the preferred format, or first available if preferred not found
+ */
+declare function getPreferredIconUrl(iconUrls: IconUrl[] | undefined, preferredFormat?: "svg" | "png"): string | undefined;
+interface FiatCurrency {
+    currency_code: string;
+    name: string;
+    icon_url: string;
+    icon_urls: IconUrl[];
+    country_codes: string[];
+    default_amount: number;
+    minimum_amount: number;
+    maximum_amount: number;
+    suggested_amounts: number[];
+}
+interface FiatCurrenciesResponse {
+    data: FiatCurrency[];
+    preferred: string[];
+}
+/**
+ * Get supported fiat currencies
+ * @param publishableKey - Optional publishable key, defaults to configured key
+ */
+declare function getFiatCurrencies(publishableKey?: string): Promise<FiatCurrenciesResponse>;
+interface OnrampQuote {
     transaction_type: string;
-    payment_method_type: string;
     source_amount: number;
     source_amount_without_fees: number;
     fiat_amount_without_fees: number;
     destination_amount_without_fees: number | null;
-    source_currency_code: string;
+    source_currency: string;
     country_code: string;
     total_fee: number;
     network_fee: number;
     transaction_fee: number;
     destination_amount: number;
-    destination_currency_code: string;
+    destination_currency: string;
+    destination_network: string;
     exchange_rate: number;
+    payment_method_type: string;
     customer_score: number;
     service_provider: string;
     service_provider_display_name: string;
+    icon_url: string;
+    icon_urls: IconUrl[];
     institution_name: string | null;
-    low_kyc: boolean | null;
+    low_kyc: boolean;
     partner_fee: number | null;
-    icon_url: string;
 }
-interface MeldQuotesRequest {
+interface OnrampQuotesRequest {
     country_code: string;
-    destination_currency_code: string;
     source_amount: string;
-    source_currency_code: string;
+    source_currency: string;
+    destination_currency: string;
+    destination_network: string;
+    subdivision_code?: string;
 }
-interface MeldQuotesResponse {
-    data: MeldQuote[];
+interface OnrampQuotesResponse {
+    data: OnrampQuote[];
 }
 /**
- * Get Meld onramp quotes
- * @param request - Meld quotes request
+ * Get unified onramp quotes from all providers
+ * @param request - Onramp quotes request
  * @param publishableKey - Optional publishable key, defaults to configured key
  */
-declare function getMeldQuotes(request: MeldQuotesRequest, publishableKey?: string): Promise<MeldQuotesResponse>;
-interface MeldSessionRequest {
+declare function getOnrampQuotes(request: OnrampQuotesRequest, publishableKey?: string): Promise<OnrampQuotesResponse>;
+interface OnrampSessionRequest {
     service_provider: string;
     country_code: string;
-    destination_currency_code: string;
-    source_currency_code: string;
-    wallet_address: string;
+    source_currency: string;
     source_amount: string;
+    destination_currency: string;
+    destination_network: string;
+    wallet_address: string;
+    subdivision_code?: string;
+    redirect_url?: string;
 }
-interface MeldSessionResponse {
-    id: string;
-    external_session_id: string | null;
-    external_customer_id: string | null;
-    customer_id: string;
-    widget_url: string;
-    service_provider_widget_url: string;
-    token: string;
+interface OnrampSessionResponse {
+    url: string;
+    service_provider: string;
 }
 /**
- * Create a Meld onramp session
- * @param request - Meld session request
+ * Create a unified onramp session
+ * @param request - Onramp session request
  * @param publishableKey - Optional publishable key, defaults to configured key
  */
-declare function createMeldSession(request: MeldSessionRequest, publishableKey?: string): Promise<MeldSessionResponse>;
+declare function createOnrampSession(request: OnrampSessionRequest, publishableKey?: string): Promise<OnrampSessionResponse>;
 /**
- * Get the preferred icon URL from an array of icon URLs
- * @param iconUrls - Array of icon URLs with format information
- * @param preferredFormat - Preferred format ("svg" or "png"), defaults to "svg"
- * @returns The URL string for the preferred format, or first available if preferred not found
+ * Generate a URL for the sessions/start endpoint that redirects to the onramp provider.
+ * This is useful for avoiding popup blockers by opening the URL directly via anchor tag.
+ * @param request - Onramp session request (same parameters as createOnrampSession)
+ * @param publishableKey - Publishable key (required)
+ * @returns URL string that can be used in an anchor tag or window.open()
  */
-declare function getPreferredIconUrl(iconUrls: IconUrl[] | undefined, preferredFormat?: "svg" | "png"): string | undefined;
-interface FiatCurrency {
-    currency_code: string;
-    name: string;
+declare function getOnrampSessionStartUrl(request: OnrampSessionRequest, publishableKey: string): string;
+interface DefaultTokenChain {
+    icon_url: string;
+    icon_urls: IconUrl[];
+    chain_id: string;
+    chain_name: string;
+    chain_type: string;
+}
+interface DefaultTokenMetadata {
     icon_url: string;
-    icon_urls?: IconUrl[];
-    country_codes?: string[];
+    icon_urls: IconUrl[];
+    decimals: number;
+    symbol: string;
+    name: string;
+    token_address: string;
+    chain_id: string;
+    chain_type: string;
+    chain_name: string;
+    chain: DefaultTokenChain;
 }
-interface FiatCurrenciesResponse {
-    data: FiatCurrency[];
-    preferred: string[];
+interface DefaultTokenResponse {
+    destination_network: string;
+    destination_currency: string;
+    destination_token_metadata: DefaultTokenMetadata;
 }
 /**
- * Get supported fiat currencies
+ * Get default onramp token for a given token/chain combination
+ * @param params - Query parameters
  * @param publishableKey - Optional publishable key, defaults to configured key
  */
-declare function getFiatCurrencies(publishableKey?: string): Promise<FiatCurrenciesResponse>;
+declare function getDefaultOnrampToken(params: {
+    country_code?: string;
+    subdivision_code?: string;
+    token_address: string;
+    chain_id: string;
+    chain_type: string;
+}, publishableKey?: string): Promise<DefaultTokenResponse>;
 interface TokenChainIconUrl {
     url: string;
     format: string;
@@ -401,4 +479,4 @@ declare const i18n: {
 };
 type I18nStrings = typeof i18n;
 
-export { type AutoSwapRequest, type AutoSwapResponse, type CreateDepositAddressRequest, type DepositAddressResponse, ExecutionStatus, type FeaturedToken, type FiatCurrenciesResponse, type FiatCurrency, type I18nStrings, type IconUrl, type IpAddressResponse, type MeldQuote, type MeldQuotesRequest, type MeldQuotesResponse, type MeldSessionRequest, type MeldSessionResponse, type PaymentNetwork, type ProjectConfigResponse, type QueryExecutionsRequest, type QueryExecutionsResponse, SOLANA_USDC_ADDRESS, type SupportedChain, type SupportedDepositTokensResponse, type SupportedToken, type TokenChain, type TokenChainIconUrl, type TokenChainsResponse, type UserIpInfo, type Wallet, createDepositAddress, createMeldSession, getApiBaseUrl, getChainName, getFiatCurrencies, getIconUrl, getIconUrlWithCdn, getIpAddress, getMeldQuotes, getPreferredIconUrl, getProjectConfig, getSupportedDepositTokens, getTokenChains, getWalletByChainType, i18n, queryExecutions, setApiConfig, useUserIp };
+export { type AutoSwapRequest, type AutoSwapResponse, type CreateDepositAddressRequest, type DefaultTokenChain, type DefaultTokenMetadata, type DefaultTokenResponse, type DepositAddressResponse, ExecutionStatus, type FeaturedToken, type FiatCurrenciesResponse, type FiatCurrency, type I18nStrings, type IconUrl, type IpAddressResponse, type OnrampQuote, type OnrampQuotesRequest, type OnrampQuotesResponse, type OnrampSessionRequest, type OnrampSessionResponse, type PaymentNetwork, type ProjectConfigResponse, type QueryExecutionsRequest, type QueryExecutionsResponse, SOLANA_USDC_ADDRESS, type SupportedChain, type SupportedDepositTokensResponse, type SupportedToken, type TokenChain, type TokenChainIconUrl, type TokenChainsResponse, type TokenMetadata, type UserIpInfo, type Wallet, createDepositAddress, createOnrampSession, getApiBaseUrl, getChainName, getDefaultOnrampToken, getFiatCurrencies, getIconUrl, getIconUrlWithCdn, getIpAddress, getOnrampQuotes, getOnrampSessionStartUrl, getPreferredIconUrl, getProjectConfig, getSupportedDepositTokens, getTokenChains, getTokenMetadata, getWalletByChainType, i18n, queryExecutions, setApiConfig, useUserIp };

package/dist/index.js

@@ -23,18 +23,21 @@ __export(index_exports, {
   ExecutionStatus: () => ExecutionStatus,
   SOLANA_USDC_ADDRESS: () => SOLANA_USDC_ADDRESS,
   createDepositAddress: () => createDepositAddress,
-  createMeldSession: () => createMeldSession,
+  createOnrampSession: () => createOnrampSession,
   getApiBaseUrl: () => getApiBaseUrl,
   getChainName: () => getChainName,
+  getDefaultOnrampToken: () => getDefaultOnrampToken,
   getFiatCurrencies: () => getFiatCurrencies,
   getIconUrl: () => getIconUrl,
   getIconUrlWithCdn: () => getIconUrlWithCdn,
   getIpAddress: () => getIpAddress,
-  getMeldQuotes: () => getMeldQuotes,
+  getOnrampQuotes: () => getOnrampQuotes,
+  getOnrampSessionStartUrl: () => getOnrampSessionStartUrl,
   getPreferredIconUrl: () => getPreferredIconUrl,
   getProjectConfig: () => getProjectConfig,
   getSupportedDepositTokens: () => getSupportedDepositTokens,
   getTokenChains: () => getTokenChains,
+  getTokenMetadata: () => getTokenMetadata,
   getWalletByChainType: () => getWalletByChainType,
   i18n: () => i18n,
   queryExecutions: () => queryExecutions,
@@ -158,11 +161,42 @@ async function queryExecutions(externalUserId, publishableKey) {
   }
   return response.json();
 }
-async function getSupportedDepositTokens(publishableKey) {
+async function getSupportedDepositTokens(publishableKey, options) {
   const pk = publishableKey || DEFAULT_PUBLISHABLE_KEY;
   validatePublishableKey(pk);
+  let url = `${API_BASE_URL}/v1/public/tokens/supported_deposit_tokens`;
+  if (options?.destination_token_address && options?.destination_chain_id && options?.destination_chain_type) {
+    const params = new URLSearchParams({
+      destination_token_address: options.destination_token_address,
+      destination_chain_id: options.destination_chain_id,
+      destination_chain_type: options.destination_chain_type
+    });
+    url = `${url}?${params.toString()}`;
+  }
+  const response = await fetch(url, {
+    method: "GET",
+    headers: {
+      accept: "application/json",
+      "x-publishable-key": pk
+    }
+  });
+  if (!response.ok) {
+    throw new Error(
+      `Failed to fetch supported deposit tokens: ${response.statusText}`
+    );
+  }
+  return response.json();
+}
+async function getTokenMetadata(request, publishableKey) {
+  const pk = publishableKey || DEFAULT_PUBLISHABLE_KEY;
+  validatePublishableKey(pk);
+  const params = new URLSearchParams({
+    chainType: request.chain_type,
+    chainId: request.chain_id,
+    tokenAddress: request.token_address
+  });
   const response = await fetch(
-    `${API_BASE_URL}/v1/public/tokens/supported_deposit_tokens`,
+    `${API_BASE_URL}/v1/public/tokens/token?${params.toString()}`,
     {
       method: "GET",
       headers: {
@@ -172,17 +206,43 @@ async function getSupportedDepositTokens(publishableKey) {
     }
   );
   if (!response.ok) {
-    throw new Error(
-      `Failed to fetch supported deposit tokens: ${response.statusText}`
-    );
+    throw new Error(`Failed to fetch token metadata: ${response.statusText}`);
+  }
+  return response.json();
+}
+function getPreferredIconUrl(iconUrls, preferredFormat = "svg") {
+  if (!iconUrls || iconUrls.length === 0) {
+    return void 0;
+  }
+  const preferred = iconUrls.find((icon) => icon.format === preferredFormat);
+  if (preferred) {
+    return preferred.url;
+  }
+  return iconUrls[0]?.url;
+}
+async function getFiatCurrencies(publishableKey) {
+  const pk = publishableKey || DEFAULT_PUBLISHABLE_KEY;
+  validatePublishableKey(pk);
+  const response = await fetch(
+    `${API_BASE_URL}/v1/public/onramps/fiat_currencies`,
+    {
+      method: "GET",
+      headers: {
+        accept: "application/json",
+        "x-publishable-key": pk
+      }
+    }
+  );
+  if (!response.ok) {
+    throw new Error(`Failed to fetch fiat currencies: ${response.statusText}`);
   }
   return response.json();
 }
-async function getMeldQuotes(request, publishableKey) {
+async function getOnrampQuotes(request, publishableKey) {
   const pk = publishableKey || DEFAULT_PUBLISHABLE_KEY;
   validatePublishableKey(pk);
   const response = await fetch(
-    `${API_BASE_URL}/v1/public/onramps/meld/quotes`,
+    `${API_BASE_URL}/v1/public/onramps/quotes`,
     {
       method: "POST",
       headers: {
@@ -194,15 +254,15 @@ async function getMeldQuotes(request, publishableKey) {
     }
   );
   if (!response.ok) {
-    throw new Error(`Failed to fetch Meld quotes: ${response.statusText}`);
+    throw new Error(`Failed to fetch onramp quotes: ${response.statusText}`);
   }
   return response.json();
 }
-async function createMeldSession(request, publishableKey) {
+async function createOnrampSession(request, publishableKey) {
   const pk = publishableKey || DEFAULT_PUBLISHABLE_KEY;
   validatePublishableKey(pk);
   const response = await fetch(
-    `${API_BASE_URL}/v1/public/onramps/meld/sessions`,
+    `${API_BASE_URL}/v1/public/onramps/sessions`,
     {
       method: "POST",
       headers: {
@@ -214,25 +274,36 @@ async function createMeldSession(request, publishableKey) {
     }
   );
   if (!response.ok) {
-    throw new Error(`Failed to create Meld session: ${response.statusText}`);
+    throw new Error(`Failed to create onramp session: ${response.statusText}`);
   }
   return response.json();
 }
-function getPreferredIconUrl(iconUrls, preferredFormat = "svg") {
-  if (!iconUrls || iconUrls.length === 0) {
-    return void 0;
+function getOnrampSessionStartUrl(request, publishableKey) {
+  const params = new URLSearchParams();
+  params.append("publishable_key", publishableKey);
+  params.append("service_provider", request.service_provider);
+  params.append("country_code", request.country_code);
+  params.append("source_currency", request.source_currency);
+  params.append("source_amount", request.source_amount);
+  params.append("destination_currency", request.destination_currency);
+  params.append("destination_network", request.destination_network);
+  params.append("wallet_address", request.wallet_address);
+  if (request.subdivision_code) {
+    params.append("subdivision_code", request.subdivision_code);
   }
-  const preferred = iconUrls.find((icon) => icon.format === preferredFormat);
-  if (preferred) {
-    return preferred.url;
-  }
-  return iconUrls[0]?.url;
+  return `${API_BASE_URL}/v1/public/onramps/sessions/start?${params.toString()}`;
 }
-async function getFiatCurrencies(publishableKey) {
+async function getDefaultOnrampToken(params, publishableKey) {
   const pk = publishableKey || DEFAULT_PUBLISHABLE_KEY;
   validatePublishableKey(pk);
+  const queryParams = new URLSearchParams();
+  if (params.country_code) queryParams.append("country_code", params.country_code);
+  if (params.subdivision_code) queryParams.append("subdivision_code", params.subdivision_code);
+  queryParams.append("token_address", params.token_address);
+  queryParams.append("chain_id", params.chain_id);
+  queryParams.append("chain_type", params.chain_type);
   const response = await fetch(
-    `${API_BASE_URL}/v1/public/onramps/fiat_currencies`,
+    `${API_BASE_URL}/v1/public/onramps/default_token?${queryParams.toString()}`,
     {
       method: "GET",
       headers: {
@@ -242,7 +313,7 @@ async function getFiatCurrencies(publishableKey) {
     }
   );
   if (!response.ok) {
-    throw new Error(`Failed to fetch fiat currencies: ${response.statusText}`);
+    throw new Error(`Failed to fetch default onramp token: ${response.statusText}`);
   }
   return response.json();
 }
@@ -259,6 +330,8 @@ async function getTokenChains() {
   return response.json();
 }
 function getChainName(chains, chainType, chainId) {
+  const target = chains.find((c) => c.chain_id === chainId && c.chain_type === chainType);
+  if (target) return target.chain_name;
   const byId = chains.find((c) => c.chain_id === chainId);
   if (byId) return byId.chain_name;
   const byType = chains.find((c) => c.chain_type === chainType);
@@ -405,18 +478,21 @@ var i18n = en_default;
   ExecutionStatus,
   SOLANA_USDC_ADDRESS,
   createDepositAddress,
-  createMeldSession,
+  createOnrampSession,
   getApiBaseUrl,
   getChainName,
+  getDefaultOnrampToken,
   getFiatCurrencies,
   getIconUrl,
   getIconUrlWithCdn,
   getIpAddress,
-  getMeldQuotes,
+  getOnrampQuotes,
+  getOnrampSessionStartUrl,
   getPreferredIconUrl,
   getProjectConfig,
   getSupportedDepositTokens,
   getTokenChains,
+  getTokenMetadata,
   getWalletByChainType,
   i18n,
   queryExecutions,

package/dist/index.mjs

@@ -113,11 +113,42 @@ async function queryExecutions(externalUserId, publishableKey) {
   }
   return response.json();
 }
-async function getSupportedDepositTokens(publishableKey) {
+async function getSupportedDepositTokens(publishableKey, options) {
   const pk = publishableKey || DEFAULT_PUBLISHABLE_KEY;
   validatePublishableKey(pk);
+  let url = `${API_BASE_URL}/v1/public/tokens/supported_deposit_tokens`;
+  if (options?.destination_token_address && options?.destination_chain_id && options?.destination_chain_type) {
+    const params = new URLSearchParams({
+      destination_token_address: options.destination_token_address,
+      destination_chain_id: options.destination_chain_id,
+      destination_chain_type: options.destination_chain_type
+    });
+    url = `${url}?${params.toString()}`;
+  }
+  const response = await fetch(url, {
+    method: "GET",
+    headers: {
+      accept: "application/json",
+      "x-publishable-key": pk
+    }
+  });
+  if (!response.ok) {
+    throw new Error(
+      `Failed to fetch supported deposit tokens: ${response.statusText}`
+    );
+  }
+  return response.json();
+}
+async function getTokenMetadata(request, publishableKey) {
+  const pk = publishableKey || DEFAULT_PUBLISHABLE_KEY;
+  validatePublishableKey(pk);
+  const params = new URLSearchParams({
+    chainType: request.chain_type,
+    chainId: request.chain_id,
+    tokenAddress: request.token_address
+  });
   const response = await fetch(
-    `${API_BASE_URL}/v1/public/tokens/supported_deposit_tokens`,
+    `${API_BASE_URL}/v1/public/tokens/token?${params.toString()}`,
     {
       method: "GET",
       headers: {
@@ -127,17 +158,43 @@ async function getSupportedDepositTokens(publishableKey) {
     }
   );
   if (!response.ok) {
-    throw new Error(
-      `Failed to fetch supported deposit tokens: ${response.statusText}`
-    );
+    throw new Error(`Failed to fetch token metadata: ${response.statusText}`);
+  }
+  return response.json();
+}
+function getPreferredIconUrl(iconUrls, preferredFormat = "svg") {
+  if (!iconUrls || iconUrls.length === 0) {
+    return void 0;
+  }
+  const preferred = iconUrls.find((icon) => icon.format === preferredFormat);
+  if (preferred) {
+    return preferred.url;
+  }
+  return iconUrls[0]?.url;
+}
+async function getFiatCurrencies(publishableKey) {
+  const pk = publishableKey || DEFAULT_PUBLISHABLE_KEY;
+  validatePublishableKey(pk);
+  const response = await fetch(
+    `${API_BASE_URL}/v1/public/onramps/fiat_currencies`,
+    {
+      method: "GET",
+      headers: {
+        accept: "application/json",
+        "x-publishable-key": pk
+      }
+    }
+  );
+  if (!response.ok) {
+    throw new Error(`Failed to fetch fiat currencies: ${response.statusText}`);
   }
   return response.json();
 }
-async function getMeldQuotes(request, publishableKey) {
+async function getOnrampQuotes(request, publishableKey) {
   const pk = publishableKey || DEFAULT_PUBLISHABLE_KEY;
   validatePublishableKey(pk);
   const response = await fetch(
-    `${API_BASE_URL}/v1/public/onramps/meld/quotes`,
+    `${API_BASE_URL}/v1/public/onramps/quotes`,
     {
       method: "POST",
       headers: {
@@ -149,15 +206,15 @@ async function getMeldQuotes(request, publishableKey) {
     }
   );
   if (!response.ok) {
-    throw new Error(`Failed to fetch Meld quotes: ${response.statusText}`);
+    throw new Error(`Failed to fetch onramp quotes: ${response.statusText}`);
   }
   return response.json();
 }
-async function createMeldSession(request, publishableKey) {
+async function createOnrampSession(request, publishableKey) {
   const pk = publishableKey || DEFAULT_PUBLISHABLE_KEY;
   validatePublishableKey(pk);
   const response = await fetch(
-    `${API_BASE_URL}/v1/public/onramps/meld/sessions`,
+    `${API_BASE_URL}/v1/public/onramps/sessions`,
     {
       method: "POST",
       headers: {
@@ -169,25 +226,36 @@ async function createMeldSession(request, publishableKey) {
     }
   );
   if (!response.ok) {
-    throw new Error(`Failed to create Meld session: ${response.statusText}`);
+    throw new Error(`Failed to create onramp session: ${response.statusText}`);
   }
   return response.json();
 }
-function getPreferredIconUrl(iconUrls, preferredFormat = "svg") {
-  if (!iconUrls || iconUrls.length === 0) {
-    return void 0;
+function getOnrampSessionStartUrl(request, publishableKey) {
+  const params = new URLSearchParams();
+  params.append("publishable_key", publishableKey);
+  params.append("service_provider", request.service_provider);
+  params.append("country_code", request.country_code);
+  params.append("source_currency", request.source_currency);
+  params.append("source_amount", request.source_amount);
+  params.append("destination_currency", request.destination_currency);
+  params.append("destination_network", request.destination_network);
+  params.append("wallet_address", request.wallet_address);
+  if (request.subdivision_code) {
+    params.append("subdivision_code", request.subdivision_code);
   }
-  const preferred = iconUrls.find((icon) => icon.format === preferredFormat);
-  if (preferred) {
-    return preferred.url;
-  }
-  return iconUrls[0]?.url;
+  return `${API_BASE_URL}/v1/public/onramps/sessions/start?${params.toString()}`;
 }
-async function getFiatCurrencies(publishableKey) {
+async function getDefaultOnrampToken(params, publishableKey) {
   const pk = publishableKey || DEFAULT_PUBLISHABLE_KEY;
   validatePublishableKey(pk);
+  const queryParams = new URLSearchParams();
+  if (params.country_code) queryParams.append("country_code", params.country_code);
+  if (params.subdivision_code) queryParams.append("subdivision_code", params.subdivision_code);
+  queryParams.append("token_address", params.token_address);
+  queryParams.append("chain_id", params.chain_id);
+  queryParams.append("chain_type", params.chain_type);
   const response = await fetch(
-    `${API_BASE_URL}/v1/public/onramps/fiat_currencies`,
+    `${API_BASE_URL}/v1/public/onramps/default_token?${queryParams.toString()}`,
     {
       method: "GET",
       headers: {
@@ -197,7 +265,7 @@ async function getFiatCurrencies(publishableKey) {
     }
   );
   if (!response.ok) {
-    throw new Error(`Failed to fetch fiat currencies: ${response.statusText}`);
+    throw new Error(`Failed to fetch default onramp token: ${response.statusText}`);
   }
   return response.json();
 }
@@ -214,6 +282,8 @@ async function getTokenChains() {
   return response.json();
 }
 function getChainName(chains, chainType, chainId) {
+  const target = chains.find((c) => c.chain_id === chainId && c.chain_type === chainType);
+  if (target) return target.chain_name;
   const byId = chains.find((c) => c.chain_id === chainId);
   if (byId) return byId.chain_name;
   const byType = chains.find((c) => c.chain_type === chainType);
@@ -359,18 +429,21 @@ export {
   ExecutionStatus,
   SOLANA_USDC_ADDRESS,
   createDepositAddress,
-  createMeldSession,
+  createOnrampSession,
   getApiBaseUrl,
   getChainName,
+  getDefaultOnrampToken,
   getFiatCurrencies,
   getIconUrl,
   getIconUrlWithCdn,
   getIpAddress,
-  getMeldQuotes,
+  getOnrampQuotes,
+  getOnrampSessionStartUrl,
   getPreferredIconUrl,
   getProjectConfig,
   getSupportedDepositTokens,
   getTokenChains,
+  getTokenMetadata,
   getWalletByChainType,
   i18n,
   queryExecutions,

package/package.json

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