@metamask/money-account-api-data-service 0.1.0

package/dist/money-account-api-data-service-method-action-types.d.cts

@@ -0,0 +1,60 @@
+/**
+ * This file is auto generated.
+ * Do not edit manually.
+ */
+import type { MoneyAccountApiDataService } from "./money-account-api-data-service.cjs";
+/**
+ * Fetches the current vault positions for a given user address.
+ *
+ * @param address - The user's Ethereum address.
+ * @returns The position response containing vault positions.
+ */
+export type MoneyAccountApiDataServiceFetchPositionsAction = {
+    type: `MoneyAccountApiDataService:fetchPositions`;
+    handler: MoneyAccountApiDataService['fetchPositions'];
+};
+/**
+ * Fetches the interest earned for a given address and vault over a
+ * specified time window.
+ *
+ * @param address - The user's Ethereum address.
+ * @param options - Options specifying vault, window, and optional chain ID.
+ * @returns The interest response.
+ */
+export type MoneyAccountApiDataServiceFetchInterestAction = {
+    type: `MoneyAccountApiDataService:fetchInterest`;
+    handler: MoneyAccountApiDataService['fetchInterest'];
+};
+/**
+ * Fetches cursor-paginated cash-flow history for a given address.
+ * Uses `fetchInfiniteQuery` for proper TanStack Query pagination semantics.
+ *
+ * When paginating, consumers must re-pass the same filter options
+ * (`vaultAddress`, `chainId`, `limit`) alongside `cursor` on every page
+ * request. This ensures the query key matches the original infinite query
+ * and that the HTTP request includes the correct filters.
+ *
+ * @param address - The user's Ethereum address.
+ * @param options - Optional filtering and pagination options.
+ * @returns The history response containing cash-flow entries for the requested page.
+ */
+export type MoneyAccountApiDataServiceFetchHistoryAction = {
+    type: `MoneyAccountApiDataService:fetchHistory`;
+    handler: MoneyAccountApiDataService['fetchHistory'];
+};
+/**
+ * Fetches the exchange-rate time series for a given vault.
+ *
+ * @param vaultAddress - The vault's Ethereum address.
+ * @param options - Optional range and chain ID filters.
+ * @returns The rate history response.
+ */
+export type MoneyAccountApiDataServiceFetchRateHistoryAction = {
+    type: `MoneyAccountApiDataService:fetchRateHistory`;
+    handler: MoneyAccountApiDataService['fetchRateHistory'];
+};
+/**
+ * Union of all MoneyAccountApiDataService action types.
+ */
+export type MoneyAccountApiDataServiceMethodActions = MoneyAccountApiDataServiceFetchPositionsAction | MoneyAccountApiDataServiceFetchInterestAction | MoneyAccountApiDataServiceFetchHistoryAction | MoneyAccountApiDataServiceFetchRateHistoryAction;
+//# sourceMappingURL=money-account-api-data-service-method-action-types.d.cts.map

package/dist/money-account-api-data-service-method-action-types.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"money-account-api-data-service-method-action-types.d.cts","sourceRoot":"","sources":["../src/money-account-api-data-service-method-action-types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,0BAA0B,EAAE,6CAAyC;AAEnF;;;;;GAKG;AACH,MAAM,MAAM,8CAA8C,GAAG;IAC3D,IAAI,EAAE,2CAA2C,CAAC;IAClD,OAAO,EAAE,0BAA0B,CAAC,gBAAgB,CAAC,CAAC;CACvD,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,MAAM,6CAA6C,GAAG;IAC1D,IAAI,EAAE,0CAA0C,CAAC;IACjD,OAAO,EAAE,0BAA0B,CAAC,eAAe,CAAC,CAAC;CACtD,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,4CAA4C,GAAG;IACzD,IAAI,EAAE,yCAAyC,CAAC;IAChD,OAAO,EAAE,0BAA0B,CAAC,cAAc,CAAC,CAAC;CACrD,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,MAAM,gDAAgD,GAAG;IAC7D,IAAI,EAAE,6CAA6C,CAAC;IACpD,OAAO,EAAE,0BAA0B,CAAC,kBAAkB,CAAC,CAAC;CACzD,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,uCAAuC,GAC/C,8CAA8C,GAC9C,6CAA6C,GAC7C,4CAA4C,GAC5C,gDAAgD,CAAC"}

package/dist/money-account-api-data-service-method-action-types.d.mts

@@ -0,0 +1,60 @@
+/**
+ * This file is auto generated.
+ * Do not edit manually.
+ */
+import type { MoneyAccountApiDataService } from "./money-account-api-data-service.mjs";
+/**
+ * Fetches the current vault positions for a given user address.
+ *
+ * @param address - The user's Ethereum address.
+ * @returns The position response containing vault positions.
+ */
+export type MoneyAccountApiDataServiceFetchPositionsAction = {
+    type: `MoneyAccountApiDataService:fetchPositions`;
+    handler: MoneyAccountApiDataService['fetchPositions'];
+};
+/**
+ * Fetches the interest earned for a given address and vault over a
+ * specified time window.
+ *
+ * @param address - The user's Ethereum address.
+ * @param options - Options specifying vault, window, and optional chain ID.
+ * @returns The interest response.
+ */
+export type MoneyAccountApiDataServiceFetchInterestAction = {
+    type: `MoneyAccountApiDataService:fetchInterest`;
+    handler: MoneyAccountApiDataService['fetchInterest'];
+};
+/**
+ * Fetches cursor-paginated cash-flow history for a given address.
+ * Uses `fetchInfiniteQuery` for proper TanStack Query pagination semantics.
+ *
+ * When paginating, consumers must re-pass the same filter options
+ * (`vaultAddress`, `chainId`, `limit`) alongside `cursor` on every page
+ * request. This ensures the query key matches the original infinite query
+ * and that the HTTP request includes the correct filters.
+ *
+ * @param address - The user's Ethereum address.
+ * @param options - Optional filtering and pagination options.
+ * @returns The history response containing cash-flow entries for the requested page.
+ */
+export type MoneyAccountApiDataServiceFetchHistoryAction = {
+    type: `MoneyAccountApiDataService:fetchHistory`;
+    handler: MoneyAccountApiDataService['fetchHistory'];
+};
+/**
+ * Fetches the exchange-rate time series for a given vault.
+ *
+ * @param vaultAddress - The vault's Ethereum address.
+ * @param options - Optional range and chain ID filters.
+ * @returns The rate history response.
+ */
+export type MoneyAccountApiDataServiceFetchRateHistoryAction = {
+    type: `MoneyAccountApiDataService:fetchRateHistory`;
+    handler: MoneyAccountApiDataService['fetchRateHistory'];
+};
+/**
+ * Union of all MoneyAccountApiDataService action types.
+ */
+export type MoneyAccountApiDataServiceMethodActions = MoneyAccountApiDataServiceFetchPositionsAction | MoneyAccountApiDataServiceFetchInterestAction | MoneyAccountApiDataServiceFetchHistoryAction | MoneyAccountApiDataServiceFetchRateHistoryAction;
+//# sourceMappingURL=money-account-api-data-service-method-action-types.d.mts.map

package/dist/money-account-api-data-service-method-action-types.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"money-account-api-data-service-method-action-types.d.mts","sourceRoot":"","sources":["../src/money-account-api-data-service-method-action-types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,0BAA0B,EAAE,6CAAyC;AAEnF;;;;;GAKG;AACH,MAAM,MAAM,8CAA8C,GAAG;IAC3D,IAAI,EAAE,2CAA2C,CAAC;IAClD,OAAO,EAAE,0BAA0B,CAAC,gBAAgB,CAAC,CAAC;CACvD,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,MAAM,6CAA6C,GAAG;IAC1D,IAAI,EAAE,0CAA0C,CAAC;IACjD,OAAO,EAAE,0BAA0B,CAAC,eAAe,CAAC,CAAC;CACtD,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,4CAA4C,GAAG;IACzD,IAAI,EAAE,yCAAyC,CAAC;IAChD,OAAO,EAAE,0BAA0B,CAAC,cAAc,CAAC,CAAC;CACrD,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,MAAM,gDAAgD,GAAG;IAC7D,IAAI,EAAE,6CAA6C,CAAC;IACpD,OAAO,EAAE,0BAA0B,CAAC,kBAAkB,CAAC,CAAC;CACzD,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,uCAAuC,GAC/C,8CAA8C,GAC9C,6CAA6C,GAC7C,4CAA4C,GAC5C,gDAAgD,CAAC"}

package/dist/money-account-api-data-service-method-action-types.mjs

@@ -0,0 +1,6 @@
+/**
+ * This file is auto generated.
+ * Do not edit manually.
+ */
+export {};
+//# sourceMappingURL=money-account-api-data-service-method-action-types.mjs.map

package/dist/money-account-api-data-service-method-action-types.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"money-account-api-data-service-method-action-types.mjs","sourceRoot":"","sources":["../src/money-account-api-data-service-method-action-types.ts"],"names":[],"mappings":"AAAA;;;GAGG","sourcesContent":["/**\n * This file is auto generated.\n * Do not edit manually.\n */\n\nimport type { MoneyAccountApiDataService } from './money-account-api-data-service';\n\n/**\n * Fetches the current vault positions for a given user address.\n *\n * @param address - The user's Ethereum address.\n * @returns The position response containing vault positions.\n */\nexport type MoneyAccountApiDataServiceFetchPositionsAction = {\n  type: `MoneyAccountApiDataService:fetchPositions`;\n  handler: MoneyAccountApiDataService['fetchPositions'];\n};\n\n/**\n * Fetches the interest earned for a given address and vault over a\n * specified time window.\n *\n * @param address - The user's Ethereum address.\n * @param options - Options specifying vault, window, and optional chain ID.\n * @returns The interest response.\n */\nexport type MoneyAccountApiDataServiceFetchInterestAction = {\n  type: `MoneyAccountApiDataService:fetchInterest`;\n  handler: MoneyAccountApiDataService['fetchInterest'];\n};\n\n/**\n * Fetches cursor-paginated cash-flow history for a given address.\n * Uses `fetchInfiniteQuery` for proper TanStack Query pagination semantics.\n *\n * When paginating, consumers must re-pass the same filter options\n * (`vaultAddress`, `chainId`, `limit`) alongside `cursor` on every page\n * request. This ensures the query key matches the original infinite query\n * and that the HTTP request includes the correct filters.\n *\n * @param address - The user's Ethereum address.\n * @param options - Optional filtering and pagination options.\n * @returns The history response containing cash-flow entries for the requested page.\n */\nexport type MoneyAccountApiDataServiceFetchHistoryAction = {\n  type: `MoneyAccountApiDataService:fetchHistory`;\n  handler: MoneyAccountApiDataService['fetchHistory'];\n};\n\n/**\n * Fetches the exchange-rate time series for a given vault.\n *\n * @param vaultAddress - The vault's Ethereum address.\n * @param options - Optional range and chain ID filters.\n * @returns The rate history response.\n */\nexport type MoneyAccountApiDataServiceFetchRateHistoryAction = {\n  type: `MoneyAccountApiDataService:fetchRateHistory`;\n  handler: MoneyAccountApiDataService['fetchRateHistory'];\n};\n\n/**\n * Union of all MoneyAccountApiDataService action types.\n */\nexport type MoneyAccountApiDataServiceMethodActions =\n  | MoneyAccountApiDataServiceFetchPositionsAction\n  | MoneyAccountApiDataServiceFetchInterestAction\n  | MoneyAccountApiDataServiceFetchHistoryAction\n  | MoneyAccountApiDataServiceFetchRateHistoryAction;\n"]}

package/dist/money-account-api-data-service.cjs

@@ -0,0 +1,228 @@
+"use strict";
+var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
+    if (kind === "m") throw new TypeError("Private method is not writable");
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
+    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
+};
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var _MoneyAccountApiDataService_baseUrl;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MoneyAccountApiDataService = exports.serviceName = void 0;
+const base_data_service_1 = require("@metamask/base-data-service");
+const controller_utils_1 = require("@metamask/controller-utils");
+const superstruct_1 = require("@metamask/superstruct");
+const constants_1 = require("./constants.cjs");
+const errors_1 = require("./errors.cjs");
+const logger_1 = require("./logger.cjs");
+const structs_1 = require("./structs.cjs");
+// === GENERAL ===
+/**
+ * The name of the {@link MoneyAccountApiDataService}, used to namespace the
+ * service's actions and events.
+ */
+exports.serviceName = 'MoneyAccountApiDataService';
+const log = (0, logger_1.createModuleLogger)(logger_1.projectLogger, exports.serviceName);
+// === MESSENGER ===
+const MESSENGER_EXPOSED_METHODS = [
+    'fetchPositions',
+    'fetchInterest',
+    'fetchHistory',
+    'fetchRateHistory',
+];
+// === SERVICE DEFINITION ===
+/**
+ * Data service responsible for fetching positions, interest, cash-flow
+ * history, and vault rate history from the Money Account APY Tracking API.
+ */
+class MoneyAccountApiDataService extends base_data_service_1.BaseDataService {
+    /**
+     * Constructs a new MoneyAccountApiDataService.
+     *
+     * @param args - The constructor arguments.
+     * @param args.messenger - The messenger suited for this service.
+     * @param args.env - The target environment. Defaults to production.
+     * @param args.queryClientConfig - Configuration for the underlying TanStack
+     * Query client.
+     * @param args.policyOptions - Options to pass to `createServicePolicy`.
+     */
+    constructor({ messenger, env = constants_1.Env.PRD, queryClientConfig = {}, policyOptions = {}, }) {
+        super({
+            name: exports.serviceName,
+            messenger,
+            queryClientConfig,
+            policyOptions: {
+                retryFilterPolicy: (0, controller_utils_1.handleWhen)((error) => !(error instanceof errors_1.MoneyAccountApiResponseValidationError)),
+                ...policyOptions,
+            },
+        });
+        _MoneyAccountApiDataService_baseUrl.set(this, void 0);
+        __classPrivateFieldSet(this, _MoneyAccountApiDataService_baseUrl, constants_1.MONEY_ACCOUNT_API_URL_MAP[env], "f");
+        this.messenger.registerMethodActionHandlers(this, MESSENGER_EXPOSED_METHODS);
+        log('Initialized', { env, baseUrl: __classPrivateFieldGet(this, _MoneyAccountApiDataService_baseUrl, "f") });
+    }
+    /**
+     * Fetches the current vault positions for a given user address.
+     *
+     * @param address - The user's Ethereum address.
+     * @returns The position response containing vault positions.
+     */
+    async fetchPositions(address) {
+        const url = new URL(`/v1/positions/${address.toLowerCase()}`, __classPrivateFieldGet(this, _MoneyAccountApiDataService_baseUrl, "f"));
+        return this.fetchQuery({
+            queryKey: [`${this.name}:fetchPositions`, address.toLowerCase()],
+            staleTime: constants_1.DEFAULT_STALE_TIME_MS,
+            queryFn: async () => {
+                const response = await fetch(url);
+                if (!response.ok) {
+                    throw new controller_utils_1.HttpError(response.status, `Money Account API positions request failed with status '${response.status}'`);
+                }
+                const json = await response.json();
+                const [error, validated] = (0, superstruct_1.validate)(json, structs_1.PositionResponseStruct);
+                if (error) {
+                    throw new errors_1.MoneyAccountApiResponseValidationError(`Malformed response from positions endpoint: ${error.message}`);
+                }
+                return validated;
+            },
+        });
+    }
+    /**
+     * Fetches the interest earned for a given address and vault over a
+     * specified time window.
+     *
+     * @param address - The user's Ethereum address.
+     * @param options - Options specifying vault, window, and optional chain ID.
+     * @returns The interest response.
+     */
+    async fetchInterest(address, options) {
+        const url = new URL(`/v1/positions/${address.toLowerCase()}/interest`, __classPrivateFieldGet(this, _MoneyAccountApiDataService_baseUrl, "f"));
+        url.searchParams.append('vault_address', options.vaultAddress.toLowerCase());
+        url.searchParams.append('window', options.window);
+        if (options.chainId !== undefined) {
+            url.searchParams.append('chain_id', String(options.chainId));
+        }
+        return this.fetchQuery({
+            queryKey: [
+                `${this.name}:fetchInterest`,
+                address.toLowerCase(),
+                options.vaultAddress.toLowerCase(),
+                options.window,
+                ...(options.chainId === undefined ? [] : [options.chainId]),
+            ],
+            staleTime: constants_1.DEFAULT_STALE_TIME_MS,
+            queryFn: async () => {
+                const response = await fetch(url);
+                if (!response.ok) {
+                    throw new controller_utils_1.HttpError(response.status, `Money Account API interest request failed with status '${response.status}'`);
+                }
+                const json = await response.json();
+                const [error, validated] = (0, superstruct_1.validate)(json, structs_1.InterestResponseStruct);
+                if (error) {
+                    throw new errors_1.MoneyAccountApiResponseValidationError(`Malformed response from interest endpoint: ${error.message}`);
+                }
+                return validated;
+            },
+        });
+    }
+    /**
+     * Fetches cursor-paginated cash-flow history for a given address.
+     * Uses `fetchInfiniteQuery` for proper TanStack Query pagination semantics.
+     *
+     * When paginating, consumers must re-pass the same filter options
+     * (`vaultAddress`, `chainId`, `limit`) alongside `cursor` on every page
+     * request. This ensures the query key matches the original infinite query
+     * and that the HTTP request includes the correct filters.
+     *
+     * @param address - The user's Ethereum address.
+     * @param options - Optional filtering and pagination options.
+     * @returns The history response containing cash-flow entries for the requested page.
+     */
+    async fetchHistory(address, options) {
+        const normalizedAddress = address.toLowerCase();
+        const normalizedVault = options?.vaultAddress?.toLowerCase() ?? null;
+        return this.fetchInfiniteQuery({
+            queryKey: [
+                `${this.name}:fetchHistory`,
+                normalizedAddress,
+                normalizedVault,
+                options?.chainId ?? null,
+                options?.limit ?? null,
+            ],
+            staleTime: constants_1.DEFAULT_STALE_TIME_MS,
+            queryFn: async (context) => {
+                const cursor = context.pageParam;
+                const url = new URL(`/v1/positions/${normalizedAddress}/history`, __classPrivateFieldGet(this, _MoneyAccountApiDataService_baseUrl, "f"));
+                if (normalizedVault) {
+                    url.searchParams.append('vault_address', normalizedVault);
+                }
+                if (options?.chainId !== undefined) {
+                    url.searchParams.append('chain_id', String(options.chainId));
+                }
+                if (cursor) {
+                    url.searchParams.append('cursor', cursor);
+                }
+                if (options?.limit !== undefined) {
+                    url.searchParams.append('limit', String(options.limit));
+                }
+                const response = await fetch(url);
+                if (!response.ok) {
+                    throw new controller_utils_1.HttpError(response.status, `Money Account API history request failed with status '${response.status}'`);
+                }
+                const json = await response.json();
+                const [error, validated] = (0, superstruct_1.validate)(json, structs_1.HistoryResponseStruct);
+                if (error) {
+                    throw new errors_1.MoneyAccountApiResponseValidationError(`Malformed response from history endpoint: ${error.message}`);
+                }
+                return validated;
+            },
+        }, options?.cursor ?? undefined);
+    }
+    /**
+     * Fetches the exchange-rate time series for a given vault.
+     *
+     * @param vaultAddress - The vault's Ethereum address.
+     * @param options - Optional range and chain ID filters.
+     * @returns The rate history response.
+     */
+    async fetchRateHistory(vaultAddress, options) {
+        const url = new URL(`/v1/vaults/${vaultAddress.toLowerCase()}/rate-history`, __classPrivateFieldGet(this, _MoneyAccountApiDataService_baseUrl, "f"));
+        if (options?.chainId !== undefined) {
+            url.searchParams.append('chain_id', String(options.chainId));
+        }
+        if (options?.from) {
+            url.searchParams.append('from', options.from);
+        }
+        if (options?.to) {
+            url.searchParams.append('to', options.to);
+        }
+        return this.fetchQuery({
+            queryKey: [
+                `${this.name}:fetchRateHistory`,
+                vaultAddress.toLowerCase(),
+                ...(options?.chainId === undefined ? [null] : [options.chainId]),
+                ...(options?.from ? [options.from] : [null]),
+                ...(options?.to ? [options.to] : [null]),
+            ],
+            staleTime: constants_1.RATE_HISTORY_STALE_TIME_MS,
+            queryFn: async () => {
+                const response = await fetch(url);
+                if (!response.ok) {
+                    throw new controller_utils_1.HttpError(response.status, `Money Account API rate-history request failed with status '${response.status}'`);
+                }
+                const json = await response.json();
+                const [error, validated] = (0, superstruct_1.validate)(json, structs_1.RateHistoryResponseStruct);
+                if (error) {
+                    throw new errors_1.MoneyAccountApiResponseValidationError(`Malformed response from rate-history endpoint: ${error.message}`);
+                }
+                return validated;
+            },
+        });
+    }
+}
+exports.MoneyAccountApiDataService = MoneyAccountApiDataService;
+_MoneyAccountApiDataService_baseUrl = new WeakMap();
+//# sourceMappingURL=money-account-api-data-service.cjs.map

package/dist/money-account-api-data-service.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"money-account-api-data-service.cjs","sourceRoot":"","sources":["../src/money-account-api-data-service.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n  DataServiceCacheUpdatedEvent,\n  DataServiceGranularCacheUpdatedEvent,\n  DataServiceInvalidateQueriesAction,\n} from '@metamask/base-data-service';\nimport { BaseDataService } from '@metamask/base-data-service';\nimport type { CreateServicePolicyOptions } from '@metamask/controller-utils';\nimport { handleWhen, HttpError } from '@metamask/controller-utils';\nimport type { Messenger } from '@metamask/messenger';\nimport { validate } from '@metamask/superstruct';\nimport type { Json } from '@metamask/utils';\nimport type { QueryClientConfig } from '@tanstack/query-core';\n\nimport {\n  DEFAULT_STALE_TIME_MS,\n  Env,\n  MONEY_ACCOUNT_API_URL_MAP,\n  RATE_HISTORY_STALE_TIME_MS,\n} from './constants';\nimport { MoneyAccountApiResponseValidationError } from './errors';\nimport { projectLogger, createModuleLogger } from './logger';\nimport type { MoneyAccountApiDataServiceMethodActions } from './money-account-api-data-service-method-action-types';\nimport type {\n  HistoryResponse,\n  InterestResponse,\n  PositionResponse,\n  RateHistoryResponse,\n} from './response.types';\nimport {\n  HistoryResponseStruct,\n  InterestResponseStruct,\n  PositionResponseStruct,\n  RateHistoryResponseStruct,\n} from './structs';\nimport type {\n  HistoryOptions,\n  InterestOptions,\n  RateHistoryOptions,\n} from './types';\n\n// === GENERAL ===\n\n/**\n * The name of the {@link MoneyAccountApiDataService}, used to namespace the\n * service's actions and events.\n */\nexport const serviceName = 'MoneyAccountApiDataService';\n\nconst log = createModuleLogger(projectLogger, serviceName);\n\n// === MESSENGER ===\n\nconst MESSENGER_EXPOSED_METHODS = [\n  'fetchPositions',\n  'fetchInterest',\n  'fetchHistory',\n  'fetchRateHistory',\n] as const;\n\n/**\n * Invalidates cached queries for {@link MoneyAccountApiDataService}.\n */\nexport type MoneyAccountApiDataServiceInvalidateQueriesAction =\n  DataServiceInvalidateQueriesAction<typeof serviceName>;\n\n/**\n * Actions that {@link MoneyAccountApiDataService} exposes to other consumers.\n */\nexport type MoneyAccountApiDataServiceActions =\n  | MoneyAccountApiDataServiceMethodActions\n  | MoneyAccountApiDataServiceInvalidateQueriesAction;\n\n/**\n * Actions from other messengers that {@link MoneyAccountApiDataService} calls.\n */\ntype AllowedActions = never;\n\n/**\n * Published when {@link MoneyAccountApiDataService}'s cache is updated.\n */\nexport type MoneyAccountApiDataServiceCacheUpdatedEvent =\n  DataServiceCacheUpdatedEvent<typeof serviceName>;\n\n/**\n * Published when a key within {@link MoneyAccountApiDataService}'s cache is\n * updated.\n */\nexport type MoneyAccountApiDataServiceGranularCacheUpdatedEvent =\n  DataServiceGranularCacheUpdatedEvent<typeof serviceName>;\n\n/**\n * Events that {@link MoneyAccountApiDataService} exposes to other consumers.\n */\nexport type MoneyAccountApiDataServiceEvents =\n  | MoneyAccountApiDataServiceCacheUpdatedEvent\n  | MoneyAccountApiDataServiceGranularCacheUpdatedEvent;\n\n/**\n * Events from other messengers that {@link MoneyAccountApiDataService}\n * subscribes to.\n */\ntype AllowedEvents = never;\n\n/**\n * The messenger which is restricted to actions and events accessed by\n * {@link MoneyAccountApiDataService}.\n */\nexport type MoneyAccountApiDataServiceMessenger = Messenger<\n  typeof serviceName,\n  MoneyAccountApiDataServiceActions | AllowedActions,\n  MoneyAccountApiDataServiceEvents | AllowedEvents\n>;\n\n// === SERVICE DEFINITION ===\n\n/**\n * Data service responsible for fetching positions, interest, cash-flow\n * history, and vault rate history from the Money Account APY Tracking API.\n */\nexport class MoneyAccountApiDataService extends BaseDataService<\n  typeof serviceName,\n  MoneyAccountApiDataServiceMessenger\n> {\n  readonly #baseUrl: string;\n\n  /**\n   * Constructs a new MoneyAccountApiDataService.\n   *\n   * @param args - The constructor arguments.\n   * @param args.messenger - The messenger suited for this service.\n   * @param args.env - The target environment. Defaults to production.\n   * @param args.queryClientConfig - Configuration for the underlying TanStack\n   * Query client.\n   * @param args.policyOptions - Options to pass to `createServicePolicy`.\n   */\n  constructor({\n    messenger,\n    env = Env.PRD,\n    queryClientConfig = {},\n    policyOptions = {},\n  }: {\n    messenger: MoneyAccountApiDataServiceMessenger;\n    env?: Env;\n    queryClientConfig?: QueryClientConfig;\n    policyOptions?: CreateServicePolicyOptions;\n  }) {\n    super({\n      name: serviceName,\n      messenger,\n      queryClientConfig,\n      policyOptions: {\n        retryFilterPolicy: handleWhen(\n          (error) => !(error instanceof MoneyAccountApiResponseValidationError),\n        ),\n        ...policyOptions,\n      },\n    });\n\n    this.#baseUrl = MONEY_ACCOUNT_API_URL_MAP[env];\n\n    this.messenger.registerMethodActionHandlers(\n      this,\n      MESSENGER_EXPOSED_METHODS,\n    );\n\n    log('Initialized', { env, baseUrl: this.#baseUrl });\n  }\n\n  /**\n   * Fetches the current vault positions for a given user address.\n   *\n   * @param address - The user's Ethereum address.\n   * @returns The position response containing vault positions.\n   */\n  async fetchPositions(address: string): Promise<PositionResponse> {\n    const url = new URL(\n      `/v1/positions/${address.toLowerCase()}`,\n      this.#baseUrl,\n    );\n\n    return this.fetchQuery({\n      queryKey: [`${this.name}:fetchPositions`, address.toLowerCase()],\n      staleTime: DEFAULT_STALE_TIME_MS,\n      queryFn: async () => {\n        const response = await fetch(url);\n\n        if (!response.ok) {\n          throw new HttpError(\n            response.status,\n            `Money Account API positions request failed with status '${response.status}'`,\n          );\n        }\n\n        const json: Json = await response.json();\n\n        const [error, validated] = validate(json, PositionResponseStruct);\n        if (error) {\n          throw new MoneyAccountApiResponseValidationError(\n            `Malformed response from positions endpoint: ${error.message}`,\n          );\n        }\n\n        return validated as unknown as PositionResponse;\n      },\n    });\n  }\n\n  /**\n   * Fetches the interest earned for a given address and vault over a\n   * specified time window.\n   *\n   * @param address - The user's Ethereum address.\n   * @param options - Options specifying vault, window, and optional chain ID.\n   * @returns The interest response.\n   */\n  async fetchInterest(\n    address: string,\n    options: InterestOptions,\n  ): Promise<InterestResponse> {\n    const url = new URL(\n      `/v1/positions/${address.toLowerCase()}/interest`,\n      this.#baseUrl,\n    );\n    url.searchParams.append(\n      'vault_address',\n      options.vaultAddress.toLowerCase(),\n    );\n    url.searchParams.append('window', options.window);\n    if (options.chainId !== undefined) {\n      url.searchParams.append('chain_id', String(options.chainId));\n    }\n\n    return this.fetchQuery({\n      queryKey: [\n        `${this.name}:fetchInterest`,\n        address.toLowerCase(),\n        options.vaultAddress.toLowerCase(),\n        options.window,\n        ...(options.chainId === undefined ? [] : [options.chainId]),\n      ],\n      staleTime: DEFAULT_STALE_TIME_MS,\n      queryFn: async () => {\n        const response = await fetch(url);\n\n        if (!response.ok) {\n          throw new HttpError(\n            response.status,\n            `Money Account API interest request failed with status '${response.status}'`,\n          );\n        }\n\n        const json: Json = await response.json();\n\n        const [error, validated] = validate(json, InterestResponseStruct);\n        if (error) {\n          throw new MoneyAccountApiResponseValidationError(\n            `Malformed response from interest endpoint: ${error.message}`,\n          );\n        }\n\n        return validated as unknown as InterestResponse;\n      },\n    });\n  }\n\n  /**\n   * Fetches cursor-paginated cash-flow history for a given address.\n   * Uses `fetchInfiniteQuery` for proper TanStack Query pagination semantics.\n   *\n   * When paginating, consumers must re-pass the same filter options\n   * (`vaultAddress`, `chainId`, `limit`) alongside `cursor` on every page\n   * request. This ensures the query key matches the original infinite query\n   * and that the HTTP request includes the correct filters.\n   *\n   * @param address - The user's Ethereum address.\n   * @param options - Optional filtering and pagination options.\n   * @returns The history response containing cash-flow entries for the requested page.\n   */\n  async fetchHistory(\n    address: string,\n    options?: HistoryOptions,\n  ): Promise<HistoryResponse> {\n    const normalizedAddress = address.toLowerCase();\n    const normalizedVault = options?.vaultAddress?.toLowerCase() ?? null;\n\n    return this.fetchInfiniteQuery(\n      {\n        queryKey: [\n          `${this.name}:fetchHistory`,\n          normalizedAddress,\n          normalizedVault,\n          options?.chainId ?? null,\n          options?.limit ?? null,\n        ],\n        staleTime: DEFAULT_STALE_TIME_MS,\n        queryFn: async (context) => {\n          const cursor = context.pageParam as string | null | undefined;\n\n          const url = new URL(\n            `/v1/positions/${normalizedAddress}/history`,\n            this.#baseUrl,\n          );\n          if (normalizedVault) {\n            url.searchParams.append('vault_address', normalizedVault);\n          }\n          if (options?.chainId !== undefined) {\n            url.searchParams.append('chain_id', String(options.chainId));\n          }\n          if (cursor) {\n            url.searchParams.append('cursor', cursor);\n          }\n          if (options?.limit !== undefined) {\n            url.searchParams.append('limit', String(options.limit));\n          }\n\n          const response = await fetch(url);\n\n          if (!response.ok) {\n            throw new HttpError(\n              response.status,\n              `Money Account API history request failed with status '${response.status}'`,\n            );\n          }\n\n          const json: Json = await response.json();\n\n          const [error, validated] = validate(json, HistoryResponseStruct);\n          if (error) {\n            throw new MoneyAccountApiResponseValidationError(\n              `Malformed response from history endpoint: ${error.message}`,\n            );\n          }\n\n          return validated as unknown as HistoryResponse;\n        },\n      },\n      options?.cursor ?? undefined,\n    );\n  }\n\n  /**\n   * Fetches the exchange-rate time series for a given vault.\n   *\n   * @param vaultAddress - The vault's Ethereum address.\n   * @param options - Optional range and chain ID filters.\n   * @returns The rate history response.\n   */\n  async fetchRateHistory(\n    vaultAddress: string,\n    options?: RateHistoryOptions,\n  ): Promise<RateHistoryResponse> {\n    const url = new URL(\n      `/v1/vaults/${vaultAddress.toLowerCase()}/rate-history`,\n      this.#baseUrl,\n    );\n    if (options?.chainId !== undefined) {\n      url.searchParams.append('chain_id', String(options.chainId));\n    }\n    if (options?.from) {\n      url.searchParams.append('from', options.from);\n    }\n    if (options?.to) {\n      url.searchParams.append('to', options.to);\n    }\n\n    return this.fetchQuery({\n      queryKey: [\n        `${this.name}:fetchRateHistory`,\n        vaultAddress.toLowerCase(),\n        ...(options?.chainId === undefined ? [null] : [options.chainId]),\n        ...(options?.from ? [options.from] : [null]),\n        ...(options?.to ? [options.to] : [null]),\n      ],\n      staleTime: RATE_HISTORY_STALE_TIME_MS,\n      queryFn: async () => {\n        const response = await fetch(url);\n\n        if (!response.ok) {\n          throw new HttpError(\n            response.status,\n            `Money Account API rate-history request failed with status '${response.status}'`,\n          );\n        }\n\n        const json: Json = await response.json();\n\n        const [error, validated] = validate(json, RateHistoryResponseStruct);\n        if (error) {\n          throw new MoneyAccountApiResponseValidationError(\n            `Malformed response from rate-history endpoint: ${error.message}`,\n          );\n        }\n\n        return validated as unknown as RateHistoryResponse;\n      },\n    });\n  }\n}\n"]}

package/dist/money-account-api-data-service.d.cts

@@ -0,0 +1,112 @@
+import type { DataServiceCacheUpdatedEvent, DataServiceGranularCacheUpdatedEvent, DataServiceInvalidateQueriesAction } from "@metamask/base-data-service";
+import { BaseDataService } from "@metamask/base-data-service";
+import type { CreateServicePolicyOptions } from "@metamask/controller-utils";
+import type { Messenger } from "@metamask/messenger";
+import type { QueryClientConfig } from "@tanstack/query-core";
+import { Env } from "./constants.cjs";
+import type { MoneyAccountApiDataServiceMethodActions } from "./money-account-api-data-service-method-action-types.cjs";
+import type { HistoryResponse, InterestResponse, PositionResponse, RateHistoryResponse } from "./response.types.cjs";
+import type { HistoryOptions, InterestOptions, RateHistoryOptions } from "./types.cjs";
+/**
+ * The name of the {@link MoneyAccountApiDataService}, used to namespace the
+ * service's actions and events.
+ */
+export declare const serviceName = "MoneyAccountApiDataService";
+/**
+ * Invalidates cached queries for {@link MoneyAccountApiDataService}.
+ */
+export type MoneyAccountApiDataServiceInvalidateQueriesAction = DataServiceInvalidateQueriesAction<typeof serviceName>;
+/**
+ * Actions that {@link MoneyAccountApiDataService} exposes to other consumers.
+ */
+export type MoneyAccountApiDataServiceActions = MoneyAccountApiDataServiceMethodActions | MoneyAccountApiDataServiceInvalidateQueriesAction;
+/**
+ * Actions from other messengers that {@link MoneyAccountApiDataService} calls.
+ */
+type AllowedActions = never;
+/**
+ * Published when {@link MoneyAccountApiDataService}'s cache is updated.
+ */
+export type MoneyAccountApiDataServiceCacheUpdatedEvent = DataServiceCacheUpdatedEvent<typeof serviceName>;
+/**
+ * Published when a key within {@link MoneyAccountApiDataService}'s cache is
+ * updated.
+ */
+export type MoneyAccountApiDataServiceGranularCacheUpdatedEvent = DataServiceGranularCacheUpdatedEvent<typeof serviceName>;
+/**
+ * Events that {@link MoneyAccountApiDataService} exposes to other consumers.
+ */
+export type MoneyAccountApiDataServiceEvents = MoneyAccountApiDataServiceCacheUpdatedEvent | MoneyAccountApiDataServiceGranularCacheUpdatedEvent;
+/**
+ * Events from other messengers that {@link MoneyAccountApiDataService}
+ * subscribes to.
+ */
+type AllowedEvents = never;
+/**
+ * The messenger which is restricted to actions and events accessed by
+ * {@link MoneyAccountApiDataService}.
+ */
+export type MoneyAccountApiDataServiceMessenger = Messenger<typeof serviceName, MoneyAccountApiDataServiceActions | AllowedActions, MoneyAccountApiDataServiceEvents | AllowedEvents>;
+/**
+ * Data service responsible for fetching positions, interest, cash-flow
+ * history, and vault rate history from the Money Account APY Tracking API.
+ */
+export declare class MoneyAccountApiDataService extends BaseDataService<typeof serviceName, MoneyAccountApiDataServiceMessenger> {
+    #private;
+    /**
+     * Constructs a new MoneyAccountApiDataService.
+     *
+     * @param args - The constructor arguments.
+     * @param args.messenger - The messenger suited for this service.
+     * @param args.env - The target environment. Defaults to production.
+     * @param args.queryClientConfig - Configuration for the underlying TanStack
+     * Query client.
+     * @param args.policyOptions - Options to pass to `createServicePolicy`.
+     */
+    constructor({ messenger, env, queryClientConfig, policyOptions, }: {
+        messenger: MoneyAccountApiDataServiceMessenger;
+        env?: Env;
+        queryClientConfig?: QueryClientConfig;
+        policyOptions?: CreateServicePolicyOptions;
+    });
+    /**
+     * Fetches the current vault positions for a given user address.
+     *
+     * @param address - The user's Ethereum address.
+     * @returns The position response containing vault positions.
+     */
+    fetchPositions(address: string): Promise<PositionResponse>;
+    /**
+     * Fetches the interest earned for a given address and vault over a
+     * specified time window.
+     *
+     * @param address - The user's Ethereum address.
+     * @param options - Options specifying vault, window, and optional chain ID.
+     * @returns The interest response.
+     */
+    fetchInterest(address: string, options: InterestOptions): Promise<InterestResponse>;
+    /**
+     * Fetches cursor-paginated cash-flow history for a given address.
+     * Uses `fetchInfiniteQuery` for proper TanStack Query pagination semantics.
+     *
+     * When paginating, consumers must re-pass the same filter options
+     * (`vaultAddress`, `chainId`, `limit`) alongside `cursor` on every page
+     * request. This ensures the query key matches the original infinite query
+     * and that the HTTP request includes the correct filters.
+     *
+     * @param address - The user's Ethereum address.
+     * @param options - Optional filtering and pagination options.
+     * @returns The history response containing cash-flow entries for the requested page.
+     */
+    fetchHistory(address: string, options?: HistoryOptions): Promise<HistoryResponse>;
+    /**
+     * Fetches the exchange-rate time series for a given vault.
+     *
+     * @param vaultAddress - The vault's Ethereum address.
+     * @param options - Optional range and chain ID filters.
+     * @returns The rate history response.
+     */
+    fetchRateHistory(vaultAddress: string, options?: RateHistoryOptions): Promise<RateHistoryResponse>;
+}
+export {};
+//# sourceMappingURL=money-account-api-data-service.d.cts.map

package/dist/money-account-api-data-service.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"money-account-api-data-service.d.cts","sourceRoot":"","sources":["../src/money-account-api-data-service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,4BAA4B,EAC5B,oCAAoC,EACpC,kCAAkC,EACnC,oCAAoC;AACrC,OAAO,EAAE,eAAe,EAAE,oCAAoC;AAC9D,OAAO,KAAK,EAAE,0BAA0B,EAAE,mCAAmC;AAE7E,OAAO,KAAK,EAAE,SAAS,EAAE,4BAA4B;AAGrD,OAAO,KAAK,EAAE,iBAAiB,EAAE,6BAA6B;AAE9D,OAAO,EAEL,GAAG,EAGJ,wBAAoB;AAGrB,OAAO,KAAK,EAAE,uCAAuC,EAAE,iEAA6D;AACpH,OAAO,KAAK,EACV,eAAe,EACf,gBAAgB,EAChB,gBAAgB,EAChB,mBAAmB,EACpB,6BAAyB;AAO1B,OAAO,KAAK,EACV,cAAc,EACd,eAAe,EACf,kBAAkB,EACnB,oBAAgB;AAIjB;;;GAGG;AACH,eAAO,MAAM,WAAW,+BAA+B,CAAC;AAaxD;;GAEG;AACH,MAAM,MAAM,iDAAiD,GAC3D,kCAAkC,CAAC,OAAO,WAAW,CAAC,CAAC;AAEzD;;GAEG;AACH,MAAM,MAAM,iCAAiC,GACzC,uCAAuC,GACvC,iDAAiD,CAAC;AAEtD;;GAEG;AACH,KAAK,cAAc,GAAG,KAAK,CAAC;AAE5B;;GAEG;AACH,MAAM,MAAM,2CAA2C,GACrD,4BAA4B,CAAC,OAAO,WAAW,CAAC,CAAC;AAEnD;;;GAGG;AACH,MAAM,MAAM,mDAAmD,GAC7D,oCAAoC,CAAC,OAAO,WAAW,CAAC,CAAC;AAE3D;;GAEG;AACH,MAAM,MAAM,gCAAgC,GACxC,2CAA2C,GAC3C,mDAAmD,CAAC;AAExD;;;GAGG;AACH,KAAK,aAAa,GAAG,KAAK,CAAC;AAE3B;;;GAGG;AACH,MAAM,MAAM,mCAAmC,GAAG,SAAS,CACzD,OAAO,WAAW,EAClB,iCAAiC,GAAG,cAAc,EAClD,gCAAgC,GAAG,aAAa,CACjD,CAAC;AAIF;;;GAGG;AACH,qBAAa,0BAA2B,SAAQ,eAAe,CAC7D,OAAO,WAAW,EAClB,mCAAmC,CACpC;;IAGC;;;;;;;;;OASG;gBACS,EACV,SAAS,EACT,GAAa,EACb,iBAAsB,EACtB,aAAkB,GACnB,EAAE;QACD,SAAS,EAAE,mCAAmC,CAAC;QAC/C,GAAG,CAAC,EAAE,GAAG,CAAC;QACV,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;QACtC,aAAa,CAAC,EAAE,0BAA0B,CAAC;KAC5C;IAuBD;;;;;OAKG;IACG,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAiChE;;;;;;;OAOG;IACG,aAAa,CACjB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,gBAAgB,CAAC;IA+C5B;;;;;;;;;;;;OAYG;IACG,YAAY,CAChB,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,eAAe,CAAC;IA2D3B;;;;;;OAMG;IACG,gBAAgB,CACpB,YAAY,EAAE,MAAM,EACpB,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,mBAAmB,CAAC;CA+ChC"}

package/dist/money-account-api-data-service.d.mts

@@ -0,0 +1,112 @@
+import type { DataServiceCacheUpdatedEvent, DataServiceGranularCacheUpdatedEvent, DataServiceInvalidateQueriesAction } from "@metamask/base-data-service";
+import { BaseDataService } from "@metamask/base-data-service";
+import type { CreateServicePolicyOptions } from "@metamask/controller-utils";
+import type { Messenger } from "@metamask/messenger";
+import type { QueryClientConfig } from "@tanstack/query-core";
+import { Env } from "./constants.mjs";
+import type { MoneyAccountApiDataServiceMethodActions } from "./money-account-api-data-service-method-action-types.mjs";
+import type { HistoryResponse, InterestResponse, PositionResponse, RateHistoryResponse } from "./response.types.mjs";
+import type { HistoryOptions, InterestOptions, RateHistoryOptions } from "./types.mjs";
+/**
+ * The name of the {@link MoneyAccountApiDataService}, used to namespace the
+ * service's actions and events.
+ */
+export declare const serviceName = "MoneyAccountApiDataService";
+/**
+ * Invalidates cached queries for {@link MoneyAccountApiDataService}.
+ */
+export type MoneyAccountApiDataServiceInvalidateQueriesAction = DataServiceInvalidateQueriesAction<typeof serviceName>;
+/**
+ * Actions that {@link MoneyAccountApiDataService} exposes to other consumers.
+ */
+export type MoneyAccountApiDataServiceActions = MoneyAccountApiDataServiceMethodActions | MoneyAccountApiDataServiceInvalidateQueriesAction;
+/**
+ * Actions from other messengers that {@link MoneyAccountApiDataService} calls.
+ */
+type AllowedActions = never;
+/**
+ * Published when {@link MoneyAccountApiDataService}'s cache is updated.
+ */
+export type MoneyAccountApiDataServiceCacheUpdatedEvent = DataServiceCacheUpdatedEvent<typeof serviceName>;
+/**
+ * Published when a key within {@link MoneyAccountApiDataService}'s cache is
+ * updated.
+ */
+export type MoneyAccountApiDataServiceGranularCacheUpdatedEvent = DataServiceGranularCacheUpdatedEvent<typeof serviceName>;
+/**
+ * Events that {@link MoneyAccountApiDataService} exposes to other consumers.
+ */
+export type MoneyAccountApiDataServiceEvents = MoneyAccountApiDataServiceCacheUpdatedEvent | MoneyAccountApiDataServiceGranularCacheUpdatedEvent;
+/**
+ * Events from other messengers that {@link MoneyAccountApiDataService}
+ * subscribes to.
+ */
+type AllowedEvents = never;
+/**
+ * The messenger which is restricted to actions and events accessed by
+ * {@link MoneyAccountApiDataService}.
+ */
+export type MoneyAccountApiDataServiceMessenger = Messenger<typeof serviceName, MoneyAccountApiDataServiceActions | AllowedActions, MoneyAccountApiDataServiceEvents | AllowedEvents>;
+/**
+ * Data service responsible for fetching positions, interest, cash-flow
+ * history, and vault rate history from the Money Account APY Tracking API.
+ */
+export declare class MoneyAccountApiDataService extends BaseDataService<typeof serviceName, MoneyAccountApiDataServiceMessenger> {
+    #private;
+    /**
+     * Constructs a new MoneyAccountApiDataService.
+     *
+     * @param args - The constructor arguments.
+     * @param args.messenger - The messenger suited for this service.
+     * @param args.env - The target environment. Defaults to production.
+     * @param args.queryClientConfig - Configuration for the underlying TanStack
+     * Query client.
+     * @param args.policyOptions - Options to pass to `createServicePolicy`.
+     */
+    constructor({ messenger, env, queryClientConfig, policyOptions, }: {
+        messenger: MoneyAccountApiDataServiceMessenger;
+        env?: Env;
+        queryClientConfig?: QueryClientConfig;
+        policyOptions?: CreateServicePolicyOptions;
+    });
+    /**
+     * Fetches the current vault positions for a given user address.
+     *
+     * @param address - The user's Ethereum address.
+     * @returns The position response containing vault positions.
+     */
+    fetchPositions(address: string): Promise<PositionResponse>;
+    /**
+     * Fetches the interest earned for a given address and vault over a
+     * specified time window.
+     *
+     * @param address - The user's Ethereum address.
+     * @param options - Options specifying vault, window, and optional chain ID.
+     * @returns The interest response.
+     */
+    fetchInterest(address: string, options: InterestOptions): Promise<InterestResponse>;
+    /**
+     * Fetches cursor-paginated cash-flow history for a given address.
+     * Uses `fetchInfiniteQuery` for proper TanStack Query pagination semantics.
+     *
+     * When paginating, consumers must re-pass the same filter options
+     * (`vaultAddress`, `chainId`, `limit`) alongside `cursor` on every page
+     * request. This ensures the query key matches the original infinite query
+     * and that the HTTP request includes the correct filters.
+     *
+     * @param address - The user's Ethereum address.
+     * @param options - Optional filtering and pagination options.
+     * @returns The history response containing cash-flow entries for the requested page.
+     */
+    fetchHistory(address: string, options?: HistoryOptions): Promise<HistoryResponse>;
+    /**
+     * Fetches the exchange-rate time series for a given vault.
+     *
+     * @param vaultAddress - The vault's Ethereum address.
+     * @param options - Optional range and chain ID filters.
+     * @returns The rate history response.
+     */
+    fetchRateHistory(vaultAddress: string, options?: RateHistoryOptions): Promise<RateHistoryResponse>;
+}
+export {};
+//# sourceMappingURL=money-account-api-data-service.d.mts.map