@unifold/core 0.1.52 → 0.1.54

package/dist/index.d.mts

@@ -76,6 +76,7 @@ interface IconUrl {
     url: string;
     format: "svg" | "png";
 }
+type ProductType = "deposit" | "payment";
 interface AutoSwapResponse {
     id: string;
     project_id: string;
@@ -157,6 +158,7 @@ interface SupportedChain {
     chain_type: string;
     icon_url: string;
     token_address: string;
+    decimals: number;
     estimated_price_impact_percent: number;
     max_slippage_percent: number;
     estimated_processing_time: number | null;
@@ -184,13 +186,17 @@ interface SupportedDestinationTokensResponse {
 /**
  * Get supported destination tokens (used for withdraw flow)
  * @param publishableKey - Optional publishable key, defaults to configured key
+ * @param options - Optional query parameters
  */
-declare function getSupportedDestinationTokens(publishableKey?: string): Promise<SupportedDestinationTokensResponse>;
+declare function getSupportedDestinationTokens(publishableKey?: string, options?: {
+    product_type?: ProductType;
+}): Promise<SupportedDestinationTokensResponse>;
 interface SupportedToken {
     symbol: string;
     name: string;
     icon_url: string;
     is_newly_added: boolean;
+    is_stablecoin: boolean;
     chains: SupportedChain[];
 }
 interface SupportedDepositTokensResponse {
@@ -204,6 +210,7 @@ declare function getSupportedDepositTokens(publishableKey?: string, options?: {
     destination_token_address?: string;
     destination_chain_id?: string;
     destination_chain_type?: string;
+    product_type?: ProductType;
 }): Promise<SupportedDepositTokensResponse>;
 interface TokenMetadata {
     symbol: string;
@@ -242,7 +249,7 @@ interface FiatCurrency {
     icon_url: string;
     icon_urls: IconUrl[];
     country_codes: string[];
-    default_amount: number;
+    default_amount: number | null;
     minimum_amount: number;
     maximum_amount: number;
     suggested_amounts: number[];
@@ -406,12 +413,20 @@ interface BlockedCountrySubdivision {
     country_code: string;
     subdivision_codes: string[];
 }
+interface FeaturedWallet {
+    name: string;
+    position: number;
+    icon_urls: IconUrl[];
+}
 interface ProjectConfigResponse {
     project_name?: string;
     asset_cdn_url: string;
     transfer_crypto: {
         networks: FeaturedToken[];
     };
+    connect_wallet: {
+        wallets: FeaturedWallet[];
+    };
     payment_networks: {
         networks: PaymentNetwork[];
     };
@@ -752,6 +767,8 @@ interface PaymentIntent {
     description: string | null;
     livemode: boolean;
     settlement_tolerance_percent: number;
+    /** When true, stablecoin deposits are credited at par (1:1) regardless of swap slippage. */
+    stablecoin_parity: boolean;
     canceled_at: string | null;
     cancellation_reason: string | null;
     expires_at: string | null;
@@ -882,6 +899,16 @@ interface DepositQuoteRequest {
     destination_chain_type: string;
     destination_chain_id: string;
     destination_token_address: string;
+    /**
+     * When true, the source amount is inflated by the expected slippage to
+     * reduce stuck payments. Typically set by the checkout flow.
+     */
+    adjust_for_slippage?: boolean;
+    /**
+     * When true and both tokens are stablecoins, returns a 1:1 quote
+     * without calling the swap provider. Ignored if source is not a stablecoin.
+     */
+    stablecoin_parity?: boolean;
 }
 interface DepositQuote {
     /**
@@ -901,6 +928,17 @@ interface DepositQuote {
     destination_token_symbol: string;
     estimated_price_impact_percent: number | null;
     estimated_fees_usd: string | null;
+    /**
+     * The slippage buffer percentage applied to the source amount.
+     * Present when `adjust_for_slippage` was true; null otherwise.
+     */
+    slippage_buffer_percent: number | null;
+    /**
+     * Expected slippage for this route (from Relay or token config).
+     * Always present when slippage data is available, regardless of
+     * `adjust_for_slippage`.
+     */
+    expected_slippage_percent: number | null;
 }
 /**
  * Get a deposit quote: how much source token is needed to receive a
@@ -942,8 +980,53 @@ declare function buildHypercoreTransaction(request: BuildHypercoreTransactionReq
  * Pass the action + nonce from buildHypercoreTransaction and
  * the signature from eth_signTypedData_v4.
  */
+interface CashAppSessionRequest {
+    external_user_id: string;
+    destination_chain_type: string;
+    destination_chain_id: string;
+    destination_token_address: string;
+    recipient_address: string;
+    source_amount: string;
+    external_id?: string;
+}
+interface CashAppSessionResponse {
+    id: string;
+    external_id: string;
+    url: string;
+    status: string;
+    destination_amount: string;
+    expires_at: string;
+}
+interface CashAppSessionStatusResponse {
+    status: string;
+    updated_at?: string;
+}
+interface CashAppLimits {
+    minimum_amount: number;
+    maximum_amount: number | null;
+    currency: string;
+}
+declare function getCashAppLimits(currency?: string, publishableKey?: string): Promise<CashAppLimits>;
+declare function createCashAppSession(request: CashAppSessionRequest, publishableKey?: string): Promise<CashAppSessionResponse>;
+declare function getCashAppSessionStatus(externalId: string, publishableKey?: string): Promise<CashAppSessionStatusResponse>;
 declare function sendHypercoreTransaction(request: SendHypercoreTransactionRequest, publishableKey?: string): Promise<SendHypercoreTransactionResponse>;
 
+/**
+ * Format a stablecoin amount to 2 decimal places, ceiling any fractional
+ * value beyond the 2nd decimal. This ensures the displayed amount is always
+ * >= the real amount, so the user never underpays.
+ *
+ * @param baseUnits - Amount in base units (e.g. "5123456")
+ * @param decimals  - Token decimals (e.g. 6 for USDC)
+ * @returns Formatted string with exactly 2 decimal places (e.g. "5.13")
+ *
+ * @example
+ * formatStablecoinAmount("5123456", 6)  // "5.13"  (5.123456 → ceil)
+ * formatStablecoinAmount("5120000", 6)  // "5.12"  (exact, no rounding)
+ * formatStablecoinAmount("3450050", 6)  // "3.46"  (3.450050 → ceil)
+ * formatStablecoinAmount("10000000", 6) // "10.00" (whole number)
+ */
+declare function formatStablecoinAmount(baseUnits: string, decimals: number): string;
 /**
  * Generate a KSUID-like prefixed ID without external dependencies.
  * Format: `{prefix}_{base62(4-byte-timestamp + 16-random-bytes)}` (27 chars after prefix).
@@ -1106,4 +1189,4 @@ declare const i18n: {
 };
 type I18nStrings = typeof i18n;
 
-export { ActionType, type AddressBalanceResponse, type AddressBalancesResponse, type AddressValidationFailureCode, type AddressValidationMetadata, type AutoSwapRequest, type AutoSwapResponse, type BlockedCountrySubdivision, type BuildHypercoreTransactionRequest, type BuildHypercoreTransactionResponse, type BuildSolanaTransactionRequest, type BuildSolanaTransactionResponse, type ChainType, type CreateDepositAddressRequest, type CreateExchangeSessionRequest, type CreateExchangeSessionResponse, type DefaultTokenChain, type DefaultTokenMetadata, type DefaultTokenResponse, type DepositAddressResponse, type DepositEvent, DepositEventType, type DepositQuote, type DepositQuoteRequest, type DestinationToken, type DestinationTokenChain, type ExchangeProviderInfo, type ExchangeProvidersResponse, type ExchangeSessionStartParams, type ExchangeWalletAddress, ExecutionStatus, type FeaturedToken, type FiatCurrenciesResponse, type FiatCurrency, type GetExchangesQuery, type HypercoreActionType, type HypercoreActivationRequest, type HypercoreActivationResponse, type I18nStrings, type IconUrl, IneligibilityReason, 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 ProjectConfigResponse, type QueryExecutionsRequest, type QueryExecutionsResponse, SOLANA_USDC_ADDRESS, type SendHypercoreTransactionRequest, type SendHypercoreTransactionResponse, type SendSolanaTransactionRequest, type SendSolanaTransactionResponse, type SourceToken, type SourceTokenNetwork, 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 UserIpInfo, type VerifyAddressRequest, type VerifyAddressResponse, type Wallet, buildHypercoreTransaction, buildSolanaTransaction, checkHypercoreActivation, createDepositAddress, createExchangeSession, createOnrampSession, generatePrefixedKSUID, getAddressBalance, getAddressBalances, getApiBaseUrl, getChainName, getDefaultOnrampToken, getDepositQuote, getExchangeSessionStartUrl, getExchanges, getFiatCurrencies, getIconUrl, getIconUrlWithCdn, getIpAddress, getOnrampQuotes, getOnrampSessionStartUrl, getPreferredIconUrl, getProjectConfig, getSupportedDepositTokens, getSupportedDestinationTokens, getTokenChains, getTokenMetadata, getWalletByChainType, i18n, listPaymentIntentExecutions, pollDirectExecutions, queryExecutions, retrievePaymentIntent, sendHypercoreTransaction, sendSolanaTransaction, setApiConfig, useUserIp, verifyRecipientAddress };
+export { ActionType, type AddressBalanceResponse, type AddressBalancesResponse, type AddressValidationFailureCode, type AddressValidationMetadata, 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 CreateDepositAddressRequest, type CreateExchangeSessionRequest, type CreateExchangeSessionResponse, type DefaultTokenChain, type DefaultTokenMetadata, type DefaultTokenResponse, type DepositAddressResponse, type DepositEvent, DepositEventType, type DepositQuote, type DepositQuoteRequest, type DestinationToken, type DestinationTokenChain, 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 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, SOLANA_USDC_ADDRESS, type SendHypercoreTransactionRequest, type SendHypercoreTransactionResponse, type SendSolanaTransactionRequest, type SendSolanaTransactionResponse, type SourceToken, type SourceTokenNetwork, 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 UserIpInfo, type VerifyAddressRequest, type VerifyAddressResponse, type Wallet, buildHypercoreTransaction, buildSolanaTransaction, checkHypercoreActivation, createCashAppSession, createDepositAddress, createExchangeSession, createOnrampSession, formatStablecoinAmount, generatePrefixedKSUID, getAddressBalance, getAddressBalances, getApiBaseUrl, getCashAppLimits, getCashAppSessionStatus, getChainName, getDefaultOnrampToken, getDepositQuote, getExchangeSessionStartUrl, getExchanges, getFiatCurrencies, getIconUrl, getIconUrlWithCdn, getIpAddress, getOnrampQuotes, getOnrampSessionStartUrl, getPreferredIconUrl, getProjectConfig, getSupportedDepositTokens, getSupportedDestinationTokens, getTokenChains, getTokenMetadata, getWalletByChainType, i18n, listPaymentIntentExecutions, pollDirectExecutions, queryExecutions, retrievePaymentIntent, sendHypercoreTransaction, sendSolanaTransaction, setApiConfig, useUserIp, verifyRecipientAddress };

package/dist/index.d.ts

@@ -76,6 +76,7 @@ interface IconUrl {
     url: string;
     format: "svg" | "png";
 }
+type ProductType = "deposit" | "payment";
 interface AutoSwapResponse {
     id: string;
     project_id: string;
@@ -157,6 +158,7 @@ interface SupportedChain {
     chain_type: string;
     icon_url: string;
     token_address: string;
+    decimals: number;
     estimated_price_impact_percent: number;
     max_slippage_percent: number;
     estimated_processing_time: number | null;
@@ -184,13 +186,17 @@ interface SupportedDestinationTokensResponse {
 /**
  * Get supported destination tokens (used for withdraw flow)
  * @param publishableKey - Optional publishable key, defaults to configured key
+ * @param options - Optional query parameters
  */
-declare function getSupportedDestinationTokens(publishableKey?: string): Promise<SupportedDestinationTokensResponse>;
+declare function getSupportedDestinationTokens(publishableKey?: string, options?: {
+    product_type?: ProductType;
+}): Promise<SupportedDestinationTokensResponse>;
 interface SupportedToken {
     symbol: string;
     name: string;
     icon_url: string;
     is_newly_added: boolean;
+    is_stablecoin: boolean;
     chains: SupportedChain[];
 }
 interface SupportedDepositTokensResponse {
@@ -204,6 +210,7 @@ declare function getSupportedDepositTokens(publishableKey?: string, options?: {
     destination_token_address?: string;
     destination_chain_id?: string;
     destination_chain_type?: string;
+    product_type?: ProductType;
 }): Promise<SupportedDepositTokensResponse>;
 interface TokenMetadata {
     symbol: string;
@@ -242,7 +249,7 @@ interface FiatCurrency {
     icon_url: string;
     icon_urls: IconUrl[];
     country_codes: string[];
-    default_amount: number;
+    default_amount: number | null;
     minimum_amount: number;
     maximum_amount: number;
     suggested_amounts: number[];
@@ -406,12 +413,20 @@ interface BlockedCountrySubdivision {
     country_code: string;
     subdivision_codes: string[];
 }
+interface FeaturedWallet {
+    name: string;
+    position: number;
+    icon_urls: IconUrl[];
+}
 interface ProjectConfigResponse {
     project_name?: string;
     asset_cdn_url: string;
     transfer_crypto: {
         networks: FeaturedToken[];
     };
+    connect_wallet: {
+        wallets: FeaturedWallet[];
+    };
     payment_networks: {
         networks: PaymentNetwork[];
     };
@@ -752,6 +767,8 @@ interface PaymentIntent {
     description: string | null;
     livemode: boolean;
     settlement_tolerance_percent: number;
+    /** When true, stablecoin deposits are credited at par (1:1) regardless of swap slippage. */
+    stablecoin_parity: boolean;
     canceled_at: string | null;
     cancellation_reason: string | null;
     expires_at: string | null;
@@ -882,6 +899,16 @@ interface DepositQuoteRequest {
     destination_chain_type: string;
     destination_chain_id: string;
     destination_token_address: string;
+    /**
+     * When true, the source amount is inflated by the expected slippage to
+     * reduce stuck payments. Typically set by the checkout flow.
+     */
+    adjust_for_slippage?: boolean;
+    /**
+     * When true and both tokens are stablecoins, returns a 1:1 quote
+     * without calling the swap provider. Ignored if source is not a stablecoin.
+     */
+    stablecoin_parity?: boolean;
 }
 interface DepositQuote {
     /**
@@ -901,6 +928,17 @@ interface DepositQuote {
     destination_token_symbol: string;
     estimated_price_impact_percent: number | null;
     estimated_fees_usd: string | null;
+    /**
+     * The slippage buffer percentage applied to the source amount.
+     * Present when `adjust_for_slippage` was true; null otherwise.
+     */
+    slippage_buffer_percent: number | null;
+    /**
+     * Expected slippage for this route (from Relay or token config).
+     * Always present when slippage data is available, regardless of
+     * `adjust_for_slippage`.
+     */
+    expected_slippage_percent: number | null;
 }
 /**
  * Get a deposit quote: how much source token is needed to receive a
@@ -942,8 +980,53 @@ declare function buildHypercoreTransaction(request: BuildHypercoreTransactionReq
  * Pass the action + nonce from buildHypercoreTransaction and
  * the signature from eth_signTypedData_v4.
  */
+interface CashAppSessionRequest {
+    external_user_id: string;
+    destination_chain_type: string;
+    destination_chain_id: string;
+    destination_token_address: string;
+    recipient_address: string;
+    source_amount: string;
+    external_id?: string;
+}
+interface CashAppSessionResponse {
+    id: string;
+    external_id: string;
+    url: string;
+    status: string;
+    destination_amount: string;
+    expires_at: string;
+}
+interface CashAppSessionStatusResponse {
+    status: string;
+    updated_at?: string;
+}
+interface CashAppLimits {
+    minimum_amount: number;
+    maximum_amount: number | null;
+    currency: string;
+}
+declare function getCashAppLimits(currency?: string, publishableKey?: string): Promise<CashAppLimits>;
+declare function createCashAppSession(request: CashAppSessionRequest, publishableKey?: string): Promise<CashAppSessionResponse>;
+declare function getCashAppSessionStatus(externalId: string, publishableKey?: string): Promise<CashAppSessionStatusResponse>;
 declare function sendHypercoreTransaction(request: SendHypercoreTransactionRequest, publishableKey?: string): Promise<SendHypercoreTransactionResponse>;
 
+/**
+ * Format a stablecoin amount to 2 decimal places, ceiling any fractional
+ * value beyond the 2nd decimal. This ensures the displayed amount is always
+ * >= the real amount, so the user never underpays.
+ *
+ * @param baseUnits - Amount in base units (e.g. "5123456")
+ * @param decimals  - Token decimals (e.g. 6 for USDC)
+ * @returns Formatted string with exactly 2 decimal places (e.g. "5.13")
+ *
+ * @example
+ * formatStablecoinAmount("5123456", 6)  // "5.13"  (5.123456 → ceil)
+ * formatStablecoinAmount("5120000", 6)  // "5.12"  (exact, no rounding)
+ * formatStablecoinAmount("3450050", 6)  // "3.46"  (3.450050 → ceil)
+ * formatStablecoinAmount("10000000", 6) // "10.00" (whole number)
+ */
+declare function formatStablecoinAmount(baseUnits: string, decimals: number): string;
 /**
  * Generate a KSUID-like prefixed ID without external dependencies.
  * Format: `{prefix}_{base62(4-byte-timestamp + 16-random-bytes)}` (27 chars after prefix).
@@ -1106,4 +1189,4 @@ declare const i18n: {
 };
 type I18nStrings = typeof i18n;
 
-export { ActionType, type AddressBalanceResponse, type AddressBalancesResponse, type AddressValidationFailureCode, type AddressValidationMetadata, type AutoSwapRequest, type AutoSwapResponse, type BlockedCountrySubdivision, type BuildHypercoreTransactionRequest, type BuildHypercoreTransactionResponse, type BuildSolanaTransactionRequest, type BuildSolanaTransactionResponse, type ChainType, type CreateDepositAddressRequest, type CreateExchangeSessionRequest, type CreateExchangeSessionResponse, type DefaultTokenChain, type DefaultTokenMetadata, type DefaultTokenResponse, type DepositAddressResponse, type DepositEvent, DepositEventType, type DepositQuote, type DepositQuoteRequest, type DestinationToken, type DestinationTokenChain, type ExchangeProviderInfo, type ExchangeProvidersResponse, type ExchangeSessionStartParams, type ExchangeWalletAddress, ExecutionStatus, type FeaturedToken, type FiatCurrenciesResponse, type FiatCurrency, type GetExchangesQuery, type HypercoreActionType, type HypercoreActivationRequest, type HypercoreActivationResponse, type I18nStrings, type IconUrl, IneligibilityReason, 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 ProjectConfigResponse, type QueryExecutionsRequest, type QueryExecutionsResponse, SOLANA_USDC_ADDRESS, type SendHypercoreTransactionRequest, type SendHypercoreTransactionResponse, type SendSolanaTransactionRequest, type SendSolanaTransactionResponse, type SourceToken, type SourceTokenNetwork, 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 UserIpInfo, type VerifyAddressRequest, type VerifyAddressResponse, type Wallet, buildHypercoreTransaction, buildSolanaTransaction, checkHypercoreActivation, createDepositAddress, createExchangeSession, createOnrampSession, generatePrefixedKSUID, getAddressBalance, getAddressBalances, getApiBaseUrl, getChainName, getDefaultOnrampToken, getDepositQuote, getExchangeSessionStartUrl, getExchanges, getFiatCurrencies, getIconUrl, getIconUrlWithCdn, getIpAddress, getOnrampQuotes, getOnrampSessionStartUrl, getPreferredIconUrl, getProjectConfig, getSupportedDepositTokens, getSupportedDestinationTokens, getTokenChains, getTokenMetadata, getWalletByChainType, i18n, listPaymentIntentExecutions, pollDirectExecutions, queryExecutions, retrievePaymentIntent, sendHypercoreTransaction, sendSolanaTransaction, setApiConfig, useUserIp, verifyRecipientAddress };
+export { ActionType, type AddressBalanceResponse, type AddressBalancesResponse, type AddressValidationFailureCode, type AddressValidationMetadata, 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 CreateDepositAddressRequest, type CreateExchangeSessionRequest, type CreateExchangeSessionResponse, type DefaultTokenChain, type DefaultTokenMetadata, type DefaultTokenResponse, type DepositAddressResponse, type DepositEvent, DepositEventType, type DepositQuote, type DepositQuoteRequest, type DestinationToken, type DestinationTokenChain, 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 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, SOLANA_USDC_ADDRESS, type SendHypercoreTransactionRequest, type SendHypercoreTransactionResponse, type SendSolanaTransactionRequest, type SendSolanaTransactionResponse, type SourceToken, type SourceTokenNetwork, 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 UserIpInfo, type VerifyAddressRequest, type VerifyAddressResponse, type Wallet, buildHypercoreTransaction, buildSolanaTransaction, checkHypercoreActivation, createCashAppSession, createDepositAddress, createExchangeSession, createOnrampSession, formatStablecoinAmount, generatePrefixedKSUID, getAddressBalance, getAddressBalances, getApiBaseUrl, getCashAppLimits, getCashAppSessionStatus, getChainName, getDefaultOnrampToken, getDepositQuote, getExchangeSessionStartUrl, getExchanges, getFiatCurrencies, getIconUrl, getIconUrlWithCdn, getIpAddress, getOnrampQuotes, getOnrampSessionStartUrl, getPreferredIconUrl, getProjectConfig, getSupportedDepositTokens, getSupportedDestinationTokens, getTokenChains, getTokenMetadata, getWalletByChainType, i18n, listPaymentIntentExecutions, pollDirectExecutions, queryExecutions, retrievePaymentIntent, sendHypercoreTransaction, sendSolanaTransaction, setApiConfig, useUserIp, verifyRecipientAddress };

package/dist/index.js

@@ -28,13 +28,17 @@ __export(index_exports, {
   buildHypercoreTransaction: () => buildHypercoreTransaction,
   buildSolanaTransaction: () => buildSolanaTransaction,
   checkHypercoreActivation: () => checkHypercoreActivation,
+  createCashAppSession: () => createCashAppSession,
   createDepositAddress: () => createDepositAddress,
   createExchangeSession: () => createExchangeSession,
   createOnrampSession: () => createOnrampSession,
+  formatStablecoinAmount: () => formatStablecoinAmount,
   generatePrefixedKSUID: () => generatePrefixedKSUID,
   getAddressBalance: () => getAddressBalance,
   getAddressBalances: () => getAddressBalances,
   getApiBaseUrl: () => getApiBaseUrl,
+  getCashAppLimits: () => getCashAppLimits,
+  getCashAppSessionStatus: () => getCashAppSessionStatus,
   getChainName: () => getChainName,
   getDefaultOnrampToken: () => getDefaultOnrampToken,
   getDepositQuote: () => getDepositQuote,
@@ -210,19 +214,25 @@ async function pollDirectExecutions(request, publishableKey) {
   }
   return response.json();
 }
-async function getSupportedDestinationTokens(publishableKey) {
+async function getSupportedDestinationTokens(publishableKey, options) {
   const pk = publishableKey || DEFAULT_PUBLISHABLE_KEY;
   validatePublishableKey(pk);
-  const response = await fetch(
-    `${API_BASE_URL}/v1/public/tokens/supported_destination_tokens`,
-    {
-      method: "GET",
-      headers: {
-        accept: "application/json",
-        "x-publishable-key": pk
-      }
+  let url = `${API_BASE_URL}/v1/public/tokens/supported_destination_tokens`;
+  const params = new URLSearchParams();
+  if (options?.product_type) {
+    params.set("product_type", options.product_type);
+  }
+  const qs = params.toString();
+  if (qs) {
+    url = `${url}?${qs}`;
+  }
+  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 destination tokens: ${response.statusText}`
@@ -234,13 +244,18 @@ async function getSupportedDepositTokens(publishableKey, options) {
   const pk = publishableKey || DEFAULT_PUBLISHABLE_KEY;
   validatePublishableKey(pk);
   let url = `${API_BASE_URL}/v1/public/tokens/supported_deposit_tokens`;
+  const params = new URLSearchParams();
   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()}`;
+    params.set("destination_token_address", options.destination_token_address);
+    params.set("destination_chain_id", options.destination_chain_id);
+    params.set("destination_chain_type", options.destination_chain_type);
+  }
+  if (options?.product_type) {
+    params.set("product_type", options.product_type);
+  }
+  const qs = params.toString();
+  if (qs) {
+    url = `${url}?${qs}`;
   }
   const response = await fetch(url, {
     method: "GET",
@@ -732,6 +747,71 @@ async function buildHypercoreTransaction(request, publishableKey) {
   }
   return response.json();
 }
+async function getCashAppLimits(currency = "usd", publishableKey) {
+  const pk = publishableKey || DEFAULT_PUBLISHABLE_KEY;
+  validatePublishableKey(pk);
+  const response = await fetch(
+    `${API_BASE_URL}/v1/public/onramps/cashapp/limits?currency=${encodeURIComponent(currency)}`,
+    {
+      method: "GET",
+      headers: {
+        accept: "application/json",
+        "x-publishable-key": pk
+      }
+    }
+  );
+  if (!response.ok) {
+    const error = await response.json().catch(() => ({ message: response.statusText }));
+    throw new Error(
+      `Failed to get Cash App limits: ${error.message || response.statusText}`
+    );
+  }
+  return response.json();
+}
+async function createCashAppSession(request, publishableKey) {
+  const pk = publishableKey || DEFAULT_PUBLISHABLE_KEY;
+  validatePublishableKey(pk);
+  const response = await fetch(
+    `${API_BASE_URL}/v1/public/onramps/cashapp/sessions`,
+    {
+      method: "POST",
+      headers: {
+        accept: "application/json",
+        "x-publishable-key": pk,
+        "Content-Type": "application/json"
+      },
+      body: JSON.stringify(request)
+    }
+  );
+  if (!response.ok) {
+    const error = await response.json().catch(() => ({ message: response.statusText }));
+    throw new Error(
+      `Failed to create Cash App session: ${error.message || response.statusText}`
+    );
+  }
+  return response.json();
+}
+async function getCashAppSessionStatus(externalId, publishableKey) {
+  const pk = publishableKey || DEFAULT_PUBLISHABLE_KEY;
+  validatePublishableKey(pk);
+  const response = await fetch(
+    `${API_BASE_URL}/v1/public/onramps/cashapp/sessions/${encodeURIComponent(externalId)}/status`,
+    {
+      method: "GET",
+      headers: {
+        accept: "application/json",
+        "x-publishable-key": pk
+      }
+    }
+  );
+  if (!response.ok) {
+    const error = await response.json().catch(() => ({ message: response.statusText }));
+    throw new Error(
+      `Failed to get Cash App session status: ${error.message || response.statusText}`
+    );
+  }
+  return response.json();
+}
 async function sendHypercoreTransaction(request, publishableKey) {
   const pk = publishableKey || DEFAULT_PUBLISHABLE_KEY;
   validatePublishableKey(pk);
@@ -757,6 +837,12 @@ async function sendHypercoreTransaction(request, publishableKey) {
 }
 
 // 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;
@@ -803,10 +889,10 @@ function useUserIp() {
     queryKey: ["unifold", "userIpInfo"],
     queryFn: async () => {
       const data = await getIpAddress();
-      const subdivision = (data.subdivision_code || data.state || "").toLowerCase() || null;
+      const subdivision = data.subdivision_code || data.state || "" || null;
       return {
-        alpha2: data.alpha2.toLowerCase(),
-        alpha3: data.alpha3?.toLowerCase(),
+        alpha2: data.alpha2,
+        alpha3: data.alpha3,
         country: data.country,
         state: subdivision,
         subdivisionCode: subdivision,
@@ -933,13 +1019,17 @@ var i18n = en_default;
   buildHypercoreTransaction,
   buildSolanaTransaction,
   checkHypercoreActivation,
+  createCashAppSession,
   createDepositAddress,
   createExchangeSession,
   createOnrampSession,
+  formatStablecoinAmount,
   generatePrefixedKSUID,
   getAddressBalance,
   getAddressBalances,
   getApiBaseUrl,
+  getCashAppLimits,
+  getCashAppSessionStatus,
   getChainName,
   getDefaultOnrampToken,
   getDepositQuote,

package/dist/index.mjs

@@ -142,19 +142,25 @@ async function pollDirectExecutions(request, publishableKey) {
   }
   return response.json();
 }
-async function getSupportedDestinationTokens(publishableKey) {
+async function getSupportedDestinationTokens(publishableKey, options) {
   const pk = publishableKey || DEFAULT_PUBLISHABLE_KEY;
   validatePublishableKey(pk);
-  const response = await fetch(
-    `${API_BASE_URL}/v1/public/tokens/supported_destination_tokens`,
-    {
-      method: "GET",
-      headers: {
-        accept: "application/json",
-        "x-publishable-key": pk
-      }
+  let url = `${API_BASE_URL}/v1/public/tokens/supported_destination_tokens`;
+  const params = new URLSearchParams();
+  if (options?.product_type) {
+    params.set("product_type", options.product_type);
+  }
+  const qs = params.toString();
+  if (qs) {
+    url = `${url}?${qs}`;
+  }
+  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 destination tokens: ${response.statusText}`
@@ -166,13 +172,18 @@ async function getSupportedDepositTokens(publishableKey, options) {
   const pk = publishableKey || DEFAULT_PUBLISHABLE_KEY;
   validatePublishableKey(pk);
   let url = `${API_BASE_URL}/v1/public/tokens/supported_deposit_tokens`;
+  const params = new URLSearchParams();
   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()}`;
+    params.set("destination_token_address", options.destination_token_address);
+    params.set("destination_chain_id", options.destination_chain_id);
+    params.set("destination_chain_type", options.destination_chain_type);
+  }
+  if (options?.product_type) {
+    params.set("product_type", options.product_type);
+  }
+  const qs = params.toString();
+  if (qs) {
+    url = `${url}?${qs}`;
   }
   const response = await fetch(url, {
     method: "GET",
@@ -664,6 +675,71 @@ async function buildHypercoreTransaction(request, publishableKey) {
   }
   return response.json();
 }
+async function getCashAppLimits(currency = "usd", publishableKey) {
+  const pk = publishableKey || DEFAULT_PUBLISHABLE_KEY;
+  validatePublishableKey(pk);
+  const response = await fetch(
+    `${API_BASE_URL}/v1/public/onramps/cashapp/limits?currency=${encodeURIComponent(currency)}`,
+    {
+      method: "GET",
+      headers: {
+        accept: "application/json",
+        "x-publishable-key": pk
+      }
+    }
+  );
+  if (!response.ok) {
+    const error = await response.json().catch(() => ({ message: response.statusText }));
+    throw new Error(
+      `Failed to get Cash App limits: ${error.message || response.statusText}`
+    );
+  }
+  return response.json();
+}
+async function createCashAppSession(request, publishableKey) {
+  const pk = publishableKey || DEFAULT_PUBLISHABLE_KEY;
+  validatePublishableKey(pk);
+  const response = await fetch(
+    `${API_BASE_URL}/v1/public/onramps/cashapp/sessions`,
+    {
+      method: "POST",
+      headers: {
+        accept: "application/json",
+        "x-publishable-key": pk,
+        "Content-Type": "application/json"
+      },
+      body: JSON.stringify(request)
+    }
+  );
+  if (!response.ok) {
+    const error = await response.json().catch(() => ({ message: response.statusText }));
+    throw new Error(
+      `Failed to create Cash App session: ${error.message || response.statusText}`
+    );
+  }
+  return response.json();
+}
+async function getCashAppSessionStatus(externalId, publishableKey) {
+  const pk = publishableKey || DEFAULT_PUBLISHABLE_KEY;
+  validatePublishableKey(pk);
+  const response = await fetch(
+    `${API_BASE_URL}/v1/public/onramps/cashapp/sessions/${encodeURIComponent(externalId)}/status`,
+    {
+      method: "GET",
+      headers: {
+        accept: "application/json",
+        "x-publishable-key": pk
+      }
+    }
+  );
+  if (!response.ok) {
+    const error = await response.json().catch(() => ({ message: response.statusText }));
+    throw new Error(
+      `Failed to get Cash App session status: ${error.message || response.statusText}`
+    );
+  }
+  return response.json();
+}
 async function sendHypercoreTransaction(request, publishableKey) {
   const pk = publishableKey || DEFAULT_PUBLISHABLE_KEY;
   validatePublishableKey(pk);
@@ -689,6 +765,12 @@ async function sendHypercoreTransaction(request, publishableKey) {
 }
 
 // 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;
@@ -735,10 +817,10 @@ function useUserIp() {
     queryKey: ["unifold", "userIpInfo"],
     queryFn: async () => {
       const data = await getIpAddress();
-      const subdivision = (data.subdivision_code || data.state || "").toLowerCase() || null;
+      const subdivision = data.subdivision_code || data.state || "" || null;
       return {
-        alpha2: data.alpha2.toLowerCase(),
-        alpha3: data.alpha3?.toLowerCase(),
+        alpha2: data.alpha2,
+        alpha3: data.alpha3,
         country: data.country,
         state: subdivision,
         subdivisionCode: subdivision,
@@ -864,13 +946,17 @@ export {
   buildHypercoreTransaction,
   buildSolanaTransaction,
   checkHypercoreActivation,
+  createCashAppSession,
   createDepositAddress,
   createExchangeSession,
   createOnrampSession,
+  formatStablecoinAmount,
   generatePrefixedKSUID,
   getAddressBalance,
   getAddressBalances,
   getApiBaseUrl,
+  getCashAppLimits,
+  getCashAppSessionStatus,
   getChainName,
   getDefaultOnrampToken,
   getDepositQuote,

package/package.json

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