feat: Expose all PerpsController methods through messenger

[cryptodev-2s]

Description

Mirrors MetaMask/core#8352 for the mobile PerpsController.

• Expand MESSENGER_EXPOSED_METHODS from 35 to 84 methods (alphabetized)
• Auto-generate PerpsController-method-action-types.ts using messenger-generate-action-types CLI
• Export PerpsControllerGetStateAction and all individual action types
• Add generate-method-action-types check/fix scripts to lint/lint:fix

Changelog

CHANGELOG entry: null

Related issues

Fixes: N/A

Manual testing steps

N/A — type-only changes, no user-facing behavior

Screenshots/Recordings

Before

N/A

After

N/A

Pre-merge author checklist

• I've followed MetaMask Contributor Docs and MetaMask Mobile Coding Standards.
• I've completed the PR template to the best of my ability
• I've included tests if applicable
• I've documented my code using JSDoc format if applicable
• I've applied the right labels on the PR (see labeling guidelines). Not required for external contributors.

Pre-merge reviewer checklist

• I've manually tested the PR (e.g. pull and build branch, run the app, test code being changed).
• I confirm that this PR addresses all acceptance criteria described in the ticket it closes and includes the necessary testing evidence such as recordings and or screenshots.

---

Note

Medium Risk
Expands the messenger-exposed surface area of PerpsController, which could affect callers and permissions if any method was not intended to be remotely invokable. Also adds a new lint-time codegen check that may introduce CI failures if generation drifts across environments.

Overview
Exposes the full PerpsController API through the messenger by expanding and alphabetizing MESSENGER_EXPOSED_METHODS, and introduces a named PerpsControllerGetStateAction type.

Switches Perps messenger action typing to generated output: PerpsController-method-action-types.ts is regenerated to include JSDoc’d action types for all controller methods and index.ts now re-exports these individual action types.

Build/CI enforcement changes: bumps @metamask/messenger to ^1.1.0 (for the codegen CLI) and wires messenger-generate-action-types into lint/lint:fix via new generate-method-action-types scripts to keep generated types in sync.

^{Written by Cursor Bugbot for commit 0fe513d. This will update automatically on new commits. Configure here.}

[github-actions]

CLA Signature Action: All authors have signed the CLA. You may need to manually re-run the blocking PR check if it doesn't pass in a few minutes.

[cryptodev-2s]

simplified here https://github.com/MetaMask/metamask-mobile/pull/28341/changes#diff-7ae45ad102eab3b6d7e7896acd08c427a9b25b346470d7bc6507b6481575d519

[github-actions]

🔍 Smart E2E Test Selection

• Selected E2E tags: SmokePerps, SmokeWalletPlatform, SmokeConfirmations
• Selected Performance tags: @PerformancePreps
• Risk Level: medium
• AI Confidence: 82%

click to see 🤖 AI reasoning details

E2E Test Selection:
The changes are focused on the PerpsController domain:

1. PerpsController.ts: Massively expanded MESSENGER_EXPOSED_METHODS array (~50+ new methods added), including WebSocket subscriptions, provider management, withdrawal flows, market data preloading, and trading operations. Also exports a new PerpsControllerGetStateAction type. These are additive changes expanding the controller's messenger API surface.

2. PerpsController-method-action-types.ts: Auto-generated file expanded from ~20 to ~70+ action type definitions, adding JSDoc and new types for all newly exposed methods.

3. index.ts: Exports all new action types.

4. package.json: Added generate-method-action-types scripts and bumped @metamask/messenger from 1.0.0 to 1.1.0 (minor version, likely adds the CLI tool used in the new scripts).

5. yarn.lock: Corresponding dependency update.

Impact: Changes are additive and confined to the Perps controller. No Engine initialization changes, no other controller modifications. The expanded messenger API means Perps features now have more capabilities exposed, which could affect Perps UI flows.

Tag selection rationale:

• SmokePerps: Directly tests Perps functionality (Add Funds, deposits, balance verification) - primary tag for these changes
• SmokeWalletPlatform: Required per SmokePerps tag description (Perps is a section inside Trending tab)
• SmokeConfirmations: Required per SmokePerps tag description (Add Funds deposits are on-chain transactions)

The changes don't affect other controller domains, navigation, or shared components, so other tags are not warranted.

Performance Test Selection:
The PerpsController changes include new market data preloading methods (startMarketDataPreload/stopMarketDataPreload), WebSocket subscription methods, and caching mechanisms (getCachedMarketDataForActiveProvider, getCachedUserDataForActiveProvider). These additions could impact perps market loading performance, position management, and the add funds flow. The @PerformancePreps tag covers perps market loading, position management, add funds flow, and order execution - all directly relevant to these controller changes.

View GitHub Actions results

[github-actions]

✅ E2E Fixture Validation — Schema is up to date
18 value mismatches detected (expected — fixture represents an existing user).
View details

[sonarqubecloud]

Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
0 Security Hotspots
0.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud