feat(perps): sync controller from mobile

[abretonc7s]

Explanation

Syncs app/controllers/perps/ from MetaMask Mobile (commit 87ad5e48) to packages/perps-controller/src/ using the automated validate-core-sync.sh pipeline. All 9 sync steps passed with 0 suppressions.

Key changes:

• Disk-backed cold-start cache — new perpsDiskPersistence.ts enables instant data display on launch by hydrating in-memory caches from MMKV synchronously at construction time. Adds skipTTL option to getCachedMarketDataForActiveProvider and getCachedUserDataForActiveProvider so disk-hydrated data is returned regardless of age on first render.
• Perps decimal formatters — new perpsFormatters.ts exports shared formatting utilities (price, size, leverage, PnL, funding rate) from the controller for use by extension consumers.
• TP/SL order fix — filters TP/SL orders by isPositionTpsl to prevent position-bound orders from disappearing after creating a market order. Distinguishes position TP/SL from normalTpsl children on pending limit orders.
• WebSocket reconnection fix — avoids full reconnection on foreground return when the WebSocket is still alive within the grace period. Adds ForegroundPingRetryDelayMs constant.
• Geo-block compliance — enforces compliance gate on Market Insights Long/Short actions.
• Funding payments fix — replaces single API call with paginated fetch using fetchWindowWithAutoSplit that recursively splits windows hitting the API cap, ensuring complete results. Deduplicates at chunk boundaries.
• Funding rate config — adds FUNDING_RATE_CONFIG constants for display formatting.
• Cache key refactoring — extracts buildProviderCacheKey and getProviderNetworkKey helpers. Replaces private #marketCacheKey/#providerIsTestnet with shared utilities. Adds #getAggregatedCacheProviderIds to recover disk-hydrated provider snapshots before init() finishes.
• MYX dynamic import fix — removes variable indirection for ts-bridge compatibility.

New files:

• packages/perps-controller/src/utils/perpsDiskPersistence.ts (360 lines)
• packages/perps-controller/src/utils/perpsFormatters.ts (624 lines)

References

• Mobile PR chain: disk cache (#27898), formatters (#28538), TP/SL fix (#28073), WS fix (#28592), geo-block (#28678), funding fix (#28671)

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

Medium Risk
Touches core PerpsController caching/preload behavior (including new disk persistence and cache-key refactors) plus funding history fetching logic; regressions could impact cold-start UI correctness or data freshness across networks/accounts.

Overview
Adds a disk-backed cold-start cache for perps market/user data. PerpsController now hydrates in-memory caches synchronously at construction, persists preload snapshots back to disk, and clears disk user data on account changes; cache reads gain an optional skipTTL to allow first-render usage of disk-hydrated data.

Refactors cache keying and aggregated cache reads. Introduces buildProviderCacheKey/getProviderNetworkKey helpers and updates aggregated reads to include provider ids inferred from disk-hydrated keys before init() completes.

Fixes and shared utilities. TP/SL lookup now filters by isPositionTpsl to avoid hiding position-bound TP/SL orders, funding history fetching switches to paginated windowed requests with recursive auto-splitting/deduping to avoid API caps, and new perpsFormatters/FUNDING_RATE_CONFIG are exported for consistent formatting.

^{Reviewed by Cursor Bugbot for commit b36f510. Bugbot is set up for automated code reviews on this repo. Configure here.}

[cursor]

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

^{❌ 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 c33111b658fb9f5689ee75317c5c1a19a9141dce. Configure here.}

[abretonc7s]

@metamaskbot publish-previews

[abretonc7s]

@metamaskbot publish-preview

[abretonc7s]

@metamaskbot publish-previews