@unifold/core 0.1.74 → 0.1.75

package/dist/index.d.mts

@@ -587,6 +587,12 @@ interface DefaultTokenResponse {
 declare function getDefaultOnrampToken(params: {
     country_code?: string;
     subdivision_code?: string;
+    /**
+     * Service provider the default token will be used with (e.g. binancepay).
+     * Reserved for provider-aware defaults — accepted but not used in
+     * resolution yet.
+     */
+    service_provider?: string;
     token_address: string;
     chain_id: string;
     chain_type: string;
@@ -953,6 +959,15 @@ interface ExchangeProviderInfo {
     enabled: boolean;
     supported_networks: string[];
     supported_currencies: string[];
+    /**
+     * The exchange's own minimum order in USD, or null when it sets none.
+     *
+     * Not a deposit minimum: `/supported_deposit_tokens` carries that per chain,
+     * and the two are independent, so an amount screen gates on whichever is
+     * higher. Undefined against API deployments that predate the field, which
+     * reads the same as "no floor of its own".
+     */
+    minimum_amount_usd?: number | null;
 }
 interface ExchangeProvidersResponse {
     data: ExchangeProviderInfo[];
@@ -982,6 +997,17 @@ interface CreateExchangeSessionRequest {
     source_currency?: string;
     source_amount?: string;
     external_id?: string;
+    /**
+     * ISO 3166-1 alpha-2 country code of the user. Recorded on the session, and
+     * required by some redirect providers (e.g. Binance Pay via Meld).
+     */
+    country_code?: string;
+    /**
+     * State/subdivision code (e.g. CA). Recorded on the session, and worth sending
+     * whenever it is known: no exchange provider reports a subdivision back, so
+     * this is the only way the session can carry one.
+     */
+    subdivision_code?: string;
 }
 interface CreateExchangeSessionResponse {
     url: string;
@@ -994,6 +1020,37 @@ interface CreateExchangeSessionResponse {
  * @param publishableKey - Optional publishable key, defaults to configured key
  */
 declare function createExchangeSession(request: CreateExchangeSessionRequest, publishableKey?: string): Promise<CreateExchangeSessionResponse>;
+/**
+ * Where the provider says an onramp session has got to.
+ *
+ * - `pending`    — the provider has no transaction for this session yet (the
+ *                  user hasn't paid, or hasn't finished paying).
+ * - `processing` — payment taken, crypto on its way.
+ * - `completed`  — the provider has sent the crypto.
+ * - `failed`     — the payment or the delivery failed.
+ * - `expired`    — the session timed out before it was paid.
+ * - `unknown`    — we couldn't reach the provider. Not a verdict; retry.
+ */
+type OnrampSessionStatusValue = 'pending' | 'processing' | 'completed' | 'failed' | 'expired' | 'unknown';
+interface OnrampSessionStatusResponse {
+    status: OnrampSessionStatusValue;
+    /** Crypto delivered, once the provider reports it. */
+    destination_amount?: string;
+    /** Fiat charged, once the provider reports it. */
+    source_amount?: string;
+    source_currency?: string;
+    transaction_hash?: string;
+}
+/**
+ * Read an onramp session's status from its provider, by the `external_id` the
+ * session was created with. Polls transfer sessions rendered as a QR or
+ * deeplink (Binance Pay) and device-wallet orders paid on another device.
+ *
+ * This is the only channel that reports a *payment* — the deposit poller sees
+ * crypto arriving on-chain, which is a later and different event, and never
+ * arrives at all if the payment failed.
+ */
+declare function getOnrampSessionStatus(externalId: string, publishableKey?: string, signal?: AbortSignal): Promise<OnrampSessionStatusResponse>;
 interface ExchangeSessionStartParams {
     service_provider: string;
     chain_type: string;
@@ -1003,12 +1060,31 @@ interface ExchangeSessionStartParams {
     source_currency?: string;
     source_amount?: string;
     external_id?: string;
+    /** ISO 3166-1 alpha-2 country code of the user. Recorded on the session. */
+    country_code?: string;
+    /**
+     * State/subdivision code (e.g. CA). Recorded on the session, and the only
+     * source for it — no exchange provider reports a subdivision back.
+     */
+    subdivision_code?: 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;
+/**
+ * How a Connect Exchange provider completes the transfer:
+ * - 'oauth': full account connection (holdings/amount/confirm in-app)
+ * - 'redirect': redirect/QR-style payment completed inside the exchange
+ *   (e.g. Binance Pay, or Coinbase in regions without OAuth). Named
+ *   'redirect' — not 'link' — to avoid confusion with Stripe Link.
+ *
+ * The server resolves this per provider per request, so clients should branch
+ * on this field rather than hardcoding provider names. Older API versions omit
+ * the field; treat undefined as 'oauth'.
+ */
+type IntegrationConnectionMethod = 'oauth' | 'redirect';
 interface IntegrationExchangeInfo {
     service_provider: string;
     service_provider_display_name: string;
@@ -1016,17 +1092,57 @@ interface IntegrationExchangeInfo {
     icon_url: string;
     icon_urls: IconUrl[];
     enabled: boolean;
+    connection_method?: IntegrationConnectionMethod;
     supported_networks: string[];
     supported_currencies: string[];
+    /**
+     * The exchange's own minimum order in USD, or null when it sets none.
+     *
+     * Not a deposit minimum: `/supported_deposit_tokens` carries that per chain,
+     * and the two are independent, so an amount screen gates on whichever is
+     * higher. Undefined against API deployments that predate the field, which
+     * reads the same as "no floor of its own".
+     */
+    minimum_amount_usd?: number | null;
 }
 interface IntegrationExchangesResponse {
     data: IntegrationExchangeInfo[];
 }
+interface GetIntegrationExchangesQuery {
+    /**
+     * ISO 3166-1 alpha-2 country code of the user. Lets the server apply
+     * region-based connection method overrides (e.g. Coinbase redirect flow in
+     * regions without OAuth).
+     */
+    country_code?: string;
+    /**
+     * State/subdivision code of the user (e.g. CA). Reserved for state-level
+     * connection-method/enablement control server-side.
+     */
+    subdivision_code?: string;
+}
+/**
+ * Get the exchanges available from the Connect Exchange entrypoint
+ * (Coinbase, Binance, Kraken, etc.).
+ * Returns provider info with icons, enabled status, connection_method
+ * ('oauth' or 'redirect'), and supported networks/currencies.
+ */
+declare function getIntegrationExchanges(publishableKey?: string, query?: GetIntegrationExchangesQuery): Promise<IntegrationExchangesResponse>;
+type CreateIntegrationExchangeSessionRequest = CreateExchangeSessionRequest;
+type CreateIntegrationExchangeSessionResponse = CreateExchangeSessionResponse;
+type IntegrationExchangeSessionStartParams = ExchangeSessionStartParams;
+/**
+ * Create a redirect-based exchange payment session for a Connect Exchange
+ * provider whose connection_method is 'redirect'.
+ * Returns a URL that opens the exchange with the deposit address pre-filled.
+ */
+declare function createIntegrationExchangeSession(request: CreateIntegrationExchangeSessionRequest, publishableKey?: string): Promise<CreateIntegrationExchangeSessionResponse>;
 /**
- * Get available integration OAuth exchanges (Coinbase, Binance, Kraken, etc.)
- * Returns provider info with icons, enabled status, and supported networks/currencies.
+ * Generate a URL for the integrations exchanges/sessions/start endpoint that
+ * redirects (302) to the exchange provider. Opening this URL directly via
+ * anchor tag or window.open() avoids popup blockers in Safari.
  */
-declare function getIntegrationExchanges(publishableKey?: string): Promise<IntegrationExchangesResponse>;
+declare function getIntegrationExchangeSessionStartUrl(request: IntegrationExchangeSessionStartParams, publishableKey: string): string;
 interface StartIntegrationOAuthResult {
     redirect_url: string;
     state: string;
@@ -3153,4 +3269,4 @@ declare const i18n: {
 };
 type I18nStrings = typeof i18n;
 
-export { type AccountConnectionData, ActionType, type AddressBalanceResponse, type AddressBalancesResponse, type AddressValidationFailureCode, type AddressValidationMetadata, type AddressVerification, type ApplePayLimitUpgradeStatus, type ApplePayProvider, type ApplePayProvidersResponse, type AuthenticateOAuthResult, type AutoSwapRequest, type AutoSwapResponse, type BankTransferConfig, type BankTransferProvider, type BankTransferProvidersResponse, type BlockedCountrySubdivision, type BuildHypercoreTransactionRequest, type BuildHypercoreTransactionResponse, type BuildSolanaTransactionRequest, type BuildSolanaTransactionResponse, type CashAppLimits, type CashAppSessionRequest, type CashAppSessionResponse, type CashAppSessionStatusResponse, type ChainType, type CheckoutEvent, CheckoutEventType, type CheckoutFlowFailedData, type CheckoutFlowStartedData, type CheckoutMethod, type CheckoutMethodSelectedData, type CheckoutPaymentIntent, type CheckoutPaymentIntentData, type CheckoutPaymentIntentSucceededEvent, type CoinbaseApplePayLimit, type CoinbaseApplePayLimitUpgradeOption, type CoinbaseApplePayLimitsResponse, type CoinbaseApplePaySessionResponse, type CoinbaseGooglePaySessionResponse, type CoinbaseLegalAgreement, type CoinbaseLegalAgreementsResponse, type CoinbaseWalletPayLimit, type CoinbaseWalletPayLimitUpgradeOption, type CoinbaseWalletPayLimitsResponse, type CoinbaseWalletPaySessionResponse, type ConfirmIntegrationTransferResult, type CreateCoinbaseApplePaySessionRequest, type CreateCoinbaseGooglePaySessionRequest, type CreateCoinbaseWalletPaySessionRequest, type CreateDepositAddressRequest, type CreateExchangeSessionRequest, type CreateExchangeSessionResponse, type CreateIntegrationTransferParams, type CreateIntegrationTransferResult, type CreateOnrampVerificationSessionRequest, DETECTION_ARM_DELAY_MS, DETECTION_POLL_INTERVAL_MS, type DefaultTokenChain, type DefaultTokenMetadata, type DefaultTokenResponse, type DepositAddress, type DepositAddressParams, type DepositAddressResponse, DepositAddressValidationError, type DepositEvent, DepositEventType, type DepositFlowFailedData, type DepositFlowStartedData, type DepositLimitReachedData, type DepositMethod, type DepositMethodSelectedData, type DepositQuote, type DepositQuoteRequest, DepositSession, type DepositSessionConfig, type DepositSessionDestination, type DepositSessionError, type DepositSessionErrorCode, type DepositSessionEvent, type DepositSessionEventMap, DepositSessionEventType, type DepositSessionParams, type DepositSessionSnapshot, type DepositSessionStatus, DepositSessionWaitError, type DepositSessionWaitErrorCode, type DepositSessionWaitOptions, type DestinationToken, type DestinationTokenChain, type DirectExecution, type DirectExecutionFailedEvent, type DirectExecutionResponse, type DirectExecutionSucceededEvent, 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 GetBankTransferProvidersOptions, type GetExchangesQuery, type GooglePayProvider, type GooglePayProvidersResponse, type HypercoreActivationRequest, type HypercoreActivationResponse, type I18nStrings, type IconUrl, IneligibilityReason, type IntegrationAccount, type IntegrationExchangeInfo, type IntegrationExchangesResponse, type IntegrationFeeAmount, type IntegrationHoldingsResponse, IntegrationProvider, IntegrationTransferError, type IntegrationTransferErrorType, type IpAddressResponse, LOOKBACK_MS, type ListExecutionsParams, type LockedQuoteLimits, type LockedQuotePreview, type LockedQuotePreviewRequest, type OnrampQuote, type OnrampQuotesRequest, type OnrampQuotesResponse, type OnrampSessionCreatedData, type OnrampSessionCreatedEvent, type OnrampSessionPaymentMethod, type OnrampSessionPaymentMethodType, type OnrampSessionRequest, type OnrampSessionResponse, type OnrampVerificationFactor, type OnrampVerificationFactorStatus, type OnrampVerificationSession, type OnrampVerificationStatus, type OnrampVerificationTokenResponse, type PaymentIntent, type PaymentIntentDepositAddress, type PaymentIntentExecutionsResponse, type PaymentIntentStatus, type PaymentIntentType, type PaymentNetwork, type PollExecutionsRequest, type PollExecutionsResponse, type ProductType, type ProjectConfigResponse, type ProviderSelectedData, type PublicIncidentResponse, type QueryExecutionsRequest, type QueryExecutionsResponse, type RefreshIntegrationTokenResult, type RequestCoinbaseApplePayLimitUpgradeRequest, type RequestCoinbaseApplePayLimitUpgradeResponse, type RequestCoinbaseWalletPayLimitUpgradeRequest, type RequestCoinbaseWalletPayLimitUpgradeResponse, SCAN_NUDGE_INTERVAL_MS, SOLANA_USDC_ADDRESS, type SendHypercoreTransactionRequest, type SendHypercoreTransactionResponse, type SendSolanaTransactionRequest, type SendSolanaTransactionResponse, type SourceToken, type SourceTokenNetwork, type StartIntegrationOAuthResult, type StripeAccessTokenResponse, StripeApiResponseError, type StripeAuthIntentResponse, type StripeConfigResponse, type StripeConfirmRequest, type StripeConsumerWallet, type StripeCreateSessionRequest, type StripeCryptoCustomer, type StripeCustomerVerification, type StripeDefaultTokenResponse, type StripeListResponse, type StripeOnrampErrorType, type StripeOnrampSession, type StripeOnrampTransactionDetails, type StripePaymentToken, type StripeQuoteRequest, type StripeQuotesResponse, type StripeTransactionLimitEntry, type StripeTransactionLimitsResponse, type SupportedChain, type SupportedDepositTokensParams, type SupportedDepositTokensResponse, type SupportedDestinationTokensResponse, type SupportedSourceTokensQuery, type SupportedSourceTokensResponse, type SupportedToken, type TokenBalance, type TokenChain, type TokenChainIconUrl, type TokenChainsResponse, type TokenDisplayMetadata, type TokenIconUrl, type TokenInfo, type TokenMetadata, type TokenSelectedData, type TransferDefaultTokenParams, type TransferDefaultTokenResult, UnifoldClient, type UnifoldClientOptions, type UserIpInfo, type VerificationData, type VerifyAddressParams, type VerifyAddressRequest, type VerifyAddressResponse, type Wallet, type WalletConnectionData, type WalletMobileDeepLinkDepositAddress, type WalletMobileDeepLinkResponse, type WalletMobileDeepLinkWallet, type WalletPayLimitUpgradeStatus, type WalletPayMethod, type WalletPayProvider, type WalletPayProvidersResponse, type WalletSelectedData, type WithdrawDirectExecutionFailedEvent, type WithdrawDirectExecutionSucceededEvent, type WithdrawEvent, WithdrawEventType, type WithdrawFlowStartedData, authenticateIntegrationOAuth, buildHypercoreTransaction, buildSolanaTransaction, checkHypercoreActivation, confirmIntegrationTransfer, createCashAppSession, createCoinbaseApplePaySession, createCoinbaseGooglePaySession, createCoinbaseWalletPaySession, createDepositAddress, createExchangeSession, createIntegrationTransfer, createOnrampSession, createOnrampVerificationSession, createUnifoldClient, exchangeOnrampVerificationToken, formatStablecoinAmount, generateKSUID, generatePrefixedKSUID, getAddressBalance, getAddressBalances, getApiBaseUrl, getApplePayLimitUpgradeStatus, getApplePayProviders, getBankTransferProviders, getCashAppLimits, getCashAppSessionStatus, getChainName, getCoinbaseApplePayLimits, getCoinbaseLegalAgreements, getCoinbaseWalletPayLimits, getDefaultOnrampToken, getDepositAddress, getDepositQuote, getExchangeSessionStartUrl, getExchanges, getExternalWallets, getFiatCurrencies, getFiatExchangeRates, getGooglePayLimitUpgradeStatus, getGooglePayProviders, getIconUrl, getIconUrlWithCdn, getIntegrationExchanges, getIntegrationHoldings, getIntegrationTransferDefaultToken, getIpAddress, getOnrampQuotes, getOnrampSessionStartUrl, getOnrampVerificationSession, getPreferredIconUrl, getProjectConfig, getPublicIncident, getSupportedDepositTokens, getSupportedDestinationTokens, getTokenChains, getTokenMetadata, getWalletByChainType, getWalletMobileDeepLink, getWalletPayLimitUpgradeStatus, getWalletPayProviders, i18n, isApplePayLimitReached, isDepositAddressValidationError, isGooglePayLimitReached, isWalletPayLimitReached, listPaymentIntentExecutions, mapDirectExecution, mapWalletToDepositAddress, pollDirectExecutions, queryExecutions, refreshIntegrationToken, requestCoinbaseApplePayLimitUpgrade, requestCoinbaseWalletPayLimitUpgrade, retrievePaymentIntent, revokeIntegrationToken, sendHypercoreTransaction, sendOnrampVerificationOtp, sendSolanaTransaction, setApiConfig, startIntegrationOAuth, stripeConfirmSession, stripeCreateAuthIntent, stripeCreateSession, stripeExchangeTokens, stripeGetConfig, stripeGetCustomer, stripeGetDefaultToken, stripeGetQuotes, stripeGetSession, stripeGetTransactionLimits, stripeListPaymentTokens, stripeListWallets, stripeRefreshQuote, stripeRefreshToken, useUserIp, verifyOnrampVerificationOtp, verifyRecipientAddress };
+export { type AccountConnectionData, ActionType, type AddressBalanceResponse, type AddressBalancesResponse, type AddressValidationFailureCode, type AddressValidationMetadata, type AddressVerification, type ApplePayLimitUpgradeStatus, type ApplePayProvider, type ApplePayProvidersResponse, type AuthenticateOAuthResult, type AutoSwapRequest, type AutoSwapResponse, type BankTransferConfig, type BankTransferProvider, type BankTransferProvidersResponse, type BlockedCountrySubdivision, type BuildHypercoreTransactionRequest, type BuildHypercoreTransactionResponse, type BuildSolanaTransactionRequest, type BuildSolanaTransactionResponse, type CashAppLimits, type CashAppSessionRequest, type CashAppSessionResponse, type CashAppSessionStatusResponse, type ChainType, type CheckoutEvent, CheckoutEventType, type CheckoutFlowFailedData, type CheckoutFlowStartedData, type CheckoutMethod, type CheckoutMethodSelectedData, type CheckoutPaymentIntent, type CheckoutPaymentIntentData, type CheckoutPaymentIntentSucceededEvent, type CoinbaseApplePayLimit, type CoinbaseApplePayLimitUpgradeOption, type CoinbaseApplePayLimitsResponse, type CoinbaseApplePaySessionResponse, type CoinbaseGooglePaySessionResponse, type CoinbaseLegalAgreement, type CoinbaseLegalAgreementsResponse, type CoinbaseWalletPayLimit, type CoinbaseWalletPayLimitUpgradeOption, type CoinbaseWalletPayLimitsResponse, type CoinbaseWalletPaySessionResponse, type ConfirmIntegrationTransferResult, type CreateCoinbaseApplePaySessionRequest, type CreateCoinbaseGooglePaySessionRequest, type CreateCoinbaseWalletPaySessionRequest, type CreateDepositAddressRequest, type CreateExchangeSessionRequest, type CreateExchangeSessionResponse, type CreateIntegrationExchangeSessionRequest, type CreateIntegrationExchangeSessionResponse, type CreateIntegrationTransferParams, type CreateIntegrationTransferResult, type CreateOnrampVerificationSessionRequest, DETECTION_ARM_DELAY_MS, DETECTION_POLL_INTERVAL_MS, type DefaultTokenChain, type DefaultTokenMetadata, type DefaultTokenResponse, type DepositAddress, type DepositAddressParams, type DepositAddressResponse, DepositAddressValidationError, type DepositEvent, DepositEventType, type DepositFlowFailedData, type DepositFlowStartedData, type DepositLimitReachedData, type DepositMethod, type DepositMethodSelectedData, type DepositQuote, type DepositQuoteRequest, DepositSession, type DepositSessionConfig, type DepositSessionDestination, type DepositSessionError, type DepositSessionErrorCode, type DepositSessionEvent, type DepositSessionEventMap, DepositSessionEventType, type DepositSessionParams, type DepositSessionSnapshot, type DepositSessionStatus, DepositSessionWaitError, type DepositSessionWaitErrorCode, type DepositSessionWaitOptions, type DestinationToken, type DestinationTokenChain, type DirectExecution, type DirectExecutionFailedEvent, type DirectExecutionResponse, type DirectExecutionSucceededEvent, 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 GetBankTransferProvidersOptions, type GetExchangesQuery, type GetIntegrationExchangesQuery, type GooglePayProvider, type GooglePayProvidersResponse, type HypercoreActivationRequest, type HypercoreActivationResponse, type I18nStrings, type IconUrl, IneligibilityReason, type IntegrationAccount, type IntegrationConnectionMethod, type IntegrationExchangeInfo, type IntegrationExchangeSessionStartParams, type IntegrationExchangesResponse, type IntegrationFeeAmount, type IntegrationHoldingsResponse, IntegrationProvider, IntegrationTransferError, type IntegrationTransferErrorType, type IpAddressResponse, LOOKBACK_MS, type ListExecutionsParams, type LockedQuoteLimits, type LockedQuotePreview, type LockedQuotePreviewRequest, type OnrampQuote, type OnrampQuotesRequest, type OnrampQuotesResponse, type OnrampSessionCreatedData, type OnrampSessionCreatedEvent, type OnrampSessionPaymentMethod, type OnrampSessionPaymentMethodType, type OnrampSessionRequest, type OnrampSessionResponse, type OnrampSessionStatusResponse, type OnrampSessionStatusValue, type OnrampVerificationFactor, type OnrampVerificationFactorStatus, type OnrampVerificationSession, type OnrampVerificationStatus, type OnrampVerificationTokenResponse, type PaymentIntent, type PaymentIntentDepositAddress, type PaymentIntentExecutionsResponse, type PaymentIntentStatus, type PaymentIntentType, type PaymentNetwork, type PollExecutionsRequest, type PollExecutionsResponse, type ProductType, type ProjectConfigResponse, type ProviderSelectedData, type PublicIncidentResponse, type QueryExecutionsRequest, type QueryExecutionsResponse, type RefreshIntegrationTokenResult, type RequestCoinbaseApplePayLimitUpgradeRequest, type RequestCoinbaseApplePayLimitUpgradeResponse, type RequestCoinbaseWalletPayLimitUpgradeRequest, type RequestCoinbaseWalletPayLimitUpgradeResponse, SCAN_NUDGE_INTERVAL_MS, SOLANA_USDC_ADDRESS, type SendHypercoreTransactionRequest, type SendHypercoreTransactionResponse, type SendSolanaTransactionRequest, type SendSolanaTransactionResponse, type SourceToken, type SourceTokenNetwork, type StartIntegrationOAuthResult, type StripeAccessTokenResponse, StripeApiResponseError, type StripeAuthIntentResponse, type StripeConfigResponse, type StripeConfirmRequest, type StripeConsumerWallet, type StripeCreateSessionRequest, type StripeCryptoCustomer, type StripeCustomerVerification, type StripeDefaultTokenResponse, type StripeListResponse, type StripeOnrampErrorType, type StripeOnrampSession, type StripeOnrampTransactionDetails, type StripePaymentToken, type StripeQuoteRequest, type StripeQuotesResponse, type StripeTransactionLimitEntry, type StripeTransactionLimitsResponse, type SupportedChain, type SupportedDepositTokensParams, type SupportedDepositTokensResponse, type SupportedDestinationTokensResponse, type SupportedSourceTokensQuery, type SupportedSourceTokensResponse, type SupportedToken, type TokenBalance, type TokenChain, type TokenChainIconUrl, type TokenChainsResponse, type TokenDisplayMetadata, type TokenIconUrl, type TokenInfo, type TokenMetadata, type TokenSelectedData, type TransferDefaultTokenParams, type TransferDefaultTokenResult, UnifoldClient, type UnifoldClientOptions, type UserIpInfo, type VerificationData, type VerifyAddressParams, type VerifyAddressRequest, type VerifyAddressResponse, type Wallet, type WalletConnectionData, type WalletMobileDeepLinkDepositAddress, type WalletMobileDeepLinkResponse, type WalletMobileDeepLinkWallet, type WalletPayLimitUpgradeStatus, type WalletPayMethod, type WalletPayProvider, type WalletPayProvidersResponse, type WalletSelectedData, type WithdrawDirectExecutionFailedEvent, type WithdrawDirectExecutionSucceededEvent, type WithdrawEvent, WithdrawEventType, type WithdrawFlowStartedData, authenticateIntegrationOAuth, buildHypercoreTransaction, buildSolanaTransaction, checkHypercoreActivation, confirmIntegrationTransfer, createCashAppSession, createCoinbaseApplePaySession, createCoinbaseGooglePaySession, createCoinbaseWalletPaySession, createDepositAddress, createExchangeSession, createIntegrationExchangeSession, createIntegrationTransfer, createOnrampSession, createOnrampVerificationSession, createUnifoldClient, exchangeOnrampVerificationToken, formatStablecoinAmount, generateKSUID, generatePrefixedKSUID, getAddressBalance, getAddressBalances, getApiBaseUrl, getApplePayLimitUpgradeStatus, getApplePayProviders, getBankTransferProviders, getCashAppLimits, getCashAppSessionStatus, getChainName, getCoinbaseApplePayLimits, getCoinbaseLegalAgreements, getCoinbaseWalletPayLimits, getDefaultOnrampToken, getDepositAddress, getDepositQuote, getExchangeSessionStartUrl, getExchanges, getExternalWallets, getFiatCurrencies, getFiatExchangeRates, getGooglePayLimitUpgradeStatus, getGooglePayProviders, getIconUrl, getIconUrlWithCdn, getIntegrationExchangeSessionStartUrl, getIntegrationExchanges, getIntegrationHoldings, getIntegrationTransferDefaultToken, getIpAddress, getOnrampQuotes, getOnrampSessionStartUrl, getOnrampSessionStatus, getOnrampVerificationSession, getPreferredIconUrl, getProjectConfig, getPublicIncident, getSupportedDepositTokens, getSupportedDestinationTokens, getTokenChains, getTokenMetadata, getWalletByChainType, getWalletMobileDeepLink, getWalletPayLimitUpgradeStatus, getWalletPayProviders, i18n, isApplePayLimitReached, isDepositAddressValidationError, isGooglePayLimitReached, isWalletPayLimitReached, listPaymentIntentExecutions, mapDirectExecution, mapWalletToDepositAddress, pollDirectExecutions, queryExecutions, refreshIntegrationToken, requestCoinbaseApplePayLimitUpgrade, requestCoinbaseWalletPayLimitUpgrade, retrievePaymentIntent, revokeIntegrationToken, sendHypercoreTransaction, sendOnrampVerificationOtp, sendSolanaTransaction, setApiConfig, startIntegrationOAuth, stripeConfirmSession, stripeCreateAuthIntent, stripeCreateSession, stripeExchangeTokens, stripeGetConfig, stripeGetCustomer, stripeGetDefaultToken, stripeGetQuotes, stripeGetSession, stripeGetTransactionLimits, stripeListPaymentTokens, stripeListWallets, stripeRefreshQuote, stripeRefreshToken, useUserIp, verifyOnrampVerificationOtp, verifyRecipientAddress };

package/dist/index.d.ts

@@ -587,6 +587,12 @@ interface DefaultTokenResponse {
 declare function getDefaultOnrampToken(params: {
     country_code?: string;
     subdivision_code?: string;
+    /**
+     * Service provider the default token will be used with (e.g. binancepay).
+     * Reserved for provider-aware defaults — accepted but not used in
+     * resolution yet.
+     */
+    service_provider?: string;
     token_address: string;
     chain_id: string;
     chain_type: string;
@@ -953,6 +959,15 @@ interface ExchangeProviderInfo {
     enabled: boolean;
     supported_networks: string[];
     supported_currencies: string[];
+    /**
+     * The exchange's own minimum order in USD, or null when it sets none.
+     *
+     * Not a deposit minimum: `/supported_deposit_tokens` carries that per chain,
+     * and the two are independent, so an amount screen gates on whichever is
+     * higher. Undefined against API deployments that predate the field, which
+     * reads the same as "no floor of its own".
+     */
+    minimum_amount_usd?: number | null;
 }
 interface ExchangeProvidersResponse {
     data: ExchangeProviderInfo[];
@@ -982,6 +997,17 @@ interface CreateExchangeSessionRequest {
     source_currency?: string;
     source_amount?: string;
     external_id?: string;
+    /**
+     * ISO 3166-1 alpha-2 country code of the user. Recorded on the session, and
+     * required by some redirect providers (e.g. Binance Pay via Meld).
+     */
+    country_code?: string;
+    /**
+     * State/subdivision code (e.g. CA). Recorded on the session, and worth sending
+     * whenever it is known: no exchange provider reports a subdivision back, so
+     * this is the only way the session can carry one.
+     */
+    subdivision_code?: string;
 }
 interface CreateExchangeSessionResponse {
     url: string;
@@ -994,6 +1020,37 @@ interface CreateExchangeSessionResponse {
  * @param publishableKey - Optional publishable key, defaults to configured key
  */
 declare function createExchangeSession(request: CreateExchangeSessionRequest, publishableKey?: string): Promise<CreateExchangeSessionResponse>;
+/**
+ * Where the provider says an onramp session has got to.
+ *
+ * - `pending`    — the provider has no transaction for this session yet (the
+ *                  user hasn't paid, or hasn't finished paying).
+ * - `processing` — payment taken, crypto on its way.
+ * - `completed`  — the provider has sent the crypto.
+ * - `failed`     — the payment or the delivery failed.
+ * - `expired`    — the session timed out before it was paid.
+ * - `unknown`    — we couldn't reach the provider. Not a verdict; retry.
+ */
+type OnrampSessionStatusValue = 'pending' | 'processing' | 'completed' | 'failed' | 'expired' | 'unknown';
+interface OnrampSessionStatusResponse {
+    status: OnrampSessionStatusValue;
+    /** Crypto delivered, once the provider reports it. */
+    destination_amount?: string;
+    /** Fiat charged, once the provider reports it. */
+    source_amount?: string;
+    source_currency?: string;
+    transaction_hash?: string;
+}
+/**
+ * Read an onramp session's status from its provider, by the `external_id` the
+ * session was created with. Polls transfer sessions rendered as a QR or
+ * deeplink (Binance Pay) and device-wallet orders paid on another device.
+ *
+ * This is the only channel that reports a *payment* — the deposit poller sees
+ * crypto arriving on-chain, which is a later and different event, and never
+ * arrives at all if the payment failed.
+ */
+declare function getOnrampSessionStatus(externalId: string, publishableKey?: string, signal?: AbortSignal): Promise<OnrampSessionStatusResponse>;
 interface ExchangeSessionStartParams {
     service_provider: string;
     chain_type: string;
@@ -1003,12 +1060,31 @@ interface ExchangeSessionStartParams {
     source_currency?: string;
     source_amount?: string;
     external_id?: string;
+    /** ISO 3166-1 alpha-2 country code of the user. Recorded on the session. */
+    country_code?: string;
+    /**
+     * State/subdivision code (e.g. CA). Recorded on the session, and the only
+     * source for it — no exchange provider reports a subdivision back.
+     */
+    subdivision_code?: 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;
+/**
+ * How a Connect Exchange provider completes the transfer:
+ * - 'oauth': full account connection (holdings/amount/confirm in-app)
+ * - 'redirect': redirect/QR-style payment completed inside the exchange
+ *   (e.g. Binance Pay, or Coinbase in regions without OAuth). Named
+ *   'redirect' — not 'link' — to avoid confusion with Stripe Link.
+ *
+ * The server resolves this per provider per request, so clients should branch
+ * on this field rather than hardcoding provider names. Older API versions omit
+ * the field; treat undefined as 'oauth'.
+ */
+type IntegrationConnectionMethod = 'oauth' | 'redirect';
 interface IntegrationExchangeInfo {
     service_provider: string;
     service_provider_display_name: string;
@@ -1016,17 +1092,57 @@ interface IntegrationExchangeInfo {
     icon_url: string;
     icon_urls: IconUrl[];
     enabled: boolean;
+    connection_method?: IntegrationConnectionMethod;
     supported_networks: string[];
     supported_currencies: string[];
+    /**
+     * The exchange's own minimum order in USD, or null when it sets none.
+     *
+     * Not a deposit minimum: `/supported_deposit_tokens` carries that per chain,
+     * and the two are independent, so an amount screen gates on whichever is
+     * higher. Undefined against API deployments that predate the field, which
+     * reads the same as "no floor of its own".
+     */
+    minimum_amount_usd?: number | null;
 }
 interface IntegrationExchangesResponse {
     data: IntegrationExchangeInfo[];
 }
+interface GetIntegrationExchangesQuery {
+    /**
+     * ISO 3166-1 alpha-2 country code of the user. Lets the server apply
+     * region-based connection method overrides (e.g. Coinbase redirect flow in
+     * regions without OAuth).
+     */
+    country_code?: string;
+    /**
+     * State/subdivision code of the user (e.g. CA). Reserved for state-level
+     * connection-method/enablement control server-side.
+     */
+    subdivision_code?: string;
+}
+/**
+ * Get the exchanges available from the Connect Exchange entrypoint
+ * (Coinbase, Binance, Kraken, etc.).
+ * Returns provider info with icons, enabled status, connection_method
+ * ('oauth' or 'redirect'), and supported networks/currencies.
+ */
+declare function getIntegrationExchanges(publishableKey?: string, query?: GetIntegrationExchangesQuery): Promise<IntegrationExchangesResponse>;
+type CreateIntegrationExchangeSessionRequest = CreateExchangeSessionRequest;
+type CreateIntegrationExchangeSessionResponse = CreateExchangeSessionResponse;
+type IntegrationExchangeSessionStartParams = ExchangeSessionStartParams;
+/**
+ * Create a redirect-based exchange payment session for a Connect Exchange
+ * provider whose connection_method is 'redirect'.
+ * Returns a URL that opens the exchange with the deposit address pre-filled.
+ */
+declare function createIntegrationExchangeSession(request: CreateIntegrationExchangeSessionRequest, publishableKey?: string): Promise<CreateIntegrationExchangeSessionResponse>;
 /**
- * Get available integration OAuth exchanges (Coinbase, Binance, Kraken, etc.)
- * Returns provider info with icons, enabled status, and supported networks/currencies.
+ * Generate a URL for the integrations exchanges/sessions/start endpoint that
+ * redirects (302) to the exchange provider. Opening this URL directly via
+ * anchor tag or window.open() avoids popup blockers in Safari.
  */
-declare function getIntegrationExchanges(publishableKey?: string): Promise<IntegrationExchangesResponse>;
+declare function getIntegrationExchangeSessionStartUrl(request: IntegrationExchangeSessionStartParams, publishableKey: string): string;
 interface StartIntegrationOAuthResult {
     redirect_url: string;
     state: string;
@@ -3153,4 +3269,4 @@ declare const i18n: {
 };
 type I18nStrings = typeof i18n;
 
-export { type AccountConnectionData, ActionType, type AddressBalanceResponse, type AddressBalancesResponse, type AddressValidationFailureCode, type AddressValidationMetadata, type AddressVerification, type ApplePayLimitUpgradeStatus, type ApplePayProvider, type ApplePayProvidersResponse, type AuthenticateOAuthResult, type AutoSwapRequest, type AutoSwapResponse, type BankTransferConfig, type BankTransferProvider, type BankTransferProvidersResponse, type BlockedCountrySubdivision, type BuildHypercoreTransactionRequest, type BuildHypercoreTransactionResponse, type BuildSolanaTransactionRequest, type BuildSolanaTransactionResponse, type CashAppLimits, type CashAppSessionRequest, type CashAppSessionResponse, type CashAppSessionStatusResponse, type ChainType, type CheckoutEvent, CheckoutEventType, type CheckoutFlowFailedData, type CheckoutFlowStartedData, type CheckoutMethod, type CheckoutMethodSelectedData, type CheckoutPaymentIntent, type CheckoutPaymentIntentData, type CheckoutPaymentIntentSucceededEvent, type CoinbaseApplePayLimit, type CoinbaseApplePayLimitUpgradeOption, type CoinbaseApplePayLimitsResponse, type CoinbaseApplePaySessionResponse, type CoinbaseGooglePaySessionResponse, type CoinbaseLegalAgreement, type CoinbaseLegalAgreementsResponse, type CoinbaseWalletPayLimit, type CoinbaseWalletPayLimitUpgradeOption, type CoinbaseWalletPayLimitsResponse, type CoinbaseWalletPaySessionResponse, type ConfirmIntegrationTransferResult, type CreateCoinbaseApplePaySessionRequest, type CreateCoinbaseGooglePaySessionRequest, type CreateCoinbaseWalletPaySessionRequest, type CreateDepositAddressRequest, type CreateExchangeSessionRequest, type CreateExchangeSessionResponse, type CreateIntegrationTransferParams, type CreateIntegrationTransferResult, type CreateOnrampVerificationSessionRequest, DETECTION_ARM_DELAY_MS, DETECTION_POLL_INTERVAL_MS, type DefaultTokenChain, type DefaultTokenMetadata, type DefaultTokenResponse, type DepositAddress, type DepositAddressParams, type DepositAddressResponse, DepositAddressValidationError, type DepositEvent, DepositEventType, type DepositFlowFailedData, type DepositFlowStartedData, type DepositLimitReachedData, type DepositMethod, type DepositMethodSelectedData, type DepositQuote, type DepositQuoteRequest, DepositSession, type DepositSessionConfig, type DepositSessionDestination, type DepositSessionError, type DepositSessionErrorCode, type DepositSessionEvent, type DepositSessionEventMap, DepositSessionEventType, type DepositSessionParams, type DepositSessionSnapshot, type DepositSessionStatus, DepositSessionWaitError, type DepositSessionWaitErrorCode, type DepositSessionWaitOptions, type DestinationToken, type DestinationTokenChain, type DirectExecution, type DirectExecutionFailedEvent, type DirectExecutionResponse, type DirectExecutionSucceededEvent, 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 GetBankTransferProvidersOptions, type GetExchangesQuery, type GooglePayProvider, type GooglePayProvidersResponse, type HypercoreActivationRequest, type HypercoreActivationResponse, type I18nStrings, type IconUrl, IneligibilityReason, type IntegrationAccount, type IntegrationExchangeInfo, type IntegrationExchangesResponse, type IntegrationFeeAmount, type IntegrationHoldingsResponse, IntegrationProvider, IntegrationTransferError, type IntegrationTransferErrorType, type IpAddressResponse, LOOKBACK_MS, type ListExecutionsParams, type LockedQuoteLimits, type LockedQuotePreview, type LockedQuotePreviewRequest, type OnrampQuote, type OnrampQuotesRequest, type OnrampQuotesResponse, type OnrampSessionCreatedData, type OnrampSessionCreatedEvent, type OnrampSessionPaymentMethod, type OnrampSessionPaymentMethodType, type OnrampSessionRequest, type OnrampSessionResponse, type OnrampVerificationFactor, type OnrampVerificationFactorStatus, type OnrampVerificationSession, type OnrampVerificationStatus, type OnrampVerificationTokenResponse, type PaymentIntent, type PaymentIntentDepositAddress, type PaymentIntentExecutionsResponse, type PaymentIntentStatus, type PaymentIntentType, type PaymentNetwork, type PollExecutionsRequest, type PollExecutionsResponse, type ProductType, type ProjectConfigResponse, type ProviderSelectedData, type PublicIncidentResponse, type QueryExecutionsRequest, type QueryExecutionsResponse, type RefreshIntegrationTokenResult, type RequestCoinbaseApplePayLimitUpgradeRequest, type RequestCoinbaseApplePayLimitUpgradeResponse, type RequestCoinbaseWalletPayLimitUpgradeRequest, type RequestCoinbaseWalletPayLimitUpgradeResponse, SCAN_NUDGE_INTERVAL_MS, SOLANA_USDC_ADDRESS, type SendHypercoreTransactionRequest, type SendHypercoreTransactionResponse, type SendSolanaTransactionRequest, type SendSolanaTransactionResponse, type SourceToken, type SourceTokenNetwork, type StartIntegrationOAuthResult, type StripeAccessTokenResponse, StripeApiResponseError, type StripeAuthIntentResponse, type StripeConfigResponse, type StripeConfirmRequest, type StripeConsumerWallet, type StripeCreateSessionRequest, type StripeCryptoCustomer, type StripeCustomerVerification, type StripeDefaultTokenResponse, type StripeListResponse, type StripeOnrampErrorType, type StripeOnrampSession, type StripeOnrampTransactionDetails, type StripePaymentToken, type StripeQuoteRequest, type StripeQuotesResponse, type StripeTransactionLimitEntry, type StripeTransactionLimitsResponse, type SupportedChain, type SupportedDepositTokensParams, type SupportedDepositTokensResponse, type SupportedDestinationTokensResponse, type SupportedSourceTokensQuery, type SupportedSourceTokensResponse, type SupportedToken, type TokenBalance, type TokenChain, type TokenChainIconUrl, type TokenChainsResponse, type TokenDisplayMetadata, type TokenIconUrl, type TokenInfo, type TokenMetadata, type TokenSelectedData, type TransferDefaultTokenParams, type TransferDefaultTokenResult, UnifoldClient, type UnifoldClientOptions, type UserIpInfo, type VerificationData, type VerifyAddressParams, type VerifyAddressRequest, type VerifyAddressResponse, type Wallet, type WalletConnectionData, type WalletMobileDeepLinkDepositAddress, type WalletMobileDeepLinkResponse, type WalletMobileDeepLinkWallet, type WalletPayLimitUpgradeStatus, type WalletPayMethod, type WalletPayProvider, type WalletPayProvidersResponse, type WalletSelectedData, type WithdrawDirectExecutionFailedEvent, type WithdrawDirectExecutionSucceededEvent, type WithdrawEvent, WithdrawEventType, type WithdrawFlowStartedData, authenticateIntegrationOAuth, buildHypercoreTransaction, buildSolanaTransaction, checkHypercoreActivation, confirmIntegrationTransfer, createCashAppSession, createCoinbaseApplePaySession, createCoinbaseGooglePaySession, createCoinbaseWalletPaySession, createDepositAddress, createExchangeSession, createIntegrationTransfer, createOnrampSession, createOnrampVerificationSession, createUnifoldClient, exchangeOnrampVerificationToken, formatStablecoinAmount, generateKSUID, generatePrefixedKSUID, getAddressBalance, getAddressBalances, getApiBaseUrl, getApplePayLimitUpgradeStatus, getApplePayProviders, getBankTransferProviders, getCashAppLimits, getCashAppSessionStatus, getChainName, getCoinbaseApplePayLimits, getCoinbaseLegalAgreements, getCoinbaseWalletPayLimits, getDefaultOnrampToken, getDepositAddress, getDepositQuote, getExchangeSessionStartUrl, getExchanges, getExternalWallets, getFiatCurrencies, getFiatExchangeRates, getGooglePayLimitUpgradeStatus, getGooglePayProviders, getIconUrl, getIconUrlWithCdn, getIntegrationExchanges, getIntegrationHoldings, getIntegrationTransferDefaultToken, getIpAddress, getOnrampQuotes, getOnrampSessionStartUrl, getOnrampVerificationSession, getPreferredIconUrl, getProjectConfig, getPublicIncident, getSupportedDepositTokens, getSupportedDestinationTokens, getTokenChains, getTokenMetadata, getWalletByChainType, getWalletMobileDeepLink, getWalletPayLimitUpgradeStatus, getWalletPayProviders, i18n, isApplePayLimitReached, isDepositAddressValidationError, isGooglePayLimitReached, isWalletPayLimitReached, listPaymentIntentExecutions, mapDirectExecution, mapWalletToDepositAddress, pollDirectExecutions, queryExecutions, refreshIntegrationToken, requestCoinbaseApplePayLimitUpgrade, requestCoinbaseWalletPayLimitUpgrade, retrievePaymentIntent, revokeIntegrationToken, sendHypercoreTransaction, sendOnrampVerificationOtp, sendSolanaTransaction, setApiConfig, startIntegrationOAuth, stripeConfirmSession, stripeCreateAuthIntent, stripeCreateSession, stripeExchangeTokens, stripeGetConfig, stripeGetCustomer, stripeGetDefaultToken, stripeGetQuotes, stripeGetSession, stripeGetTransactionLimits, stripeListPaymentTokens, stripeListWallets, stripeRefreshQuote, stripeRefreshToken, useUserIp, verifyOnrampVerificationOtp, verifyRecipientAddress };
+export { type AccountConnectionData, ActionType, type AddressBalanceResponse, type AddressBalancesResponse, type AddressValidationFailureCode, type AddressValidationMetadata, type AddressVerification, type ApplePayLimitUpgradeStatus, type ApplePayProvider, type ApplePayProvidersResponse, type AuthenticateOAuthResult, type AutoSwapRequest, type AutoSwapResponse, type BankTransferConfig, type BankTransferProvider, type BankTransferProvidersResponse, type BlockedCountrySubdivision, type BuildHypercoreTransactionRequest, type BuildHypercoreTransactionResponse, type BuildSolanaTransactionRequest, type BuildSolanaTransactionResponse, type CashAppLimits, type CashAppSessionRequest, type CashAppSessionResponse, type CashAppSessionStatusResponse, type ChainType, type CheckoutEvent, CheckoutEventType, type CheckoutFlowFailedData, type CheckoutFlowStartedData, type CheckoutMethod, type CheckoutMethodSelectedData, type CheckoutPaymentIntent, type CheckoutPaymentIntentData, type CheckoutPaymentIntentSucceededEvent, type CoinbaseApplePayLimit, type CoinbaseApplePayLimitUpgradeOption, type CoinbaseApplePayLimitsResponse, type CoinbaseApplePaySessionResponse, type CoinbaseGooglePaySessionResponse, type CoinbaseLegalAgreement, type CoinbaseLegalAgreementsResponse, type CoinbaseWalletPayLimit, type CoinbaseWalletPayLimitUpgradeOption, type CoinbaseWalletPayLimitsResponse, type CoinbaseWalletPaySessionResponse, type ConfirmIntegrationTransferResult, type CreateCoinbaseApplePaySessionRequest, type CreateCoinbaseGooglePaySessionRequest, type CreateCoinbaseWalletPaySessionRequest, type CreateDepositAddressRequest, type CreateExchangeSessionRequest, type CreateExchangeSessionResponse, type CreateIntegrationExchangeSessionRequest, type CreateIntegrationExchangeSessionResponse, type CreateIntegrationTransferParams, type CreateIntegrationTransferResult, type CreateOnrampVerificationSessionRequest, DETECTION_ARM_DELAY_MS, DETECTION_POLL_INTERVAL_MS, type DefaultTokenChain, type DefaultTokenMetadata, type DefaultTokenResponse, type DepositAddress, type DepositAddressParams, type DepositAddressResponse, DepositAddressValidationError, type DepositEvent, DepositEventType, type DepositFlowFailedData, type DepositFlowStartedData, type DepositLimitReachedData, type DepositMethod, type DepositMethodSelectedData, type DepositQuote, type DepositQuoteRequest, DepositSession, type DepositSessionConfig, type DepositSessionDestination, type DepositSessionError, type DepositSessionErrorCode, type DepositSessionEvent, type DepositSessionEventMap, DepositSessionEventType, type DepositSessionParams, type DepositSessionSnapshot, type DepositSessionStatus, DepositSessionWaitError, type DepositSessionWaitErrorCode, type DepositSessionWaitOptions, type DestinationToken, type DestinationTokenChain, type DirectExecution, type DirectExecutionFailedEvent, type DirectExecutionResponse, type DirectExecutionSucceededEvent, 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 GetBankTransferProvidersOptions, type GetExchangesQuery, type GetIntegrationExchangesQuery, type GooglePayProvider, type GooglePayProvidersResponse, type HypercoreActivationRequest, type HypercoreActivationResponse, type I18nStrings, type IconUrl, IneligibilityReason, type IntegrationAccount, type IntegrationConnectionMethod, type IntegrationExchangeInfo, type IntegrationExchangeSessionStartParams, type IntegrationExchangesResponse, type IntegrationFeeAmount, type IntegrationHoldingsResponse, IntegrationProvider, IntegrationTransferError, type IntegrationTransferErrorType, type IpAddressResponse, LOOKBACK_MS, type ListExecutionsParams, type LockedQuoteLimits, type LockedQuotePreview, type LockedQuotePreviewRequest, type OnrampQuote, type OnrampQuotesRequest, type OnrampQuotesResponse, type OnrampSessionCreatedData, type OnrampSessionCreatedEvent, type OnrampSessionPaymentMethod, type OnrampSessionPaymentMethodType, type OnrampSessionRequest, type OnrampSessionResponse, type OnrampSessionStatusResponse, type OnrampSessionStatusValue, type OnrampVerificationFactor, type OnrampVerificationFactorStatus, type OnrampVerificationSession, type OnrampVerificationStatus, type OnrampVerificationTokenResponse, type PaymentIntent, type PaymentIntentDepositAddress, type PaymentIntentExecutionsResponse, type PaymentIntentStatus, type PaymentIntentType, type PaymentNetwork, type PollExecutionsRequest, type PollExecutionsResponse, type ProductType, type ProjectConfigResponse, type ProviderSelectedData, type PublicIncidentResponse, type QueryExecutionsRequest, type QueryExecutionsResponse, type RefreshIntegrationTokenResult, type RequestCoinbaseApplePayLimitUpgradeRequest, type RequestCoinbaseApplePayLimitUpgradeResponse, type RequestCoinbaseWalletPayLimitUpgradeRequest, type RequestCoinbaseWalletPayLimitUpgradeResponse, SCAN_NUDGE_INTERVAL_MS, SOLANA_USDC_ADDRESS, type SendHypercoreTransactionRequest, type SendHypercoreTransactionResponse, type SendSolanaTransactionRequest, type SendSolanaTransactionResponse, type SourceToken, type SourceTokenNetwork, type StartIntegrationOAuthResult, type StripeAccessTokenResponse, StripeApiResponseError, type StripeAuthIntentResponse, type StripeConfigResponse, type StripeConfirmRequest, type StripeConsumerWallet, type StripeCreateSessionRequest, type StripeCryptoCustomer, type StripeCustomerVerification, type StripeDefaultTokenResponse, type StripeListResponse, type StripeOnrampErrorType, type StripeOnrampSession, type StripeOnrampTransactionDetails, type StripePaymentToken, type StripeQuoteRequest, type StripeQuotesResponse, type StripeTransactionLimitEntry, type StripeTransactionLimitsResponse, type SupportedChain, type SupportedDepositTokensParams, type SupportedDepositTokensResponse, type SupportedDestinationTokensResponse, type SupportedSourceTokensQuery, type SupportedSourceTokensResponse, type SupportedToken, type TokenBalance, type TokenChain, type TokenChainIconUrl, type TokenChainsResponse, type TokenDisplayMetadata, type TokenIconUrl, type TokenInfo, type TokenMetadata, type TokenSelectedData, type TransferDefaultTokenParams, type TransferDefaultTokenResult, UnifoldClient, type UnifoldClientOptions, type UserIpInfo, type VerificationData, type VerifyAddressParams, type VerifyAddressRequest, type VerifyAddressResponse, type Wallet, type WalletConnectionData, type WalletMobileDeepLinkDepositAddress, type WalletMobileDeepLinkResponse, type WalletMobileDeepLinkWallet, type WalletPayLimitUpgradeStatus, type WalletPayMethod, type WalletPayProvider, type WalletPayProvidersResponse, type WalletSelectedData, type WithdrawDirectExecutionFailedEvent, type WithdrawDirectExecutionSucceededEvent, type WithdrawEvent, WithdrawEventType, type WithdrawFlowStartedData, authenticateIntegrationOAuth, buildHypercoreTransaction, buildSolanaTransaction, checkHypercoreActivation, confirmIntegrationTransfer, createCashAppSession, createCoinbaseApplePaySession, createCoinbaseGooglePaySession, createCoinbaseWalletPaySession, createDepositAddress, createExchangeSession, createIntegrationExchangeSession, createIntegrationTransfer, createOnrampSession, createOnrampVerificationSession, createUnifoldClient, exchangeOnrampVerificationToken, formatStablecoinAmount, generateKSUID, generatePrefixedKSUID, getAddressBalance, getAddressBalances, getApiBaseUrl, getApplePayLimitUpgradeStatus, getApplePayProviders, getBankTransferProviders, getCashAppLimits, getCashAppSessionStatus, getChainName, getCoinbaseApplePayLimits, getCoinbaseLegalAgreements, getCoinbaseWalletPayLimits, getDefaultOnrampToken, getDepositAddress, getDepositQuote, getExchangeSessionStartUrl, getExchanges, getExternalWallets, getFiatCurrencies, getFiatExchangeRates, getGooglePayLimitUpgradeStatus, getGooglePayProviders, getIconUrl, getIconUrlWithCdn, getIntegrationExchangeSessionStartUrl, getIntegrationExchanges, getIntegrationHoldings, getIntegrationTransferDefaultToken, getIpAddress, getOnrampQuotes, getOnrampSessionStartUrl, getOnrampSessionStatus, getOnrampVerificationSession, getPreferredIconUrl, getProjectConfig, getPublicIncident, getSupportedDepositTokens, getSupportedDestinationTokens, getTokenChains, getTokenMetadata, getWalletByChainType, getWalletMobileDeepLink, getWalletPayLimitUpgradeStatus, getWalletPayProviders, i18n, isApplePayLimitReached, isDepositAddressValidationError, isGooglePayLimitReached, isWalletPayLimitReached, listPaymentIntentExecutions, mapDirectExecution, mapWalletToDepositAddress, pollDirectExecutions, queryExecutions, refreshIntegrationToken, requestCoinbaseApplePayLimitUpgrade, requestCoinbaseWalletPayLimitUpgrade, retrievePaymentIntent, revokeIntegrationToken, sendHypercoreTransaction, sendOnrampVerificationOtp, sendSolanaTransaction, setApiConfig, startIntegrationOAuth, stripeConfirmSession, stripeCreateAuthIntent, stripeCreateSession, stripeExchangeTokens, stripeGetConfig, stripeGetCustomer, stripeGetDefaultToken, stripeGetQuotes, stripeGetSession, stripeGetTransactionLimits, stripeListPaymentTokens, stripeListWallets, stripeRefreshQuote, stripeRefreshToken, useUserIp, verifyOnrampVerificationOtp, verifyRecipientAddress };

package/dist/index.js

@@ -52,6 +52,7 @@ __export(index_exports, {
   createCoinbaseWalletPaySession: () => createCoinbaseWalletPaySession,
   createDepositAddress: () => createDepositAddress,
   createExchangeSession: () => createExchangeSession,
+  createIntegrationExchangeSession: () => createIntegrationExchangeSession,
   createIntegrationTransfer: () => createIntegrationTransfer,
   createOnrampSession: () => createOnrampSession,
   createOnrampVerificationSession: () => createOnrampVerificationSession,
@@ -84,12 +85,14 @@ __export(index_exports, {
   getGooglePayProviders: () => getGooglePayProviders,
   getIconUrl: () => getIconUrl,
   getIconUrlWithCdn: () => getIconUrlWithCdn,
+  getIntegrationExchangeSessionStartUrl: () => getIntegrationExchangeSessionStartUrl,
   getIntegrationExchanges: () => getIntegrationExchanges,
   getIntegrationHoldings: () => getIntegrationHoldings,
   getIntegrationTransferDefaultToken: () => getIntegrationTransferDefaultToken,
   getIpAddress: () => getIpAddress,
   getOnrampQuotes: () => getOnrampQuotes,
   getOnrampSessionStartUrl: () => getOnrampSessionStartUrl,
+  getOnrampSessionStatus: () => getOnrampSessionStatus,
   getOnrampVerificationSession: () => getOnrampVerificationSession,
   getPreferredIconUrl: () => getPreferredIconUrl,
   getProjectConfig: () => getProjectConfig,
@@ -181,7 +184,7 @@ function generatePrefixedKSUID(prefix) {
 }
 
 // src/lib/client-headers.ts
-var SDK_VERSION = true ? "0.1.74" : "0.0.0-dev";
+var SDK_VERSION = true ? "0.1.75" : "0.0.0-dev";
 var CLIENT_VERSION_HEADER = "x-unifold-client-version";
 var CLIENT_USER_AGENT_HEADER = "x-unifold-client-user-agent";
 function detectRuntime() {
@@ -679,6 +682,7 @@ async function getDefaultOnrampToken(params, publishableKey) {
   const queryParams = new URLSearchParams();
   if (params.country_code) queryParams.append("country_code", params.country_code);
   if (params.subdivision_code) queryParams.append("subdivision_code", params.subdivision_code);
+  if (params.service_provider) queryParams.append("service_provider", params.service_provider);
   queryParams.append("token_address", params.token_address);
   queryParams.append("chain_id", params.chain_id);
   queryParams.append("chain_type", params.chain_type);
@@ -943,6 +947,25 @@ async function createExchangeSession(request, publishableKey) {
   }
   return response.json();
 }
+async function getOnrampSessionStatus(externalId, publishableKey, signal) {
+  const pk = publishableKey || DEFAULT_PUBLISHABLE_KEY;
+  validatePublishableKey(pk);
+  const response = await apiFetch(`${API_BASE_URL}/v1/public/onramps/sessions/status`, {
+    method: "POST",
+    headers: {
+      accept: "application/json",
+      "x-publishable-key": pk,
+      "Content-Type": "application/json"
+    },
+    body: JSON.stringify({ external_id: externalId }),
+    signal
+  });
+  if (!response.ok) {
+    const error = await response.json().catch(() => ({ message: response.statusText }));
+    throw new Error(`Failed to get session status: ${error.message || response.statusText}`);
+  }
+  return response.json();
+}
 function getExchangeSessionStartUrl(request, publishableKey) {
   const params = new URLSearchParams();
   params.append("publishable_key", publishableKey);
@@ -961,24 +984,95 @@ function getExchangeSessionStartUrl(request, publishableKey) {
   if (request.source_amount) {
     params.append("source_amount", request.source_amount);
   }
+  if (request.country_code) {
+    params.append("country_code", request.country_code);
+  }
+  if (request.subdivision_code) {
+    params.append("subdivision_code", request.subdivision_code);
+  }
   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) {
+async function getIntegrationExchanges(publishableKey, query) {
   const pk = publishableKey || DEFAULT_PUBLISHABLE_KEY;
   validatePublishableKey(pk);
-  const response = await apiFetch(`${API_BASE_URL}/v1/public/integrations/oauth/exchanges`, {
-    method: "GET",
+  const params = new URLSearchParams();
+  if (query?.country_code) params.append("country_code", query.country_code);
+  if (query?.subdivision_code) params.append("subdivision_code", query.subdivision_code);
+  const queryString = params.toString() ? `?${params.toString()}` : "";
+  const headers = {
+    accept: "application/json",
+    "x-publishable-key": pk
+  };
+  const response = await apiFetch(
+    `${API_BASE_URL}/v1/public/integrations/exchanges${queryString}`,
+    {
+      method: "GET",
+      headers
+    }
+  );
+  if (response.ok) {
+    return response.json();
+  }
+  if (response.status === 404) {
+    const legacyResponse = await apiFetch(
+      `${API_BASE_URL}/v1/public/integrations/oauth/exchanges${queryString}`,
+      {
+        method: "GET",
+        headers
+      }
+    );
+    if (legacyResponse.ok) {
+      return legacyResponse.json();
+    }
+    throw new Error(`Failed to fetch integration exchanges: ${legacyResponse.statusText}`);
+  }
+  throw new Error(`Failed to fetch integration exchanges: ${response.statusText}`);
+}
+async function createIntegrationExchangeSession(request, publishableKey) {
+  const pk = publishableKey || DEFAULT_PUBLISHABLE_KEY;
+  validatePublishableKey(pk);
+  const response = await apiFetch(`${API_BASE_URL}/v1/public/integrations/exchanges/sessions`, {
+    method: "POST",
     headers: {
       accept: "application/json",
-      "x-publishable-key": pk
-    }
+      "x-publishable-key": pk,
+      "Content-Type": "application/json"
+    },
+    body: JSON.stringify(request)
   });
   if (!response.ok) {
-    throw new Error(`Failed to fetch integration exchanges: ${response.statusText}`);
+    throw new Error(`Failed to create integration exchange session: ${response.statusText}`);
   }
   return response.json();
 }
+function getIntegrationExchangeSessionStartUrl(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.country_code) {
+    params.append("country_code", request.country_code);
+  }
+  if (request.subdivision_code) {
+    params.append("subdivision_code", request.subdivision_code);
+  }
+  params.append("external_id", request.external_id ?? generatePrefixedKSUID("exc"));
+  return `${API_BASE_URL}/v1/public/integrations/exchanges/sessions/start?${params.toString()}`;
+}
 async function startIntegrationOAuth(publishableKey) {
   const pk = publishableKey || DEFAULT_PUBLISHABLE_KEY;
   validatePublishableKey(pk);
@@ -2896,6 +2990,7 @@ var i18n = en_default;
   createCoinbaseWalletPaySession,
   createDepositAddress,
   createExchangeSession,
+  createIntegrationExchangeSession,
   createIntegrationTransfer,
   createOnrampSession,
   createOnrampVerificationSession,
@@ -2928,12 +3023,14 @@ var i18n = en_default;
   getGooglePayProviders,
   getIconUrl,
   getIconUrlWithCdn,
+  getIntegrationExchangeSessionStartUrl,
   getIntegrationExchanges,
   getIntegrationHoldings,
   getIntegrationTransferDefaultToken,
   getIpAddress,
   getOnrampQuotes,
   getOnrampSessionStartUrl,
+  getOnrampSessionStatus,
   getOnrampVerificationSession,
   getPreferredIconUrl,
   getProjectConfig,

package/dist/index.mjs

@@ -41,7 +41,7 @@ function generatePrefixedKSUID(prefix) {
 }
 
 // src/lib/client-headers.ts
-var SDK_VERSION = true ? "0.1.74" : "0.0.0-dev";
+var SDK_VERSION = true ? "0.1.75" : "0.0.0-dev";
 var CLIENT_VERSION_HEADER = "x-unifold-client-version";
 var CLIENT_USER_AGENT_HEADER = "x-unifold-client-user-agent";
 function detectRuntime() {
@@ -539,6 +539,7 @@ async function getDefaultOnrampToken(params, publishableKey) {
   const queryParams = new URLSearchParams();
   if (params.country_code) queryParams.append("country_code", params.country_code);
   if (params.subdivision_code) queryParams.append("subdivision_code", params.subdivision_code);
+  if (params.service_provider) queryParams.append("service_provider", params.service_provider);
   queryParams.append("token_address", params.token_address);
   queryParams.append("chain_id", params.chain_id);
   queryParams.append("chain_type", params.chain_type);
@@ -803,6 +804,25 @@ async function createExchangeSession(request, publishableKey) {
   }
   return response.json();
 }
+async function getOnrampSessionStatus(externalId, publishableKey, signal) {
+  const pk = publishableKey || DEFAULT_PUBLISHABLE_KEY;
+  validatePublishableKey(pk);
+  const response = await apiFetch(`${API_BASE_URL}/v1/public/onramps/sessions/status`, {
+    method: "POST",
+    headers: {
+      accept: "application/json",
+      "x-publishable-key": pk,
+      "Content-Type": "application/json"
+    },
+    body: JSON.stringify({ external_id: externalId }),
+    signal
+  });
+  if (!response.ok) {
+    const error = await response.json().catch(() => ({ message: response.statusText }));
+    throw new Error(`Failed to get session status: ${error.message || response.statusText}`);
+  }
+  return response.json();
+}
 function getExchangeSessionStartUrl(request, publishableKey) {
   const params = new URLSearchParams();
   params.append("publishable_key", publishableKey);
@@ -821,24 +841,95 @@ function getExchangeSessionStartUrl(request, publishableKey) {
   if (request.source_amount) {
     params.append("source_amount", request.source_amount);
   }
+  if (request.country_code) {
+    params.append("country_code", request.country_code);
+  }
+  if (request.subdivision_code) {
+    params.append("subdivision_code", request.subdivision_code);
+  }
   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) {
+async function getIntegrationExchanges(publishableKey, query) {
   const pk = publishableKey || DEFAULT_PUBLISHABLE_KEY;
   validatePublishableKey(pk);
-  const response = await apiFetch(`${API_BASE_URL}/v1/public/integrations/oauth/exchanges`, {
-    method: "GET",
+  const params = new URLSearchParams();
+  if (query?.country_code) params.append("country_code", query.country_code);
+  if (query?.subdivision_code) params.append("subdivision_code", query.subdivision_code);
+  const queryString = params.toString() ? `?${params.toString()}` : "";
+  const headers = {
+    accept: "application/json",
+    "x-publishable-key": pk
+  };
+  const response = await apiFetch(
+    `${API_BASE_URL}/v1/public/integrations/exchanges${queryString}`,
+    {
+      method: "GET",
+      headers
+    }
+  );
+  if (response.ok) {
+    return response.json();
+  }
+  if (response.status === 404) {
+    const legacyResponse = await apiFetch(
+      `${API_BASE_URL}/v1/public/integrations/oauth/exchanges${queryString}`,
+      {
+        method: "GET",
+        headers
+      }
+    );
+    if (legacyResponse.ok) {
+      return legacyResponse.json();
+    }
+    throw new Error(`Failed to fetch integration exchanges: ${legacyResponse.statusText}`);
+  }
+  throw new Error(`Failed to fetch integration exchanges: ${response.statusText}`);
+}
+async function createIntegrationExchangeSession(request, publishableKey) {
+  const pk = publishableKey || DEFAULT_PUBLISHABLE_KEY;
+  validatePublishableKey(pk);
+  const response = await apiFetch(`${API_BASE_URL}/v1/public/integrations/exchanges/sessions`, {
+    method: "POST",
     headers: {
       accept: "application/json",
-      "x-publishable-key": pk
-    }
+      "x-publishable-key": pk,
+      "Content-Type": "application/json"
+    },
+    body: JSON.stringify(request)
   });
   if (!response.ok) {
-    throw new Error(`Failed to fetch integration exchanges: ${response.statusText}`);
+    throw new Error(`Failed to create integration exchange session: ${response.statusText}`);
   }
   return response.json();
 }
+function getIntegrationExchangeSessionStartUrl(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.country_code) {
+    params.append("country_code", request.country_code);
+  }
+  if (request.subdivision_code) {
+    params.append("subdivision_code", request.subdivision_code);
+  }
+  params.append("external_id", request.external_id ?? generatePrefixedKSUID("exc"));
+  return `${API_BASE_URL}/v1/public/integrations/exchanges/sessions/start?${params.toString()}`;
+}
 async function startIntegrationOAuth(publishableKey) {
   const pk = publishableKey || DEFAULT_PUBLISHABLE_KEY;
   validatePublishableKey(pk);
@@ -2755,6 +2846,7 @@ export {
   createCoinbaseWalletPaySession,
   createDepositAddress,
   createExchangeSession,
+  createIntegrationExchangeSession,
   createIntegrationTransfer,
   createOnrampSession,
   createOnrampVerificationSession,
@@ -2787,12 +2879,14 @@ export {
   getGooglePayProviders,
   getIconUrl,
   getIconUrlWithCdn,
+  getIntegrationExchangeSessionStartUrl,
   getIntegrationExchanges,
   getIntegrationHoldings,
   getIntegrationTransferDefaultToken,
   getIpAddress,
   getOnrampQuotes,
   getOnrampSessionStartUrl,
+  getOnrampSessionStatus,
   getOnrampVerificationSession,
   getPreferredIconUrl,
   getProjectConfig,

package/package.json

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