@shogun-sdk/swap 0.0.2-test

package/dist/react.d.cts

@@ -0,0 +1,158 @@
+import { TokenSearchParams, TokenSearchResponse } from '@shogun-sdk/intents-sdk';
+export { ChainID, isEvmChain } from '@shogun-sdk/intents-sdk';
+import { a as SwapQuoteResponse, e as executeOrder, b as Stage, S as SwapQuoteParams, B as BalanceRequestParams, c as BalanceResponse } from './execute-FaLLPp1i.cjs';
+export { P as PlaceOrderResult, Q as QuoteTokenInfo, T as TokenBalance, f as TokenInfo, d as TokenSearchResponse } from './execute-FaLLPp1i.cjs';
+import { A as AdaptedWallet } from './wallet-MmUIz8GE.cjs';
+import { WalletClient } from 'viem';
+import '@mysten/sui/transactions';
+import '@solana/web3.js';
+
+declare function useTokenList(params: TokenSearchParams & {
+    debounceMs?: number;
+}): {
+    /** Current fetched data (cached when possible) */
+    data: TokenSearchResponse | null;
+    /** Whether a request is in progress */
+    loading: boolean;
+    /** Error object if a request failed */
+    error: Error | null;
+    /** Manually refetch the token list */
+    refetch: () => Promise<void>;
+    /** Clear all cached token results (shared across hook instances) */
+    clearCache: () => void;
+};
+
+/** Infers the exact return type from executeOrder() */
+type ExecuteOrderResult = Awaited<ReturnType<typeof executeOrder>>;
+/**
+ * React hook for executing swap orders via the Shogun SDK with
+ * built-in stage tracking, loading states, and error handling.
+ *
+ * ---
+ * ## Features
+ * - Live stage updates (processing, approving, signing, submitting, etc.)
+ * - Built-in 20-min deadline by default (current timestamp + 1200s)
+ * - Safe state handling with unmount guards
+ * - Works for both EVM and Solana wallets
+ *
+ * ---
+ * ## Example
+ * ```tsx
+ * import { useExecuteOrder } from "@shogun-sdk/swap/react"
+ *
+ * export function SwapButton({ quote, accountAddress, wallet }) {
+ *   const { execute, status, message, loading } = useExecuteOrder()
+ *
+ *   const handleClick = async () => {
+ *     await execute({
+ *       quote,
+ *       accountAddress,
+ *       wallet,
+ *       // Optional: custom 10-minute deadline
+ *       deadline: Math.floor(Date.now() / 1000) + 10 * 60,
+ *     })
+ *   }
+ *
+ *   return (
+ *     <button disabled={loading} onClick={handleClick}>
+ *       {loading ? message ?? "Processing..." : "Execute Swap"}
+ *     </button>
+ *   )
+ * }
+ * ```
+ */
+declare function useExecuteOrder(): {
+    /** Executes the swap order. */
+    execute: ({ quote, accountAddress, recipientAddress, wallet, deadline, }: {
+        quote: SwapQuoteResponse;
+        accountAddress: string;
+        recipientAddress?: string;
+        wallet: AdaptedWallet | WalletClient;
+        deadline?: number;
+    }) => Promise<ExecuteOrderResult>;
+    /** Current execution stage. */
+    status: Stage;
+    /** Human-readable status message. */
+    message: string | null;
+    /** Whether execution is ongoing. */
+    loading: boolean;
+    /** Raw SDK response data. */
+    data: {
+        status: boolean;
+        txHash: string;
+        chainId: number;
+        stage: string;
+    } | {
+        status: boolean;
+        message: string;
+        stage: string;
+    } | null;
+    /** Captured error (if execution failed). */
+    error: Error | null;
+};
+
+/**
+ *  useQuote — React hook for fetching live swap quotes (single or cross-chain).
+ *
+ * @example
+ * ```tsx
+ * import { useQuote } from "@shogun-sdk/swap/react"
+ *
+ * export function SwapQuote({ params }) {
+ *   const { data, loading, error, warning, refetch } = useQuote(params, { debounceMs: 300 })
+ *
+ *   if (loading) return <p>Fetching quote...</p>
+ *   if (error) return <p style={{ color: "red" }}>{error.message}</p>
+ *   if (warning) return <p style={{ color: "orange" }}>{warning}</p>
+ *
+ *   return (
+ *     <div>
+ *       <p>Output: {data?.amountOut.toString()}</p>
+ *       <p>Reduced (after slippage): {data?.internal?.estimatedAmountOutReduced?.toString()}</p>
+ *       <button onClick={refetch}>Refresh</button>
+ *     </div>
+ *   )
+ * }
+ * ```
+ */
+declare function useQuote(params: SwapQuoteParams | null, options?: {
+    /** Debounce duration (ms) for reactive fetches. Default: 250 */
+    debounceMs?: number;
+    /** Optional polling interval (ms) for auto refresh */
+    autoRefreshMs?: number;
+}): {
+    /** Latest quote data */
+    data: SwapQuoteResponse | null;
+    /** Whether a fetch is ongoing */
+    loading: boolean;
+    /** Error (if any) */
+    error: Error | null;
+    /** Warning (e.g. high slippage alert) */
+    warning: string | null;
+    /** Manual refetch */
+    refetch: () => Promise<void>;
+};
+
+/**
+ * React hook for fetching wallet token balances across EVM + SVM chains.
+ *
+ * ---
+ * ## Example
+ * ```tsx
+ * const { data, loading, error, refetch } = useBalances({
+ *   addresses: { evm: evmAddress, svm: svmAddress },
+ * })
+ * ```
+ */
+declare function useBalances(params: BalanceRequestParams | null): {
+    /** Latest fetched balance data */
+    data: BalanceResponse | null;
+    /** Whether the hook is currently fetching */
+    loading: boolean;
+    /** Error object if fetching failed */
+    error: Error | null;
+    /** Manually trigger a refresh */
+    refetch: () => Promise<BalanceResponse | undefined>;
+};
+
+export { BalanceRequestParams, BalanceResponse, Stage, SwapQuoteParams, SwapQuoteResponse, useBalances, useExecuteOrder, useQuote, useTokenList };

package/dist/react.d.ts

@@ -0,0 +1,158 @@
+import { TokenSearchParams, TokenSearchResponse } from '@shogun-sdk/intents-sdk';
+export { ChainID, isEvmChain } from '@shogun-sdk/intents-sdk';
+import { a as SwapQuoteResponse, e as executeOrder, b as Stage, S as SwapQuoteParams, B as BalanceRequestParams, c as BalanceResponse } from './execute-HX1fQ7wG.js';
+export { P as PlaceOrderResult, Q as QuoteTokenInfo, T as TokenBalance, f as TokenInfo, d as TokenSearchResponse } from './execute-HX1fQ7wG.js';
+import { A as AdaptedWallet } from './wallet-MmUIz8GE.js';
+import { WalletClient } from 'viem';
+import '@mysten/sui/transactions';
+import '@solana/web3.js';
+
+declare function useTokenList(params: TokenSearchParams & {
+    debounceMs?: number;
+}): {
+    /** Current fetched data (cached when possible) */
+    data: TokenSearchResponse | null;
+    /** Whether a request is in progress */
+    loading: boolean;
+    /** Error object if a request failed */
+    error: Error | null;
+    /** Manually refetch the token list */
+    refetch: () => Promise<void>;
+    /** Clear all cached token results (shared across hook instances) */
+    clearCache: () => void;
+};
+
+/** Infers the exact return type from executeOrder() */
+type ExecuteOrderResult = Awaited<ReturnType<typeof executeOrder>>;
+/**
+ * React hook for executing swap orders via the Shogun SDK with
+ * built-in stage tracking, loading states, and error handling.
+ *
+ * ---
+ * ## Features
+ * - Live stage updates (processing, approving, signing, submitting, etc.)
+ * - Built-in 20-min deadline by default (current timestamp + 1200s)
+ * - Safe state handling with unmount guards
+ * - Works for both EVM and Solana wallets
+ *
+ * ---
+ * ## Example
+ * ```tsx
+ * import { useExecuteOrder } from "@shogun-sdk/swap/react"
+ *
+ * export function SwapButton({ quote, accountAddress, wallet }) {
+ *   const { execute, status, message, loading } = useExecuteOrder()
+ *
+ *   const handleClick = async () => {
+ *     await execute({
+ *       quote,
+ *       accountAddress,
+ *       wallet,
+ *       // Optional: custom 10-minute deadline
+ *       deadline: Math.floor(Date.now() / 1000) + 10 * 60,
+ *     })
+ *   }
+ *
+ *   return (
+ *     <button disabled={loading} onClick={handleClick}>
+ *       {loading ? message ?? "Processing..." : "Execute Swap"}
+ *     </button>
+ *   )
+ * }
+ * ```
+ */
+declare function useExecuteOrder(): {
+    /** Executes the swap order. */
+    execute: ({ quote, accountAddress, recipientAddress, wallet, deadline, }: {
+        quote: SwapQuoteResponse;
+        accountAddress: string;
+        recipientAddress?: string;
+        wallet: AdaptedWallet | WalletClient;
+        deadline?: number;
+    }) => Promise<ExecuteOrderResult>;
+    /** Current execution stage. */
+    status: Stage;
+    /** Human-readable status message. */
+    message: string | null;
+    /** Whether execution is ongoing. */
+    loading: boolean;
+    /** Raw SDK response data. */
+    data: {
+        status: boolean;
+        txHash: string;
+        chainId: number;
+        stage: string;
+    } | {
+        status: boolean;
+        message: string;
+        stage: string;
+    } | null;
+    /** Captured error (if execution failed). */
+    error: Error | null;
+};
+
+/**
+ *  useQuote — React hook for fetching live swap quotes (single or cross-chain).
+ *
+ * @example
+ * ```tsx
+ * import { useQuote } from "@shogun-sdk/swap/react"
+ *
+ * export function SwapQuote({ params }) {
+ *   const { data, loading, error, warning, refetch } = useQuote(params, { debounceMs: 300 })
+ *
+ *   if (loading) return <p>Fetching quote...</p>
+ *   if (error) return <p style={{ color: "red" }}>{error.message}</p>
+ *   if (warning) return <p style={{ color: "orange" }}>{warning}</p>
+ *
+ *   return (
+ *     <div>
+ *       <p>Output: {data?.amountOut.toString()}</p>
+ *       <p>Reduced (after slippage): {data?.internal?.estimatedAmountOutReduced?.toString()}</p>
+ *       <button onClick={refetch}>Refresh</button>
+ *     </div>
+ *   )
+ * }
+ * ```
+ */
+declare function useQuote(params: SwapQuoteParams | null, options?: {
+    /** Debounce duration (ms) for reactive fetches. Default: 250 */
+    debounceMs?: number;
+    /** Optional polling interval (ms) for auto refresh */
+    autoRefreshMs?: number;
+}): {
+    /** Latest quote data */
+    data: SwapQuoteResponse | null;
+    /** Whether a fetch is ongoing */
+    loading: boolean;
+    /** Error (if any) */
+    error: Error | null;
+    /** Warning (e.g. high slippage alert) */
+    warning: string | null;
+    /** Manual refetch */
+    refetch: () => Promise<void>;
+};
+
+/**
+ * React hook for fetching wallet token balances across EVM + SVM chains.
+ *
+ * ---
+ * ## Example
+ * ```tsx
+ * const { data, loading, error, refetch } = useBalances({
+ *   addresses: { evm: evmAddress, svm: svmAddress },
+ * })
+ * ```
+ */
+declare function useBalances(params: BalanceRequestParams | null): {
+    /** Latest fetched balance data */
+    data: BalanceResponse | null;
+    /** Whether the hook is currently fetching */
+    loading: boolean;
+    /** Error object if fetching failed */
+    error: Error | null;
+    /** Manually trigger a refresh */
+    refetch: () => Promise<BalanceResponse | undefined>;
+};
+
+export { BalanceRequestParams, BalanceResponse, Stage, SwapQuoteParams, SwapQuoteResponse, useBalances, useExecuteOrder, useQuote, useTokenList };