@metamask-previews/wallet 4.0.0-preview-9de9aa4 → 4.0.0-preview-ed0047684

package/CHANGELOG.md

@@ -7,6 +7,12 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+### Added
+
+- **BREAKING:** Add `NetworkController` initialization ([#9001](https://github.com/MetaMask/core/pull/9001))
+  - Passing `instanceOptions.networkController.infuraProjectId` is now required.
+- Add the `Wallet.init` function which calls `init` on required instances ([#9001](https://github.com/MetaMask/core/pull/9001))
+
 ## [4.0.0]
 
 ### Added

package/dist/Wallet.cjs

@@ -93,6 +93,19 @@ class Wallet {
     getInstance(name) {
         return __classPrivateFieldGet(this, _Wallet_instances, "f")[name];
     }
+    /**
+     * Complete additional initialization of instantiated controllers or services after instantiating `Wallet`.
+     *
+     * @returns The results of all initialization calls.
+     */
+    init() {
+        return Promise.allSettled(Object.values(__classPrivateFieldGet(this, _Wallet_instances, "f"))
+            .filter((instance) => 
+        // We do actually want to check the prototype here.
+        // eslint-disable-next-line no-restricted-syntax
+        'init' in instance)
+            .map(async (instance) => instance.init()));
+    }
     /**
      * Destroy the wallet instance.
      */

package/dist/Wallet.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"Wallet.cjs","sourceRoot":"","sources":["../src/Wallet.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AACA,mDAAgD;AAChD,2CAA8C;AAS9C,wEAA6D;AAG7D,MAAa,MAAM;IAYjB;;;;;;;;;;OAUG;IACH,YAAY,OAAsB;QAtBlC,oEAAoE;QAC3D,oCAAyD;QAEzD,oCAA6B;QAE7B,6CAEP;QAEF,8BAAe,KAAK,EAAC;QAcnB,uBAAA,IAAI,qBACF,OAAO,CAAC,SAAS;YACjB,IAAI,qBAAS,CAAC;gBACZ,SAAS,EAAE,MAAM;aAClB,CAAC,MAAA,CAAC;QAEL,uBAAA,IAAI,qBAAc,IAAA,2BAAU,EAAC;YAC3B,GAAG,OAAO;YACV,SAAS,EAAE,uBAAA,IAAI,yBAAW;SAC3B,CAAC,MAAA,CAAC;QAEH,uBAAA,IAAI,8BAAuB,MAAM,CAAC,WAAW,CAC3C,MAAM,CAAC,OAAO,CAAC,uBAAA,IAAI,yBAAW,CAAC;aAC5B,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,EAAE,EAAE,CAAC,IAAA,mBAAW,EAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;aAC5D,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,QAAQ,CAAC,EAAE,EAAE,CAAC;YACzB,IAAI;YACH,QAAkD,CAAC,QAAQ;SAC7D,CAAC,CACL,MAAA,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,IAAI,SAAS;QACX,OAAO,uBAAA,IAAI,yBAAW,CAAC;IACzB,CAAC;IAED,IAAI,SAAS,CAAC,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;IAC/D,CAAC;IAED;;OAEG;IACH,IAAI,KAAK;QACP,OAAO,MAAM,CAAC,OAAO,CAAC,uBAAA,IAAI,yBAAW,CAAC,CAAC,MAAM,CAC3C,CAAC,UAAU,EAAE,CAAC,IAAI,EAAE,QAAQ,CAAC,EAAE,EAAE;YAC/B,mDAAmD;YACnD,gDAAgD;YAChD,IAAI,OAAO,IAAI,QAAQ,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;gBAC1C,UAAU,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC;YACpC,CAAC;YACD,OAAO,UAAU,CAAC;QACpB,CAAC,EACD,EAAE,CACa,CAAC;IACpB,CAAC;IAED,IAAI,KAAK,CAAC,CAAC;QACT,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;IAC9D,CAAC;IAED;;OAEG;IACH,IAAI,kBAAkB;QAGpB,OAAO,uBAAA,IAAI,kCAAoB,CAAC;IAClC,CAAC;IAED,IAAI,kBAAkB,CAAC,CAAC;QACtB,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;IACzE,CAAC;IAUD;;;;;;OAMG;IACH,WAAW,CACT,IAAY;QAEZ,OAAO,uBAAA,IAAI,yBAAW,CAAC,IAA8B,CAAC,CAAC;IACzD,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,OAAO;QACX,IAAI,uBAAA,IAAI,2BAAa,EAAE,CAAC;YACtB,OAAO;QACT,CAAC;QAED,uBAAA,IAAI,uBAAgB,IAAI,MAAA,CAAC;QAEzB,MAAM,OAAO,CAAC,UAAU,CACtB,MAAM,CAAC,MAAM,CAAC,uBAAA,IAAI,yBAAW,CAAC,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE;YACpD,iDAAiD;YACjD,IAAI,OAAO,QAAQ,CAAC,OAAO,KAAK,UAAU,EAAE,CAAC;gBAC3C,iDAAiD;gBACjD,OAAO,MAAM,QAAQ,CAAC,OAAO,EAAE,CAAC;YAClC,CAAC;YACD,0BAA0B;YAC1B,OAAO,SAAS,CAAC;QACnB,CAAC,CAAC,CACH,CAAC;IACJ,CAAC;CACF;AArID,wBAqIC","sourcesContent":["import type { StateMetadataConstraint } from '@metamask/base-controller';\nimport { Messenger } from '@metamask/messenger';\nimport { hasProperty } from '@metamask/utils';\n\nimport type {\n  DefaultActions,\n  DefaultEvents,\n  DefaultInstances,\n  DefaultState,\n  RootMessenger,\n} from './initialization/defaults';\nimport { initialize } from './initialization/initialization';\nimport { WalletOptions } from './types';\n\nexport class Wallet {\n  // TODO: Expand default types when passing additionalConfigurations.\n  readonly #messenger: RootMessenger<DefaultActions, DefaultEvents>;\n\n  readonly #instances: DefaultInstances;\n\n  readonly #controllerMetadata: Readonly<\n    Record<string, Readonly<StateMetadataConstraint>>\n  >;\n\n  #isDestroyed = false;\n\n  /**\n   * Creates a `Wallet` instance, initializing all instances as specified by the passed options.\n   *\n   * @param options - Options bag.\n   * @param options.messenger - An optional messenger to override the default one.\n   * @param options.state - An optional state blob.\n   * @param options.initializationConfigurations - An optional list of additional initialization configurations\n   * required beyond the ones included by default.\n   * @param options.instanceOptions - An optional object containing options that should be passed\n   * to specific instances for additional customization.\n   */\n  constructor(options: WalletOptions) {\n    this.#messenger =\n      options.messenger ??\n      new Messenger({\n        namespace: 'Root',\n      });\n\n    this.#instances = initialize({\n      ...options,\n      messenger: this.#messenger,\n    });\n\n    this.#controllerMetadata = Object.fromEntries(\n      Object.entries(this.#instances)\n        .filter(([_, instance]) => hasProperty(instance, 'metadata'))\n        .map(([name, instance]) => [\n          name,\n          (instance as { metadata: StateMetadataConstraint }).metadata,\n        ]),\n    );\n  }\n\n  /**\n   * @returns The root messenger of the wallet.\n   */\n  get messenger(): Readonly<RootMessenger<DefaultActions, DefaultEvents>> {\n    return this.#messenger;\n  }\n\n  set messenger(_) {\n    throw new Error('The messenger cannot be directly mutated.');\n  }\n\n  /**\n   * @returns The combined state of the wallet.\n   */\n  get state(): DefaultState {\n    return Object.entries(this.#instances).reduce<Record<string, unknown>>(\n      (totalState, [name, instance]) => {\n        // We do actually want to check the prototype here.\n        // eslint-disable-next-line no-restricted-syntax\n        if ('state' in instance && instance.state) {\n          totalState[name] = instance.state;\n        }\n        return totalState;\n      },\n      {},\n    ) as DefaultState;\n  }\n\n  set state(_) {\n    throw new Error('Wallet state cannot be directly mutated.');\n  }\n\n  /**\n   * @returns The controller metadata; containing per-controller information about what properties to persist etc.\n   */\n  get controllerMetadata(): Readonly<\n    Record<string, Readonly<StateMetadataConstraint>>\n  > {\n    return this.#controllerMetadata;\n  }\n\n  set controllerMetadata(_) {\n    throw new Error('The controller metadata cannot be directly mutated.');\n  }\n\n  getInstance<Name extends keyof DefaultInstances>(\n    name: Name,\n  ): DefaultInstances[Name];\n\n  getInstance(\n    name: string,\n  ): DefaultInstances[keyof DefaultInstances] | undefined;\n\n  /**\n   * Get an instantiated controller or service.\n   *\n   * @param name - The name.\n   * @returns The instance, if it exists.\n   * @deprecated - Please use the messenger instead of direct access.\n   */\n  getInstance(\n    name: string,\n  ): DefaultInstances[keyof DefaultInstances] | undefined {\n    return this.#instances[name as keyof DefaultInstances];\n  }\n\n  /**\n   * Destroy the wallet instance.\n   */\n  async destroy(): Promise<void> {\n    if (this.#isDestroyed) {\n      return;\n    }\n\n    this.#isDestroyed = true;\n\n    await Promise.allSettled(\n      Object.values(this.#instances).map(async (instance) => {\n        // @ts-expect-error Accessing protected property.\n        if (typeof instance.destroy === 'function') {\n          // @ts-expect-error Accessing protected property.\n          return await instance.destroy();\n        }\n        /* istanbul ignore next */\n        return undefined;\n      }),\n    );\n  }\n}\n"]}
+{"version":3,"file":"Wallet.cjs","sourceRoot":"","sources":["../src/Wallet.ts"],"names":[],"mappings":"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","sourcesContent":["import type { StateMetadataConstraint } from '@metamask/base-controller';\nimport { Messenger } from '@metamask/messenger';\nimport { hasProperty } from '@metamask/utils';\n\nimport type {\n  DefaultActions,\n  DefaultEvents,\n  DefaultInstances,\n  DefaultState,\n  RootMessenger,\n} from './initialization/defaults';\nimport { initialize } from './initialization/initialization';\nimport { WalletOptions } from './types';\n\nexport class Wallet {\n  // TODO: Expand default types when passing additionalConfigurations.\n  readonly #messenger: RootMessenger<DefaultActions, DefaultEvents>;\n\n  readonly #instances: DefaultInstances;\n\n  readonly #controllerMetadata: Readonly<\n    Record<string, Readonly<StateMetadataConstraint>>\n  >;\n\n  #isDestroyed = false;\n\n  /**\n   * Creates a `Wallet` instance, initializing all instances as specified by the passed options.\n   *\n   * @param options - Options bag.\n   * @param options.messenger - An optional messenger to override the default one.\n   * @param options.state - An optional state blob.\n   * @param options.initializationConfigurations - An optional list of additional initialization configurations\n   * required beyond the ones included by default.\n   * @param options.instanceOptions - An optional object containing options that should be passed\n   * to specific instances for additional customization.\n   */\n  constructor(options: WalletOptions) {\n    this.#messenger =\n      options.messenger ??\n      new Messenger({\n        namespace: 'Root',\n      });\n\n    this.#instances = initialize({\n      ...options,\n      messenger: this.#messenger,\n    });\n\n    this.#controllerMetadata = Object.fromEntries(\n      Object.entries(this.#instances)\n        .filter(([_, instance]) => hasProperty(instance, 'metadata'))\n        .map(([name, instance]) => [\n          name,\n          (instance as { metadata: StateMetadataConstraint }).metadata,\n        ]),\n    );\n  }\n\n  /**\n   * @returns The root messenger of the wallet.\n   */\n  get messenger(): Readonly<RootMessenger<DefaultActions, DefaultEvents>> {\n    return this.#messenger;\n  }\n\n  set messenger(_) {\n    throw new Error('The messenger cannot be directly mutated.');\n  }\n\n  /**\n   * @returns The combined state of the wallet.\n   */\n  get state(): DefaultState {\n    return Object.entries(this.#instances).reduce<Record<string, unknown>>(\n      (totalState, [name, instance]) => {\n        // We do actually want to check the prototype here.\n        // eslint-disable-next-line no-restricted-syntax\n        if ('state' in instance && instance.state) {\n          totalState[name] = instance.state;\n        }\n        return totalState;\n      },\n      {},\n    ) as DefaultState;\n  }\n\n  set state(_) {\n    throw new Error('Wallet state cannot be directly mutated.');\n  }\n\n  /**\n   * @returns The controller metadata; containing per-controller information about what properties to persist etc.\n   */\n  get controllerMetadata(): Readonly<\n    Record<string, Readonly<StateMetadataConstraint>>\n  > {\n    return this.#controllerMetadata;\n  }\n\n  set controllerMetadata(_) {\n    throw new Error('The controller metadata cannot be directly mutated.');\n  }\n\n  getInstance<Name extends keyof DefaultInstances>(\n    name: Name,\n  ): DefaultInstances[Name];\n\n  getInstance(\n    name: string,\n  ): DefaultInstances[keyof DefaultInstances] | undefined;\n\n  /**\n   * Get an instantiated controller or service.\n   *\n   * @param name - The name.\n   * @returns The instance, if it exists.\n   * @deprecated - Please use the messenger instead of direct access.\n   */\n  getInstance(\n    name: string,\n  ): DefaultInstances[keyof DefaultInstances] | undefined {\n    return this.#instances[name as keyof DefaultInstances];\n  }\n\n  /**\n   * Complete additional initialization of instantiated controllers or services after instantiating `Wallet`.\n   *\n   * @returns The results of all initialization calls.\n   */\n  init(): Promise<PromiseSettledResult<unknown>[]> {\n    return Promise.allSettled(\n      Object.values(this.#instances)\n        .filter(\n          (instance): instance is Extract<typeof instance, { init: unknown }> =>\n            // We do actually want to check the prototype here.\n            // eslint-disable-next-line no-restricted-syntax\n            'init' in instance,\n        )\n        .map(async (instance) => instance.init()),\n    );\n  }\n\n  /**\n   * Destroy the wallet instance.\n   */\n  async destroy(): Promise<void> {\n    if (this.#isDestroyed) {\n      return;\n    }\n\n    this.#isDestroyed = true;\n\n    await Promise.allSettled(\n      Object.values(this.#instances).map(async (instance) => {\n        // @ts-expect-error Accessing protected property.\n        if (typeof instance.destroy === 'function') {\n          // @ts-expect-error Accessing protected property.\n          return await instance.destroy();\n        }\n        /* istanbul ignore next */\n        return undefined;\n      }),\n    );\n  }\n}\n"]}

package/dist/Wallet.d.cts

@@ -32,6 +32,12 @@ export declare class Wallet {
     set controllerMetadata(_: Readonly<Record<string, Readonly<StateMetadataConstraint>>>);
     getInstance<Name extends keyof DefaultInstances>(name: Name): DefaultInstances[Name];
     getInstance(name: string): DefaultInstances[keyof DefaultInstances] | undefined;
+    /**
+     * Complete additional initialization of instantiated controllers or services after instantiating `Wallet`.
+     *
+     * @returns The results of all initialization calls.
+     */
+    init(): Promise<PromiseSettledResult<unknown>[]>;
     /**
      * Destroy the wallet instance.
      */

package/dist/Wallet.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"Wallet.d.cts","sourceRoot":"","sources":["../src/Wallet.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,kCAAkC;AAIzE,OAAO,KAAK,EACV,cAAc,EACd,aAAa,EACb,gBAAgB,EAChB,YAAY,EACZ,aAAa,EACd,sCAAkC;AAEnC,OAAO,EAAE,aAAa,EAAE,oBAAgB;AAExC,qBAAa,MAAM;;IAYjB;;;;;;;;;;OAUG;gBACS,OAAO,EAAE,aAAa;IAsBlC;;OAEG;IACH,IAAI,SAAS,IAAI,QAAQ,CAAC,aAAa,CAAC,cAAc,EAAE,aAAa,CAAC,CAAC,CAEtE;IAED,IAAI,SAAS,CAAC,CAAC,EAJE,QAAQ,CAAC,aAAa,CAAC,cAAc,EAAE,aAAa,CAAC,CAIvD,EAEd;IAED;;OAEG;IACH,IAAI,KAAK,IAAI,YAAY,CAYxB;IAED,IAAI,KAAK,CAAC,CAAC,EAdE,YAcF,EAEV;IAED;;OAEG;IACH,IAAI,kBAAkB,IAAI,QAAQ,CAChC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,uBAAuB,CAAC,CAAC,CAClD,CAEA;IAED,IAAI,kBAAkB,CAAC,CAAC,EANE,QAAQ,CAChC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,uBAAuB,CAAC,CAAC,CAK3B,EAEvB;IAED,WAAW,CAAC,IAAI,SAAS,MAAM,gBAAgB,EAC7C,IAAI,EAAE,IAAI,GACT,gBAAgB,CAAC,IAAI,CAAC;IAEzB,WAAW,CACT,IAAI,EAAE,MAAM,GACX,gBAAgB,CAAC,MAAM,gBAAgB,CAAC,GAAG,SAAS;IAevD;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAmB/B"}
+{"version":3,"file":"Wallet.d.cts","sourceRoot":"","sources":["../src/Wallet.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,kCAAkC;AAIzE,OAAO,KAAK,EACV,cAAc,EACd,aAAa,EACb,gBAAgB,EAChB,YAAY,EACZ,aAAa,EACd,sCAAkC;AAEnC,OAAO,EAAE,aAAa,EAAE,oBAAgB;AAExC,qBAAa,MAAM;;IAYjB;;;;;;;;;;OAUG;gBACS,OAAO,EAAE,aAAa;IAsBlC;;OAEG;IACH,IAAI,SAAS,IAAI,QAAQ,CAAC,aAAa,CAAC,cAAc,EAAE,aAAa,CAAC,CAAC,CAEtE;IAED,IAAI,SAAS,CAAC,CAAC,EAJE,QAAQ,CAAC,aAAa,CAAC,cAAc,EAAE,aAAa,CAAC,CAIvD,EAEd;IAED;;OAEG;IACH,IAAI,KAAK,IAAI,YAAY,CAYxB;IAED,IAAI,KAAK,CAAC,CAAC,EAdE,YAcF,EAEV;IAED;;OAEG;IACH,IAAI,kBAAkB,IAAI,QAAQ,CAChC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,uBAAuB,CAAC,CAAC,CAClD,CAEA;IAED,IAAI,kBAAkB,CAAC,CAAC,EANE,QAAQ,CAChC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,uBAAuB,CAAC,CAAC,CAK3B,EAEvB;IAED,WAAW,CAAC,IAAI,SAAS,MAAM,gBAAgB,EAC7C,IAAI,EAAE,IAAI,GACT,gBAAgB,CAAC,IAAI,CAAC;IAEzB,WAAW,CACT,IAAI,EAAE,MAAM,GACX,gBAAgB,CAAC,MAAM,gBAAgB,CAAC,GAAG,SAAS;IAevD;;;;OAIG;IACH,IAAI,IAAI,OAAO,CAAC,oBAAoB,CAAC,OAAO,CAAC,EAAE,CAAC;IAahD;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAmB/B"}

package/dist/Wallet.d.mts

@@ -32,6 +32,12 @@ export declare class Wallet {
     set controllerMetadata(_: Readonly<Record<string, Readonly<StateMetadataConstraint>>>);
     getInstance<Name extends keyof DefaultInstances>(name: Name): DefaultInstances[Name];
     getInstance(name: string): DefaultInstances[keyof DefaultInstances] | undefined;
+    /**
+     * Complete additional initialization of instantiated controllers or services after instantiating `Wallet`.
+     *
+     * @returns The results of all initialization calls.
+     */
+    init(): Promise<PromiseSettledResult<unknown>[]>;
     /**
      * Destroy the wallet instance.
      */

package/dist/Wallet.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"Wallet.d.mts","sourceRoot":"","sources":["../src/Wallet.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,kCAAkC;AAIzE,OAAO,KAAK,EACV,cAAc,EACd,aAAa,EACb,gBAAgB,EAChB,YAAY,EACZ,aAAa,EACd,sCAAkC;AAEnC,OAAO,EAAE,aAAa,EAAE,oBAAgB;AAExC,qBAAa,MAAM;;IAYjB;;;;;;;;;;OAUG;gBACS,OAAO,EAAE,aAAa;IAsBlC;;OAEG;IACH,IAAI,SAAS,IAAI,QAAQ,CAAC,aAAa,CAAC,cAAc,EAAE,aAAa,CAAC,CAAC,CAEtE;IAED,IAAI,SAAS,CAAC,CAAC,EAJE,QAAQ,CAAC,aAAa,CAAC,cAAc,EAAE,aAAa,CAAC,CAIvD,EAEd;IAED;;OAEG;IACH,IAAI,KAAK,IAAI,YAAY,CAYxB;IAED,IAAI,KAAK,CAAC,CAAC,EAdE,YAcF,EAEV;IAED;;OAEG;IACH,IAAI,kBAAkB,IAAI,QAAQ,CAChC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,uBAAuB,CAAC,CAAC,CAClD,CAEA;IAED,IAAI,kBAAkB,CAAC,CAAC,EANE,QAAQ,CAChC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,uBAAuB,CAAC,CAAC,CAK3B,EAEvB;IAED,WAAW,CAAC,IAAI,SAAS,MAAM,gBAAgB,EAC7C,IAAI,EAAE,IAAI,GACT,gBAAgB,CAAC,IAAI,CAAC;IAEzB,WAAW,CACT,IAAI,EAAE,MAAM,GACX,gBAAgB,CAAC,MAAM,gBAAgB,CAAC,GAAG,SAAS;IAevD;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAmB/B"}
+{"version":3,"file":"Wallet.d.mts","sourceRoot":"","sources":["../src/Wallet.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,kCAAkC;AAIzE,OAAO,KAAK,EACV,cAAc,EACd,aAAa,EACb,gBAAgB,EAChB,YAAY,EACZ,aAAa,EACd,sCAAkC;AAEnC,OAAO,EAAE,aAAa,EAAE,oBAAgB;AAExC,qBAAa,MAAM;;IAYjB;;;;;;;;;;OAUG;gBACS,OAAO,EAAE,aAAa;IAsBlC;;OAEG;IACH,IAAI,SAAS,IAAI,QAAQ,CAAC,aAAa,CAAC,cAAc,EAAE,aAAa,CAAC,CAAC,CAEtE;IAED,IAAI,SAAS,CAAC,CAAC,EAJE,QAAQ,CAAC,aAAa,CAAC,cAAc,EAAE,aAAa,CAAC,CAIvD,EAEd;IAED;;OAEG;IACH,IAAI,KAAK,IAAI,YAAY,CAYxB;IAED,IAAI,KAAK,CAAC,CAAC,EAdE,YAcF,EAEV;IAED;;OAEG;IACH,IAAI,kBAAkB,IAAI,QAAQ,CAChC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,uBAAuB,CAAC,CAAC,CAClD,CAEA;IAED,IAAI,kBAAkB,CAAC,CAAC,EANE,QAAQ,CAChC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,uBAAuB,CAAC,CAAC,CAK3B,EAEvB;IAED,WAAW,CAAC,IAAI,SAAS,MAAM,gBAAgB,EAC7C,IAAI,EAAE,IAAI,GACT,gBAAgB,CAAC,IAAI,CAAC;IAEzB,WAAW,CACT,IAAI,EAAE,MAAM,GACX,gBAAgB,CAAC,MAAM,gBAAgB,CAAC,GAAG,SAAS;IAevD;;;;OAIG;IACH,IAAI,IAAI,OAAO,CAAC,oBAAoB,CAAC,OAAO,CAAC,EAAE,CAAC;IAahD;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAmB/B"}

package/dist/Wallet.mjs

@@ -90,6 +90,19 @@ export class Wallet {
     getInstance(name) {
         return __classPrivateFieldGet(this, _Wallet_instances, "f")[name];
     }
+    /**
+     * Complete additional initialization of instantiated controllers or services after instantiating `Wallet`.
+     *
+     * @returns The results of all initialization calls.
+     */
+    init() {
+        return Promise.allSettled(Object.values(__classPrivateFieldGet(this, _Wallet_instances, "f"))
+            .filter((instance) => 
+        // We do actually want to check the prototype here.
+        // eslint-disable-next-line no-restricted-syntax
+        'init' in instance)
+            .map(async (instance) => instance.init()));
+    }
     /**
      * Destroy the wallet instance.
      */

package/dist/Wallet.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"Wallet.mjs","sourceRoot":"","sources":["../src/Wallet.ts"],"names":[],"mappings":"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","sourcesContent":["import type { StateMetadataConstraint } from '@metamask/base-controller';\nimport { Messenger } from '@metamask/messenger';\nimport { hasProperty } from '@metamask/utils';\n\nimport type {\n  DefaultActions,\n  DefaultEvents,\n  DefaultInstances,\n  DefaultState,\n  RootMessenger,\n} from './initialization/defaults';\nimport { initialize } from './initialization/initialization';\nimport { WalletOptions } from './types';\n\nexport class Wallet {\n  // TODO: Expand default types when passing additionalConfigurations.\n  readonly #messenger: RootMessenger<DefaultActions, DefaultEvents>;\n\n  readonly #instances: DefaultInstances;\n\n  readonly #controllerMetadata: Readonly<\n    Record<string, Readonly<StateMetadataConstraint>>\n  >;\n\n  #isDestroyed = false;\n\n  /**\n   * Creates a `Wallet` instance, initializing all instances as specified by the passed options.\n   *\n   * @param options - Options bag.\n   * @param options.messenger - An optional messenger to override the default one.\n   * @param options.state - An optional state blob.\n   * @param options.initializationConfigurations - An optional list of additional initialization configurations\n   * required beyond the ones included by default.\n   * @param options.instanceOptions - An optional object containing options that should be passed\n   * to specific instances for additional customization.\n   */\n  constructor(options: WalletOptions) {\n    this.#messenger =\n      options.messenger ??\n      new Messenger({\n        namespace: 'Root',\n      });\n\n    this.#instances = initialize({\n      ...options,\n      messenger: this.#messenger,\n    });\n\n    this.#controllerMetadata = Object.fromEntries(\n      Object.entries(this.#instances)\n        .filter(([_, instance]) => hasProperty(instance, 'metadata'))\n        .map(([name, instance]) => [\n          name,\n          (instance as { metadata: StateMetadataConstraint }).metadata,\n        ]),\n    );\n  }\n\n  /**\n   * @returns The root messenger of the wallet.\n   */\n  get messenger(): Readonly<RootMessenger<DefaultActions, DefaultEvents>> {\n    return this.#messenger;\n  }\n\n  set messenger(_) {\n    throw new Error('The messenger cannot be directly mutated.');\n  }\n\n  /**\n   * @returns The combined state of the wallet.\n   */\n  get state(): DefaultState {\n    return Object.entries(this.#instances).reduce<Record<string, unknown>>(\n      (totalState, [name, instance]) => {\n        // We do actually want to check the prototype here.\n        // eslint-disable-next-line no-restricted-syntax\n        if ('state' in instance && instance.state) {\n          totalState[name] = instance.state;\n        }\n        return totalState;\n      },\n      {},\n    ) as DefaultState;\n  }\n\n  set state(_) {\n    throw new Error('Wallet state cannot be directly mutated.');\n  }\n\n  /**\n   * @returns The controller metadata; containing per-controller information about what properties to persist etc.\n   */\n  get controllerMetadata(): Readonly<\n    Record<string, Readonly<StateMetadataConstraint>>\n  > {\n    return this.#controllerMetadata;\n  }\n\n  set controllerMetadata(_) {\n    throw new Error('The controller metadata cannot be directly mutated.');\n  }\n\n  getInstance<Name extends keyof DefaultInstances>(\n    name: Name,\n  ): DefaultInstances[Name];\n\n  getInstance(\n    name: string,\n  ): DefaultInstances[keyof DefaultInstances] | undefined;\n\n  /**\n   * Get an instantiated controller or service.\n   *\n   * @param name - The name.\n   * @returns The instance, if it exists.\n   * @deprecated - Please use the messenger instead of direct access.\n   */\n  getInstance(\n    name: string,\n  ): DefaultInstances[keyof DefaultInstances] | undefined {\n    return this.#instances[name as keyof DefaultInstances];\n  }\n\n  /**\n   * Destroy the wallet instance.\n   */\n  async destroy(): Promise<void> {\n    if (this.#isDestroyed) {\n      return;\n    }\n\n    this.#isDestroyed = true;\n\n    await Promise.allSettled(\n      Object.values(this.#instances).map(async (instance) => {\n        // @ts-expect-error Accessing protected property.\n        if (typeof instance.destroy === 'function') {\n          // @ts-expect-error Accessing protected property.\n          return await instance.destroy();\n        }\n        /* istanbul ignore next */\n        return undefined;\n      }),\n    );\n  }\n}\n"]}
+{"version":3,"file":"Wallet.mjs","sourceRoot":"","sources":["../src/Wallet.ts"],"names":[],"mappings":"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","sourcesContent":["import type { StateMetadataConstraint } from '@metamask/base-controller';\nimport { Messenger } from '@metamask/messenger';\nimport { hasProperty } from '@metamask/utils';\n\nimport type {\n  DefaultActions,\n  DefaultEvents,\n  DefaultInstances,\n  DefaultState,\n  RootMessenger,\n} from './initialization/defaults';\nimport { initialize } from './initialization/initialization';\nimport { WalletOptions } from './types';\n\nexport class Wallet {\n  // TODO: Expand default types when passing additionalConfigurations.\n  readonly #messenger: RootMessenger<DefaultActions, DefaultEvents>;\n\n  readonly #instances: DefaultInstances;\n\n  readonly #controllerMetadata: Readonly<\n    Record<string, Readonly<StateMetadataConstraint>>\n  >;\n\n  #isDestroyed = false;\n\n  /**\n   * Creates a `Wallet` instance, initializing all instances as specified by the passed options.\n   *\n   * @param options - Options bag.\n   * @param options.messenger - An optional messenger to override the default one.\n   * @param options.state - An optional state blob.\n   * @param options.initializationConfigurations - An optional list of additional initialization configurations\n   * required beyond the ones included by default.\n   * @param options.instanceOptions - An optional object containing options that should be passed\n   * to specific instances for additional customization.\n   */\n  constructor(options: WalletOptions) {\n    this.#messenger =\n      options.messenger ??\n      new Messenger({\n        namespace: 'Root',\n      });\n\n    this.#instances = initialize({\n      ...options,\n      messenger: this.#messenger,\n    });\n\n    this.#controllerMetadata = Object.fromEntries(\n      Object.entries(this.#instances)\n        .filter(([_, instance]) => hasProperty(instance, 'metadata'))\n        .map(([name, instance]) => [\n          name,\n          (instance as { metadata: StateMetadataConstraint }).metadata,\n        ]),\n    );\n  }\n\n  /**\n   * @returns The root messenger of the wallet.\n   */\n  get messenger(): Readonly<RootMessenger<DefaultActions, DefaultEvents>> {\n    return this.#messenger;\n  }\n\n  set messenger(_) {\n    throw new Error('The messenger cannot be directly mutated.');\n  }\n\n  /**\n   * @returns The combined state of the wallet.\n   */\n  get state(): DefaultState {\n    return Object.entries(this.#instances).reduce<Record<string, unknown>>(\n      (totalState, [name, instance]) => {\n        // We do actually want to check the prototype here.\n        // eslint-disable-next-line no-restricted-syntax\n        if ('state' in instance && instance.state) {\n          totalState[name] = instance.state;\n        }\n        return totalState;\n      },\n      {},\n    ) as DefaultState;\n  }\n\n  set state(_) {\n    throw new Error('Wallet state cannot be directly mutated.');\n  }\n\n  /**\n   * @returns The controller metadata; containing per-controller information about what properties to persist etc.\n   */\n  get controllerMetadata(): Readonly<\n    Record<string, Readonly<StateMetadataConstraint>>\n  > {\n    return this.#controllerMetadata;\n  }\n\n  set controllerMetadata(_) {\n    throw new Error('The controller metadata cannot be directly mutated.');\n  }\n\n  getInstance<Name extends keyof DefaultInstances>(\n    name: Name,\n  ): DefaultInstances[Name];\n\n  getInstance(\n    name: string,\n  ): DefaultInstances[keyof DefaultInstances] | undefined;\n\n  /**\n   * Get an instantiated controller or service.\n   *\n   * @param name - The name.\n   * @returns The instance, if it exists.\n   * @deprecated - Please use the messenger instead of direct access.\n   */\n  getInstance(\n    name: string,\n  ): DefaultInstances[keyof DefaultInstances] | undefined {\n    return this.#instances[name as keyof DefaultInstances];\n  }\n\n  /**\n   * Complete additional initialization of instantiated controllers or services after instantiating `Wallet`.\n   *\n   * @returns The results of all initialization calls.\n   */\n  init(): Promise<PromiseSettledResult<unknown>[]> {\n    return Promise.allSettled(\n      Object.values(this.#instances)\n        .filter(\n          (instance): instance is Extract<typeof instance, { init: unknown }> =>\n            // We do actually want to check the prototype here.\n            // eslint-disable-next-line no-restricted-syntax\n            'init' in instance,\n        )\n        .map(async (instance) => instance.init()),\n    );\n  }\n\n  /**\n   * Destroy the wallet instance.\n   */\n  async destroy(): Promise<void> {\n    if (this.#isDestroyed) {\n      return;\n    }\n\n    this.#isDestroyed = true;\n\n    await Promise.allSettled(\n      Object.values(this.#instances).map(async (instance) => {\n        // @ts-expect-error Accessing protected property.\n        if (typeof instance.destroy === 'function') {\n          // @ts-expect-error Accessing protected property.\n          return await instance.destroy();\n        }\n        /* istanbul ignore next */\n        return undefined;\n      }),\n    );\n  }\n}\n"]}

package/dist/initialization/instances/index.cjs

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.storageService = exports.remoteFeatureFlagController = exports.keyringController = exports.connectivityController = exports.approvalController = exports.accountsController = void 0;
+exports.storageService = exports.remoteFeatureFlagController = exports.networkController = exports.keyringController = exports.connectivityController = exports.approvalController = exports.accountsController = void 0;
 var accounts_controller_1 = require("./accounts-controller/accounts-controller.cjs");
 Object.defineProperty(exports, "accountsController", { enumerable: true, get: function () { return accounts_controller_1.accountsController; } });
 var approval_controller_1 = require("./approval-controller/approval-controller.cjs");
@@ -9,6 +9,8 @@ var connectivity_controller_1 = require("./connectivity-controller/connectivity-
 Object.defineProperty(exports, "connectivityController", { enumerable: true, get: function () { return connectivity_controller_1.connectivityController; } });
 var keyring_controller_1 = require("./keyring-controller/keyring-controller.cjs");
 Object.defineProperty(exports, "keyringController", { enumerable: true, get: function () { return keyring_controller_1.keyringController; } });
+var network_controller_1 = require("./network-controller/network-controller.cjs");
+Object.defineProperty(exports, "networkController", { enumerable: true, get: function () { return network_controller_1.networkController; } });
 var remote_feature_flag_controller_1 = require("./remote-feature-flag-controller/remote-feature-flag-controller.cjs");
 Object.defineProperty(exports, "remoteFeatureFlagController", { enumerable: true, get: function () { return remote_feature_flag_controller_1.remoteFeatureFlagController; } });
 var storage_service_1 = require("./storage-service/storage-service.cjs");

package/dist/initialization/instances/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","sourceRoot":"","sources":["../../../src/initialization/instances/index.ts"],"names":[],"mappings":";;;AAAA,qFAA+E;AAAtE,yHAAA,kBAAkB,OAAA;AAC3B,qFAA+E;AAAtE,yHAAA,kBAAkB,OAAA;AAC3B,iGAA2F;AAAlF,iIAAA,sBAAsB,OAAA;AAC/B,kFAA4E;AAAnE,uHAAA,iBAAiB,OAAA;AAC1B,sHAA8G;AAArG,6IAAA,2BAA2B,OAAA;AACpC,yEAAmE;AAA1D,iHAAA,cAAc,OAAA","sourcesContent":["export { accountsController } from './accounts-controller/accounts-controller';\nexport { approvalController } from './approval-controller/approval-controller';\nexport { connectivityController } from './connectivity-controller/connectivity-controller';\nexport { keyringController } from './keyring-controller/keyring-controller';\nexport { remoteFeatureFlagController } from './remote-feature-flag-controller/remote-feature-flag-controller';\nexport { storageService } from './storage-service/storage-service';\n"]}
+{"version":3,"file":"index.cjs","sourceRoot":"","sources":["../../../src/initialization/instances/index.ts"],"names":[],"mappings":";;;AAAA,qFAA+E;AAAtE,yHAAA,kBAAkB,OAAA;AAC3B,qFAA+E;AAAtE,yHAAA,kBAAkB,OAAA;AAC3B,iGAA2F;AAAlF,iIAAA,sBAAsB,OAAA;AAC/B,kFAA4E;AAAnE,uHAAA,iBAAiB,OAAA;AAC1B,kFAA4E;AAAnE,uHAAA,iBAAiB,OAAA;AAC1B,sHAA8G;AAArG,6IAAA,2BAA2B,OAAA;AACpC,yEAAmE;AAA1D,iHAAA,cAAc,OAAA","sourcesContent":["export { accountsController } from './accounts-controller/accounts-controller';\nexport { approvalController } from './approval-controller/approval-controller';\nexport { connectivityController } from './connectivity-controller/connectivity-controller';\nexport { keyringController } from './keyring-controller/keyring-controller';\nexport { networkController } from './network-controller/network-controller';\nexport { remoteFeatureFlagController } from './remote-feature-flag-controller/remote-feature-flag-controller';\nexport { storageService } from './storage-service/storage-service';\n"]}

package/dist/initialization/instances/index.d.cts

@@ -2,6 +2,7 @@ export { accountsController } from "./accounts-controller/accounts-controller.cj
 export { approvalController } from "./approval-controller/approval-controller.cjs";
 export { connectivityController } from "./connectivity-controller/connectivity-controller.cjs";
 export { keyringController } from "./keyring-controller/keyring-controller.cjs";
+export { networkController } from "./network-controller/network-controller.cjs";
 export { remoteFeatureFlagController } from "./remote-feature-flag-controller/remote-feature-flag-controller.cjs";
 export { storageService } from "./storage-service/storage-service.cjs";
 //# sourceMappingURL=index.d.cts.map

package/dist/initialization/instances/index.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.cts","sourceRoot":"","sources":["../../../src/initialization/instances/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,sDAAkD;AAC/E,OAAO,EAAE,kBAAkB,EAAE,sDAAkD;AAC/E,OAAO,EAAE,sBAAsB,EAAE,8DAA0D;AAC3F,OAAO,EAAE,iBAAiB,EAAE,oDAAgD;AAC5E,OAAO,EAAE,2BAA2B,EAAE,4EAAwE;AAC9G,OAAO,EAAE,cAAc,EAAE,8CAA0C"}
+{"version":3,"file":"index.d.cts","sourceRoot":"","sources":["../../../src/initialization/instances/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,sDAAkD;AAC/E,OAAO,EAAE,kBAAkB,EAAE,sDAAkD;AAC/E,OAAO,EAAE,sBAAsB,EAAE,8DAA0D;AAC3F,OAAO,EAAE,iBAAiB,EAAE,oDAAgD;AAC5E,OAAO,EAAE,iBAAiB,EAAE,oDAAgD;AAC5E,OAAO,EAAE,2BAA2B,EAAE,4EAAwE;AAC9G,OAAO,EAAE,cAAc,EAAE,8CAA0C"}

package/dist/initialization/instances/index.d.mts

@@ -2,6 +2,7 @@ export { accountsController } from "./accounts-controller/accounts-controller.mj
 export { approvalController } from "./approval-controller/approval-controller.mjs";
 export { connectivityController } from "./connectivity-controller/connectivity-controller.mjs";
 export { keyringController } from "./keyring-controller/keyring-controller.mjs";
+export { networkController } from "./network-controller/network-controller.mjs";
 export { remoteFeatureFlagController } from "./remote-feature-flag-controller/remote-feature-flag-controller.mjs";
 export { storageService } from "./storage-service/storage-service.mjs";
 //# sourceMappingURL=index.d.mts.map

package/dist/initialization/instances/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../../../src/initialization/instances/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,sDAAkD;AAC/E,OAAO,EAAE,kBAAkB,EAAE,sDAAkD;AAC/E,OAAO,EAAE,sBAAsB,EAAE,8DAA0D;AAC3F,OAAO,EAAE,iBAAiB,EAAE,oDAAgD;AAC5E,OAAO,EAAE,2BAA2B,EAAE,4EAAwE;AAC9G,OAAO,EAAE,cAAc,EAAE,8CAA0C"}
+{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../../../src/initialization/instances/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,sDAAkD;AAC/E,OAAO,EAAE,kBAAkB,EAAE,sDAAkD;AAC/E,OAAO,EAAE,sBAAsB,EAAE,8DAA0D;AAC3F,OAAO,EAAE,iBAAiB,EAAE,oDAAgD;AAC5E,OAAO,EAAE,iBAAiB,EAAE,oDAAgD;AAC5E,OAAO,EAAE,2BAA2B,EAAE,4EAAwE;AAC9G,OAAO,EAAE,cAAc,EAAE,8CAA0C"}

package/dist/initialization/instances/index.mjs

@@ -2,6 +2,7 @@ export { accountsController } from "./accounts-controller/accounts-controller.mj
 export { approvalController } from "./approval-controller/approval-controller.mjs";
 export { connectivityController } from "./connectivity-controller/connectivity-controller.mjs";
 export { keyringController } from "./keyring-controller/keyring-controller.mjs";
+export { networkController } from "./network-controller/network-controller.mjs";
 export { remoteFeatureFlagController } from "./remote-feature-flag-controller/remote-feature-flag-controller.mjs";
 export { storageService } from "./storage-service/storage-service.mjs";
 //# sourceMappingURL=index.mjs.map

package/dist/initialization/instances/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../../../src/initialization/instances/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,sDAAkD;AAC/E,OAAO,EAAE,kBAAkB,EAAE,sDAAkD;AAC/E,OAAO,EAAE,sBAAsB,EAAE,8DAA0D;AAC3F,OAAO,EAAE,iBAAiB,EAAE,oDAAgD;AAC5E,OAAO,EAAE,2BAA2B,EAAE,4EAAwE;AAC9G,OAAO,EAAE,cAAc,EAAE,8CAA0C","sourcesContent":["export { accountsController } from './accounts-controller/accounts-controller';\nexport { approvalController } from './approval-controller/approval-controller';\nexport { connectivityController } from './connectivity-controller/connectivity-controller';\nexport { keyringController } from './keyring-controller/keyring-controller';\nexport { remoteFeatureFlagController } from './remote-feature-flag-controller/remote-feature-flag-controller';\nexport { storageService } from './storage-service/storage-service';\n"]}
+{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../../../src/initialization/instances/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,sDAAkD;AAC/E,OAAO,EAAE,kBAAkB,EAAE,sDAAkD;AAC/E,OAAO,EAAE,sBAAsB,EAAE,8DAA0D;AAC3F,OAAO,EAAE,iBAAiB,EAAE,oDAAgD;AAC5E,OAAO,EAAE,iBAAiB,EAAE,oDAAgD;AAC5E,OAAO,EAAE,2BAA2B,EAAE,4EAAwE;AAC9G,OAAO,EAAE,cAAc,EAAE,8CAA0C","sourcesContent":["export { accountsController } from './accounts-controller/accounts-controller';\nexport { approvalController } from './approval-controller/approval-controller';\nexport { connectivityController } from './connectivity-controller/connectivity-controller';\nexport { keyringController } from './keyring-controller/keyring-controller';\nexport { networkController } from './network-controller/network-controller';\nexport { remoteFeatureFlagController } from './remote-feature-flag-controller/remote-feature-flag-controller';\nexport { storageService } from './storage-service/storage-service';\n"]}

package/dist/initialization/instances/network-controller/network-controller.cjs

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.networkController = void 0;
+const messenger_1 = require("@metamask/messenger");
+const network_controller_1 = require("@metamask/network-controller");
+exports.networkController = {
+    name: 'NetworkController',
+    init: ({ state, messenger, options }) => new network_controller_1.NetworkController({
+        state,
+        messenger,
+        infuraProjectId: options.infuraProjectId,
+        failoverUrls: options.failoverUrls,
+    }),
+    getMessenger: (parent) => {
+        const networkControllerMessenger = new messenger_1.Messenger({
+            namespace: 'NetworkController',
+            parent,
+        });
+        parent.delegate({
+            messenger: networkControllerMessenger,
+            actions: [
+                'ConnectivityController:getState',
+                'RemoteFeatureFlagController:getState',
+            ],
+            events: [
+                // eslint-disable-next-line no-restricted-syntax
+                'RemoteFeatureFlagController:stateChange',
+            ],
+        });
+        return networkControllerMessenger;
+    },
+};
+//# sourceMappingURL=network-controller.cjs.map

package/dist/initialization/instances/network-controller/network-controller.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"network-controller.cjs","sourceRoot":"","sources":["../../../../src/initialization/instances/network-controller/network-controller.ts"],"names":[],"mappings":";;;AAAA,mDAAgD;AAChD,qEAGsC;AAIzB,QAAA,iBAAiB,GAG1B;IACF,IAAI,EAAE,mBAAmB;IACzB,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,EAAE,EAAE,CACtC,IAAI,sCAAiB,CAAC;QACpB,KAAK;QACL,SAAS;QACT,eAAe,EAAE,OAAO,CAAC,eAAe;QACxC,YAAY,EAAE,OAAO,CAAC,YAAY;KACnC,CAAC;IACJ,YAAY,EAAE,CAAC,MAAM,EAAE,EAAE;QACvB,MAAM,0BAA0B,GAC9B,IAAI,qBAAS,CAAC;YACZ,SAAS,EAAE,mBAAmB;YAC9B,MAAM;SACP,CAAC,CAAC;QAEL,MAAM,CAAC,QAAQ,CAAC;YACd,SAAS,EAAE,0BAA0B;YACrC,OAAO,EAAE;gBACP,iCAAiC;gBACjC,sCAAsC;aACvC;YAED,MAAM,EAAE;gBACN,gDAAgD;gBAChD,yCAAyC;aAC1C;SACF,CAAC,CAAC;QAEH,OAAO,0BAA0B,CAAC;IACpC,CAAC;CACF,CAAC","sourcesContent":["import { Messenger } from '@metamask/messenger';\nimport {\n  NetworkController,\n  NetworkControllerMessenger,\n} from '@metamask/network-controller';\n\nimport { InitializationConfiguration } from '../../types';\n\nexport const networkController: InitializationConfiguration<\n  NetworkController,\n  NetworkControllerMessenger\n> = {\n  name: 'NetworkController',\n  init: ({ state, messenger, options }) =>\n    new NetworkController({\n      state,\n      messenger,\n      infuraProjectId: options.infuraProjectId,\n      failoverUrls: options.failoverUrls,\n    }),\n  getMessenger: (parent) => {\n    const networkControllerMessenger: NetworkControllerMessenger =\n      new Messenger({\n        namespace: 'NetworkController',\n        parent,\n      });\n\n    parent.delegate({\n      messenger: networkControllerMessenger,\n      actions: [\n        'ConnectivityController:getState',\n        'RemoteFeatureFlagController:getState',\n      ],\n\n      events: [\n        // eslint-disable-next-line no-restricted-syntax\n        'RemoteFeatureFlagController:stateChange',\n      ],\n    });\n\n    return networkControllerMessenger;\n  },\n};\n"]}

package/dist/initialization/instances/network-controller/network-controller.d.cts

@@ -0,0 +1,4 @@
+import { NetworkController, NetworkControllerMessenger } from "@metamask/network-controller";
+import { InitializationConfiguration } from "../../types.cjs";
+export declare const networkController: InitializationConfiguration<NetworkController, NetworkControllerMessenger>;
+//# sourceMappingURL=network-controller.d.cts.map

package/dist/initialization/instances/network-controller/network-controller.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"network-controller.d.cts","sourceRoot":"","sources":["../../../../src/initialization/instances/network-controller/network-controller.ts"],"names":[],"mappings":"AACA,OAAO,EACL,iBAAiB,EACjB,0BAA0B,EAC3B,qCAAqC;AAEtC,OAAO,EAAE,2BAA2B,EAAE,wBAAoB;AAE1D,eAAO,MAAM,iBAAiB,EAAE,2BAA2B,CACzD,iBAAiB,EACjB,0BAA0B,CAgC3B,CAAC"}

package/dist/initialization/instances/network-controller/network-controller.d.mts

@@ -0,0 +1,4 @@
+import { NetworkController, NetworkControllerMessenger } from "@metamask/network-controller";
+import { InitializationConfiguration } from "../../types.mjs";
+export declare const networkController: InitializationConfiguration<NetworkController, NetworkControllerMessenger>;
+//# sourceMappingURL=network-controller.d.mts.map

package/dist/initialization/instances/network-controller/network-controller.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"network-controller.d.mts","sourceRoot":"","sources":["../../../../src/initialization/instances/network-controller/network-controller.ts"],"names":[],"mappings":"AACA,OAAO,EACL,iBAAiB,EACjB,0BAA0B,EAC3B,qCAAqC;AAEtC,OAAO,EAAE,2BAA2B,EAAE,wBAAoB;AAE1D,eAAO,MAAM,iBAAiB,EAAE,2BAA2B,CACzD,iBAAiB,EACjB,0BAA0B,CAgC3B,CAAC"}

package/dist/initialization/instances/network-controller/network-controller.mjs

@@ -0,0 +1,30 @@
+import { Messenger } from "@metamask/messenger";
+import { NetworkController } from "@metamask/network-controller";
+export const networkController = {
+    name: 'NetworkController',
+    init: ({ state, messenger, options }) => new NetworkController({
+        state,
+        messenger,
+        infuraProjectId: options.infuraProjectId,
+        failoverUrls: options.failoverUrls,
+    }),
+    getMessenger: (parent) => {
+        const networkControllerMessenger = new Messenger({
+            namespace: 'NetworkController',
+            parent,
+        });
+        parent.delegate({
+            messenger: networkControllerMessenger,
+            actions: [
+                'ConnectivityController:getState',
+                'RemoteFeatureFlagController:getState',
+            ],
+            events: [
+                // eslint-disable-next-line no-restricted-syntax
+                'RemoteFeatureFlagController:stateChange',
+            ],
+        });
+        return networkControllerMessenger;
+    },
+};
+//# sourceMappingURL=network-controller.mjs.map

package/dist/initialization/instances/network-controller/network-controller.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"network-controller.mjs","sourceRoot":"","sources":["../../../../src/initialization/instances/network-controller/network-controller.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,4BAA4B;AAChD,OAAO,EACL,iBAAiB,EAElB,qCAAqC;AAItC,MAAM,CAAC,MAAM,iBAAiB,GAG1B;IACF,IAAI,EAAE,mBAAmB;IACzB,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,EAAE,EAAE,CACtC,IAAI,iBAAiB,CAAC;QACpB,KAAK;QACL,SAAS;QACT,eAAe,EAAE,OAAO,CAAC,eAAe;QACxC,YAAY,EAAE,OAAO,CAAC,YAAY;KACnC,CAAC;IACJ,YAAY,EAAE,CAAC,MAAM,EAAE,EAAE;QACvB,MAAM,0BAA0B,GAC9B,IAAI,SAAS,CAAC;YACZ,SAAS,EAAE,mBAAmB;YAC9B,MAAM;SACP,CAAC,CAAC;QAEL,MAAM,CAAC,QAAQ,CAAC;YACd,SAAS,EAAE,0BAA0B;YACrC,OAAO,EAAE;gBACP,iCAAiC;gBACjC,sCAAsC;aACvC;YAED,MAAM,EAAE;gBACN,gDAAgD;gBAChD,yCAAyC;aAC1C;SACF,CAAC,CAAC;QAEH,OAAO,0BAA0B,CAAC;IACpC,CAAC;CACF,CAAC","sourcesContent":["import { Messenger } from '@metamask/messenger';\nimport {\n  NetworkController,\n  NetworkControllerMessenger,\n} from '@metamask/network-controller';\n\nimport { InitializationConfiguration } from '../../types';\n\nexport const networkController: InitializationConfiguration<\n  NetworkController,\n  NetworkControllerMessenger\n> = {\n  name: 'NetworkController',\n  init: ({ state, messenger, options }) =>\n    new NetworkController({\n      state,\n      messenger,\n      infuraProjectId: options.infuraProjectId,\n      failoverUrls: options.failoverUrls,\n    }),\n  getMessenger: (parent) => {\n    const networkControllerMessenger: NetworkControllerMessenger =\n      new Messenger({\n        namespace: 'NetworkController',\n        parent,\n      });\n\n    parent.delegate({\n      messenger: networkControllerMessenger,\n      actions: [\n        'ConnectivityController:getState',\n        'RemoteFeatureFlagController:getState',\n      ],\n\n      events: [\n        // eslint-disable-next-line no-restricted-syntax\n        'RemoteFeatureFlagController:stateChange',\n      ],\n    });\n\n    return networkControllerMessenger;\n  },\n};\n"]}

package/dist/initialization/instances/network-controller/types.cjs

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.cjs.map

package/dist/initialization/instances/network-controller/types.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.cjs","sourceRoot":"","sources":["../../../../src/initialization/instances/network-controller/types.ts"],"names":[],"mappings":"","sourcesContent":["import { Hex } from '@metamask/utils';\n\n/**\n * Per-instance options for the wallet's `NetworkController`.\n */\nexport type NetworkControllerInstanceOptions = {\n  /**\n   * The API key for Infura, used to make requests to Infura.\n   */\n  infuraProjectId: string;\n  /**\n   * An optional map of available failover URLs for each chain ID.\n   */\n  failoverUrls?: Record<Hex, string[]>;\n};\n"]}

package/dist/initialization/instances/network-controller/types.d.cts

@@ -0,0 +1,15 @@
+import { Hex } from "@metamask/utils";
+/**
+ * Per-instance options for the wallet's `NetworkController`.
+ */
+export type NetworkControllerInstanceOptions = {
+    /**
+     * The API key for Infura, used to make requests to Infura.
+     */
+    infuraProjectId: string;
+    /**
+     * An optional map of available failover URLs for each chain ID.
+     */
+    failoverUrls?: Record<Hex, string[]>;
+};
+//# sourceMappingURL=types.d.cts.map

package/dist/initialization/instances/network-controller/types.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.cts","sourceRoot":"","sources":["../../../../src/initialization/instances/network-controller/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,wBAAwB;AAEtC;;GAEG;AACH,MAAM,MAAM,gCAAgC,GAAG;IAC7C;;OAEG;IACH,eAAe,EAAE,MAAM,CAAC;IACxB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,CAAC,CAAC;CACtC,CAAC"}

package/dist/initialization/instances/network-controller/types.d.mts

@@ -0,0 +1,15 @@
+import { Hex } from "@metamask/utils";
+/**
+ * Per-instance options for the wallet's `NetworkController`.
+ */
+export type NetworkControllerInstanceOptions = {
+    /**
+     * The API key for Infura, used to make requests to Infura.
+     */
+    infuraProjectId: string;
+    /**
+     * An optional map of available failover URLs for each chain ID.
+     */
+    failoverUrls?: Record<Hex, string[]>;
+};
+//# sourceMappingURL=types.d.mts.map

package/dist/initialization/instances/network-controller/types.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.mts","sourceRoot":"","sources":["../../../../src/initialization/instances/network-controller/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,wBAAwB;AAEtC;;GAEG;AACH,MAAM,MAAM,gCAAgC,GAAG;IAC7C;;OAEG;IACH,eAAe,EAAE,MAAM,CAAC;IACxB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,CAAC,CAAC;CACtC,CAAC"}

package/dist/initialization/instances/network-controller/types.mjs

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.mjs.map

package/dist/initialization/instances/network-controller/types.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.mjs","sourceRoot":"","sources":["../../../../src/initialization/instances/network-controller/types.ts"],"names":[],"mappings":"","sourcesContent":["import { Hex } from '@metamask/utils';\n\n/**\n * Per-instance options for the wallet's `NetworkController`.\n */\nexport type NetworkControllerInstanceOptions = {\n  /**\n   * The API key for Infura, used to make requests to Infura.\n   */\n  infuraProjectId: string;\n  /**\n   * An optional map of available failover URLs for each chain ID.\n   */\n  failoverUrls?: Record<Hex, string[]>;\n};\n"]}

package/dist/types.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"types.cjs","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"","sourcesContent":["import type { Json } from '@metamask/utils';\n\nimport type {\n  DefaultActions,\n  DefaultEvents,\n  RootMessenger,\n} from './initialization/defaults';\nimport type { ApprovalControllerInstanceOptions } from './initialization/instances/approval-controller/types';\nimport type { ConnectivityControllerInstanceOptions } from './initialization/instances/connectivity-controller/types';\nimport type { KeyringControllerInstanceOptions } from './initialization/instances/keyring-controller/types';\nimport type { RemoteFeatureFlagControllerInstanceOptions } from './initialization/instances/remote-feature-flag-controller/types';\nimport type { StorageServiceInstanceOptions } from './initialization/instances/storage-service/types';\nimport { InitializationConfiguration } from './initialization/types';\n\nexport type WalletOptions = {\n  messenger?: RootMessenger<DefaultActions, DefaultEvents>;\n  state?: Record<string, Record<string, Json> | undefined>;\n  initializationConfigurations?: InitializationConfiguration<\n    unknown,\n    unknown\n  >[];\n  instanceOptions: InstanceSpecificOptions;\n};\n\nexport type InstanceSpecificOptions = {\n  approvalController?: ApprovalControllerInstanceOptions;\n  connectivityController: ConnectivityControllerInstanceOptions;\n  keyringController?: KeyringControllerInstanceOptions;\n  remoteFeatureFlagController: RemoteFeatureFlagControllerInstanceOptions;\n  storageService: StorageServiceInstanceOptions;\n};\n"]}
+{"version":3,"file":"types.cjs","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"","sourcesContent":["import type { Json } from '@metamask/utils';\n\nimport type {\n  DefaultActions,\n  DefaultEvents,\n  RootMessenger,\n} from './initialization/defaults';\nimport type { ApprovalControllerInstanceOptions } from './initialization/instances/approval-controller/types';\nimport type { ConnectivityControllerInstanceOptions } from './initialization/instances/connectivity-controller/types';\nimport type { KeyringControllerInstanceOptions } from './initialization/instances/keyring-controller/types';\nimport type { NetworkControllerInstanceOptions } from './initialization/instances/network-controller/types';\nimport type { RemoteFeatureFlagControllerInstanceOptions } from './initialization/instances/remote-feature-flag-controller/types';\nimport type { StorageServiceInstanceOptions } from './initialization/instances/storage-service/types';\nimport type { InitializationConfiguration } from './initialization/types';\n\nexport type WalletOptions = {\n  messenger?: RootMessenger<DefaultActions, DefaultEvents>;\n  state?: Record<string, Record<string, Json> | undefined>;\n  initializationConfigurations?: InitializationConfiguration<\n    unknown,\n    unknown\n  >[];\n  instanceOptions: InstanceSpecificOptions;\n};\n\nexport type InstanceSpecificOptions = {\n  approvalController?: ApprovalControllerInstanceOptions;\n  connectivityController: ConnectivityControllerInstanceOptions;\n  keyringController?: KeyringControllerInstanceOptions;\n  networkController: NetworkControllerInstanceOptions;\n  remoteFeatureFlagController: RemoteFeatureFlagControllerInstanceOptions;\n  storageService: StorageServiceInstanceOptions;\n};\n"]}

package/dist/types.d.cts

@@ -3,9 +3,10 @@ import type { DefaultActions, DefaultEvents, RootMessenger } from "./initializat
 import type { ApprovalControllerInstanceOptions } from "./initialization/instances/approval-controller/types.cjs";
 import type { ConnectivityControllerInstanceOptions } from "./initialization/instances/connectivity-controller/types.cjs";
 import type { KeyringControllerInstanceOptions } from "./initialization/instances/keyring-controller/types.cjs";
+import type { NetworkControllerInstanceOptions } from "./initialization/instances/network-controller/types.cjs";
 import type { RemoteFeatureFlagControllerInstanceOptions } from "./initialization/instances/remote-feature-flag-controller/types.cjs";
 import type { StorageServiceInstanceOptions } from "./initialization/instances/storage-service/types.cjs";
-import { InitializationConfiguration } from "./initialization/types.cjs";
+import type { InitializationConfiguration } from "./initialization/types.cjs";
 export type WalletOptions = {
     messenger?: RootMessenger<DefaultActions, DefaultEvents>;
     state?: Record<string, Record<string, Json> | undefined>;
@@ -16,6 +17,7 @@ export type InstanceSpecificOptions = {
     approvalController?: ApprovalControllerInstanceOptions;
     connectivityController: ConnectivityControllerInstanceOptions;
     keyringController?: KeyringControllerInstanceOptions;
+    networkController: NetworkControllerInstanceOptions;
     remoteFeatureFlagController: RemoteFeatureFlagControllerInstanceOptions;
     storageService: StorageServiceInstanceOptions;
 };

package/dist/types.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.cts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,wBAAwB;AAE5C,OAAO,KAAK,EACV,cAAc,EACd,aAAa,EACb,aAAa,EACd,sCAAkC;AACnC,OAAO,KAAK,EAAE,iCAAiC,EAAE,iEAA6D;AAC9G,OAAO,KAAK,EAAE,qCAAqC,EAAE,qEAAiE;AACtH,OAAO,KAAK,EAAE,gCAAgC,EAAE,gEAA4D;AAC5G,OAAO,KAAK,EAAE,0CAA0C,EAAE,4EAAwE;AAClI,OAAO,KAAK,EAAE,6BAA6B,EAAE,6DAAyD;AACtG,OAAO,EAAE,2BAA2B,EAAE,mCAA+B;AAErE,MAAM,MAAM,aAAa,GAAG;IAC1B,SAAS,CAAC,EAAE,aAAa,CAAC,cAAc,EAAE,aAAa,CAAC,CAAC;IACzD,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,GAAG,SAAS,CAAC,CAAC;IACzD,4BAA4B,CAAC,EAAE,2BAA2B,CACxD,OAAO,EACP,OAAO,CACR,EAAE,CAAC;IACJ,eAAe,EAAE,uBAAuB,CAAC;CAC1C,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG;IACpC,kBAAkB,CAAC,EAAE,iCAAiC,CAAC;IACvD,sBAAsB,EAAE,qCAAqC,CAAC;IAC9D,iBAAiB,CAAC,EAAE,gCAAgC,CAAC;IACrD,2BAA2B,EAAE,0CAA0C,CAAC;IACxE,cAAc,EAAE,6BAA6B,CAAC;CAC/C,CAAC"}
+{"version":3,"file":"types.d.cts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,wBAAwB;AAE5C,OAAO,KAAK,EACV,cAAc,EACd,aAAa,EACb,aAAa,EACd,sCAAkC;AACnC,OAAO,KAAK,EAAE,iCAAiC,EAAE,iEAA6D;AAC9G,OAAO,KAAK,EAAE,qCAAqC,EAAE,qEAAiE;AACtH,OAAO,KAAK,EAAE,gCAAgC,EAAE,gEAA4D;AAC5G,OAAO,KAAK,EAAE,gCAAgC,EAAE,gEAA4D;AAC5G,OAAO,KAAK,EAAE,0CAA0C,EAAE,4EAAwE;AAClI,OAAO,KAAK,EAAE,6BAA6B,EAAE,6DAAyD;AACtG,OAAO,KAAK,EAAE,2BAA2B,EAAE,mCAA+B;AAE1E,MAAM,MAAM,aAAa,GAAG;IAC1B,SAAS,CAAC,EAAE,aAAa,CAAC,cAAc,EAAE,aAAa,CAAC,CAAC;IACzD,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,GAAG,SAAS,CAAC,CAAC;IACzD,4BAA4B,CAAC,EAAE,2BAA2B,CACxD,OAAO,EACP,OAAO,CACR,EAAE,CAAC;IACJ,eAAe,EAAE,uBAAuB,CAAC;CAC1C,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG;IACpC,kBAAkB,CAAC,EAAE,iCAAiC,CAAC;IACvD,sBAAsB,EAAE,qCAAqC,CAAC;IAC9D,iBAAiB,CAAC,EAAE,gCAAgC,CAAC;IACrD,iBAAiB,EAAE,gCAAgC,CAAC;IACpD,2BAA2B,EAAE,0CAA0C,CAAC;IACxE,cAAc,EAAE,6BAA6B,CAAC;CAC/C,CAAC"}

package/dist/types.d.mts

@@ -3,9 +3,10 @@ import type { DefaultActions, DefaultEvents, RootMessenger } from "./initializat
 import type { ApprovalControllerInstanceOptions } from "./initialization/instances/approval-controller/types.mjs";
 import type { ConnectivityControllerInstanceOptions } from "./initialization/instances/connectivity-controller/types.mjs";
 import type { KeyringControllerInstanceOptions } from "./initialization/instances/keyring-controller/types.mjs";
+import type { NetworkControllerInstanceOptions } from "./initialization/instances/network-controller/types.mjs";
 import type { RemoteFeatureFlagControllerInstanceOptions } from "./initialization/instances/remote-feature-flag-controller/types.mjs";
 import type { StorageServiceInstanceOptions } from "./initialization/instances/storage-service/types.mjs";
-import { InitializationConfiguration } from "./initialization/types.mjs";
+import type { InitializationConfiguration } from "./initialization/types.mjs";
 export type WalletOptions = {
     messenger?: RootMessenger<DefaultActions, DefaultEvents>;
     state?: Record<string, Record<string, Json> | undefined>;
@@ -16,6 +17,7 @@ export type InstanceSpecificOptions = {
     approvalController?: ApprovalControllerInstanceOptions;
     connectivityController: ConnectivityControllerInstanceOptions;
     keyringController?: KeyringControllerInstanceOptions;
+    networkController: NetworkControllerInstanceOptions;
     remoteFeatureFlagController: RemoteFeatureFlagControllerInstanceOptions;
     storageService: StorageServiceInstanceOptions;
 };

package/dist/types.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.mts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,wBAAwB;AAE5C,OAAO,KAAK,EACV,cAAc,EACd,aAAa,EACb,aAAa,EACd,sCAAkC;AACnC,OAAO,KAAK,EAAE,iCAAiC,EAAE,iEAA6D;AAC9G,OAAO,KAAK,EAAE,qCAAqC,EAAE,qEAAiE;AACtH,OAAO,KAAK,EAAE,gCAAgC,EAAE,gEAA4D;AAC5G,OAAO,KAAK,EAAE,0CAA0C,EAAE,4EAAwE;AAClI,OAAO,KAAK,EAAE,6BAA6B,EAAE,6DAAyD;AACtG,OAAO,EAAE,2BAA2B,EAAE,mCAA+B;AAErE,MAAM,MAAM,aAAa,GAAG;IAC1B,SAAS,CAAC,EAAE,aAAa,CAAC,cAAc,EAAE,aAAa,CAAC,CAAC;IACzD,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,GAAG,SAAS,CAAC,CAAC;IACzD,4BAA4B,CAAC,EAAE,2BAA2B,CACxD,OAAO,EACP,OAAO,CACR,EAAE,CAAC;IACJ,eAAe,EAAE,uBAAuB,CAAC;CAC1C,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG;IACpC,kBAAkB,CAAC,EAAE,iCAAiC,CAAC;IACvD,sBAAsB,EAAE,qCAAqC,CAAC;IAC9D,iBAAiB,CAAC,EAAE,gCAAgC,CAAC;IACrD,2BAA2B,EAAE,0CAA0C,CAAC;IACxE,cAAc,EAAE,6BAA6B,CAAC;CAC/C,CAAC"}
+{"version":3,"file":"types.d.mts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,wBAAwB;AAE5C,OAAO,KAAK,EACV,cAAc,EACd,aAAa,EACb,aAAa,EACd,sCAAkC;AACnC,OAAO,KAAK,EAAE,iCAAiC,EAAE,iEAA6D;AAC9G,OAAO,KAAK,EAAE,qCAAqC,EAAE,qEAAiE;AACtH,OAAO,KAAK,EAAE,gCAAgC,EAAE,gEAA4D;AAC5G,OAAO,KAAK,EAAE,gCAAgC,EAAE,gEAA4D;AAC5G,OAAO,KAAK,EAAE,0CAA0C,EAAE,4EAAwE;AAClI,OAAO,KAAK,EAAE,6BAA6B,EAAE,6DAAyD;AACtG,OAAO,KAAK,EAAE,2BAA2B,EAAE,mCAA+B;AAE1E,MAAM,MAAM,aAAa,GAAG;IAC1B,SAAS,CAAC,EAAE,aAAa,CAAC,cAAc,EAAE,aAAa,CAAC,CAAC;IACzD,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,GAAG,SAAS,CAAC,CAAC;IACzD,4BAA4B,CAAC,EAAE,2BAA2B,CACxD,OAAO,EACP,OAAO,CACR,EAAE,CAAC;IACJ,eAAe,EAAE,uBAAuB,CAAC;CAC1C,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG;IACpC,kBAAkB,CAAC,EAAE,iCAAiC,CAAC;IACvD,sBAAsB,EAAE,qCAAqC,CAAC;IAC9D,iBAAiB,CAAC,EAAE,gCAAgC,CAAC;IACrD,iBAAiB,EAAE,gCAAgC,CAAC;IACpD,2BAA2B,EAAE,0CAA0C,CAAC;IACxE,cAAc,EAAE,6BAA6B,CAAC;CAC/C,CAAC"}

package/dist/types.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"types.mjs","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"","sourcesContent":["import type { Json } from '@metamask/utils';\n\nimport type {\n  DefaultActions,\n  DefaultEvents,\n  RootMessenger,\n} from './initialization/defaults';\nimport type { ApprovalControllerInstanceOptions } from './initialization/instances/approval-controller/types';\nimport type { ConnectivityControllerInstanceOptions } from './initialization/instances/connectivity-controller/types';\nimport type { KeyringControllerInstanceOptions } from './initialization/instances/keyring-controller/types';\nimport type { RemoteFeatureFlagControllerInstanceOptions } from './initialization/instances/remote-feature-flag-controller/types';\nimport type { StorageServiceInstanceOptions } from './initialization/instances/storage-service/types';\nimport { InitializationConfiguration } from './initialization/types';\n\nexport type WalletOptions = {\n  messenger?: RootMessenger<DefaultActions, DefaultEvents>;\n  state?: Record<string, Record<string, Json> | undefined>;\n  initializationConfigurations?: InitializationConfiguration<\n    unknown,\n    unknown\n  >[];\n  instanceOptions: InstanceSpecificOptions;\n};\n\nexport type InstanceSpecificOptions = {\n  approvalController?: ApprovalControllerInstanceOptions;\n  connectivityController: ConnectivityControllerInstanceOptions;\n  keyringController?: KeyringControllerInstanceOptions;\n  remoteFeatureFlagController: RemoteFeatureFlagControllerInstanceOptions;\n  storageService: StorageServiceInstanceOptions;\n};\n"]}
+{"version":3,"file":"types.mjs","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"","sourcesContent":["import type { Json } from '@metamask/utils';\n\nimport type {\n  DefaultActions,\n  DefaultEvents,\n  RootMessenger,\n} from './initialization/defaults';\nimport type { ApprovalControllerInstanceOptions } from './initialization/instances/approval-controller/types';\nimport type { ConnectivityControllerInstanceOptions } from './initialization/instances/connectivity-controller/types';\nimport type { KeyringControllerInstanceOptions } from './initialization/instances/keyring-controller/types';\nimport type { NetworkControllerInstanceOptions } from './initialization/instances/network-controller/types';\nimport type { RemoteFeatureFlagControllerInstanceOptions } from './initialization/instances/remote-feature-flag-controller/types';\nimport type { StorageServiceInstanceOptions } from './initialization/instances/storage-service/types';\nimport type { InitializationConfiguration } from './initialization/types';\n\nexport type WalletOptions = {\n  messenger?: RootMessenger<DefaultActions, DefaultEvents>;\n  state?: Record<string, Record<string, Json> | undefined>;\n  initializationConfigurations?: InitializationConfiguration<\n    unknown,\n    unknown\n  >[];\n  instanceOptions: InstanceSpecificOptions;\n};\n\nexport type InstanceSpecificOptions = {\n  approvalController?: ApprovalControllerInstanceOptions;\n  connectivityController: ConnectivityControllerInstanceOptions;\n  keyringController?: KeyringControllerInstanceOptions;\n  networkController: NetworkControllerInstanceOptions;\n  remoteFeatureFlagController: RemoteFeatureFlagControllerInstanceOptions;\n  storageService: StorageServiceInstanceOptions;\n};\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@metamask-previews/wallet",
-  "version": "4.0.0-preview-9de9aa4",
+  "version": "4.0.0-preview-ed0047684",
   "description": "Provides a shared framework for building MetaMask wallets",
   "keywords": [
     "Ethereum",
@@ -61,6 +61,7 @@
     "@metamask/controller-utils": "^12.3.0",
     "@metamask/keyring-controller": "^27.1.0",
     "@metamask/messenger": "^1.2.0",
+    "@metamask/network-controller": "^33.0.0",
     "@metamask/remote-feature-flag-controller": "^4.2.2",
     "@metamask/scure-bip39": "^2.1.1",
     "@metamask/storage-service": "^1.0.2",