@unifold/core 0.1.62 → 0.1.64

package/dist/index.d.mts

@@ -457,9 +457,11 @@ interface ProjectConfigResponse {
     project_name?: string;
     asset_cdn_url: string;
     transfer_crypto: {
+        enabled?: boolean;
         networks: FeaturedToken[];
     };
     connect_wallet: {
+        enabled?: boolean;
         wallets: FeaturedWallet[];
     };
     payment_networks: {
@@ -467,12 +469,21 @@ interface ProjectConfigResponse {
     };
     blocked_country_codes?: string[];
     blocked_country_subdivisions?: BlockedCountrySubdivision[];
+    connect_exchange?: {
+        enabled: boolean;
+    };
+    cash_app?: {
+        enabled: boolean;
+    };
     pay_with_exchange?: {
         enabled: boolean;
     };
     fiat_onramp?: {
         enabled: boolean;
     };
+    deposit_tracker?: {
+        enabled: boolean;
+    };
     hypercore_sponsorship?: {
         enabled: boolean;
     };
@@ -540,6 +551,78 @@ interface AddressBalancesResponse {
  * @param publishableKey - Optional publishable key, defaults to configured key
  */
 declare function getAddressBalances(address: string, chainType: ChainType, publishableKey?: string): Promise<AddressBalancesResponse>;
+/** Wallet ids supported by the connect-wallet flow. */
+type WalletMobileDeepLinkWallet = "phantom" | "metamask" | "coinbase" | "trust" | "rainbow" | "rabby" | "okx";
+/** Chain types an external wallet can connect on. */
+type ExternalWalletChainType = "ethereum" | "solana";
+/** A supported external (self-custody) wallet from the directory endpoint. */
+interface ExternalWalletInfo {
+    id: WalletMobileDeepLinkWallet;
+    name: string;
+    chain_types: ExternalWalletChainType[];
+    install_url: string;
+    icon_url: string;
+    icon_urls: Array<{
+        url: string;
+        format: "svg" | "png";
+    }>;
+    /** Whether the wallet can be opened into its in-app browser on mobile. */
+    supports_mobile_browse: boolean;
+    /**
+     * Mobile platforms the in-app browser deep link works on.
+     * `null` means all platforms; an explicit list (e.g. `["ios"]`) tells the
+     * client to only offer mobile-browse on those platforms.
+     */
+    mobile_browse_platforms: ("ios" | "android")[] | null;
+}
+interface ExternalWalletsResponse {
+    data: ExternalWalletInfo[];
+}
+/**
+ * List the external (self-custody) wallets supported by the connect-wallet flow.
+ *
+ * Returns the wallet catalog (id, name, networks, install URL, icons, mobile
+ * in-app browser support) from the backend, so the supported set can change
+ * server-side without an SDK release.
+ *
+ * @param publishableKey - Optional publishable key, defaults to configured key
+ */
+declare function getExternalWallets(publishableKey?: string): Promise<ExternalWalletsResponse>;
+/** A Unifold deposit address the hosted pay page can send funds to. */
+interface WalletMobileDeepLinkDepositAddress {
+    chain_type: string;
+    address: string;
+}
+interface WalletMobileDeepLinkResponse {
+    /** The wallet the deep link was generated for. */
+    wallet: WalletMobileDeepLinkWallet;
+    /**
+     * Universal/deep link that opens the hosted Unifold pay page inside the
+     * wallet's in-app browser, or `null` when the wallet has no reliable
+     * dapp-browser deep link.
+     */
+    deeplink: string | null;
+    /** The hosted Unifold pay URL the deep link points at (self-contained flow). */
+    pay_url: string;
+    /** Whether the wallet supports opening a dapp in its in-app browser. */
+    supported: boolean;
+}
+/**
+ * Generate a mobile in-app browser deep link for a wallet.
+ *
+ * Browser-extension wallets only inject their provider inside their own in-app
+ * browser, not in a regular mobile browser. The backend builds a self-contained
+ * Unifold-hosted pay URL (embedding the given deposit addresses) and wraps it in
+ * the selected wallet's in-app browser deep link (e.g. Phantom's embedded
+ * browser). Opening it runs the deposit flow inside the wallet without depending
+ * on the merchant's site. `deeplink` is `null` for wallets without a reliable
+ * dapp-browser deep link.
+ *
+ * @param wallet - Wallet id (phantom, metamask, coinbase, trust, rainbow, rabby, okx)
+ * @param depositAddresses - Unifold deposit addresses (one per source chain) to embed in the hosted pay URL
+ * @param publishableKey - Optional publishable key, defaults to configured key
+ */
+declare function getWalletMobileDeepLink(wallet: WalletMobileDeepLinkWallet, depositAddresses: WalletMobileDeepLinkDepositAddress[], publishableKey?: string): Promise<WalletMobileDeepLinkResponse>;
 interface AddressBalanceResponse {
     address: string;
     chain_type: string;
@@ -1195,6 +1278,11 @@ declare function sendHypercoreTransaction(request: SendHypercoreTransactionReque
  * formatStablecoinAmount("10000000", 6) // "10.00" (whole number)
  */
 declare function formatStablecoinAmount(baseUnits: string, decimals: number): string;
+/**
+ * Generate a KSUID-like ID without external dependencies.
+ * Format: `base62(4-byte-timestamp + 16-random-bytes)` (27 chars).
+ */
+declare function generateKSUID(): string;
 /**
  * Generate a KSUID-like prefixed ID without external dependencies.
  * Format: `{prefix}_{base62(4-byte-timestamp + 16-random-bytes)}` (27 chars after prefix).
@@ -1357,4 +1445,4 @@ declare const i18n: {
 };
 type I18nStrings = typeof i18n;
 
-export { ActionType, type AddressBalanceResponse, type AddressBalancesResponse, type AddressValidationFailureCode, type AddressValidationMetadata, type AuthenticateOAuthResult, type AutoSwapRequest, type AutoSwapResponse, type BlockedCountrySubdivision, type BuildHypercoreTransactionRequest, type BuildHypercoreTransactionResponse, type BuildSolanaTransactionRequest, type BuildSolanaTransactionResponse, type CashAppLimits, type CashAppSessionRequest, type CashAppSessionResponse, type CashAppSessionStatusResponse, type ChainType, type ConfirmIntegrationTransferResult, type CreateDepositAddressRequest, type CreateExchangeSessionRequest, type CreateExchangeSessionResponse, type CreateIntegrationTransferParams, type CreateIntegrationTransferResult, type DefaultTokenChain, type DefaultTokenMetadata, type DefaultTokenResponse, type DepositAddressResponse, type DepositEvent, DepositEventType, type DepositQuote, type DepositQuoteRequest, type DestinationToken, type DestinationTokenChain, type EvmContractCall, type ExchangeProviderInfo, type ExchangeProvidersResponse, type ExchangeSessionStartParams, type ExchangeWalletAddress, ExecutionStatus, type FeaturedToken, type FeaturedWallet, type FiatCurrenciesResponse, type FiatCurrency, type GetExchangesQuery, type HypercoreActionType, type HypercoreActivationRequest, type HypercoreActivationResponse, type I18nStrings, type IconUrl, IneligibilityReason, type IntegrationAccount, type IntegrationExchangeInfo, type IntegrationExchangesResponse, type IntegrationFeeAmount, type IntegrationHoldingsResponse, IntegrationProvider, type IpAddressResponse, type LockedQuoteLimits, type LockedQuotePreview, type LockedQuotePreviewRequest, type OnrampQuote, type OnrampQuotesRequest, type OnrampQuotesResponse, type OnrampSessionCreatedData, type OnrampSessionCreatedEvent, type OnrampSessionRequest, type OnrampSessionResponse, type PaymentIntent, type PaymentIntentDepositAddress, type PaymentIntentExecutionsResponse, type PaymentIntentStatus, type PaymentIntentType, type PaymentNetwork, type PollExecutionsRequest, type PollExecutionsResponse, type ProductType, type ProjectConfigResponse, type QueryExecutionsRequest, type QueryExecutionsResponse, type RefreshIntegrationTokenResult, SOLANA_USDC_ADDRESS, type SendHypercoreTransactionRequest, type SendHypercoreTransactionResponse, type SendSolanaTransactionRequest, type SendSolanaTransactionResponse, type SourceToken, type SourceTokenNetwork, type StartIntegrationOAuthResult, type SupportedChain, type SupportedDepositTokensResponse, type SupportedDestinationTokensResponse, type SupportedSourceTokensQuery, type SupportedSourceTokensResponse, type SupportedToken, type TokenBalance, type TokenChain, type TokenChainIconUrl, type TokenChainsResponse, type TokenIconUrl, type TokenInfo, type TokenMetadata, type TransferDefaultTokenParams, type TransferDefaultTokenResult, type UserIpInfo, type VerifyAddressRequest, type VerifyAddressResponse, type Wallet, authenticateIntegrationOAuth, buildHypercoreTransaction, buildSolanaTransaction, checkHypercoreActivation, confirmIntegrationTransfer, createCashAppSession, createDepositAddress, createExchangeSession, createIntegrationTransfer, createOnrampSession, formatStablecoinAmount, generatePrefixedKSUID, getAddressBalance, getAddressBalances, getApiBaseUrl, getCashAppLimits, getCashAppSessionStatus, getChainName, getDefaultOnrampToken, getDepositAddress, getDepositQuote, getExchangeSessionStartUrl, getExchanges, getFiatCurrencies, getIconUrl, getIconUrlWithCdn, getIntegrationExchanges, getIntegrationHoldings, getIntegrationTransferDefaultToken, getIpAddress, getOnrampQuotes, getOnrampSessionStartUrl, getPreferredIconUrl, getProjectConfig, getSupportedDepositTokens, getSupportedDestinationTokens, getTokenChains, getTokenMetadata, getWalletByChainType, i18n, listPaymentIntentExecutions, pollDirectExecutions, queryExecutions, refreshIntegrationToken, retrievePaymentIntent, revokeIntegrationToken, sendHypercoreTransaction, sendSolanaTransaction, setApiConfig, startIntegrationOAuth, useUserIp, verifyRecipientAddress };
+export { ActionType, type AddressBalanceResponse, type AddressBalancesResponse, type AddressValidationFailureCode, type AddressValidationMetadata, type AuthenticateOAuthResult, type AutoSwapRequest, type AutoSwapResponse, type BlockedCountrySubdivision, type BuildHypercoreTransactionRequest, type BuildHypercoreTransactionResponse, type BuildSolanaTransactionRequest, type BuildSolanaTransactionResponse, type CashAppLimits, type CashAppSessionRequest, type CashAppSessionResponse, type CashAppSessionStatusResponse, type ChainType, type ConfirmIntegrationTransferResult, type CreateDepositAddressRequest, type CreateExchangeSessionRequest, type CreateExchangeSessionResponse, type CreateIntegrationTransferParams, type CreateIntegrationTransferResult, type DefaultTokenChain, type DefaultTokenMetadata, type DefaultTokenResponse, type DepositAddressResponse, type DepositEvent, DepositEventType, type DepositQuote, type DepositQuoteRequest, type DestinationToken, type DestinationTokenChain, type EvmContractCall, type ExchangeProviderInfo, type ExchangeProvidersResponse, type ExchangeSessionStartParams, type ExchangeWalletAddress, ExecutionStatus, type ExternalWalletChainType, type ExternalWalletInfo, type ExternalWalletsResponse, type FeaturedToken, type FeaturedWallet, type FiatCurrenciesResponse, type FiatCurrency, type GetExchangesQuery, type HypercoreActionType, type HypercoreActivationRequest, type HypercoreActivationResponse, type I18nStrings, type IconUrl, IneligibilityReason, type IntegrationAccount, type IntegrationExchangeInfo, type IntegrationExchangesResponse, type IntegrationFeeAmount, type IntegrationHoldingsResponse, IntegrationProvider, type IpAddressResponse, type LockedQuoteLimits, type LockedQuotePreview, type LockedQuotePreviewRequest, type OnrampQuote, type OnrampQuotesRequest, type OnrampQuotesResponse, type OnrampSessionCreatedData, type OnrampSessionCreatedEvent, type OnrampSessionRequest, type OnrampSessionResponse, type PaymentIntent, type PaymentIntentDepositAddress, type PaymentIntentExecutionsResponse, type PaymentIntentStatus, type PaymentIntentType, type PaymentNetwork, type PollExecutionsRequest, type PollExecutionsResponse, type ProductType, type ProjectConfigResponse, type QueryExecutionsRequest, type QueryExecutionsResponse, type RefreshIntegrationTokenResult, SOLANA_USDC_ADDRESS, type SendHypercoreTransactionRequest, type SendHypercoreTransactionResponse, type SendSolanaTransactionRequest, type SendSolanaTransactionResponse, type SourceToken, type SourceTokenNetwork, type StartIntegrationOAuthResult, type SupportedChain, type SupportedDepositTokensResponse, type SupportedDestinationTokensResponse, type SupportedSourceTokensQuery, type SupportedSourceTokensResponse, type SupportedToken, type TokenBalance, type TokenChain, type TokenChainIconUrl, type TokenChainsResponse, type TokenIconUrl, type TokenInfo, type TokenMetadata, type TransferDefaultTokenParams, type TransferDefaultTokenResult, type UserIpInfo, type VerifyAddressRequest, type VerifyAddressResponse, type Wallet, type WalletMobileDeepLinkDepositAddress, type WalletMobileDeepLinkResponse, type WalletMobileDeepLinkWallet, authenticateIntegrationOAuth, buildHypercoreTransaction, buildSolanaTransaction, checkHypercoreActivation, confirmIntegrationTransfer, createCashAppSession, createDepositAddress, createExchangeSession, createIntegrationTransfer, createOnrampSession, formatStablecoinAmount, generateKSUID, generatePrefixedKSUID, getAddressBalance, getAddressBalances, getApiBaseUrl, getCashAppLimits, getCashAppSessionStatus, getChainName, getDefaultOnrampToken, getDepositAddress, getDepositQuote, getExchangeSessionStartUrl, getExchanges, getExternalWallets, getFiatCurrencies, getIconUrl, getIconUrlWithCdn, getIntegrationExchanges, getIntegrationHoldings, getIntegrationTransferDefaultToken, getIpAddress, getOnrampQuotes, getOnrampSessionStartUrl, getPreferredIconUrl, getProjectConfig, getSupportedDepositTokens, getSupportedDestinationTokens, getTokenChains, getTokenMetadata, getWalletByChainType, getWalletMobileDeepLink, i18n, listPaymentIntentExecutions, pollDirectExecutions, queryExecutions, refreshIntegrationToken, retrievePaymentIntent, revokeIntegrationToken, sendHypercoreTransaction, sendSolanaTransaction, setApiConfig, startIntegrationOAuth, useUserIp, verifyRecipientAddress };

package/dist/index.d.ts

@@ -457,9 +457,11 @@ interface ProjectConfigResponse {
     project_name?: string;
     asset_cdn_url: string;
     transfer_crypto: {
+        enabled?: boolean;
         networks: FeaturedToken[];
     };
     connect_wallet: {
+        enabled?: boolean;
         wallets: FeaturedWallet[];
     };
     payment_networks: {
@@ -467,12 +469,21 @@ interface ProjectConfigResponse {
     };
     blocked_country_codes?: string[];
     blocked_country_subdivisions?: BlockedCountrySubdivision[];
+    connect_exchange?: {
+        enabled: boolean;
+    };
+    cash_app?: {
+        enabled: boolean;
+    };
     pay_with_exchange?: {
         enabled: boolean;
     };
     fiat_onramp?: {
         enabled: boolean;
     };
+    deposit_tracker?: {
+        enabled: boolean;
+    };
     hypercore_sponsorship?: {
         enabled: boolean;
     };
@@ -540,6 +551,78 @@ interface AddressBalancesResponse {
  * @param publishableKey - Optional publishable key, defaults to configured key
  */
 declare function getAddressBalances(address: string, chainType: ChainType, publishableKey?: string): Promise<AddressBalancesResponse>;
+/** Wallet ids supported by the connect-wallet flow. */
+type WalletMobileDeepLinkWallet = "phantom" | "metamask" | "coinbase" | "trust" | "rainbow" | "rabby" | "okx";
+/** Chain types an external wallet can connect on. */
+type ExternalWalletChainType = "ethereum" | "solana";
+/** A supported external (self-custody) wallet from the directory endpoint. */
+interface ExternalWalletInfo {
+    id: WalletMobileDeepLinkWallet;
+    name: string;
+    chain_types: ExternalWalletChainType[];
+    install_url: string;
+    icon_url: string;
+    icon_urls: Array<{
+        url: string;
+        format: "svg" | "png";
+    }>;
+    /** Whether the wallet can be opened into its in-app browser on mobile. */
+    supports_mobile_browse: boolean;
+    /**
+     * Mobile platforms the in-app browser deep link works on.
+     * `null` means all platforms; an explicit list (e.g. `["ios"]`) tells the
+     * client to only offer mobile-browse on those platforms.
+     */
+    mobile_browse_platforms: ("ios" | "android")[] | null;
+}
+interface ExternalWalletsResponse {
+    data: ExternalWalletInfo[];
+}
+/**
+ * List the external (self-custody) wallets supported by the connect-wallet flow.
+ *
+ * Returns the wallet catalog (id, name, networks, install URL, icons, mobile
+ * in-app browser support) from the backend, so the supported set can change
+ * server-side without an SDK release.
+ *
+ * @param publishableKey - Optional publishable key, defaults to configured key
+ */
+declare function getExternalWallets(publishableKey?: string): Promise<ExternalWalletsResponse>;
+/** A Unifold deposit address the hosted pay page can send funds to. */
+interface WalletMobileDeepLinkDepositAddress {
+    chain_type: string;
+    address: string;
+}
+interface WalletMobileDeepLinkResponse {
+    /** The wallet the deep link was generated for. */
+    wallet: WalletMobileDeepLinkWallet;
+    /**
+     * Universal/deep link that opens the hosted Unifold pay page inside the
+     * wallet's in-app browser, or `null` when the wallet has no reliable
+     * dapp-browser deep link.
+     */
+    deeplink: string | null;
+    /** The hosted Unifold pay URL the deep link points at (self-contained flow). */
+    pay_url: string;
+    /** Whether the wallet supports opening a dapp in its in-app browser. */
+    supported: boolean;
+}
+/**
+ * Generate a mobile in-app browser deep link for a wallet.
+ *
+ * Browser-extension wallets only inject their provider inside their own in-app
+ * browser, not in a regular mobile browser. The backend builds a self-contained
+ * Unifold-hosted pay URL (embedding the given deposit addresses) and wraps it in
+ * the selected wallet's in-app browser deep link (e.g. Phantom's embedded
+ * browser). Opening it runs the deposit flow inside the wallet without depending
+ * on the merchant's site. `deeplink` is `null` for wallets without a reliable
+ * dapp-browser deep link.
+ *
+ * @param wallet - Wallet id (phantom, metamask, coinbase, trust, rainbow, rabby, okx)
+ * @param depositAddresses - Unifold deposit addresses (one per source chain) to embed in the hosted pay URL
+ * @param publishableKey - Optional publishable key, defaults to configured key
+ */
+declare function getWalletMobileDeepLink(wallet: WalletMobileDeepLinkWallet, depositAddresses: WalletMobileDeepLinkDepositAddress[], publishableKey?: string): Promise<WalletMobileDeepLinkResponse>;
 interface AddressBalanceResponse {
     address: string;
     chain_type: string;
@@ -1195,6 +1278,11 @@ declare function sendHypercoreTransaction(request: SendHypercoreTransactionReque
  * formatStablecoinAmount("10000000", 6) // "10.00" (whole number)
  */
 declare function formatStablecoinAmount(baseUnits: string, decimals: number): string;
+/**
+ * Generate a KSUID-like ID without external dependencies.
+ * Format: `base62(4-byte-timestamp + 16-random-bytes)` (27 chars).
+ */
+declare function generateKSUID(): string;
 /**
  * Generate a KSUID-like prefixed ID without external dependencies.
  * Format: `{prefix}_{base62(4-byte-timestamp + 16-random-bytes)}` (27 chars after prefix).
@@ -1357,4 +1445,4 @@ declare const i18n: {
 };
 type I18nStrings = typeof i18n;
 
-export { ActionType, type AddressBalanceResponse, type AddressBalancesResponse, type AddressValidationFailureCode, type AddressValidationMetadata, type AuthenticateOAuthResult, type AutoSwapRequest, type AutoSwapResponse, type BlockedCountrySubdivision, type BuildHypercoreTransactionRequest, type BuildHypercoreTransactionResponse, type BuildSolanaTransactionRequest, type BuildSolanaTransactionResponse, type CashAppLimits, type CashAppSessionRequest, type CashAppSessionResponse, type CashAppSessionStatusResponse, type ChainType, type ConfirmIntegrationTransferResult, type CreateDepositAddressRequest, type CreateExchangeSessionRequest, type CreateExchangeSessionResponse, type CreateIntegrationTransferParams, type CreateIntegrationTransferResult, type DefaultTokenChain, type DefaultTokenMetadata, type DefaultTokenResponse, type DepositAddressResponse, type DepositEvent, DepositEventType, type DepositQuote, type DepositQuoteRequest, type DestinationToken, type DestinationTokenChain, type EvmContractCall, type ExchangeProviderInfo, type ExchangeProvidersResponse, type ExchangeSessionStartParams, type ExchangeWalletAddress, ExecutionStatus, type FeaturedToken, type FeaturedWallet, type FiatCurrenciesResponse, type FiatCurrency, type GetExchangesQuery, type HypercoreActionType, type HypercoreActivationRequest, type HypercoreActivationResponse, type I18nStrings, type IconUrl, IneligibilityReason, type IntegrationAccount, type IntegrationExchangeInfo, type IntegrationExchangesResponse, type IntegrationFeeAmount, type IntegrationHoldingsResponse, IntegrationProvider, type IpAddressResponse, type LockedQuoteLimits, type LockedQuotePreview, type LockedQuotePreviewRequest, type OnrampQuote, type OnrampQuotesRequest, type OnrampQuotesResponse, type OnrampSessionCreatedData, type OnrampSessionCreatedEvent, type OnrampSessionRequest, type OnrampSessionResponse, type PaymentIntent, type PaymentIntentDepositAddress, type PaymentIntentExecutionsResponse, type PaymentIntentStatus, type PaymentIntentType, type PaymentNetwork, type PollExecutionsRequest, type PollExecutionsResponse, type ProductType, type ProjectConfigResponse, type QueryExecutionsRequest, type QueryExecutionsResponse, type RefreshIntegrationTokenResult, SOLANA_USDC_ADDRESS, type SendHypercoreTransactionRequest, type SendHypercoreTransactionResponse, type SendSolanaTransactionRequest, type SendSolanaTransactionResponse, type SourceToken, type SourceTokenNetwork, type StartIntegrationOAuthResult, type SupportedChain, type SupportedDepositTokensResponse, type SupportedDestinationTokensResponse, type SupportedSourceTokensQuery, type SupportedSourceTokensResponse, type SupportedToken, type TokenBalance, type TokenChain, type TokenChainIconUrl, type TokenChainsResponse, type TokenIconUrl, type TokenInfo, type TokenMetadata, type TransferDefaultTokenParams, type TransferDefaultTokenResult, type UserIpInfo, type VerifyAddressRequest, type VerifyAddressResponse, type Wallet, authenticateIntegrationOAuth, buildHypercoreTransaction, buildSolanaTransaction, checkHypercoreActivation, confirmIntegrationTransfer, createCashAppSession, createDepositAddress, createExchangeSession, createIntegrationTransfer, createOnrampSession, formatStablecoinAmount, generatePrefixedKSUID, getAddressBalance, getAddressBalances, getApiBaseUrl, getCashAppLimits, getCashAppSessionStatus, getChainName, getDefaultOnrampToken, getDepositAddress, getDepositQuote, getExchangeSessionStartUrl, getExchanges, getFiatCurrencies, getIconUrl, getIconUrlWithCdn, getIntegrationExchanges, getIntegrationHoldings, getIntegrationTransferDefaultToken, getIpAddress, getOnrampQuotes, getOnrampSessionStartUrl, getPreferredIconUrl, getProjectConfig, getSupportedDepositTokens, getSupportedDestinationTokens, getTokenChains, getTokenMetadata, getWalletByChainType, i18n, listPaymentIntentExecutions, pollDirectExecutions, queryExecutions, refreshIntegrationToken, retrievePaymentIntent, revokeIntegrationToken, sendHypercoreTransaction, sendSolanaTransaction, setApiConfig, startIntegrationOAuth, useUserIp, verifyRecipientAddress };
+export { ActionType, type AddressBalanceResponse, type AddressBalancesResponse, type AddressValidationFailureCode, type AddressValidationMetadata, type AuthenticateOAuthResult, type AutoSwapRequest, type AutoSwapResponse, type BlockedCountrySubdivision, type BuildHypercoreTransactionRequest, type BuildHypercoreTransactionResponse, type BuildSolanaTransactionRequest, type BuildSolanaTransactionResponse, type CashAppLimits, type CashAppSessionRequest, type CashAppSessionResponse, type CashAppSessionStatusResponse, type ChainType, type ConfirmIntegrationTransferResult, type CreateDepositAddressRequest, type CreateExchangeSessionRequest, type CreateExchangeSessionResponse, type CreateIntegrationTransferParams, type CreateIntegrationTransferResult, type DefaultTokenChain, type DefaultTokenMetadata, type DefaultTokenResponse, type DepositAddressResponse, type DepositEvent, DepositEventType, type DepositQuote, type DepositQuoteRequest, type DestinationToken, type DestinationTokenChain, type EvmContractCall, type ExchangeProviderInfo, type ExchangeProvidersResponse, type ExchangeSessionStartParams, type ExchangeWalletAddress, ExecutionStatus, type ExternalWalletChainType, type ExternalWalletInfo, type ExternalWalletsResponse, type FeaturedToken, type FeaturedWallet, type FiatCurrenciesResponse, type FiatCurrency, type GetExchangesQuery, type HypercoreActionType, type HypercoreActivationRequest, type HypercoreActivationResponse, type I18nStrings, type IconUrl, IneligibilityReason, type IntegrationAccount, type IntegrationExchangeInfo, type IntegrationExchangesResponse, type IntegrationFeeAmount, type IntegrationHoldingsResponse, IntegrationProvider, type IpAddressResponse, type LockedQuoteLimits, type LockedQuotePreview, type LockedQuotePreviewRequest, type OnrampQuote, type OnrampQuotesRequest, type OnrampQuotesResponse, type OnrampSessionCreatedData, type OnrampSessionCreatedEvent, type OnrampSessionRequest, type OnrampSessionResponse, type PaymentIntent, type PaymentIntentDepositAddress, type PaymentIntentExecutionsResponse, type PaymentIntentStatus, type PaymentIntentType, type PaymentNetwork, type PollExecutionsRequest, type PollExecutionsResponse, type ProductType, type ProjectConfigResponse, type QueryExecutionsRequest, type QueryExecutionsResponse, type RefreshIntegrationTokenResult, SOLANA_USDC_ADDRESS, type SendHypercoreTransactionRequest, type SendHypercoreTransactionResponse, type SendSolanaTransactionRequest, type SendSolanaTransactionResponse, type SourceToken, type SourceTokenNetwork, type StartIntegrationOAuthResult, type SupportedChain, type SupportedDepositTokensResponse, type SupportedDestinationTokensResponse, type SupportedSourceTokensQuery, type SupportedSourceTokensResponse, type SupportedToken, type TokenBalance, type TokenChain, type TokenChainIconUrl, type TokenChainsResponse, type TokenIconUrl, type TokenInfo, type TokenMetadata, type TransferDefaultTokenParams, type TransferDefaultTokenResult, type UserIpInfo, type VerifyAddressRequest, type VerifyAddressResponse, type Wallet, type WalletMobileDeepLinkDepositAddress, type WalletMobileDeepLinkResponse, type WalletMobileDeepLinkWallet, authenticateIntegrationOAuth, buildHypercoreTransaction, buildSolanaTransaction, checkHypercoreActivation, confirmIntegrationTransfer, createCashAppSession, createDepositAddress, createExchangeSession, createIntegrationTransfer, createOnrampSession, formatStablecoinAmount, generateKSUID, generatePrefixedKSUID, getAddressBalance, getAddressBalances, getApiBaseUrl, getCashAppLimits, getCashAppSessionStatus, getChainName, getDefaultOnrampToken, getDepositAddress, getDepositQuote, getExchangeSessionStartUrl, getExchanges, getExternalWallets, getFiatCurrencies, getIconUrl, getIconUrlWithCdn, getIntegrationExchanges, getIntegrationHoldings, getIntegrationTransferDefaultToken, getIpAddress, getOnrampQuotes, getOnrampSessionStartUrl, getPreferredIconUrl, getProjectConfig, getSupportedDepositTokens, getSupportedDestinationTokens, getTokenChains, getTokenMetadata, getWalletByChainType, getWalletMobileDeepLink, i18n, listPaymentIntentExecutions, pollDirectExecutions, queryExecutions, refreshIntegrationToken, retrievePaymentIntent, revokeIntegrationToken, sendHypercoreTransaction, sendSolanaTransaction, setApiConfig, startIntegrationOAuth, useUserIp, verifyRecipientAddress };

package/dist/index.js

@@ -37,6 +37,7 @@ __export(index_exports, {
   createIntegrationTransfer: () => createIntegrationTransfer,
   createOnrampSession: () => createOnrampSession,
   formatStablecoinAmount: () => formatStablecoinAmount,
+  generateKSUID: () => generateKSUID,
   generatePrefixedKSUID: () => generatePrefixedKSUID,
   getAddressBalance: () => getAddressBalance,
   getAddressBalances: () => getAddressBalances,
@@ -49,6 +50,7 @@ __export(index_exports, {
   getDepositQuote: () => getDepositQuote,
   getExchangeSessionStartUrl: () => getExchangeSessionStartUrl,
   getExchanges: () => getExchanges,
+  getExternalWallets: () => getExternalWallets,
   getFiatCurrencies: () => getFiatCurrencies,
   getIconUrl: () => getIconUrl,
   getIconUrlWithCdn: () => getIconUrlWithCdn,
@@ -65,6 +67,7 @@ __export(index_exports, {
   getTokenChains: () => getTokenChains,
   getTokenMetadata: () => getTokenMetadata,
   getWalletByChainType: () => getWalletByChainType,
+  getWalletMobileDeepLink: () => getWalletMobileDeepLink,
   i18n: () => i18n,
   listPaymentIntentExecutions: () => listPaymentIntentExecutions,
   pollDirectExecutions: () => pollDirectExecutions,
@@ -81,6 +84,44 @@ __export(index_exports, {
 });
 module.exports = __toCommonJS(index_exports);
 
+// src/lib/utils.ts
+function formatStablecoinAmount(baseUnits, decimals) {
+  const raw = Number(baseUnits) / 10 ** decimals;
+  const floored = Math.floor(raw * 100) / 100;
+  const ceiled = raw > floored ? floored + 0.01 : raw;
+  return ceiled.toFixed(2);
+}
+function generateKSUID() {
+  const BASE62 = "0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz";
+  const KSUID_EPOCH = 14e8;
+  const timestampSeconds = Math.floor(Date.now() / 1e3) - KSUID_EPOCH;
+  const payload = new Uint8Array(20);
+  payload[0] = timestampSeconds >>> 24 & 255;
+  payload[1] = timestampSeconds >>> 16 & 255;
+  payload[2] = timestampSeconds >>> 8 & 255;
+  payload[3] = timestampSeconds & 255;
+  if (typeof crypto !== "undefined" && crypto.getRandomValues) {
+    crypto.getRandomValues(payload.subarray(4));
+  } else {
+    for (let i = 4; i < 20; i++) {
+      payload[i] = Math.floor(Math.random() * 256);
+    }
+  }
+  let value = 0n;
+  for (const byte of payload) {
+    value = value << 8n | BigInt(byte);
+  }
+  let encoded = "";
+  while (value > 0n) {
+    encoded = BASE62[Number(value % 62n)] + encoded;
+    value = value / 62n;
+  }
+  return encoded.padStart(27, "0");
+}
+function generatePrefixedKSUID(prefix) {
+  return `${prefix}_${generateKSUID()}`;
+}
+
 // src/lib/api.ts
 var API_BASE_URL = (() => {
   try {
@@ -408,9 +449,7 @@ function getOnrampSessionStartUrl(request, publishableKey) {
   if (request.subdivision_code) {
     params.append("subdivision_code", request.subdivision_code);
   }
-  if (request.external_id) {
-    params.append("external_id", request.external_id);
-  }
+  params.append("external_id", request.external_id ?? generatePrefixedKSUID("ors"));
   if (request.email) {
     params.append("email", request.email);
   }
@@ -521,6 +560,40 @@ async function getAddressBalances(address, chainType, publishableKey) {
   const data = await response.json();
   return data;
 }
+async function getExternalWallets(publishableKey) {
+  const pk = publishableKey || DEFAULT_PUBLISHABLE_KEY;
+  validatePublishableKey(pk);
+  const response = await fetch(`${API_BASE_URL}/v1/public/external_wallets`, {
+    method: "GET",
+    headers: {
+      accept: "application/json",
+      "x-publishable-key": pk
+    }
+  });
+  if (!response.ok) {
+    throw new Error(`Failed to fetch external wallets: ${response.statusText}`);
+  }
+  const data = await response.json();
+  return data;
+}
+async function getWalletMobileDeepLink(wallet, depositAddresses, publishableKey) {
+  const pk = publishableKey || DEFAULT_PUBLISHABLE_KEY;
+  validatePublishableKey(pk);
+  const response = await fetch(`${API_BASE_URL}/v1/public/external_wallets/mobile_deeplink`, {
+    method: "POST",
+    headers: {
+      "Content-Type": "application/json",
+      accept: "application/json",
+      "x-publishable-key": pk
+    },
+    body: JSON.stringify({ wallet, deposit_addresses: depositAddresses })
+  });
+  if (!response.ok) {
+    throw new Error(`Failed to generate wallet deep link: ${response.statusText}`);
+  }
+  const data = await response.json();
+  return data;
+}
 async function getAddressBalance(address, chainType, chainId, tokenAddress, publishableKey) {
   const pk = publishableKey || DEFAULT_PUBLISHABLE_KEY;
   validatePublishableKey(pk);
@@ -645,9 +718,7 @@ function getExchangeSessionStartUrl(request, publishableKey) {
   if (request.source_amount) {
     params.append("source_amount", request.source_amount);
   }
-  if (request.external_id) {
-    params.append("external_id", request.external_id);
-  }
+  params.append("external_id", request.external_id ?? generatePrefixedKSUID("exc"));
   return `${API_BASE_URL}/v1/public/onramps/exchanges/sessions/start?${params.toString()}`;
 }
 async function getIntegrationExchanges(publishableKey) {
@@ -1028,42 +1099,6 @@ async function sendHypercoreTransaction(request, publishableKey) {
   return response.json();
 }
 
-// src/lib/utils.ts
-function formatStablecoinAmount(baseUnits, decimals) {
-  const raw = Number(baseUnits) / 10 ** decimals;
-  const floored = Math.floor(raw * 100) / 100;
-  const ceiled = raw > floored ? floored + 0.01 : raw;
-  return ceiled.toFixed(2);
-}
-function generatePrefixedKSUID(prefix) {
-  const BASE62 = "0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz";
-  const KSUID_EPOCH = 14e8;
-  const timestampSeconds = Math.floor(Date.now() / 1e3) - KSUID_EPOCH;
-  const payload = new Uint8Array(20);
-  payload[0] = timestampSeconds >>> 24 & 255;
-  payload[1] = timestampSeconds >>> 16 & 255;
-  payload[2] = timestampSeconds >>> 8 & 255;
-  payload[3] = timestampSeconds & 255;
-  if (typeof crypto !== "undefined" && crypto.getRandomValues) {
-    crypto.getRandomValues(payload.subarray(4));
-  } else {
-    for (let i = 4; i < 20; i++) {
-      payload[i] = Math.floor(Math.random() * 256);
-    }
-  }
-  let value = 0n;
-  for (const byte of payload) {
-    value = value << 8n | BigInt(byte);
-  }
-  let encoded = "";
-  while (value > 0n) {
-    encoded = BASE62[Number(value % 62n)] + encoded;
-    value = value / 62n;
-  }
-  encoded = encoded.padStart(27, "0");
-  return `${prefix}_${encoded}`;
-}
-
 // src/lib/events.ts
 var DepositEventType = /* @__PURE__ */ ((DepositEventType2) => {
   DepositEventType2["ONRAMP_SESSION_CREATED"] = "onramp_session.created";
@@ -1220,6 +1255,7 @@ var i18n = en_default;
   createIntegrationTransfer,
   createOnrampSession,
   formatStablecoinAmount,
+  generateKSUID,
   generatePrefixedKSUID,
   getAddressBalance,
   getAddressBalances,
@@ -1232,6 +1268,7 @@ var i18n = en_default;
   getDepositQuote,
   getExchangeSessionStartUrl,
   getExchanges,
+  getExternalWallets,
   getFiatCurrencies,
   getIconUrl,
   getIconUrlWithCdn,
@@ -1248,6 +1285,7 @@ var i18n = en_default;
   getTokenChains,
   getTokenMetadata,
   getWalletByChainType,
+  getWalletMobileDeepLink,
   i18n,
   listPaymentIntentExecutions,
   pollDirectExecutions,

package/dist/index.mjs

@@ -1,3 +1,41 @@
+// src/lib/utils.ts
+function formatStablecoinAmount(baseUnits, decimals) {
+  const raw = Number(baseUnits) / 10 ** decimals;
+  const floored = Math.floor(raw * 100) / 100;
+  const ceiled = raw > floored ? floored + 0.01 : raw;
+  return ceiled.toFixed(2);
+}
+function generateKSUID() {
+  const BASE62 = "0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz";
+  const KSUID_EPOCH = 14e8;
+  const timestampSeconds = Math.floor(Date.now() / 1e3) - KSUID_EPOCH;
+  const payload = new Uint8Array(20);
+  payload[0] = timestampSeconds >>> 24 & 255;
+  payload[1] = timestampSeconds >>> 16 & 255;
+  payload[2] = timestampSeconds >>> 8 & 255;
+  payload[3] = timestampSeconds & 255;
+  if (typeof crypto !== "undefined" && crypto.getRandomValues) {
+    crypto.getRandomValues(payload.subarray(4));
+  } else {
+    for (let i = 4; i < 20; i++) {
+      payload[i] = Math.floor(Math.random() * 256);
+    }
+  }
+  let value = 0n;
+  for (const byte of payload) {
+    value = value << 8n | BigInt(byte);
+  }
+  let encoded = "";
+  while (value > 0n) {
+    encoded = BASE62[Number(value % 62n)] + encoded;
+    value = value / 62n;
+  }
+  return encoded.padStart(27, "0");
+}
+function generatePrefixedKSUID(prefix) {
+  return `${prefix}_${generateKSUID()}`;
+}
+
 // src/lib/api.ts
 var API_BASE_URL = (() => {
   try {
@@ -325,9 +363,7 @@ function getOnrampSessionStartUrl(request, publishableKey) {
   if (request.subdivision_code) {
     params.append("subdivision_code", request.subdivision_code);
   }
-  if (request.external_id) {
-    params.append("external_id", request.external_id);
-  }
+  params.append("external_id", request.external_id ?? generatePrefixedKSUID("ors"));
   if (request.email) {
     params.append("email", request.email);
   }
@@ -438,6 +474,40 @@ async function getAddressBalances(address, chainType, publishableKey) {
   const data = await response.json();
   return data;
 }
+async function getExternalWallets(publishableKey) {
+  const pk = publishableKey || DEFAULT_PUBLISHABLE_KEY;
+  validatePublishableKey(pk);
+  const response = await fetch(`${API_BASE_URL}/v1/public/external_wallets`, {
+    method: "GET",
+    headers: {
+      accept: "application/json",
+      "x-publishable-key": pk
+    }
+  });
+  if (!response.ok) {
+    throw new Error(`Failed to fetch external wallets: ${response.statusText}`);
+  }
+  const data = await response.json();
+  return data;
+}
+async function getWalletMobileDeepLink(wallet, depositAddresses, publishableKey) {
+  const pk = publishableKey || DEFAULT_PUBLISHABLE_KEY;
+  validatePublishableKey(pk);
+  const response = await fetch(`${API_BASE_URL}/v1/public/external_wallets/mobile_deeplink`, {
+    method: "POST",
+    headers: {
+      "Content-Type": "application/json",
+      accept: "application/json",
+      "x-publishable-key": pk
+    },
+    body: JSON.stringify({ wallet, deposit_addresses: depositAddresses })
+  });
+  if (!response.ok) {
+    throw new Error(`Failed to generate wallet deep link: ${response.statusText}`);
+  }
+  const data = await response.json();
+  return data;
+}
 async function getAddressBalance(address, chainType, chainId, tokenAddress, publishableKey) {
   const pk = publishableKey || DEFAULT_PUBLISHABLE_KEY;
   validatePublishableKey(pk);
@@ -562,9 +632,7 @@ function getExchangeSessionStartUrl(request, publishableKey) {
   if (request.source_amount) {
     params.append("source_amount", request.source_amount);
   }
-  if (request.external_id) {
-    params.append("external_id", request.external_id);
-  }
+  params.append("external_id", request.external_id ?? generatePrefixedKSUID("exc"));
   return `${API_BASE_URL}/v1/public/onramps/exchanges/sessions/start?${params.toString()}`;
 }
 async function getIntegrationExchanges(publishableKey) {
@@ -945,42 +1013,6 @@ async function sendHypercoreTransaction(request, publishableKey) {
   return response.json();
 }
 
-// src/lib/utils.ts
-function formatStablecoinAmount(baseUnits, decimals) {
-  const raw = Number(baseUnits) / 10 ** decimals;
-  const floored = Math.floor(raw * 100) / 100;
-  const ceiled = raw > floored ? floored + 0.01 : raw;
-  return ceiled.toFixed(2);
-}
-function generatePrefixedKSUID(prefix) {
-  const BASE62 = "0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz";
-  const KSUID_EPOCH = 14e8;
-  const timestampSeconds = Math.floor(Date.now() / 1e3) - KSUID_EPOCH;
-  const payload = new Uint8Array(20);
-  payload[0] = timestampSeconds >>> 24 & 255;
-  payload[1] = timestampSeconds >>> 16 & 255;
-  payload[2] = timestampSeconds >>> 8 & 255;
-  payload[3] = timestampSeconds & 255;
-  if (typeof crypto !== "undefined" && crypto.getRandomValues) {
-    crypto.getRandomValues(payload.subarray(4));
-  } else {
-    for (let i = 4; i < 20; i++) {
-      payload[i] = Math.floor(Math.random() * 256);
-    }
-  }
-  let value = 0n;
-  for (const byte of payload) {
-    value = value << 8n | BigInt(byte);
-  }
-  let encoded = "";
-  while (value > 0n) {
-    encoded = BASE62[Number(value % 62n)] + encoded;
-    value = value / 62n;
-  }
-  encoded = encoded.padStart(27, "0");
-  return `${prefix}_${encoded}`;
-}
-
 // src/lib/events.ts
 var DepositEventType = /* @__PURE__ */ ((DepositEventType2) => {
   DepositEventType2["ONRAMP_SESSION_CREATED"] = "onramp_session.created";
@@ -1136,6 +1168,7 @@ export {
   createIntegrationTransfer,
   createOnrampSession,
   formatStablecoinAmount,
+  generateKSUID,
   generatePrefixedKSUID,
   getAddressBalance,
   getAddressBalances,
@@ -1148,6 +1181,7 @@ export {
   getDepositQuote,
   getExchangeSessionStartUrl,
   getExchanges,
+  getExternalWallets,
   getFiatCurrencies,
   getIconUrl,
   getIconUrlWithCdn,
@@ -1164,6 +1198,7 @@ export {
   getTokenChains,
   getTokenMetadata,
   getWalletByChainType,
+  getWalletMobileDeepLink,
   i18n,
   listPaymentIntentExecutions,
   pollDirectExecutions,

package/package.json

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