@unifold/core 0.1.28 → 0.1.29

package/dist/index.d.mts

@@ -385,6 +385,9 @@ interface ProjectConfigResponse {
         networks: PaymentNetwork[];
     };
     blocked_country_codes?: string[];
+    pay_with_exchange?: {
+        enabled: boolean;
+    };
 }
 /**
  * Get project configuration
@@ -496,6 +499,71 @@ interface VerifyAddressResponse {
  * @returns Verification result with valid status and reason if invalid
  */
 declare function verifyRecipientAddress(request: VerifyAddressRequest, publishableKey?: string): Promise<VerifyAddressResponse>;
+interface ExchangeProviderInfo {
+    service_provider: string;
+    service_provider_display_name: string;
+    description: string;
+    icon_url: string;
+    icon_urls: IconUrl[];
+    enabled: boolean;
+    supported_networks: string[];
+    supported_currencies: string[];
+}
+interface ExchangeProvidersResponse {
+    data: ExchangeProviderInfo[];
+}
+interface GetExchangesQuery {
+    country_code?: string;
+    destination_currency?: string;
+    destination_network?: string;
+    source_amount?: string;
+    source_currency?: string;
+}
+/**
+ * Get available exchange providers for "Pay with Exchange"
+ * @param query - Optional filters (destination_currency, destination_network)
+ * @param publishableKey - Optional publishable key, defaults to configured key
+ */
+declare function getExchanges(query?: GetExchangesQuery, publishableKey?: string): Promise<ExchangeProvidersResponse>;
+interface ExchangeWalletAddress {
+    address: string;
+    chain_type: string;
+}
+interface CreateExchangeSessionRequest {
+    service_provider: string;
+    wallet_addresses: ExchangeWalletAddress[];
+    preferred_destination_currency?: string;
+    preferred_destination_network?: string;
+    source_currency?: string;
+    source_amount?: string;
+    external_id?: string;
+}
+interface CreateExchangeSessionResponse {
+    url: string;
+    service_provider: string;
+    external_id: string;
+}
+/**
+ * Create an exchange session for "Pay with Exchange"
+ * @param request - Exchange session request
+ * @param publishableKey - Optional publishable key, defaults to configured key
+ */
+declare function createExchangeSession(request: CreateExchangeSessionRequest, publishableKey?: string): Promise<CreateExchangeSessionResponse>;
+interface ExchangeSessionStartParams {
+    service_provider: string;
+    chain_type: string;
+    address: string;
+    preferred_destination_currency?: string;
+    preferred_destination_network?: string;
+    source_currency?: string;
+    source_amount?: string;
+    external_id?: string;
+}
+/**
+ * Generate a URL for the exchanges/sessions/start endpoint that redirects to the exchange provider.
+ * This avoids popup blockers in Safari by opening the URL directly via anchor tag or window.open().
+ */
+declare function getExchangeSessionStartUrl(request: ExchangeSessionStartParams, publishableKey: string): string;
 interface BuildSolanaTransactionRequest {
     chain_id: string;
     token_address: string;
@@ -633,4 +701,4 @@ declare const i18n: {
 };
 type I18nStrings = typeof i18n;
 
-export { type AddressBalanceResponse, type AddressBalancesResponse, type AddressValidationFailureCode, type AddressValidationMetadata, type AutoSwapRequest, type AutoSwapResponse, type BuildSolanaTransactionRequest, type BuildSolanaTransactionResponse, type ChainType, type CreateDepositAddressRequest, type DefaultTokenChain, type DefaultTokenMetadata, type DefaultTokenResponse, type DepositAddressResponse, ExecutionStatus, type FeaturedToken, type FiatCurrenciesResponse, type FiatCurrency, type I18nStrings, type IconUrl, IneligibilityReason, type IpAddressResponse, type OnrampQuote, type OnrampQuotesRequest, type OnrampQuotesResponse, type OnrampSessionRequest, type OnrampSessionResponse, type PaymentNetwork, type PollExecutionsRequest, type PollExecutionsResponse, type ProjectConfigResponse, type QueryExecutionsRequest, type QueryExecutionsResponse, SOLANA_USDC_ADDRESS, type SendSolanaTransactionRequest, type SendSolanaTransactionResponse, type SupportedChain, type SupportedDepositTokensResponse, type SupportedToken, type TokenBalance, type TokenChain, type TokenChainIconUrl, type TokenChainsResponse, type TokenIconUrl, type TokenInfo, type TokenMetadata, type UserIpInfo, type VerifyAddressRequest, type VerifyAddressResponse, type Wallet, buildSolanaTransaction, createDepositAddress, createOnrampSession, getAddressBalance, getAddressBalances, getApiBaseUrl, getChainName, getDefaultOnrampToken, getFiatCurrencies, getIconUrl, getIconUrlWithCdn, getIpAddress, getOnrampQuotes, getOnrampSessionStartUrl, getPreferredIconUrl, getProjectConfig, getSupportedDepositTokens, getTokenChains, getTokenMetadata, getWalletByChainType, i18n, pollDirectExecutions, queryExecutions, sendSolanaTransaction, setApiConfig, useUserIp, verifyRecipientAddress };
+export { type AddressBalanceResponse, type AddressBalancesResponse, type AddressValidationFailureCode, type AddressValidationMetadata, type AutoSwapRequest, type AutoSwapResponse, type BuildSolanaTransactionRequest, type BuildSolanaTransactionResponse, type ChainType, type CreateDepositAddressRequest, type CreateExchangeSessionRequest, type CreateExchangeSessionResponse, type DefaultTokenChain, type DefaultTokenMetadata, type DefaultTokenResponse, type DepositAddressResponse, type ExchangeProviderInfo, type ExchangeProvidersResponse, type ExchangeSessionStartParams, type ExchangeWalletAddress, ExecutionStatus, type FeaturedToken, type FiatCurrenciesResponse, type FiatCurrency, type GetExchangesQuery, type I18nStrings, type IconUrl, IneligibilityReason, type IpAddressResponse, type OnrampQuote, type OnrampQuotesRequest, type OnrampQuotesResponse, type OnrampSessionRequest, type OnrampSessionResponse, type PaymentNetwork, type PollExecutionsRequest, type PollExecutionsResponse, type ProjectConfigResponse, type QueryExecutionsRequest, type QueryExecutionsResponse, SOLANA_USDC_ADDRESS, type SendSolanaTransactionRequest, type SendSolanaTransactionResponse, type SupportedChain, type SupportedDepositTokensResponse, type SupportedToken, type TokenBalance, type TokenChain, type TokenChainIconUrl, type TokenChainsResponse, type TokenIconUrl, type TokenInfo, type TokenMetadata, type UserIpInfo, type VerifyAddressRequest, type VerifyAddressResponse, type Wallet, buildSolanaTransaction, createDepositAddress, createExchangeSession, createOnrampSession, getAddressBalance, getAddressBalances, getApiBaseUrl, getChainName, getDefaultOnrampToken, getExchangeSessionStartUrl, getExchanges, getFiatCurrencies, getIconUrl, getIconUrlWithCdn, getIpAddress, getOnrampQuotes, getOnrampSessionStartUrl, getPreferredIconUrl, getProjectConfig, getSupportedDepositTokens, getTokenChains, getTokenMetadata, getWalletByChainType, i18n, pollDirectExecutions, queryExecutions, sendSolanaTransaction, setApiConfig, useUserIp, verifyRecipientAddress };

package/dist/index.d.ts

@@ -385,6 +385,9 @@ interface ProjectConfigResponse {
         networks: PaymentNetwork[];
     };
     blocked_country_codes?: string[];
+    pay_with_exchange?: {
+        enabled: boolean;
+    };
 }
 /**
  * Get project configuration
@@ -496,6 +499,71 @@ interface VerifyAddressResponse {
  * @returns Verification result with valid status and reason if invalid
  */
 declare function verifyRecipientAddress(request: VerifyAddressRequest, publishableKey?: string): Promise<VerifyAddressResponse>;
+interface ExchangeProviderInfo {
+    service_provider: string;
+    service_provider_display_name: string;
+    description: string;
+    icon_url: string;
+    icon_urls: IconUrl[];
+    enabled: boolean;
+    supported_networks: string[];
+    supported_currencies: string[];
+}
+interface ExchangeProvidersResponse {
+    data: ExchangeProviderInfo[];
+}
+interface GetExchangesQuery {
+    country_code?: string;
+    destination_currency?: string;
+    destination_network?: string;
+    source_amount?: string;
+    source_currency?: string;
+}
+/**
+ * Get available exchange providers for "Pay with Exchange"
+ * @param query - Optional filters (destination_currency, destination_network)
+ * @param publishableKey - Optional publishable key, defaults to configured key
+ */
+declare function getExchanges(query?: GetExchangesQuery, publishableKey?: string): Promise<ExchangeProvidersResponse>;
+interface ExchangeWalletAddress {
+    address: string;
+    chain_type: string;
+}
+interface CreateExchangeSessionRequest {
+    service_provider: string;
+    wallet_addresses: ExchangeWalletAddress[];
+    preferred_destination_currency?: string;
+    preferred_destination_network?: string;
+    source_currency?: string;
+    source_amount?: string;
+    external_id?: string;
+}
+interface CreateExchangeSessionResponse {
+    url: string;
+    service_provider: string;
+    external_id: string;
+}
+/**
+ * Create an exchange session for "Pay with Exchange"
+ * @param request - Exchange session request
+ * @param publishableKey - Optional publishable key, defaults to configured key
+ */
+declare function createExchangeSession(request: CreateExchangeSessionRequest, publishableKey?: string): Promise<CreateExchangeSessionResponse>;
+interface ExchangeSessionStartParams {
+    service_provider: string;
+    chain_type: string;
+    address: string;
+    preferred_destination_currency?: string;
+    preferred_destination_network?: string;
+    source_currency?: string;
+    source_amount?: string;
+    external_id?: string;
+}
+/**
+ * Generate a URL for the exchanges/sessions/start endpoint that redirects to the exchange provider.
+ * This avoids popup blockers in Safari by opening the URL directly via anchor tag or window.open().
+ */
+declare function getExchangeSessionStartUrl(request: ExchangeSessionStartParams, publishableKey: string): string;
 interface BuildSolanaTransactionRequest {
     chain_id: string;
     token_address: string;
@@ -633,4 +701,4 @@ declare const i18n: {
 };
 type I18nStrings = typeof i18n;
 
-export { type AddressBalanceResponse, type AddressBalancesResponse, type AddressValidationFailureCode, type AddressValidationMetadata, type AutoSwapRequest, type AutoSwapResponse, type BuildSolanaTransactionRequest, type BuildSolanaTransactionResponse, type ChainType, type CreateDepositAddressRequest, type DefaultTokenChain, type DefaultTokenMetadata, type DefaultTokenResponse, type DepositAddressResponse, ExecutionStatus, type FeaturedToken, type FiatCurrenciesResponse, type FiatCurrency, type I18nStrings, type IconUrl, IneligibilityReason, type IpAddressResponse, type OnrampQuote, type OnrampQuotesRequest, type OnrampQuotesResponse, type OnrampSessionRequest, type OnrampSessionResponse, type PaymentNetwork, type PollExecutionsRequest, type PollExecutionsResponse, type ProjectConfigResponse, type QueryExecutionsRequest, type QueryExecutionsResponse, SOLANA_USDC_ADDRESS, type SendSolanaTransactionRequest, type SendSolanaTransactionResponse, type SupportedChain, type SupportedDepositTokensResponse, type SupportedToken, type TokenBalance, type TokenChain, type TokenChainIconUrl, type TokenChainsResponse, type TokenIconUrl, type TokenInfo, type TokenMetadata, type UserIpInfo, type VerifyAddressRequest, type VerifyAddressResponse, type Wallet, buildSolanaTransaction, createDepositAddress, createOnrampSession, getAddressBalance, getAddressBalances, getApiBaseUrl, getChainName, getDefaultOnrampToken, getFiatCurrencies, getIconUrl, getIconUrlWithCdn, getIpAddress, getOnrampQuotes, getOnrampSessionStartUrl, getPreferredIconUrl, getProjectConfig, getSupportedDepositTokens, getTokenChains, getTokenMetadata, getWalletByChainType, i18n, pollDirectExecutions, queryExecutions, sendSolanaTransaction, setApiConfig, useUserIp, verifyRecipientAddress };
+export { type AddressBalanceResponse, type AddressBalancesResponse, type AddressValidationFailureCode, type AddressValidationMetadata, type AutoSwapRequest, type AutoSwapResponse, type BuildSolanaTransactionRequest, type BuildSolanaTransactionResponse, type ChainType, type CreateDepositAddressRequest, type CreateExchangeSessionRequest, type CreateExchangeSessionResponse, type DefaultTokenChain, type DefaultTokenMetadata, type DefaultTokenResponse, type DepositAddressResponse, type ExchangeProviderInfo, type ExchangeProvidersResponse, type ExchangeSessionStartParams, type ExchangeWalletAddress, ExecutionStatus, type FeaturedToken, type FiatCurrenciesResponse, type FiatCurrency, type GetExchangesQuery, type I18nStrings, type IconUrl, IneligibilityReason, type IpAddressResponse, type OnrampQuote, type OnrampQuotesRequest, type OnrampQuotesResponse, type OnrampSessionRequest, type OnrampSessionResponse, type PaymentNetwork, type PollExecutionsRequest, type PollExecutionsResponse, type ProjectConfigResponse, type QueryExecutionsRequest, type QueryExecutionsResponse, SOLANA_USDC_ADDRESS, type SendSolanaTransactionRequest, type SendSolanaTransactionResponse, type SupportedChain, type SupportedDepositTokensResponse, type SupportedToken, type TokenBalance, type TokenChain, type TokenChainIconUrl, type TokenChainsResponse, type TokenIconUrl, type TokenInfo, type TokenMetadata, type UserIpInfo, type VerifyAddressRequest, type VerifyAddressResponse, type Wallet, buildSolanaTransaction, createDepositAddress, createExchangeSession, createOnrampSession, getAddressBalance, getAddressBalances, getApiBaseUrl, getChainName, getDefaultOnrampToken, getExchangeSessionStartUrl, getExchanges, getFiatCurrencies, getIconUrl, getIconUrlWithCdn, getIpAddress, getOnrampQuotes, getOnrampSessionStartUrl, getPreferredIconUrl, getProjectConfig, getSupportedDepositTokens, getTokenChains, getTokenMetadata, getWalletByChainType, i18n, pollDirectExecutions, queryExecutions, sendSolanaTransaction, setApiConfig, useUserIp, verifyRecipientAddress };

package/dist/index.js

@@ -25,12 +25,15 @@ __export(index_exports, {
   SOLANA_USDC_ADDRESS: () => SOLANA_USDC_ADDRESS,
   buildSolanaTransaction: () => buildSolanaTransaction,
   createDepositAddress: () => createDepositAddress,
+  createExchangeSession: () => createExchangeSession,
   createOnrampSession: () => createOnrampSession,
   getAddressBalance: () => getAddressBalance,
   getAddressBalances: () => getAddressBalances,
   getApiBaseUrl: () => getApiBaseUrl,
   getChainName: () => getChainName,
   getDefaultOnrampToken: () => getDefaultOnrampToken,
+  getExchangeSessionStartUrl: () => getExchangeSessionStartUrl,
+  getExchanges: () => getExchanges,
   getFiatCurrencies: () => getFiatCurrencies,
   getIconUrl: () => getIconUrl,
   getIconUrlWithCdn: () => getIconUrlWithCdn,
@@ -468,6 +471,70 @@ async function verifyRecipientAddress(request, publishableKey) {
   }
   return response.json();
 }
+async function getExchanges(query, publishableKey) {
+  const pk = publishableKey || DEFAULT_PUBLISHABLE_KEY;
+  validatePublishableKey(pk);
+  const params = new URLSearchParams();
+  if (query?.destination_currency) params.append("destination_currency", query.destination_currency);
+  if (query?.destination_network) params.append("destination_network", query.destination_network);
+  const queryString = params.toString();
+  const url = `${API_BASE_URL}/v1/public/onramps/exchanges${queryString ? `?${queryString}` : ""}`;
+  const response = await fetch(url, {
+    method: "GET",
+    headers: {
+      accept: "application/json",
+      "x-publishable-key": pk,
+      "Content-Type": "application/json"
+    }
+  });
+  if (!response.ok) {
+    throw new Error(`Failed to fetch exchanges: ${response.statusText}`);
+  }
+  return response.json();
+}
+async function createExchangeSession(request, publishableKey) {
+  const pk = publishableKey || DEFAULT_PUBLISHABLE_KEY;
+  validatePublishableKey(pk);
+  const response = await fetch(
+    `${API_BASE_URL}/v1/public/onramps/exchanges/sessions`,
+    {
+      method: "POST",
+      headers: {
+        accept: "application/json",
+        "x-publishable-key": pk,
+        "Content-Type": "application/json"
+      },
+      body: JSON.stringify(request)
+    }
+  );
+  if (!response.ok) {
+    throw new Error(`Failed to create exchange session: ${response.statusText}`);
+  }
+  return response.json();
+}
+function getExchangeSessionStartUrl(request, publishableKey) {
+  const params = new URLSearchParams();
+  params.append("publishable_key", publishableKey);
+  params.append("service_provider", request.service_provider);
+  params.append("chain_type", request.chain_type);
+  params.append("address", request.address);
+  if (request.preferred_destination_currency) {
+    params.append("preferred_destination_currency", request.preferred_destination_currency);
+  }
+  if (request.preferred_destination_network) {
+    params.append("preferred_destination_network", request.preferred_destination_network);
+  }
+  if (request.source_currency) {
+    params.append("source_currency", request.source_currency);
+  }
+  if (request.source_amount) {
+    params.append("source_amount", request.source_amount);
+  }
+  if (request.external_id) {
+    params.append("external_id", request.external_id);
+  }
+  return `${API_BASE_URL}/v1/public/onramps/exchanges/sessions/start?${params.toString()}`;
+}
 async function buildSolanaTransaction(request, publishableKey) {
   const pk = publishableKey || DEFAULT_PUBLISHABLE_KEY;
   validatePublishableKey(pk);
@@ -619,12 +686,15 @@ var i18n = en_default;
   SOLANA_USDC_ADDRESS,
   buildSolanaTransaction,
   createDepositAddress,
+  createExchangeSession,
   createOnrampSession,
   getAddressBalance,
   getAddressBalances,
   getApiBaseUrl,
   getChainName,
   getDefaultOnrampToken,
+  getExchangeSessionStartUrl,
+  getExchanges,
   getFiatCurrencies,
   getIconUrl,
   getIconUrlWithCdn,

package/dist/index.mjs

@@ -413,6 +413,70 @@ async function verifyRecipientAddress(request, publishableKey) {
   }
   return response.json();
 }
+async function getExchanges(query, publishableKey) {
+  const pk = publishableKey || DEFAULT_PUBLISHABLE_KEY;
+  validatePublishableKey(pk);
+  const params = new URLSearchParams();
+  if (query?.destination_currency) params.append("destination_currency", query.destination_currency);
+  if (query?.destination_network) params.append("destination_network", query.destination_network);
+  const queryString = params.toString();
+  const url = `${API_BASE_URL}/v1/public/onramps/exchanges${queryString ? `?${queryString}` : ""}`;
+  const response = await fetch(url, {
+    method: "GET",
+    headers: {
+      accept: "application/json",
+      "x-publishable-key": pk,
+      "Content-Type": "application/json"
+    }
+  });
+  if (!response.ok) {
+    throw new Error(`Failed to fetch exchanges: ${response.statusText}`);
+  }
+  return response.json();
+}
+async function createExchangeSession(request, publishableKey) {
+  const pk = publishableKey || DEFAULT_PUBLISHABLE_KEY;
+  validatePublishableKey(pk);
+  const response = await fetch(
+    `${API_BASE_URL}/v1/public/onramps/exchanges/sessions`,
+    {
+      method: "POST",
+      headers: {
+        accept: "application/json",
+        "x-publishable-key": pk,
+        "Content-Type": "application/json"
+      },
+      body: JSON.stringify(request)
+    }
+  );
+  if (!response.ok) {
+    throw new Error(`Failed to create exchange session: ${response.statusText}`);
+  }
+  return response.json();
+}
+function getExchangeSessionStartUrl(request, publishableKey) {
+  const params = new URLSearchParams();
+  params.append("publishable_key", publishableKey);
+  params.append("service_provider", request.service_provider);
+  params.append("chain_type", request.chain_type);
+  params.append("address", request.address);
+  if (request.preferred_destination_currency) {
+    params.append("preferred_destination_currency", request.preferred_destination_currency);
+  }
+  if (request.preferred_destination_network) {
+    params.append("preferred_destination_network", request.preferred_destination_network);
+  }
+  if (request.source_currency) {
+    params.append("source_currency", request.source_currency);
+  }
+  if (request.source_amount) {
+    params.append("source_amount", request.source_amount);
+  }
+  if (request.external_id) {
+    params.append("external_id", request.external_id);
+  }
+  return `${API_BASE_URL}/v1/public/onramps/exchanges/sessions/start?${params.toString()}`;
+}
 async function buildSolanaTransaction(request, publishableKey) {
   const pk = publishableKey || DEFAULT_PUBLISHABLE_KEY;
   validatePublishableKey(pk);
@@ -563,12 +627,15 @@ export {
   SOLANA_USDC_ADDRESS,
   buildSolanaTransaction,
   createDepositAddress,
+  createExchangeSession,
   createOnrampSession,
   getAddressBalance,
   getAddressBalances,
   getApiBaseUrl,
   getChainName,
   getDefaultOnrampToken,
+  getExchangeSessionStartUrl,
+  getExchanges,
   getFiatCurrencies,
   getIconUrl,
   getIconUrlWithCdn,

package/package.json

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