Skip to content

feat(money): implement MoneyAccountApiDataService#9402

Merged
ffmcgee725 merged 12 commits into
mainfrom
jc/MUSD-1042-impl
Jul 7, 2026
Merged

feat(money): implement MoneyAccountApiDataService#9402
ffmcgee725 merged 12 commits into
mainfrom
jc/MUSD-1042-impl

Conversation

@ffmcgee725

Copy link
Copy Markdown
Member

Explanation

The Earn team currently lacks a dedicated data service for fetching user positions, interest accruals, cash-flow history, and vault rate history from the Money Account API (vertical app hosted at money.api.cx.metamask.io).

Follow up to #9278

This PR introduces @metamask/money-account-api-data-service, a new package that:

  • Extends BaseDataService to leverage TanStack Query caching, service policy (retries + circuit-breaking), and messenger integration out of the box.
  • Exposes 4 methods via the messenger: fetchPositions, fetchInterest, fetchHistory, fetchRateHistory.
  • Uses @metamask/superstruct for runtime response validation, with types derived from structs (Infer<typeof ...Struct>) to prevent type/struct drift.
  • Includes detailed validation error messages (superstruct failure details + error cause chain) for easier production debugging.
  • Uses fetchInfiniteQuery for the cursor-paginated history endpoint, giving consumers proper TanStack Query pagination semantics.
  • Configures retryFilterPolicy to skip retrying validation errors (malformed responses won't fix themselves).
  • Supports environment switching (dev / uat / prd) via an Env enum + URL map, following the claims-controller pattern.

This is architected as an independent service. The client calls it directly for API-sourced data, separate from money-account-balance-service which handles RPC-based balance fetching. A future orchestration layer may unify these.

Checklist

  • I've updated the test suite for new or updated code as appropriate
  • I've updated documentation (JSDoc, Markdown, etc.) for new or updated code as appropriate
  • I've communicated my changes to consumers by updating changelogs for packages I've changed
  • I've introduced breaking changes in this PR and have prepared draft pull requests for clients and consumer packages to resolve them

Note: No breaking changes introduced — this is an entirely new package (v0.0.0).


Note

Low Risk
New isolated package with no changes to existing controllers; risk is limited to future consumers trusting API-sourced financial display data and external API contract stability.

Overview
Adds @metamask/money-account-api-data-service, a new Earn-team package that fetches vault positions, interest, cash-flow history, and vault rate history from the Money Account HTTP API (separate from RPC-based money-account-balance-service).

MoneyAccountApiDataService extends BaseDataService with TanStack Query caching, messenger actions (fetchPositions, fetchInterest, fetchHistory, fetchRateHistory, invalidateQueries), dev/uat/prd base URLs via Env, and superstruct-validated responses with MoneyAccountApiResponseValidationError (no retries on validation failures). History uses fetchInfiniteQuery for cursor pagination; other endpoints use tuned stale times aligned with server cache TTLs.

Monorepo wiring updates CODEOWNERS, README, teams.json, root tsconfig references, and yarn.lock for the new workspace package.

Reviewed by Cursor Bugbot for commit ae6334b. Bugbot is set up for automated code reviews on this repo. Configure here.

@ffmcgee725 ffmcgee725 requested review from a team as code owners July 7, 2026 09:19
@ffmcgee725

Copy link
Copy Markdown
Member Author

@metamaskbot publish-preview

@cursor cursor Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Cursor Bugbot has reviewed your changes and found 1 potential issue.

Fix All in Cursor

❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, have a team admin enable autofix in the Cursor dashboard.

Reviewed by Cursor Bugbot for commit fc75e0e. Configure here.

},
},
options?.cursor ?? undefined,
);

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

History cache returns wrong page

Medium Severity

fetchHistory omits cursor from the TanStack query key but can populate the infinite-query cache with a cursor-driven request as pages[0]. A later call with the same filters and no cursor goes through BaseDataService’s pageParam === undefined path and returns that cached pages[0] while data is still fresh, so the first page of cash-flow history can be wrong until stale time expires or the cache is invalidated.

Fix in Cursor Fix in Web

Reviewed by Cursor Bugbot for commit fc75e0e. Configure here.

Base automatically changed from jc/MUSD-1042 to main July 7, 2026 09:26
@ffmcgee725 ffmcgee725 force-pushed the jc/MUSD-1042-impl branch from fc75e0e to b3ee420 Compare July 7, 2026 09:29
@github-actions

github-actions Bot commented Jul 7, 2026

Copy link
Copy Markdown
Contributor

Preview builds have been published. Learn how to use preview builds in other projects.

Expand for full list of packages and versions.
@metamask-previews/account-tree-controller@7.5.3-preview-fc75e0e
@metamask-previews/accounts-controller@39.0.4-preview-fc75e0e
@metamask-previews/address-book-controller@7.1.2-preview-fc75e0e
@metamask-previews/ai-controllers@0.7.0-preview-fc75e0e
@metamask-previews/analytics-controller@1.2.1-preview-fc75e0e
@metamask-previews/analytics-data-regulation-controller@0.0.0-preview-fc75e0e
@metamask-previews/announcement-controller@8.1.0-preview-fc75e0e
@metamask-previews/app-metadata-controller@2.0.1-preview-fc75e0e
@metamask-previews/approval-controller@9.0.2-preview-fc75e0e
@metamask-previews/assets-controller@10.0.1-preview-fc75e0e
@metamask-previews/assets-controllers@109.3.0-preview-fc75e0e
@metamask-previews/authenticated-user-storage@3.0.0-preview-fc75e0e
@metamask-previews/base-controller@9.1.0-preview-fc75e0e
@metamask-previews/base-data-service@0.1.3-preview-fc75e0e
@metamask-previews/bitcoin-regtest-up@1.0.0-preview-fc75e0e
@metamask-previews/bridge-controller@77.3.2-preview-fc75e0e
@metamask-previews/bridge-status-controller@74.0.2-preview-fc75e0e
@metamask-previews/build-utils@3.0.4-preview-fc75e0e
@metamask-previews/chain-agnostic-permission@1.7.0-preview-fc75e0e
@metamask-previews/chomp-api-service@3.1.0-preview-fc75e0e
@metamask-previews/claims-controller@0.5.3-preview-fc75e0e
@metamask-previews/client-controller@1.0.1-preview-fc75e0e
@metamask-previews/client-utils@0.0.0-preview-fc75e0e
@metamask-previews/compliance-controller@2.1.0-preview-fc75e0e
@metamask-previews/composable-controller@12.0.1-preview-fc75e0e
@metamask-previews/config-registry-controller@0.4.1-preview-fc75e0e
@metamask-previews/connectivity-controller@0.2.0-preview-fc75e0e
@metamask-previews/controller-utils@12.3.0-preview-fc75e0e
@metamask-previews/core-backend@6.5.0-preview-fc75e0e
@metamask-previews/delegation-controller@3.0.2-preview-fc75e0e
@metamask-previews/earn-controller@12.2.2-preview-fc75e0e
@metamask-previews/eip-5792-middleware@3.0.4-preview-fc75e0e
@metamask-previews/eip-7702-internal-rpc-middleware@0.1.1-preview-fc75e0e
@metamask-previews/eip1193-permission-middleware@2.0.1-preview-fc75e0e
@metamask-previews/ens-controller@19.1.5-preview-fc75e0e
@metamask-previews/eth-block-tracker@15.0.1-preview-fc75e0e
@metamask-previews/eth-json-rpc-middleware@23.1.3-preview-fc75e0e
@metamask-previews/eth-json-rpc-provider@6.0.1-preview-fc75e0e
@metamask-previews/foundryup@1.0.1-preview-fc75e0e
@metamask-previews/gas-fee-controller@26.2.4-preview-fc75e0e
@metamask-previews/gator-permissions-controller@4.2.2-preview-fc75e0e
@metamask-previews/geolocation-controller@0.1.3-preview-fc75e0e
@metamask-previews/java-tron-up@1.0.0-preview-fc75e0e
@metamask-previews/json-rpc-engine@10.5.0-preview-fc75e0e
@metamask-previews/json-rpc-middleware-stream@8.0.8-preview-fc75e0e
@metamask-previews/keyring-controller@27.1.0-preview-fc75e0e
@metamask-previews/local-node-utils@1.0.0-preview-fc75e0e
@metamask-previews/logging-controller@8.0.2-preview-fc75e0e
@metamask-previews/message-manager@14.1.2-preview-fc75e0e
@metamask-previews/messenger@2.0.0-preview-fc75e0e
@metamask-previews/messenger-cli@0.2.0-preview-fc75e0e
@metamask-previews/money-account-api-data-service@0.0.0-preview-fc75e0e
@metamask-previews/money-account-balance-service@2.1.2-preview-fc75e0e
@metamask-previews/money-account-controller@0.3.3-preview-fc75e0e
@metamask-previews/money-account-upgrade-controller@2.2.1-preview-fc75e0e
@metamask-previews/multichain-account-service@11.1.0-preview-fc75e0e
@metamask-previews/multichain-api-middleware@4.0.1-preview-fc75e0e
@metamask-previews/multichain-network-controller@3.2.1-preview-fc75e0e
@metamask-previews/multichain-transactions-controller@7.1.1-preview-fc75e0e
@metamask-previews/name-controller@9.1.2-preview-fc75e0e
@metamask-previews/network-controller@34.0.0-preview-fc75e0e
@metamask-previews/network-enablement-controller@5.4.1-preview-fc75e0e
@metamask-previews/notification-services-controller@24.3.0-preview-fc75e0e
@metamask-previews/passkey-controller@2.0.1-preview-fc75e0e
@metamask-previews/permission-controller@13.1.1-preview-fc75e0e
@metamask-previews/permission-log-controller@5.1.0-preview-fc75e0e
@metamask-previews/perps-controller@9.2.1-preview-fc75e0e
@metamask-previews/phishing-controller@17.2.0-preview-fc75e0e
@metamask-previews/platform-api-docs@0.0.0-preview-fc75e0e
@metamask-previews/polling-controller@16.0.8-preview-fc75e0e
@metamask-previews/preferences-controller@23.1.0-preview-fc75e0e
@metamask-previews/profile-metrics-controller@4.0.1-preview-fc75e0e
@metamask-previews/profile-sync-controller@28.2.0-preview-fc75e0e
@metamask-previews/ramps-controller@15.1.0-preview-fc75e0e
@metamask-previews/rate-limit-controller@7.0.1-preview-fc75e0e
@metamask-previews/react-data-query@0.2.1-preview-fc75e0e
@metamask-previews/remote-feature-flag-controller@4.2.2-preview-fc75e0e
@metamask-previews/sample-controllers@5.0.3-preview-fc75e0e
@metamask-previews/seedless-onboarding-controller@10.0.3-preview-fc75e0e
@metamask-previews/selected-network-controller@26.1.5-preview-fc75e0e
@metamask-previews/shield-controller@5.1.2-preview-fc75e0e
@metamask-previews/signature-controller@39.2.7-preview-fc75e0e
@metamask-previews/smart-transactions-controller@24.2.4-preview-fc75e0e
@metamask-previews/snap-account-service@1.0.0-preview-fc75e0e
@metamask-previews/social-controllers@2.3.1-preview-fc75e0e
@metamask-previews/solana-test-validator-up@1.0.0-preview-fc75e0e
@metamask-previews/stellar-quickstart-up@0.0.0-preview-fc75e0e
@metamask-previews/storage-service@1.0.2-preview-fc75e0e
@metamask-previews/subscription-controller@6.2.0-preview-fc75e0e
@metamask-previews/transaction-controller@68.2.2-preview-fc75e0e
@metamask-previews/transaction-pay-controller@23.17.4-preview-fc75e0e
@metamask-previews/user-operation-controller@41.2.6-preview-fc75e0e
@metamask-previews/wallet@7.0.0-preview-fc75e0e
@metamask-previews/wallet-cli@0.0.0-preview-fc75e0e

Co-authored-by: Cursor <cursoragent@cursor.com>

# Conflicts:
#	packages/money-account-api-data-service/CHANGELOG.md
#	packages/money-account-api-data-service/LICENSE
#	packages/money-account-api-data-service/README.md
#	packages/money-account-api-data-service/jest.config.js
#	packages/money-account-api-data-service/package.json
#	packages/money-account-api-data-service/src/index.ts
#	packages/money-account-api-data-service/tsconfig.build.json
#	packages/money-account-api-data-service/tsconfig.json
#	yarn.lock
@ffmcgee725 ffmcgee725 force-pushed the jc/MUSD-1042-impl branch from b3ee420 to 2143e62 Compare July 7, 2026 09:34
@ffmcgee725

Copy link
Copy Markdown
Member Author

@metamaskbot publish-preview

@github-actions

github-actions Bot commented Jul 7, 2026

Copy link
Copy Markdown
Contributor

Preview builds have been published. Learn how to use preview builds in other projects.

Expand for full list of packages and versions.
@metamask-previews/account-tree-controller@7.5.3-preview-31e57bd36
@metamask-previews/accounts-controller@39.0.4-preview-31e57bd36
@metamask-previews/address-book-controller@7.1.2-preview-31e57bd36
@metamask-previews/ai-controllers@0.7.0-preview-31e57bd36
@metamask-previews/analytics-controller@1.2.1-preview-31e57bd36
@metamask-previews/analytics-data-regulation-controller@0.0.0-preview-31e57bd36
@metamask-previews/announcement-controller@8.1.0-preview-31e57bd36
@metamask-previews/app-metadata-controller@2.0.1-preview-31e57bd36
@metamask-previews/approval-controller@9.0.2-preview-31e57bd36
@metamask-previews/assets-controller@10.0.1-preview-31e57bd36
@metamask-previews/assets-controllers@109.3.0-preview-31e57bd36
@metamask-previews/authenticated-user-storage@3.0.0-preview-31e57bd36
@metamask-previews/base-controller@9.1.0-preview-31e57bd36
@metamask-previews/base-data-service@0.1.3-preview-31e57bd36
@metamask-previews/bitcoin-regtest-up@1.0.0-preview-31e57bd36
@metamask-previews/bridge-controller@77.3.2-preview-31e57bd36
@metamask-previews/bridge-status-controller@74.0.2-preview-31e57bd36
@metamask-previews/build-utils@3.0.4-preview-31e57bd36
@metamask-previews/chain-agnostic-permission@1.7.0-preview-31e57bd36
@metamask-previews/chomp-api-service@3.1.0-preview-31e57bd36
@metamask-previews/claims-controller@0.5.3-preview-31e57bd36
@metamask-previews/client-controller@1.0.1-preview-31e57bd36
@metamask-previews/client-utils@0.0.0-preview-31e57bd36
@metamask-previews/compliance-controller@2.1.0-preview-31e57bd36
@metamask-previews/composable-controller@12.0.1-preview-31e57bd36
@metamask-previews/config-registry-controller@0.4.1-preview-31e57bd36
@metamask-previews/connectivity-controller@0.2.0-preview-31e57bd36
@metamask-previews/controller-utils@12.3.0-preview-31e57bd36
@metamask-previews/core-backend@6.5.0-preview-31e57bd36
@metamask-previews/delegation-controller@3.0.2-preview-31e57bd36
@metamask-previews/earn-controller@12.2.2-preview-31e57bd36
@metamask-previews/eip-5792-middleware@3.0.4-preview-31e57bd36
@metamask-previews/eip-7702-internal-rpc-middleware@0.1.1-preview-31e57bd36
@metamask-previews/eip1193-permission-middleware@2.0.1-preview-31e57bd36
@metamask-previews/ens-controller@19.1.5-preview-31e57bd36
@metamask-previews/eth-block-tracker@15.0.1-preview-31e57bd36
@metamask-previews/eth-json-rpc-middleware@23.1.3-preview-31e57bd36
@metamask-previews/eth-json-rpc-provider@6.0.1-preview-31e57bd36
@metamask-previews/foundryup@1.0.1-preview-31e57bd36
@metamask-previews/gas-fee-controller@26.2.4-preview-31e57bd36
@metamask-previews/gator-permissions-controller@4.2.2-preview-31e57bd36
@metamask-previews/geolocation-controller@0.1.3-preview-31e57bd36
@metamask-previews/java-tron-up@1.0.0-preview-31e57bd36
@metamask-previews/json-rpc-engine@10.5.0-preview-31e57bd36
@metamask-previews/json-rpc-middleware-stream@8.0.8-preview-31e57bd36
@metamask-previews/keyring-controller@27.1.0-preview-31e57bd36
@metamask-previews/local-node-utils@1.0.0-preview-31e57bd36
@metamask-previews/logging-controller@8.0.2-preview-31e57bd36
@metamask-previews/message-manager@14.1.2-preview-31e57bd36
@metamask-previews/messenger@2.0.0-preview-31e57bd36
@metamask-previews/messenger-cli@0.2.0-preview-31e57bd36
@metamask-previews/money-account-api-data-service@0.0.0-preview-31e57bd36
@metamask-previews/money-account-balance-service@2.1.2-preview-31e57bd36
@metamask-previews/money-account-controller@0.3.3-preview-31e57bd36
@metamask-previews/money-account-upgrade-controller@2.2.1-preview-31e57bd36
@metamask-previews/multichain-account-service@11.1.0-preview-31e57bd36
@metamask-previews/multichain-api-middleware@4.0.1-preview-31e57bd36
@metamask-previews/multichain-network-controller@3.2.1-preview-31e57bd36
@metamask-previews/multichain-transactions-controller@7.1.1-preview-31e57bd36
@metamask-previews/name-controller@9.1.2-preview-31e57bd36
@metamask-previews/network-controller@34.0.0-preview-31e57bd36
@metamask-previews/network-enablement-controller@5.4.1-preview-31e57bd36
@metamask-previews/notification-services-controller@24.3.0-preview-31e57bd36
@metamask-previews/passkey-controller@2.0.1-preview-31e57bd36
@metamask-previews/permission-controller@13.1.1-preview-31e57bd36
@metamask-previews/permission-log-controller@5.1.0-preview-31e57bd36
@metamask-previews/perps-controller@9.2.1-preview-31e57bd36
@metamask-previews/phishing-controller@17.2.0-preview-31e57bd36
@metamask-previews/platform-api-docs@0.0.0-preview-31e57bd36
@metamask-previews/polling-controller@16.0.8-preview-31e57bd36
@metamask-previews/preferences-controller@23.1.0-preview-31e57bd36
@metamask-previews/profile-metrics-controller@4.0.1-preview-31e57bd36
@metamask-previews/profile-sync-controller@28.2.0-preview-31e57bd36
@metamask-previews/ramps-controller@15.1.0-preview-31e57bd36
@metamask-previews/rate-limit-controller@7.0.1-preview-31e57bd36
@metamask-previews/react-data-query@0.2.1-preview-31e57bd36
@metamask-previews/remote-feature-flag-controller@4.2.2-preview-31e57bd36
@metamask-previews/sample-controllers@5.0.3-preview-31e57bd36
@metamask-previews/seedless-onboarding-controller@10.0.3-preview-31e57bd36
@metamask-previews/selected-network-controller@26.1.5-preview-31e57bd36
@metamask-previews/shield-controller@5.1.2-preview-31e57bd36
@metamask-previews/signature-controller@39.2.7-preview-31e57bd36
@metamask-previews/smart-transactions-controller@24.2.4-preview-31e57bd36
@metamask-previews/snap-account-service@1.0.0-preview-31e57bd36
@metamask-previews/social-controllers@2.3.1-preview-31e57bd36
@metamask-previews/solana-test-validator-up@1.0.0-preview-31e57bd36
@metamask-previews/stellar-quickstart-up@0.0.0-preview-31e57bd36
@metamask-previews/storage-service@1.0.2-preview-31e57bd36
@metamask-previews/subscription-controller@6.2.0-preview-31e57bd36
@metamask-previews/transaction-controller@68.2.2-preview-31e57bd36
@metamask-previews/transaction-pay-controller@23.17.4-preview-31e57bd36
@metamask-previews/user-operation-controller@41.2.6-preview-31e57bd36
@metamask-previews/wallet@7.0.0-preview-31e57bd36
@metamask-previews/wallet-cli@0.0.0-preview-31e57bd36

@ffmcgee725 ffmcgee725 added this pull request to the merge queue Jul 7, 2026
Merged via the queue into main with commit 4f14fd8 Jul 7, 2026
417 checks passed
@ffmcgee725 ffmcgee725 deleted the jc/MUSD-1042-impl branch July 7, 2026 10:16
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants