feat: add getV4MultiAccountTransactionsInfiniteQueryOptions

Author: n3ps

packages/core-backend/src/api/accounts/client.test.ts

@@ -397,6 +397,82 @@ describe('AccountsApiClient', () => {
       });
       expect(mockFetch).not.toHaveBeenCalled();
     });
+
+    describe('getV4MultiAccountTransactionsInfiniteQueryOptions', () => {
+      it('returns a queryKey', () => {
+        const result =
+          client.accounts.getV4MultiAccountTransactionsInfiniteQueryOptions({
+            accountAddresses: ['eip155:0:0xabc'],
+            networks: ['eip155:1', 'eip155:137'],
+            sortDirection: 'DESC',
+            limit: 25,
+          });
+
+        expect(result.queryKey).toStrictEqual([
+          'accounts',
+          'transactions',
+          'v4MultiAccount',
+          {
+            accountAddresses: ['eip155:0:0xabc'],
+            networks: ['eip155:1', 'eip155:137'],
+            startTimestamp: undefined,
+            endTimestamp: undefined,
+            limit: 25,
+            sortDirection: 'DESC',
+            includeLogs: undefined,
+            includeTxMetadata: undefined,
+            maxLogsPerTx: undefined,
+            lang: undefined,
+          },
+        ]);
+      });
+
+      it('sorts accountAddresses in the queryKey for stability', () => {
+        const result =
+          client.accounts.getV4MultiAccountTransactionsInfiniteQueryOptions({
+            accountAddresses: ['eip155:0:0xzzz', 'eip155:0:0xaaa'],
+          });
+
+        const keyObj = result.queryKey[3];
+        expect(keyObj).toMatchObject({
+          accountAddresses: ['eip155:0:0xaaa', 'eip155:0:0xzzz'],
+        });
+      });
+
+      it('sorts networks in the queryKey for stability', () => {
+        const result =
+          client.accounts.getV4MultiAccountTransactionsInfiniteQueryOptions({
+            accountAddresses: ['eip155:0:0xabc'],
+            networks: ['eip155:137', 'eip155:1'],
+          });
+
+        const keyObj = result.queryKey[3];
+        expect(keyObj).toMatchObject({
+          networks: ['eip155:1', 'eip155:137'],
+        });
+      });
+
+      it('uses STALE_TIMES.TRANSACTIONS and GC_TIMES.DEFAULT by default', () => {
+        const result =
+          client.accounts.getV4MultiAccountTransactionsInfiniteQueryOptions({
+            accountAddresses: ['eip155:0:0xabc'],
+          });
+
+        expect(result.staleTime).toBe(30 * 1000);
+        expect(result.gcTime).toBe(5 * 60 * 1000);
+      });
+
+      it('allows overriding staleTime and gcTime via options', () => {
+        const result =
+          client.accounts.getV4MultiAccountTransactionsInfiniteQueryOptions(
+            { accountAddresses: ['eip155:0:0xabc'] },
+            { staleTime: 60_000, gcTime: 120_000 },
+          );
+
+        expect(result.staleTime).toBe(60_000);
+        expect(result.gcTime).toBe(120_000);
+      });
+    });
   });
 
   describe('Relationships', () => {

packages/core-backend/src/api/accounts/client.ts

@@ -757,6 +757,98 @@ export class AccountsApiClient extends BaseApiClient {
     };
   }
 
+  /**
+   * Returns TanStack Query options for v4 multi-account transactions,
+   * designed for use with `useInfiniteQuery`.
+   *
+   * Unlike `getV4MultiAccountTransactionsQueryOptions`, this method:
+   * - Excludes pagination params (cursor/after/before) from the query key for stability across pages.
+   * - Accepts `pageParam` at query-time (via React Query) instead of baking cursor into a closure.
+   * - Calls `this.fetch()` directly (not `queryClient.fetchQuery()`) to avoid double-caching.
+   *
+   * @param params - API endpoint parameters (excluding pagination cursors).
+   * @param params.accountAddresses - Array of CAIP-10 account addresses.
+   * @param params.networks - CAIP-2 network IDs to filter by.
+   * @param params.startTimestamp - Start timestamp (epoch).
+   * @param params.endTimestamp - End timestamp (epoch).
+   * @param params.limit - Max transactions per page (default 50).
+   * @param params.sortDirection - Sort direction (ASC/DESC).
+   * @param params.includeLogs - Whether to include logs.
+   * @param params.includeTxMetadata - Whether to include transaction metadata.
+   * @param params.maxLogsPerTx - Max logs per transaction.
+   * @param params.lang - Language for transaction category (default "en").
+   * @param options - Fetch options including cache settings.
+   * @returns Options object compatible with `useInfiniteQuery`.
+   */
+  getV4MultiAccountTransactionsInfiniteQueryOptions(
+    params: {
+      accountAddresses: string[];
+      networks?: string[];
+      startTimestamp?: number;
+      endTimestamp?: number;
+      limit?: number;
+      sortDirection?: 'ASC' | 'DESC';
+      includeLogs?: boolean;
+      includeTxMetadata?: boolean;
+      maxLogsPerTx?: number;
+      lang?: string;
+    },
+    options?: FetchOptions,
+  ): FetchQueryOptions<V4MultiAccountTransactionsResponse> {
+    return {
+      queryKey: [
+        'accounts',
+        'transactions',
+        'v4MultiAccount',
+        {
+          accountAddresses: [...params.accountAddresses].sort(),
+          networks: params.networks && [...params.networks].sort(),
+          startTimestamp: params.startTimestamp,
+          endTimestamp: params.endTimestamp,
+          limit: params.limit,
+          sortDirection: params.sortDirection,
+          includeLogs: params.includeLogs,
+          includeTxMetadata: params.includeTxMetadata,
+          maxLogsPerTx: params.maxLogsPerTx,
+          lang: params.lang,
+        },
+      ] as const,
+      queryFn: ({
+        pageParam,
+        signal,
+      }: {
+        pageParam?: string;
+        signal?: AbortSignal;
+      }) =>
+        this.fetch<V4MultiAccountTransactionsResponse>(
+          API_URLS.ACCOUNTS,
+          '/v4/multiaccount/transactions',
+          {
+            signal,
+            params: {
+              accountAddresses: params.accountAddresses,
+              networks: params.networks,
+              startTimestamp: params.startTimestamp,
+              endTimestamp: params.endTimestamp,
+              cursor: pageParam,
+              limit: params.limit,
+              sortDirection: params.sortDirection,
+              includeLogs: params.includeLogs,
+              includeTxMetadata: params.includeTxMetadata,
+              maxLogsPerTx: params.maxLogsPerTx,
+              lang: params.lang,
+            },
+          },
+        ),
+      getNextPageParam: ({ pageInfo }: V4MultiAccountTransactionsResponse) =>
+        pageInfo.hasNextPage ? pageInfo.endCursor : undefined,
+      initialPageParam: undefined as string | undefined,
+      ...getQueryOptionsOverrides(options),
+      staleTime: options?.staleTime ?? STALE_TIMES.TRANSACTIONS,
+      gcTime: options?.gcTime ?? GC_TIMES.DEFAULT,
+    };
+  }
+
   /**
    * Get multi-account transactions (v4 endpoint).
    *