@metamask-previews/account-api 0.2.0-e017e7a → 0.5.0-0e28ac0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (56) hide show
  1. package/CHANGELOG.md +28 -1
  2. package/dist/api/group.cjs +13 -1
  3. package/dist/api/group.cjs.map +1 -1
  4. package/dist/api/group.d.cts +23 -3
  5. package/dist/api/group.d.cts.map +1 -1
  6. package/dist/api/group.d.mts +23 -3
  7. package/dist/api/group.d.mts.map +1 -1
  8. package/dist/api/group.mjs +12 -0
  9. package/dist/api/group.mjs.map +1 -1
  10. package/dist/api/multichain/group.cjs +42 -0
  11. package/dist/api/multichain/group.cjs.map +1 -0
  12. package/dist/api/multichain/group.d.cts +68 -0
  13. package/dist/api/multichain/group.d.cts.map +1 -0
  14. package/dist/api/multichain/group.d.mts +68 -0
  15. package/dist/api/multichain/group.d.mts.map +1 -0
  16. package/dist/api/multichain/group.mjs +37 -0
  17. package/dist/api/multichain/group.mjs.map +1 -0
  18. package/dist/api/multichain/index.cjs +1 -1
  19. package/dist/api/multichain/index.cjs.map +1 -1
  20. package/dist/api/multichain/index.d.cts +1 -1
  21. package/dist/api/multichain/index.d.cts.map +1 -1
  22. package/dist/api/multichain/index.d.mts +1 -1
  23. package/dist/api/multichain/index.d.mts.map +1 -1
  24. package/dist/api/multichain/index.mjs +1 -1
  25. package/dist/api/multichain/index.mjs.map +1 -1
  26. package/dist/api/multichain/wallet.cjs +1 -140
  27. package/dist/api/multichain/wallet.cjs.map +1 -1
  28. package/dist/api/multichain/wallet.d.cts +11 -45
  29. package/dist/api/multichain/wallet.d.cts.map +1 -1
  30. package/dist/api/multichain/wallet.d.mts +11 -45
  31. package/dist/api/multichain/wallet.d.mts.map +1 -1
  32. package/dist/api/multichain/wallet.mjs +2 -139
  33. package/dist/api/multichain/wallet.mjs.map +1 -1
  34. package/dist/api/provider.cjs.map +1 -1
  35. package/dist/api/provider.d.cts +2 -3
  36. package/dist/api/provider.d.cts.map +1 -1
  37. package/dist/api/provider.d.mts +2 -3
  38. package/dist/api/provider.d.mts.map +1 -1
  39. package/dist/api/provider.mjs.map +1 -1
  40. package/dist/api/wallet.cjs +19 -23
  41. package/dist/api/wallet.cjs.map +1 -1
  42. package/dist/api/wallet.d.cts +20 -19
  43. package/dist/api/wallet.d.cts.map +1 -1
  44. package/dist/api/wallet.d.mts +20 -19
  45. package/dist/api/wallet.d.mts.map +1 -1
  46. package/dist/api/wallet.mjs +18 -22
  47. package/dist/api/wallet.mjs.map +1 -1
  48. package/package.json +3 -3
  49. package/dist/api/multichain/account.cjs +0 -213
  50. package/dist/api/multichain/account.cjs.map +0 -1
  51. package/dist/api/multichain/account.d.cts +0 -103
  52. package/dist/api/multichain/account.d.cts.map +0 -1
  53. package/dist/api/multichain/account.d.mts +0 -103
  54. package/dist/api/multichain/account.d.mts.map +0 -1
  55. package/dist/api/multichain/account.mjs +0 -206
  56. package/dist/api/multichain/account.mjs.map +0 -1
@@ -1 +0,0 @@
1
- {"version":3,"file":"account.d.cts","sourceRoot":"","sources":["../../../src/api/multichain/account.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,cAAc,EAAE,8BAA8B;AAG5D,OAAO,KAAK,EACV,uBAAuB,EACvB,yBAAyB,EAC1B,qBAAiB;AAClB,OAAO,KAAK,EAAE,YAAY,EAAE,qBAAiB;AAC7C,OAAO,KAAK,EAAE,YAAY,EAAE,qBAAiB;AAC7C,OAAO,KAAK,EAAE,eAAe,EAAE,wBAAoB;AACnD,OAAO,KAAK,EAAE,eAAe,EAAE,wBAAoB;AAQnD;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,GAAG,yBAAyB,IAAI,MAAM,EAAE,CAAC;AAE3E;;GAEG;AACH,qBAAa,iBAAiB,CAAC,OAAO,SAAS,YAAY,CAAC,cAAc,CAAC,CACzE,YAAW,YAAY,CAAC,OAAO,CAAC;;gBAcpB,EACV,UAAU,EACV,MAAM,EACN,SAAS,GACV,EAAE;QACD,UAAU,EAAE,MAAM,CAAC;QACnB,MAAM,EAAE,uBAAuB,CAAC,OAAO,CAAC,CAAC;QACzC,SAAS,EAAE,eAAe,CAAC,OAAO,CAAC,EAAE,CAAC;KACvC;IAWD;;;;;OAKG;IACH,IAAI,IAAI,IAAI;IA0BZ;;;;OAIG;IACH,IAAI,EAAE,IAAI,mBAAmB,CAE5B;IAED;;;;OAIG;IACH,IAAI,MAAM,IAAI,uBAAuB,CAAC,OAAO,CAAC,CAE7C;IAED;;;;OAIG;IACH,IAAI,KAAK,IAAI,MAAM,CAElB;IAED;;;;OAIG;IACH,WAAW,IAAI,OAAO;IAKtB;;;;OAIG;IACH,WAAW,IAAI,OAAO,EAAE;IAYxB;;;;;OAKG;IACH,UAAU,CAAC,EAAE,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,GAAG,SAAS;IAWlD;;;;;;OAMG;IACH,GAAG,CAAC,QAAQ,EAAE,eAAe,CAAC,OAAO,CAAC,GAAG,OAAO,GAAG,SAAS;IAgB5D;;;;;OAKG;IACH,MAAM,CAAC,QAAQ,EAAE,eAAe,CAAC,OAAO,CAAC,GAAG,OAAO,EAAE;CA8BtD;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,yBAAyB,EACnC,UAAU,EAAE,MAAM,GACjB,mBAAmB,CAErB;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,MAAM,GACZ,KAAK,IAAI,mBAAmB,CAE9B;AAED;;;;;GAKG;AACH,wBAAgB,oCAAoC,CAClD,EAAE,EAAE,mBAAmB,GACtB,MAAM,CASR"}
@@ -1,103 +0,0 @@
1
- import { type KeyringAccount } from "@metamask/keyring-api";
2
- import type { MultichainAccountWallet, MultichainAccountWalletId } from "./wallet.mjs";
3
- import type { Bip44Account } from "../bip44.mjs";
4
- import type { AccountGroup } from "../group.mjs";
5
- import type { AccountProvider } from "../provider.mjs";
6
- import type { AccountSelector } from "../selector.mjs";
7
- /**
8
- * Multichain account ID.
9
- */
10
- export type MultichainAccountId = `${MultichainAccountWalletId}/${number}`;
11
- /**
12
- * A multichain account that holds multiple accounts.
13
- */
14
- export declare class MultichainAccount<Account extends Bip44Account<KeyringAccount>> implements AccountGroup<Account> {
15
- #private;
16
- constructor({ groupIndex, wallet, providers, }: {
17
- groupIndex: number;
18
- wallet: MultichainAccountWallet<Account>;
19
- providers: AccountProvider<Account>[];
20
- });
21
- /**
22
- * Force multichain account synchronization.
23
- *
24
- * This can be used if account providers got new accounts that the multichain
25
- * account doesn't know about.
26
- */
27
- sync(): void;
28
- /**
29
- * Gets the multichain account ID.
30
- *
31
- * @returns The multichain account ID.
32
- */
33
- get id(): MultichainAccountId;
34
- /**
35
- * Gets the multichain account's wallet reference (parent).
36
- *
37
- * @returns The multichain account's wallet.
38
- */
39
- get wallet(): MultichainAccountWallet<Account>;
40
- /**
41
- * Gets the multichain account group index.
42
- *
43
- * @returns The multichain account group index.
44
- */
45
- get index(): number;
46
- /**
47
- * Checks if there's any underlying accounts for this multichain accounts.
48
- *
49
- * @returns True if there's any underlying accounts, false otherwise.
50
- */
51
- hasAccounts(): boolean;
52
- /**
53
- * Gets the accounts for this multichain account.
54
- *
55
- * @returns The accounts.
56
- */
57
- getAccounts(): Account[];
58
- /**
59
- * Gets the account for a given account ID.
60
- *
61
- * @param id - Account ID.
62
- * @returns The account or undefined if not found.
63
- */
64
- getAccount(id: Account['id']): Account | undefined;
65
- /**
66
- * Query an account matching the selector.
67
- *
68
- * @param selector - Query selector.
69
- * @returns The account matching the selector or undefined if not matching.
70
- * @throws If multiple accounts match the selector.
71
- */
72
- get(selector: AccountSelector<Account>): Account | undefined;
73
- /**
74
- * Query accounts matching the selector.
75
- *
76
- * @param selector - Query selector.
77
- * @returns The accounts matching the selector.
78
- */
79
- select(selector: AccountSelector<Account>): Account[];
80
- }
81
- /**
82
- * Gets the multichain account ID from its multichain account wallet ID and its index.
83
- *
84
- * @param walletId - Multichain account wallet ID.
85
- * @param groupIndex - Index of that multichain account.
86
- * @returns The multichain account ID.
87
- */
88
- export declare function toMultichainAccountId(walletId: MultichainAccountWalletId, groupIndex: number): MultichainAccountId;
89
- /**
90
- * Checks if the given value is {@link MultichainAccountId}.
91
- *
92
- * @param value - The value to check.
93
- * @returns Whether the value is a {@link MultichainAccountId}.
94
- */
95
- export declare function isMultichainAccountId(value: string): value is MultichainAccountId;
96
- /**
97
- * Gets the multichain account index from an account group ID.
98
- *
99
- * @param id - Multichain account ID.
100
- * @returns The multichain account index if extractable, undefined otherwise.
101
- */
102
- export declare function getGroupIndexFromMultichainAccountId(id: MultichainAccountId): number;
103
- //# sourceMappingURL=account.d.mts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"account.d.mts","sourceRoot":"","sources":["../../../src/api/multichain/account.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,cAAc,EAAE,8BAA8B;AAG5D,OAAO,KAAK,EACV,uBAAuB,EACvB,yBAAyB,EAC1B,qBAAiB;AAClB,OAAO,KAAK,EAAE,YAAY,EAAE,qBAAiB;AAC7C,OAAO,KAAK,EAAE,YAAY,EAAE,qBAAiB;AAC7C,OAAO,KAAK,EAAE,eAAe,EAAE,wBAAoB;AACnD,OAAO,KAAK,EAAE,eAAe,EAAE,wBAAoB;AAQnD;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,GAAG,yBAAyB,IAAI,MAAM,EAAE,CAAC;AAE3E;;GAEG;AACH,qBAAa,iBAAiB,CAAC,OAAO,SAAS,YAAY,CAAC,cAAc,CAAC,CACzE,YAAW,YAAY,CAAC,OAAO,CAAC;;gBAcpB,EACV,UAAU,EACV,MAAM,EACN,SAAS,GACV,EAAE;QACD,UAAU,EAAE,MAAM,CAAC;QACnB,MAAM,EAAE,uBAAuB,CAAC,OAAO,CAAC,CAAC;QACzC,SAAS,EAAE,eAAe,CAAC,OAAO,CAAC,EAAE,CAAC;KACvC;IAWD;;;;;OAKG;IACH,IAAI,IAAI,IAAI;IA0BZ;;;;OAIG;IACH,IAAI,EAAE,IAAI,mBAAmB,CAE5B;IAED;;;;OAIG;IACH,IAAI,MAAM,IAAI,uBAAuB,CAAC,OAAO,CAAC,CAE7C;IAED;;;;OAIG;IACH,IAAI,KAAK,IAAI,MAAM,CAElB;IAED;;;;OAIG;IACH,WAAW,IAAI,OAAO;IAKtB;;;;OAIG;IACH,WAAW,IAAI,OAAO,EAAE;IAYxB;;;;;OAKG;IACH,UAAU,CAAC,EAAE,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,GAAG,SAAS;IAWlD;;;;;;OAMG;IACH,GAAG,CAAC,QAAQ,EAAE,eAAe,CAAC,OAAO,CAAC,GAAG,OAAO,GAAG,SAAS;IAgB5D;;;;;OAKG;IACH,MAAM,CAAC,QAAQ,EAAE,eAAe,CAAC,OAAO,CAAC,GAAG,OAAO,EAAE;CA8BtD;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,yBAAyB,EACnC,UAAU,EAAE,MAAM,GACjB,mBAAmB,CAErB;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,MAAM,GACZ,KAAK,IAAI,mBAAmB,CAE9B;AAED;;;;;GAKG;AACH,wBAAgB,oCAAoC,CAClD,EAAE,EAAE,mBAAmB,GACtB,MAAM,CASR"}
@@ -1,206 +0,0 @@
1
- var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
2
- if (kind === "m") throw new TypeError("Private method is not writable");
3
- if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
4
- if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
5
- return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
6
- };
7
- var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
8
- if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
9
- 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");
10
- return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
11
- };
12
- var _MultichainAccount_id, _MultichainAccount_wallet, _MultichainAccount_index, _MultichainAccount_providers, _MultichainAccount_accounts, _MultichainAccount_reverse;
13
- import { isScopeEqualToAny } from "@metamask/keyring-utils";
14
- import { AccountWalletCategory } from "../wallet.mjs";
15
- const MULTICHAIN_ACCOUNT_ID_REGEX = new RegExp(`^${AccountWalletCategory.Entropy}:.*/(?<groupIndex>\\d+)$`, 'u');
16
- /**
17
- * A multichain account that holds multiple accounts.
18
- */
19
- export class MultichainAccount {
20
- constructor({ groupIndex, wallet, providers, }) {
21
- _MultichainAccount_id.set(this, void 0);
22
- _MultichainAccount_wallet.set(this, void 0);
23
- _MultichainAccount_index.set(this, void 0);
24
- _MultichainAccount_providers.set(this, void 0);
25
- _MultichainAccount_accounts.set(this, void 0);
26
- _MultichainAccount_reverse.set(this, void 0);
27
- __classPrivateFieldSet(this, _MultichainAccount_id, toMultichainAccountId(wallet.id, groupIndex), "f");
28
- __classPrivateFieldSet(this, _MultichainAccount_index, groupIndex, "f");
29
- __classPrivateFieldSet(this, _MultichainAccount_wallet, wallet, "f");
30
- __classPrivateFieldSet(this, _MultichainAccount_providers, providers, "f");
31
- __classPrivateFieldSet(this, _MultichainAccount_accounts, new Map(), "f");
32
- __classPrivateFieldSet(this, _MultichainAccount_reverse, new Map(), "f");
33
- this.sync();
34
- }
35
- /**
36
- * Force multichain account synchronization.
37
- *
38
- * This can be used if account providers got new accounts that the multichain
39
- * account doesn't know about.
40
- */
41
- sync() {
42
- // Clear reverse mapping and re-construct it entirely based on the refreshed
43
- // list of accounts from each providers.
44
- __classPrivateFieldGet(this, _MultichainAccount_reverse, "f").clear();
45
- for (const provider of __classPrivateFieldGet(this, _MultichainAccount_providers, "f")) {
46
- // Filter account only for that index.
47
- const accounts = [];
48
- for (const account of provider.getAccounts()) {
49
- if (account.options.entropy.id === this.wallet.entropySource &&
50
- account.options.entropy.groupIndex === this.index) {
51
- // We only use IDs to always fetch the latest version of accounts.
52
- accounts.push(account.id);
53
- }
54
- }
55
- __classPrivateFieldGet(this, _MultichainAccount_accounts, "f").set(provider, accounts);
56
- // Reverse-mapping for fast indexing.
57
- for (const id of accounts) {
58
- __classPrivateFieldGet(this, _MultichainAccount_reverse, "f").set(id, provider);
59
- }
60
- }
61
- }
62
- /**
63
- * Gets the multichain account ID.
64
- *
65
- * @returns The multichain account ID.
66
- */
67
- get id() {
68
- return __classPrivateFieldGet(this, _MultichainAccount_id, "f");
69
- }
70
- /**
71
- * Gets the multichain account's wallet reference (parent).
72
- *
73
- * @returns The multichain account's wallet.
74
- */
75
- get wallet() {
76
- return __classPrivateFieldGet(this, _MultichainAccount_wallet, "f");
77
- }
78
- /**
79
- * Gets the multichain account group index.
80
- *
81
- * @returns The multichain account group index.
82
- */
83
- get index() {
84
- return __classPrivateFieldGet(this, _MultichainAccount_index, "f");
85
- }
86
- /**
87
- * Checks if there's any underlying accounts for this multichain accounts.
88
- *
89
- * @returns True if there's any underlying accounts, false otherwise.
90
- */
91
- hasAccounts() {
92
- // If there's anything in the reverse-map, it means we have some accounts.
93
- return __classPrivateFieldGet(this, _MultichainAccount_reverse, "f").size > 0;
94
- }
95
- /**
96
- * Gets the accounts for this multichain account.
97
- *
98
- * @returns The accounts.
99
- */
100
- getAccounts() {
101
- let allAccounts = [];
102
- for (const [provider, accounts] of __classPrivateFieldGet(this, _MultichainAccount_accounts, "f").entries()) {
103
- allAccounts = allAccounts.concat(accounts.map((id) => provider.getAccount(id)));
104
- }
105
- return allAccounts;
106
- }
107
- /**
108
- * Gets the account for a given account ID.
109
- *
110
- * @param id - Account ID.
111
- * @returns The account or undefined if not found.
112
- */
113
- getAccount(id) {
114
- const provider = __classPrivateFieldGet(this, _MultichainAccount_reverse, "f").get(id);
115
- // If there's nothing in the map, it means we tried to get an account
116
- // that does not belong to this multichain account.
117
- if (!provider) {
118
- return undefined;
119
- }
120
- return provider.getAccount(id);
121
- }
122
- /**
123
- * Query an account matching the selector.
124
- *
125
- * @param selector - Query selector.
126
- * @returns The account matching the selector or undefined if not matching.
127
- * @throws If multiple accounts match the selector.
128
- */
129
- get(selector) {
130
- const accounts = this.select(selector);
131
- if (accounts.length > 1) {
132
- throw new Error(`Too many account candidates, expected 1, got: ${accounts.length}`);
133
- }
134
- if (accounts.length === 0) {
135
- return undefined;
136
- }
137
- return accounts[0]; // This is safe, see checks above.
138
- }
139
- /**
140
- * Query accounts matching the selector.
141
- *
142
- * @param selector - Query selector.
143
- * @returns The accounts matching the selector.
144
- */
145
- select(selector) {
146
- return this.getAccounts().filter((account) => {
147
- let selected = true;
148
- if (selector.id) {
149
- selected && (selected = account.id === selector.id);
150
- }
151
- if (selector.address) {
152
- selected && (selected = account.address === selector.address);
153
- }
154
- if (selector.type) {
155
- selected && (selected = account.type === selector.type);
156
- }
157
- if (selector.methods !== undefined) {
158
- selected && (selected = selector.methods.some((method) => account.methods.includes(method)));
159
- }
160
- if (selector.scopes !== undefined) {
161
- selected && (selected = selector.scopes.some((scope) => {
162
- return (
163
- // This will cover specific EVM EOA scopes as well.
164
- isScopeEqualToAny(scope, account.scopes));
165
- }));
166
- }
167
- return selected;
168
- });
169
- }
170
- }
171
- _MultichainAccount_id = new WeakMap(), _MultichainAccount_wallet = new WeakMap(), _MultichainAccount_index = new WeakMap(), _MultichainAccount_providers = new WeakMap(), _MultichainAccount_accounts = new WeakMap(), _MultichainAccount_reverse = new WeakMap();
172
- /**
173
- * Gets the multichain account ID from its multichain account wallet ID and its index.
174
- *
175
- * @param walletId - Multichain account wallet ID.
176
- * @param groupIndex - Index of that multichain account.
177
- * @returns The multichain account ID.
178
- */
179
- export function toMultichainAccountId(walletId, groupIndex) {
180
- return `${walletId}/${groupIndex}`;
181
- }
182
- /**
183
- * Checks if the given value is {@link MultichainAccountId}.
184
- *
185
- * @param value - The value to check.
186
- * @returns Whether the value is a {@link MultichainAccountId}.
187
- */
188
- export function isMultichainAccountId(value) {
189
- return MULTICHAIN_ACCOUNT_ID_REGEX.test(value);
190
- }
191
- /**
192
- * Gets the multichain account index from an account group ID.
193
- *
194
- * @param id - Multichain account ID.
195
- * @returns The multichain account index if extractable, undefined otherwise.
196
- */
197
- export function getGroupIndexFromMultichainAccountId(id) {
198
- const matched = id.match(MULTICHAIN_ACCOUNT_ID_REGEX);
199
- if (matched?.groups?.groupIndex === undefined) {
200
- // Unable to extract group index, even though, type wise, this should not
201
- // be possible!
202
- throw new Error('Unable to extract group index');
203
- }
204
- return Number(matched.groups.groupIndex);
205
- }
206
- //# sourceMappingURL=account.mjs.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"account.mjs","sourceRoot":"","sources":["../../../src/api/multichain/account.ts"],"names":[],"mappings":"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","sourcesContent":["import { type KeyringAccount } from '@metamask/keyring-api';\nimport { isScopeEqualToAny } from '@metamask/keyring-utils';\n\nimport type {\n MultichainAccountWallet,\n MultichainAccountWalletId,\n} from './wallet';\nimport type { Bip44Account } from '../bip44';\nimport type { AccountGroup } from '../group';\nimport type { AccountProvider } from '../provider';\nimport type { AccountSelector } from '../selector';\nimport { AccountWalletCategory } from '../wallet';\n\nconst MULTICHAIN_ACCOUNT_ID_REGEX = new RegExp(\n `^${AccountWalletCategory.Entropy}:.*/(?<groupIndex>\\\\d+)$`,\n 'u',\n);\n\n/**\n * Multichain account ID.\n */\nexport type MultichainAccountId = `${MultichainAccountWalletId}/${number}`; // Use number for the account group index.\n\n/**\n * A multichain account that holds multiple accounts.\n */\nexport class MultichainAccount<Account extends Bip44Account<KeyringAccount>>\n implements AccountGroup<Account>\n{\n readonly #id: MultichainAccountId;\n\n readonly #wallet: MultichainAccountWallet<Account>;\n\n readonly #index: number;\n\n readonly #providers: AccountProvider<Account>[];\n\n readonly #accounts: Map<AccountProvider<Account>, Account['id'][]>;\n\n readonly #reverse: Map<Account['id'], AccountProvider<Account>>;\n\n constructor({\n groupIndex,\n wallet,\n providers,\n }: {\n groupIndex: number;\n wallet: MultichainAccountWallet<Account>;\n providers: AccountProvider<Account>[];\n }) {\n this.#id = toMultichainAccountId(wallet.id, groupIndex);\n this.#index = groupIndex;\n this.#wallet = wallet;\n this.#providers = providers;\n this.#accounts = new Map();\n this.#reverse = new Map();\n\n this.sync();\n }\n\n /**\n * Force multichain account synchronization.\n *\n * This can be used if account providers got new accounts that the multichain\n * account doesn't know about.\n */\n sync(): void {\n // Clear reverse mapping and re-construct it entirely based on the refreshed\n // list of accounts from each providers.\n this.#reverse.clear();\n\n for (const provider of this.#providers) {\n // Filter account only for that index.\n const accounts = [];\n for (const account of provider.getAccounts()) {\n if (\n account.options.entropy.id === this.wallet.entropySource &&\n account.options.entropy.groupIndex === this.index\n ) {\n // We only use IDs to always fetch the latest version of accounts.\n accounts.push(account.id);\n }\n }\n this.#accounts.set(provider, accounts);\n\n // Reverse-mapping for fast indexing.\n for (const id of accounts) {\n this.#reverse.set(id, provider);\n }\n }\n }\n\n /**\n * Gets the multichain account ID.\n *\n * @returns The multichain account ID.\n */\n get id(): MultichainAccountId {\n return this.#id;\n }\n\n /**\n * Gets the multichain account's wallet reference (parent).\n *\n * @returns The multichain account's wallet.\n */\n get wallet(): MultichainAccountWallet<Account> {\n return this.#wallet;\n }\n\n /**\n * Gets the multichain account group index.\n *\n * @returns The multichain account group index.\n */\n get index(): number {\n return this.#index;\n }\n\n /**\n * Checks if there's any underlying accounts for this multichain accounts.\n *\n * @returns True if there's any underlying accounts, false otherwise.\n */\n hasAccounts(): boolean {\n // If there's anything in the reverse-map, it means we have some accounts.\n return this.#reverse.size > 0;\n }\n\n /**\n * Gets the accounts for this multichain account.\n *\n * @returns The accounts.\n */\n getAccounts(): Account[] {\n let allAccounts: Account[] = [];\n\n for (const [provider, accounts] of this.#accounts.entries()) {\n allAccounts = allAccounts.concat(\n accounts.map((id) => provider.getAccount(id)),\n );\n }\n\n return allAccounts;\n }\n\n /**\n * Gets the account for a given account ID.\n *\n * @param id - Account ID.\n * @returns The account or undefined if not found.\n */\n getAccount(id: Account['id']): Account | undefined {\n const provider = this.#reverse.get(id);\n\n // If there's nothing in the map, it means we tried to get an account\n // that does not belong to this multichain account.\n if (!provider) {\n return undefined;\n }\n return provider.getAccount(id);\n }\n\n /**\n * Query an account matching the selector.\n *\n * @param selector - Query selector.\n * @returns The account matching the selector or undefined if not matching.\n * @throws If multiple accounts match the selector.\n */\n get(selector: AccountSelector<Account>): Account | undefined {\n const accounts = this.select(selector);\n\n if (accounts.length > 1) {\n throw new Error(\n `Too many account candidates, expected 1, got: ${accounts.length}`,\n );\n }\n\n if (accounts.length === 0) {\n return undefined;\n }\n\n return accounts[0]; // This is safe, see checks above.\n }\n\n /**\n * Query accounts matching the selector.\n *\n * @param selector - Query selector.\n * @returns The accounts matching the selector.\n */\n select(selector: AccountSelector<Account>): Account[] {\n return this.getAccounts().filter((account) => {\n let selected = true;\n\n if (selector.id) {\n selected &&= account.id === selector.id;\n }\n if (selector.address) {\n selected &&= account.address === selector.address;\n }\n if (selector.type) {\n selected &&= account.type === selector.type;\n }\n if (selector.methods !== undefined) {\n selected &&= selector.methods.some((method) =>\n account.methods.includes(method),\n );\n }\n if (selector.scopes !== undefined) {\n selected &&= selector.scopes.some((scope) => {\n return (\n // This will cover specific EVM EOA scopes as well.\n isScopeEqualToAny(scope, account.scopes)\n );\n });\n }\n\n return selected;\n });\n }\n}\n\n/**\n * Gets the multichain account ID from its multichain account wallet ID and its index.\n *\n * @param walletId - Multichain account wallet ID.\n * @param groupIndex - Index of that multichain account.\n * @returns The multichain account ID.\n */\nexport function toMultichainAccountId(\n walletId: MultichainAccountWalletId,\n groupIndex: number,\n): MultichainAccountId {\n return `${walletId}/${groupIndex}`;\n}\n\n/**\n * Checks if the given value is {@link MultichainAccountId}.\n *\n * @param value - The value to check.\n * @returns Whether the value is a {@link MultichainAccountId}.\n */\nexport function isMultichainAccountId(\n value: string,\n): value is MultichainAccountId {\n return MULTICHAIN_ACCOUNT_ID_REGEX.test(value);\n}\n\n/**\n * Gets the multichain account index from an account group ID.\n *\n * @param id - Multichain account ID.\n * @returns The multichain account index if extractable, undefined otherwise.\n */\nexport function getGroupIndexFromMultichainAccountId(\n id: MultichainAccountId,\n): number {\n const matched = id.match(MULTICHAIN_ACCOUNT_ID_REGEX);\n if (matched?.groups?.groupIndex === undefined) {\n // Unable to extract group index, even though, type wise, this should not\n // be possible!\n throw new Error('Unable to extract group index');\n }\n\n return Number(matched.groups.groupIndex);\n}\n"]}