@sodax/dapp-kit 1.3.1-beta-rc2 → 1.3.1-beta-rc3

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@sodax/dapp-kit",
   "license": "MIT",
-  "version": "1.3.1-beta-rc2",
+  "version": "1.3.1-beta-rc3",
   "description": "dapp-kit of New World",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -16,8 +16,8 @@
   },
   "dependencies": {
     "viem": "2.29.2",
-    "@sodax/sdk": "1.3.1-beta-rc2",
-    "@sodax/types": "1.3.1-beta-rc2"
+    "@sodax/sdk": "1.3.1-beta-rc3",
+    "@sodax/types": "1.3.1-beta-rc3"
   },
   "devDependencies": {
     "@types/react": "19.0.8",

package/src/hooks/backend/index.ts

@@ -12,6 +12,10 @@ export { useBackendIntentByTxHash } from './useBackendIntentByTxHash';
 export { useBackendIntentByHash } from './useBackendIntentByHash';
 export { useBackendUserIntents } from './useBackendUserIntents';
 
+// Swap submit-tx hooks
+export { useBackendSubmitSwapTx } from './useBackendSubmitSwapTx';
+export { useBackendSubmitSwapTxStatus } from './useBackendSubmitSwapTxStatus';
+
 // Solver hooks
 export { useBackendOrderbook } from './useBackendOrderbook';
 

package/src/hooks/backend/useBackendSubmitSwapTx.ts

@@ -0,0 +1,55 @@
+import { useMutation, type UseMutationOptions, type UseMutationResult } from '@tanstack/react-query';
+import type { SubmitSwapTxRequest, SubmitSwapTxResponse } from '@sodax/types';
+import type { RequestOverrideConfig } from '@sodax/sdk';
+import { useSodaxContext } from '../shared/useSodaxContext';
+
+export type UseBackendSubmitSwapTxParams = {
+  apiConfig?: RequestOverrideConfig;
+  mutationOptions?: UseMutationOptions<SubmitSwapTxResponse, Error, SubmitSwapTxRequest>;
+};
+
+/**
+ * React hook for submitting a swap transaction to be processed by the backend
+ * (relay, post execution to solver, etc.).
+ *
+ * @param {UseBackendSubmitSwapTxParams | undefined} params - Optional parameters:
+ *   - `mutationOptions`: React Query mutation options to customize behavior (e.g., onSuccess, onError, retry).
+ *
+ * @returns {UseMutationResult<SubmitSwapTxResponse, Error, SubmitSwapTxRequest>} React Query mutation result:
+ *   - `mutate` / `mutateAsync`: Functions to trigger the submission.
+ *   - `data`: The submit response on success.
+ *   - `isPending`: Loading state.
+ *   - `error`: Error instance if the mutation failed.
+ *
+ * @example
+ * const { mutateAsync: submitSwapTx, isPending, error } = useBackendSubmitSwapTx();
+ *
+ * const result = await submitSwapTx({
+ *   txHash: '0x123...',
+ *   srcChainId: '1',
+ *   walletAddress: '0xabc...',
+ *   intent: { ... },
+ *   relayData: '0x...',
+ * });
+ */
+export const useBackendSubmitSwapTx = (
+  params?: UseBackendSubmitSwapTxParams,
+): UseMutationResult<SubmitSwapTxResponse, Error, SubmitSwapTxRequest> => {
+  const { sodax } = useSodaxContext();
+
+  const defaultMutationOptions = {
+    retry: 3,
+  };
+
+  const mutationOptions = {
+    ...defaultMutationOptions,
+    ...params?.mutationOptions,
+  };
+
+  return useMutation({
+    ...mutationOptions,
+    mutationFn: async (request: SubmitSwapTxRequest): Promise<SubmitSwapTxResponse> => {
+      return sodax.backendApi.submitSwapTx(request, params?.apiConfig);
+    },
+  });
+};

package/src/hooks/backend/useBackendSubmitSwapTxStatus.ts

@@ -0,0 +1,79 @@
+import { useQuery, type UseQueryOptions, type UseQueryResult } from '@tanstack/react-query';
+import type { SubmitSwapTxStatusResponse } from '@sodax/types';
+import type { RequestOverrideConfig } from '@sodax/sdk';
+import { useSodaxContext } from '../shared/useSodaxContext';
+
+export type UseBackendSubmitSwapTxStatusParams = {
+  params: {
+    txHash: string | undefined;
+    srcChainId?: string;
+  };
+  apiConfig?: RequestOverrideConfig;
+  queryOptions?: UseQueryOptions<SubmitSwapTxStatusResponse | undefined, Error>;
+};
+
+/**
+ * React hook for polling the processing status of a submitted swap transaction.
+ *
+ * @param {UseBackendSubmitSwapTxStatusParams | undefined} params - Parameters for the query:
+ *   - `params.txHash`: The transaction hash of the submitted swap; query is disabled if undefined or empty.
+ *   - `params.srcChainId`: Optional source chain ID to narrow the status lookup.
+ *   - `queryOptions`: Optional React Query options to override default behavior (e.g., refetchInterval, retry).
+ *
+ * @returns {UseQueryResult<SubmitSwapTxStatusResponse | undefined, Error>} React Query result object:
+ *   - `data`: The status response or undefined if unavailable.
+ *   - `isLoading`: Loading state.
+ *   - `error`: Error instance if the query failed.
+ *   - `refetch`: Function to re-trigger the query.
+ *
+ * @example
+ * const { data: status, isLoading, error } = useBackendSubmitSwapTxStatus({
+ *   params: { txHash: '0x123...', srcChainId: '1' },
+ * });
+ *
+ * if (status?.data.status === 'executed') {
+ *   console.log('Swap completed!', status.data.result);
+ * }
+ *
+ * @remarks
+ * - Query is disabled if `params` is undefined or `txHash` is undefined/empty.
+ * - Default refetch interval is 1 second for real-time status polling.
+ * - Uses React Query for state management, caching, and retries.
+ */
+export const useBackendSubmitSwapTxStatus = (
+  params: UseBackendSubmitSwapTxStatusParams | undefined,
+): UseQueryResult<SubmitSwapTxStatusResponse | undefined, Error> => {
+  const { sodax } = useSodaxContext();
+
+  const defaultQueryOptions = {
+    queryKey: ['api', 'swaps', 'submit-tx', 'status', params?.params?.txHash, params?.params?.srcChainId],
+    enabled: !!params?.params?.txHash && params.params.txHash.length > 0,
+    retry: 3,
+    refetchInterval: (query: { state: { data: SubmitSwapTxStatusResponse | undefined } }) => {
+      const status = query.state.data?.data?.status;
+      if (status === 'executed' || status === 'failed') return false;
+      return 1000;
+    },
+  };
+
+  const queryOptions = {
+    ...defaultQueryOptions,
+    ...params?.queryOptions,
+  };
+
+  return useQuery({
+    ...queryOptions,
+    queryFn: async (): Promise<SubmitSwapTxStatusResponse | undefined> => {
+      if (!params?.params?.txHash) {
+        return undefined;
+      }
+      return sodax.backendApi.getSubmitSwapTxStatus(
+        {
+          txHash: params.params.txHash,
+          srcChainId: params.params.srcChainId,
+        },
+        params.apiConfig,
+      );
+    },
+  });
+};