@metamask-previews/money-account-api-data-service 0.1.0-preview-e196c24cd → 0.1.0-preview-8fd5dfabc

package/CHANGELOG.md

@@ -7,6 +7,16 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+### Added
+
+- Added optional `trace` callback to `MoneyAccountApiDataService` constructor for network request tracing ([#TBD](https://github.com/MetaMask/core/pull/TBD))
+  - All HTTP calls (`fetchPositions`, `fetchInterest`, `fetchHistory`, `fetchRateHistory`) emit best-effort backdated traces with `startTime`, `success`, and `errorName` attributes
+  - Tracing is isolated from fetch/retry logic; trace failures do not impact queries
+
+### Fixed
+
+- Fixed `fetchPositions` struct validation failing when the API returns the `balance` field ([#TBD](https://github.com/MetaMask/core/pull/TBD))
+
 ## [0.1.0]
 
 ### Added

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,uFAA8E;AAArE,4IAAA,0BAA0B,OAAA;AA8BnC,6CAAkC;AAAzB,gGAAA,GAAG,OAAA;AACZ,uCAAkE;AAAzD,gIAAA,sCAAsC,OAAA","sourcesContent":["export { MoneyAccountApiDataService } from './money-account-api-data-service';\nexport type {\n  MoneyAccountApiDataServiceActions,\n  MoneyAccountApiDataServiceEvents,\n  MoneyAccountApiDataServiceMessenger,\n} from './money-account-api-data-service';\nexport type {\n  MoneyAccountApiDataServiceFetchPositionsAction,\n  MoneyAccountApiDataServiceFetchInterestAction,\n  MoneyAccountApiDataServiceFetchHistoryAction,\n  MoneyAccountApiDataServiceFetchRateHistoryAction,\n} from './money-account-api-data-service-method-action-types';\nexport type {\n  PositionResponse,\n  InterestResponse,\n  HistoryResponse,\n  RateHistoryResponse,\n  VaultPosition,\n  CashFlowEntry,\n  RateHistoryEntry,\n  DataFreshness,\n  CashFlowType,\n  CashFlowSource,\n} from './response.types';\nexport type {\n  InterestWindow,\n  InterestOptions,\n  HistoryOptions,\n  RateHistoryOptions,\n} from './types';\nexport { Env } from './constants';\nexport { MoneyAccountApiResponseValidationError } from './errors';\n"]}
+{"version":3,"file":"index.cjs","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,uFAA8E;AAArE,4IAAA,0BAA0B,OAAA;AAkCnC,6CAAkC;AAAzB,gGAAA,GAAG,OAAA;AACZ,uCAAkE;AAAzD,gIAAA,sCAAsC,OAAA","sourcesContent":["export { MoneyAccountApiDataService } from './money-account-api-data-service';\nexport type {\n  MoneyAccountApiDataServiceActions,\n  MoneyAccountApiDataServiceEvents,\n  MoneyAccountApiDataServiceMessenger,\n  MoneyAccountApiDataServiceOptions,\n  MoneyAccountApiDataServiceTraceCallback,\n  MoneyAccountApiDataServiceTraceRequest,\n} from './money-account-api-data-service';\nexport type {\n  MoneyAccountApiDataServiceFetchPositionsAction,\n  MoneyAccountApiDataServiceFetchInterestAction,\n  MoneyAccountApiDataServiceFetchHistoryAction,\n  MoneyAccountApiDataServiceFetchRateHistoryAction,\n} from './money-account-api-data-service-method-action-types';\nexport type {\n  Balance,\n  PositionResponse,\n  InterestResponse,\n  HistoryResponse,\n  RateHistoryResponse,\n  VaultPosition,\n  CashFlowEntry,\n  RateHistoryEntry,\n  DataFreshness,\n  CashFlowType,\n  CashFlowSource,\n} from './response.types';\nexport type {\n  InterestWindow,\n  InterestOptions,\n  HistoryOptions,\n  RateHistoryOptions,\n} from './types';\nexport { Env } from './constants';\nexport { MoneyAccountApiResponseValidationError } from './errors';\n"]}

package/dist/index.d.cts

@@ -1,7 +1,7 @@
 export { MoneyAccountApiDataService } from "./money-account-api-data-service.cjs";
-export type { MoneyAccountApiDataServiceActions, MoneyAccountApiDataServiceEvents, MoneyAccountApiDataServiceMessenger, } from "./money-account-api-data-service.cjs";
+export type { MoneyAccountApiDataServiceActions, MoneyAccountApiDataServiceEvents, MoneyAccountApiDataServiceMessenger, MoneyAccountApiDataServiceOptions, MoneyAccountApiDataServiceTraceCallback, MoneyAccountApiDataServiceTraceRequest, } from "./money-account-api-data-service.cjs";
 export type { MoneyAccountApiDataServiceFetchPositionsAction, MoneyAccountApiDataServiceFetchInterestAction, MoneyAccountApiDataServiceFetchHistoryAction, MoneyAccountApiDataServiceFetchRateHistoryAction, } from "./money-account-api-data-service-method-action-types.cjs";
-export type { PositionResponse, InterestResponse, HistoryResponse, RateHistoryResponse, VaultPosition, CashFlowEntry, RateHistoryEntry, DataFreshness, CashFlowType, CashFlowSource, } from "./response.types.cjs";
+export type { Balance, PositionResponse, InterestResponse, HistoryResponse, RateHistoryResponse, VaultPosition, CashFlowEntry, RateHistoryEntry, DataFreshness, CashFlowType, CashFlowSource, } from "./response.types.cjs";
 export type { InterestWindow, InterestOptions, HistoryOptions, RateHistoryOptions, } from "./types.cjs";
 export { Env } from "./constants.cjs";
 export { MoneyAccountApiResponseValidationError } from "./errors.cjs";

package/dist/index.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.cts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,0BAA0B,EAAE,6CAAyC;AAC9E,YAAY,EACV,iCAAiC,EACjC,gCAAgC,EAChC,mCAAmC,GACpC,6CAAyC;AAC1C,YAAY,EACV,8CAA8C,EAC9C,6CAA6C,EAC7C,4CAA4C,EAC5C,gDAAgD,GACjD,iEAA6D;AAC9D,YAAY,EACV,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,mBAAmB,EACnB,aAAa,EACb,aAAa,EACb,gBAAgB,EAChB,aAAa,EACb,YAAY,EACZ,cAAc,GACf,6BAAyB;AAC1B,YAAY,EACV,cAAc,EACd,eAAe,EACf,cAAc,EACd,kBAAkB,GACnB,oBAAgB;AACjB,OAAO,EAAE,GAAG,EAAE,wBAAoB;AAClC,OAAO,EAAE,sCAAsC,EAAE,qBAAiB"}
+{"version":3,"file":"index.d.cts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,0BAA0B,EAAE,6CAAyC;AAC9E,YAAY,EACV,iCAAiC,EACjC,gCAAgC,EAChC,mCAAmC,EACnC,iCAAiC,EACjC,uCAAuC,EACvC,sCAAsC,GACvC,6CAAyC;AAC1C,YAAY,EACV,8CAA8C,EAC9C,6CAA6C,EAC7C,4CAA4C,EAC5C,gDAAgD,GACjD,iEAA6D;AAC9D,YAAY,EACV,OAAO,EACP,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,mBAAmB,EACnB,aAAa,EACb,aAAa,EACb,gBAAgB,EAChB,aAAa,EACb,YAAY,EACZ,cAAc,GACf,6BAAyB;AAC1B,YAAY,EACV,cAAc,EACd,eAAe,EACf,cAAc,EACd,kBAAkB,GACnB,oBAAgB;AACjB,OAAO,EAAE,GAAG,EAAE,wBAAoB;AAClC,OAAO,EAAE,sCAAsC,EAAE,qBAAiB"}

package/dist/index.d.mts

@@ -1,7 +1,7 @@
 export { MoneyAccountApiDataService } from "./money-account-api-data-service.mjs";
-export type { MoneyAccountApiDataServiceActions, MoneyAccountApiDataServiceEvents, MoneyAccountApiDataServiceMessenger, } from "./money-account-api-data-service.mjs";
+export type { MoneyAccountApiDataServiceActions, MoneyAccountApiDataServiceEvents, MoneyAccountApiDataServiceMessenger, MoneyAccountApiDataServiceOptions, MoneyAccountApiDataServiceTraceCallback, MoneyAccountApiDataServiceTraceRequest, } from "./money-account-api-data-service.mjs";
 export type { MoneyAccountApiDataServiceFetchPositionsAction, MoneyAccountApiDataServiceFetchInterestAction, MoneyAccountApiDataServiceFetchHistoryAction, MoneyAccountApiDataServiceFetchRateHistoryAction, } from "./money-account-api-data-service-method-action-types.mjs";
-export type { PositionResponse, InterestResponse, HistoryResponse, RateHistoryResponse, VaultPosition, CashFlowEntry, RateHistoryEntry, DataFreshness, CashFlowType, CashFlowSource, } from "./response.types.mjs";
+export type { Balance, PositionResponse, InterestResponse, HistoryResponse, RateHistoryResponse, VaultPosition, CashFlowEntry, RateHistoryEntry, DataFreshness, CashFlowType, CashFlowSource, } from "./response.types.mjs";
 export type { InterestWindow, InterestOptions, HistoryOptions, RateHistoryOptions, } from "./types.mjs";
 export { Env } from "./constants.mjs";
 export { MoneyAccountApiResponseValidationError } from "./errors.mjs";

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,0BAA0B,EAAE,6CAAyC;AAC9E,YAAY,EACV,iCAAiC,EACjC,gCAAgC,EAChC,mCAAmC,GACpC,6CAAyC;AAC1C,YAAY,EACV,8CAA8C,EAC9C,6CAA6C,EAC7C,4CAA4C,EAC5C,gDAAgD,GACjD,iEAA6D;AAC9D,YAAY,EACV,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,mBAAmB,EACnB,aAAa,EACb,aAAa,EACb,gBAAgB,EAChB,aAAa,EACb,YAAY,EACZ,cAAc,GACf,6BAAyB;AAC1B,YAAY,EACV,cAAc,EACd,eAAe,EACf,cAAc,EACd,kBAAkB,GACnB,oBAAgB;AACjB,OAAO,EAAE,GAAG,EAAE,wBAAoB;AAClC,OAAO,EAAE,sCAAsC,EAAE,qBAAiB"}
+{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,0BAA0B,EAAE,6CAAyC;AAC9E,YAAY,EACV,iCAAiC,EACjC,gCAAgC,EAChC,mCAAmC,EACnC,iCAAiC,EACjC,uCAAuC,EACvC,sCAAsC,GACvC,6CAAyC;AAC1C,YAAY,EACV,8CAA8C,EAC9C,6CAA6C,EAC7C,4CAA4C,EAC5C,gDAAgD,GACjD,iEAA6D;AAC9D,YAAY,EACV,OAAO,EACP,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,mBAAmB,EACnB,aAAa,EACb,aAAa,EACb,gBAAgB,EAChB,aAAa,EACb,YAAY,EACZ,cAAc,GACf,6BAAyB;AAC1B,YAAY,EACV,cAAc,EACd,eAAe,EACf,cAAc,EACd,kBAAkB,GACnB,oBAAgB;AACjB,OAAO,EAAE,GAAG,EAAE,wBAAoB;AAClC,OAAO,EAAE,sCAAsC,EAAE,qBAAiB"}

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,0BAA0B,EAAE,6CAAyC;AA8B9E,OAAO,EAAE,GAAG,EAAE,wBAAoB;AAClC,OAAO,EAAE,sCAAsC,EAAE,qBAAiB","sourcesContent":["export { MoneyAccountApiDataService } from './money-account-api-data-service';\nexport type {\n  MoneyAccountApiDataServiceActions,\n  MoneyAccountApiDataServiceEvents,\n  MoneyAccountApiDataServiceMessenger,\n} from './money-account-api-data-service';\nexport type {\n  MoneyAccountApiDataServiceFetchPositionsAction,\n  MoneyAccountApiDataServiceFetchInterestAction,\n  MoneyAccountApiDataServiceFetchHistoryAction,\n  MoneyAccountApiDataServiceFetchRateHistoryAction,\n} from './money-account-api-data-service-method-action-types';\nexport type {\n  PositionResponse,\n  InterestResponse,\n  HistoryResponse,\n  RateHistoryResponse,\n  VaultPosition,\n  CashFlowEntry,\n  RateHistoryEntry,\n  DataFreshness,\n  CashFlowType,\n  CashFlowSource,\n} from './response.types';\nexport type {\n  InterestWindow,\n  InterestOptions,\n  HistoryOptions,\n  RateHistoryOptions,\n} from './types';\nexport { Env } from './constants';\nexport { MoneyAccountApiResponseValidationError } from './errors';\n"]}
+{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,0BAA0B,EAAE,6CAAyC;AAkC9E,OAAO,EAAE,GAAG,EAAE,wBAAoB;AAClC,OAAO,EAAE,sCAAsC,EAAE,qBAAiB","sourcesContent":["export { MoneyAccountApiDataService } from './money-account-api-data-service';\nexport type {\n  MoneyAccountApiDataServiceActions,\n  MoneyAccountApiDataServiceEvents,\n  MoneyAccountApiDataServiceMessenger,\n  MoneyAccountApiDataServiceOptions,\n  MoneyAccountApiDataServiceTraceCallback,\n  MoneyAccountApiDataServiceTraceRequest,\n} from './money-account-api-data-service';\nexport type {\n  MoneyAccountApiDataServiceFetchPositionsAction,\n  MoneyAccountApiDataServiceFetchInterestAction,\n  MoneyAccountApiDataServiceFetchHistoryAction,\n  MoneyAccountApiDataServiceFetchRateHistoryAction,\n} from './money-account-api-data-service-method-action-types';\nexport type {\n  Balance,\n  PositionResponse,\n  InterestResponse,\n  HistoryResponse,\n  RateHistoryResponse,\n  VaultPosition,\n  CashFlowEntry,\n  RateHistoryEntry,\n  DataFreshness,\n  CashFlowType,\n  CashFlowSource,\n} from './response.types';\nexport type {\n  InterestWindow,\n  InterestOptions,\n  HistoryOptions,\n  RateHistoryOptions,\n} from './types';\nexport { Env } from './constants';\nexport { MoneyAccountApiResponseValidationError } from './errors';\n"]}

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

@@ -10,9 +10,9 @@ var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (
     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;
+var _MoneyAccountApiDataService_instances, _MoneyAccountApiDataService_baseUrl, _MoneyAccountApiDataService_trace, _MoneyAccountApiDataService_traceNetworkRequest;
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.MoneyAccountApiDataService = exports.serviceName = void 0;
+exports.MoneyAccountApiDataService = exports.TRACES = 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");
@@ -27,6 +27,13 @@ const structs_1 = require("./structs.cjs");
  */
 exports.serviceName = 'MoneyAccountApiDataService';
 const log = (0, logger_1.createModuleLogger)(logger_1.projectLogger, exports.serviceName);
+const traceLogger = (0, logger_1.createModuleLogger)(logger_1.projectLogger, 'trace');
+exports.TRACES = {
+    POSITIONS_API: 'Money Account API Fetch Positions',
+    INTEREST_API: 'Money Account API Fetch Interest',
+    HISTORY_API: 'Money Account API Fetch History',
+    RATE_HISTORY_API: 'Money Account API Fetch Rate History',
+};
 // === MESSENGER ===
 const MESSENGER_EXPOSED_METHODS = [
     'fetchPositions',
@@ -34,7 +41,6 @@ const MESSENGER_EXPOSED_METHODS = [
     '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.
@@ -43,14 +49,15 @@ 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`.
+     * @param options - The constructor arguments.
+     * @param options.messenger - The messenger suited for this service.
+     * @param options.env - The target environment. Defaults to production.
+     * @param options.queryClientConfig - Configuration for the underlying
+     * TanStack Query client.
+     * @param options.policyOptions - Options to pass to `createServicePolicy`.
+     * @param options.trace - Optional callback to trace network requests.
      */
-    constructor({ messenger, env = constants_1.Env.PRD, queryClientConfig = {}, policyOptions = {}, }) {
+    constructor({ messenger, env = constants_1.Env.PRD, queryClientConfig = {}, policyOptions = {}, trace, }) {
         super({
             name: exports.serviceName,
             messenger,
@@ -60,8 +67,14 @@ class MoneyAccountApiDataService extends base_data_service_1.BaseDataService {
                 ...policyOptions,
             },
         });
+        _MoneyAccountApiDataService_instances.add(this);
         _MoneyAccountApiDataService_baseUrl.set(this, void 0);
+        _MoneyAccountApiDataService_trace.set(this, void 0);
         __classPrivateFieldSet(this, _MoneyAccountApiDataService_baseUrl, constants_1.MONEY_ACCOUNT_API_URL_MAP[env], "f");
+        __classPrivateFieldSet(this, _MoneyAccountApiDataService_trace, trace ??
+            (async (_request, fn) => {
+                return await Promise.resolve(fn?.());
+            }), "f");
         this.messenger.registerMethodActionHandlers(this, MESSENGER_EXPOSED_METHODS);
         log('Initialized', { env, baseUrl: __classPrivateFieldGet(this, _MoneyAccountApiDataService_baseUrl, "f") });
     }
@@ -77,16 +90,21 @@ class MoneyAccountApiDataService extends base_data_service_1.BaseDataService {
             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;
+                return __classPrivateFieldGet(this, _MoneyAccountApiDataService_instances, "m", _MoneyAccountApiDataService_traceNetworkRequest).call(this, {
+                    name: exports.TRACES.POSITIONS_API,
+                    data: { operation: 'fetchPositions' },
+                }, 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;
+                });
             },
         });
     }
@@ -115,16 +133,21 @@ class MoneyAccountApiDataService extends base_data_service_1.BaseDataService {
             ],
             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;
+                return __classPrivateFieldGet(this, _MoneyAccountApiDataService_instances, "m", _MoneyAccountApiDataService_traceNetworkRequest).call(this, {
+                    name: exports.TRACES.INTEREST_API,
+                    data: { operation: 'fetchInterest' },
+                }, 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;
+                });
             },
         });
     }
@@ -168,16 +191,21 @@ class MoneyAccountApiDataService extends base_data_service_1.BaseDataService {
                 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;
+                return __classPrivateFieldGet(this, _MoneyAccountApiDataService_instances, "m", _MoneyAccountApiDataService_traceNetworkRequest).call(this, {
+                    name: exports.TRACES.HISTORY_API,
+                    data: { operation: 'fetchHistory' },
+                }, async () => {
+                    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);
     }
@@ -209,20 +237,69 @@ class MoneyAccountApiDataService extends base_data_service_1.BaseDataService {
             ],
             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;
+                return __classPrivateFieldGet(this, _MoneyAccountApiDataService_instances, "m", _MoneyAccountApiDataService_traceNetworkRequest).call(this, {
+                    name: exports.TRACES.RATE_HISTORY_API,
+                    data: { operation: 'fetchRateHistory' },
+                }, 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();
+_MoneyAccountApiDataService_baseUrl = new WeakMap(), _MoneyAccountApiDataService_trace = new WeakMap(), _MoneyAccountApiDataService_instances = new WeakSet(), _MoneyAccountApiDataService_traceNetworkRequest = 
+/**
+ * Runs a network request and emits a best-effort backdated trace.
+ *
+ * @param request - Trace metadata for the network request.
+ * @param fn - Network request to execute.
+ * @returns The network request result.
+ */
+async function _MoneyAccountApiDataService_traceNetworkRequest(request, fn) {
+    const startTime = Date.now();
+    let success = false;
+    let errorName;
+    try {
+        const result = await fn();
+        success = true;
+        return result;
+    }
+    catch (error) {
+        errorName = error instanceof Error ? error.name : typeof error;
+        throw error;
+    }
+    finally {
+        const traceRequest = {
+            ...request,
+            startTime,
+            data: {
+                ...request.data,
+                success,
+                ...(errorName ? { errorName } : {}),
+            },
+        };
+        const onTraceError = (traceError) => {
+            traceLogger('Failed to emit trace', {
+                traceName: request.name,
+                traceError,
+            });
+        };
+        try {
+            Promise.resolve(__classPrivateFieldGet(this, _MoneyAccountApiDataService_trace, "f").call(this, traceRequest, () => undefined)).catch(onTraceError);
+        }
+        catch (traceError) {
+            onTraceError(traceError);
+        }
+    }
+};
 //# sourceMappingURL=money-account-api-data-service.cjs.map

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

@@ -1 +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"]}
+{"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 {\n  CreateServicePolicyOptions,\n  TraceContext,\n  TraceRequest,\n} 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);\nconst traceLogger = createModuleLogger(projectLogger, 'trace');\n\nexport const TRACES = {\n  POSITIONS_API: 'Money Account API Fetch Positions',\n  INTEREST_API: 'Money Account API Fetch Interest',\n  HISTORY_API: 'Money Account API Fetch History',\n  RATE_HISTORY_API: 'Money Account API Fetch Rate History',\n} as const;\n\nexport type MoneyAccountApiDataServiceTraceName =\n  (typeof TRACES)[keyof typeof TRACES];\n\nexport type MoneyAccountApiDataServiceTraceRequest = Omit<\n  TraceRequest,\n  'name'\n> & {\n  name: MoneyAccountApiDataServiceTraceName;\n  startTime?: number;\n};\n\nexport type MoneyAccountApiDataServiceTraceCallback = <ReturnType>(\n  request: MoneyAccountApiDataServiceTraceRequest,\n  fn?: (context?: TraceContext) => ReturnType,\n) => Promise<ReturnType>;\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\nexport type MoneyAccountApiDataServiceOptions = {\n  messenger: MoneyAccountApiDataServiceMessenger;\n  env?: Env;\n  queryClientConfig?: QueryClientConfig;\n  policyOptions?: CreateServicePolicyOptions;\n  trace?: MoneyAccountApiDataServiceTraceCallback;\n};\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  readonly #trace: MoneyAccountApiDataServiceTraceCallback;\n\n  /**\n   * Constructs a new MoneyAccountApiDataService.\n   *\n   * @param options - The constructor arguments.\n   * @param options.messenger - The messenger suited for this service.\n   * @param options.env - The target environment. Defaults to production.\n   * @param options.queryClientConfig - Configuration for the underlying\n   * TanStack Query client.\n   * @param options.policyOptions - Options to pass to `createServicePolicy`.\n   * @param options.trace - Optional callback to trace network requests.\n   */\n  constructor({\n    messenger,\n    env = Env.PRD,\n    queryClientConfig = {},\n    policyOptions = {},\n    trace,\n  }: MoneyAccountApiDataServiceOptions) {\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.#trace =\n      trace ??\n      (async <Result>(\n        _request: MoneyAccountApiDataServiceTraceRequest,\n        fn?: (context?: TraceContext) => Result,\n      ): Promise<Result> => {\n        return await Promise.resolve(fn?.() as Result);\n      });\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        return this.#traceNetworkRequest(\n          {\n            name: TRACES.POSITIONS_API,\n            data: { operation: 'fetchPositions' },\n          },\n          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\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        return this.#traceNetworkRequest(\n          {\n            name: TRACES.INTEREST_API,\n            data: { operation: 'fetchInterest' },\n          },\n          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\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          return this.#traceNetworkRequest(\n            {\n              name: TRACES.HISTORY_API,\n              data: { operation: 'fetchHistory' },\n            },\n            async () => {\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        },\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        return this.#traceNetworkRequest(\n          {\n            name: TRACES.RATE_HISTORY_API,\n            data: { operation: 'fetchRateHistory' },\n          },\n          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(\n              json,\n              RateHistoryResponseStruct,\n            );\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  }\n\n  /**\n   * Runs a network request and emits a best-effort backdated trace.\n   *\n   * @param request - Trace metadata for the network request.\n   * @param fn - Network request to execute.\n   * @returns The network request result.\n   */\n  async #traceNetworkRequest<Result>(\n    request: MoneyAccountApiDataServiceTraceRequest,\n    fn: () => Promise<Result>,\n  ): Promise<Result> {\n    const startTime = Date.now();\n    let success = false;\n    let errorName: string | undefined;\n\n    try {\n      const result = await fn();\n      success = true;\n      return result;\n    } catch (error) {\n      errorName = error instanceof Error ? error.name : typeof error;\n      throw error;\n    } finally {\n      const traceRequest = {\n        ...request,\n        startTime,\n        data: {\n          ...request.data,\n          success,\n          ...(errorName ? { errorName } : {}),\n        },\n      };\n      const onTraceError = (traceError: unknown): void => {\n        traceLogger('Failed to emit trace', {\n          traceName: request.name,\n          traceError,\n        });\n      };\n\n      try {\n        Promise.resolve(this.#trace(traceRequest, () => undefined)).catch(\n          onTraceError,\n        );\n      } catch (traceError) {\n        onTraceError(traceError);\n      }\n    }\n  }\n}\n"]}

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

@@ -1,6 +1,6 @@
 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 { CreateServicePolicyOptions, TraceContext, TraceRequest } from "@metamask/controller-utils";
 import type { Messenger } from "@metamask/messenger";
 import type { QueryClientConfig } from "@tanstack/query-core";
 import { Env } from "./constants.cjs";
@@ -12,6 +12,18 @@ import type { HistoryOptions, InterestOptions, RateHistoryOptions } from "./type
  * service's actions and events.
  */
 export declare const serviceName = "MoneyAccountApiDataService";
+export declare const TRACES: {
+    readonly POSITIONS_API: "Money Account API Fetch Positions";
+    readonly INTEREST_API: "Money Account API Fetch Interest";
+    readonly HISTORY_API: "Money Account API Fetch History";
+    readonly RATE_HISTORY_API: "Money Account API Fetch Rate History";
+};
+export type MoneyAccountApiDataServiceTraceName = (typeof TRACES)[keyof typeof TRACES];
+export type MoneyAccountApiDataServiceTraceRequest = Omit<TraceRequest, 'name'> & {
+    name: MoneyAccountApiDataServiceTraceName;
+    startTime?: number;
+};
+export type MoneyAccountApiDataServiceTraceCallback = <ReturnType>(request: MoneyAccountApiDataServiceTraceRequest, fn?: (context?: TraceContext) => ReturnType) => Promise<ReturnType>;
 /**
  * Invalidates cached queries for {@link MoneyAccountApiDataService}.
  */
@@ -47,6 +59,13 @@ type AllowedEvents = never;
  * {@link MoneyAccountApiDataService}.
  */
 export type MoneyAccountApiDataServiceMessenger = Messenger<typeof serviceName, MoneyAccountApiDataServiceActions | AllowedActions, MoneyAccountApiDataServiceEvents | AllowedEvents>;
+export type MoneyAccountApiDataServiceOptions = {
+    messenger: MoneyAccountApiDataServiceMessenger;
+    env?: Env;
+    queryClientConfig?: QueryClientConfig;
+    policyOptions?: CreateServicePolicyOptions;
+    trace?: MoneyAccountApiDataServiceTraceCallback;
+};
 /**
  * Data service responsible for fetching positions, interest, cash-flow
  * history, and vault rate history from the Money Account APY Tracking API.
@@ -56,19 +75,15 @@ export declare class MoneyAccountApiDataService extends BaseDataService<typeof s
     /**
      * 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`.
+     * @param options - The constructor arguments.
+     * @param options.messenger - The messenger suited for this service.
+     * @param options.env - The target environment. Defaults to production.
+     * @param options.queryClientConfig - Configuration for the underlying
+     * TanStack Query client.
+     * @param options.policyOptions - Options to pass to `createServicePolicy`.
+     * @param options.trace - Optional callback to trace network requests.
      */
-    constructor({ messenger, env, queryClientConfig, policyOptions, }: {
-        messenger: MoneyAccountApiDataServiceMessenger;
-        env?: Env;
-        queryClientConfig?: QueryClientConfig;
-        policyOptions?: CreateServicePolicyOptions;
-    });
+    constructor({ messenger, env, queryClientConfig, policyOptions, trace, }: MoneyAccountApiDataServiceOptions);
     /**
      * Fetches the current vault positions for a given user address.
      *

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

@@ -1 +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"}
+{"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,EACV,0BAA0B,EAC1B,YAAY,EACZ,YAAY,EACb,mCAAmC;AAEpC,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;AAKxD,eAAO,MAAM,MAAM;;;;;CAKT,CAAC;AAEX,MAAM,MAAM,mCAAmC,GAC7C,CAAC,OAAO,MAAM,CAAC,CAAC,MAAM,OAAO,MAAM,CAAC,CAAC;AAEvC,MAAM,MAAM,sCAAsC,GAAG,IAAI,CACvD,YAAY,EACZ,MAAM,CACP,GAAG;IACF,IAAI,EAAE,mCAAmC,CAAC;IAC1C,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,uCAAuC,GAAG,CAAC,UAAU,EAC/D,OAAO,EAAE,sCAAsC,EAC/C,EAAE,CAAC,EAAE,CAAC,OAAO,CAAC,EAAE,YAAY,KAAK,UAAU,KACxC,OAAO,CAAC,UAAU,CAAC,CAAC;AAWzB;;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,MAAM,MAAM,iCAAiC,GAAG;IAC9C,SAAS,EAAE,mCAAmC,CAAC;IAC/C,GAAG,CAAC,EAAE,GAAG,CAAC;IACV,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;IACtC,aAAa,CAAC,EAAE,0BAA0B,CAAC;IAC3C,KAAK,CAAC,EAAE,uCAAuC,CAAC;CACjD,CAAC;AAEF;;;GAGG;AACH,qBAAa,0BAA2B,SAAQ,eAAe,CAC7D,OAAO,WAAW,EAClB,mCAAmC,CACpC;;IAKC;;;;;;;;;;OAUG;gBACS,EACV,SAAS,EACT,GAAa,EACb,iBAAsB,EACtB,aAAkB,EAClB,KAAK,GACN,EAAE,iCAAiC;IAgCpC;;;;;OAKG;IACG,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAyChE;;;;;;;OAOG;IACG,aAAa,CACjB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,gBAAgB,CAAC;IAuD5B;;;;;;;;;;;;OAYG;IACG,YAAY,CAChB,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,eAAe,CAAC;IAmE3B;;;;;;OAMG;IACG,gBAAgB,CACpB,YAAY,EAAE,MAAM,EACpB,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,mBAAmB,CAAC;CA2GhC"}

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

@@ -1,6 +1,6 @@
 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 { CreateServicePolicyOptions, TraceContext, TraceRequest } from "@metamask/controller-utils";
 import type { Messenger } from "@metamask/messenger";
 import type { QueryClientConfig } from "@tanstack/query-core";
 import { Env } from "./constants.mjs";
@@ -12,6 +12,18 @@ import type { HistoryOptions, InterestOptions, RateHistoryOptions } from "./type
  * service's actions and events.
  */
 export declare const serviceName = "MoneyAccountApiDataService";
+export declare const TRACES: {
+    readonly POSITIONS_API: "Money Account API Fetch Positions";
+    readonly INTEREST_API: "Money Account API Fetch Interest";
+    readonly HISTORY_API: "Money Account API Fetch History";
+    readonly RATE_HISTORY_API: "Money Account API Fetch Rate History";
+};
+export type MoneyAccountApiDataServiceTraceName = (typeof TRACES)[keyof typeof TRACES];
+export type MoneyAccountApiDataServiceTraceRequest = Omit<TraceRequest, 'name'> & {
+    name: MoneyAccountApiDataServiceTraceName;
+    startTime?: number;
+};
+export type MoneyAccountApiDataServiceTraceCallback = <ReturnType>(request: MoneyAccountApiDataServiceTraceRequest, fn?: (context?: TraceContext) => ReturnType) => Promise<ReturnType>;
 /**
  * Invalidates cached queries for {@link MoneyAccountApiDataService}.
  */
@@ -47,6 +59,13 @@ type AllowedEvents = never;
  * {@link MoneyAccountApiDataService}.
  */
 export type MoneyAccountApiDataServiceMessenger = Messenger<typeof serviceName, MoneyAccountApiDataServiceActions | AllowedActions, MoneyAccountApiDataServiceEvents | AllowedEvents>;
+export type MoneyAccountApiDataServiceOptions = {
+    messenger: MoneyAccountApiDataServiceMessenger;
+    env?: Env;
+    queryClientConfig?: QueryClientConfig;
+    policyOptions?: CreateServicePolicyOptions;
+    trace?: MoneyAccountApiDataServiceTraceCallback;
+};
 /**
  * Data service responsible for fetching positions, interest, cash-flow
  * history, and vault rate history from the Money Account APY Tracking API.
@@ -56,19 +75,15 @@ export declare class MoneyAccountApiDataService extends BaseDataService<typeof s
     /**
      * 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`.
+     * @param options - The constructor arguments.
+     * @param options.messenger - The messenger suited for this service.
+     * @param options.env - The target environment. Defaults to production.
+     * @param options.queryClientConfig - Configuration for the underlying
+     * TanStack Query client.
+     * @param options.policyOptions - Options to pass to `createServicePolicy`.
+     * @param options.trace - Optional callback to trace network requests.
      */
-    constructor({ messenger, env, queryClientConfig, policyOptions, }: {
-        messenger: MoneyAccountApiDataServiceMessenger;
-        env?: Env;
-        queryClientConfig?: QueryClientConfig;
-        policyOptions?: CreateServicePolicyOptions;
-    });
+    constructor({ messenger, env, queryClientConfig, policyOptions, trace, }: MoneyAccountApiDataServiceOptions);
     /**
      * Fetches the current vault positions for a given user address.
      *

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

@@ -1 +1 @@
-{"version":3,"file":"money-account-api-data-service.d.mts","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"}
+{"version":3,"file":"money-account-api-data-service.d.mts","sourceRoot":"","sources":["../src/money-account-api-data-service.ts"],"names":[],"mappings":"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"}