@unifold/core 0.1.25 → 0.1.27

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" | "algorand";
+    chain_type: "ethereum" | "solana" | "bitcoin" | "algorand" | "xrpl";
     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" | "algorand"): Wallet | undefined;
+declare function getWalletByChainType(wallets: Wallet[], chainType: "ethereum" | "solana" | "bitcoin" | "algorand" | "xrpl"): Wallet | undefined;
 interface AutoSwapRequest {
     wallet_id: string;
     origin_currency: string;
@@ -374,6 +374,7 @@ interface PaymentNetwork {
     icon_urls: IconUrl[];
 }
 interface ProjectConfigResponse {
+    project_name?: string;
     asset_cdn_url: string;
     transfer_crypto: {
         networks: FeaturedToken[];
@@ -419,11 +420,16 @@ interface TokenInfo {
     chain_icon_url: string;
     chain_icon_urls: TokenIconUrl[];
 }
+declare enum IneligibilityReason {
+    MINIMUM_NOT_MET = "minimum_not_met",
+    NOT_SUPPORTED_DEPOSIT_FROM = "not_supported_deposit_from"
+}
 interface TokenBalance {
     amount: string;
     amount_usd: string | null;
     exchange_rate: string | null;
     is_eligible: boolean;
+    ineligibility_reason: IneligibilityReason | null;
     token: TokenInfo;
 }
 interface AddressBalancesResponse {
@@ -488,6 +494,48 @@ interface VerifyAddressResponse {
  * @returns Verification result with valid status and reason if invalid
  */
 declare function verifyRecipientAddress(request: VerifyAddressRequest, publishableKey?: string): Promise<VerifyAddressResponse>;
+interface BuildSolanaTransactionRequest {
+    chain_id: string;
+    token_address: string;
+    source_address: string;
+    destination_address: string;
+    amount: string;
+}
+interface BuildSolanaTransactionResponse {
+    encoding: 'base64';
+    transaction: string;
+}
+/**
+ * Build a Solana transaction for transferring SOL or SPL tokens.
+ * Returns an unsigned VersionedTransaction that must be signed by the user's wallet.
+ *
+ * Features:
+ * - Native SOL transfers (use "native" as token_address)
+ * - SPL Token transfers (standard Token Program)
+ * - SPL Token-2022 transfers (Token Extensions)
+ * - Automatic ATA (Associated Token Account) creation with idempotency
+ *
+ * @param request - Transaction details including chain_id, token_address, source/destination addresses, and amount
+ * @param publishableKey - Optional publishable key, defaults to configured key
+ * @returns Unsigned transaction in base64 format that needs to be signed by the wallet
+ */
+declare function buildSolanaTransaction(request: BuildSolanaTransactionRequest, publishableKey?: string): Promise<BuildSolanaTransactionResponse>;
+interface SendSolanaTransactionRequest {
+    chain_id: string;
+    signed_transaction: string;
+}
+interface SendSolanaTransactionResponse {
+    signature: string;
+}
+/**
+ * Send a signed Solana transaction to the network.
+ * The transaction must have been previously built using buildSolanaTransaction() and signed by the user's wallet.
+ *
+ * @param request - Contains chain_id and the signed transaction in base64 format
+ * @param publishableKey - Optional publishable key, defaults to configured key
+ * @returns Transaction signature (hash) that can be used to track the transaction
+ */
+declare function sendSolanaTransaction(request: SendSolanaTransactionRequest, publishableKey?: string): Promise<SendSolanaTransactionResponse>;
 
 /**
  * User IP information interface
@@ -583,4 +631,4 @@ declare const i18n: {
 };
 type I18nStrings = typeof i18n;
 
-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 PollExecutionsRequest, type PollExecutionsResponse, 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, pollDirectExecutions, queryExecutions, setApiConfig, useUserIp, verifyRecipientAddress };
+export { type AddressBalanceResponse, type AddressBalancesResponse, type AddressValidationFailureCode, type AddressValidationMetadata, type AutoSwapRequest, type AutoSwapResponse, type BuildSolanaTransactionRequest, type BuildSolanaTransactionResponse, type CreateDepositAddressRequest, type DefaultTokenChain, type DefaultTokenMetadata, type DefaultTokenResponse, type DepositAddressResponse, ExecutionStatus, type FeaturedToken, type FiatCurrenciesResponse, type FiatCurrency, type I18nStrings, type IconUrl, IneligibilityReason, type IpAddressResponse, type OnrampQuote, type OnrampQuotesRequest, type OnrampQuotesResponse, type OnrampSessionRequest, type OnrampSessionResponse, type PaymentNetwork, type PollExecutionsRequest, type PollExecutionsResponse, type ProjectConfigResponse, type QueryExecutionsRequest, type QueryExecutionsResponse, SOLANA_USDC_ADDRESS, type SendSolanaTransactionRequest, type SendSolanaTransactionResponse, type SupportedChain, type SupportedDepositTokensResponse, type SupportedToken, type TokenBalance, type TokenChain, type TokenChainIconUrl, type TokenChainsResponse, type TokenIconUrl, type TokenInfo, type TokenMetadata, type UserIpInfo, type VerifyAddressRequest, type VerifyAddressResponse, type Wallet, buildSolanaTransaction, createDepositAddress, createOnrampSession, getAddressBalance, getAddressBalances, getApiBaseUrl, getChainName, getDefaultOnrampToken, getFiatCurrencies, getIconUrl, getIconUrlWithCdn, getIpAddress, getOnrampQuotes, getOnrampSessionStartUrl, getPreferredIconUrl, getProjectConfig, getSupportedDepositTokens, getTokenChains, getTokenMetadata, getWalletByChainType, i18n, pollDirectExecutions, queryExecutions, sendSolanaTransaction, setApiConfig, useUserIp, verifyRecipientAddress };

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" | "algorand";
+    chain_type: "ethereum" | "solana" | "bitcoin" | "algorand" | "xrpl";
     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" | "algorand"): Wallet | undefined;
+declare function getWalletByChainType(wallets: Wallet[], chainType: "ethereum" | "solana" | "bitcoin" | "algorand" | "xrpl"): Wallet | undefined;
 interface AutoSwapRequest {
     wallet_id: string;
     origin_currency: string;
@@ -374,6 +374,7 @@ interface PaymentNetwork {
     icon_urls: IconUrl[];
 }
 interface ProjectConfigResponse {
+    project_name?: string;
     asset_cdn_url: string;
     transfer_crypto: {
         networks: FeaturedToken[];
@@ -419,11 +420,16 @@ interface TokenInfo {
     chain_icon_url: string;
     chain_icon_urls: TokenIconUrl[];
 }
+declare enum IneligibilityReason {
+    MINIMUM_NOT_MET = "minimum_not_met",
+    NOT_SUPPORTED_DEPOSIT_FROM = "not_supported_deposit_from"
+}
 interface TokenBalance {
     amount: string;
     amount_usd: string | null;
     exchange_rate: string | null;
     is_eligible: boolean;
+    ineligibility_reason: IneligibilityReason | null;
     token: TokenInfo;
 }
 interface AddressBalancesResponse {
@@ -488,6 +494,48 @@ interface VerifyAddressResponse {
  * @returns Verification result with valid status and reason if invalid
  */
 declare function verifyRecipientAddress(request: VerifyAddressRequest, publishableKey?: string): Promise<VerifyAddressResponse>;
+interface BuildSolanaTransactionRequest {
+    chain_id: string;
+    token_address: string;
+    source_address: string;
+    destination_address: string;
+    amount: string;
+}
+interface BuildSolanaTransactionResponse {
+    encoding: 'base64';
+    transaction: string;
+}
+/**
+ * Build a Solana transaction for transferring SOL or SPL tokens.
+ * Returns an unsigned VersionedTransaction that must be signed by the user's wallet.
+ *
+ * Features:
+ * - Native SOL transfers (use "native" as token_address)
+ * - SPL Token transfers (standard Token Program)
+ * - SPL Token-2022 transfers (Token Extensions)
+ * - Automatic ATA (Associated Token Account) creation with idempotency
+ *
+ * @param request - Transaction details including chain_id, token_address, source/destination addresses, and amount
+ * @param publishableKey - Optional publishable key, defaults to configured key
+ * @returns Unsigned transaction in base64 format that needs to be signed by the wallet
+ */
+declare function buildSolanaTransaction(request: BuildSolanaTransactionRequest, publishableKey?: string): Promise<BuildSolanaTransactionResponse>;
+interface SendSolanaTransactionRequest {
+    chain_id: string;
+    signed_transaction: string;
+}
+interface SendSolanaTransactionResponse {
+    signature: string;
+}
+/**
+ * Send a signed Solana transaction to the network.
+ * The transaction must have been previously built using buildSolanaTransaction() and signed by the user's wallet.
+ *
+ * @param request - Contains chain_id and the signed transaction in base64 format
+ * @param publishableKey - Optional publishable key, defaults to configured key
+ * @returns Transaction signature (hash) that can be used to track the transaction
+ */
+declare function sendSolanaTransaction(request: SendSolanaTransactionRequest, publishableKey?: string): Promise<SendSolanaTransactionResponse>;
 
 /**
  * User IP information interface
@@ -583,4 +631,4 @@ declare const i18n: {
 };
 type I18nStrings = typeof i18n;
 
-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 PollExecutionsRequest, type PollExecutionsResponse, 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, pollDirectExecutions, queryExecutions, setApiConfig, useUserIp, verifyRecipientAddress };
+export { type AddressBalanceResponse, type AddressBalancesResponse, type AddressValidationFailureCode, type AddressValidationMetadata, type AutoSwapRequest, type AutoSwapResponse, type BuildSolanaTransactionRequest, type BuildSolanaTransactionResponse, type CreateDepositAddressRequest, type DefaultTokenChain, type DefaultTokenMetadata, type DefaultTokenResponse, type DepositAddressResponse, ExecutionStatus, type FeaturedToken, type FiatCurrenciesResponse, type FiatCurrency, type I18nStrings, type IconUrl, IneligibilityReason, type IpAddressResponse, type OnrampQuote, type OnrampQuotesRequest, type OnrampQuotesResponse, type OnrampSessionRequest, type OnrampSessionResponse, type PaymentNetwork, type PollExecutionsRequest, type PollExecutionsResponse, type ProjectConfigResponse, type QueryExecutionsRequest, type QueryExecutionsResponse, SOLANA_USDC_ADDRESS, type SendSolanaTransactionRequest, type SendSolanaTransactionResponse, type SupportedChain, type SupportedDepositTokensResponse, type SupportedToken, type TokenBalance, type TokenChain, type TokenChainIconUrl, type TokenChainsResponse, type TokenIconUrl, type TokenInfo, type TokenMetadata, type UserIpInfo, type VerifyAddressRequest, type VerifyAddressResponse, type Wallet, buildSolanaTransaction, createDepositAddress, createOnrampSession, getAddressBalance, getAddressBalances, getApiBaseUrl, getChainName, getDefaultOnrampToken, getFiatCurrencies, getIconUrl, getIconUrlWithCdn, getIpAddress, getOnrampQuotes, getOnrampSessionStartUrl, getPreferredIconUrl, getProjectConfig, getSupportedDepositTokens, getTokenChains, getTokenMetadata, getWalletByChainType, i18n, pollDirectExecutions, queryExecutions, sendSolanaTransaction, setApiConfig, useUserIp, verifyRecipientAddress };

package/dist/index.js

@@ -21,7 +21,9 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var index_exports = {};
 __export(index_exports, {
   ExecutionStatus: () => ExecutionStatus,
+  IneligibilityReason: () => IneligibilityReason,
   SOLANA_USDC_ADDRESS: () => SOLANA_USDC_ADDRESS,
+  buildSolanaTransaction: () => buildSolanaTransaction,
   createDepositAddress: () => createDepositAddress,
   createOnrampSession: () => createOnrampSession,
   getAddressBalance: () => getAddressBalance,
@@ -44,6 +46,7 @@ __export(index_exports, {
   i18n: () => i18n,
   pollDirectExecutions: () => pollDirectExecutions,
   queryExecutions: () => queryExecutions,
+  sendSolanaTransaction: () => sendSolanaTransaction,
   setApiConfig: () => setApiConfig,
   useUserIp: () => useUserIp,
   verifyRecipientAddress: () => verifyRecipientAddress
@@ -395,6 +398,11 @@ async function getIpAddress() {
   }
   return response.json();
 }
+var IneligibilityReason = /* @__PURE__ */ ((IneligibilityReason2) => {
+  IneligibilityReason2["MINIMUM_NOT_MET"] = "minimum_not_met";
+  IneligibilityReason2["NOT_SUPPORTED_DEPOSIT_FROM"] = "not_supported_deposit_from";
+  return IneligibilityReason2;
+})(IneligibilityReason || {});
 async function getAddressBalances(address, chainType, publishableKey) {
   const pk = publishableKey || DEFAULT_PUBLISHABLE_KEY;
   validatePublishableKey(pk);
@@ -460,6 +468,46 @@ async function verifyRecipientAddress(request, publishableKey) {
   }
   return response.json();
 }
+async function buildSolanaTransaction(request, publishableKey) {
+  const pk = publishableKey || DEFAULT_PUBLISHABLE_KEY;
+  validatePublishableKey(pk);
+  const response = await fetch(`${API_BASE_URL}/v1/public/transactions/solana/build`, {
+    method: "POST",
+    headers: {
+      accept: "application/json",
+      "x-publishable-key": pk,
+      "Content-Type": "application/json"
+    },
+    body: JSON.stringify(request)
+  });
+  if (!response.ok) {
+    const error = await response.json().catch(() => ({ message: response.statusText }));
+    throw new Error(
+      `Failed to build Solana transaction: ${error.message || response.statusText}`
+    );
+  }
+  return response.json();
+}
+async function sendSolanaTransaction(request, publishableKey) {
+  const pk = publishableKey || DEFAULT_PUBLISHABLE_KEY;
+  validatePublishableKey(pk);
+  const response = await fetch(`${API_BASE_URL}/v1/public/transactions/solana/send`, {
+    method: "POST",
+    headers: {
+      accept: "application/json",
+      "x-publishable-key": pk,
+      "Content-Type": "application/json"
+    },
+    body: JSON.stringify(request)
+  });
+  if (!response.ok) {
+    const error = await response.json().catch(() => ({ message: response.statusText }));
+    throw new Error(
+      `Failed to send Solana transaction: ${error.message || response.statusText}`
+    );
+  }
+  return response.json();
+}
 
 // src/hooks/use-user-ip.ts
 var import_react_query = require("@tanstack/react-query");
@@ -567,7 +615,9 @@ var i18n = en_default;
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   ExecutionStatus,
+  IneligibilityReason,
   SOLANA_USDC_ADDRESS,
+  buildSolanaTransaction,
   createDepositAddress,
   createOnrampSession,
   getAddressBalance,
@@ -590,6 +640,7 @@ var i18n = en_default;
   i18n,
   pollDirectExecutions,
   queryExecutions,
+  sendSolanaTransaction,
   setApiConfig,
   useUserIp,
   verifyRecipientAddress

package/dist/index.mjs

@@ -343,6 +343,11 @@ async function getIpAddress() {
   }
   return response.json();
 }
+var IneligibilityReason = /* @__PURE__ */ ((IneligibilityReason2) => {
+  IneligibilityReason2["MINIMUM_NOT_MET"] = "minimum_not_met";
+  IneligibilityReason2["NOT_SUPPORTED_DEPOSIT_FROM"] = "not_supported_deposit_from";
+  return IneligibilityReason2;
+})(IneligibilityReason || {});
 async function getAddressBalances(address, chainType, publishableKey) {
   const pk = publishableKey || DEFAULT_PUBLISHABLE_KEY;
   validatePublishableKey(pk);
@@ -408,6 +413,46 @@ async function verifyRecipientAddress(request, publishableKey) {
   }
   return response.json();
 }
+async function buildSolanaTransaction(request, publishableKey) {
+  const pk = publishableKey || DEFAULT_PUBLISHABLE_KEY;
+  validatePublishableKey(pk);
+  const response = await fetch(`${API_BASE_URL}/v1/public/transactions/solana/build`, {
+    method: "POST",
+    headers: {
+      accept: "application/json",
+      "x-publishable-key": pk,
+      "Content-Type": "application/json"
+    },
+    body: JSON.stringify(request)
+  });
+  if (!response.ok) {
+    const error = await response.json().catch(() => ({ message: response.statusText }));
+    throw new Error(
+      `Failed to build Solana transaction: ${error.message || response.statusText}`
+    );
+  }
+  return response.json();
+}
+async function sendSolanaTransaction(request, publishableKey) {
+  const pk = publishableKey || DEFAULT_PUBLISHABLE_KEY;
+  validatePublishableKey(pk);
+  const response = await fetch(`${API_BASE_URL}/v1/public/transactions/solana/send`, {
+    method: "POST",
+    headers: {
+      accept: "application/json",
+      "x-publishable-key": pk,
+      "Content-Type": "application/json"
+    },
+    body: JSON.stringify(request)
+  });
+  if (!response.ok) {
+    const error = await response.json().catch(() => ({ message: response.statusText }));
+    throw new Error(
+      `Failed to send Solana transaction: ${error.message || response.statusText}`
+    );
+  }
+  return response.json();
+}
 
 // src/hooks/use-user-ip.ts
 import { useQuery } from "@tanstack/react-query";
@@ -514,7 +559,9 @@ var en_default = {
 var i18n = en_default;
 export {
   ExecutionStatus,
+  IneligibilityReason,
   SOLANA_USDC_ADDRESS,
+  buildSolanaTransaction,
   createDepositAddress,
   createOnrampSession,
   getAddressBalance,
@@ -537,6 +584,7 @@ export {
   i18n,
   pollDirectExecutions,
   queryExecutions,
+  sendSolanaTransaction,
   setApiConfig,
   useUserIp,
   verifyRecipientAddress

package/package.json

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