@metamask/multichain-account-service 7.1.0 → 8.0.0

package/dist/providers/TrxAccountProvider.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"TrxAccountProvider.d.cts","sourceRoot":"","sources":["../../src/providers/TrxAccountProvider.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,8BAA8B;AAC1D,OAAO,KAAK,EAAE,aAAa,EAAE,mCAAmC;AAChE,OAAO,KAAK,EACV,oBAAoB,EACpB,eAAe,EACf,cAAc,EACd,mBAAmB,EACpB,8BAA8B;AAQ/B,OAAO,KAAK,EAAE,eAAe,EAAE,uCAAuC;AACtE,OAAO,KAAK,EAAE,MAAM,EAAE,4BAA4B;AAElD,OAAO,EAAE,mBAAmB,EAAE,kCAA8B;AAC5D,OAAO,KAAK,EAEV,yBAAyB,EAC1B,kCAA8B;AAI/B,OAAO,KAAK,EAAE,iCAAiC,EAAE,qBAAiB;AAElE,MAAM,MAAM,wBAAwB,GAAG,yBAAyB,CAAC;AAEjE,eAAO,MAAM,yBAAyB,SAAS,CAAC;AAEhD,eAAO,MAAM,mCAAmC,EAAE,wBAWjD,CAAC;AAEF,qBAAa,kBAAmB,SAAQ,mBAAmB;;IACzD,MAAM,CAAC,IAAI,SAA6B;IAExC,MAAM,CAAC,WAAW,SAA8C;IAEhE,QAAQ,CAAC,YAAY,EAAE,mBAAmB,CAKxC;gBAGA,SAAS,EAAE,iCAAiC,EAC5C,MAAM,GAAE,wBAA8D,EACtE,KAAK,GAAE,aAA6B;IAKtC,OAAO,IAAI,MAAM;IAIjB,mBAAmB,CAAC,OAAO,EAAE,YAAY,CAAC,eAAe,CAAC,GAAG,OAAO;IAiC9D,cAAc,CAClB,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,YAAY,CAAC,cAAc,CAAC,EAAE,CAAC;IAgBpC,gBAAgB,CAAC,EACrB,aAAa,EACb,UAAU,GACX,EAAE;QACD,aAAa,EAAE,eAAe,CAAC;QAC/B,UAAU,EAAE,MAAM,CAAC;KACpB,GAAG,OAAO,CAAC,YAAY,CAAC,cAAc,CAAC,EAAE,CAAC;CA6C5C"}
+{"version":3,"file":"TrxAccountProvider.d.cts","sourceRoot":"","sources":["../../src/providers/TrxAccountProvider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,8BAA8B;AAC1D,OAAO,KAAK,EAAE,aAAa,EAAE,mCAAmC;AAChE,OAAO,KAAK,EACV,eAAe,EACf,cAAc,EACd,mBAAmB,EACpB,8BAA8B;AAO/B,OAAO,KAAK,EAAE,eAAe,EAAE,uCAAuC;AACtE,OAAO,KAAK,EAAE,MAAM,EAAE,4BAA4B;AAElD,OAAO,EAAE,mBAAmB,EAAE,kCAA8B;AAC5D,OAAO,KAAK,EACV,qBAAqB,EACrB,yBAAyB,EAC1B,kCAA8B;AAI/B,OAAO,KAAK,EAAE,iCAAiC,EAAE,qBAAiB;AAElE,MAAM,MAAM,wBAAwB,GAAG,yBAAyB,CAAC;AAEjE,eAAO,MAAM,yBAAyB,SAAS,CAAC;AAEhD,eAAO,MAAM,mCAAmC,EAAE,wBAejD,CAAC;AAEF,qBAAa,kBAAmB,SAAQ,mBAAmB;IACzD,MAAM,CAAC,IAAI,SAA6B;IAExC,MAAM,CAAC,WAAW,SAA8C;IAEhE,QAAQ,CAAC,YAAY,EAAE,mBAAmB,CAMxC;gBAGA,SAAS,EAAE,iCAAiC,EAC5C,MAAM,GAAE,wBAA8D,EACtE,KAAK,GAAE,aAA6B;IAKtC,OAAO,IAAI,MAAM;IAIjB,mBAAmB,CAAC,OAAO,EAAE,YAAY,CAAC,eAAe,CAAC,GAAG,OAAO;cAOjD,eAAe,CAChC,OAAO,EAAE,qBAAqB,EAC9B,EACE,aAAa,EACb,UAAU,GACX,EAAE;QAAE,aAAa,EAAE,eAAe,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,GACxD,OAAO,CAAC,cAAc,CAAC;IASpB,gBAAgB,CAAC,EACrB,aAAa,EACb,UAAU,GACX,EAAE;QACD,aAAa,EAAE,eAAe,CAAC;QAC/B,UAAU,EAAE,MAAM,CAAC;KACpB,GAAG,OAAO,CAAC,YAAY,CAAC,cAAc,CAAC,EAAE,CAAC;CA4C5C"}

package/dist/providers/TrxAccountProvider.d.mts

@@ -1,23 +1,25 @@
 import type { Bip44Account } from "@metamask/account-api";
 import type { TraceCallback } from "@metamask/controller-utils";
-import type { CreateAccountOptions, EntropySourceId, KeyringAccount, KeyringCapabilities } from "@metamask/keyring-api";
+import type { EntropySourceId, KeyringAccount, KeyringCapabilities } from "@metamask/keyring-api";
 import type { InternalAccount } from "@metamask/keyring-internal-api";
 import type { SnapId } from "@metamask/snaps-sdk";
 import { SnapAccountProvider } from "./SnapAccountProvider.mjs";
-import type { SnapAccountProviderConfig } from "./SnapAccountProvider.mjs";
+import type { RestrictedSnapKeyring, SnapAccountProviderConfig } from "./SnapAccountProvider.mjs";
 import type { MultichainAccountServiceMessenger } from "../types.mjs";
 export type TrxAccountProviderConfig = SnapAccountProviderConfig;
 export declare const TRX_ACCOUNT_PROVIDER_NAME = "Tron";
 export declare const TRX_ACCOUNT_PROVIDER_DEFAULT_CONFIG: TrxAccountProviderConfig;
 export declare class TrxAccountProvider extends SnapAccountProvider {
-    #private;
     static NAME: string;
     static TRX_SNAP_ID: SnapId;
     readonly capabilities: KeyringCapabilities;
     constructor(messenger: MultichainAccountServiceMessenger, config?: TrxAccountProviderConfig, trace?: TraceCallback);
     getName(): string;
     isAccountCompatible(account: Bip44Account<InternalAccount>): boolean;
-    createAccounts(options: CreateAccountOptions): Promise<Bip44Account<KeyringAccount>[]>;
+    protected createAccountV1(keyring: RestrictedSnapKeyring, { entropySource, groupIndex, }: {
+        entropySource: EntropySourceId;
+        groupIndex: number;
+    }): Promise<KeyringAccount>;
     discoverAccounts({ entropySource, groupIndex, }: {
         entropySource: EntropySourceId;
         groupIndex: number;

package/dist/providers/TrxAccountProvider.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"TrxAccountProvider.d.mts","sourceRoot":"","sources":["../../src/providers/TrxAccountProvider.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,8BAA8B;AAC1D,OAAO,KAAK,EAAE,aAAa,EAAE,mCAAmC;AAChE,OAAO,KAAK,EACV,oBAAoB,EACpB,eAAe,EACf,cAAc,EACd,mBAAmB,EACpB,8BAA8B;AAQ/B,OAAO,KAAK,EAAE,eAAe,EAAE,uCAAuC;AACtE,OAAO,KAAK,EAAE,MAAM,EAAE,4BAA4B;AAElD,OAAO,EAAE,mBAAmB,EAAE,kCAA8B;AAC5D,OAAO,KAAK,EAEV,yBAAyB,EAC1B,kCAA8B;AAI/B,OAAO,KAAK,EAAE,iCAAiC,EAAE,qBAAiB;AAElE,MAAM,MAAM,wBAAwB,GAAG,yBAAyB,CAAC;AAEjE,eAAO,MAAM,yBAAyB,SAAS,CAAC;AAEhD,eAAO,MAAM,mCAAmC,EAAE,wBAWjD,CAAC;AAEF,qBAAa,kBAAmB,SAAQ,mBAAmB;;IACzD,MAAM,CAAC,IAAI,SAA6B;IAExC,MAAM,CAAC,WAAW,SAA8C;IAEhE,QAAQ,CAAC,YAAY,EAAE,mBAAmB,CAKxC;gBAGA,SAAS,EAAE,iCAAiC,EAC5C,MAAM,GAAE,wBAA8D,EACtE,KAAK,GAAE,aAA6B;IAKtC,OAAO,IAAI,MAAM;IAIjB,mBAAmB,CAAC,OAAO,EAAE,YAAY,CAAC,eAAe,CAAC,GAAG,OAAO;IAiC9D,cAAc,CAClB,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,YAAY,CAAC,cAAc,CAAC,EAAE,CAAC;IAgBpC,gBAAgB,CAAC,EACrB,aAAa,EACb,UAAU,GACX,EAAE;QACD,aAAa,EAAE,eAAe,CAAC;QAC/B,UAAU,EAAE,MAAM,CAAC;KACpB,GAAG,OAAO,CAAC,YAAY,CAAC,cAAc,CAAC,EAAE,CAAC;CA6C5C"}
+{"version":3,"file":"TrxAccountProvider.d.mts","sourceRoot":"","sources":["../../src/providers/TrxAccountProvider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,8BAA8B;AAC1D,OAAO,KAAK,EAAE,aAAa,EAAE,mCAAmC;AAChE,OAAO,KAAK,EACV,eAAe,EACf,cAAc,EACd,mBAAmB,EACpB,8BAA8B;AAO/B,OAAO,KAAK,EAAE,eAAe,EAAE,uCAAuC;AACtE,OAAO,KAAK,EAAE,MAAM,EAAE,4BAA4B;AAElD,OAAO,EAAE,mBAAmB,EAAE,kCAA8B;AAC5D,OAAO,KAAK,EACV,qBAAqB,EACrB,yBAAyB,EAC1B,kCAA8B;AAI/B,OAAO,KAAK,EAAE,iCAAiC,EAAE,qBAAiB;AAElE,MAAM,MAAM,wBAAwB,GAAG,yBAAyB,CAAC;AAEjE,eAAO,MAAM,yBAAyB,SAAS,CAAC;AAEhD,eAAO,MAAM,mCAAmC,EAAE,wBAejD,CAAC;AAEF,qBAAa,kBAAmB,SAAQ,mBAAmB;IACzD,MAAM,CAAC,IAAI,SAA6B;IAExC,MAAM,CAAC,WAAW,SAA8C;IAEhE,QAAQ,CAAC,YAAY,EAAE,mBAAmB,CAMxC;gBAGA,SAAS,EAAE,iCAAiC,EAC5C,MAAM,GAAE,wBAA8D,EACtE,KAAK,GAAE,aAA6B;IAKtC,OAAO,IAAI,MAAM;IAIjB,mBAAmB,CAAC,OAAO,EAAE,YAAY,CAAC,eAAe,CAAC,GAAG,OAAO;cAOjD,eAAe,CAChC,OAAO,EAAE,qBAAqB,EAC9B,EACE,aAAa,EACb,UAAU,GACX,EAAE;QAAE,aAAa,EAAE,eAAe,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,GACxD,OAAO,CAAC,cAAc,CAAC;IASpB,gBAAgB,CAAC,EACrB,aAAa,EACb,UAAU,GACX,EAAE;QACD,aAAa,EAAE,eAAe,CAAC;QAC/B,UAAU,EAAE,MAAM,CAAC;KACpB,GAAG,OAAO,CAAC,YAAY,CAAC,cAAc,CAAC,EAAE,CAAC;CA4C5C"}

package/dist/providers/TrxAccountProvider.mjs

@@ -1,16 +1,9 @@
-var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
-    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
-    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
-    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
-};
-var _TrxAccountProvider_instances, _TrxAccountProvider_createAccounts;
-import { assertIsBip44Account } from "@metamask/account-api";
-import { AccountCreationType, assertCreateAccountOptionIsSupported, TrxAccountType, TrxScope } from "@metamask/keyring-api";
+import { AccountCreationType, TrxAccountType, TrxScope } from "@metamask/keyring-api";
 import { KeyringTypes } from "@metamask/keyring-controller";
 import { SnapAccountProvider } from "./SnapAccountProvider.mjs";
 import { withRetry, withTimeout } from "./utils.mjs";
 import { traceFallback } from "../analytics/index.mjs";
-import { TraceName } from "../constants/traces.mjs";
+import { TraceName } from "../analytics/traces.mjs";
 export const TRX_ACCOUNT_PROVIDER_NAME = 'Tron';
 export const TRX_ACCOUNT_PROVIDER_DEFAULT_CONFIG = {
     maxConcurrency: 3,
@@ -21,17 +14,21 @@ export const TRX_ACCOUNT_PROVIDER_DEFAULT_CONFIG = {
         backOffMs: 1000,
     },
     createAccounts: {
+        batched: false, // For now, the Snap is not fully v2 compliant.
         timeoutMs: 3000,
     },
+    resyncAccounts: {
+        autoRemoveExtraSnapAccounts: true,
+    },
 };
 export class TrxAccountProvider extends SnapAccountProvider {
     constructor(messenger, config = TRX_ACCOUNT_PROVIDER_DEFAULT_CONFIG, trace = traceFallback) {
         super(TrxAccountProvider.TRX_SNAP_ID, messenger, config, trace);
-        _TrxAccountProvider_instances.add(this);
         this.capabilities = {
             scopes: [TrxScope.Mainnet, TrxScope.Shasta],
             bip44: {
                 deriveIndex: true,
+                deriveIndexRange: true,
             },
         };
     }
@@ -42,17 +39,12 @@ export class TrxAccountProvider extends SnapAccountProvider {
         return (account.type === TrxAccountType.Eoa &&
             account.metadata.keyring.type === KeyringTypes.snap);
     }
-    async createAccounts(options) {
-        assertCreateAccountOptionIsSupported(options, [
-            `${AccountCreationType.Bip44DeriveIndex}`,
-        ]);
-        const { entropySource, groupIndex } = options;
-        return this.withSnap(async ({ keyring }) => {
-            return __classPrivateFieldGet(this, _TrxAccountProvider_instances, "m", _TrxAccountProvider_createAccounts).call(this, {
-                keyring,
-                entropySource,
-                groupIndex,
-            });
+    createAccountV1(keyring, { entropySource, groupIndex, }) {
+        return keyring.createAccount({
+            entropySource,
+            index: groupIndex,
+            addressType: TrxAccountType.Eoa,
+            scope: TrxScope.Mainnet,
         });
     }
     async discoverAccounts({ entropySource, groupIndex, }) {
@@ -66,36 +58,22 @@ export class TrxAccountProvider extends SnapAccountProvider {
                 if (!this.config.discovery.enabled) {
                     return [];
                 }
-                const discoveredAccounts = await withRetry(() => withTimeout(client.discoverAccounts([TrxScope.Mainnet], entropySource, groupIndex), this.config.discovery.timeoutMs), {
+                const discoveredAccounts = await withRetry(() => withTimeout(() => client.discoverAccounts([TrxScope.Mainnet], entropySource, groupIndex), this.config.discovery.timeoutMs), {
                     maxAttempts: this.config.discovery.maxAttempts,
                     backOffMs: this.config.discovery.backOffMs,
                 });
                 if (!discoveredAccounts.length) {
                     return [];
                 }
-                const createdAccounts = await __classPrivateFieldGet(this, _TrxAccountProvider_instances, "m", _TrxAccountProvider_createAccounts).call(this, {
-                    keyring,
+                return await this.createBip44Accounts(keyring, {
+                    type: AccountCreationType.Bip44DeriveIndex,
                     entropySource,
                     groupIndex,
                 });
-                return createdAccounts;
             });
         });
     }
 }
-_TrxAccountProvider_instances = new WeakSet(), _TrxAccountProvider_createAccounts = async function _TrxAccountProvider_createAccounts({ keyring, entropySource, groupIndex: index, }) {
-    return this.withMaxConcurrency(async () => {
-        const account = await withTimeout(keyring.createAccount({
-            entropySource,
-            index,
-            addressType: TrxAccountType.Eoa,
-            scope: TrxScope.Mainnet,
-        }), this.config.createAccounts.timeoutMs);
-        assertIsBip44Account(account);
-        this.accounts.add(account.id);
-        return [account];
-    });
-};
 TrxAccountProvider.NAME = TRX_ACCOUNT_PROVIDER_NAME;
 TrxAccountProvider.TRX_SNAP_ID = 'npm:@metamask/tron-wallet-snap';
 //# sourceMappingURL=TrxAccountProvider.mjs.map

package/dist/providers/TrxAccountProvider.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"TrxAccountProvider.mjs","sourceRoot":"","sources":["../../src/providers/TrxAccountProvider.ts"],"names":[],"mappings":"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","sourcesContent":["import { assertIsBip44Account } from '@metamask/account-api';\nimport type { Bip44Account } from '@metamask/account-api';\nimport type { TraceCallback } from '@metamask/controller-utils';\nimport type {\n  CreateAccountOptions,\n  EntropySourceId,\n  KeyringAccount,\n  KeyringCapabilities,\n} from '@metamask/keyring-api';\nimport {\n  AccountCreationType,\n  assertCreateAccountOptionIsSupported,\n  TrxAccountType,\n  TrxScope,\n} from '@metamask/keyring-api';\nimport { KeyringTypes } from '@metamask/keyring-controller';\nimport type { InternalAccount } from '@metamask/keyring-internal-api';\nimport type { SnapId } from '@metamask/snaps-sdk';\n\nimport { SnapAccountProvider } from './SnapAccountProvider';\nimport type {\n  RestrictedSnapKeyring,\n  SnapAccountProviderConfig,\n} from './SnapAccountProvider';\nimport { withRetry, withTimeout } from './utils';\nimport { traceFallback } from '../analytics';\nimport { TraceName } from '../constants/traces';\nimport type { MultichainAccountServiceMessenger } from '../types';\n\nexport type TrxAccountProviderConfig = SnapAccountProviderConfig;\n\nexport const TRX_ACCOUNT_PROVIDER_NAME = 'Tron';\n\nexport const TRX_ACCOUNT_PROVIDER_DEFAULT_CONFIG: TrxAccountProviderConfig = {\n  maxConcurrency: 3,\n  discovery: {\n    enabled: true,\n    timeoutMs: 2000,\n    maxAttempts: 3,\n    backOffMs: 1000,\n  },\n  createAccounts: {\n    timeoutMs: 3000,\n  },\n};\n\nexport class TrxAccountProvider extends SnapAccountProvider {\n  static NAME = TRX_ACCOUNT_PROVIDER_NAME;\n\n  static TRX_SNAP_ID = 'npm:@metamask/tron-wallet-snap' as SnapId;\n\n  readonly capabilities: KeyringCapabilities = {\n    scopes: [TrxScope.Mainnet, TrxScope.Shasta],\n    bip44: {\n      deriveIndex: true,\n    },\n  };\n\n  constructor(\n    messenger: MultichainAccountServiceMessenger,\n    config: TrxAccountProviderConfig = TRX_ACCOUNT_PROVIDER_DEFAULT_CONFIG,\n    trace: TraceCallback = traceFallback,\n  ) {\n    super(TrxAccountProvider.TRX_SNAP_ID, messenger, config, trace);\n  }\n\n  getName(): string {\n    return TrxAccountProvider.NAME;\n  }\n\n  isAccountCompatible(account: Bip44Account<InternalAccount>): boolean {\n    return (\n      account.type === TrxAccountType.Eoa &&\n      account.metadata.keyring.type === (KeyringTypes.snap as string)\n    );\n  }\n\n  async #createAccounts({\n    keyring,\n    entropySource,\n    groupIndex: index,\n  }: {\n    keyring: RestrictedSnapKeyring;\n    entropySource: EntropySourceId;\n    groupIndex: number;\n  }): Promise<Bip44Account<KeyringAccount>[]> {\n    return this.withMaxConcurrency(async () => {\n      const account = await withTimeout(\n        keyring.createAccount({\n          entropySource,\n          index,\n          addressType: TrxAccountType.Eoa,\n          scope: TrxScope.Mainnet,\n        }),\n        this.config.createAccounts.timeoutMs,\n      );\n\n      assertIsBip44Account(account);\n      this.accounts.add(account.id);\n      return [account];\n    });\n  }\n\n  async createAccounts(\n    options: CreateAccountOptions,\n  ): Promise<Bip44Account<KeyringAccount>[]> {\n    assertCreateAccountOptionIsSupported(options, [\n      `${AccountCreationType.Bip44DeriveIndex}`,\n    ]);\n\n    const { entropySource, groupIndex } = options;\n\n    return this.withSnap(async ({ keyring }) => {\n      return this.#createAccounts({\n        keyring,\n        entropySource,\n        groupIndex,\n      });\n    });\n  }\n\n  async discoverAccounts({\n    entropySource,\n    groupIndex,\n  }: {\n    entropySource: EntropySourceId;\n    groupIndex: number;\n  }): Promise<Bip44Account<KeyringAccount>[]> {\n    return this.withSnap(async ({ client, keyring }) => {\n      return await super.trace(\n        {\n          name: TraceName.SnapDiscoverAccounts,\n          data: {\n            provider: this.getName(),\n          },\n        },\n        async () => {\n          if (!this.config.discovery.enabled) {\n            return [];\n          }\n\n          const discoveredAccounts = await withRetry(\n            () =>\n              withTimeout(\n                client.discoverAccounts(\n                  [TrxScope.Mainnet],\n                  entropySource,\n                  groupIndex,\n                ),\n                this.config.discovery.timeoutMs,\n              ),\n            {\n              maxAttempts: this.config.discovery.maxAttempts,\n              backOffMs: this.config.discovery.backOffMs,\n            },\n          );\n\n          if (!discoveredAccounts.length) {\n            return [];\n          }\n\n          const createdAccounts = await this.#createAccounts({\n            keyring,\n            entropySource,\n            groupIndex,\n          });\n\n          return createdAccounts;\n        },\n      );\n    });\n  }\n}\n"]}
+{"version":3,"file":"TrxAccountProvider.mjs","sourceRoot":"","sources":["../../src/providers/TrxAccountProvider.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Bip44Account } from '@metamask/account-api';\nimport type { TraceCallback } from '@metamask/controller-utils';\nimport type {\n  EntropySourceId,\n  KeyringAccount,\n  KeyringCapabilities,\n} from '@metamask/keyring-api';\nimport {\n  AccountCreationType,\n  TrxAccountType,\n  TrxScope,\n} from '@metamask/keyring-api';\nimport { KeyringTypes } from '@metamask/keyring-controller';\nimport type { InternalAccount } from '@metamask/keyring-internal-api';\nimport type { SnapId } from '@metamask/snaps-sdk';\n\nimport { SnapAccountProvider } from './SnapAccountProvider';\nimport type {\n  RestrictedSnapKeyring,\n  SnapAccountProviderConfig,\n} from './SnapAccountProvider';\nimport { withRetry, withTimeout } from './utils';\nimport { traceFallback } from '../analytics';\nimport { TraceName } from '../analytics/traces';\nimport type { MultichainAccountServiceMessenger } from '../types';\n\nexport type TrxAccountProviderConfig = SnapAccountProviderConfig;\n\nexport const TRX_ACCOUNT_PROVIDER_NAME = 'Tron';\n\nexport const TRX_ACCOUNT_PROVIDER_DEFAULT_CONFIG: TrxAccountProviderConfig = {\n  maxConcurrency: 3,\n  discovery: {\n    enabled: true,\n    timeoutMs: 2000,\n    maxAttempts: 3,\n    backOffMs: 1000,\n  },\n  createAccounts: {\n    batched: false, // For now, the Snap is not fully v2 compliant.\n    timeoutMs: 3000,\n  },\n  resyncAccounts: {\n    autoRemoveExtraSnapAccounts: true,\n  },\n};\n\nexport class TrxAccountProvider extends SnapAccountProvider {\n  static NAME = TRX_ACCOUNT_PROVIDER_NAME;\n\n  static TRX_SNAP_ID = 'npm:@metamask/tron-wallet-snap' as SnapId;\n\n  readonly capabilities: KeyringCapabilities = {\n    scopes: [TrxScope.Mainnet, TrxScope.Shasta],\n    bip44: {\n      deriveIndex: true,\n      deriveIndexRange: true,\n    },\n  };\n\n  constructor(\n    messenger: MultichainAccountServiceMessenger,\n    config: TrxAccountProviderConfig = TRX_ACCOUNT_PROVIDER_DEFAULT_CONFIG,\n    trace: TraceCallback = traceFallback,\n  ) {\n    super(TrxAccountProvider.TRX_SNAP_ID, messenger, config, trace);\n  }\n\n  getName(): string {\n    return TrxAccountProvider.NAME;\n  }\n\n  isAccountCompatible(account: Bip44Account<InternalAccount>): boolean {\n    return (\n      account.type === TrxAccountType.Eoa &&\n      account.metadata.keyring.type === (KeyringTypes.snap as string)\n    );\n  }\n\n  protected override createAccountV1(\n    keyring: RestrictedSnapKeyring,\n    {\n      entropySource,\n      groupIndex,\n    }: { entropySource: EntropySourceId; groupIndex: number },\n  ): Promise<KeyringAccount> {\n    return keyring.createAccount({\n      entropySource,\n      index: groupIndex,\n      addressType: TrxAccountType.Eoa,\n      scope: TrxScope.Mainnet,\n    });\n  }\n\n  async discoverAccounts({\n    entropySource,\n    groupIndex,\n  }: {\n    entropySource: EntropySourceId;\n    groupIndex: number;\n  }): Promise<Bip44Account<KeyringAccount>[]> {\n    return this.withSnap(async ({ client, keyring }) => {\n      return await super.trace(\n        {\n          name: TraceName.SnapDiscoverAccounts,\n          data: {\n            provider: this.getName(),\n          },\n        },\n        async () => {\n          if (!this.config.discovery.enabled) {\n            return [];\n          }\n\n          const discoveredAccounts = await withRetry(\n            () =>\n              withTimeout(\n                () =>\n                  client.discoverAccounts(\n                    [TrxScope.Mainnet],\n                    entropySource,\n                    groupIndex,\n                  ),\n                this.config.discovery.timeoutMs,\n              ),\n            {\n              maxAttempts: this.config.discovery.maxAttempts,\n              backOffMs: this.config.discovery.backOffMs,\n            },\n          );\n\n          if (!discoveredAccounts.length) {\n            return [];\n          }\n\n          return await this.createBip44Accounts(keyring, {\n            type: AccountCreationType.Bip44DeriveIndex,\n            entropySource,\n            groupIndex,\n          });\n        },\n      );\n    });\n  }\n}\n"]}

package/dist/providers/index.cjs

@@ -14,13 +14,14 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.TimeoutError = void 0;
+exports.isTimeoutError = exports.TimeoutError = void 0;
 __exportStar(require("./BaseBip44AccountProvider.cjs"), exports);
 __exportStar(require("./SnapAccountProvider.cjs"), exports);
 __exportStar(require("./AccountProviderWrapper.cjs"), exports);
 // Errors that can bubble up outside of provider calls.
 var utils_1 = require("./utils.cjs");
 Object.defineProperty(exports, "TimeoutError", { enumerable: true, get: function () { return utils_1.TimeoutError; } });
+Object.defineProperty(exports, "isTimeoutError", { enumerable: true, get: function () { return utils_1.isTimeoutError; } });
 // Concrete providers:
 __exportStar(require("./SolAccountProvider.cjs"), exports);
 __exportStar(require("./EvmAccountProvider.cjs"), exports);

package/dist/providers/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","sourceRoot":"","sources":["../../src/providers/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,iEAA2C;AAC3C,4DAAsC;AACtC,+DAAyC;AAEzC,uDAAuD;AACvD,qCAAuC;AAA9B,qGAAA,YAAY,OAAA;AAErB,sBAAsB;AACtB,2DAAqC;AACrC,2DAAqC;AACrC,2DAAqC;AACrC,2DAAqC","sourcesContent":["export * from './BaseBip44AccountProvider';\nexport * from './SnapAccountProvider';\nexport * from './AccountProviderWrapper';\n\n// Errors that can bubble up outside of provider calls.\nexport { TimeoutError } from './utils';\n\n// Concrete providers:\nexport * from './SolAccountProvider';\nexport * from './EvmAccountProvider';\nexport * from './BtcAccountProvider';\nexport * from './TrxAccountProvider';\n"]}
+{"version":3,"file":"index.cjs","sourceRoot":"","sources":["../../src/providers/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,iEAA2C;AAC3C,4DAAsC;AACtC,+DAAyC;AAEzC,uDAAuD;AACvD,qCAAuD;AAA9C,qGAAA,YAAY,OAAA;AAAE,uGAAA,cAAc,OAAA;AAErC,sBAAsB;AACtB,2DAAqC;AACrC,2DAAqC;AACrC,2DAAqC;AACrC,2DAAqC","sourcesContent":["export * from './BaseBip44AccountProvider';\nexport * from './SnapAccountProvider';\nexport * from './AccountProviderWrapper';\n\n// Errors that can bubble up outside of provider calls.\nexport { TimeoutError, isTimeoutError } from './utils';\n\n// Concrete providers:\nexport * from './SolAccountProvider';\nexport * from './EvmAccountProvider';\nexport * from './BtcAccountProvider';\nexport * from './TrxAccountProvider';\n"]}

package/dist/providers/index.d.cts

@@ -1,7 +1,7 @@
 export * from "./BaseBip44AccountProvider.cjs";
 export * from "./SnapAccountProvider.cjs";
 export * from "./AccountProviderWrapper.cjs";
-export { TimeoutError } from "./utils.cjs";
+export { TimeoutError, isTimeoutError } from "./utils.cjs";
 export * from "./SolAccountProvider.cjs";
 export * from "./EvmAccountProvider.cjs";
 export * from "./BtcAccountProvider.cjs";

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.cts","sourceRoot":"","sources":["../../src/providers/index.ts"],"names":[],"mappings":"AAAA,+CAA2C;AAC3C,0CAAsC;AACtC,6CAAyC;AAGzC,OAAO,EAAE,YAAY,EAAE,oBAAgB;AAGvC,yCAAqC;AACrC,yCAAqC;AACrC,yCAAqC;AACrC,yCAAqC"}
+{"version":3,"file":"index.d.cts","sourceRoot":"","sources":["../../src/providers/index.ts"],"names":[],"mappings":"AAAA,+CAA2C;AAC3C,0CAAsC;AACtC,6CAAyC;AAGzC,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,oBAAgB;AAGvD,yCAAqC;AACrC,yCAAqC;AACrC,yCAAqC;AACrC,yCAAqC"}

package/dist/providers/index.d.mts

@@ -1,7 +1,7 @@
 export * from "./BaseBip44AccountProvider.mjs";
 export * from "./SnapAccountProvider.mjs";
 export * from "./AccountProviderWrapper.mjs";
-export { TimeoutError } from "./utils.mjs";
+export { TimeoutError, isTimeoutError } from "./utils.mjs";
 export * from "./SolAccountProvider.mjs";
 export * from "./EvmAccountProvider.mjs";
 export * from "./BtcAccountProvider.mjs";

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../../src/providers/index.ts"],"names":[],"mappings":"AAAA,+CAA2C;AAC3C,0CAAsC;AACtC,6CAAyC;AAGzC,OAAO,EAAE,YAAY,EAAE,oBAAgB;AAGvC,yCAAqC;AACrC,yCAAqC;AACrC,yCAAqC;AACrC,yCAAqC"}
+{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../../src/providers/index.ts"],"names":[],"mappings":"AAAA,+CAA2C;AAC3C,0CAAsC;AACtC,6CAAyC;AAGzC,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,oBAAgB;AAGvD,yCAAqC;AACrC,yCAAqC;AACrC,yCAAqC;AACrC,yCAAqC"}

package/dist/providers/index.mjs

@@ -2,7 +2,7 @@ export * from "./BaseBip44AccountProvider.mjs";
 export * from "./SnapAccountProvider.mjs";
 export * from "./AccountProviderWrapper.mjs";
 // Errors that can bubble up outside of provider calls.
-export { TimeoutError } from "./utils.mjs";
+export { TimeoutError, isTimeoutError } from "./utils.mjs";
 // Concrete providers:
 export * from "./SolAccountProvider.mjs";
 export * from "./EvmAccountProvider.mjs";

package/dist/providers/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../../src/providers/index.ts"],"names":[],"mappings":"AAAA,+CAA2C;AAC3C,0CAAsC;AACtC,6CAAyC;AAEzC,uDAAuD;AACvD,OAAO,EAAE,YAAY,EAAE,oBAAgB;AAEvC,sBAAsB;AACtB,yCAAqC;AACrC,yCAAqC;AACrC,yCAAqC;AACrC,yCAAqC","sourcesContent":["export * from './BaseBip44AccountProvider';\nexport * from './SnapAccountProvider';\nexport * from './AccountProviderWrapper';\n\n// Errors that can bubble up outside of provider calls.\nexport { TimeoutError } from './utils';\n\n// Concrete providers:\nexport * from './SolAccountProvider';\nexport * from './EvmAccountProvider';\nexport * from './BtcAccountProvider';\nexport * from './TrxAccountProvider';\n"]}
+{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../../src/providers/index.ts"],"names":[],"mappings":"AAAA,+CAA2C;AAC3C,0CAAsC;AACtC,6CAAyC;AAEzC,uDAAuD;AACvD,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,oBAAgB;AAEvD,sBAAsB;AACtB,yCAAqC;AACrC,yCAAqC;AACrC,yCAAqC;AACrC,yCAAqC","sourcesContent":["export * from './BaseBip44AccountProvider';\nexport * from './SnapAccountProvider';\nexport * from './AccountProviderWrapper';\n\n// Errors that can bubble up outside of provider calls.\nexport { TimeoutError, isTimeoutError } from './utils';\n\n// Concrete providers:\nexport * from './SolAccountProvider';\nexport * from './EvmAccountProvider';\nexport * from './BtcAccountProvider';\nexport * from './TrxAccountProvider';\n"]}

package/dist/providers/utils.cjs

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.withTimeout = exports.withRetry = exports.TimeoutError = void 0;
+exports.withTimeout = exports.withRetry = exports.isTimeoutError = exports.TimeoutError = void 0;
 /** Timeout error. */
 class TimeoutError extends Error {
     constructor(message) {
@@ -9,6 +9,16 @@ class TimeoutError extends Error {
     }
 }
 exports.TimeoutError = TimeoutError;
+/**
+ * Check if an error is a `TimeoutError`.
+ *
+ * @param error - The error to check.
+ * @returns `true` if the error is a `TimeoutError`, otherwise `false`.
+ */
+function isTimeoutError(error) {
+    return error instanceof TimeoutError;
+}
+exports.isTimeoutError = isTimeoutError;
 /**
  * Execute a function with exponential backoff on transient failures.
  *
@@ -42,17 +52,17 @@ exports.withRetry = withRetry;
 /**
  * Execute a promise with a timeout.
  *
- * @param promise - The promise to execute.
+ * @param fn - A callback that returns the promise to execute.
  * @param timeoutMs - The timeout in milliseconds.
  * @returns The result of the promise.
  */
-async function withTimeout(promise, timeoutMs = 500) {
+async function withTimeout(fn, timeoutMs = 500) {
     let timer;
     try {
         return await Promise.race([
-            promise,
+            fn(),
             new Promise((_resolve, reject) => {
-                timer = setTimeout(() => reject(new TimeoutError('Timed out')), timeoutMs);
+                timer = setTimeout(() => reject(new TimeoutError(`Timed out after: ${timeoutMs}ms`)), timeoutMs);
             }),
         ]);
     }

package/dist/providers/utils.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"utils.cjs","sourceRoot":"","sources":["../../src/providers/utils.ts"],"names":[],"mappings":";;;AAAA,qBAAqB;AACrB,MAAa,YAAa,SAAQ,KAAK;IACrC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;IAC7B,CAAC;CACF;AALD,oCAKC;AAED;;;;;;;;;GASG;AACI,KAAK,UAAU,SAAS,CAC7B,WAA6B,EAC7B,EACE,WAAW,GAAG,CAAC,EACf,SAAS,GAAG,GAAG,MACiC,EAAE;IAEpD,IAAI,SAAS,CAAC;IACd,IAAI,OAAO,GAAG,SAAS,CAAC;IACxB,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,WAAW,EAAE,OAAO,EAAE,EAAE,CAAC;QACxD,IAAI,CAAC;YACH,OAAO,MAAM,WAAW,EAAE,CAAC;QAC7B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,SAAS,GAAG,KAAK,CAAC;YAClB,IAAI,OAAO,IAAI,WAAW,EAAE,CAAC;gBAC3B,MAAM;YACR,CAAC;YACD,MAAM,KAAK,GAAG,OAAO,CAAC;YACtB,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;YAC3D,OAAO,IAAI,CAAC,CAAC;QACf,CAAC;IACH,CAAC;IACD,MAAM,SAAS,CAAC;AAClB,CAAC;AAvBD,8BAuBC;AAED;;;;;;GAMG;AACI,KAAK,UAAU,WAAW,CAC/B,OAAmB,EACnB,YAAoB,GAAG;IAEvB,IAAI,KAAK,CAAC;IACV,IAAI,CAAC;QACH,OAAO,MAAM,OAAO,CAAC,IAAI,CAAI;YAC3B,OAAO;YACP,IAAI,OAAO,CAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE;gBAClC,KAAK,GAAG,UAAU,CAChB,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,YAAY,CAAC,WAAW,CAAC,CAAC,EAC3C,SAAS,CACV,CAAC;YACJ,CAAC,CAAC;SACH,CAAC,CAAC;IACL,CAAC;YAAS,CAAC;QACT,IAAI,KAAK,EAAE,CAAC;YACV,YAAY,CAAC,KAAK,CAAC,CAAC;QACtB,CAAC;IACH,CAAC;AACH,CAAC;AApBD,kCAoBC","sourcesContent":["/** Timeout error. */\nexport class TimeoutError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = 'TimeoutError';\n  }\n}\n\n/**\n * Execute a function with exponential backoff on transient failures.\n *\n * @param fnToExecute - The function to execute.\n * @param options - The options for the retry.\n * @param options.maxAttempts - The maximum number of attempts.\n * @param options.backOffMs - The backoff in milliseconds.\n * @throws An error if the transaction count cannot be retrieved.\n * @returns The result of the function.\n */\nexport async function withRetry<T>(\n  fnToExecute: () => Promise<T>,\n  {\n    maxAttempts = 3,\n    backOffMs = 500,\n  }: { maxAttempts?: number; backOffMs?: number } = {},\n): Promise<T> {\n  let lastError;\n  let backOff = backOffMs;\n  for (let attempt = 1; attempt <= maxAttempts; attempt++) {\n    try {\n      return await fnToExecute();\n    } catch (error) {\n      lastError = error;\n      if (attempt >= maxAttempts) {\n        break;\n      }\n      const delay = backOff;\n      await new Promise((resolve) => setTimeout(resolve, delay));\n      backOff *= 2;\n    }\n  }\n  throw lastError;\n}\n\n/**\n * Execute a promise with a timeout.\n *\n * @param promise - The promise to execute.\n * @param timeoutMs - The timeout in milliseconds.\n * @returns The result of the promise.\n */\nexport async function withTimeout<T>(\n  promise: Promise<T>,\n  timeoutMs: number = 500,\n): Promise<T> {\n  let timer;\n  try {\n    return await Promise.race<T>([\n      promise,\n      new Promise<T>((_resolve, reject) => {\n        timer = setTimeout(\n          () => reject(new TimeoutError('Timed out')),\n          timeoutMs,\n        );\n      }),\n    ]);\n  } finally {\n    if (timer) {\n      clearTimeout(timer);\n    }\n  }\n}\n"]}
+{"version":3,"file":"utils.cjs","sourceRoot":"","sources":["../../src/providers/utils.ts"],"names":[],"mappings":";;;AAAA,qBAAqB;AACrB,MAAa,YAAa,SAAQ,KAAK;IACrC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;IAC7B,CAAC;CACF;AALD,oCAKC;AAED;;;;;GAKG;AACH,SAAgB,cAAc,CAAC,KAAc;IAC3C,OAAO,KAAK,YAAY,YAAY,CAAC;AACvC,CAAC;AAFD,wCAEC;AAED;;;;;;;;;GASG;AACI,KAAK,UAAU,SAAS,CAC7B,WAA6B,EAC7B,EACE,WAAW,GAAG,CAAC,EACf,SAAS,GAAG,GAAG,MACiC,EAAE;IAEpD,IAAI,SAAS,CAAC;IACd,IAAI,OAAO,GAAG,SAAS,CAAC;IACxB,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,WAAW,EAAE,OAAO,EAAE,EAAE,CAAC;QACxD,IAAI,CAAC;YACH,OAAO,MAAM,WAAW,EAAE,CAAC;QAC7B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,SAAS,GAAG,KAAK,CAAC;YAClB,IAAI,OAAO,IAAI,WAAW,EAAE,CAAC;gBAC3B,MAAM;YACR,CAAC;YACD,MAAM,KAAK,GAAG,OAAO,CAAC;YACtB,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;YAC3D,OAAO,IAAI,CAAC,CAAC;QACf,CAAC;IACH,CAAC;IACD,MAAM,SAAS,CAAC;AAClB,CAAC;AAvBD,8BAuBC;AAED;;;;;;GAMG;AACI,KAAK,UAAU,WAAW,CAC/B,EAAoB,EACpB,YAAoB,GAAG;IAEvB,IAAI,KAAK,CAAC;IACV,IAAI,CAAC;QACH,OAAO,MAAM,OAAO,CAAC,IAAI,CAAI;YAC3B,EAAE,EAAE;YACJ,IAAI,OAAO,CAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE;gBAClC,KAAK,GAAG,UAAU,CAChB,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,YAAY,CAAC,oBAAoB,SAAS,IAAI,CAAC,CAAC,EACjE,SAAS,CACV,CAAC;YACJ,CAAC,CAAC;SACH,CAAC,CAAC;IACL,CAAC;YAAS,CAAC;QACT,IAAI,KAAK,EAAE,CAAC;YACV,YAAY,CAAC,KAAK,CAAC,CAAC;QACtB,CAAC;IACH,CAAC;AACH,CAAC;AApBD,kCAoBC","sourcesContent":["/** Timeout error. */\nexport class TimeoutError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = 'TimeoutError';\n  }\n}\n\n/**\n * Check if an error is a `TimeoutError`.\n *\n * @param error - The error to check.\n * @returns `true` if the error is a `TimeoutError`, otherwise `false`.\n */\nexport function isTimeoutError(error: unknown): error is TimeoutError {\n  return error instanceof TimeoutError;\n}\n\n/**\n * Execute a function with exponential backoff on transient failures.\n *\n * @param fnToExecute - The function to execute.\n * @param options - The options for the retry.\n * @param options.maxAttempts - The maximum number of attempts.\n * @param options.backOffMs - The backoff in milliseconds.\n * @throws An error if the transaction count cannot be retrieved.\n * @returns The result of the function.\n */\nexport async function withRetry<T>(\n  fnToExecute: () => Promise<T>,\n  {\n    maxAttempts = 3,\n    backOffMs = 500,\n  }: { maxAttempts?: number; backOffMs?: number } = {},\n): Promise<T> {\n  let lastError;\n  let backOff = backOffMs;\n  for (let attempt = 1; attempt <= maxAttempts; attempt++) {\n    try {\n      return await fnToExecute();\n    } catch (error) {\n      lastError = error;\n      if (attempt >= maxAttempts) {\n        break;\n      }\n      const delay = backOff;\n      await new Promise((resolve) => setTimeout(resolve, delay));\n      backOff *= 2;\n    }\n  }\n  throw lastError;\n}\n\n/**\n * Execute a promise with a timeout.\n *\n * @param fn - A callback that returns the promise to execute.\n * @param timeoutMs - The timeout in milliseconds.\n * @returns The result of the promise.\n */\nexport async function withTimeout<T>(\n  fn: () => Promise<T>,\n  timeoutMs: number = 500,\n): Promise<T> {\n  let timer;\n  try {\n    return await Promise.race<T>([\n      fn(),\n      new Promise<T>((_resolve, reject) => {\n        timer = setTimeout(\n          () => reject(new TimeoutError(`Timed out after: ${timeoutMs}ms`)),\n          timeoutMs,\n        );\n      }),\n    ]);\n  } finally {\n    if (timer) {\n      clearTimeout(timer);\n    }\n  }\n}\n"]}

package/dist/providers/utils.d.cts

@@ -2,6 +2,13 @@
 export declare class TimeoutError extends Error {
     constructor(message: string);
 }
+/**
+ * Check if an error is a `TimeoutError`.
+ *
+ * @param error - The error to check.
+ * @returns `true` if the error is a `TimeoutError`, otherwise `false`.
+ */
+export declare function isTimeoutError(error: unknown): error is TimeoutError;
 /**
  * Execute a function with exponential backoff on transient failures.
  *
@@ -19,9 +26,9 @@ export declare function withRetry<T>(fnToExecute: () => Promise<T>, { maxAttempt
 /**
  * Execute a promise with a timeout.
  *
- * @param promise - The promise to execute.
+ * @param fn - A callback that returns the promise to execute.
  * @param timeoutMs - The timeout in milliseconds.
  * @returns The result of the promise.
  */
-export declare function withTimeout<T>(promise: Promise<T>, timeoutMs?: number): Promise<T>;
+export declare function withTimeout<T>(fn: () => Promise<T>, timeoutMs?: number): Promise<T>;
 //# sourceMappingURL=utils.d.cts.map

package/dist/providers/utils.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.cts","sourceRoot":"","sources":["../../src/providers/utils.ts"],"names":[],"mappings":"AAAA,qBAAqB;AACrB,qBAAa,YAAa,SAAQ,KAAK;gBACzB,OAAO,EAAE,MAAM;CAI5B;AAED;;;;;;;;;GASG;AACH,wBAAsB,SAAS,CAAC,CAAC,EAC/B,WAAW,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAC7B,EACE,WAAe,EACf,SAAe,GAChB,GAAE;IAAE,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAO,GACnD,OAAO,CAAC,CAAC,CAAC,CAiBZ;AAED;;;;;;GAMG;AACH,wBAAsB,WAAW,CAAC,CAAC,EACjC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EACnB,SAAS,GAAE,MAAY,GACtB,OAAO,CAAC,CAAC,CAAC,CAiBZ"}
+{"version":3,"file":"utils.d.cts","sourceRoot":"","sources":["../../src/providers/utils.ts"],"names":[],"mappings":"AAAA,qBAAqB;AACrB,qBAAa,YAAa,SAAQ,KAAK;gBACzB,OAAO,EAAE,MAAM;CAI5B;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,YAAY,CAEpE;AAED;;;;;;;;;GASG;AACH,wBAAsB,SAAS,CAAC,CAAC,EAC/B,WAAW,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAC7B,EACE,WAAe,EACf,SAAe,GAChB,GAAE;IAAE,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAO,GACnD,OAAO,CAAC,CAAC,CAAC,CAiBZ;AAED;;;;;;GAMG;AACH,wBAAsB,WAAW,CAAC,CAAC,EACjC,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,SAAS,GAAE,MAAY,GACtB,OAAO,CAAC,CAAC,CAAC,CAiBZ"}

package/dist/providers/utils.d.mts

@@ -2,6 +2,13 @@
 export declare class TimeoutError extends Error {
     constructor(message: string);
 }
+/**
+ * Check if an error is a `TimeoutError`.
+ *
+ * @param error - The error to check.
+ * @returns `true` if the error is a `TimeoutError`, otherwise `false`.
+ */
+export declare function isTimeoutError(error: unknown): error is TimeoutError;
 /**
  * Execute a function with exponential backoff on transient failures.
  *
@@ -19,9 +26,9 @@ export declare function withRetry<T>(fnToExecute: () => Promise<T>, { maxAttempt
 /**
  * Execute a promise with a timeout.
  *
- * @param promise - The promise to execute.
+ * @param fn - A callback that returns the promise to execute.
  * @param timeoutMs - The timeout in milliseconds.
  * @returns The result of the promise.
  */
-export declare function withTimeout<T>(promise: Promise<T>, timeoutMs?: number): Promise<T>;
+export declare function withTimeout<T>(fn: () => Promise<T>, timeoutMs?: number): Promise<T>;
 //# sourceMappingURL=utils.d.mts.map

package/dist/providers/utils.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.mts","sourceRoot":"","sources":["../../src/providers/utils.ts"],"names":[],"mappings":"AAAA,qBAAqB;AACrB,qBAAa,YAAa,SAAQ,KAAK;gBACzB,OAAO,EAAE,MAAM;CAI5B;AAED;;;;;;;;;GASG;AACH,wBAAsB,SAAS,CAAC,CAAC,EAC/B,WAAW,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAC7B,EACE,WAAe,EACf,SAAe,GAChB,GAAE;IAAE,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAO,GACnD,OAAO,CAAC,CAAC,CAAC,CAiBZ;AAED;;;;;;GAMG;AACH,wBAAsB,WAAW,CAAC,CAAC,EACjC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EACnB,SAAS,GAAE,MAAY,GACtB,OAAO,CAAC,CAAC,CAAC,CAiBZ"}
+{"version":3,"file":"utils.d.mts","sourceRoot":"","sources":["../../src/providers/utils.ts"],"names":[],"mappings":"AAAA,qBAAqB;AACrB,qBAAa,YAAa,SAAQ,KAAK;gBACzB,OAAO,EAAE,MAAM;CAI5B;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,YAAY,CAEpE;AAED;;;;;;;;;GASG;AACH,wBAAsB,SAAS,CAAC,CAAC,EAC/B,WAAW,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAC7B,EACE,WAAe,EACf,SAAe,GAChB,GAAE;IAAE,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAO,GACnD,OAAO,CAAC,CAAC,CAAC,CAiBZ;AAED;;;;;;GAMG;AACH,wBAAsB,WAAW,CAAC,CAAC,EACjC,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,SAAS,GAAE,MAAY,GACtB,OAAO,CAAC,CAAC,CAAC,CAiBZ"}

package/dist/providers/utils.mjs

@@ -5,6 +5,15 @@ export class TimeoutError extends Error {
         this.name = 'TimeoutError';
     }
 }
+/**
+ * Check if an error is a `TimeoutError`.
+ *
+ * @param error - The error to check.
+ * @returns `true` if the error is a `TimeoutError`, otherwise `false`.
+ */
+export function isTimeoutError(error) {
+    return error instanceof TimeoutError;
+}
 /**
  * Execute a function with exponential backoff on transient failures.
  *
@@ -37,17 +46,17 @@ export async function withRetry(fnToExecute, { maxAttempts = 3, backOffMs = 500,
 /**
  * Execute a promise with a timeout.
  *
- * @param promise - The promise to execute.
+ * @param fn - A callback that returns the promise to execute.
  * @param timeoutMs - The timeout in milliseconds.
  * @returns The result of the promise.
  */
-export async function withTimeout(promise, timeoutMs = 500) {
+export async function withTimeout(fn, timeoutMs = 500) {
     let timer;
     try {
         return await Promise.race([
-            promise,
+            fn(),
             new Promise((_resolve, reject) => {
-                timer = setTimeout(() => reject(new TimeoutError('Timed out')), timeoutMs);
+                timer = setTimeout(() => reject(new TimeoutError(`Timed out after: ${timeoutMs}ms`)), timeoutMs);
             }),
         ]);
     }

package/dist/providers/utils.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"utils.mjs","sourceRoot":"","sources":["../../src/providers/utils.ts"],"names":[],"mappings":"AAAA,qBAAqB;AACrB,MAAM,OAAO,YAAa,SAAQ,KAAK;IACrC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;IAC7B,CAAC;CACF;AAED;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,WAA6B,EAC7B,EACE,WAAW,GAAG,CAAC,EACf,SAAS,GAAG,GAAG,MACiC,EAAE;IAEpD,IAAI,SAAS,CAAC;IACd,IAAI,OAAO,GAAG,SAAS,CAAC;IACxB,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,WAAW,EAAE,OAAO,EAAE,EAAE,CAAC;QACxD,IAAI,CAAC;YACH,OAAO,MAAM,WAAW,EAAE,CAAC;QAC7B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,SAAS,GAAG,KAAK,CAAC;YAClB,IAAI,OAAO,IAAI,WAAW,EAAE,CAAC;gBAC3B,MAAM;YACR,CAAC;YACD,MAAM,KAAK,GAAG,OAAO,CAAC;YACtB,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;YAC3D,OAAO,IAAI,CAAC,CAAC;QACf,CAAC;IACH,CAAC;IACD,MAAM,SAAS,CAAC;AAClB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,OAAmB,EACnB,YAAoB,GAAG;IAEvB,IAAI,KAAK,CAAC;IACV,IAAI,CAAC;QACH,OAAO,MAAM,OAAO,CAAC,IAAI,CAAI;YAC3B,OAAO;YACP,IAAI,OAAO,CAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE;gBAClC,KAAK,GAAG,UAAU,CAChB,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,YAAY,CAAC,WAAW,CAAC,CAAC,EAC3C,SAAS,CACV,CAAC;YACJ,CAAC,CAAC;SACH,CAAC,CAAC;IACL,CAAC;YAAS,CAAC;QACT,IAAI,KAAK,EAAE,CAAC;YACV,YAAY,CAAC,KAAK,CAAC,CAAC;QACtB,CAAC;IACH,CAAC;AACH,CAAC","sourcesContent":["/** Timeout error. */\nexport class TimeoutError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = 'TimeoutError';\n  }\n}\n\n/**\n * Execute a function with exponential backoff on transient failures.\n *\n * @param fnToExecute - The function to execute.\n * @param options - The options for the retry.\n * @param options.maxAttempts - The maximum number of attempts.\n * @param options.backOffMs - The backoff in milliseconds.\n * @throws An error if the transaction count cannot be retrieved.\n * @returns The result of the function.\n */\nexport async function withRetry<T>(\n  fnToExecute: () => Promise<T>,\n  {\n    maxAttempts = 3,\n    backOffMs = 500,\n  }: { maxAttempts?: number; backOffMs?: number } = {},\n): Promise<T> {\n  let lastError;\n  let backOff = backOffMs;\n  for (let attempt = 1; attempt <= maxAttempts; attempt++) {\n    try {\n      return await fnToExecute();\n    } catch (error) {\n      lastError = error;\n      if (attempt >= maxAttempts) {\n        break;\n      }\n      const delay = backOff;\n      await new Promise((resolve) => setTimeout(resolve, delay));\n      backOff *= 2;\n    }\n  }\n  throw lastError;\n}\n\n/**\n * Execute a promise with a timeout.\n *\n * @param promise - The promise to execute.\n * @param timeoutMs - The timeout in milliseconds.\n * @returns The result of the promise.\n */\nexport async function withTimeout<T>(\n  promise: Promise<T>,\n  timeoutMs: number = 500,\n): Promise<T> {\n  let timer;\n  try {\n    return await Promise.race<T>([\n      promise,\n      new Promise<T>((_resolve, reject) => {\n        timer = setTimeout(\n          () => reject(new TimeoutError('Timed out')),\n          timeoutMs,\n        );\n      }),\n    ]);\n  } finally {\n    if (timer) {\n      clearTimeout(timer);\n    }\n  }\n}\n"]}
+{"version":3,"file":"utils.mjs","sourceRoot":"","sources":["../../src/providers/utils.ts"],"names":[],"mappings":"AAAA,qBAAqB;AACrB,MAAM,OAAO,YAAa,SAAQ,KAAK;IACrC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;IAC7B,CAAC;CACF;AAED;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,KAAc;IAC3C,OAAO,KAAK,YAAY,YAAY,CAAC;AACvC,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,WAA6B,EAC7B,EACE,WAAW,GAAG,CAAC,EACf,SAAS,GAAG,GAAG,MACiC,EAAE;IAEpD,IAAI,SAAS,CAAC;IACd,IAAI,OAAO,GAAG,SAAS,CAAC;IACxB,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,WAAW,EAAE,OAAO,EAAE,EAAE,CAAC;QACxD,IAAI,CAAC;YACH,OAAO,MAAM,WAAW,EAAE,CAAC;QAC7B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,SAAS,GAAG,KAAK,CAAC;YAClB,IAAI,OAAO,IAAI,WAAW,EAAE,CAAC;gBAC3B,MAAM;YACR,CAAC;YACD,MAAM,KAAK,GAAG,OAAO,CAAC;YACtB,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;YAC3D,OAAO,IAAI,CAAC,CAAC;QACf,CAAC;IACH,CAAC;IACD,MAAM,SAAS,CAAC;AAClB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,EAAoB,EACpB,YAAoB,GAAG;IAEvB,IAAI,KAAK,CAAC;IACV,IAAI,CAAC;QACH,OAAO,MAAM,OAAO,CAAC,IAAI,CAAI;YAC3B,EAAE,EAAE;YACJ,IAAI,OAAO,CAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE;gBAClC,KAAK,GAAG,UAAU,CAChB,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,YAAY,CAAC,oBAAoB,SAAS,IAAI,CAAC,CAAC,EACjE,SAAS,CACV,CAAC;YACJ,CAAC,CAAC;SACH,CAAC,CAAC;IACL,CAAC;YAAS,CAAC;QACT,IAAI,KAAK,EAAE,CAAC;YACV,YAAY,CAAC,KAAK,CAAC,CAAC;QACtB,CAAC;IACH,CAAC;AACH,CAAC","sourcesContent":["/** Timeout error. */\nexport class TimeoutError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = 'TimeoutError';\n  }\n}\n\n/**\n * Check if an error is a `TimeoutError`.\n *\n * @param error - The error to check.\n * @returns `true` if the error is a `TimeoutError`, otherwise `false`.\n */\nexport function isTimeoutError(error: unknown): error is TimeoutError {\n  return error instanceof TimeoutError;\n}\n\n/**\n * Execute a function with exponential backoff on transient failures.\n *\n * @param fnToExecute - The function to execute.\n * @param options - The options for the retry.\n * @param options.maxAttempts - The maximum number of attempts.\n * @param options.backOffMs - The backoff in milliseconds.\n * @throws An error if the transaction count cannot be retrieved.\n * @returns The result of the function.\n */\nexport async function withRetry<T>(\n  fnToExecute: () => Promise<T>,\n  {\n    maxAttempts = 3,\n    backOffMs = 500,\n  }: { maxAttempts?: number; backOffMs?: number } = {},\n): Promise<T> {\n  let lastError;\n  let backOff = backOffMs;\n  for (let attempt = 1; attempt <= maxAttempts; attempt++) {\n    try {\n      return await fnToExecute();\n    } catch (error) {\n      lastError = error;\n      if (attempt >= maxAttempts) {\n        break;\n      }\n      const delay = backOff;\n      await new Promise((resolve) => setTimeout(resolve, delay));\n      backOff *= 2;\n    }\n  }\n  throw lastError;\n}\n\n/**\n * Execute a promise with a timeout.\n *\n * @param fn - A callback that returns the promise to execute.\n * @param timeoutMs - The timeout in milliseconds.\n * @returns The result of the promise.\n */\nexport async function withTimeout<T>(\n  fn: () => Promise<T>,\n  timeoutMs: number = 500,\n): Promise<T> {\n  let timer;\n  try {\n    return await Promise.race<T>([\n      fn(),\n      new Promise<T>((_resolve, reject) => {\n        timer = setTimeout(\n          () => reject(new TimeoutError(`Timed out after: ${timeoutMs}ms`)),\n          timeoutMs,\n        );\n      }),\n    ]);\n  } finally {\n    if (timer) {\n      clearTimeout(timer);\n    }\n  }\n}\n"]}

package/dist/snaps/SnapPlatformWatcher.cjs

@@ -10,21 +10,37 @@ var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (
     if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
     return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
 };
-var _SnapPlatformWatcher_instances, _SnapPlatformWatcher_messenger, _SnapPlatformWatcher_ensureOnboardingComplete, _SnapPlatformWatcher_isReadyOnce, _SnapPlatformWatcher_isReady, _SnapPlatformWatcher_watch;
+var _SnapPlatformWatcher_instances, _SnapPlatformWatcher_messenger, _SnapPlatformWatcher_ensureOnboardingComplete, _SnapPlatformWatcher_snapKeyringWaitTimeoutMs, _SnapPlatformWatcher_isReadyOnce, _SnapPlatformWatcher_isReady, _SnapPlatformWatcher_waitForSnapKeyring, _SnapPlatformWatcher_hasSnapKeyring, _SnapPlatformWatcher_waitForSnapKeyringViaStateChange, _SnapPlatformWatcher_watch;
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SnapPlatformWatcher = void 0;
+exports.SnapPlatformWatcher = exports.DEFAULT_SNAP_KEYRING_WAIT_TIMEOUT_MS = void 0;
+const keyring_controller_1 = require("@metamask/keyring-controller");
 const utils_1 = require("@metamask/utils");
 const lodash_1 = require("lodash");
 const logger_1 = require("../logger.cjs");
+/** Default wait for Snap keyring to appear before rejecting (ms). */
+exports.DEFAULT_SNAP_KEYRING_WAIT_TIMEOUT_MS = 5000;
+/** Error message when Snap keyring does not appear within the timeout. */
+const SNAP_KEYRING_TIMEOUT_MESSAGE = 'Snap platform or keyrings still not ready. Aborting.';
+/**
+ * Returns true if the given KeyringController state slice contains a Snap keyring.
+ *
+ * @param state - KeyringController state.
+ * @returns True if state.keyrings contains a keyring with type KeyringTypes.snap.
+ */
+function stateHasSnapKeyring(state) {
+    return state.keyrings.some((k) => k.type === keyring_controller_1.KeyringTypes.snap);
+}
 class SnapPlatformWatcher {
     constructor(messenger, options = {}) {
         _SnapPlatformWatcher_instances.add(this);
         _SnapPlatformWatcher_messenger.set(this, void 0);
         _SnapPlatformWatcher_ensureOnboardingComplete.set(this, void 0);
+        _SnapPlatformWatcher_snapKeyringWaitTimeoutMs.set(this, void 0);
         _SnapPlatformWatcher_isReadyOnce.set(this, void 0);
         _SnapPlatformWatcher_isReady.set(this, void 0);
         __classPrivateFieldSet(this, _SnapPlatformWatcher_messenger, messenger, "f");
         __classPrivateFieldSet(this, _SnapPlatformWatcher_ensureOnboardingComplete, options.ensureOnboardingComplete, "f");
+        __classPrivateFieldSet(this, _SnapPlatformWatcher_snapKeyringWaitTimeoutMs, options.snapKeyringWaitTimeoutMs ?? exports.DEFAULT_SNAP_KEYRING_WAIT_TIMEOUT_MS, "f");
         __classPrivateFieldSet(this, _SnapPlatformWatcher_isReady, false, "f");
         __classPrivateFieldSet(this, _SnapPlatformWatcher_isReadyOnce, (0, utils_1.createDeferredPromise)(), "f");
         __classPrivateFieldGet(this, _SnapPlatformWatcher_instances, "m", _SnapPlatformWatcher_watch).call(this);
@@ -40,10 +56,57 @@ class SnapPlatformWatcher {
         if (!__classPrivateFieldGet(this, _SnapPlatformWatcher_isReady, "f")) {
             throw new Error('Snap platform cannot be used now.');
         }
+        // After a restore/reset, the Snap keyring is created lazily by the client (e.g. when
+        // getSnapKeyring() is called). Non-EVM account creation needs the keyring to exist, so we
+        // wait for it here with a timeout to avoid "Keyring not found" errors.
+        await __classPrivateFieldGet(this, _SnapPlatformWatcher_instances, "m", _SnapPlatformWatcher_waitForSnapKeyring).call(this);
     }
 }
 exports.SnapPlatformWatcher = SnapPlatformWatcher;
-_SnapPlatformWatcher_messenger = new WeakMap(), _SnapPlatformWatcher_ensureOnboardingComplete = new WeakMap(), _SnapPlatformWatcher_isReadyOnce = new WeakMap(), _SnapPlatformWatcher_isReady = new WeakMap(), _SnapPlatformWatcher_instances = new WeakSet(), _SnapPlatformWatcher_watch = function _SnapPlatformWatcher_watch() {
+_SnapPlatformWatcher_messenger = new WeakMap(), _SnapPlatformWatcher_ensureOnboardingComplete = new WeakMap(), _SnapPlatformWatcher_snapKeyringWaitTimeoutMs = new WeakMap(), _SnapPlatformWatcher_isReadyOnce = new WeakMap(), _SnapPlatformWatcher_isReady = new WeakMap(), _SnapPlatformWatcher_instances = new WeakSet(), _SnapPlatformWatcher_waitForSnapKeyring = 
+/**
+ * Waits for KeyringController to have a Snap keyring available.
+ * Checks once, then subscribes to KeyringController:stateChange until the keyring
+ * appears or the timeout is reached (then throws).
+ */
+async function _SnapPlatformWatcher_waitForSnapKeyring() {
+    if (__classPrivateFieldGet(this, _SnapPlatformWatcher_instances, "m", _SnapPlatformWatcher_hasSnapKeyring).call(this)) {
+        return;
+    }
+    await __classPrivateFieldGet(this, _SnapPlatformWatcher_instances, "m", _SnapPlatformWatcher_waitForSnapKeyringViaStateChange).call(this);
+}, _SnapPlatformWatcher_hasSnapKeyring = function _SnapPlatformWatcher_hasSnapKeyring() {
+    try {
+        const state = __classPrivateFieldGet(this, _SnapPlatformWatcher_messenger, "f").call('KeyringController:getState');
+        return stateHasSnapKeyring(state);
+    }
+    catch (error) {
+        (0, logger_1.projectLogger)(`${logger_1.WARNING_PREFIX} KeyringController error while waiting for Snap keyring:`, error);
+        return false;
+    }
+}, _SnapPlatformWatcher_waitForSnapKeyringViaStateChange = 
+/**
+ * Subscribes to KeyringController:stateChange and resolves when a Snap keyring
+ * appears in state, or rejects with an error after the timeout.
+ */
+async function _SnapPlatformWatcher_waitForSnapKeyringViaStateChange() {
+    await new Promise((resolve, reject) => {
+        const timeoutRef = {
+            id: undefined,
+        };
+        const listener = (keyrings) => {
+            if (stateHasSnapKeyring({ keyrings })) {
+                clearTimeout(timeoutRef.id);
+                __classPrivateFieldGet(this, _SnapPlatformWatcher_messenger, "f").unsubscribe('KeyringController:stateChange', listener);
+                resolve();
+            }
+        };
+        timeoutRef.id = setTimeout(() => {
+            __classPrivateFieldGet(this, _SnapPlatformWatcher_messenger, "f").unsubscribe('KeyringController:stateChange', listener);
+            reject(new Error(SNAP_KEYRING_TIMEOUT_MESSAGE));
+        }, __classPrivateFieldGet(this, _SnapPlatformWatcher_snapKeyringWaitTimeoutMs, "f"));
+        __classPrivateFieldGet(this, _SnapPlatformWatcher_messenger, "f").subscribe('KeyringController:stateChange', listener, (state) => state.keyrings);
+    });
+}, _SnapPlatformWatcher_watch = function _SnapPlatformWatcher_watch() {
     const logReadyOnce = (0, lodash_1.once)(() => (0, logger_1.projectLogger)('Snap platform is ready!'));
     const initialState = __classPrivateFieldGet(this, _SnapPlatformWatcher_messenger, "f").call('SnapController:getState');
     if (initialState.isReady) {

package/dist/snaps/SnapPlatformWatcher.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"SnapPlatformWatcher.cjs","sourceRoot":"","sources":["../../src/snaps/SnapPlatformWatcher.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AAAA,2CAAyE;AACzE,mCAA8B;AAE9B,0CAAiD;AAUjD,MAAa,mBAAmB;IAS9B,YACE,SAA4C,EAC5C,UAAsC,EAAE;;QAVjC,iDAA8C;QAE9C,gEAAgD;QAEhD,mDAAoC;QAE7C,+CAAkB;QAMhB,uBAAA,IAAI,kCAAc,SAAS,MAAA,CAAC;QAC5B,uBAAA,IAAI,iDAA6B,OAAO,CAAC,wBAAwB,MAAA,CAAC;QAElE,uBAAA,IAAI,gCAAY,KAAK,MAAA,CAAC;QACtB,uBAAA,IAAI,oCAAgB,IAAA,6BAAqB,GAAQ,MAAA,CAAC;QAElD,uBAAA,IAAI,kEAAO,MAAX,IAAI,CAAS,CAAC;IAChB,CAAC;IAED,IAAI,OAAO;QACT,OAAO,uBAAA,IAAI,oCAAS,CAAC;IACvB,CAAC;IAED,KAAK,CAAC,wBAAwB;QAC5B,4EAA4E;QAC5E,MAAM,uBAAA,IAAI,qDAA0B,EAAE,KAAhC,IAAI,CAA8B,CAAC;QAEzC,6EAA6E;QAC7E,MAAM,uBAAA,IAAI,wCAAa,CAAC,OAAO,CAAC;QAEhC,IAAI,CAAC,uBAAA,IAAI,oCAAS,EAAE,CAAC;YACnB,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;QACvD,CAAC;IACH,CAAC;CAwBF;AA5DD,kDA4DC;;IArBG,MAAM,YAAY,GAAG,IAAA,aAAI,EAAC,GAAG,EAAE,CAAC,IAAA,sBAAG,EAAC,yBAAyB,CAAC,CAAC,CAAC;IAEhE,MAAM,YAAY,GAAG,uBAAA,IAAI,sCAAW,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC;IACrE,IAAI,YAAY,CAAC,OAAO,EAAE,CAAC;QACzB,uBAAA,IAAI,gCAAY,IAAI,MAAA,CAAC;QACrB,uBAAA,IAAI,wCAAa,CAAC,OAAO,EAAE,CAAC;IAC9B,CAAC;IAED,uBAAA,IAAI,sCAAW,CAAC,SAAS,CACvB,4BAA4B,EAC5B,CAAC,OAAgB,EAAE,EAAE;QACnB,uBAAA,IAAI,gCAAY,OAAO,MAAA,CAAC;QAExB,IAAI,OAAO,EAAE,CAAC;YACZ,YAAY,EAAE,CAAC;YACf,uBAAA,IAAI,wCAAa,CAAC,OAAO,EAAE,CAAC;QAC9B,CAAC;IACH,CAAC,EACD,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CACzB,CAAC;AACJ,CAAC","sourcesContent":["import { createDeferredPromise, DeferredPromise } from '@metamask/utils';\nimport { once } from 'lodash';\n\nimport { projectLogger as log } from '../logger';\nimport { MultichainAccountServiceMessenger } from '../types';\n\nexport type SnapPlatformWatcherOptions = {\n  /**\n   * Resolves when onboarding is complete.\n   */\n  ensureOnboardingComplete?: () => Promise<void>;\n};\n\nexport class SnapPlatformWatcher {\n  readonly #messenger: MultichainAccountServiceMessenger;\n\n  readonly #ensureOnboardingComplete?: () => Promise<void>;\n\n  readonly #isReadyOnce: DeferredPromise<void>;\n\n  #isReady: boolean;\n\n  constructor(\n    messenger: MultichainAccountServiceMessenger,\n    options: SnapPlatformWatcherOptions = {},\n  ) {\n    this.#messenger = messenger;\n    this.#ensureOnboardingComplete = options.ensureOnboardingComplete;\n\n    this.#isReady = false;\n    this.#isReadyOnce = createDeferredPromise<void>();\n\n    this.#watch();\n  }\n\n  get isReady(): boolean {\n    return this.#isReady;\n  }\n\n  async ensureCanUseSnapPlatform(): Promise<void> {\n    // When ensureOnboardingComplete is provided, wait for the onboarding first.\n    await this.#ensureOnboardingComplete?.();\n\n    // In all cases, we also require the Snap platform to be ready and available.\n    await this.#isReadyOnce.promise;\n\n    if (!this.#isReady) {\n      throw new Error('Snap platform cannot be used now.');\n    }\n  }\n\n  #watch(): void {\n    const logReadyOnce = once(() => log('Snap platform is ready!'));\n\n    const initialState = this.#messenger.call('SnapController:getState');\n    if (initialState.isReady) {\n      this.#isReady = true;\n      this.#isReadyOnce.resolve();\n    }\n\n    this.#messenger.subscribe(\n      'SnapController:stateChange',\n      (isReady: boolean) => {\n        this.#isReady = isReady;\n\n        if (isReady) {\n          logReadyOnce();\n          this.#isReadyOnce.resolve();\n        }\n      },\n      (state) => state.isReady,\n    );\n  }\n}\n"]}
+{"version":3,"file":"SnapPlatformWatcher.cjs","sourceRoot":"","sources":["../../src/snaps/SnapPlatformWatcher.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AAAA,qEAA4D;AAC5D,2CAAyE;AACzE,mCAA8B;AAE9B,0CAAiE;AAQjE,qEAAqE;AACxD,QAAA,oCAAoC,GAAG,IAAK,CAAC;AAE1D,0EAA0E;AAC1E,MAAM,4BAA4B,GAChC,sDAAsD,CAAC;AAEzD;;;;;GAKG;AACH,SAAS,mBAAmB,CAAC,KAAkC;IAC7D,OAAO,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,iCAAY,CAAC,IAAI,CAAC,CAAC;AAClE,CAAC;AAeD,MAAa,mBAAmB;IAW9B,YACE,SAA4C,EAC5C,UAAsC,EAAE;;QAZjC,iDAA8C;QAE9C,gEAAgD;QAEhD,gEAAkC;QAElC,mDAAoC;QAE7C,+CAAkB;QAMhB,uBAAA,IAAI,kCAAc,SAAS,MAAA,CAAC;QAC5B,uBAAA,IAAI,iDAA6B,OAAO,CAAC,wBAAwB,MAAA,CAAC;QAClE,uBAAA,IAAI,iDACF,OAAO,CAAC,wBAAwB,IAAI,4CAAoC,MAAA,CAAC;QAE3E,uBAAA,IAAI,gCAAY,KAAK,MAAA,CAAC;QACtB,uBAAA,IAAI,oCAAgB,IAAA,6BAAqB,GAAQ,MAAA,CAAC;QAElD,uBAAA,IAAI,kEAAO,MAAX,IAAI,CAAS,CAAC;IAChB,CAAC;IAED,IAAI,OAAO;QACT,OAAO,uBAAA,IAAI,oCAAS,CAAC;IACvB,CAAC;IAED,KAAK,CAAC,wBAAwB;QAC5B,4EAA4E;QAC5E,MAAM,uBAAA,IAAI,qDAA0B,EAAE,KAAhC,IAAI,CAA8B,CAAC;QAEzC,6EAA6E;QAC7E,MAAM,uBAAA,IAAI,wCAAa,CAAC,OAAO,CAAC;QAEhC,IAAI,CAAC,uBAAA,IAAI,oCAAS,EAAE,CAAC;YACnB,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;QACvD,CAAC;QAED,qFAAqF;QACrF,0FAA0F;QAC1F,uEAAuE;QACvE,MAAM,uBAAA,IAAI,+EAAoB,MAAxB,IAAI,CAAsB,CAAC;IACnC,CAAC;CA6FF;AA1ID,kDA0IC;;AA3FC;;;;GAIG;AACH,KAAK;IACH,IAAI,uBAAA,IAAI,2EAAgB,MAApB,IAAI,CAAkB,EAAE,CAAC;QAC3B,OAAO;IACT,CAAC;IACD,MAAM,uBAAA,IAAI,6FAAkC,MAAtC,IAAI,CAAoC,CAAC;AACjD,CAAC;IASC,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,uBAAA,IAAI,sCAAW,CAAC,IAAI,CAChC,4BAA4B,CACE,CAAC;QACjC,OAAO,mBAAmB,CAAC,KAAK,CAAC,CAAC;IACpC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAA,sBAAG,EACD,GAAG,uBAAc,0DAA0D,EAC3E,KAAK,CACN,CAAC;QACF,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,KAAK;IACH,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QAC1C,MAAM,UAAU,GAAsD;YACpE,EAAE,EAAE,SAAS;SACd,CAAC;QAEF,MAAM,QAAQ,GAAG,CACf,QAAiD,EAC3C,EAAE;YACR,IAAI,mBAAmB,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;gBACtC,YAAY,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;gBAC5B,uBAAA,IAAI,sCAAW,CAAC,WAAW,CACzB,+BAA+B,EAC/B,QAAQ,CACT,CAAC;gBACF,OAAO,EAAE,CAAC;YACZ,CAAC;QACH,CAAC,CAAC;QAEF,UAAU,CAAC,EAAE,GAAG,UAAU,CAAC,GAAG,EAAE;YAC9B,uBAAA,IAAI,sCAAW,CAAC,WAAW,CAAC,+BAA+B,EAAE,QAAQ,CAAC,CAAC;YACvE,MAAM,CAAC,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC,CAAC;QAClD,CAAC,EAAE,uBAAA,IAAI,qDAA0B,CAAC,CAAC;QAEnC,uBAAA,IAAI,sCAAW,CAAC,SAAS,CACvB,+BAA+B,EAC/B,QAAQ,EACR,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,CAC1B,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;IAGC,MAAM,YAAY,GAAG,IAAA,aAAI,EAAC,GAAG,EAAE,CAAC,IAAA,sBAAG,EAAC,yBAAyB,CAAC,CAAC,CAAC;IAEhE,MAAM,YAAY,GAAG,uBAAA,IAAI,sCAAW,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC;IACrE,IAAI,YAAY,CAAC,OAAO,EAAE,CAAC;QACzB,uBAAA,IAAI,gCAAY,IAAI,MAAA,CAAC;QACrB,uBAAA,IAAI,wCAAa,CAAC,OAAO,EAAE,CAAC;IAC9B,CAAC;IAED,uBAAA,IAAI,sCAAW,CAAC,SAAS,CACvB,4BAA4B,EAC5B,CAAC,OAAgB,EAAE,EAAE;QACnB,uBAAA,IAAI,gCAAY,OAAO,MAAA,CAAC;QAExB,IAAI,OAAO,EAAE,CAAC;YACZ,YAAY,EAAE,CAAC;YACf,uBAAA,IAAI,wCAAa,CAAC,OAAO,EAAE,CAAC;QAC9B,CAAC;IACH,CAAC,EACD,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CACzB,CAAC;AACJ,CAAC","sourcesContent":["import { KeyringTypes } from '@metamask/keyring-controller';\nimport { createDeferredPromise, DeferredPromise } from '@metamask/utils';\nimport { once } from 'lodash';\n\nimport { projectLogger as log, WARNING_PREFIX } from '../logger';\nimport { MultichainAccountServiceMessenger } from '../types';\n\n/** Minimal KeyringController state shape needed to detect Snap keyring. */\ntype KeyringControllerStateSlice = {\n  keyrings: { type: string }[];\n};\n\n/** Default wait for Snap keyring to appear before rejecting (ms). */\nexport const DEFAULT_SNAP_KEYRING_WAIT_TIMEOUT_MS = 5_000;\n\n/** Error message when Snap keyring does not appear within the timeout. */\nconst SNAP_KEYRING_TIMEOUT_MESSAGE =\n  'Snap platform or keyrings still not ready. Aborting.';\n\n/**\n * Returns true if the given KeyringController state slice contains a Snap keyring.\n *\n * @param state - KeyringController state.\n * @returns True if state.keyrings contains a keyring with type KeyringTypes.snap.\n */\nfunction stateHasSnapKeyring(state: KeyringControllerStateSlice): boolean {\n  return state.keyrings.some((k) => k.type === KeyringTypes.snap);\n}\n\nexport type SnapPlatformWatcherOptions = {\n  /**\n   * Resolves when onboarding is complete.\n   */\n  ensureOnboardingComplete?: () => Promise<void>;\n  /**\n   * How long to wait for the Snap keyring to appear before rejecting (ms).\n   *\n   * @default DEFAULT_SNAP_KEYRING_WAIT_TIMEOUT_MS\n   */\n  snapKeyringWaitTimeoutMs?: number;\n};\n\nexport class SnapPlatformWatcher {\n  readonly #messenger: MultichainAccountServiceMessenger;\n\n  readonly #ensureOnboardingComplete?: () => Promise<void>;\n\n  readonly #snapKeyringWaitTimeoutMs: number;\n\n  readonly #isReadyOnce: DeferredPromise<void>;\n\n  #isReady: boolean;\n\n  constructor(\n    messenger: MultichainAccountServiceMessenger,\n    options: SnapPlatformWatcherOptions = {},\n  ) {\n    this.#messenger = messenger;\n    this.#ensureOnboardingComplete = options.ensureOnboardingComplete;\n    this.#snapKeyringWaitTimeoutMs =\n      options.snapKeyringWaitTimeoutMs ?? DEFAULT_SNAP_KEYRING_WAIT_TIMEOUT_MS;\n\n    this.#isReady = false;\n    this.#isReadyOnce = createDeferredPromise<void>();\n\n    this.#watch();\n  }\n\n  get isReady(): boolean {\n    return this.#isReady;\n  }\n\n  async ensureCanUseSnapPlatform(): Promise<void> {\n    // When ensureOnboardingComplete is provided, wait for the onboarding first.\n    await this.#ensureOnboardingComplete?.();\n\n    // In all cases, we also require the Snap platform to be ready and available.\n    await this.#isReadyOnce.promise;\n\n    if (!this.#isReady) {\n      throw new Error('Snap platform cannot be used now.');\n    }\n\n    // After a restore/reset, the Snap keyring is created lazily by the client (e.g. when\n    // getSnapKeyring() is called). Non-EVM account creation needs the keyring to exist, so we\n    // wait for it here with a timeout to avoid \"Keyring not found\" errors.\n    await this.#waitForSnapKeyring();\n  }\n\n  /**\n   * Waits for KeyringController to have a Snap keyring available.\n   * Checks once, then subscribes to KeyringController:stateChange until the keyring\n   * appears or the timeout is reached (then throws).\n   */\n  async #waitForSnapKeyring(): Promise<void> {\n    if (this.#hasSnapKeyring()) {\n      return;\n    }\n    await this.#waitForSnapKeyringViaStateChange();\n  }\n\n  /**\n   * Returns true if KeyringController already has a Snap keyring.\n   * Logs and returns false on error.\n   *\n   * @returns True if a Snap keyring exists, false otherwise or on error.\n   */\n  #hasSnapKeyring(): boolean {\n    try {\n      const state = this.#messenger.call(\n        'KeyringController:getState',\n      ) as KeyringControllerStateSlice;\n      return stateHasSnapKeyring(state);\n    } catch (error) {\n      log(\n        `${WARNING_PREFIX} KeyringController error while waiting for Snap keyring:`,\n        error,\n      );\n      return false;\n    }\n  }\n\n  /**\n   * Subscribes to KeyringController:stateChange and resolves when a Snap keyring\n   * appears in state, or rejects with an error after the timeout.\n   */\n  async #waitForSnapKeyringViaStateChange(): Promise<void> {\n    await new Promise<void>((resolve, reject) => {\n      const timeoutRef: { id: ReturnType<typeof setTimeout> | undefined } = {\n        id: undefined,\n      };\n\n      const listener = (\n        keyrings: KeyringControllerStateSlice['keyrings'],\n      ): void => {\n        if (stateHasSnapKeyring({ keyrings })) {\n          clearTimeout(timeoutRef.id);\n          this.#messenger.unsubscribe(\n            'KeyringController:stateChange',\n            listener,\n          );\n          resolve();\n        }\n      };\n\n      timeoutRef.id = setTimeout(() => {\n        this.#messenger.unsubscribe('KeyringController:stateChange', listener);\n        reject(new Error(SNAP_KEYRING_TIMEOUT_MESSAGE));\n      }, this.#snapKeyringWaitTimeoutMs);\n\n      this.#messenger.subscribe(\n        'KeyringController:stateChange',\n        listener,\n        (state) => state.keyrings,\n      );\n    });\n  }\n\n  #watch(): void {\n    const logReadyOnce = once(() => log('Snap platform is ready!'));\n\n    const initialState = this.#messenger.call('SnapController:getState');\n    if (initialState.isReady) {\n      this.#isReady = true;\n      this.#isReadyOnce.resolve();\n    }\n\n    this.#messenger.subscribe(\n      'SnapController:stateChange',\n      (isReady: boolean) => {\n        this.#isReady = isReady;\n\n        if (isReady) {\n          logReadyOnce();\n          this.#isReadyOnce.resolve();\n        }\n      },\n      (state) => state.isReady,\n    );\n  }\n}\n"]}

package/dist/snaps/SnapPlatformWatcher.d.cts

@@ -1,9 +1,17 @@
 import { MultichainAccountServiceMessenger } from "../types.cjs";
+/** Default wait for Snap keyring to appear before rejecting (ms). */
+export declare const DEFAULT_SNAP_KEYRING_WAIT_TIMEOUT_MS = 5000;
 export type SnapPlatformWatcherOptions = {
     /**
      * Resolves when onboarding is complete.
      */
     ensureOnboardingComplete?: () => Promise<void>;
+    /**
+     * How long to wait for the Snap keyring to appear before rejecting (ms).
+     *
+     * @default DEFAULT_SNAP_KEYRING_WAIT_TIMEOUT_MS
+     */
+    snapKeyringWaitTimeoutMs?: number;
 };
 export declare class SnapPlatformWatcher {
     #private;