@unifold/core 0.1.20 → 0.1.22

package/dist/index.d.mts

@@ -22,7 +22,7 @@ declare function getIconUrl(iconPath: string): string;
 declare function getIconUrlWithCdn(iconPath: string, assetCdnUrl?: string): string;
 interface Wallet {
     id: string;
-    chain_type: "ethereum" | "solana" | "bitcoin";
+    chain_type: "ethereum" | "solana" | "bitcoin" | "algorand";
     address_type: string | null;
     address: string;
     destination_chain_type: string;
@@ -51,7 +51,7 @@ declare function createDepositAddress(overrides?: Partial<CreateDepositAddressRe
 /**
  * Get wallet address for a specific chain type
  */
-declare function getWalletByChainType(wallets: Wallet[], chainType: "ethereum" | "solana" | "bitcoin"): Wallet | undefined;
+declare function getWalletByChainType(wallets: Wallet[], chainType: "ethereum" | "solana" | "bitcoin" | "algorand"): Wallet | undefined;
 interface AutoSwapRequest {
     wallet_id: string;
     origin_currency: string;
@@ -117,6 +117,7 @@ interface AutoSwapResponse {
     };
     source_currency?: string;
     destination_currency?: string;
+    estimated_processing_time?: number | null;
 }
 declare const SOLANA_USDC_ADDRESS = "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v";
 interface QueryExecutionsRequest {
@@ -157,91 +158,170 @@ interface SupportedDepositTokensResponse {
  * Get supported deposit tokens
  * @param publishableKey - Optional publishable key, defaults to configured key
  */
-declare function getSupportedDepositTokens(publishableKey?: string): Promise<SupportedDepositTokensResponse>;
-interface MeldQuote {
+declare function getSupportedDepositTokens(publishableKey?: string, options?: {
+    destination_token_address?: string;
+    destination_chain_id?: string;
+    destination_chain_type?: string;
+}): Promise<SupportedDepositTokensResponse>;
+interface TokenMetadata {
+    symbol: string;
+    name: string;
+    icon_url: string;
+    icon_urls: IconUrl[];
+    chain_name: string;
+    chain_type: string;
+    chain_id: string;
+    token_address: string;
+    decimals: number;
+    chain_icon_url: string;
+    chain_icon_urls: IconUrl[];
+}
+interface GetTokenMetadataRequest {
+    chain_type: string;
+    chain_id: string;
+    token_address: string;
+}
+/**
+ * Get token metadata for a specific token
+ * @param request - Token query parameters (chain_type, chain_id, token_address)
+ * @param publishableKey - Optional publishable key, defaults to configured key
+ */
+declare function getTokenMetadata(request: GetTokenMetadataRequest, publishableKey?: string): Promise<TokenMetadata | null>;
+/**
+ * Get the preferred icon URL from an array of icon URLs
+ * @param iconUrls - Array of icon URLs with format information
+ * @param preferredFormat - Preferred format ("svg" or "png"), defaults to "svg"
+ * @returns The URL string for the preferred format, or first available if preferred not found
+ */
+declare function getPreferredIconUrl(iconUrls: IconUrl[] | undefined, preferredFormat?: "svg" | "png"): string | undefined;
+interface FiatCurrency {
+    currency_code: string;
+    name: string;
+    icon_url: string;
+    icon_urls: IconUrl[];
+    country_codes: string[];
+    default_amount: number;
+    minimum_amount: number;
+    maximum_amount: number;
+    suggested_amounts: number[];
+}
+interface FiatCurrenciesResponse {
+    data: FiatCurrency[];
+    preferred: string[];
+}
+/**
+ * Get supported fiat currencies
+ * @param publishableKey - Optional publishable key, defaults to configured key
+ */
+declare function getFiatCurrencies(publishableKey?: string): Promise<FiatCurrenciesResponse>;
+interface OnrampQuote {
     transaction_type: string;
-    payment_method_type: string;
     source_amount: number;
     source_amount_without_fees: number;
     fiat_amount_without_fees: number;
     destination_amount_without_fees: number | null;
-    source_currency_code: string;
+    source_currency: string;
     country_code: string;
     total_fee: number;
     network_fee: number;
     transaction_fee: number;
     destination_amount: number;
-    destination_currency_code: string;
+    destination_currency: string;
+    destination_network: string;
     exchange_rate: number;
+    payment_method_type: string;
     customer_score: number;
     service_provider: string;
     service_provider_display_name: string;
+    icon_url: string;
+    icon_urls: IconUrl[];
     institution_name: string | null;
-    low_kyc: boolean | null;
+    low_kyc: boolean;
     partner_fee: number | null;
-    icon_url: string;
 }
-interface MeldQuotesRequest {
+interface OnrampQuotesRequest {
     country_code: string;
-    destination_currency_code: string;
     source_amount: string;
-    source_currency_code: string;
+    source_currency: string;
+    destination_currency: string;
+    destination_network: string;
+    subdivision_code?: string;
 }
-interface MeldQuotesResponse {
-    data: MeldQuote[];
+interface OnrampQuotesResponse {
+    data: OnrampQuote[];
 }
 /**
- * Get Meld onramp quotes
- * @param request - Meld quotes request
+ * Get unified onramp quotes from all providers
+ * @param request - Onramp quotes request
  * @param publishableKey - Optional publishable key, defaults to configured key
  */
-declare function getMeldQuotes(request: MeldQuotesRequest, publishableKey?: string): Promise<MeldQuotesResponse>;
-interface MeldSessionRequest {
+declare function getOnrampQuotes(request: OnrampQuotesRequest, publishableKey?: string): Promise<OnrampQuotesResponse>;
+interface OnrampSessionRequest {
     service_provider: string;
     country_code: string;
-    destination_currency_code: string;
-    source_currency_code: string;
-    wallet_address: string;
+    source_currency: string;
     source_amount: string;
+    destination_currency: string;
+    destination_network: string;
+    wallet_address: string;
+    subdivision_code?: string;
+    redirect_url?: string;
 }
-interface MeldSessionResponse {
-    id: string;
-    external_session_id: string | null;
-    external_customer_id: string | null;
-    customer_id: string;
-    widget_url: string;
-    service_provider_widget_url: string;
-    token: string;
+interface OnrampSessionResponse {
+    url: string;
+    service_provider: string;
 }
 /**
- * Create a Meld onramp session
- * @param request - Meld session request
+ * Create a unified onramp session
+ * @param request - Onramp session request
  * @param publishableKey - Optional publishable key, defaults to configured key
  */
-declare function createMeldSession(request: MeldSessionRequest, publishableKey?: string): Promise<MeldSessionResponse>;
+declare function createOnrampSession(request: OnrampSessionRequest, publishableKey?: string): Promise<OnrampSessionResponse>;
 /**
- * Get the preferred icon URL from an array of icon URLs
- * @param iconUrls - Array of icon URLs with format information
- * @param preferredFormat - Preferred format ("svg" or "png"), defaults to "svg"
- * @returns The URL string for the preferred format, or first available if preferred not found
+ * Generate a URL for the sessions/start endpoint that redirects to the onramp provider.
+ * This is useful for avoiding popup blockers by opening the URL directly via anchor tag.
+ * @param request - Onramp session request (same parameters as createOnrampSession)
+ * @param publishableKey - Publishable key (required)
+ * @returns URL string that can be used in an anchor tag or window.open()
  */
-declare function getPreferredIconUrl(iconUrls: IconUrl[] | undefined, preferredFormat?: "svg" | "png"): string | undefined;
-interface FiatCurrency {
-    currency_code: string;
-    name: string;
+declare function getOnrampSessionStartUrl(request: OnrampSessionRequest, publishableKey: string): string;
+interface DefaultTokenChain {
+    icon_url: string;
+    icon_urls: IconUrl[];
+    chain_id: string;
+    chain_name: string;
+    chain_type: string;
+}
+interface DefaultTokenMetadata {
     icon_url: string;
-    icon_urls?: IconUrl[];
-    country_codes?: string[];
+    icon_urls: IconUrl[];
+    decimals: number;
+    symbol: string;
+    name: string;
+    token_address: string;
+    chain_id: string;
+    chain_type: string;
+    chain_name: string;
+    chain: DefaultTokenChain;
 }
-interface FiatCurrenciesResponse {
-    data: FiatCurrency[];
-    preferred: string[];
+interface DefaultTokenResponse {
+    destination_network: string;
+    destination_currency: string;
+    destination_token_metadata: DefaultTokenMetadata;
+    estimated_processing_time: number | null;
 }
 /**
- * Get supported fiat currencies
+ * Get default onramp token for a given token/chain combination
+ * @param params - Query parameters
  * @param publishableKey - Optional publishable key, defaults to configured key
  */
-declare function getFiatCurrencies(publishableKey?: string): Promise<FiatCurrenciesResponse>;
+declare function getDefaultOnrampToken(params: {
+    country_code?: string;
+    subdivision_code?: string;
+    token_address: string;
+    chain_id: string;
+    chain_type: string;
+}, publishableKey?: string): Promise<DefaultTokenResponse>;
 interface TokenChainIconUrl {
     url: string;
     format: string;
@@ -306,6 +386,93 @@ interface IpAddressResponse {
  * This is a public endpoint that doesn't require authentication
  */
 declare function getIpAddress(): Promise<IpAddressResponse>;
+interface TokenIconUrl {
+    url: string;
+    format: string;
+}
+interface TokenInfo {
+    symbol: string;
+    name: string;
+    icon_url: string;
+    icon_urls: TokenIconUrl[];
+    token_address: string;
+    chain_id: string;
+    chain_name: string;
+    chain_type: string;
+    decimals: number;
+    minimum_deposit_amount_usd: number;
+    chain_icon_url: string;
+    chain_icon_urls: TokenIconUrl[];
+}
+interface TokenBalance {
+    amount: string;
+    amount_usd: string | null;
+    exchange_rate: string | null;
+    is_eligible: boolean;
+    token: TokenInfo;
+}
+interface AddressBalancesResponse {
+    address: string;
+    chain_type: string;
+    balances: TokenBalance[];
+}
+/**
+ * Get token balances for a wallet address
+ * Returns balances for all supported deposit tokens on the specified chain type
+ * @param address - Wallet address to check balances for
+ * @param chainType - Chain type to fetch balances for ('ethereum', 'solana', or 'bitcoin')
+ * @param publishableKey - Optional publishable key, defaults to configured key
+ */
+declare function getAddressBalances(address: string, chainType: 'ethereum' | 'solana' | 'bitcoin', publishableKey?: string): Promise<AddressBalancesResponse>;
+interface AddressBalanceResponse {
+    address: string;
+    chain_type: string;
+    chain_id: string;
+    token_address: string;
+    balance: TokenBalance | null;
+}
+/**
+ * Get balance for a specific token on a specific chain
+ * Returns the balance for a single token, or null if not found or zero balance
+ * @param address - Wallet address to check balance for
+ * @param chainType - Chain type ('ethereum', 'solana', or 'bitcoin')
+ * @param chainId - Chain ID (e.g., "1" for Ethereum mainnet)
+ * @param tokenAddress - Token contract address or "native" for native tokens
+ * @param publishableKey - Optional publishable key, defaults to configured key
+ */
+declare function getAddressBalance(address: string, chainType: 'ethereum' | 'solana' | 'bitcoin', chainId: string, tokenAddress: string, publishableKey?: string): Promise<AddressBalanceResponse>;
+interface VerifyAddressRequest {
+    chain_type: string;
+    chain_id: string;
+    token_address: string;
+    recipient_address: string;
+}
+/**
+ * Standard error codes for address validation failures.
+ * Used by frontend to display localized error messages.
+ */
+type AddressValidationFailureCode = 'token_not_supported' | 'not_opted_in' | 'insufficient_balance' | 'account_not_found' | 'validation_error';
+interface AddressValidationMetadata {
+    chain_name?: string;
+    token_symbol?: string;
+}
+interface VerifyAddressResponse {
+    valid: boolean;
+    /** Standardized error code for frontend i18n */
+    failure_code?: AddressValidationFailureCode;
+    /** Metadata for message interpolation */
+    metadata?: AddressValidationMetadata;
+}
+/**
+ * Verify if a recipient address can receive funds for a given chain/token
+ * This is useful to check before confirming a transfer, especially for Algorand
+ * where recipients must opt-in to assets before receiving them.
+ *
+ * @param request - Verification request with chain_type, chain_id, token_address, recipient_address
+ * @param publishableKey - Optional publishable key, defaults to configured key
+ * @returns Verification result with valid status and reason if invalid
+ */
+declare function verifyRecipientAddress(request: VerifyAddressRequest, publishableKey?: string): Promise<VerifyAddressResponse>;
 
 /**
  * User IP information interface
@@ -401,4 +568,4 @@ declare const i18n: {
 };
 type I18nStrings = typeof i18n;
 
-export { type AutoSwapRequest, type AutoSwapResponse, type CreateDepositAddressRequest, type DepositAddressResponse, ExecutionStatus, type FeaturedToken, type FiatCurrenciesResponse, type FiatCurrency, type I18nStrings, type IconUrl, type IpAddressResponse, type MeldQuote, type MeldQuotesRequest, type MeldQuotesResponse, type MeldSessionRequest, type MeldSessionResponse, type PaymentNetwork, type ProjectConfigResponse, type QueryExecutionsRequest, type QueryExecutionsResponse, SOLANA_USDC_ADDRESS, type SupportedChain, type SupportedDepositTokensResponse, type SupportedToken, type TokenChain, type TokenChainIconUrl, type TokenChainsResponse, type UserIpInfo, type Wallet, createDepositAddress, createMeldSession, getApiBaseUrl, getChainName, getFiatCurrencies, getIconUrl, getIconUrlWithCdn, getIpAddress, getMeldQuotes, getPreferredIconUrl, getProjectConfig, getSupportedDepositTokens, getTokenChains, getWalletByChainType, i18n, queryExecutions, setApiConfig, useUserIp };
+export { type AddressBalanceResponse, type AddressBalancesResponse, type AddressValidationFailureCode, type AddressValidationMetadata, type AutoSwapRequest, type AutoSwapResponse, type CreateDepositAddressRequest, type DefaultTokenChain, type DefaultTokenMetadata, type DefaultTokenResponse, type DepositAddressResponse, ExecutionStatus, type FeaturedToken, type FiatCurrenciesResponse, type FiatCurrency, type I18nStrings, type IconUrl, type IpAddressResponse, type OnrampQuote, type OnrampQuotesRequest, type OnrampQuotesResponse, type OnrampSessionRequest, type OnrampSessionResponse, type PaymentNetwork, type ProjectConfigResponse, type QueryExecutionsRequest, type QueryExecutionsResponse, SOLANA_USDC_ADDRESS, type SupportedChain, type SupportedDepositTokensResponse, type SupportedToken, type TokenBalance, type TokenChain, type TokenChainIconUrl, type TokenChainsResponse, type TokenIconUrl, type TokenInfo, type TokenMetadata, type UserIpInfo, type VerifyAddressRequest, type VerifyAddressResponse, type Wallet, createDepositAddress, createOnrampSession, getAddressBalance, getAddressBalances, getApiBaseUrl, getChainName, getDefaultOnrampToken, getFiatCurrencies, getIconUrl, getIconUrlWithCdn, getIpAddress, getOnrampQuotes, getOnrampSessionStartUrl, getPreferredIconUrl, getProjectConfig, getSupportedDepositTokens, getTokenChains, getTokenMetadata, getWalletByChainType, i18n, queryExecutions, setApiConfig, useUserIp, verifyRecipientAddress };

package/dist/index.d.ts

@@ -22,7 +22,7 @@ declare function getIconUrl(iconPath: string): string;
 declare function getIconUrlWithCdn(iconPath: string, assetCdnUrl?: string): string;
 interface Wallet {
     id: string;
-    chain_type: "ethereum" | "solana" | "bitcoin";
+    chain_type: "ethereum" | "solana" | "bitcoin" | "algorand";
     address_type: string | null;
     address: string;
     destination_chain_type: string;
@@ -51,7 +51,7 @@ declare function createDepositAddress(overrides?: Partial<CreateDepositAddressRe
 /**
  * Get wallet address for a specific chain type
  */
-declare function getWalletByChainType(wallets: Wallet[], chainType: "ethereum" | "solana" | "bitcoin"): Wallet | undefined;
+declare function getWalletByChainType(wallets: Wallet[], chainType: "ethereum" | "solana" | "bitcoin" | "algorand"): Wallet | undefined;
 interface AutoSwapRequest {
     wallet_id: string;
     origin_currency: string;
@@ -117,6 +117,7 @@ interface AutoSwapResponse {
     };
     source_currency?: string;
     destination_currency?: string;
+    estimated_processing_time?: number | null;
 }
 declare const SOLANA_USDC_ADDRESS = "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v";
 interface QueryExecutionsRequest {
@@ -157,91 +158,170 @@ interface SupportedDepositTokensResponse {
  * Get supported deposit tokens
  * @param publishableKey - Optional publishable key, defaults to configured key
  */
-declare function getSupportedDepositTokens(publishableKey?: string): Promise<SupportedDepositTokensResponse>;
-interface MeldQuote {
+declare function getSupportedDepositTokens(publishableKey?: string, options?: {
+    destination_token_address?: string;
+    destination_chain_id?: string;
+    destination_chain_type?: string;
+}): Promise<SupportedDepositTokensResponse>;
+interface TokenMetadata {
+    symbol: string;
+    name: string;
+    icon_url: string;
+    icon_urls: IconUrl[];
+    chain_name: string;
+    chain_type: string;
+    chain_id: string;
+    token_address: string;
+    decimals: number;
+    chain_icon_url: string;
+    chain_icon_urls: IconUrl[];
+}
+interface GetTokenMetadataRequest {
+    chain_type: string;
+    chain_id: string;
+    token_address: string;
+}
+/**
+ * Get token metadata for a specific token
+ * @param request - Token query parameters (chain_type, chain_id, token_address)
+ * @param publishableKey - Optional publishable key, defaults to configured key
+ */
+declare function getTokenMetadata(request: GetTokenMetadataRequest, publishableKey?: string): Promise<TokenMetadata | null>;
+/**
+ * Get the preferred icon URL from an array of icon URLs
+ * @param iconUrls - Array of icon URLs with format information
+ * @param preferredFormat - Preferred format ("svg" or "png"), defaults to "svg"
+ * @returns The URL string for the preferred format, or first available if preferred not found
+ */
+declare function getPreferredIconUrl(iconUrls: IconUrl[] | undefined, preferredFormat?: "svg" | "png"): string | undefined;
+interface FiatCurrency {
+    currency_code: string;
+    name: string;
+    icon_url: string;
+    icon_urls: IconUrl[];
+    country_codes: string[];
+    default_amount: number;
+    minimum_amount: number;
+    maximum_amount: number;
+    suggested_amounts: number[];
+}
+interface FiatCurrenciesResponse {
+    data: FiatCurrency[];
+    preferred: string[];
+}
+/**
+ * Get supported fiat currencies
+ * @param publishableKey - Optional publishable key, defaults to configured key
+ */
+declare function getFiatCurrencies(publishableKey?: string): Promise<FiatCurrenciesResponse>;
+interface OnrampQuote {
     transaction_type: string;
-    payment_method_type: string;
     source_amount: number;
     source_amount_without_fees: number;
     fiat_amount_without_fees: number;
     destination_amount_without_fees: number | null;
-    source_currency_code: string;
+    source_currency: string;
     country_code: string;
     total_fee: number;
     network_fee: number;
     transaction_fee: number;
     destination_amount: number;
-    destination_currency_code: string;
+    destination_currency: string;
+    destination_network: string;
     exchange_rate: number;
+    payment_method_type: string;
     customer_score: number;
     service_provider: string;
     service_provider_display_name: string;
+    icon_url: string;
+    icon_urls: IconUrl[];
     institution_name: string | null;
-    low_kyc: boolean | null;
+    low_kyc: boolean;
     partner_fee: number | null;
-    icon_url: string;
 }
-interface MeldQuotesRequest {
+interface OnrampQuotesRequest {
     country_code: string;
-    destination_currency_code: string;
     source_amount: string;
-    source_currency_code: string;
+    source_currency: string;
+    destination_currency: string;
+    destination_network: string;
+    subdivision_code?: string;
 }
-interface MeldQuotesResponse {
-    data: MeldQuote[];
+interface OnrampQuotesResponse {
+    data: OnrampQuote[];
 }
 /**
- * Get Meld onramp quotes
- * @param request - Meld quotes request
+ * Get unified onramp quotes from all providers
+ * @param request - Onramp quotes request
  * @param publishableKey - Optional publishable key, defaults to configured key
  */
-declare function getMeldQuotes(request: MeldQuotesRequest, publishableKey?: string): Promise<MeldQuotesResponse>;
-interface MeldSessionRequest {
+declare function getOnrampQuotes(request: OnrampQuotesRequest, publishableKey?: string): Promise<OnrampQuotesResponse>;
+interface OnrampSessionRequest {
     service_provider: string;
     country_code: string;
-    destination_currency_code: string;
-    source_currency_code: string;
-    wallet_address: string;
+    source_currency: string;
     source_amount: string;
+    destination_currency: string;
+    destination_network: string;
+    wallet_address: string;
+    subdivision_code?: string;
+    redirect_url?: string;
 }
-interface MeldSessionResponse {
-    id: string;
-    external_session_id: string | null;
-    external_customer_id: string | null;
-    customer_id: string;
-    widget_url: string;
-    service_provider_widget_url: string;
-    token: string;
+interface OnrampSessionResponse {
+    url: string;
+    service_provider: string;
 }
 /**
- * Create a Meld onramp session
- * @param request - Meld session request
+ * Create a unified onramp session
+ * @param request - Onramp session request
  * @param publishableKey - Optional publishable key, defaults to configured key
  */
-declare function createMeldSession(request: MeldSessionRequest, publishableKey?: string): Promise<MeldSessionResponse>;
+declare function createOnrampSession(request: OnrampSessionRequest, publishableKey?: string): Promise<OnrampSessionResponse>;
 /**
- * Get the preferred icon URL from an array of icon URLs
- * @param iconUrls - Array of icon URLs with format information
- * @param preferredFormat - Preferred format ("svg" or "png"), defaults to "svg"
- * @returns The URL string for the preferred format, or first available if preferred not found
+ * Generate a URL for the sessions/start endpoint that redirects to the onramp provider.
+ * This is useful for avoiding popup blockers by opening the URL directly via anchor tag.
+ * @param request - Onramp session request (same parameters as createOnrampSession)
+ * @param publishableKey - Publishable key (required)
+ * @returns URL string that can be used in an anchor tag or window.open()
  */
-declare function getPreferredIconUrl(iconUrls: IconUrl[] | undefined, preferredFormat?: "svg" | "png"): string | undefined;
-interface FiatCurrency {
-    currency_code: string;
-    name: string;
+declare function getOnrampSessionStartUrl(request: OnrampSessionRequest, publishableKey: string): string;
+interface DefaultTokenChain {
+    icon_url: string;
+    icon_urls: IconUrl[];
+    chain_id: string;
+    chain_name: string;
+    chain_type: string;
+}
+interface DefaultTokenMetadata {
     icon_url: string;
-    icon_urls?: IconUrl[];
-    country_codes?: string[];
+    icon_urls: IconUrl[];
+    decimals: number;
+    symbol: string;
+    name: string;
+    token_address: string;
+    chain_id: string;
+    chain_type: string;
+    chain_name: string;
+    chain: DefaultTokenChain;
 }
-interface FiatCurrenciesResponse {
-    data: FiatCurrency[];
-    preferred: string[];
+interface DefaultTokenResponse {
+    destination_network: string;
+    destination_currency: string;
+    destination_token_metadata: DefaultTokenMetadata;
+    estimated_processing_time: number | null;
 }
 /**
- * Get supported fiat currencies
+ * Get default onramp token for a given token/chain combination
+ * @param params - Query parameters
  * @param publishableKey - Optional publishable key, defaults to configured key
  */
-declare function getFiatCurrencies(publishableKey?: string): Promise<FiatCurrenciesResponse>;
+declare function getDefaultOnrampToken(params: {
+    country_code?: string;
+    subdivision_code?: string;
+    token_address: string;
+    chain_id: string;
+    chain_type: string;
+}, publishableKey?: string): Promise<DefaultTokenResponse>;
 interface TokenChainIconUrl {
     url: string;
     format: string;
@@ -306,6 +386,93 @@ interface IpAddressResponse {
  * This is a public endpoint that doesn't require authentication
  */
 declare function getIpAddress(): Promise<IpAddressResponse>;
+interface TokenIconUrl {
+    url: string;
+    format: string;
+}
+interface TokenInfo {
+    symbol: string;
+    name: string;
+    icon_url: string;
+    icon_urls: TokenIconUrl[];
+    token_address: string;
+    chain_id: string;
+    chain_name: string;
+    chain_type: string;
+    decimals: number;
+    minimum_deposit_amount_usd: number;
+    chain_icon_url: string;
+    chain_icon_urls: TokenIconUrl[];
+}
+interface TokenBalance {
+    amount: string;
+    amount_usd: string | null;
+    exchange_rate: string | null;
+    is_eligible: boolean;
+    token: TokenInfo;
+}
+interface AddressBalancesResponse {
+    address: string;
+    chain_type: string;
+    balances: TokenBalance[];
+}
+/**
+ * Get token balances for a wallet address
+ * Returns balances for all supported deposit tokens on the specified chain type
+ * @param address - Wallet address to check balances for
+ * @param chainType - Chain type to fetch balances for ('ethereum', 'solana', or 'bitcoin')
+ * @param publishableKey - Optional publishable key, defaults to configured key
+ */
+declare function getAddressBalances(address: string, chainType: 'ethereum' | 'solana' | 'bitcoin', publishableKey?: string): Promise<AddressBalancesResponse>;
+interface AddressBalanceResponse {
+    address: string;
+    chain_type: string;
+    chain_id: string;
+    token_address: string;
+    balance: TokenBalance | null;
+}
+/**
+ * Get balance for a specific token on a specific chain
+ * Returns the balance for a single token, or null if not found or zero balance
+ * @param address - Wallet address to check balance for
+ * @param chainType - Chain type ('ethereum', 'solana', or 'bitcoin')
+ * @param chainId - Chain ID (e.g., "1" for Ethereum mainnet)
+ * @param tokenAddress - Token contract address or "native" for native tokens
+ * @param publishableKey - Optional publishable key, defaults to configured key
+ */
+declare function getAddressBalance(address: string, chainType: 'ethereum' | 'solana' | 'bitcoin', chainId: string, tokenAddress: string, publishableKey?: string): Promise<AddressBalanceResponse>;
+interface VerifyAddressRequest {
+    chain_type: string;
+    chain_id: string;
+    token_address: string;
+    recipient_address: string;
+}
+/**
+ * Standard error codes for address validation failures.
+ * Used by frontend to display localized error messages.
+ */
+type AddressValidationFailureCode = 'token_not_supported' | 'not_opted_in' | 'insufficient_balance' | 'account_not_found' | 'validation_error';
+interface AddressValidationMetadata {
+    chain_name?: string;
+    token_symbol?: string;
+}
+interface VerifyAddressResponse {
+    valid: boolean;
+    /** Standardized error code for frontend i18n */
+    failure_code?: AddressValidationFailureCode;
+    /** Metadata for message interpolation */
+    metadata?: AddressValidationMetadata;
+}
+/**
+ * Verify if a recipient address can receive funds for a given chain/token
+ * This is useful to check before confirming a transfer, especially for Algorand
+ * where recipients must opt-in to assets before receiving them.
+ *
+ * @param request - Verification request with chain_type, chain_id, token_address, recipient_address
+ * @param publishableKey - Optional publishable key, defaults to configured key
+ * @returns Verification result with valid status and reason if invalid
+ */
+declare function verifyRecipientAddress(request: VerifyAddressRequest, publishableKey?: string): Promise<VerifyAddressResponse>;
 
 /**
  * User IP information interface
@@ -401,4 +568,4 @@ declare const i18n: {
 };
 type I18nStrings = typeof i18n;
 
-export { type AutoSwapRequest, type AutoSwapResponse, type CreateDepositAddressRequest, type DepositAddressResponse, ExecutionStatus, type FeaturedToken, type FiatCurrenciesResponse, type FiatCurrency, type I18nStrings, type IconUrl, type IpAddressResponse, type MeldQuote, type MeldQuotesRequest, type MeldQuotesResponse, type MeldSessionRequest, type MeldSessionResponse, type PaymentNetwork, type ProjectConfigResponse, type QueryExecutionsRequest, type QueryExecutionsResponse, SOLANA_USDC_ADDRESS, type SupportedChain, type SupportedDepositTokensResponse, type SupportedToken, type TokenChain, type TokenChainIconUrl, type TokenChainsResponse, type UserIpInfo, type Wallet, createDepositAddress, createMeldSession, getApiBaseUrl, getChainName, getFiatCurrencies, getIconUrl, getIconUrlWithCdn, getIpAddress, getMeldQuotes, getPreferredIconUrl, getProjectConfig, getSupportedDepositTokens, getTokenChains, getWalletByChainType, i18n, queryExecutions, setApiConfig, useUserIp };
+export { type AddressBalanceResponse, type AddressBalancesResponse, type AddressValidationFailureCode, type AddressValidationMetadata, type AutoSwapRequest, type AutoSwapResponse, type CreateDepositAddressRequest, type DefaultTokenChain, type DefaultTokenMetadata, type DefaultTokenResponse, type DepositAddressResponse, ExecutionStatus, type FeaturedToken, type FiatCurrenciesResponse, type FiatCurrency, type I18nStrings, type IconUrl, type IpAddressResponse, type OnrampQuote, type OnrampQuotesRequest, type OnrampQuotesResponse, type OnrampSessionRequest, type OnrampSessionResponse, type PaymentNetwork, type ProjectConfigResponse, type QueryExecutionsRequest, type QueryExecutionsResponse, SOLANA_USDC_ADDRESS, type SupportedChain, type SupportedDepositTokensResponse, type SupportedToken, type TokenBalance, type TokenChain, type TokenChainIconUrl, type TokenChainsResponse, type TokenIconUrl, type TokenInfo, type TokenMetadata, type UserIpInfo, type VerifyAddressRequest, type VerifyAddressResponse, type Wallet, createDepositAddress, createOnrampSession, getAddressBalance, getAddressBalances, getApiBaseUrl, getChainName, getDefaultOnrampToken, getFiatCurrencies, getIconUrl, getIconUrlWithCdn, getIpAddress, getOnrampQuotes, getOnrampSessionStartUrl, getPreferredIconUrl, getProjectConfig, getSupportedDepositTokens, getTokenChains, getTokenMetadata, getWalletByChainType, i18n, queryExecutions, setApiConfig, useUserIp, verifyRecipientAddress };

package/dist/index.js

@@ -23,23 +23,29 @@ __export(index_exports, {
   ExecutionStatus: () => ExecutionStatus,
   SOLANA_USDC_ADDRESS: () => SOLANA_USDC_ADDRESS,
   createDepositAddress: () => createDepositAddress,
-  createMeldSession: () => createMeldSession,
+  createOnrampSession: () => createOnrampSession,
+  getAddressBalance: () => getAddressBalance,
+  getAddressBalances: () => getAddressBalances,
   getApiBaseUrl: () => getApiBaseUrl,
   getChainName: () => getChainName,
+  getDefaultOnrampToken: () => getDefaultOnrampToken,
   getFiatCurrencies: () => getFiatCurrencies,
   getIconUrl: () => getIconUrl,
   getIconUrlWithCdn: () => getIconUrlWithCdn,
   getIpAddress: () => getIpAddress,
-  getMeldQuotes: () => getMeldQuotes,
+  getOnrampQuotes: () => getOnrampQuotes,
+  getOnrampSessionStartUrl: () => getOnrampSessionStartUrl,
   getPreferredIconUrl: () => getPreferredIconUrl,
   getProjectConfig: () => getProjectConfig,
   getSupportedDepositTokens: () => getSupportedDepositTokens,
   getTokenChains: () => getTokenChains,
+  getTokenMetadata: () => getTokenMetadata,
   getWalletByChainType: () => getWalletByChainType,
   i18n: () => i18n,
   queryExecutions: () => queryExecutions,
   setApiConfig: () => setApiConfig,
-  useUserIp: () => useUserIp
+  useUserIp: () => useUserIp,
+  verifyRecipientAddress: () => verifyRecipientAddress
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -158,11 +164,42 @@ async function queryExecutions(externalUserId, publishableKey) {
   }
   return response.json();
 }
-async function getSupportedDepositTokens(publishableKey) {
+async function getSupportedDepositTokens(publishableKey, options) {
   const pk = publishableKey || DEFAULT_PUBLISHABLE_KEY;
   validatePublishableKey(pk);
+  let url = `${API_BASE_URL}/v1/public/tokens/supported_deposit_tokens`;
+  if (options?.destination_token_address && options?.destination_chain_id && options?.destination_chain_type) {
+    const params = new URLSearchParams({
+      destination_token_address: options.destination_token_address,
+      destination_chain_id: options.destination_chain_id,
+      destination_chain_type: options.destination_chain_type
+    });
+    url = `${url}?${params.toString()}`;
+  }
+  const response = await fetch(url, {
+    method: "GET",
+    headers: {
+      accept: "application/json",
+      "x-publishable-key": pk
+    }
+  });
+  if (!response.ok) {
+    throw new Error(
+      `Failed to fetch supported deposit tokens: ${response.statusText}`
+    );
+  }
+  return response.json();
+}
+async function getTokenMetadata(request, publishableKey) {
+  const pk = publishableKey || DEFAULT_PUBLISHABLE_KEY;
+  validatePublishableKey(pk);
+  const params = new URLSearchParams({
+    chainType: request.chain_type,
+    chainId: request.chain_id,
+    tokenAddress: request.token_address
+  });
   const response = await fetch(
-    `${API_BASE_URL}/v1/public/tokens/supported_deposit_tokens`,
+    `${API_BASE_URL}/v1/public/tokens/token?${params.toString()}`,
     {
       method: "GET",
       headers: {
@@ -172,17 +209,43 @@ async function getSupportedDepositTokens(publishableKey) {
     }
   );
   if (!response.ok) {
-    throw new Error(
-      `Failed to fetch supported deposit tokens: ${response.statusText}`
-    );
+    throw new Error(`Failed to fetch token metadata: ${response.statusText}`);
+  }
+  return response.json();
+}
+function getPreferredIconUrl(iconUrls, preferredFormat = "svg") {
+  if (!iconUrls || iconUrls.length === 0) {
+    return void 0;
+  }
+  const preferred = iconUrls.find((icon) => icon.format === preferredFormat);
+  if (preferred) {
+    return preferred.url;
+  }
+  return iconUrls[0]?.url;
+}
+async function getFiatCurrencies(publishableKey) {
+  const pk = publishableKey || DEFAULT_PUBLISHABLE_KEY;
+  validatePublishableKey(pk);
+  const response = await fetch(
+    `${API_BASE_URL}/v1/public/onramps/fiat_currencies`,
+    {
+      method: "GET",
+      headers: {
+        accept: "application/json",
+        "x-publishable-key": pk
+      }
+    }
+  );
+  if (!response.ok) {
+    throw new Error(`Failed to fetch fiat currencies: ${response.statusText}`);
   }
   return response.json();
 }
-async function getMeldQuotes(request, publishableKey) {
+async function getOnrampQuotes(request, publishableKey) {
   const pk = publishableKey || DEFAULT_PUBLISHABLE_KEY;
   validatePublishableKey(pk);
   const response = await fetch(
-    `${API_BASE_URL}/v1/public/onramps/meld/quotes`,
+    `${API_BASE_URL}/v1/public/onramps/quotes`,
     {
       method: "POST",
       headers: {
@@ -194,15 +257,15 @@ async function getMeldQuotes(request, publishableKey) {
     }
   );
   if (!response.ok) {
-    throw new Error(`Failed to fetch Meld quotes: ${response.statusText}`);
+    throw new Error(`Failed to fetch onramp quotes: ${response.statusText}`);
   }
   return response.json();
 }
-async function createMeldSession(request, publishableKey) {
+async function createOnrampSession(request, publishableKey) {
   const pk = publishableKey || DEFAULT_PUBLISHABLE_KEY;
   validatePublishableKey(pk);
   const response = await fetch(
-    `${API_BASE_URL}/v1/public/onramps/meld/sessions`,
+    `${API_BASE_URL}/v1/public/onramps/sessions`,
     {
       method: "POST",
       headers: {
@@ -214,25 +277,36 @@ async function createMeldSession(request, publishableKey) {
     }
   );
   if (!response.ok) {
-    throw new Error(`Failed to create Meld session: ${response.statusText}`);
+    throw new Error(`Failed to create onramp session: ${response.statusText}`);
   }
   return response.json();
 }
-function getPreferredIconUrl(iconUrls, preferredFormat = "svg") {
-  if (!iconUrls || iconUrls.length === 0) {
-    return void 0;
+function getOnrampSessionStartUrl(request, publishableKey) {
+  const params = new URLSearchParams();
+  params.append("publishable_key", publishableKey);
+  params.append("service_provider", request.service_provider);
+  params.append("country_code", request.country_code);
+  params.append("source_currency", request.source_currency);
+  params.append("source_amount", request.source_amount);
+  params.append("destination_currency", request.destination_currency);
+  params.append("destination_network", request.destination_network);
+  params.append("wallet_address", request.wallet_address);
+  if (request.subdivision_code) {
+    params.append("subdivision_code", request.subdivision_code);
   }
-  const preferred = iconUrls.find((icon) => icon.format === preferredFormat);
-  if (preferred) {
-    return preferred.url;
-  }
-  return iconUrls[0]?.url;
+  return `${API_BASE_URL}/v1/public/onramps/sessions/start?${params.toString()}`;
 }
-async function getFiatCurrencies(publishableKey) {
+async function getDefaultOnrampToken(params, publishableKey) {
   const pk = publishableKey || DEFAULT_PUBLISHABLE_KEY;
   validatePublishableKey(pk);
+  const queryParams = new URLSearchParams();
+  if (params.country_code) queryParams.append("country_code", params.country_code);
+  if (params.subdivision_code) queryParams.append("subdivision_code", params.subdivision_code);
+  queryParams.append("token_address", params.token_address);
+  queryParams.append("chain_id", params.chain_id);
+  queryParams.append("chain_type", params.chain_type);
   const response = await fetch(
-    `${API_BASE_URL}/v1/public/onramps/fiat_currencies`,
+    `${API_BASE_URL}/v1/public/onramps/default_token?${queryParams.toString()}`,
     {
       method: "GET",
       headers: {
@@ -242,7 +316,7 @@ async function getFiatCurrencies(publishableKey) {
     }
   );
   if (!response.ok) {
-    throw new Error(`Failed to fetch fiat currencies: ${response.statusText}`);
+    throw new Error(`Failed to fetch default onramp token: ${response.statusText}`);
   }
   return response.json();
 }
@@ -259,10 +333,14 @@ async function getTokenChains() {
   return response.json();
 }
 function getChainName(chains, chainType, chainId) {
+  if (!chainType && !chainId) return "Unknown";
+  const target = chains.find((c) => c.chain_id === chainId && c.chain_type === chainType);
+  if (target) return target.chain_name;
   const byId = chains.find((c) => c.chain_id === chainId);
   if (byId) return byId.chain_name;
   const byType = chains.find((c) => c.chain_type === chainType);
   if (byType) return byType.chain_name;
+  if (!chainType) return chainId || "Unknown";
   return chainType.charAt(0).toUpperCase() + chainType.slice(1);
 }
 async function getProjectConfig(publishableKey) {
@@ -296,6 +374,71 @@ async function getIpAddress() {
   }
   return response.json();
 }
+async function getAddressBalances(address, chainType, publishableKey) {
+  const pk = publishableKey || DEFAULT_PUBLISHABLE_KEY;
+  validatePublishableKey(pk);
+  const url = `${API_BASE_URL}/v1/public/addresses/balances`;
+  const response = await fetch(url, {
+    method: "POST",
+    headers: {
+      "Content-Type": "application/json",
+      accept: "application/json",
+      "x-publishable-key": pk
+    },
+    body: JSON.stringify({
+      address,
+      chain_type: chainType
+    })
+  });
+  if (!response.ok) {
+    throw new Error(`Failed to fetch address balances: ${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);
+  const url = `${API_BASE_URL}/v1/public/addresses/balance`;
+  const response = await fetch(url, {
+    method: "POST",
+    headers: {
+      "Content-Type": "application/json",
+      accept: "application/json",
+      "x-publishable-key": pk
+    },
+    body: JSON.stringify({
+      address,
+      chain_type: chainType,
+      chain_id: chainId,
+      token_address: tokenAddress
+    })
+  });
+  if (!response.ok) {
+    throw new Error(`Failed to fetch address balance: ${response.statusText}`);
+  }
+  const data = await response.json();
+  return data;
+}
+async function verifyRecipientAddress(request, publishableKey) {
+  const pk = publishableKey || DEFAULT_PUBLISHABLE_KEY;
+  validatePublishableKey(pk);
+  const response = await fetch(`${API_BASE_URL}/v1/public/addresses/verify`, {
+    method: "POST",
+    headers: {
+      accept: "application/json",
+      "x-publishable-key": pk,
+      "Content-Type": "application/json"
+    },
+    body: JSON.stringify(request)
+  });
+  if (!response.ok) {
+    throw new Error(
+      `Failed to verify recipient address: ${response.statusText}`
+    );
+  }
+  return response.json();
+}
 
 // src/hooks/use-user-ip.ts
 var import_react_query = require("@tanstack/react-query");
@@ -405,21 +548,27 @@ var i18n = en_default;
   ExecutionStatus,
   SOLANA_USDC_ADDRESS,
   createDepositAddress,
-  createMeldSession,
+  createOnrampSession,
+  getAddressBalance,
+  getAddressBalances,
   getApiBaseUrl,
   getChainName,
+  getDefaultOnrampToken,
   getFiatCurrencies,
   getIconUrl,
   getIconUrlWithCdn,
   getIpAddress,
-  getMeldQuotes,
+  getOnrampQuotes,
+  getOnrampSessionStartUrl,
   getPreferredIconUrl,
   getProjectConfig,
   getSupportedDepositTokens,
   getTokenChains,
+  getTokenMetadata,
   getWalletByChainType,
   i18n,
   queryExecutions,
   setApiConfig,
-  useUserIp
+  useUserIp,
+  verifyRecipientAddress
 });

package/dist/index.mjs

@@ -113,11 +113,42 @@ async function queryExecutions(externalUserId, publishableKey) {
   }
   return response.json();
 }
-async function getSupportedDepositTokens(publishableKey) {
+async function getSupportedDepositTokens(publishableKey, options) {
   const pk = publishableKey || DEFAULT_PUBLISHABLE_KEY;
   validatePublishableKey(pk);
+  let url = `${API_BASE_URL}/v1/public/tokens/supported_deposit_tokens`;
+  if (options?.destination_token_address && options?.destination_chain_id && options?.destination_chain_type) {
+    const params = new URLSearchParams({
+      destination_token_address: options.destination_token_address,
+      destination_chain_id: options.destination_chain_id,
+      destination_chain_type: options.destination_chain_type
+    });
+    url = `${url}?${params.toString()}`;
+  }
+  const response = await fetch(url, {
+    method: "GET",
+    headers: {
+      accept: "application/json",
+      "x-publishable-key": pk
+    }
+  });
+  if (!response.ok) {
+    throw new Error(
+      `Failed to fetch supported deposit tokens: ${response.statusText}`
+    );
+  }
+  return response.json();
+}
+async function getTokenMetadata(request, publishableKey) {
+  const pk = publishableKey || DEFAULT_PUBLISHABLE_KEY;
+  validatePublishableKey(pk);
+  const params = new URLSearchParams({
+    chainType: request.chain_type,
+    chainId: request.chain_id,
+    tokenAddress: request.token_address
+  });
   const response = await fetch(
-    `${API_BASE_URL}/v1/public/tokens/supported_deposit_tokens`,
+    `${API_BASE_URL}/v1/public/tokens/token?${params.toString()}`,
     {
       method: "GET",
       headers: {
@@ -127,17 +158,43 @@ async function getSupportedDepositTokens(publishableKey) {
     }
   );
   if (!response.ok) {
-    throw new Error(
-      `Failed to fetch supported deposit tokens: ${response.statusText}`
-    );
+    throw new Error(`Failed to fetch token metadata: ${response.statusText}`);
+  }
+  return response.json();
+}
+function getPreferredIconUrl(iconUrls, preferredFormat = "svg") {
+  if (!iconUrls || iconUrls.length === 0) {
+    return void 0;
+  }
+  const preferred = iconUrls.find((icon) => icon.format === preferredFormat);
+  if (preferred) {
+    return preferred.url;
+  }
+  return iconUrls[0]?.url;
+}
+async function getFiatCurrencies(publishableKey) {
+  const pk = publishableKey || DEFAULT_PUBLISHABLE_KEY;
+  validatePublishableKey(pk);
+  const response = await fetch(
+    `${API_BASE_URL}/v1/public/onramps/fiat_currencies`,
+    {
+      method: "GET",
+      headers: {
+        accept: "application/json",
+        "x-publishable-key": pk
+      }
+    }
+  );
+  if (!response.ok) {
+    throw new Error(`Failed to fetch fiat currencies: ${response.statusText}`);
   }
   return response.json();
 }
-async function getMeldQuotes(request, publishableKey) {
+async function getOnrampQuotes(request, publishableKey) {
   const pk = publishableKey || DEFAULT_PUBLISHABLE_KEY;
   validatePublishableKey(pk);
   const response = await fetch(
-    `${API_BASE_URL}/v1/public/onramps/meld/quotes`,
+    `${API_BASE_URL}/v1/public/onramps/quotes`,
     {
       method: "POST",
       headers: {
@@ -149,15 +206,15 @@ async function getMeldQuotes(request, publishableKey) {
     }
   );
   if (!response.ok) {
-    throw new Error(`Failed to fetch Meld quotes: ${response.statusText}`);
+    throw new Error(`Failed to fetch onramp quotes: ${response.statusText}`);
   }
   return response.json();
 }
-async function createMeldSession(request, publishableKey) {
+async function createOnrampSession(request, publishableKey) {
   const pk = publishableKey || DEFAULT_PUBLISHABLE_KEY;
   validatePublishableKey(pk);
   const response = await fetch(
-    `${API_BASE_URL}/v1/public/onramps/meld/sessions`,
+    `${API_BASE_URL}/v1/public/onramps/sessions`,
     {
       method: "POST",
       headers: {
@@ -169,25 +226,36 @@ async function createMeldSession(request, publishableKey) {
     }
   );
   if (!response.ok) {
-    throw new Error(`Failed to create Meld session: ${response.statusText}`);
+    throw new Error(`Failed to create onramp session: ${response.statusText}`);
   }
   return response.json();
 }
-function getPreferredIconUrl(iconUrls, preferredFormat = "svg") {
-  if (!iconUrls || iconUrls.length === 0) {
-    return void 0;
+function getOnrampSessionStartUrl(request, publishableKey) {
+  const params = new URLSearchParams();
+  params.append("publishable_key", publishableKey);
+  params.append("service_provider", request.service_provider);
+  params.append("country_code", request.country_code);
+  params.append("source_currency", request.source_currency);
+  params.append("source_amount", request.source_amount);
+  params.append("destination_currency", request.destination_currency);
+  params.append("destination_network", request.destination_network);
+  params.append("wallet_address", request.wallet_address);
+  if (request.subdivision_code) {
+    params.append("subdivision_code", request.subdivision_code);
   }
-  const preferred = iconUrls.find((icon) => icon.format === preferredFormat);
-  if (preferred) {
-    return preferred.url;
-  }
-  return iconUrls[0]?.url;
+  return `${API_BASE_URL}/v1/public/onramps/sessions/start?${params.toString()}`;
 }
-async function getFiatCurrencies(publishableKey) {
+async function getDefaultOnrampToken(params, publishableKey) {
   const pk = publishableKey || DEFAULT_PUBLISHABLE_KEY;
   validatePublishableKey(pk);
+  const queryParams = new URLSearchParams();
+  if (params.country_code) queryParams.append("country_code", params.country_code);
+  if (params.subdivision_code) queryParams.append("subdivision_code", params.subdivision_code);
+  queryParams.append("token_address", params.token_address);
+  queryParams.append("chain_id", params.chain_id);
+  queryParams.append("chain_type", params.chain_type);
   const response = await fetch(
-    `${API_BASE_URL}/v1/public/onramps/fiat_currencies`,
+    `${API_BASE_URL}/v1/public/onramps/default_token?${queryParams.toString()}`,
     {
       method: "GET",
       headers: {
@@ -197,7 +265,7 @@ async function getFiatCurrencies(publishableKey) {
     }
   );
   if (!response.ok) {
-    throw new Error(`Failed to fetch fiat currencies: ${response.statusText}`);
+    throw new Error(`Failed to fetch default onramp token: ${response.statusText}`);
   }
   return response.json();
 }
@@ -214,10 +282,14 @@ async function getTokenChains() {
   return response.json();
 }
 function getChainName(chains, chainType, chainId) {
+  if (!chainType && !chainId) return "Unknown";
+  const target = chains.find((c) => c.chain_id === chainId && c.chain_type === chainType);
+  if (target) return target.chain_name;
   const byId = chains.find((c) => c.chain_id === chainId);
   if (byId) return byId.chain_name;
   const byType = chains.find((c) => c.chain_type === chainType);
   if (byType) return byType.chain_name;
+  if (!chainType) return chainId || "Unknown";
   return chainType.charAt(0).toUpperCase() + chainType.slice(1);
 }
 async function getProjectConfig(publishableKey) {
@@ -251,6 +323,71 @@ async function getIpAddress() {
   }
   return response.json();
 }
+async function getAddressBalances(address, chainType, publishableKey) {
+  const pk = publishableKey || DEFAULT_PUBLISHABLE_KEY;
+  validatePublishableKey(pk);
+  const url = `${API_BASE_URL}/v1/public/addresses/balances`;
+  const response = await fetch(url, {
+    method: "POST",
+    headers: {
+      "Content-Type": "application/json",
+      accept: "application/json",
+      "x-publishable-key": pk
+    },
+    body: JSON.stringify({
+      address,
+      chain_type: chainType
+    })
+  });
+  if (!response.ok) {
+    throw new Error(`Failed to fetch address balances: ${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);
+  const url = `${API_BASE_URL}/v1/public/addresses/balance`;
+  const response = await fetch(url, {
+    method: "POST",
+    headers: {
+      "Content-Type": "application/json",
+      accept: "application/json",
+      "x-publishable-key": pk
+    },
+    body: JSON.stringify({
+      address,
+      chain_type: chainType,
+      chain_id: chainId,
+      token_address: tokenAddress
+    })
+  });
+  if (!response.ok) {
+    throw new Error(`Failed to fetch address balance: ${response.statusText}`);
+  }
+  const data = await response.json();
+  return data;
+}
+async function verifyRecipientAddress(request, publishableKey) {
+  const pk = publishableKey || DEFAULT_PUBLISHABLE_KEY;
+  validatePublishableKey(pk);
+  const response = await fetch(`${API_BASE_URL}/v1/public/addresses/verify`, {
+    method: "POST",
+    headers: {
+      accept: "application/json",
+      "x-publishable-key": pk,
+      "Content-Type": "application/json"
+    },
+    body: JSON.stringify(request)
+  });
+  if (!response.ok) {
+    throw new Error(
+      `Failed to verify recipient address: ${response.statusText}`
+    );
+  }
+  return response.json();
+}
 
 // src/hooks/use-user-ip.ts
 import { useQuery } from "@tanstack/react-query";
@@ -359,21 +496,27 @@ export {
   ExecutionStatus,
   SOLANA_USDC_ADDRESS,
   createDepositAddress,
-  createMeldSession,
+  createOnrampSession,
+  getAddressBalance,
+  getAddressBalances,
   getApiBaseUrl,
   getChainName,
+  getDefaultOnrampToken,
   getFiatCurrencies,
   getIconUrl,
   getIconUrlWithCdn,
   getIpAddress,
-  getMeldQuotes,
+  getOnrampQuotes,
+  getOnrampSessionStartUrl,
   getPreferredIconUrl,
   getProjectConfig,
   getSupportedDepositTokens,
   getTokenChains,
+  getTokenMetadata,
   getWalletByChainType,
   i18n,
   queryExecutions,
   setApiConfig,
-  useUserIp
+  useUserIp,
+  verifyRecipientAddress
 };

package/package.json

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