@metamask/core-backend 5.0.0 → 5.1.0

package/dist/api/accounts/client.cjs

@@ -0,0 +1,492 @@
+"use strict";
+/**
+ * Accounts API Client - accounts.api.cx.metamask.io
+ *
+ * Handles all account-related API calls including:
+ * - Supported networks
+ * - Active networks
+ * - Balances (v2, v4, v5)
+ * - Transactions
+ * - Relationships
+ * - NFTs
+ * - Token discovery
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AccountsApiClient = void 0;
+const base_client_1 = require("../base-client.cjs");
+/**
+ * Accounts API Client.
+ * Provides methods for interacting with the Accounts API.
+ */
+class AccountsApiClient extends base_client_1.BaseApiClient {
+    // ==========================================================================
+    // CACHE MANAGEMENT
+    // ==========================================================================
+    /**
+     * Invalidate all balance queries.
+     */
+    async invalidateBalances() {
+        await this.queryClient.invalidateQueries({
+            queryKey: ['accounts', 'balances'],
+        });
+    }
+    /**
+     * Invalidate all account queries.
+     */
+    async invalidateAccounts() {
+        await this.queryClient.invalidateQueries({
+            queryKey: ['accounts'],
+        });
+    }
+    // ==========================================================================
+    // SUPPORTED NETWORKS
+    // ==========================================================================
+    /**
+     * Get list of supported networks (v1 endpoint).
+     *
+     * @param options - Fetch options including cache settings.
+     * @returns The list of supported networks.
+     */
+    async fetchV1SupportedNetworks(options) {
+        return this.queryClient.fetchQuery({
+            queryKey: ['accounts', 'v1SupportedNetworks'],
+            queryFn: ({ signal }) => this.fetch(base_client_1.API_URLS.ACCOUNTS, '/v1/supportedNetworks', { signal }),
+            staleTime: options?.staleTime ?? base_client_1.STALE_TIMES.SUPPORTED_NETWORKS,
+            gcTime: options?.gcTime ?? base_client_1.GC_TIMES.EXTENDED,
+        });
+    }
+    /**
+     * Get list of supported networks (v2 endpoint).
+     *
+     * @param options - Fetch options including cache settings.
+     * @returns The list of supported networks.
+     */
+    async fetchV2SupportedNetworks(options) {
+        return this.queryClient.fetchQuery({
+            queryKey: ['accounts', 'v2SupportedNetworks'],
+            queryFn: ({ signal }) => this.fetch(base_client_1.API_URLS.ACCOUNTS, '/v2/supportedNetworks', { signal }),
+            staleTime: options?.staleTime ?? base_client_1.STALE_TIMES.SUPPORTED_NETWORKS,
+            gcTime: options?.gcTime ?? base_client_1.GC_TIMES.EXTENDED,
+        });
+    }
+    // ==========================================================================
+    // ACTIVE NETWORKS
+    // ==========================================================================
+    /**
+     * Get active networks by CAIP-10 account IDs (v2 endpoint).
+     *
+     * @param accountIds - Array of CAIP-10 account IDs.
+     * @param queryOptions - Query filter options.
+     * @param queryOptions.filterMMListTokens - Whether to filter MM list tokens.
+     * @param queryOptions.networks - Networks to filter by.
+     * @param options - Fetch options including cache settings.
+     * @returns The active networks response.
+     */
+    async fetchV2ActiveNetworks(accountIds, queryOptions, options) {
+        return this.queryClient.fetchQuery({
+            queryKey: [
+                'accounts',
+                'v2ActiveNetworks',
+                {
+                    accountIds: [...accountIds].sort(),
+                    options: queryOptions && {
+                        ...queryOptions,
+                        networks: queryOptions.networks && [...queryOptions.networks].sort(),
+                    },
+                },
+            ],
+            queryFn: ({ signal }) => this.fetch(base_client_1.API_URLS.ACCOUNTS, '/v2/activeNetworks', {
+                signal,
+                params: {
+                    accountIds,
+                    filterMMListTokens: queryOptions?.filterMMListTokens,
+                    networks: queryOptions?.networks,
+                },
+            }),
+            staleTime: options?.staleTime ?? base_client_1.STALE_TIMES.NETWORKS,
+            gcTime: options?.gcTime ?? base_client_1.GC_TIMES.DEFAULT,
+        });
+    }
+    // ==========================================================================
+    // BALANCES
+    // ==========================================================================
+    /**
+     * Get account balances for a single address (v2 endpoint).
+     *
+     * @param address - The account address.
+     * @param queryOptions - Query filter options.
+     * @param queryOptions.networks - Networks to filter by.
+     * @param options - Fetch options including cache settings.
+     * @returns The account balances response.
+     */
+    async fetchV2Balances(address, queryOptions, options) {
+        return this.queryClient.fetchQuery({
+            queryKey: [
+                'accounts',
+                'balances',
+                'v2',
+                {
+                    address,
+                    options: queryOptions && {
+                        ...queryOptions,
+                        networks: queryOptions.networks && [...queryOptions.networks].sort(),
+                    },
+                },
+            ],
+            queryFn: ({ signal }) => this.fetch(base_client_1.API_URLS.ACCOUNTS, `/v2/accounts/${address}/balances`, {
+                signal,
+                params: { networks: queryOptions?.networks },
+            }),
+            staleTime: options?.staleTime ?? base_client_1.STALE_TIMES.BALANCES,
+            gcTime: options?.gcTime ?? base_client_1.GC_TIMES.DEFAULT,
+        });
+    }
+    /**
+     * Get account balances with additional options (v2 endpoint).
+     *
+     * @param address - The account address.
+     * @param queryOptions - Query filter options.
+     * @param queryOptions.networks - Networks to filter by.
+     * @param queryOptions.filterSupportedTokens - Whether to filter supported tokens.
+     * @param queryOptions.includeTokenAddresses - Token addresses to include.
+     * @param queryOptions.includeStakedAssets - Whether to include staked assets.
+     * @param options - Fetch options including cache settings.
+     * @returns The account balances response.
+     */
+    async fetchV2BalancesWithOptions(address, queryOptions, options) {
+        return this.queryClient.fetchQuery({
+            queryKey: [
+                'accounts',
+                'balances',
+                'v2',
+                {
+                    address,
+                    options: queryOptions && {
+                        ...queryOptions,
+                        networks: queryOptions.networks && [...queryOptions.networks].sort(),
+                        includeTokenAddresses: queryOptions.includeTokenAddresses &&
+                            [...queryOptions.includeTokenAddresses].sort(),
+                    },
+                },
+            ],
+            queryFn: ({ signal }) => this.fetch(base_client_1.API_URLS.ACCOUNTS, `/v2/accounts/${address}/balances`, {
+                signal,
+                params: {
+                    networks: queryOptions?.networks,
+                    filterSupportedTokens: queryOptions?.filterSupportedTokens,
+                    includeTokenAddresses: queryOptions?.includeTokenAddresses,
+                    includeStakedAssets: queryOptions?.includeStakedAssets,
+                },
+            }),
+            staleTime: options?.staleTime ?? base_client_1.STALE_TIMES.BALANCES,
+            gcTime: options?.gcTime ?? base_client_1.GC_TIMES.DEFAULT,
+        });
+    }
+    /**
+     * Get balances for multiple accounts (v4 endpoint).
+     *
+     * @param accountAddresses - Array of account addresses.
+     * @param queryOptions - Query filter options.
+     * @param queryOptions.networks - Networks to filter by.
+     * @param options - Fetch options including cache settings.
+     * @returns The multi-account balances response.
+     */
+    async fetchV4MultiAccountBalances(accountAddresses, queryOptions, options) {
+        return this.queryClient.fetchQuery({
+            queryKey: [
+                'accounts',
+                'balances',
+                'v4',
+                {
+                    accountAddresses: [...accountAddresses].sort(),
+                    options: queryOptions && {
+                        ...queryOptions,
+                        networks: queryOptions.networks && [...queryOptions.networks].sort(),
+                    },
+                },
+            ],
+            queryFn: ({ signal }) => this.fetch(base_client_1.API_URLS.ACCOUNTS, '/v4/multiaccount/balances', {
+                signal,
+                params: {
+                    accountAddresses,
+                    networks: queryOptions?.networks,
+                },
+            }),
+            staleTime: options?.staleTime ?? base_client_1.STALE_TIMES.BALANCES,
+            gcTime: options?.gcTime ?? base_client_1.GC_TIMES.DEFAULT,
+        });
+    }
+    /**
+     * Get balances for multiple accounts using CAIP-10 IDs (v5 endpoint).
+     *
+     * @param accountIds - Array of CAIP-10 account IDs.
+     * @param queryOptions - Query filter options.
+     * @param queryOptions.filterMMListTokens - Whether to filter MM list tokens.
+     * @param queryOptions.networks - Networks to filter by.
+     * @param queryOptions.includeStakedAssets - Whether to include staked assets.
+     * @param options - Fetch options including cache settings.
+     * @returns The multi-account balances response.
+     */
+    async fetchV5MultiAccountBalances(accountIds, queryOptions, options) {
+        return this.queryClient.fetchQuery({
+            queryKey: [
+                'accounts',
+                'balances',
+                'v5',
+                {
+                    accountIds: [...accountIds].sort(),
+                    options: queryOptions && {
+                        ...queryOptions,
+                        networks: queryOptions.networks && [...queryOptions.networks].sort(),
+                    },
+                },
+            ],
+            queryFn: ({ signal }) => this.fetch(base_client_1.API_URLS.ACCOUNTS, '/v5/multiaccount/balances', {
+                signal,
+                params: {
+                    accountIds,
+                    networks: queryOptions?.networks,
+                    filterMMListTokens: queryOptions?.filterMMListTokens,
+                    includeStakedAssets: queryOptions?.includeStakedAssets,
+                },
+            }),
+            staleTime: options?.staleTime ?? base_client_1.STALE_TIMES.BALANCES,
+            gcTime: options?.gcTime ?? base_client_1.GC_TIMES.DEFAULT,
+        });
+    }
+    // ==========================================================================
+    // TRANSACTIONS
+    // ==========================================================================
+    /**
+     * Get a specific transaction by hash (v1 endpoint).
+     *
+     * @param chainId - The chain ID.
+     * @param txHash - The transaction hash.
+     * @param queryOptions - Query filter options.
+     * @param queryOptions.includeLogs - Whether to include logs.
+     * @param queryOptions.includeValueTransfers - Whether to include value transfers.
+     * @param queryOptions.includeTxMetadata - Whether to include transaction metadata.
+     * @param queryOptions.lang - Language for metadata.
+     * @param options - Fetch options including cache settings.
+     * @returns The transaction details.
+     */
+    async fetchV1TransactionByHash(chainId, txHash, queryOptions, options) {
+        return this.queryClient.fetchQuery({
+            queryKey: [
+                'accounts',
+                'transactions',
+                'v1ByHash',
+                { chainId, txHash, options: queryOptions },
+            ],
+            queryFn: ({ signal }) => this.fetch(base_client_1.API_URLS.ACCOUNTS, `/v1/networks/${chainId}/transactions/${txHash}`, {
+                signal,
+                params: {
+                    includeLogs: queryOptions?.includeLogs,
+                    includeValueTransfers: queryOptions?.includeValueTransfers,
+                    includeTxMetadata: queryOptions?.includeTxMetadata,
+                    lang: queryOptions?.lang,
+                },
+            }),
+            staleTime: options?.staleTime ?? base_client_1.STALE_TIMES.TRANSACTIONS,
+            gcTime: options?.gcTime ?? base_client_1.GC_TIMES.DEFAULT,
+        });
+    }
+    /**
+     * Get account transactions (v1 endpoint).
+     *
+     * @param address - The account address.
+     * @param queryOptions - Query filter options.
+     * @param queryOptions.chainIds - Chain IDs to filter by.
+     * @param queryOptions.cursor - Pagination cursor.
+     * @param queryOptions.startTimestamp - Start timestamp filter.
+     * @param queryOptions.endTimestamp - End timestamp filter.
+     * @param queryOptions.sortDirection - Sort direction (ASC/DESC).
+     * @param options - Fetch options including cache settings.
+     * @returns The account transactions response.
+     */
+    async fetchV1AccountTransactions(address, queryOptions, options) {
+        return this.queryClient.fetchQuery({
+            queryKey: [
+                'accounts',
+                'transactions',
+                'v1Account',
+                {
+                    address,
+                    options: queryOptions && {
+                        ...queryOptions,
+                        chainIds: queryOptions.chainIds && [...queryOptions.chainIds].sort(),
+                    },
+                },
+            ],
+            queryFn: ({ signal }) => this.fetch(base_client_1.API_URLS.ACCOUNTS, `/v1/accounts/${address}/transactions`, {
+                signal,
+                params: {
+                    networks: queryOptions?.chainIds,
+                    cursor: queryOptions?.cursor,
+                    startTimestamp: queryOptions?.startTimestamp,
+                    endTimestamp: queryOptions?.endTimestamp,
+                    sortDirection: queryOptions?.sortDirection,
+                },
+            }),
+            staleTime: options?.staleTime ?? base_client_1.STALE_TIMES.TRANSACTIONS,
+            gcTime: options?.gcTime ?? base_client_1.GC_TIMES.DEFAULT,
+        });
+    }
+    /**
+     * Get multi-account transactions (v4 endpoint).
+     *
+     * @param accountIds - Array of CAIP-10 account IDs.
+     * @param queryOptions - Query filter options.
+     * @param queryOptions.networks - Networks to filter by.
+     * @param queryOptions.cursor - Pagination cursor.
+     * @param queryOptions.sortDirection - Sort direction (ASC/DESC).
+     * @param queryOptions.includeLogs - Whether to include logs.
+     * @param queryOptions.includeValueTransfers - Whether to include value transfers.
+     * @param queryOptions.includeTxMetadata - Whether to include transaction metadata.
+     * @param options - Fetch options including cache settings.
+     * @returns The multi-account transactions response.
+     */
+    async fetchV4MultiAccountTransactions(accountIds, queryOptions, options) {
+        return this.queryClient.fetchQuery({
+            queryKey: [
+                'accounts',
+                'transactions',
+                'v4MultiAccount',
+                {
+                    accountIds: [...accountIds].sort(),
+                    options: queryOptions && {
+                        ...queryOptions,
+                        networks: queryOptions.networks && [...queryOptions.networks].sort(),
+                    },
+                },
+            ],
+            queryFn: ({ signal }) => this.fetch(base_client_1.API_URLS.ACCOUNTS, '/v4/multiaccount/transactions', {
+                signal,
+                params: {
+                    accountIds,
+                    networks: queryOptions?.networks,
+                    cursor: queryOptions?.cursor,
+                    sortDirection: queryOptions?.sortDirection,
+                    includeLogs: queryOptions?.includeLogs,
+                    includeValueTransfers: queryOptions?.includeValueTransfers,
+                    includeTxMetadata: queryOptions?.includeTxMetadata,
+                },
+            }),
+            staleTime: options?.staleTime ?? base_client_1.STALE_TIMES.TRANSACTIONS,
+            gcTime: options?.gcTime ?? base_client_1.GC_TIMES.DEFAULT,
+        });
+    }
+    // ==========================================================================
+    // RELATIONSHIPS
+    // ==========================================================================
+    /**
+     * Get account address relationship (v1 endpoint).
+     *
+     * @param chainId - The chain ID.
+     * @param from - The from address.
+     * @param to - The to address.
+     * @param options - Fetch options including cache settings.
+     * @returns The account relationship result.
+     */
+    async fetchV1AccountRelationship(chainId, from, to, options) {
+        return this.queryClient.fetchQuery({
+            queryKey: ['accounts', 'v1Relationship', chainId, from, to],
+            queryFn: async ({ signal }) => {
+                try {
+                    return await this.fetch(base_client_1.API_URLS.ACCOUNTS, `/v1/networks/${chainId}/accounts/${from}/relationships/${to}`, { signal });
+                }
+                catch (error) {
+                    if (error instanceof base_client_1.HttpError && typeof error.body === 'object') {
+                        const body = error.body;
+                        if (body?.error &&
+                            typeof body.error === 'object' &&
+                            typeof body.error.code === 'string' &&
+                            typeof body.error.message === 'string') {
+                            return {
+                                error: {
+                                    code: body.error.code,
+                                    message: body.error.message,
+                                },
+                            };
+                        }
+                    }
+                    throw error;
+                }
+            },
+            staleTime: options?.staleTime ?? base_client_1.STALE_TIMES.DEFAULT,
+            gcTime: options?.gcTime ?? base_client_1.GC_TIMES.DEFAULT,
+        });
+    }
+    // ==========================================================================
+    // NFTs
+    // ==========================================================================
+    /**
+     * Get NFTs owned by an account (v2 endpoint).
+     *
+     * @param address - The account address.
+     * @param queryOptions - Query filter options.
+     * @param queryOptions.networks - Networks to filter by.
+     * @param queryOptions.cursor - Pagination cursor.
+     * @param options - Fetch options including cache settings.
+     * @returns The NFTs response.
+     */
+    async fetchV2AccountNfts(address, queryOptions, options) {
+        return this.queryClient.fetchQuery({
+            queryKey: [
+                'accounts',
+                'v2Nfts',
+                {
+                    address,
+                    options: queryOptions && {
+                        ...queryOptions,
+                        networks: queryOptions.networks && [...queryOptions.networks].sort(),
+                    },
+                },
+            ],
+            queryFn: ({ signal }) => this.fetch(base_client_1.API_URLS.ACCOUNTS, `/v2/accounts/${address}/nfts`, {
+                signal,
+                params: {
+                    networks: queryOptions?.networks,
+                    cursor: queryOptions?.cursor,
+                },
+            }),
+            staleTime: options?.staleTime ?? base_client_1.STALE_TIMES.DEFAULT,
+            gcTime: options?.gcTime ?? base_client_1.GC_TIMES.DEFAULT,
+        });
+    }
+    // ==========================================================================
+    // TOKEN DISCOVERY
+    // ==========================================================================
+    /**
+     * Get ERC20 tokens detected for an account (v2 endpoint).
+     *
+     * @param address - The account address.
+     * @param queryOptions - Query filter options.
+     * @param queryOptions.networks - Networks to filter by.
+     * @param options - Fetch options including cache settings.
+     * @returns The tokens response.
+     */
+    async fetchV2AccountTokens(address, queryOptions, options) {
+        return this.queryClient.fetchQuery({
+            queryKey: [
+                'accounts',
+                'v2Tokens',
+                {
+                    address,
+                    options: queryOptions && {
+                        ...queryOptions,
+                        networks: queryOptions.networks && [...queryOptions.networks].sort(),
+                    },
+                },
+            ],
+            queryFn: ({ signal }) => this.fetch(base_client_1.API_URLS.ACCOUNTS, `/v2/accounts/${address}/tokens`, {
+                signal,
+                params: { networks: queryOptions?.networks },
+            }),
+            staleTime: options?.staleTime ?? base_client_1.STALE_TIMES.DEFAULT,
+            gcTime: options?.gcTime ?? base_client_1.GC_TIMES.DEFAULT,
+        });
+    }
+}
+exports.AccountsApiClient = AccountsApiClient;
+//# sourceMappingURL=client.cjs.map

package/dist/api/accounts/client.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.cjs","sourceRoot":"","sources":["../../../src/api/accounts/client.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Accounts API Client - accounts.api.cx.metamask.io\n *\n * Handles all account-related API calls including:\n * - Supported networks\n * - Active networks\n * - Balances (v2, v4, v5)\n * - Transactions\n * - Relationships\n * - NFTs\n * - Token discovery\n */\n\nimport type { QueryFunctionContext } from '@tanstack/query-core';\n\nimport type {\n  V1SupportedNetworksResponse,\n  V2SupportedNetworksResponse,\n  V2ActiveNetworksResponse,\n  V2BalancesResponse,\n  V4BalancesResponse,\n  V5BalancesResponse,\n  V1TransactionByHashResponse,\n  V1AccountTransactionsResponse,\n  V4MultiAccountTransactionsResponse,\n  V1AccountRelationshipResult,\n  V2NftsResponse,\n  V2TokensResponse,\n} from './types';\nimport {\n  BaseApiClient,\n  API_URLS,\n  STALE_TIMES,\n  GC_TIMES,\n  HttpError,\n} from '../base-client';\nimport type { FetchOptions } from '../shared-types';\n\n/**\n * Accounts API Client.\n * Provides methods for interacting with the Accounts API.\n */\nexport class AccountsApiClient extends BaseApiClient {\n  // ==========================================================================\n  // CACHE MANAGEMENT\n  // ==========================================================================\n\n  /**\n   * Invalidate all balance queries.\n   */\n  async invalidateBalances(): Promise<void> {\n    await this.queryClient.invalidateQueries({\n      queryKey: ['accounts', 'balances'],\n    });\n  }\n\n  /**\n   * Invalidate all account queries.\n   */\n  async invalidateAccounts(): Promise<void> {\n    await this.queryClient.invalidateQueries({\n      queryKey: ['accounts'],\n    });\n  }\n\n  // ==========================================================================\n  // SUPPORTED NETWORKS\n  // ==========================================================================\n\n  /**\n   * Get list of supported networks (v1 endpoint).\n   *\n   * @param options - Fetch options including cache settings.\n   * @returns The list of supported networks.\n   */\n  async fetchV1SupportedNetworks(\n    options?: FetchOptions,\n  ): Promise<V1SupportedNetworksResponse> {\n    return this.queryClient.fetchQuery({\n      queryKey: ['accounts', 'v1SupportedNetworks'],\n      queryFn: ({ signal }: QueryFunctionContext) =>\n        this.fetch<V1SupportedNetworksResponse>(\n          API_URLS.ACCOUNTS,\n          '/v1/supportedNetworks',\n          { signal },\n        ),\n      staleTime: options?.staleTime ?? STALE_TIMES.SUPPORTED_NETWORKS,\n      gcTime: options?.gcTime ?? GC_TIMES.EXTENDED,\n    });\n  }\n\n  /**\n   * Get list of supported networks (v2 endpoint).\n   *\n   * @param options - Fetch options including cache settings.\n   * @returns The list of supported networks.\n   */\n  async fetchV2SupportedNetworks(\n    options?: FetchOptions,\n  ): Promise<V2SupportedNetworksResponse> {\n    return this.queryClient.fetchQuery({\n      queryKey: ['accounts', 'v2SupportedNetworks'],\n      queryFn: ({ signal }: QueryFunctionContext) =>\n        this.fetch<V2SupportedNetworksResponse>(\n          API_URLS.ACCOUNTS,\n          '/v2/supportedNetworks',\n          { signal },\n        ),\n      staleTime: options?.staleTime ?? STALE_TIMES.SUPPORTED_NETWORKS,\n      gcTime: options?.gcTime ?? GC_TIMES.EXTENDED,\n    });\n  }\n\n  // ==========================================================================\n  // ACTIVE NETWORKS\n  // ==========================================================================\n\n  /**\n   * Get active networks by CAIP-10 account IDs (v2 endpoint).\n   *\n   * @param accountIds - Array of CAIP-10 account IDs.\n   * @param queryOptions - Query filter options.\n   * @param queryOptions.filterMMListTokens - Whether to filter MM list tokens.\n   * @param queryOptions.networks - Networks to filter by.\n   * @param options - Fetch options including cache settings.\n   * @returns The active networks response.\n   */\n  async fetchV2ActiveNetworks(\n    accountIds: string[],\n    queryOptions?: { filterMMListTokens?: boolean; networks?: string[] },\n    options?: FetchOptions,\n  ): Promise<V2ActiveNetworksResponse> {\n    return this.queryClient.fetchQuery({\n      queryKey: [\n        'accounts',\n        'v2ActiveNetworks',\n        {\n          accountIds: [...accountIds].sort(),\n          options: queryOptions && {\n            ...queryOptions,\n            networks:\n              queryOptions.networks && [...queryOptions.networks].sort(),\n          },\n        },\n      ],\n      queryFn: ({ signal }: QueryFunctionContext) =>\n        this.fetch<V2ActiveNetworksResponse>(\n          API_URLS.ACCOUNTS,\n          '/v2/activeNetworks',\n          {\n            signal,\n            params: {\n              accountIds,\n              filterMMListTokens: queryOptions?.filterMMListTokens,\n              networks: queryOptions?.networks,\n            },\n          },\n        ),\n      staleTime: options?.staleTime ?? STALE_TIMES.NETWORKS,\n      gcTime: options?.gcTime ?? GC_TIMES.DEFAULT,\n    });\n  }\n\n  // ==========================================================================\n  // BALANCES\n  // ==========================================================================\n\n  /**\n   * Get account balances for a single address (v2 endpoint).\n   *\n   * @param address - The account address.\n   * @param queryOptions - Query filter options.\n   * @param queryOptions.networks - Networks to filter by.\n   * @param options - Fetch options including cache settings.\n   * @returns The account balances response.\n   */\n  async fetchV2Balances(\n    address: string,\n    queryOptions?: { networks?: number[] },\n    options?: FetchOptions,\n  ): Promise<V2BalancesResponse> {\n    return this.queryClient.fetchQuery({\n      queryKey: [\n        'accounts',\n        'balances',\n        'v2',\n        {\n          address,\n          options: queryOptions && {\n            ...queryOptions,\n            networks:\n              queryOptions.networks && [...queryOptions.networks].sort(),\n          },\n        },\n      ],\n      queryFn: ({ signal }: QueryFunctionContext) =>\n        this.fetch<V2BalancesResponse>(\n          API_URLS.ACCOUNTS,\n          `/v2/accounts/${address}/balances`,\n          {\n            signal,\n            params: { networks: queryOptions?.networks },\n          },\n        ),\n      staleTime: options?.staleTime ?? STALE_TIMES.BALANCES,\n      gcTime: options?.gcTime ?? GC_TIMES.DEFAULT,\n    });\n  }\n\n  /**\n   * Get account balances with additional options (v2 endpoint).\n   *\n   * @param address - The account address.\n   * @param queryOptions - Query filter options.\n   * @param queryOptions.networks - Networks to filter by.\n   * @param queryOptions.filterSupportedTokens - Whether to filter supported tokens.\n   * @param queryOptions.includeTokenAddresses - Token addresses to include.\n   * @param queryOptions.includeStakedAssets - Whether to include staked assets.\n   * @param options - Fetch options including cache settings.\n   * @returns The account balances response.\n   */\n  async fetchV2BalancesWithOptions(\n    address: string,\n    queryOptions?: {\n      networks?: number[];\n      filterSupportedTokens?: boolean;\n      includeTokenAddresses?: string[];\n      includeStakedAssets?: boolean;\n    },\n    options?: FetchOptions,\n  ): Promise<V2BalancesResponse> {\n    return this.queryClient.fetchQuery({\n      queryKey: [\n        'accounts',\n        'balances',\n        'v2',\n        {\n          address,\n          options: queryOptions && {\n            ...queryOptions,\n            networks:\n              queryOptions.networks && [...queryOptions.networks].sort(),\n            includeTokenAddresses:\n              queryOptions.includeTokenAddresses &&\n              [...queryOptions.includeTokenAddresses].sort(),\n          },\n        },\n      ],\n      queryFn: ({ signal }: QueryFunctionContext) =>\n        this.fetch<V2BalancesResponse>(\n          API_URLS.ACCOUNTS,\n          `/v2/accounts/${address}/balances`,\n          {\n            signal,\n            params: {\n              networks: queryOptions?.networks,\n              filterSupportedTokens: queryOptions?.filterSupportedTokens,\n              includeTokenAddresses: queryOptions?.includeTokenAddresses,\n              includeStakedAssets: queryOptions?.includeStakedAssets,\n            },\n          },\n        ),\n      staleTime: options?.staleTime ?? STALE_TIMES.BALANCES,\n      gcTime: options?.gcTime ?? GC_TIMES.DEFAULT,\n    });\n  }\n\n  /**\n   * Get balances for multiple accounts (v4 endpoint).\n   *\n   * @param accountAddresses - Array of account addresses.\n   * @param queryOptions - Query filter options.\n   * @param queryOptions.networks - Networks to filter by.\n   * @param options - Fetch options including cache settings.\n   * @returns The multi-account balances response.\n   */\n  async fetchV4MultiAccountBalances(\n    accountAddresses: string[],\n    queryOptions?: { networks?: number[] },\n    options?: FetchOptions,\n  ): Promise<V4BalancesResponse> {\n    return this.queryClient.fetchQuery({\n      queryKey: [\n        'accounts',\n        'balances',\n        'v4',\n        {\n          accountAddresses: [...accountAddresses].sort(),\n          options: queryOptions && {\n            ...queryOptions,\n            networks:\n              queryOptions.networks && [...queryOptions.networks].sort(),\n          },\n        },\n      ],\n      queryFn: ({ signal }: QueryFunctionContext) =>\n        this.fetch<V4BalancesResponse>(\n          API_URLS.ACCOUNTS,\n          '/v4/multiaccount/balances',\n          {\n            signal,\n            params: {\n              accountAddresses,\n              networks: queryOptions?.networks,\n            },\n          },\n        ),\n      staleTime: options?.staleTime ?? STALE_TIMES.BALANCES,\n      gcTime: options?.gcTime ?? GC_TIMES.DEFAULT,\n    });\n  }\n\n  /**\n   * Get balances for multiple accounts using CAIP-10 IDs (v5 endpoint).\n   *\n   * @param accountIds - Array of CAIP-10 account IDs.\n   * @param queryOptions - Query filter options.\n   * @param queryOptions.filterMMListTokens - Whether to filter MM list tokens.\n   * @param queryOptions.networks - Networks to filter by.\n   * @param queryOptions.includeStakedAssets - Whether to include staked assets.\n   * @param options - Fetch options including cache settings.\n   * @returns The multi-account balances response.\n   */\n  async fetchV5MultiAccountBalances(\n    accountIds: string[],\n    queryOptions?: {\n      filterMMListTokens?: boolean;\n      networks?: string[];\n      includeStakedAssets?: boolean;\n    },\n    options?: FetchOptions,\n  ): Promise<V5BalancesResponse> {\n    return this.queryClient.fetchQuery({\n      queryKey: [\n        'accounts',\n        'balances',\n        'v5',\n        {\n          accountIds: [...accountIds].sort(),\n          options: queryOptions && {\n            ...queryOptions,\n            networks:\n              queryOptions.networks && [...queryOptions.networks].sort(),\n          },\n        },\n      ],\n      queryFn: ({ signal }: QueryFunctionContext) =>\n        this.fetch<V5BalancesResponse>(\n          API_URLS.ACCOUNTS,\n          '/v5/multiaccount/balances',\n          {\n            signal,\n            params: {\n              accountIds,\n              networks: queryOptions?.networks,\n              filterMMListTokens: queryOptions?.filterMMListTokens,\n              includeStakedAssets: queryOptions?.includeStakedAssets,\n            },\n          },\n        ),\n      staleTime: options?.staleTime ?? STALE_TIMES.BALANCES,\n      gcTime: options?.gcTime ?? GC_TIMES.DEFAULT,\n    });\n  }\n\n  // ==========================================================================\n  // TRANSACTIONS\n  // ==========================================================================\n\n  /**\n   * Get a specific transaction by hash (v1 endpoint).\n   *\n   * @param chainId - The chain ID.\n   * @param txHash - The transaction hash.\n   * @param queryOptions - Query filter options.\n   * @param queryOptions.includeLogs - Whether to include logs.\n   * @param queryOptions.includeValueTransfers - Whether to include value transfers.\n   * @param queryOptions.includeTxMetadata - Whether to include transaction metadata.\n   * @param queryOptions.lang - Language for metadata.\n   * @param options - Fetch options including cache settings.\n   * @returns The transaction details.\n   */\n  async fetchV1TransactionByHash(\n    chainId: number,\n    txHash: string,\n    queryOptions?: {\n      includeLogs?: boolean;\n      includeValueTransfers?: boolean;\n      includeTxMetadata?: boolean;\n      lang?: string;\n    },\n    options?: FetchOptions,\n  ): Promise<V1TransactionByHashResponse> {\n    return this.queryClient.fetchQuery({\n      queryKey: [\n        'accounts',\n        'transactions',\n        'v1ByHash',\n        { chainId, txHash, options: queryOptions },\n      ],\n      queryFn: ({ signal }: QueryFunctionContext) =>\n        this.fetch<V1TransactionByHashResponse>(\n          API_URLS.ACCOUNTS,\n          `/v1/networks/${chainId}/transactions/${txHash}`,\n          {\n            signal,\n            params: {\n              includeLogs: queryOptions?.includeLogs,\n              includeValueTransfers: queryOptions?.includeValueTransfers,\n              includeTxMetadata: queryOptions?.includeTxMetadata,\n              lang: queryOptions?.lang,\n            },\n          },\n        ),\n      staleTime: options?.staleTime ?? STALE_TIMES.TRANSACTIONS,\n      gcTime: options?.gcTime ?? GC_TIMES.DEFAULT,\n    });\n  }\n\n  /**\n   * Get account transactions (v1 endpoint).\n   *\n   * @param address - The account address.\n   * @param queryOptions - Query filter options.\n   * @param queryOptions.chainIds - Chain IDs to filter by.\n   * @param queryOptions.cursor - Pagination cursor.\n   * @param queryOptions.startTimestamp - Start timestamp filter.\n   * @param queryOptions.endTimestamp - End timestamp filter.\n   * @param queryOptions.sortDirection - Sort direction (ASC/DESC).\n   * @param options - Fetch options including cache settings.\n   * @returns The account transactions response.\n   */\n  async fetchV1AccountTransactions(\n    address: string,\n    queryOptions?: {\n      chainIds?: string[];\n      cursor?: string;\n      startTimestamp?: number;\n      endTimestamp?: number;\n      sortDirection?: 'ASC' | 'DESC';\n    },\n    options?: FetchOptions,\n  ): Promise<V1AccountTransactionsResponse> {\n    return this.queryClient.fetchQuery({\n      queryKey: [\n        'accounts',\n        'transactions',\n        'v1Account',\n        {\n          address,\n          options: queryOptions && {\n            ...queryOptions,\n            chainIds:\n              queryOptions.chainIds && [...queryOptions.chainIds].sort(),\n          },\n        },\n      ],\n      queryFn: ({ signal }: QueryFunctionContext) =>\n        this.fetch<V1AccountTransactionsResponse>(\n          API_URLS.ACCOUNTS,\n          `/v1/accounts/${address}/transactions`,\n          {\n            signal,\n            params: {\n              networks: queryOptions?.chainIds,\n              cursor: queryOptions?.cursor,\n              startTimestamp: queryOptions?.startTimestamp,\n              endTimestamp: queryOptions?.endTimestamp,\n              sortDirection: queryOptions?.sortDirection,\n            },\n          },\n        ),\n      staleTime: options?.staleTime ?? STALE_TIMES.TRANSACTIONS,\n      gcTime: options?.gcTime ?? GC_TIMES.DEFAULT,\n    });\n  }\n\n  /**\n   * Get multi-account transactions (v4 endpoint).\n   *\n   * @param accountIds - Array of CAIP-10 account IDs.\n   * @param queryOptions - Query filter options.\n   * @param queryOptions.networks - Networks to filter by.\n   * @param queryOptions.cursor - Pagination cursor.\n   * @param queryOptions.sortDirection - Sort direction (ASC/DESC).\n   * @param queryOptions.includeLogs - Whether to include logs.\n   * @param queryOptions.includeValueTransfers - Whether to include value transfers.\n   * @param queryOptions.includeTxMetadata - Whether to include transaction metadata.\n   * @param options - Fetch options including cache settings.\n   * @returns The multi-account transactions response.\n   */\n  async fetchV4MultiAccountTransactions(\n    accountIds: string[],\n    queryOptions?: {\n      networks?: string[];\n      cursor?: string;\n      sortDirection?: 'ASC' | 'DESC';\n      includeLogs?: boolean;\n      includeValueTransfers?: boolean;\n      includeTxMetadata?: boolean;\n    },\n    options?: FetchOptions,\n  ): Promise<V4MultiAccountTransactionsResponse> {\n    return this.queryClient.fetchQuery({\n      queryKey: [\n        'accounts',\n        'transactions',\n        'v4MultiAccount',\n        {\n          accountIds: [...accountIds].sort(),\n          options: queryOptions && {\n            ...queryOptions,\n            networks:\n              queryOptions.networks && [...queryOptions.networks].sort(),\n          },\n        },\n      ],\n      queryFn: ({ signal }: QueryFunctionContext) =>\n        this.fetch<V4MultiAccountTransactionsResponse>(\n          API_URLS.ACCOUNTS,\n          '/v4/multiaccount/transactions',\n          {\n            signal,\n            params: {\n              accountIds,\n              networks: queryOptions?.networks,\n              cursor: queryOptions?.cursor,\n              sortDirection: queryOptions?.sortDirection,\n              includeLogs: queryOptions?.includeLogs,\n              includeValueTransfers: queryOptions?.includeValueTransfers,\n              includeTxMetadata: queryOptions?.includeTxMetadata,\n            },\n          },\n        ),\n      staleTime: options?.staleTime ?? STALE_TIMES.TRANSACTIONS,\n      gcTime: options?.gcTime ?? GC_TIMES.DEFAULT,\n    });\n  }\n\n  // ==========================================================================\n  // RELATIONSHIPS\n  // ==========================================================================\n\n  /**\n   * Get account address relationship (v1 endpoint).\n   *\n   * @param chainId - The chain ID.\n   * @param from - The from address.\n   * @param to - The to address.\n   * @param options - Fetch options including cache settings.\n   * @returns The account relationship result.\n   */\n  async fetchV1AccountRelationship(\n    chainId: number,\n    from: string,\n    to: string,\n    options?: FetchOptions,\n  ): Promise<V1AccountRelationshipResult> {\n    return this.queryClient.fetchQuery({\n      queryKey: ['accounts', 'v1Relationship', chainId, from, to],\n      queryFn: async ({ signal }: QueryFunctionContext) => {\n        try {\n          return await this.fetch<V1AccountRelationshipResult>(\n            API_URLS.ACCOUNTS,\n            `/v1/networks/${chainId}/accounts/${from}/relationships/${to}`,\n            { signal },\n          );\n        } catch (error) {\n          if (error instanceof HttpError && typeof error.body === 'object') {\n            const body = error.body as {\n              error?: { code?: string; message?: string };\n            } | null;\n            if (\n              body?.error &&\n              typeof body.error === 'object' &&\n              typeof body.error.code === 'string' &&\n              typeof body.error.message === 'string'\n            ) {\n              return {\n                error: {\n                  code: body.error.code,\n                  message: body.error.message,\n                },\n              };\n            }\n          }\n          throw error;\n        }\n      },\n      staleTime: options?.staleTime ?? STALE_TIMES.DEFAULT,\n      gcTime: options?.gcTime ?? GC_TIMES.DEFAULT,\n    });\n  }\n\n  // ==========================================================================\n  // NFTs\n  // ==========================================================================\n\n  /**\n   * Get NFTs owned by an account (v2 endpoint).\n   *\n   * @param address - The account address.\n   * @param queryOptions - Query filter options.\n   * @param queryOptions.networks - Networks to filter by.\n   * @param queryOptions.cursor - Pagination cursor.\n   * @param options - Fetch options including cache settings.\n   * @returns The NFTs response.\n   */\n  async fetchV2AccountNfts(\n    address: string,\n    queryOptions?: { networks?: number[]; cursor?: string },\n    options?: FetchOptions,\n  ): Promise<V2NftsResponse> {\n    return this.queryClient.fetchQuery({\n      queryKey: [\n        'accounts',\n        'v2Nfts',\n        {\n          address,\n          options: queryOptions && {\n            ...queryOptions,\n            networks:\n              queryOptions.networks && [...queryOptions.networks].sort(),\n          },\n        },\n      ],\n      queryFn: ({ signal }: QueryFunctionContext) =>\n        this.fetch<V2NftsResponse>(\n          API_URLS.ACCOUNTS,\n          `/v2/accounts/${address}/nfts`,\n          {\n            signal,\n            params: {\n              networks: queryOptions?.networks,\n              cursor: queryOptions?.cursor,\n            },\n          },\n        ),\n      staleTime: options?.staleTime ?? STALE_TIMES.DEFAULT,\n      gcTime: options?.gcTime ?? GC_TIMES.DEFAULT,\n    });\n  }\n\n  // ==========================================================================\n  // TOKEN DISCOVERY\n  // ==========================================================================\n\n  /**\n   * Get ERC20 tokens detected for an account (v2 endpoint).\n   *\n   * @param address - The account address.\n   * @param queryOptions - Query filter options.\n   * @param queryOptions.networks - Networks to filter by.\n   * @param options - Fetch options including cache settings.\n   * @returns The tokens response.\n   */\n  async fetchV2AccountTokens(\n    address: string,\n    queryOptions?: { networks?: number[] },\n    options?: FetchOptions,\n  ): Promise<V2TokensResponse> {\n    return this.queryClient.fetchQuery({\n      queryKey: [\n        'accounts',\n        'v2Tokens',\n        {\n          address,\n          options: queryOptions && {\n            ...queryOptions,\n            networks:\n              queryOptions.networks && [...queryOptions.networks].sort(),\n          },\n        },\n      ],\n      queryFn: ({ signal }: QueryFunctionContext) =>\n        this.fetch<V2TokensResponse>(\n          API_URLS.ACCOUNTS,\n          `/v2/accounts/${address}/tokens`,\n          {\n            signal,\n            params: { networks: queryOptions?.networks },\n          },\n        ),\n      staleTime: options?.staleTime ?? STALE_TIMES.DEFAULT,\n      gcTime: options?.gcTime ?? GC_TIMES.DEFAULT,\n    });\n  }\n}\n"]}