@metamask/snaps-jest 9.0.0 → 9.2.0

package/CHANGELOG.md

@@ -7,6 +7,18 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [9.2.0]
+
+### Added
+
+- Add support for `AssetSelector` and `AccountSelector` ([#3462](https://github.com/MetaMask/snaps/pull/3462))
+
+## [9.1.0]
+
+### Added
+
+- Add support for `onStart` ([#3455](https://github.com/MetaMask/snaps/pull/3455))
+
 ## [9.0.0]
 
 ### Added
@@ -385,7 +397,9 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   - The version of the package no longer needs to match the version of all other
     MetaMask Snaps packages.
 
-[Unreleased]: https://github.com/MetaMask/snaps/compare/@metamask/snaps-jest@9.0.0...HEAD
+[Unreleased]: https://github.com/MetaMask/snaps/compare/@metamask/snaps-jest@9.2.0...HEAD
+[9.2.0]: https://github.com/MetaMask/snaps/compare/@metamask/snaps-jest@9.1.0...@metamask/snaps-jest@9.2.0
+[9.1.0]: https://github.com/MetaMask/snaps/compare/@metamask/snaps-jest@9.0.0...@metamask/snaps-jest@9.1.0
 [9.0.0]: https://github.com/MetaMask/snaps/compare/@metamask/snaps-jest@8.16.0...@metamask/snaps-jest@9.0.0
 [8.16.0]: https://github.com/MetaMask/snaps/compare/@metamask/snaps-jest@8.15.0...@metamask/snaps-jest@8.16.0
 [8.15.0]: https://github.com/MetaMask/snaps/compare/@metamask/snaps-jest@8.14.1...@metamask/snaps-jest@8.15.0

package/dist/helpers.cjs

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.installSnap = void 0;
+exports.getMockAccount = exports.getStateFromAsset = exports.getStateFromAccount = exports.installSnap = void 0;
 const snaps_utils_1 = require("@metamask/snaps-utils");
 const utils_1 = require("@metamask/utils");
 const internals_1 = require("./internals/index.cjs");
@@ -55,7 +55,7 @@ async function installSnap(snapId, options = {}) {
     // TODO: Either fix this lint violation or explain why it's necessary to
     //  ignore.
     /* eslint-disable @typescript-eslint/unbound-method */
-    const { request, onTransaction, sendTransaction, onSignature, onCronjob, runCronjob, onBackgroundEvent, onHomePage, onSettingsPage, onKeyringRequest, onInstall, onUpdate, onNameLookup, onProtocolRequest, onClientRequest, mockJsonRpc, close, } = await (0, internals_1.getEnvironment)().installSnap(...resolvedOptions);
+    const { request, onTransaction, sendTransaction, onSignature, onCronjob, runCronjob, onBackgroundEvent, onHomePage, onSettingsPage, onKeyringRequest, onInstall, onUpdate, onStart, onNameLookup, onProtocolRequest, onClientRequest, mockJsonRpc, close, } = await (0, internals_1.getEnvironment)().installSnap(...resolvedOptions);
     /* eslint-enable @typescript-eslint/unbound-method */
     return {
         request,
@@ -70,6 +70,7 @@ async function installSnap(snapId, options = {}) {
         onKeyringRequest,
         onInstall,
         onUpdate,
+        onStart,
         onNameLookup,
         onProtocolRequest,
         onClientRequest,
@@ -82,4 +83,66 @@ async function installSnap(snapId, options = {}) {
     };
 }
 exports.installSnap = installSnap;
+/**
+ * Get the state of an AccountSelector based on a {@link SimulationAccount}.
+ *
+ * @param account - The {@link SimulationAccount} to get the state from.
+ * @returns The state of the AccountSelector.
+ */
+function getStateFromAccount(account) {
+    const { address, scopes } = account;
+    return {
+        addresses: scopes.map((scope) => `${scope}:${address}`),
+        accountId: account.id,
+    };
+}
+exports.getStateFromAccount = getStateFromAccount;
+/**
+ * Get the state of an AssetSelector based on a {@link SimulationAsset}.
+ *
+ * @param id - The Asset id as a CAIP-19 asset type.
+ * @param assets - The {@link SimulationAsset} to get the state from.
+ * @returns The state of the AssetSelector.
+ */
+function getStateFromAsset(id, assets) {
+    const asset = assets[id];
+    (0, utils_1.assert)(asset, `Asset with ID "${id}" not found in simulation assets.`);
+    const { symbol, name } = asset;
+    return {
+        asset: id,
+        symbol,
+        name,
+    };
+}
+exports.getStateFromAsset = getStateFromAsset;
+/**
+ * Generate a pseudo-random UUID.
+ *
+ * @returns A pseudo-random UUID string.
+ */
+const getPseudoRandomUuid = (0, internals_1.getPseudoRandomUuidGenerator)();
+/**
+ * Get a mock account object for testing purposes.
+ *
+ * @param options - The options for creating the mock account.
+ * @param options.address - The address of the account.
+ * @param options.scopes - The scopes associated with the account, in CAIP
+ * format. If not provided, they will be derived from the `assets`.
+ * @param options.assets - The assets associated with the account, in CAIP
+ * format. If not provided, it will default to an empty array.
+ * @param options.selected - Whether the account is selected by default.
+ * @param options.id - The ID of the account. If not provided, a pseudo-random
+ * UUID will be generated.
+ * @returns A mock account object with the specified properties.
+ */
+function getMockAccount({ address, assets = [], selected = false, id = getPseudoRandomUuid(), scopes = (0, internals_1.getScopesFromAssets)(assets), }) {
+    return {
+        address,
+        id,
+        scopes,
+        selected,
+        assets,
+    };
+}
+exports.getMockAccount = getMockAccount;
 //# sourceMappingURL=helpers.cjs.map

package/dist/helpers.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"helpers.cjs","sourceRoot":"","sources":["../src/helpers.ts"],"names":[],"mappings":";;;AAGA,uDAAgD;AAChD,2CAAqD;AAErD,qDAAyD;AAEzD,MAAM,GAAG,GAAG,IAAA,0BAAkB,EAAC,sBAAU,EAAE,SAAS,CAAC,CAAC;AAEtD;;;;;;GAMG;AACH,SAAS,UAAU,CAKjB,MAAiE,EACjE,OAA6C;IAE7C,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC/B,OAAO,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IAC7B,CAAC;IAED,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAC3B,CAAC;AAqGD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACI,KAAK,UAAU,WAAW,CAK/B,MAAsD,EACtD,UAAgD,EAAE;IAElD,MAAM,eAAe,GAAG,UAAU,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEpD,wEAAwE;IACxE,WAAW;IACX,sDAAsD;IACtD,MAAM,EACJ,OAAO,EACP,aAAa,EACb,eAAe,EACf,WAAW,EACX,SAAS,EACT,UAAU,EACV,iBAAiB,EACjB,UAAU,EACV,cAAc,EACd,gBAAgB,EAChB,SAAS,EACT,QAAQ,EACR,YAAY,EACZ,iBAAiB,EACjB,eAAe,EACf,WAAW,EACX,KAAK,GACN,GAAG,MAAM,IAAA,0BAAc,GAAE,CAAC,WAAW,CAAC,GAAG,eAAe,CAAC,CAAC;IAC3D,qDAAqD;IAErD,OAAO;QACL,OAAO;QACP,aAAa;QACb,eAAe;QACf,WAAW;QACX,SAAS;QACT,UAAU;QACV,iBAAiB;QACjB,UAAU;QACV,cAAc;QACd,gBAAgB;QAChB,SAAS;QACT,QAAQ;QACR,YAAY;QACZ,iBAAiB;QACjB,eAAe;QACf,WAAW;QACX,KAAK,EAAE,KAAK,IAAI,EAAE;YAChB,GAAG,CAAC,4BAA4B,CAAC,CAAC;YAClC,IAAA,qBAAO,EACL,uIAAuI,CACxI,CAAC;YAEF,MAAM,KAAK,EAAE,CAAC;QAChB,CAAC;KACF,CAAC;AACJ,CAAC;AA5DD,kCA4DC","sourcesContent":["import type { AbstractExecutionService } from '@metamask/snaps-controllers';\nimport type { SnapId } from '@metamask/snaps-sdk';\nimport type { InstallSnapOptions, Snap } from '@metamask/snaps-simulation';\nimport { logInfo } from '@metamask/snaps-utils';\nimport { createModuleLogger } from '@metamask/utils';\n\nimport { rootLogger, getEnvironment } from './internals';\n\nconst log = createModuleLogger(rootLogger, 'helpers');\n\n/**\n * Get the options for {@link installSnap}.\n *\n * @param snapId - The ID of the Snap, or the options.\n * @param options - The options, if any.\n * @returns The options.\n */\nfunction getOptions<\n  Service extends new (\n    ...args: any[]\n  ) => InstanceType<typeof AbstractExecutionService>,\n>(\n  snapId: SnapId | Partial<InstallSnapOptions<Service>> | undefined,\n  options: Partial<InstallSnapOptions<Service>>,\n): [SnapId | undefined, Partial<InstallSnapOptions<Service>>] {\n  if (typeof snapId === 'object') {\n    return [undefined, snapId];\n  }\n\n  return [snapId, options];\n}\n\n/**\n * Load a snap into the environment. This is the main entry point for testing\n * snaps: It returns a {@link Snap} object that can be used to interact with the\n * snap.\n *\n * @example\n * import { installSnap } from '@metamask/snaps-jest';\n *\n * describe('My Snap', () => {\n *   it('should do something', async () => {\n *     const { request } = await installSnap('local:my-snap');\n *     const response = await request({\n *       method: 'foo',\n *       params: ['bar'],\n *     });\n *     expect(response).toRespondWith('bar');\n *   });\n * });\n * @returns The snap.\n * @throws If the built-in server is not running, and no snap ID is provided.\n */\nexport async function installSnap(): Promise<Snap>;\n\n/**\n * Load a snap into the environment. This is the main entry point for testing\n * snaps: It returns a {@link Snap} object that can be used to interact with the\n * snap.\n *\n * @example\n * import { installSnap } from '@metamask/snaps-jest';\n *\n * describe('My Snap', () => {\n *   it('should do something', async () => {\n *     const { request } = await installSnap('local:my-snap');\n *     const response = await request({\n *       method: 'foo',\n *       params: ['bar'],\n *     });\n *     expect(response).toRespondWith('bar');\n *   });\n * });\n * @param options - The options to use.\n * @param options.executionService - The execution service to use. Defaults to\n * {@link NodeThreadExecutionService}. You do not need to provide this unless\n * you are testing a custom execution service.\n * @param options.executionServiceOptions - The options to use when creating the\n * execution service, if any. This should only include options specific to the\n * provided execution service.\n * @param options.options - The simulation options.\n * @returns The snap.\n * @throws If the built-in server is not running, and no snap ID is provided.\n */\nexport async function installSnap<\n  Service extends new (\n    ...args: any[]\n  ) => InstanceType<typeof AbstractExecutionService>,\n>(options: Partial<InstallSnapOptions<Service>>): Promise<Snap>;\n\n/**\n * Load a snap into the environment. This is the main entry point for testing\n * snaps: It returns a {@link Snap} object that can be used to interact with the\n * snap.\n *\n * @example\n * import { installSnap } from '@metamask/snaps-jest';\n *\n * describe('My Snap', () => {\n *   it('should do something', async () => {\n *     const { request } = await installSnap('local:my-snap');\n *     const response = await request({\n *       method: 'foo',\n *       params: ['bar'],\n *     });\n *     expect(response).toRespondWith('bar');\n *   });\n * });\n * @param snapId - The ID of the snap, including the prefix (`local:`). Defaults\n * to the URL of the built-in server, if it is running. This supports both\n * local snap IDs and NPM snap IDs.\n * @param options - The options to use.\n * @param options.executionService - The execution service to use. Defaults to\n * {@link NodeThreadExecutionService}. You do not need to provide this unless\n * you are testing a custom execution service.\n * @param options.executionServiceOptions - The options to use when creating the\n * execution service, if any. This should only include options specific to the\n * provided execution service.\n * @param options.options - The simulation options.\n * @returns The snap.\n * @throws If the built-in server is not running, and no snap ID is provided.\n */\nexport async function installSnap<\n  Service extends new (\n    ...args: any[]\n  ) => InstanceType<typeof AbstractExecutionService>,\n>(\n  snapId: SnapId,\n  options?: Partial<InstallSnapOptions<Service>>,\n): Promise<Snap>;\n\n/**\n * Load a snap into the environment. This is the main entry point for testing\n * snaps: It returns a {@link Snap} object that can be used to interact with the\n * snap.\n *\n * @example\n * import { installSnap } from '@metamask/snaps-jest';\n *\n * describe('My Snap', () => {\n *   it('should do something', async () => {\n *     const { request } = await installSnap('local:my-snap');\n *     const response = await request({\n *       method: 'foo',\n *       params: ['bar'],\n *     });\n *     expect(response).toRespondWith('bar');\n *   });\n * });\n * @param snapId - The ID of the snap, including the prefix (`local:`). Defaults\n * to the URL of the built-in server, if it is running. This supports both\n * local snap IDs and NPM snap IDs.\n * @param options - The options to use.\n * @param options.executionService - The execution service to use. Defaults to\n * {@link NodeThreadExecutionService}. You do not need to provide this unless\n * you are testing a custom execution service.\n * @param options.executionServiceOptions - The options to use when creating the\n * execution service, if any. This should only include options specific to the\n * provided execution service.\n * @param options.options - The simulation options.\n * @returns The snap.\n * @throws If the built-in server is not running, and no snap ID is provided.\n */\nexport async function installSnap<\n  Service extends new (\n    ...args: any[]\n  ) => InstanceType<typeof AbstractExecutionService>,\n>(\n  snapId?: SnapId | Partial<InstallSnapOptions<Service>>,\n  options: Partial<InstallSnapOptions<Service>> = {},\n): Promise<Snap> {\n  const resolvedOptions = getOptions(snapId, options);\n\n  // TODO: Either fix this lint violation or explain why it's necessary to\n  //  ignore.\n  /* eslint-disable @typescript-eslint/unbound-method */\n  const {\n    request,\n    onTransaction,\n    sendTransaction,\n    onSignature,\n    onCronjob,\n    runCronjob,\n    onBackgroundEvent,\n    onHomePage,\n    onSettingsPage,\n    onKeyringRequest,\n    onInstall,\n    onUpdate,\n    onNameLookup,\n    onProtocolRequest,\n    onClientRequest,\n    mockJsonRpc,\n    close,\n  } = await getEnvironment().installSnap(...resolvedOptions);\n  /* eslint-enable @typescript-eslint/unbound-method */\n\n  return {\n    request,\n    onTransaction,\n    sendTransaction,\n    onSignature,\n    onCronjob,\n    runCronjob,\n    onBackgroundEvent,\n    onHomePage,\n    onSettingsPage,\n    onKeyringRequest,\n    onInstall,\n    onUpdate,\n    onNameLookup,\n    onProtocolRequest,\n    onClientRequest,\n    mockJsonRpc,\n    close: async () => {\n      log('Closing execution service.');\n      logInfo(\n        'Calling `snap.close()` is deprecated, and will be removed in a future release. Snaps are now automatically closed when the test ends.',\n      );\n\n      await close();\n    },\n  };\n}\n"]}
+{"version":3,"file":"helpers.cjs","sourceRoot":"","sources":["../src/helpers.ts"],"names":[],"mappings":"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","sourcesContent":["import type { AbstractExecutionService } from '@metamask/snaps-controllers';\nimport type {\n  AccountSelectorState,\n  AssetSelectorState,\n  SnapId,\n} from '@metamask/snaps-sdk';\nimport type {\n  InstallSnapOptions,\n  SimulationAccount,\n  SimulationAsset,\n  Snap,\n} from '@metamask/snaps-simulation';\nimport { logInfo } from '@metamask/snaps-utils';\nimport { assert, createModuleLogger } from '@metamask/utils';\nimport type {\n  CaipAccountId,\n  CaipAssetType,\n  CaipChainId,\n} from '@metamask/utils';\n\nimport {\n  rootLogger,\n  getEnvironment,\n  getPseudoRandomUuidGenerator,\n  getScopesFromAssets,\n} from './internals';\n\nconst log = createModuleLogger(rootLogger, 'helpers');\n\n/**\n * Get the options for {@link installSnap}.\n *\n * @param snapId - The ID of the Snap, or the options.\n * @param options - The options, if any.\n * @returns The options.\n */\nfunction getOptions<\n  Service extends new (\n    ...args: any[]\n  ) => InstanceType<typeof AbstractExecutionService>,\n>(\n  snapId: SnapId | Partial<InstallSnapOptions<Service>> | undefined,\n  options: Partial<InstallSnapOptions<Service>>,\n): [SnapId | undefined, Partial<InstallSnapOptions<Service>>] {\n  if (typeof snapId === 'object') {\n    return [undefined, snapId];\n  }\n\n  return [snapId, options];\n}\n\n/**\n * Load a snap into the environment. This is the main entry point for testing\n * snaps: It returns a {@link Snap} object that can be used to interact with the\n * snap.\n *\n * @example\n * import { installSnap } from '@metamask/snaps-jest';\n *\n * describe('My Snap', () => {\n *   it('should do something', async () => {\n *     const { request } = await installSnap('local:my-snap');\n *     const response = await request({\n *       method: 'foo',\n *       params: ['bar'],\n *     });\n *     expect(response).toRespondWith('bar');\n *   });\n * });\n * @returns The snap.\n * @throws If the built-in server is not running, and no snap ID is provided.\n */\nexport async function installSnap(): Promise<Snap>;\n\n/**\n * Load a snap into the environment. This is the main entry point for testing\n * snaps: It returns a {@link Snap} object that can be used to interact with the\n * snap.\n *\n * @example\n * import { installSnap } from '@metamask/snaps-jest';\n *\n * describe('My Snap', () => {\n *   it('should do something', async () => {\n *     const { request } = await installSnap('local:my-snap');\n *     const response = await request({\n *       method: 'foo',\n *       params: ['bar'],\n *     });\n *     expect(response).toRespondWith('bar');\n *   });\n * });\n * @param options - The options to use.\n * @param options.executionService - The execution service to use. Defaults to\n * {@link NodeThreadExecutionService}. You do not need to provide this unless\n * you are testing a custom execution service.\n * @param options.executionServiceOptions - The options to use when creating the\n * execution service, if any. This should only include options specific to the\n * provided execution service.\n * @param options.options - The simulation options.\n * @returns The snap.\n * @throws If the built-in server is not running, and no snap ID is provided.\n */\nexport async function installSnap<\n  Service extends new (\n    ...args: any[]\n  ) => InstanceType<typeof AbstractExecutionService>,\n>(options: Partial<InstallSnapOptions<Service>>): Promise<Snap>;\n\n/**\n * Load a snap into the environment. This is the main entry point for testing\n * snaps: It returns a {@link Snap} object that can be used to interact with the\n * snap.\n *\n * @example\n * import { installSnap } from '@metamask/snaps-jest';\n *\n * describe('My Snap', () => {\n *   it('should do something', async () => {\n *     const { request } = await installSnap('local:my-snap');\n *     const response = await request({\n *       method: 'foo',\n *       params: ['bar'],\n *     });\n *     expect(response).toRespondWith('bar');\n *   });\n * });\n * @param snapId - The ID of the snap, including the prefix (`local:`). Defaults\n * to the URL of the built-in server, if it is running. This supports both\n * local snap IDs and NPM snap IDs.\n * @param options - The options to use.\n * @param options.executionService - The execution service to use. Defaults to\n * {@link NodeThreadExecutionService}. You do not need to provide this unless\n * you are testing a custom execution service.\n * @param options.executionServiceOptions - The options to use when creating the\n * execution service, if any. This should only include options specific to the\n * provided execution service.\n * @param options.options - The simulation options.\n * @returns The snap.\n * @throws If the built-in server is not running, and no snap ID is provided.\n */\nexport async function installSnap<\n  Service extends new (\n    ...args: any[]\n  ) => InstanceType<typeof AbstractExecutionService>,\n>(\n  snapId: SnapId,\n  options?: Partial<InstallSnapOptions<Service>>,\n): Promise<Snap>;\n\n/**\n * Load a snap into the environment. This is the main entry point for testing\n * snaps: It returns a {@link Snap} object that can be used to interact with the\n * snap.\n *\n * @example\n * import { installSnap } from '@metamask/snaps-jest';\n *\n * describe('My Snap', () => {\n *   it('should do something', async () => {\n *     const { request } = await installSnap('local:my-snap');\n *     const response = await request({\n *       method: 'foo',\n *       params: ['bar'],\n *     });\n *     expect(response).toRespondWith('bar');\n *   });\n * });\n * @param snapId - The ID of the snap, including the prefix (`local:`). Defaults\n * to the URL of the built-in server, if it is running. This supports both\n * local snap IDs and NPM snap IDs.\n * @param options - The options to use.\n * @param options.executionService - The execution service to use. Defaults to\n * {@link NodeThreadExecutionService}. You do not need to provide this unless\n * you are testing a custom execution service.\n * @param options.executionServiceOptions - The options to use when creating the\n * execution service, if any. This should only include options specific to the\n * provided execution service.\n * @param options.options - The simulation options.\n * @returns The snap.\n * @throws If the built-in server is not running, and no snap ID is provided.\n */\nexport async function installSnap<\n  Service extends new (\n    ...args: any[]\n  ) => InstanceType<typeof AbstractExecutionService>,\n>(\n  snapId?: SnapId | Partial<InstallSnapOptions<Service>>,\n  options: Partial<InstallSnapOptions<Service>> = {},\n): Promise<Snap> {\n  const resolvedOptions = getOptions(snapId, options);\n\n  // TODO: Either fix this lint violation or explain why it's necessary to\n  //  ignore.\n  /* eslint-disable @typescript-eslint/unbound-method */\n  const {\n    request,\n    onTransaction,\n    sendTransaction,\n    onSignature,\n    onCronjob,\n    runCronjob,\n    onBackgroundEvent,\n    onHomePage,\n    onSettingsPage,\n    onKeyringRequest,\n    onInstall,\n    onUpdate,\n    onStart,\n    onNameLookup,\n    onProtocolRequest,\n    onClientRequest,\n    mockJsonRpc,\n    close,\n  } = await getEnvironment().installSnap(...resolvedOptions);\n  /* eslint-enable @typescript-eslint/unbound-method */\n\n  return {\n    request,\n    onTransaction,\n    sendTransaction,\n    onSignature,\n    onCronjob,\n    runCronjob,\n    onBackgroundEvent,\n    onHomePage,\n    onSettingsPage,\n    onKeyringRequest,\n    onInstall,\n    onUpdate,\n    onStart,\n    onNameLookup,\n    onProtocolRequest,\n    onClientRequest,\n    mockJsonRpc,\n    close: async () => {\n      log('Closing execution service.');\n      logInfo(\n        'Calling `snap.close()` is deprecated, and will be removed in a future release. Snaps are now automatically closed when the test ends.',\n      );\n\n      await close();\n    },\n  };\n}\n\n/**\n * Get the state of an AccountSelector based on a {@link SimulationAccount}.\n *\n * @param account - The {@link SimulationAccount} to get the state from.\n * @returns The state of the AccountSelector.\n */\nexport function getStateFromAccount(\n  account: SimulationAccount,\n): AccountSelectorState {\n  const { address, scopes } = account;\n  return {\n    addresses: scopes.map((scope) => `${scope}:${address}`) as CaipAccountId[],\n    accountId: account.id,\n  };\n}\n\n/**\n * Get the state of an AssetSelector based on a {@link SimulationAsset}.\n *\n * @param id - The Asset id as a CAIP-19 asset type.\n * @param assets - The {@link SimulationAsset} to get the state from.\n * @returns The state of the AssetSelector.\n */\nexport function getStateFromAsset(\n  id: CaipAssetType,\n  assets: Record<CaipAssetType, SimulationAsset>,\n): AssetSelectorState {\n  const asset = assets[id];\n\n  assert(asset, `Asset with ID \"${id}\" not found in simulation assets.`);\n\n  const { symbol, name } = asset;\n\n  return {\n    asset: id,\n    symbol,\n    name,\n  };\n}\n\n/**\n * Generate a pseudo-random UUID.\n *\n * @returns A pseudo-random UUID string.\n */\nconst getPseudoRandomUuid = getPseudoRandomUuidGenerator();\n\n/**\n * The base options for the {@link getMockAccount} function.\n */\nexport type BaseMockAccountOptions = {\n  /**\n   * The address of the account.\n   */\n  address: string;\n\n  /**\n   * The ID of the account. If not provided, a pseudo-random UUID will be\n   * generated.\n   */\n  id?: string;\n\n  /**\n   * Whether the account is selected by default.\n   */\n  selected?: boolean;\n};\n\n/**\n * Options for creating a mock account with assets or scopes. If `scopes` are\n * not provided, they will be derived from the `assets`.\n *\n * @see BaseMockAccountOptions\n */\nexport type MockAccountOptionsWithAssets = BaseMockAccountOptions & {\n  /**\n   * The assets associated with the account. These should be in CAIP format.\n   */\n  assets: CaipAssetType[];\n\n  /**\n   * The scopes associated with the account. If not provided, they will be\n   * derived from the `assets`.\n   */\n  scopes?: CaipChainId[];\n};\n\n/**\n * Options for creating a mock account with scopes, and optionally assets.\n *\n * @see BaseMockAccountOptions\n */\nexport type MockAccountOptionsWithScopes = BaseMockAccountOptions & {\n  /**\n   * The scopes associated with the account. These should be in CAIP format.\n   */\n  scopes: CaipChainId[];\n\n  /**\n   * The assets associated with the account. If not provided, it will default\n   * to an empty array.\n   */\n  assets?: CaipAssetType[];\n};\n\nexport type GetMockAccountOptions =\n  | MockAccountOptionsWithAssets\n  | MockAccountOptionsWithScopes;\n\n/**\n * Get a mock account object for testing purposes.\n *\n * @param options - The options for creating the mock account.\n * @param options.address - The address of the account.\n * @param options.scopes - The scopes associated with the account, in CAIP\n * format. If not provided, they will be derived from the `assets`.\n * @param options.assets - The assets associated with the account, in CAIP\n * format. If not provided, it will default to an empty array.\n * @param options.selected - Whether the account is selected by default.\n * @param options.id - The ID of the account. If not provided, a pseudo-random\n * UUID will be generated.\n * @returns A mock account object with the specified properties.\n */\nexport function getMockAccount({\n  address,\n  assets = [],\n  selected = false,\n  id = getPseudoRandomUuid(),\n  scopes = getScopesFromAssets(assets),\n}: GetMockAccountOptions): SimulationAccount {\n  return {\n    address,\n    id,\n    scopes,\n    selected,\n    assets,\n  };\n}\n"]}

package/dist/helpers.d.cts

@@ -1,6 +1,7 @@
 import type { AbstractExecutionService } from "@metamask/snaps-controllers";
-import type { SnapId } from "@metamask/snaps-sdk";
-import type { InstallSnapOptions, Snap } from "@metamask/snaps-simulation";
+import type { AccountSelectorState, AssetSelectorState, SnapId } from "@metamask/snaps-sdk";
+import type { InstallSnapOptions, SimulationAccount, SimulationAsset, Snap } from "@metamask/snaps-simulation";
+import type { CaipAssetType, CaipChainId } from "@metamask/utils";
 /**
  * Load a snap into the environment. This is the main entry point for testing
  * snaps: It returns a {@link Snap} object that can be used to interact with the
@@ -86,4 +87,86 @@ export declare function installSnap<Service extends new (...args: any[]) => Inst
  * @throws If the built-in server is not running, and no snap ID is provided.
  */
 export declare function installSnap<Service extends new (...args: any[]) => InstanceType<typeof AbstractExecutionService>>(snapId: SnapId, options?: Partial<InstallSnapOptions<Service>>): Promise<Snap>;
+/**
+ * Get the state of an AccountSelector based on a {@link SimulationAccount}.
+ *
+ * @param account - The {@link SimulationAccount} to get the state from.
+ * @returns The state of the AccountSelector.
+ */
+export declare function getStateFromAccount(account: SimulationAccount): AccountSelectorState;
+/**
+ * Get the state of an AssetSelector based on a {@link SimulationAsset}.
+ *
+ * @param id - The Asset id as a CAIP-19 asset type.
+ * @param assets - The {@link SimulationAsset} to get the state from.
+ * @returns The state of the AssetSelector.
+ */
+export declare function getStateFromAsset(id: CaipAssetType, assets: Record<CaipAssetType, SimulationAsset>): AssetSelectorState;
+/**
+ * The base options for the {@link getMockAccount} function.
+ */
+export type BaseMockAccountOptions = {
+    /**
+     * The address of the account.
+     */
+    address: string;
+    /**
+     * The ID of the account. If not provided, a pseudo-random UUID will be
+     * generated.
+     */
+    id?: string;
+    /**
+     * Whether the account is selected by default.
+     */
+    selected?: boolean;
+};
+/**
+ * Options for creating a mock account with assets or scopes. If `scopes` are
+ * not provided, they will be derived from the `assets`.
+ *
+ * @see BaseMockAccountOptions
+ */
+export type MockAccountOptionsWithAssets = BaseMockAccountOptions & {
+    /**
+     * The assets associated with the account. These should be in CAIP format.
+     */
+    assets: CaipAssetType[];
+    /**
+     * The scopes associated with the account. If not provided, they will be
+     * derived from the `assets`.
+     */
+    scopes?: CaipChainId[];
+};
+/**
+ * Options for creating a mock account with scopes, and optionally assets.
+ *
+ * @see BaseMockAccountOptions
+ */
+export type MockAccountOptionsWithScopes = BaseMockAccountOptions & {
+    /**
+     * The scopes associated with the account. These should be in CAIP format.
+     */
+    scopes: CaipChainId[];
+    /**
+     * The assets associated with the account. If not provided, it will default
+     * to an empty array.
+     */
+    assets?: CaipAssetType[];
+};
+export type GetMockAccountOptions = MockAccountOptionsWithAssets | MockAccountOptionsWithScopes;
+/**
+ * Get a mock account object for testing purposes.
+ *
+ * @param options - The options for creating the mock account.
+ * @param options.address - The address of the account.
+ * @param options.scopes - The scopes associated with the account, in CAIP
+ * format. If not provided, they will be derived from the `assets`.
+ * @param options.assets - The assets associated with the account, in CAIP
+ * format. If not provided, it will default to an empty array.
+ * @param options.selected - Whether the account is selected by default.
+ * @param options.id - The ID of the account. If not provided, a pseudo-random
+ * UUID will be generated.
+ * @returns A mock account object with the specified properties.
+ */
+export declare function getMockAccount({ address, assets, selected, id, scopes, }: GetMockAccountOptions): SimulationAccount;
 //# sourceMappingURL=helpers.d.cts.map

package/dist/helpers.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"helpers.d.cts","sourceRoot":"","sources":["../src/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,oCAAoC;AAC5E,OAAO,KAAK,EAAE,MAAM,EAAE,4BAA4B;AAClD,OAAO,KAAK,EAAE,kBAAkB,EAAE,IAAI,EAAE,mCAAmC;AA8B3E;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;AAEnD;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAsB,WAAW,CAC/B,OAAO,SAAS,KACd,GAAG,IAAI,EAAE,GAAG,EAAE,KACX,YAAY,CAAC,OAAO,wBAAwB,CAAC,EAClD,OAAO,EAAE,OAAO,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAEhE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAsB,WAAW,CAC/B,OAAO,SAAS,KACd,GAAG,IAAI,EAAE,GAAG,EAAE,KACX,YAAY,CAAC,OAAO,wBAAwB,CAAC,EAElD,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC,GAC7C,OAAO,CAAC,IAAI,CAAC,CAAC"}
+{"version":3,"file":"helpers.d.cts","sourceRoot":"","sources":["../src/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,oCAAoC;AAC5E,OAAO,KAAK,EACV,oBAAoB,EACpB,kBAAkB,EAClB,MAAM,EACP,4BAA4B;AAC7B,OAAO,KAAK,EACV,kBAAkB,EAClB,iBAAiB,EACjB,eAAe,EACf,IAAI,EACL,mCAAmC;AAGpC,OAAO,KAAK,EAEV,aAAa,EACb,WAAW,EACZ,wBAAwB;AAiCzB;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;AAEnD;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAsB,WAAW,CAC/B,OAAO,SAAS,KACd,GAAG,IAAI,EAAE,GAAG,EAAE,KACX,YAAY,CAAC,OAAO,wBAAwB,CAAC,EAClD,OAAO,EAAE,OAAO,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAEhE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAsB,WAAW,CAC/B,OAAO,SAAS,KACd,GAAG,IAAI,EAAE,GAAG,EAAE,KACX,YAAY,CAAC,OAAO,wBAAwB,CAAC,EAElD,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC,GAC7C,OAAO,CAAC,IAAI,CAAC,CAAC;AAkGjB;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,iBAAiB,GACzB,oBAAoB,CAMtB;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,EAAE,EAAE,aAAa,EACjB,MAAM,EAAE,MAAM,CAAC,aAAa,EAAE,eAAe,CAAC,GAC7C,kBAAkB,CAYpB;AASD;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG;IACnC;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,EAAE,CAAC,EAAE,MAAM,CAAC;IAEZ;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,4BAA4B,GAAG,sBAAsB,GAAG;IAClE;;OAEG;IACH,MAAM,EAAE,aAAa,EAAE,CAAC;IAExB;;;OAGG;IACH,MAAM,CAAC,EAAE,WAAW,EAAE,CAAC;CACxB,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,4BAA4B,GAAG,sBAAsB,GAAG;IAClE;;OAEG;IACH,MAAM,EAAE,WAAW,EAAE,CAAC;IAEtB;;;OAGG;IACH,MAAM,CAAC,EAAE,aAAa,EAAE,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAC7B,4BAA4B,GAC5B,4BAA4B,CAAC;AAEjC;;;;;;;;;;;;;GAaG;AACH,wBAAgB,cAAc,CAAC,EAC7B,OAAO,EACP,MAAW,EACX,QAAgB,EAChB,EAA0B,EAC1B,MAAoC,GACrC,EAAE,qBAAqB,GAAG,iBAAiB,CAQ3C"}

package/dist/helpers.d.mts

@@ -1,6 +1,7 @@
 import type { AbstractExecutionService } from "@metamask/snaps-controllers";
-import type { SnapId } from "@metamask/snaps-sdk";
-import type { InstallSnapOptions, Snap } from "@metamask/snaps-simulation";
+import type { AccountSelectorState, AssetSelectorState, SnapId } from "@metamask/snaps-sdk";
+import type { InstallSnapOptions, SimulationAccount, SimulationAsset, Snap } from "@metamask/snaps-simulation";
+import type { CaipAssetType, CaipChainId } from "@metamask/utils";
 /**
  * Load a snap into the environment. This is the main entry point for testing
  * snaps: It returns a {@link Snap} object that can be used to interact with the
@@ -86,4 +87,86 @@ export declare function installSnap<Service extends new (...args: any[]) => Inst
  * @throws If the built-in server is not running, and no snap ID is provided.
  */
 export declare function installSnap<Service extends new (...args: any[]) => InstanceType<typeof AbstractExecutionService>>(snapId: SnapId, options?: Partial<InstallSnapOptions<Service>>): Promise<Snap>;
+/**
+ * Get the state of an AccountSelector based on a {@link SimulationAccount}.
+ *
+ * @param account - The {@link SimulationAccount} to get the state from.
+ * @returns The state of the AccountSelector.
+ */
+export declare function getStateFromAccount(account: SimulationAccount): AccountSelectorState;
+/**
+ * Get the state of an AssetSelector based on a {@link SimulationAsset}.
+ *
+ * @param id - The Asset id as a CAIP-19 asset type.
+ * @param assets - The {@link SimulationAsset} to get the state from.
+ * @returns The state of the AssetSelector.
+ */
+export declare function getStateFromAsset(id: CaipAssetType, assets: Record<CaipAssetType, SimulationAsset>): AssetSelectorState;
+/**
+ * The base options for the {@link getMockAccount} function.
+ */
+export type BaseMockAccountOptions = {
+    /**
+     * The address of the account.
+     */
+    address: string;
+    /**
+     * The ID of the account. If not provided, a pseudo-random UUID will be
+     * generated.
+     */
+    id?: string;
+    /**
+     * Whether the account is selected by default.
+     */
+    selected?: boolean;
+};
+/**
+ * Options for creating a mock account with assets or scopes. If `scopes` are
+ * not provided, they will be derived from the `assets`.
+ *
+ * @see BaseMockAccountOptions
+ */
+export type MockAccountOptionsWithAssets = BaseMockAccountOptions & {
+    /**
+     * The assets associated with the account. These should be in CAIP format.
+     */
+    assets: CaipAssetType[];
+    /**
+     * The scopes associated with the account. If not provided, they will be
+     * derived from the `assets`.
+     */
+    scopes?: CaipChainId[];
+};
+/**
+ * Options for creating a mock account with scopes, and optionally assets.
+ *
+ * @see BaseMockAccountOptions
+ */
+export type MockAccountOptionsWithScopes = BaseMockAccountOptions & {
+    /**
+     * The scopes associated with the account. These should be in CAIP format.
+     */
+    scopes: CaipChainId[];
+    /**
+     * The assets associated with the account. If not provided, it will default
+     * to an empty array.
+     */
+    assets?: CaipAssetType[];
+};
+export type GetMockAccountOptions = MockAccountOptionsWithAssets | MockAccountOptionsWithScopes;
+/**
+ * Get a mock account object for testing purposes.
+ *
+ * @param options - The options for creating the mock account.
+ * @param options.address - The address of the account.
+ * @param options.scopes - The scopes associated with the account, in CAIP
+ * format. If not provided, they will be derived from the `assets`.
+ * @param options.assets - The assets associated with the account, in CAIP
+ * format. If not provided, it will default to an empty array.
+ * @param options.selected - Whether the account is selected by default.
+ * @param options.id - The ID of the account. If not provided, a pseudo-random
+ * UUID will be generated.
+ * @returns A mock account object with the specified properties.
+ */
+export declare function getMockAccount({ address, assets, selected, id, scopes, }: GetMockAccountOptions): SimulationAccount;
 //# sourceMappingURL=helpers.d.mts.map

package/dist/helpers.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"helpers.d.mts","sourceRoot":"","sources":["../src/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,oCAAoC;AAC5E,OAAO,KAAK,EAAE,MAAM,EAAE,4BAA4B;AAClD,OAAO,KAAK,EAAE,kBAAkB,EAAE,IAAI,EAAE,mCAAmC;AA8B3E;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;AAEnD;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAsB,WAAW,CAC/B,OAAO,SAAS,KACd,GAAG,IAAI,EAAE,GAAG,EAAE,KACX,YAAY,CAAC,OAAO,wBAAwB,CAAC,EAClD,OAAO,EAAE,OAAO,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAEhE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAsB,WAAW,CAC/B,OAAO,SAAS,KACd,GAAG,IAAI,EAAE,GAAG,EAAE,KACX,YAAY,CAAC,OAAO,wBAAwB,CAAC,EAElD,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC,GAC7C,OAAO,CAAC,IAAI,CAAC,CAAC"}
+{"version":3,"file":"helpers.d.mts","sourceRoot":"","sources":["../src/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,oCAAoC;AAC5E,OAAO,KAAK,EACV,oBAAoB,EACpB,kBAAkB,EAClB,MAAM,EACP,4BAA4B;AAC7B,OAAO,KAAK,EACV,kBAAkB,EAClB,iBAAiB,EACjB,eAAe,EACf,IAAI,EACL,mCAAmC;AAGpC,OAAO,KAAK,EAEV,aAAa,EACb,WAAW,EACZ,wBAAwB;AAiCzB;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;AAEnD;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAsB,WAAW,CAC/B,OAAO,SAAS,KACd,GAAG,IAAI,EAAE,GAAG,EAAE,KACX,YAAY,CAAC,OAAO,wBAAwB,CAAC,EAClD,OAAO,EAAE,OAAO,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAEhE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAsB,WAAW,CAC/B,OAAO,SAAS,KACd,GAAG,IAAI,EAAE,GAAG,EAAE,KACX,YAAY,CAAC,OAAO,wBAAwB,CAAC,EAElD,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC,GAC7C,OAAO,CAAC,IAAI,CAAC,CAAC;AAkGjB;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,iBAAiB,GACzB,oBAAoB,CAMtB;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,EAAE,EAAE,aAAa,EACjB,MAAM,EAAE,MAAM,CAAC,aAAa,EAAE,eAAe,CAAC,GAC7C,kBAAkB,CAYpB;AASD;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG;IACnC;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,EAAE,CAAC,EAAE,MAAM,CAAC;IAEZ;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,4BAA4B,GAAG,sBAAsB,GAAG;IAClE;;OAEG;IACH,MAAM,EAAE,aAAa,EAAE,CAAC;IAExB;;;OAGG;IACH,MAAM,CAAC,EAAE,WAAW,EAAE,CAAC;CACxB,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,4BAA4B,GAAG,sBAAsB,GAAG;IAClE;;OAEG;IACH,MAAM,EAAE,WAAW,EAAE,CAAC;IAEtB;;;OAGG;IACH,MAAM,CAAC,EAAE,aAAa,EAAE,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAC7B,4BAA4B,GAC5B,4BAA4B,CAAC;AAEjC;;;;;;;;;;;;;GAaG;AACH,wBAAgB,cAAc,CAAC,EAC7B,OAAO,EACP,MAAW,EACX,QAAgB,EAChB,EAA0B,EAC1B,MAAoC,GACrC,EAAE,qBAAqB,GAAG,iBAAiB,CAQ3C"}

package/dist/helpers.mjs

@@ -1,6 +1,6 @@
 import { logInfo } from "@metamask/snaps-utils";
-import { createModuleLogger } from "@metamask/utils";
-import { rootLogger, getEnvironment } from "./internals/index.mjs";
+import { assert, createModuleLogger } from "@metamask/utils";
+import { rootLogger, getEnvironment, getPseudoRandomUuidGenerator, getScopesFromAssets } from "./internals/index.mjs";
 const log = createModuleLogger(rootLogger, 'helpers');
 /**
  * Get the options for {@link installSnap}.
@@ -52,7 +52,7 @@ export async function installSnap(snapId, options = {}) {
     // TODO: Either fix this lint violation or explain why it's necessary to
     //  ignore.
     /* eslint-disable @typescript-eslint/unbound-method */
-    const { request, onTransaction, sendTransaction, onSignature, onCronjob, runCronjob, onBackgroundEvent, onHomePage, onSettingsPage, onKeyringRequest, onInstall, onUpdate, onNameLookup, onProtocolRequest, onClientRequest, mockJsonRpc, close, } = await getEnvironment().installSnap(...resolvedOptions);
+    const { request, onTransaction, sendTransaction, onSignature, onCronjob, runCronjob, onBackgroundEvent, onHomePage, onSettingsPage, onKeyringRequest, onInstall, onUpdate, onStart, onNameLookup, onProtocolRequest, onClientRequest, mockJsonRpc, close, } = await getEnvironment().installSnap(...resolvedOptions);
     /* eslint-enable @typescript-eslint/unbound-method */
     return {
         request,
@@ -67,6 +67,7 @@ export async function installSnap(snapId, options = {}) {
         onKeyringRequest,
         onInstall,
         onUpdate,
+        onStart,
         onNameLookup,
         onProtocolRequest,
         onClientRequest,
@@ -78,4 +79,63 @@ export async function installSnap(snapId, options = {}) {
         },
     };
 }
+/**
+ * Get the state of an AccountSelector based on a {@link SimulationAccount}.
+ *
+ * @param account - The {@link SimulationAccount} to get the state from.
+ * @returns The state of the AccountSelector.
+ */
+export function getStateFromAccount(account) {
+    const { address, scopes } = account;
+    return {
+        addresses: scopes.map((scope) => `${scope}:${address}`),
+        accountId: account.id,
+    };
+}
+/**
+ * Get the state of an AssetSelector based on a {@link SimulationAsset}.
+ *
+ * @param id - The Asset id as a CAIP-19 asset type.
+ * @param assets - The {@link SimulationAsset} to get the state from.
+ * @returns The state of the AssetSelector.
+ */
+export function getStateFromAsset(id, assets) {
+    const asset = assets[id];
+    assert(asset, `Asset with ID "${id}" not found in simulation assets.`);
+    const { symbol, name } = asset;
+    return {
+        asset: id,
+        symbol,
+        name,
+    };
+}
+/**
+ * Generate a pseudo-random UUID.
+ *
+ * @returns A pseudo-random UUID string.
+ */
+const getPseudoRandomUuid = getPseudoRandomUuidGenerator();
+/**
+ * Get a mock account object for testing purposes.
+ *
+ * @param options - The options for creating the mock account.
+ * @param options.address - The address of the account.
+ * @param options.scopes - The scopes associated with the account, in CAIP
+ * format. If not provided, they will be derived from the `assets`.
+ * @param options.assets - The assets associated with the account, in CAIP
+ * format. If not provided, it will default to an empty array.
+ * @param options.selected - Whether the account is selected by default.
+ * @param options.id - The ID of the account. If not provided, a pseudo-random
+ * UUID will be generated.
+ * @returns A mock account object with the specified properties.
+ */
+export function getMockAccount({ address, assets = [], selected = false, id = getPseudoRandomUuid(), scopes = getScopesFromAssets(assets), }) {
+    return {
+        address,
+        id,
+        scopes,
+        selected,
+        assets,
+    };
+}
 //# sourceMappingURL=helpers.mjs.map

package/dist/helpers.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"helpers.mjs","sourceRoot":"","sources":["../src/helpers.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,OAAO,EAAE,8BAA8B;AAChD,OAAO,EAAE,kBAAkB,EAAE,wBAAwB;AAErD,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,8BAAoB;AAEzD,MAAM,GAAG,GAAG,kBAAkB,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;AAEtD;;;;;;GAMG;AACH,SAAS,UAAU,CAKjB,MAAiE,EACjE,OAA6C;IAE7C,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC/B,OAAO,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IAC7B,CAAC;IAED,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAC3B,CAAC;AAqGD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAK/B,MAAsD,EACtD,UAAgD,EAAE;IAElD,MAAM,eAAe,GAAG,UAAU,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEpD,wEAAwE;IACxE,WAAW;IACX,sDAAsD;IACtD,MAAM,EACJ,OAAO,EACP,aAAa,EACb,eAAe,EACf,WAAW,EACX,SAAS,EACT,UAAU,EACV,iBAAiB,EACjB,UAAU,EACV,cAAc,EACd,gBAAgB,EAChB,SAAS,EACT,QAAQ,EACR,YAAY,EACZ,iBAAiB,EACjB,eAAe,EACf,WAAW,EACX,KAAK,GACN,GAAG,MAAM,cAAc,EAAE,CAAC,WAAW,CAAC,GAAG,eAAe,CAAC,CAAC;IAC3D,qDAAqD;IAErD,OAAO;QACL,OAAO;QACP,aAAa;QACb,eAAe;QACf,WAAW;QACX,SAAS;QACT,UAAU;QACV,iBAAiB;QACjB,UAAU;QACV,cAAc;QACd,gBAAgB;QAChB,SAAS;QACT,QAAQ;QACR,YAAY;QACZ,iBAAiB;QACjB,eAAe;QACf,WAAW;QACX,KAAK,EAAE,KAAK,IAAI,EAAE;YAChB,GAAG,CAAC,4BAA4B,CAAC,CAAC;YAClC,OAAO,CACL,uIAAuI,CACxI,CAAC;YAEF,MAAM,KAAK,EAAE,CAAC;QAChB,CAAC;KACF,CAAC;AACJ,CAAC","sourcesContent":["import type { AbstractExecutionService } from '@metamask/snaps-controllers';\nimport type { SnapId } from '@metamask/snaps-sdk';\nimport type { InstallSnapOptions, Snap } from '@metamask/snaps-simulation';\nimport { logInfo } from '@metamask/snaps-utils';\nimport { createModuleLogger } from '@metamask/utils';\n\nimport { rootLogger, getEnvironment } from './internals';\n\nconst log = createModuleLogger(rootLogger, 'helpers');\n\n/**\n * Get the options for {@link installSnap}.\n *\n * @param snapId - The ID of the Snap, or the options.\n * @param options - The options, if any.\n * @returns The options.\n */\nfunction getOptions<\n  Service extends new (\n    ...args: any[]\n  ) => InstanceType<typeof AbstractExecutionService>,\n>(\n  snapId: SnapId | Partial<InstallSnapOptions<Service>> | undefined,\n  options: Partial<InstallSnapOptions<Service>>,\n): [SnapId | undefined, Partial<InstallSnapOptions<Service>>] {\n  if (typeof snapId === 'object') {\n    return [undefined, snapId];\n  }\n\n  return [snapId, options];\n}\n\n/**\n * Load a snap into the environment. This is the main entry point for testing\n * snaps: It returns a {@link Snap} object that can be used to interact with the\n * snap.\n *\n * @example\n * import { installSnap } from '@metamask/snaps-jest';\n *\n * describe('My Snap', () => {\n *   it('should do something', async () => {\n *     const { request } = await installSnap('local:my-snap');\n *     const response = await request({\n *       method: 'foo',\n *       params: ['bar'],\n *     });\n *     expect(response).toRespondWith('bar');\n *   });\n * });\n * @returns The snap.\n * @throws If the built-in server is not running, and no snap ID is provided.\n */\nexport async function installSnap(): Promise<Snap>;\n\n/**\n * Load a snap into the environment. This is the main entry point for testing\n * snaps: It returns a {@link Snap} object that can be used to interact with the\n * snap.\n *\n * @example\n * import { installSnap } from '@metamask/snaps-jest';\n *\n * describe('My Snap', () => {\n *   it('should do something', async () => {\n *     const { request } = await installSnap('local:my-snap');\n *     const response = await request({\n *       method: 'foo',\n *       params: ['bar'],\n *     });\n *     expect(response).toRespondWith('bar');\n *   });\n * });\n * @param options - The options to use.\n * @param options.executionService - The execution service to use. Defaults to\n * {@link NodeThreadExecutionService}. You do not need to provide this unless\n * you are testing a custom execution service.\n * @param options.executionServiceOptions - The options to use when creating the\n * execution service, if any. This should only include options specific to the\n * provided execution service.\n * @param options.options - The simulation options.\n * @returns The snap.\n * @throws If the built-in server is not running, and no snap ID is provided.\n */\nexport async function installSnap<\n  Service extends new (\n    ...args: any[]\n  ) => InstanceType<typeof AbstractExecutionService>,\n>(options: Partial<InstallSnapOptions<Service>>): Promise<Snap>;\n\n/**\n * Load a snap into the environment. This is the main entry point for testing\n * snaps: It returns a {@link Snap} object that can be used to interact with the\n * snap.\n *\n * @example\n * import { installSnap } from '@metamask/snaps-jest';\n *\n * describe('My Snap', () => {\n *   it('should do something', async () => {\n *     const { request } = await installSnap('local:my-snap');\n *     const response = await request({\n *       method: 'foo',\n *       params: ['bar'],\n *     });\n *     expect(response).toRespondWith('bar');\n *   });\n * });\n * @param snapId - The ID of the snap, including the prefix (`local:`). Defaults\n * to the URL of the built-in server, if it is running. This supports both\n * local snap IDs and NPM snap IDs.\n * @param options - The options to use.\n * @param options.executionService - The execution service to use. Defaults to\n * {@link NodeThreadExecutionService}. You do not need to provide this unless\n * you are testing a custom execution service.\n * @param options.executionServiceOptions - The options to use when creating the\n * execution service, if any. This should only include options specific to the\n * provided execution service.\n * @param options.options - The simulation options.\n * @returns The snap.\n * @throws If the built-in server is not running, and no snap ID is provided.\n */\nexport async function installSnap<\n  Service extends new (\n    ...args: any[]\n  ) => InstanceType<typeof AbstractExecutionService>,\n>(\n  snapId: SnapId,\n  options?: Partial<InstallSnapOptions<Service>>,\n): Promise<Snap>;\n\n/**\n * Load a snap into the environment. This is the main entry point for testing\n * snaps: It returns a {@link Snap} object that can be used to interact with the\n * snap.\n *\n * @example\n * import { installSnap } from '@metamask/snaps-jest';\n *\n * describe('My Snap', () => {\n *   it('should do something', async () => {\n *     const { request } = await installSnap('local:my-snap');\n *     const response = await request({\n *       method: 'foo',\n *       params: ['bar'],\n *     });\n *     expect(response).toRespondWith('bar');\n *   });\n * });\n * @param snapId - The ID of the snap, including the prefix (`local:`). Defaults\n * to the URL of the built-in server, if it is running. This supports both\n * local snap IDs and NPM snap IDs.\n * @param options - The options to use.\n * @param options.executionService - The execution service to use. Defaults to\n * {@link NodeThreadExecutionService}. You do not need to provide this unless\n * you are testing a custom execution service.\n * @param options.executionServiceOptions - The options to use when creating the\n * execution service, if any. This should only include options specific to the\n * provided execution service.\n * @param options.options - The simulation options.\n * @returns The snap.\n * @throws If the built-in server is not running, and no snap ID is provided.\n */\nexport async function installSnap<\n  Service extends new (\n    ...args: any[]\n  ) => InstanceType<typeof AbstractExecutionService>,\n>(\n  snapId?: SnapId | Partial<InstallSnapOptions<Service>>,\n  options: Partial<InstallSnapOptions<Service>> = {},\n): Promise<Snap> {\n  const resolvedOptions = getOptions(snapId, options);\n\n  // TODO: Either fix this lint violation or explain why it's necessary to\n  //  ignore.\n  /* eslint-disable @typescript-eslint/unbound-method */\n  const {\n    request,\n    onTransaction,\n    sendTransaction,\n    onSignature,\n    onCronjob,\n    runCronjob,\n    onBackgroundEvent,\n    onHomePage,\n    onSettingsPage,\n    onKeyringRequest,\n    onInstall,\n    onUpdate,\n    onNameLookup,\n    onProtocolRequest,\n    onClientRequest,\n    mockJsonRpc,\n    close,\n  } = await getEnvironment().installSnap(...resolvedOptions);\n  /* eslint-enable @typescript-eslint/unbound-method */\n\n  return {\n    request,\n    onTransaction,\n    sendTransaction,\n    onSignature,\n    onCronjob,\n    runCronjob,\n    onBackgroundEvent,\n    onHomePage,\n    onSettingsPage,\n    onKeyringRequest,\n    onInstall,\n    onUpdate,\n    onNameLookup,\n    onProtocolRequest,\n    onClientRequest,\n    mockJsonRpc,\n    close: async () => {\n      log('Closing execution service.');\n      logInfo(\n        'Calling `snap.close()` is deprecated, and will be removed in a future release. Snaps are now automatically closed when the test ends.',\n      );\n\n      await close();\n    },\n  };\n}\n"]}
+{"version":3,"file":"helpers.mjs","sourceRoot":"","sources":["../src/helpers.ts"],"names":[],"mappings":"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","sourcesContent":["import type { AbstractExecutionService } from '@metamask/snaps-controllers';\nimport type {\n  AccountSelectorState,\n  AssetSelectorState,\n  SnapId,\n} from '@metamask/snaps-sdk';\nimport type {\n  InstallSnapOptions,\n  SimulationAccount,\n  SimulationAsset,\n  Snap,\n} from '@metamask/snaps-simulation';\nimport { logInfo } from '@metamask/snaps-utils';\nimport { assert, createModuleLogger } from '@metamask/utils';\nimport type {\n  CaipAccountId,\n  CaipAssetType,\n  CaipChainId,\n} from '@metamask/utils';\n\nimport {\n  rootLogger,\n  getEnvironment,\n  getPseudoRandomUuidGenerator,\n  getScopesFromAssets,\n} from './internals';\n\nconst log = createModuleLogger(rootLogger, 'helpers');\n\n/**\n * Get the options for {@link installSnap}.\n *\n * @param snapId - The ID of the Snap, or the options.\n * @param options - The options, if any.\n * @returns The options.\n */\nfunction getOptions<\n  Service extends new (\n    ...args: any[]\n  ) => InstanceType<typeof AbstractExecutionService>,\n>(\n  snapId: SnapId | Partial<InstallSnapOptions<Service>> | undefined,\n  options: Partial<InstallSnapOptions<Service>>,\n): [SnapId | undefined, Partial<InstallSnapOptions<Service>>] {\n  if (typeof snapId === 'object') {\n    return [undefined, snapId];\n  }\n\n  return [snapId, options];\n}\n\n/**\n * Load a snap into the environment. This is the main entry point for testing\n * snaps: It returns a {@link Snap} object that can be used to interact with the\n * snap.\n *\n * @example\n * import { installSnap } from '@metamask/snaps-jest';\n *\n * describe('My Snap', () => {\n *   it('should do something', async () => {\n *     const { request } = await installSnap('local:my-snap');\n *     const response = await request({\n *       method: 'foo',\n *       params: ['bar'],\n *     });\n *     expect(response).toRespondWith('bar');\n *   });\n * });\n * @returns The snap.\n * @throws If the built-in server is not running, and no snap ID is provided.\n */\nexport async function installSnap(): Promise<Snap>;\n\n/**\n * Load a snap into the environment. This is the main entry point for testing\n * snaps: It returns a {@link Snap} object that can be used to interact with the\n * snap.\n *\n * @example\n * import { installSnap } from '@metamask/snaps-jest';\n *\n * describe('My Snap', () => {\n *   it('should do something', async () => {\n *     const { request } = await installSnap('local:my-snap');\n *     const response = await request({\n *       method: 'foo',\n *       params: ['bar'],\n *     });\n *     expect(response).toRespondWith('bar');\n *   });\n * });\n * @param options - The options to use.\n * @param options.executionService - The execution service to use. Defaults to\n * {@link NodeThreadExecutionService}. You do not need to provide this unless\n * you are testing a custom execution service.\n * @param options.executionServiceOptions - The options to use when creating the\n * execution service, if any. This should only include options specific to the\n * provided execution service.\n * @param options.options - The simulation options.\n * @returns The snap.\n * @throws If the built-in server is not running, and no snap ID is provided.\n */\nexport async function installSnap<\n  Service extends new (\n    ...args: any[]\n  ) => InstanceType<typeof AbstractExecutionService>,\n>(options: Partial<InstallSnapOptions<Service>>): Promise<Snap>;\n\n/**\n * Load a snap into the environment. This is the main entry point for testing\n * snaps: It returns a {@link Snap} object that can be used to interact with the\n * snap.\n *\n * @example\n * import { installSnap } from '@metamask/snaps-jest';\n *\n * describe('My Snap', () => {\n *   it('should do something', async () => {\n *     const { request } = await installSnap('local:my-snap');\n *     const response = await request({\n *       method: 'foo',\n *       params: ['bar'],\n *     });\n *     expect(response).toRespondWith('bar');\n *   });\n * });\n * @param snapId - The ID of the snap, including the prefix (`local:`). Defaults\n * to the URL of the built-in server, if it is running. This supports both\n * local snap IDs and NPM snap IDs.\n * @param options - The options to use.\n * @param options.executionService - The execution service to use. Defaults to\n * {@link NodeThreadExecutionService}. You do not need to provide this unless\n * you are testing a custom execution service.\n * @param options.executionServiceOptions - The options to use when creating the\n * execution service, if any. This should only include options specific to the\n * provided execution service.\n * @param options.options - The simulation options.\n * @returns The snap.\n * @throws If the built-in server is not running, and no snap ID is provided.\n */\nexport async function installSnap<\n  Service extends new (\n    ...args: any[]\n  ) => InstanceType<typeof AbstractExecutionService>,\n>(\n  snapId: SnapId,\n  options?: Partial<InstallSnapOptions<Service>>,\n): Promise<Snap>;\n\n/**\n * Load a snap into the environment. This is the main entry point for testing\n * snaps: It returns a {@link Snap} object that can be used to interact with the\n * snap.\n *\n * @example\n * import { installSnap } from '@metamask/snaps-jest';\n *\n * describe('My Snap', () => {\n *   it('should do something', async () => {\n *     const { request } = await installSnap('local:my-snap');\n *     const response = await request({\n *       method: 'foo',\n *       params: ['bar'],\n *     });\n *     expect(response).toRespondWith('bar');\n *   });\n * });\n * @param snapId - The ID of the snap, including the prefix (`local:`). Defaults\n * to the URL of the built-in server, if it is running. This supports both\n * local snap IDs and NPM snap IDs.\n * @param options - The options to use.\n * @param options.executionService - The execution service to use. Defaults to\n * {@link NodeThreadExecutionService}. You do not need to provide this unless\n * you are testing a custom execution service.\n * @param options.executionServiceOptions - The options to use when creating the\n * execution service, if any. This should only include options specific to the\n * provided execution service.\n * @param options.options - The simulation options.\n * @returns The snap.\n * @throws If the built-in server is not running, and no snap ID is provided.\n */\nexport async function installSnap<\n  Service extends new (\n    ...args: any[]\n  ) => InstanceType<typeof AbstractExecutionService>,\n>(\n  snapId?: SnapId | Partial<InstallSnapOptions<Service>>,\n  options: Partial<InstallSnapOptions<Service>> = {},\n): Promise<Snap> {\n  const resolvedOptions = getOptions(snapId, options);\n\n  // TODO: Either fix this lint violation or explain why it's necessary to\n  //  ignore.\n  /* eslint-disable @typescript-eslint/unbound-method */\n  const {\n    request,\n    onTransaction,\n    sendTransaction,\n    onSignature,\n    onCronjob,\n    runCronjob,\n    onBackgroundEvent,\n    onHomePage,\n    onSettingsPage,\n    onKeyringRequest,\n    onInstall,\n    onUpdate,\n    onStart,\n    onNameLookup,\n    onProtocolRequest,\n    onClientRequest,\n    mockJsonRpc,\n    close,\n  } = await getEnvironment().installSnap(...resolvedOptions);\n  /* eslint-enable @typescript-eslint/unbound-method */\n\n  return {\n    request,\n    onTransaction,\n    sendTransaction,\n    onSignature,\n    onCronjob,\n    runCronjob,\n    onBackgroundEvent,\n    onHomePage,\n    onSettingsPage,\n    onKeyringRequest,\n    onInstall,\n    onUpdate,\n    onStart,\n    onNameLookup,\n    onProtocolRequest,\n    onClientRequest,\n    mockJsonRpc,\n    close: async () => {\n      log('Closing execution service.');\n      logInfo(\n        'Calling `snap.close()` is deprecated, and will be removed in a future release. Snaps are now automatically closed when the test ends.',\n      );\n\n      await close();\n    },\n  };\n}\n\n/**\n * Get the state of an AccountSelector based on a {@link SimulationAccount}.\n *\n * @param account - The {@link SimulationAccount} to get the state from.\n * @returns The state of the AccountSelector.\n */\nexport function getStateFromAccount(\n  account: SimulationAccount,\n): AccountSelectorState {\n  const { address, scopes } = account;\n  return {\n    addresses: scopes.map((scope) => `${scope}:${address}`) as CaipAccountId[],\n    accountId: account.id,\n  };\n}\n\n/**\n * Get the state of an AssetSelector based on a {@link SimulationAsset}.\n *\n * @param id - The Asset id as a CAIP-19 asset type.\n * @param assets - The {@link SimulationAsset} to get the state from.\n * @returns The state of the AssetSelector.\n */\nexport function getStateFromAsset(\n  id: CaipAssetType,\n  assets: Record<CaipAssetType, SimulationAsset>,\n): AssetSelectorState {\n  const asset = assets[id];\n\n  assert(asset, `Asset with ID \"${id}\" not found in simulation assets.`);\n\n  const { symbol, name } = asset;\n\n  return {\n    asset: id,\n    symbol,\n    name,\n  };\n}\n\n/**\n * Generate a pseudo-random UUID.\n *\n * @returns A pseudo-random UUID string.\n */\nconst getPseudoRandomUuid = getPseudoRandomUuidGenerator();\n\n/**\n * The base options for the {@link getMockAccount} function.\n */\nexport type BaseMockAccountOptions = {\n  /**\n   * The address of the account.\n   */\n  address: string;\n\n  /**\n   * The ID of the account. If not provided, a pseudo-random UUID will be\n   * generated.\n   */\n  id?: string;\n\n  /**\n   * Whether the account is selected by default.\n   */\n  selected?: boolean;\n};\n\n/**\n * Options for creating a mock account with assets or scopes. If `scopes` are\n * not provided, they will be derived from the `assets`.\n *\n * @see BaseMockAccountOptions\n */\nexport type MockAccountOptionsWithAssets = BaseMockAccountOptions & {\n  /**\n   * The assets associated with the account. These should be in CAIP format.\n   */\n  assets: CaipAssetType[];\n\n  /**\n   * The scopes associated with the account. If not provided, they will be\n   * derived from the `assets`.\n   */\n  scopes?: CaipChainId[];\n};\n\n/**\n * Options for creating a mock account with scopes, and optionally assets.\n *\n * @see BaseMockAccountOptions\n */\nexport type MockAccountOptionsWithScopes = BaseMockAccountOptions & {\n  /**\n   * The scopes associated with the account. These should be in CAIP format.\n   */\n  scopes: CaipChainId[];\n\n  /**\n   * The assets associated with the account. If not provided, it will default\n   * to an empty array.\n   */\n  assets?: CaipAssetType[];\n};\n\nexport type GetMockAccountOptions =\n  | MockAccountOptionsWithAssets\n  | MockAccountOptionsWithScopes;\n\n/**\n * Get a mock account object for testing purposes.\n *\n * @param options - The options for creating the mock account.\n * @param options.address - The address of the account.\n * @param options.scopes - The scopes associated with the account, in CAIP\n * format. If not provided, they will be derived from the `assets`.\n * @param options.assets - The assets associated with the account, in CAIP\n * format. If not provided, it will default to an empty array.\n * @param options.selected - Whether the account is selected by default.\n * @param options.id - The ID of the account. If not provided, a pseudo-random\n * UUID will be generated.\n * @returns A mock account object with the specified properties.\n */\nexport function getMockAccount({\n  address,\n  assets = [],\n  selected = false,\n  id = getPseudoRandomUuid(),\n  scopes = getScopesFromAssets(assets),\n}: GetMockAccountOptions): SimulationAccount {\n  return {\n    address,\n    id,\n    scopes,\n    selected,\n    assets,\n  };\n}\n"]}

package/dist/internals/accounts.cjs

@@ -0,0 +1,50 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getScopesFromAssets = exports.getPseudoRandomUuidGenerator = void 0;
+const utils_1 = require("@metamask/utils");
+const crypto_1 = require("crypto");
+/**
+ * Get a function that generates pseudo-random UUIDs. This function uses a
+ * counter to generate a unique UUID each time it is called.
+ *
+ * This is likely not suitable for production use, as it does not guarantee
+ * true randomness and is not cryptographically secure. It is intended for
+ * testing and mock purposes only.
+ *
+ * @returns A function that generates a pseudo-random UUID.
+ */
+function getPseudoRandomUuidGenerator() {
+    let counter = 0;
+    return () => {
+        const bytes = (0, crypto_1.createHash)('sha256')
+            .update(`${counter}`)
+            .digest()
+            .subarray(0, 16);
+        /* eslint-disable no-bitwise */
+        bytes[6] = (bytes[6] & 0x0f) | 0x40;
+        bytes[8] = (bytes[8] & 0x3f) | 0x80;
+        /* eslint-enable no-bitwise */
+        counter += 1;
+        return (bytes
+            .toString('hex')
+            .match(/.{1,8}/gu)
+            ?.join('-') ?? '');
+    };
+}
+exports.getPseudoRandomUuidGenerator = getPseudoRandomUuidGenerator;
+/**
+ * Get unique scopes from a list of assets. This assumes the assets are in
+ * CAIP format, where the chain ID is the first part of the asset type.
+ *
+ * @param assets - An array of CAIP asset types.
+ * @returns An array of unique CAIP chain IDs derived from the assets.
+ */
+function getScopesFromAssets(assets = []) {
+    const scopes = assets.map((asset) => {
+        const { chainId } = (0, utils_1.parseCaipAssetType)(asset);
+        return chainId;
+    });
+    return Array.from(new Set(scopes));
+}
+exports.getScopesFromAssets = getScopesFromAssets;
+//# sourceMappingURL=accounts.cjs.map

package/dist/internals/accounts.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"accounts.cjs","sourceRoot":"","sources":["../../src/internals/accounts.ts"],"names":[],"mappings":";;;AACA,2CAAqD;AACrD,mCAAoC;AAEpC;;;;;;;;;GASG;AACH,SAAgB,4BAA4B;IAC1C,IAAI,OAAO,GAAG,CAAC,CAAC;IAEhB,OAAO,GAAG,EAAE;QACV,MAAM,KAAK,GAAG,IAAA,mBAAU,EAAC,QAAQ,CAAC;aAC/B,MAAM,CAAC,GAAG,OAAO,EAAE,CAAC;aACpB,MAAM,EAAE;aACR,QAAQ,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAEnB,+BAA+B;QAC/B,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;QACpC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;QACpC,8BAA8B;QAE9B,OAAO,IAAI,CAAC,CAAC;QAEb,OAAO,CACL,KAAK;aACF,QAAQ,CAAC,KAAK,CAAC;aACf,KAAK,CAAC,UAAU,CAAC;YAClB,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CACpB,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC;AAvBD,oEAuBC;AAED;;;;;;GAMG;AACH,SAAgB,mBAAmB,CACjC,SAA0B,EAAE;IAE5B,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;QAClC,MAAM,EAAE,OAAO,EAAE,GAAG,IAAA,0BAAkB,EAAC,KAAK,CAAC,CAAC;QAC9C,OAAO,OAAO,CAAC;IACjB,CAAC,CAAC,CAAC;IAEH,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;AACrC,CAAC;AATD,kDASC","sourcesContent":["import type { CaipAssetType, CaipChainId } from '@metamask/utils';\nimport { parseCaipAssetType } from '@metamask/utils';\nimport { createHash } from 'crypto';\n\n/**\n * Get a function that generates pseudo-random UUIDs. This function uses a\n * counter to generate a unique UUID each time it is called.\n *\n * This is likely not suitable for production use, as it does not guarantee\n * true randomness and is not cryptographically secure. It is intended for\n * testing and mock purposes only.\n *\n * @returns A function that generates a pseudo-random UUID.\n */\nexport function getPseudoRandomUuidGenerator() {\n  let counter = 0;\n\n  return () => {\n    const bytes = createHash('sha256')\n      .update(`${counter}`)\n      .digest()\n      .subarray(0, 16);\n\n    /* eslint-disable no-bitwise */\n    bytes[6] = (bytes[6] & 0x0f) | 0x40;\n    bytes[8] = (bytes[8] & 0x3f) | 0x80;\n    /* eslint-enable no-bitwise */\n\n    counter += 1;\n\n    return (\n      bytes\n        .toString('hex')\n        .match(/.{1,8}/gu)\n        ?.join('-') ?? ''\n    );\n  };\n}\n\n/**\n * Get unique scopes from a list of assets. This assumes the assets are in\n * CAIP format, where the chain ID is the first part of the asset type.\n *\n * @param assets - An array of CAIP asset types.\n * @returns An array of unique CAIP chain IDs derived from the assets.\n */\nexport function getScopesFromAssets(\n  assets: CaipAssetType[] = [],\n): CaipChainId[] {\n  const scopes = assets.map((asset) => {\n    const { chainId } = parseCaipAssetType(asset);\n    return chainId;\n  });\n\n  return Array.from(new Set(scopes));\n}\n"]}

package/dist/internals/accounts.d.cts

@@ -0,0 +1,21 @@
+import type { CaipAssetType, CaipChainId } from "@metamask/utils";
+/**
+ * Get a function that generates pseudo-random UUIDs. This function uses a
+ * counter to generate a unique UUID each time it is called.
+ *
+ * This is likely not suitable for production use, as it does not guarantee
+ * true randomness and is not cryptographically secure. It is intended for
+ * testing and mock purposes only.
+ *
+ * @returns A function that generates a pseudo-random UUID.
+ */
+export declare function getPseudoRandomUuidGenerator(): () => string;
+/**
+ * Get unique scopes from a list of assets. This assumes the assets are in
+ * CAIP format, where the chain ID is the first part of the asset type.
+ *
+ * @param assets - An array of CAIP asset types.
+ * @returns An array of unique CAIP chain IDs derived from the assets.
+ */
+export declare function getScopesFromAssets(assets?: CaipAssetType[]): CaipChainId[];
+//# sourceMappingURL=accounts.d.cts.map

package/dist/internals/accounts.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"accounts.d.cts","sourceRoot":"","sources":["../../src/internals/accounts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,wBAAwB;AAIlE;;;;;;;;;GASG;AACH,wBAAgB,4BAA4B,iBAuB3C;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,GAAE,aAAa,EAAO,GAC3B,WAAW,EAAE,CAOf"}

package/dist/internals/accounts.d.mts

@@ -0,0 +1,21 @@
+import type { CaipAssetType, CaipChainId } from "@metamask/utils";
+/**
+ * Get a function that generates pseudo-random UUIDs. This function uses a
+ * counter to generate a unique UUID each time it is called.
+ *
+ * This is likely not suitable for production use, as it does not guarantee
+ * true randomness and is not cryptographically secure. It is intended for
+ * testing and mock purposes only.
+ *
+ * @returns A function that generates a pseudo-random UUID.
+ */
+export declare function getPseudoRandomUuidGenerator(): () => string;
+/**
+ * Get unique scopes from a list of assets. This assumes the assets are in
+ * CAIP format, where the chain ID is the first part of the asset type.
+ *
+ * @param assets - An array of CAIP asset types.
+ * @returns An array of unique CAIP chain IDs derived from the assets.
+ */
+export declare function getScopesFromAssets(assets?: CaipAssetType[]): CaipChainId[];
+//# sourceMappingURL=accounts.d.mts.map

package/dist/internals/accounts.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"accounts.d.mts","sourceRoot":"","sources":["../../src/internals/accounts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,wBAAwB;AAIlE;;;;;;;;;GASG;AACH,wBAAgB,4BAA4B,iBAuB3C;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,GAAE,aAAa,EAAO,GAC3B,WAAW,EAAE,CAOf"}

package/dist/internals/accounts.mjs

@@ -0,0 +1,45 @@
+import { parseCaipAssetType } from "@metamask/utils";
+import { createHash } from "crypto";
+/**
+ * Get a function that generates pseudo-random UUIDs. This function uses a
+ * counter to generate a unique UUID each time it is called.
+ *
+ * This is likely not suitable for production use, as it does not guarantee
+ * true randomness and is not cryptographically secure. It is intended for
+ * testing and mock purposes only.
+ *
+ * @returns A function that generates a pseudo-random UUID.
+ */
+export function getPseudoRandomUuidGenerator() {
+    let counter = 0;
+    return () => {
+        const bytes = createHash('sha256')
+            .update(`${counter}`)
+            .digest()
+            .subarray(0, 16);
+        /* eslint-disable no-bitwise */
+        bytes[6] = (bytes[6] & 0x0f) | 0x40;
+        bytes[8] = (bytes[8] & 0x3f) | 0x80;
+        /* eslint-enable no-bitwise */
+        counter += 1;
+        return (bytes
+            .toString('hex')
+            .match(/.{1,8}/gu)
+            ?.join('-') ?? '');
+    };
+}
+/**
+ * Get unique scopes from a list of assets. This assumes the assets are in
+ * CAIP format, where the chain ID is the first part of the asset type.
+ *
+ * @param assets - An array of CAIP asset types.
+ * @returns An array of unique CAIP chain IDs derived from the assets.
+ */
+export function getScopesFromAssets(assets = []) {
+    const scopes = assets.map((asset) => {
+        const { chainId } = parseCaipAssetType(asset);
+        return chainId;
+    });
+    return Array.from(new Set(scopes));
+}
+//# sourceMappingURL=accounts.mjs.map

package/dist/internals/accounts.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"accounts.mjs","sourceRoot":"","sources":["../../src/internals/accounts.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,wBAAwB;AACrD,OAAO,EAAE,UAAU,EAAE,eAAe;AAEpC;;;;;;;;;GASG;AACH,MAAM,UAAU,4BAA4B;IAC1C,IAAI,OAAO,GAAG,CAAC,CAAC;IAEhB,OAAO,GAAG,EAAE;QACV,MAAM,KAAK,GAAG,UAAU,CAAC,QAAQ,CAAC;aAC/B,MAAM,CAAC,GAAG,OAAO,EAAE,CAAC;aACpB,MAAM,EAAE;aACR,QAAQ,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAEnB,+BAA+B;QAC/B,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;QACpC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;QACpC,8BAA8B;QAE9B,OAAO,IAAI,CAAC,CAAC;QAEb,OAAO,CACL,KAAK;aACF,QAAQ,CAAC,KAAK,CAAC;aACf,KAAK,CAAC,UAAU,CAAC;YAClB,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CACpB,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CACjC,SAA0B,EAAE;IAE5B,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;QAClC,MAAM,EAAE,OAAO,EAAE,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAC;QAC9C,OAAO,OAAO,CAAC;IACjB,CAAC,CAAC,CAAC;IAEH,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;AACrC,CAAC","sourcesContent":["import type { CaipAssetType, CaipChainId } from '@metamask/utils';\nimport { parseCaipAssetType } from '@metamask/utils';\nimport { createHash } from 'crypto';\n\n/**\n * Get a function that generates pseudo-random UUIDs. This function uses a\n * counter to generate a unique UUID each time it is called.\n *\n * This is likely not suitable for production use, as it does not guarantee\n * true randomness and is not cryptographically secure. It is intended for\n * testing and mock purposes only.\n *\n * @returns A function that generates a pseudo-random UUID.\n */\nexport function getPseudoRandomUuidGenerator() {\n  let counter = 0;\n\n  return () => {\n    const bytes = createHash('sha256')\n      .update(`${counter}`)\n      .digest()\n      .subarray(0, 16);\n\n    /* eslint-disable no-bitwise */\n    bytes[6] = (bytes[6] & 0x0f) | 0x40;\n    bytes[8] = (bytes[8] & 0x3f) | 0x80;\n    /* eslint-enable no-bitwise */\n\n    counter += 1;\n\n    return (\n      bytes\n        .toString('hex')\n        .match(/.{1,8}/gu)\n        ?.join('-') ?? ''\n    );\n  };\n}\n\n/**\n * Get unique scopes from a list of assets. This assumes the assets are in\n * CAIP format, where the chain ID is the first part of the asset type.\n *\n * @param assets - An array of CAIP asset types.\n * @returns An array of unique CAIP chain IDs derived from the assets.\n */\nexport function getScopesFromAssets(\n  assets: CaipAssetType[] = [],\n): CaipChainId[] {\n  const scopes = assets.map((asset) => {\n    const { chainId } = parseCaipAssetType(asset);\n    return chainId;\n  });\n\n  return Array.from(new Set(scopes));\n}\n"]}

package/dist/internals/index.cjs

@@ -17,4 +17,5 @@ Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./environment.cjs"), exports);
 __exportStar(require("./logger.cjs"), exports);
 __exportStar(require("./server.cjs"), exports);
+__exportStar(require("./accounts.cjs"), exports);
 //# sourceMappingURL=index.cjs.map

package/dist/internals/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","sourceRoot":"","sources":["../../src/internals/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,oDAA8B;AAC9B,+CAAyB;AACzB,+CAAyB","sourcesContent":["export * from './environment';\nexport * from './logger';\nexport * from './server';\n"]}
+{"version":3,"file":"index.cjs","sourceRoot":"","sources":["../../src/internals/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,oDAA8B;AAC9B,+CAAyB;AACzB,+CAAyB;AACzB,iDAA2B","sourcesContent":["export * from './environment';\nexport * from './logger';\nexport * from './server';\nexport * from './accounts';\n"]}

package/dist/internals/index.d.cts

@@ -1,4 +1,5 @@
 export * from "./environment.cjs";
 export * from "./logger.cjs";
 export * from "./server.cjs";
+export * from "./accounts.cjs";
 //# sourceMappingURL=index.d.cts.map

package/dist/internals/index.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.cts","sourceRoot":"","sources":["../../src/internals/index.ts"],"names":[],"mappings":"AAAA,kCAA8B;AAC9B,6BAAyB;AACzB,6BAAyB"}
+{"version":3,"file":"index.d.cts","sourceRoot":"","sources":["../../src/internals/index.ts"],"names":[],"mappings":"AAAA,kCAA8B;AAC9B,6BAAyB;AACzB,6BAAyB;AACzB,+BAA2B"}

package/dist/internals/index.d.mts

@@ -1,4 +1,5 @@
 export * from "./environment.mjs";
 export * from "./logger.mjs";
 export * from "./server.mjs";
+export * from "./accounts.mjs";
 //# sourceMappingURL=index.d.mts.map

package/dist/internals/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../../src/internals/index.ts"],"names":[],"mappings":"AAAA,kCAA8B;AAC9B,6BAAyB;AACzB,6BAAyB"}
+{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../../src/internals/index.ts"],"names":[],"mappings":"AAAA,kCAA8B;AAC9B,6BAAyB;AACzB,6BAAyB;AACzB,+BAA2B"}

package/dist/internals/index.mjs

@@ -1,4 +1,5 @@
 export * from "./environment.mjs";
 export * from "./logger.mjs";
 export * from "./server.mjs";
+export * from "./accounts.mjs";
 //# sourceMappingURL=index.mjs.map

package/dist/internals/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../../src/internals/index.ts"],"names":[],"mappings":"AAAA,kCAA8B;AAC9B,6BAAyB;AACzB,6BAAyB","sourcesContent":["export * from './environment';\nexport * from './logger';\nexport * from './server';\n"]}
+{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../../src/internals/index.ts"],"names":[],"mappings":"AAAA,kCAA8B;AAC9B,6BAAyB;AACzB,6BAAyB;AACzB,+BAA2B","sourcesContent":["export * from './environment';\nexport * from './logger';\nexport * from './server';\nexport * from './accounts';\n"]}

package/dist/options.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"options.cjs","sourceRoot":"","sources":["../src/options.ts"],"names":[],"mappings":";;;AACA,uDAQ+B;AAE/B,MAAM,6BAA6B,GAAG,IAAA,kBAAI,EAAC;IACzC,MAAM,EAAE,IAAA,uBAAS,EACf,IAAA,oBAAM,EAAC;QACL,OAAO,EAAE,IAAA,uBAAS,EAAC,IAAA,qBAAO,GAAE,EAAE,IAAI,CAAC;QACnC,IAAI,EAAE,IAAA,uBAAS,EAAC,IAAA,oBAAM,GAAE,EAAE,CAAC,CAAC;QAC5B,IAAI,EAAE,IAAA,uBAAS,EAAC,IAAA,oBAAM,GAAE,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC;KACzC,CAAC,EACF,EAAE,CACH;CACF,CAAC,CAAC;AA+BH;;;;;;;GAOG;AACH,SAAgB,UAAU,CAAC,sBAA+C;IACxE,OAAO,IAAA,oBAAM,EAAC,sBAAsB,EAAE,6BAA6B,CAAC,CAAC;AACvE,CAAC;AAFD,gCAEC","sourcesContent":["import type { Infer } from '@metamask/superstruct';\nimport {\n  boolean,\n  create,\n  defaulted,\n  number,\n  object,\n  string,\n  type,\n} from '@metamask/superstruct';\n\nconst SnapsEnvironmentOptionsStruct = type({\n  server: defaulted(\n    object({\n      enabled: defaulted(boolean(), true),\n      port: defaulted(number(), 0),\n      root: defaulted(string(), process.cwd()),\n    }),\n    {},\n  ),\n});\n\n/**\n * The options for the environment. These can be specified in the Jest\n * configuration under `testEnvironmentOptions`.\n *\n * @example\n * {\n *   \"testEnvironment\": \"@metamask/snaps-jest\",\n *   \"testEnvironmentOptions\": {\n *     \"executionEnvironmentUrl\": \"http://localhost:8080\",\n *     \"server\": {\n *       \"port\": 8080,\n *       /* ... *\\/\n *     }\n *   }\n * }\n * @property server - The options for the built-in HTTP server.\n * @property server.enabled - Whether to run the built-in HTTP server. Defaults\n * to `true`.\n * @property server.port - The port to use for the built-in HTTP server. If this\n * is not provided, a random available port will be used.\n * @property server.root - The root directory to serve from the built-in HTTP\n * server. Defaults to the current working directory. This is assumed to be the\n * directory containing the snap manifest and `dist` files. If this is a\n * relative path, it will be resolved relative to the current working directory.\n */\nexport type SnapsEnvironmentOptions = Infer<\n  typeof SnapsEnvironmentOptionsStruct\n>;\n\n/**\n * Get the environment options. This validates the options, and returns the\n * default options if none are provided.\n *\n * @param testEnvironmentOptions - The test environment options as defined in\n * the Jest configuration.\n * @returns The environment options.\n */\nexport function getOptions(testEnvironmentOptions: Record<string, unknown>) {\n  return create(testEnvironmentOptions, SnapsEnvironmentOptionsStruct);\n}\n"]}
+{"version":3,"file":"options.cjs","sourceRoot":"","sources":["../src/options.ts"],"names":[],"mappings":";;;AACA,uDAQ+B;AAE/B,MAAM,6BAA6B,GAAG,IAAA,kBAAI,EAAC;IACzC,MAAM,EAAE,IAAA,uBAAS,EACf,IAAA,oBAAM,EAAC;QACL,OAAO,EAAE,IAAA,uBAAS,EAAC,IAAA,qBAAO,GAAE,EAAE,IAAI,CAAC;QACnC,IAAI,EAAE,IAAA,uBAAS,EAAC,IAAA,oBAAM,GAAE,EAAE,CAAC,CAAC;QAC5B,IAAI,EAAE,IAAA,uBAAS,EAAC,IAAA,oBAAM,GAAE,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC;KACzC,CAAC,EACF,EAAE,CACH;CACF,CAAC,CAAC;AA+BH;;;;;;;GAOG;AACH,SAAgB,UAAU,CAAC,sBAA+C;IACxE,OAAO,IAAA,oBAAM,EAAC,sBAAsB,EAAE,6BAA6B,CAAC,CAAC;AACvE,CAAC;AAFD,gCAEC","sourcesContent":["import type { Infer } from '@metamask/superstruct';\nimport {\n  boolean,\n  create,\n  defaulted,\n  number,\n  object,\n  string,\n  type,\n} from '@metamask/superstruct';\n\nconst SnapsEnvironmentOptionsStruct = type({\n  server: defaulted(\n    object({\n      enabled: defaulted(boolean(), true),\n      port: defaulted(number(), 0),\n      root: defaulted(string(), process.cwd()),\n    }),\n    {},\n  ),\n});\n\n/**\n * The options for the environment. These can be specified in the Jest\n * configuration under `testEnvironmentOptions`.\n *\n * @example\n * {\n *   \"testEnvironment\": \"@metamask/snaps-jest\",\n *   \"testEnvironmentOptions\": {\n *     \"executionEnvironmentUrl\": \"http://localhost:8080\",\n *     \"server\": {\n *       \"port\": 8080,\n *       /* ... *\\/\n *     }\n *   }\n * }\n * @property server - The options for the built-in HTTP server.\n * @property server.enabled - Whether to run the built-in HTTP server. Defaults\n * to `true`.\n * @property server.port - The port to use for the built-in HTTP server. If this\n * is not provided, a random available port will be used.\n * @property server.root - The root directory to serve from the built-in HTTP\n * server. Defaults to the current working directory. This is assumed to be the\n * directory containing the snap manifest and `dist` files. If this is a\n * relative path, it will be resolved relative to the current working directory.\n */\nexport type SnapsEnvironmentOptions = Infer<\n  typeof SnapsEnvironmentOptionsStruct\n>;\n\n/**\n * Get the environment options. This validates the options, and returns the\n * default options if none are provided.\n *\n * @param testEnvironmentOptions - The test environment options as defined in\n * the Jest configuration.\n * @returns The environment options.\n */\nexport function getOptions(testEnvironmentOptions: Record<string, unknown>) {\n  return create(testEnvironmentOptions, SnapsEnvironmentOptionsStruct);\n}\n\nexport type {\n  SimulationAccount,\n  SimulationAsset,\n} from '@metamask/snaps-simulation';\n"]}

package/dist/options.d.cts

@@ -57,5 +57,5 @@ export declare function getOptions(testEnvironmentOptions: Record<string, unknow
         root: string;
     };
 };
-export {};
+export type { SimulationAccount, SimulationAsset, } from "@metamask/snaps-simulation";
 //# sourceMappingURL=options.d.cts.map

package/dist/options.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"options.d.cts","sourceRoot":"","sources":["../src/options.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,8BAA8B;AAWnD,QAAA,MAAM,6BAA6B;;;;;;;;;;;;;;;;EASjC,CAAC;AAEH;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,MAAM,uBAAuB,GAAG,KAAK,CACzC,OAAO,6BAA6B,CACrC,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,sBAAsB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;;EAEzE"}
+{"version":3,"file":"options.d.cts","sourceRoot":"","sources":["../src/options.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,8BAA8B;AAWnD,QAAA,MAAM,6BAA6B;;;;;;;;;;;;;;;;EASjC,CAAC;AAEH;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,MAAM,uBAAuB,GAAG,KAAK,CACzC,OAAO,6BAA6B,CACrC,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,sBAAsB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;;EAEzE;AAED,YAAY,EACV,iBAAiB,EACjB,eAAe,GAChB,mCAAmC"}

package/dist/options.d.mts

@@ -57,5 +57,5 @@ export declare function getOptions(testEnvironmentOptions: Record<string, unknow
         root: string;
     };
 };
-export {};
+export type { SimulationAccount, SimulationAsset, } from "@metamask/snaps-simulation";
 //# sourceMappingURL=options.d.mts.map

package/dist/options.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"options.d.mts","sourceRoot":"","sources":["../src/options.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,8BAA8B;AAWnD,QAAA,MAAM,6BAA6B;;;;;;;;;;;;;;;;EASjC,CAAC;AAEH;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,MAAM,uBAAuB,GAAG,KAAK,CACzC,OAAO,6BAA6B,CACrC,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,sBAAsB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;;EAEzE"}
+{"version":3,"file":"options.d.mts","sourceRoot":"","sources":["../src/options.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,8BAA8B;AAWnD,QAAA,MAAM,6BAA6B;;;;;;;;;;;;;;;;EASjC,CAAC;AAEH;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,MAAM,uBAAuB,GAAG,KAAK,CACzC,OAAO,6BAA6B,CACrC,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,sBAAsB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;;EAEzE;AAED,YAAY,EACV,iBAAiB,EACjB,eAAe,GAChB,mCAAmC"}

package/dist/options.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"options.mjs","sourceRoot":"","sources":["../src/options.ts"],"names":[],"mappings":"AACA,OAAO,EACL,OAAO,EACP,MAAM,EACN,SAAS,EACT,MAAM,EACN,MAAM,EACN,MAAM,EACN,IAAI,EACL,8BAA8B;AAE/B,MAAM,6BAA6B,GAAG,IAAI,CAAC;IACzC,MAAM,EAAE,SAAS,CACf,MAAM,CAAC;QACL,OAAO,EAAE,SAAS,CAAC,OAAO,EAAE,EAAE,IAAI,CAAC;QACnC,IAAI,EAAE,SAAS,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QAC5B,IAAI,EAAE,SAAS,CAAC,MAAM,EAAE,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC;KACzC,CAAC,EACF,EAAE,CACH;CACF,CAAC,CAAC;AA+BH;;;;;;;GAOG;AACH,MAAM,UAAU,UAAU,CAAC,sBAA+C;IACxE,OAAO,MAAM,CAAC,sBAAsB,EAAE,6BAA6B,CAAC,CAAC;AACvE,CAAC","sourcesContent":["import type { Infer } from '@metamask/superstruct';\nimport {\n  boolean,\n  create,\n  defaulted,\n  number,\n  object,\n  string,\n  type,\n} from '@metamask/superstruct';\n\nconst SnapsEnvironmentOptionsStruct = type({\n  server: defaulted(\n    object({\n      enabled: defaulted(boolean(), true),\n      port: defaulted(number(), 0),\n      root: defaulted(string(), process.cwd()),\n    }),\n    {},\n  ),\n});\n\n/**\n * The options for the environment. These can be specified in the Jest\n * configuration under `testEnvironmentOptions`.\n *\n * @example\n * {\n *   \"testEnvironment\": \"@metamask/snaps-jest\",\n *   \"testEnvironmentOptions\": {\n *     \"executionEnvironmentUrl\": \"http://localhost:8080\",\n *     \"server\": {\n *       \"port\": 8080,\n *       /* ... *\\/\n *     }\n *   }\n * }\n * @property server - The options for the built-in HTTP server.\n * @property server.enabled - Whether to run the built-in HTTP server. Defaults\n * to `true`.\n * @property server.port - The port to use for the built-in HTTP server. If this\n * is not provided, a random available port will be used.\n * @property server.root - The root directory to serve from the built-in HTTP\n * server. Defaults to the current working directory. This is assumed to be the\n * directory containing the snap manifest and `dist` files. If this is a\n * relative path, it will be resolved relative to the current working directory.\n */\nexport type SnapsEnvironmentOptions = Infer<\n  typeof SnapsEnvironmentOptionsStruct\n>;\n\n/**\n * Get the environment options. This validates the options, and returns the\n * default options if none are provided.\n *\n * @param testEnvironmentOptions - The test environment options as defined in\n * the Jest configuration.\n * @returns The environment options.\n */\nexport function getOptions(testEnvironmentOptions: Record<string, unknown>) {\n  return create(testEnvironmentOptions, SnapsEnvironmentOptionsStruct);\n}\n"]}
+{"version":3,"file":"options.mjs","sourceRoot":"","sources":["../src/options.ts"],"names":[],"mappings":"AACA,OAAO,EACL,OAAO,EACP,MAAM,EACN,SAAS,EACT,MAAM,EACN,MAAM,EACN,MAAM,EACN,IAAI,EACL,8BAA8B;AAE/B,MAAM,6BAA6B,GAAG,IAAI,CAAC;IACzC,MAAM,EAAE,SAAS,CACf,MAAM,CAAC;QACL,OAAO,EAAE,SAAS,CAAC,OAAO,EAAE,EAAE,IAAI,CAAC;QACnC,IAAI,EAAE,SAAS,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QAC5B,IAAI,EAAE,SAAS,CAAC,MAAM,EAAE,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC;KACzC,CAAC,EACF,EAAE,CACH;CACF,CAAC,CAAC;AA+BH;;;;;;;GAOG;AACH,MAAM,UAAU,UAAU,CAAC,sBAA+C;IACxE,OAAO,MAAM,CAAC,sBAAsB,EAAE,6BAA6B,CAAC,CAAC;AACvE,CAAC","sourcesContent":["import type { Infer } from '@metamask/superstruct';\nimport {\n  boolean,\n  create,\n  defaulted,\n  number,\n  object,\n  string,\n  type,\n} from '@metamask/superstruct';\n\nconst SnapsEnvironmentOptionsStruct = type({\n  server: defaulted(\n    object({\n      enabled: defaulted(boolean(), true),\n      port: defaulted(number(), 0),\n      root: defaulted(string(), process.cwd()),\n    }),\n    {},\n  ),\n});\n\n/**\n * The options for the environment. These can be specified in the Jest\n * configuration under `testEnvironmentOptions`.\n *\n * @example\n * {\n *   \"testEnvironment\": \"@metamask/snaps-jest\",\n *   \"testEnvironmentOptions\": {\n *     \"executionEnvironmentUrl\": \"http://localhost:8080\",\n *     \"server\": {\n *       \"port\": 8080,\n *       /* ... *\\/\n *     }\n *   }\n * }\n * @property server - The options for the built-in HTTP server.\n * @property server.enabled - Whether to run the built-in HTTP server. Defaults\n * to `true`.\n * @property server.port - The port to use for the built-in HTTP server. If this\n * is not provided, a random available port will be used.\n * @property server.root - The root directory to serve from the built-in HTTP\n * server. Defaults to the current working directory. This is assumed to be the\n * directory containing the snap manifest and `dist` files. If this is a\n * relative path, it will be resolved relative to the current working directory.\n */\nexport type SnapsEnvironmentOptions = Infer<\n  typeof SnapsEnvironmentOptionsStruct\n>;\n\n/**\n * Get the environment options. This validates the options, and returns the\n * default options if none are provided.\n *\n * @param testEnvironmentOptions - The test environment options as defined in\n * the Jest configuration.\n * @returns The environment options.\n */\nexport function getOptions(testEnvironmentOptions: Record<string, unknown>) {\n  return create(testEnvironmentOptions, SnapsEnvironmentOptionsStruct);\n}\n\nexport type {\n  SimulationAccount,\n  SimulationAsset,\n} from '@metamask/snaps-simulation';\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@metamask/snaps-jest",
-  "version": "9.0.0",
+  "version": "9.2.0",
   "description": "A Jest preset for end-to-end testing MetaMask Snaps, including a Jest environment, and a set of Jest matchers",
   "keywords": [
     "MetaMask",
@@ -60,9 +60,9 @@
     "@jest/environment": "^29.5.0",
     "@jest/expect": "^29.5.0",
     "@jest/globals": "^29.5.0",
-    "@metamask/snaps-controllers": "^13.0.0",
-    "@metamask/snaps-sdk": "^8.0.0",
-    "@metamask/snaps-simulation": "^3.0.0",
+    "@metamask/snaps-controllers": "^14.0.0",
+    "@metamask/snaps-sdk": "^9.0.0",
+    "@metamask/snaps-simulation": "^3.2.0",
     "@metamask/superstruct": "^3.2.1",
     "@metamask/utils": "^11.4.0",
     "express": "^5.1.0",
@@ -72,9 +72,9 @@
   },
   "devDependencies": {
     "@jest/types": "^29.6.3",
-    "@lavamoat/allow-scripts": "^3.3.3",
+    "@lavamoat/allow-scripts": "^3.3.4",
     "@metamask/auto-changelog": "^5.0.2",
-    "@metamask/snaps-utils": "^10.0.0",
+    "@metamask/snaps-utils": "^11.0.0",
     "@swc/core": "1.11.31",
     "@swc/jest": "^0.2.38",
     "@ts-bridge/cli": "^0.6.1",