@unifold/core 0.1.24 → 0.1.26

package/dist/index.d.mts

@@ -133,6 +133,21 @@ interface QueryExecutionsResponse {
  * @param publishableKey - Optional publishable key, defaults to configured key
  */
 declare function queryExecutions(externalUserId: string, publishableKey?: string): Promise<QueryExecutionsResponse>;
+interface PollExecutionsRequest {
+    deposit_wallet_id: string;
+}
+interface PollExecutionsResponse {
+    success: boolean;
+    message: string;
+    workflow_id: string;
+    already_running: boolean;
+}
+/**
+ * Start a poll workflow for direct executions on a deposit wallet
+ * @param request - Poll request with deposit_wallet_id
+ * @param publishableKey - Optional publishable key, defaults to configured key
+ */
+declare function pollDirectExecutions(request: PollExecutionsRequest, publishableKey?: string): Promise<PollExecutionsResponse>;
 interface SupportedChain {
     chain_id: string;
     chain_name: string;
@@ -359,6 +374,7 @@ interface PaymentNetwork {
     icon_urls: IconUrl[];
 }
 interface ProjectConfigResponse {
+    project_name?: string;
     asset_cdn_url: string;
     transfer_crypto: {
         networks: FeaturedToken[];
@@ -473,6 +489,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
@@ -568,4 +626,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 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 };
+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, 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

@@ -133,6 +133,21 @@ interface QueryExecutionsResponse {
  * @param publishableKey - Optional publishable key, defaults to configured key
  */
 declare function queryExecutions(externalUserId: string, publishableKey?: string): Promise<QueryExecutionsResponse>;
+interface PollExecutionsRequest {
+    deposit_wallet_id: string;
+}
+interface PollExecutionsResponse {
+    success: boolean;
+    message: string;
+    workflow_id: string;
+    already_running: boolean;
+}
+/**
+ * Start a poll workflow for direct executions on a deposit wallet
+ * @param request - Poll request with deposit_wallet_id
+ * @param publishableKey - Optional publishable key, defaults to configured key
+ */
+declare function pollDirectExecutions(request: PollExecutionsRequest, publishableKey?: string): Promise<PollExecutionsResponse>;
 interface SupportedChain {
     chain_id: string;
     chain_name: string;
@@ -359,6 +374,7 @@ interface PaymentNetwork {
     icon_urls: IconUrl[];
 }
 interface ProjectConfigResponse {
+    project_name?: string;
     asset_cdn_url: string;
     transfer_crypto: {
         networks: FeaturedToken[];
@@ -473,6 +489,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
@@ -568,4 +626,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 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 };
+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, 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

@@ -22,6 +22,7 @@ var index_exports = {};
 __export(index_exports, {
   ExecutionStatus: () => ExecutionStatus,
   SOLANA_USDC_ADDRESS: () => SOLANA_USDC_ADDRESS,
+  buildSolanaTransaction: () => buildSolanaTransaction,
   createDepositAddress: () => createDepositAddress,
   createOnrampSession: () => createOnrampSession,
   getAddressBalance: () => getAddressBalance,
@@ -42,7 +43,9 @@ __export(index_exports, {
   getTokenMetadata: () => getTokenMetadata,
   getWalletByChainType: () => getWalletByChainType,
   i18n: () => i18n,
+  pollDirectExecutions: () => pollDirectExecutions,
   queryExecutions: () => queryExecutions,
+  sendSolanaTransaction: () => sendSolanaTransaction,
   setApiConfig: () => setApiConfig,
   useUserIp: () => useUserIp,
   verifyRecipientAddress: () => verifyRecipientAddress
@@ -164,6 +167,26 @@ async function queryExecutions(externalUserId, publishableKey) {
   }
   return response.json();
 }
+async function pollDirectExecutions(request, publishableKey) {
+  const pk = publishableKey || DEFAULT_PUBLISHABLE_KEY;
+  validatePublishableKey(pk);
+  const response = await fetch(
+    `${API_BASE_URL}/v1/public/direct_executions/poll`,
+    {
+      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 poll direct executions: ${response.statusText}`);
+  }
+  return response.json();
+}
 async function getSupportedDepositTokens(publishableKey, options) {
   const pk = publishableKey || DEFAULT_PUBLISHABLE_KEY;
   validatePublishableKey(pk);
@@ -439,6 +462,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");
@@ -547,6 +610,7 @@ var i18n = en_default;
 0 && (module.exports = {
   ExecutionStatus,
   SOLANA_USDC_ADDRESS,
+  buildSolanaTransaction,
   createDepositAddress,
   createOnrampSession,
   getAddressBalance,
@@ -567,7 +631,9 @@ var i18n = en_default;
   getTokenMetadata,
   getWalletByChainType,
   i18n,
+  pollDirectExecutions,
   queryExecutions,
+  sendSolanaTransaction,
   setApiConfig,
   useUserIp,
   verifyRecipientAddress

package/dist/index.mjs

@@ -113,6 +113,26 @@ async function queryExecutions(externalUserId, publishableKey) {
   }
   return response.json();
 }
+async function pollDirectExecutions(request, publishableKey) {
+  const pk = publishableKey || DEFAULT_PUBLISHABLE_KEY;
+  validatePublishableKey(pk);
+  const response = await fetch(
+    `${API_BASE_URL}/v1/public/direct_executions/poll`,
+    {
+      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 poll direct executions: ${response.statusText}`);
+  }
+  return response.json();
+}
 async function getSupportedDepositTokens(publishableKey, options) {
   const pk = publishableKey || DEFAULT_PUBLISHABLE_KEY;
   validatePublishableKey(pk);
@@ -388,6 +408,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";
@@ -495,6 +555,7 @@ var i18n = en_default;
 export {
   ExecutionStatus,
   SOLANA_USDC_ADDRESS,
+  buildSolanaTransaction,
   createDepositAddress,
   createOnrampSession,
   getAddressBalance,
@@ -515,7 +576,9 @@ export {
   getTokenMetadata,
   getWalletByChainType,
   i18n,
+  pollDirectExecutions,
   queryExecutions,
+  sendSolanaTransaction,
   setApiConfig,
   useUserIp,
   verifyRecipientAddress

package/package.json

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