feat: MUSD-626 update earn controller to follow init pattern (#8421)

## Explanation

`EarnController` previously performed async work (SDK initialization,
data refreshing) directly in its constructor and required
`selectedNetworkClientId` to be passed in as a constructor argument —
storing derived state that was already available from
`NetworkController`.

This PR refactors `EarnController` to follow the standard init pattern
used across the codebase:

- Removes `selectedNetworkClientId` from the constructor options; the
controller now reads it on-demand from `NetworkController:getState`.
- Adds an `init()` method that performs the async startup work (SDK
initialization, pooled staking data refresh, lending data refresh,
eligibility refresh) that was previously triggered from the constructor.
- Adds a `deferAccountDependentRefreshes()` method to handle refreshes
that depend on account state being ready, subscribed to
`AccountTreeController:stateChanged`.
- Removes the now-redundant stored `#selectedNetworkClientId` field.
- Deduplicates eligibility refresh calls that were previously triggered
from multiple code paths.

## Breaking Changes
- Removed `selectedNetworkClientId` from the `EarnController`
constructor.
- Added `NetworkController:getState` action to `EarnController`
- Added `AccountTreeController:stateChange` event `EarnController`

## References
- Fixes [MUSD-626: Update EarnController to follow .init()
pattern](https://consensyssoftware.atlassian.net/browse/MUSD-626)

## Checklist

- [x] I've updated the test suite for new or updated code as appropriate
- [x] 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

<!-- CURSOR_SUMMARY -->
---

> [!NOTE]
> **Medium Risk**
> Introduces breaking API/behavior changes to `EarnController`
initialization and refresh flow; consumers must now call `init()` and
update messenger policies, and incorrect sequencing could lead to
missing initial data refreshes.
> 
> **Overview**
> **Refactors `EarnController` to follow an explicit `init()` pattern.**
Async SDK initialization and initial data refreshes are removed from the
constructor; consumers must call `init()`, which deduplicates concurrent
calls and supports retry on failure.
> 
> **Changes how network/account state is sourced and when refreshes
run.** `selectedNetworkClientId` is no longer stored/passed in; it’s
read via `NetworkController:getState`, and when no EVM account is
available at init time the controller defers portfolio refresh until a
one-time `AccountTreeController:stateChange` provides a usable selected
account group.
> 
> **Eligibility/refresh API adjustments (breaking).**
`refreshPooledStakingData`/`refreshLendingData` no longer perform
eligibility checks internally, and the
`EarnController:refreshLendingEligibility` action/type (and related
options type) are removed in favor of `refreshEarnEligibility`; tests
and changelog are updated accordingly.
> 
> <sup>Reviewed by [Cursor Bugbot](https://cursor.com/bugbot) for commit
b3fcdef. Bugbot is set up for automated
code reviews on this repo. Configure
[here](https://www.cursor.com/dashboard/bugbot).</sup>
<!-- /CURSOR_SUMMARY -->

Author: Matt561

eslint-suppressions.json

@@ -929,22 +929,19 @@
     }
   },
   "packages/earn-controller/src/EarnController.test.ts": {
-    "@typescript-eslint/explicit-function-return-type": {
+    "no-restricted-syntax": {
       "count": 1
-    },
-    "jest/unbound-method": {
-      "count": 36
     }
   },
   "packages/earn-controller/src/EarnController.ts": {
     "@typescript-eslint/explicit-function-return-type": {
-      "count": 9
-    },
-    "id-length": {
-      "count": 2
+      "count": 4
     },
     "no-negated-condition": {
       "count": 3
+    },
+    "no-restricted-syntax": {
+      "count": 1
     }
   },
   "packages/earn-controller/src/selectors.ts": {

packages/earn-controller/CHANGELOG.md

@@ -9,10 +9,16 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Changed
 
+- **BREAKING:** `EarnController` constructor no longer accepts `selectedNetworkClientId` and no longer performs async work during construction. Consumers must call `init()` after construction. The messenger must now allow `AccountTreeController:stateChange` and `NetworkController:getState` ([#8421](https://github.com/MetaMask/core/pull/8421))
+- **BREAKING:** `refreshPooledStakingData` and `refreshLendingData` no longer call eligibility checks internally. Eligibility is fetched once during `init()`. Consumers that relied on these methods to keep eligibility state current must call `refreshEarnEligibility` separately ([#8421](https://github.com/MetaMask/core/pull/8421))
 - Bump `@metamask/controller-utils` from `^11.19.0` to `^11.20.0` ([#8344](https://github.com/MetaMask/core/pull/8344))
 - Bump `@metamask/messenger` from `^1.0.0` to `^1.1.1` ([#8364](https://github.com/MetaMask/core/pull/8364), [#8373](https://github.com/MetaMask/core/pull/8373))
 - Bump `@metamask/transaction-controller` from `^64.0.0` to `^64.1.0` ([#8432](https://github.com/MetaMask/core/pull/8432))
 
+### Removed
+
+- **BREAKING:** Removed `EarnController:refreshLendingEligibility` messenger action and `EarnControllerRefreshLendingEligibilityAction` type. Use `EarnController:refreshEarnEligibility` instead ([#8421](https://github.com/MetaMask/core/pull/8421))
+
 ## [11.2.1]
 
 ### Changed

packages/earn-controller/src/EarnController-method-action-types.ts

@@ -116,19 +116,6 @@ export type EarnControllerRefreshLendingPositionsAction = {
   handler: EarnController['refreshLendingPositions'];
 };
 
-/**
- * Refreshes the lending eligibility status for the current account.
- * Updates the eligibility status in the controller state based on the location and address blocklist for compliance.
- *
- * @param options - Optional arguments
- * @param [options.address] - The address to refresh lending eligibility for (optional).
- * @returns A promise that resolves when the eligibility status has been updated
- */
-export type EarnControllerRefreshLendingEligibilityAction = {
-  type: `EarnController:refreshLendingEligibility`;
-  handler: EarnController['refreshLendingEligibility'];
-};
-
 /**
  * Refreshes all lending related data including markets, positions, and eligibility.
  * This method allows partial success, meaning some data may update while other requests fail.
@@ -302,7 +289,6 @@ export type EarnControllerMethodActions =
   | EarnControllerRefreshPooledStakingDataAction
   | EarnControllerRefreshLendingMarketsAction
   | EarnControllerRefreshLendingPositionsAction
-  | EarnControllerRefreshLendingEligibilityAction
   | EarnControllerRefreshLendingDataAction
   | EarnControllerRefreshTronStakingApyAction
   | EarnControllerGetTronStakingApyAction