@reown/appkit 1.6.9 → 1.7.0-alpha.0

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 (97) hide show
  1. package/dist/esm/exports/basic.js +11 -0
  2. package/dist/esm/exports/basic.js.map +1 -0
  3. package/dist/esm/exports/constants.js +1 -1
  4. package/dist/esm/exports/constants.js.map +1 -1
  5. package/dist/esm/exports/index.js +1 -3
  6. package/dist/esm/exports/index.js.map +1 -1
  7. package/dist/esm/exports/react.js +1 -3
  8. package/dist/esm/exports/react.js.map +1 -1
  9. package/dist/esm/exports/vue.js +1 -3
  10. package/dist/esm/exports/vue.js.map +1 -1
  11. package/dist/esm/package.json +19 -3
  12. package/dist/esm/src/adapters/ChainAdapterBlueprint.js +0 -1
  13. package/dist/esm/src/adapters/ChainAdapterBlueprint.js.map +1 -1
  14. package/dist/esm/src/client/appkit-basic.js +35 -0
  15. package/dist/esm/src/client/appkit-basic.js.map +1 -0
  16. package/dist/esm/src/client/appkit.js +385 -0
  17. package/dist/esm/src/client/appkit.js.map +1 -0
  18. package/dist/esm/src/client/core.js +1348 -0
  19. package/dist/esm/src/client/core.js.map +1 -0
  20. package/dist/esm/tests/client/adapter-management.test.js +83 -0
  21. package/dist/esm/tests/client/adapter-management.test.js.map +1 -0
  22. package/dist/esm/tests/client/appkit-basic.test.js +68 -0
  23. package/dist/esm/tests/client/appkit-basic.test.js.map +1 -0
  24. package/dist/esm/tests/client/balance.test.js +54 -0
  25. package/dist/esm/tests/client/balance.test.js.map +1 -0
  26. package/dist/esm/tests/client/connection.test.js +137 -0
  27. package/dist/esm/tests/client/connection.test.js.map +1 -0
  28. package/dist/esm/tests/client/initialization.test.js +122 -0
  29. package/dist/esm/tests/client/initialization.test.js.map +1 -0
  30. package/dist/esm/tests/client/listeners.test.js +53 -0
  31. package/dist/esm/tests/client/listeners.test.js.map +1 -0
  32. package/dist/esm/tests/client/public-methods.test.js +683 -0
  33. package/dist/esm/tests/client/public-methods.test.js.map +1 -0
  34. package/dist/esm/tests/client/universal-adapter.test.js +44 -0
  35. package/dist/esm/tests/client/universal-adapter.test.js.map +1 -0
  36. package/dist/esm/tests/client/walletconnect-events.test.js +80 -0
  37. package/dist/esm/tests/client/walletconnect-events.test.js.map +1 -0
  38. package/dist/esm/tests/connectors/WalletConnectConnector.test.js +63 -0
  39. package/dist/esm/tests/connectors/WalletConnectConnector.test.js.map +1 -0
  40. package/dist/esm/tests/mocks/Account.js +13 -0
  41. package/dist/esm/tests/mocks/Account.js.map +1 -0
  42. package/dist/esm/tests/mocks/Adapter.js +95 -0
  43. package/dist/esm/tests/mocks/Adapter.js.map +1 -0
  44. package/dist/esm/tests/mocks/AppKit.js +24 -0
  45. package/dist/esm/tests/mocks/AppKit.js.map +1 -0
  46. package/dist/esm/tests/mocks/Networks.js +17 -0
  47. package/dist/esm/tests/mocks/Networks.js.map +1 -0
  48. package/dist/esm/tests/mocks/Options.js +17 -0
  49. package/dist/esm/tests/mocks/Options.js.map +1 -0
  50. package/dist/esm/tests/mocks/Providers.js +46 -0
  51. package/dist/esm/tests/mocks/Providers.js.map +1 -0
  52. package/dist/esm/tests/mocks/UniversalProvider.js +139 -0
  53. package/dist/esm/tests/mocks/UniversalProvider.js.map +1 -0
  54. package/dist/esm/tests/siwe.test.js +261 -0
  55. package/dist/esm/tests/siwe.test.js.map +1 -0
  56. package/dist/esm/tests/test-utils.js +39 -0
  57. package/dist/esm/tests/test-utils.js.map +1 -0
  58. package/dist/esm/tests/universal-adapter.test.js +246 -0
  59. package/dist/esm/tests/universal-adapter.test.js.map +1 -0
  60. package/dist/esm/tests/utils/HelpersUtil.test.js +229 -0
  61. package/dist/esm/tests/utils/HelpersUtil.test.js.map +1 -0
  62. package/dist/esm/tsconfig.build.tsbuildinfo +1 -1
  63. package/dist/esm/tsconfig.tsbuildinfo +1 -0
  64. package/dist/types/exports/basic.d.ts +8 -0
  65. package/dist/types/exports/constants.d.ts +1 -1
  66. package/dist/types/exports/index.d.ts +2 -3
  67. package/dist/types/exports/react.d.ts +2 -3
  68. package/dist/types/exports/vue.d.ts +2 -3
  69. package/dist/types/src/adapters/ChainAdapterBlueprint.d.ts +3 -3
  70. package/dist/types/src/client/appkit-basic.d.ts +24 -0
  71. package/dist/types/src/client/appkit.d.ts +24 -0
  72. package/dist/types/src/client/core.d.ts +208 -0
  73. package/dist/types/src/library/react/index.d.ts +1 -1
  74. package/dist/types/src/library/vue/index.d.ts +2 -2
  75. package/dist/types/src/utils/TypesUtil.d.ts +5 -0
  76. package/dist/types/tests/client/adapter-management.test.d.ts +1 -0
  77. package/dist/types/tests/client/appkit-basic.test.d.ts +1 -0
  78. package/dist/types/tests/client/balance.test.d.ts +1 -0
  79. package/dist/types/tests/client/connection.test.d.ts +1 -0
  80. package/dist/types/tests/client/initialization.test.d.ts +1 -0
  81. package/dist/types/tests/client/listeners.test.d.ts +1 -0
  82. package/dist/types/tests/client/public-methods.test.d.ts +1 -0
  83. package/dist/types/tests/client/universal-adapter.test.d.ts +1 -0
  84. package/dist/types/tests/client/walletconnect-events.test.d.ts +1 -0
  85. package/dist/types/tests/connectors/WalletConnectConnector.test.d.ts +1 -0
  86. package/dist/types/tests/mocks/Account.d.ts +12 -0
  87. package/dist/types/tests/mocks/Adapter.d.ts +5 -0
  88. package/dist/types/tests/mocks/AppKit.d.ts +3 -0
  89. package/dist/types/tests/mocks/Networks.d.ts +4 -0
  90. package/dist/types/tests/mocks/Options.d.ts +6 -0
  91. package/dist/types/tests/mocks/Providers.d.ts +42 -0
  92. package/dist/types/tests/mocks/UniversalProvider.d.ts +3 -0
  93. package/dist/types/tests/siwe.test.d.ts +1 -0
  94. package/dist/types/tests/test-utils.d.ts +6 -0
  95. package/dist/types/tests/universal-adapter.test.d.ts +1 -0
  96. package/dist/types/tests/utils/HelpersUtil.test.d.ts +1 -0
  97. package/package.json +26 -10
@@ -0,0 +1,1348 @@
1
+ import UniversalProvider from '@walletconnect/universal-provider';
2
+ import { ConstantsUtil, NetworkUtil, ParseUtil } from '@reown/appkit-common';
3
+ import { AccountController, AlertController, AssetUtil, BlockchainApiController, ChainController, ConnectionController, ConnectorController, CoreHelperUtil, EnsController, EventsController, ModalController, OptionsController, PublicStateController, RouterController, SnackController, StorageUtil, ThemeController } from '@reown/appkit-core';
4
+ import { WalletUtil } from '@reown/appkit-scaffold-ui/utils';
5
+ import { setColorTheme, setThemeVariables } from '@reown/appkit-ui';
6
+ import { CaipNetworksUtil, ErrorUtil, HelpersUtil, LoggerUtil, ConstantsUtil as UtilConstantsUtil } from '@reown/appkit-utils';
7
+ import { ProviderUtil } from '../store/ProviderUtil.js';
8
+ import { UniversalAdapter } from '../universal-adapter/client.js';
9
+ import { WcHelpersUtil } from '../utils/index.js';
10
+ export class AppKitCore {
11
+ constructor(options) {
12
+ this.chainNamespaces = [];
13
+ this.reportedAlertErrors = {};
14
+ // -- Public Internal ---------------------------------------------------
15
+ this.getCaipNetwork = (chainNamespace) => {
16
+ if (chainNamespace) {
17
+ return ChainController.getRequestedCaipNetworks(chainNamespace).filter(c => c.chainNamespace === chainNamespace)?.[0];
18
+ }
19
+ return ChainController.state.activeCaipNetwork || this.defaultCaipNetwork;
20
+ };
21
+ this.getCaipNetworkId = () => {
22
+ const network = this.getCaipNetwork();
23
+ if (network) {
24
+ return network.id;
25
+ }
26
+ return undefined;
27
+ };
28
+ this.getCaipNetworks = (namespace) => ChainController.getRequestedCaipNetworks(namespace);
29
+ this.getActiveChainNamespace = () => ChainController.state.activeChain;
30
+ this.setRequestedCaipNetworks = (requestedCaipNetworks, chain) => {
31
+ ChainController.setRequestedCaipNetworks(requestedCaipNetworks, chain);
32
+ };
33
+ this.getApprovedCaipNetworkIds = () => ChainController.getAllApprovedCaipNetworkIds();
34
+ this.getCaipAddress = (chainNamespace) => {
35
+ if (ChainController.state.activeChain === chainNamespace || !chainNamespace) {
36
+ return ChainController.state.activeCaipAddress;
37
+ }
38
+ return ChainController.getAccountProp('caipAddress', chainNamespace);
39
+ };
40
+ this.setClientId = clientId => {
41
+ BlockchainApiController.setClientId(clientId);
42
+ };
43
+ this.getProvider = (namespace) => ProviderUtil.getProvider(namespace);
44
+ this.getProviderType = (namespace) => ProviderUtil.state.providerIds[namespace];
45
+ this.getPreferredAccountType = () => AccountController.state.preferredAccountType;
46
+ this.setCaipAddress = (caipAddress, chain) => {
47
+ AccountController.setCaipAddress(caipAddress, chain);
48
+ };
49
+ this.setBalance = (balance, balanceSymbol, chain) => {
50
+ AccountController.setBalance(balance, balanceSymbol, chain);
51
+ };
52
+ this.setProfileName = (profileName, chain) => {
53
+ AccountController.setProfileName(profileName, chain);
54
+ };
55
+ this.setProfileImage = (profileImage, chain) => {
56
+ AccountController.setProfileImage(profileImage, chain);
57
+ };
58
+ this.setUser = (user, chain) => {
59
+ AccountController.setUser(user, chain);
60
+ if (OptionsController.state.enableEmbedded) {
61
+ ModalController.close();
62
+ }
63
+ };
64
+ this.resetAccount = (chain) => {
65
+ AccountController.resetAccount(chain);
66
+ };
67
+ this.setCaipNetwork = caipNetwork => {
68
+ ChainController.setActiveCaipNetwork(caipNetwork);
69
+ };
70
+ this.setAllAccounts = (addresses, chain) => {
71
+ AccountController.setAllAccounts(addresses, chain);
72
+ OptionsController.setHasMultipleAddresses(addresses?.length > 1);
73
+ };
74
+ this.setStatus = (status, chain) => {
75
+ StorageUtil.setConnectionStatus(status);
76
+ AccountController.setStatus(status, chain);
77
+ };
78
+ this.getAddressByChainNamespace = (chainNamespace) => ChainController.getAccountProp('address', chainNamespace);
79
+ this.setConnectors = connectors => {
80
+ const allConnectors = [...ConnectorController.getConnectors(), ...connectors];
81
+ ConnectorController.setConnectors(allConnectors);
82
+ };
83
+ this.fetchIdentity = request => BlockchainApiController.fetchIdentity(request);
84
+ this.getReownName = address => EnsController.getNamesForAddress(address);
85
+ this.getConnectors = () => ConnectorController.getConnectors();
86
+ this.getConnectorImage = connector => AssetUtil.getConnectorImage(connector);
87
+ this.setConnectedWalletInfo = (connectedWalletInfo, chain) => {
88
+ const type = ProviderUtil.getProviderId(chain);
89
+ const walletInfo = connectedWalletInfo ? { ...connectedWalletInfo, type } : undefined;
90
+ AccountController.setConnectedWalletInfo(walletInfo, chain);
91
+ };
92
+ this.getIsConnectedState = () => Boolean(ChainController.state.activeCaipAddress);
93
+ this.addAddressLabel = (address, label, chain) => {
94
+ AccountController.addAddressLabel(address, label, chain);
95
+ };
96
+ this.removeAddressLabel = (address, chain) => {
97
+ AccountController.removeAddressLabel(address, chain);
98
+ };
99
+ this.getAddress = (chainNamespace) => {
100
+ if (ChainController.state.activeChain === chainNamespace || !chainNamespace) {
101
+ return AccountController.state.address;
102
+ }
103
+ return ChainController.getAccountProp('address', chainNamespace);
104
+ };
105
+ this.setApprovedCaipNetworksData = namespace => ChainController.setApprovedCaipNetworksData(namespace);
106
+ this.resetNetwork = (namespace) => {
107
+ ChainController.resetNetwork(namespace);
108
+ };
109
+ this.addConnector = connector => {
110
+ ConnectorController.addConnector(connector);
111
+ };
112
+ this.resetWcConnection = () => {
113
+ ConnectionController.resetWcConnection();
114
+ };
115
+ this.setAddressExplorerUrl = (addressExplorerUrl, chain) => {
116
+ AccountController.setAddressExplorerUrl(addressExplorerUrl, chain);
117
+ };
118
+ this.setSmartAccountDeployed = (isDeployed, chain) => {
119
+ AccountController.setSmartAccountDeployed(isDeployed, chain);
120
+ };
121
+ this.setSmartAccountEnabledNetworks = (smartAccountEnabledNetworks, chain) => {
122
+ ChainController.setSmartAccountEnabledNetworks(smartAccountEnabledNetworks, chain);
123
+ };
124
+ this.setPreferredAccountType = (preferredAccountType, chain) => {
125
+ AccountController.setPreferredAccountType(preferredAccountType, chain);
126
+ };
127
+ this.setEIP6963Enabled = enabled => {
128
+ OptionsController.setEIP6963Enabled(enabled);
129
+ };
130
+ this.handleUnsafeRPCRequest = () => {
131
+ if (this.isOpen()) {
132
+ // If we are on the modal but there is no transaction stack, close the modal
133
+ if (this.isTransactionStackEmpty()) {
134
+ return;
135
+ }
136
+ // Check if we need to replace or redirect
137
+ this.redirect('ApproveTransaction');
138
+ }
139
+ else {
140
+ // If called from outside the modal, open ApproveTransaction
141
+ this.open({ view: 'ApproveTransaction' });
142
+ }
143
+ };
144
+ this.options = options;
145
+ this.version = options.sdkVersion;
146
+ this.caipNetworks = this.extendCaipNetworks(options);
147
+ this.chainNamespaces = [
148
+ ...new Set(this.caipNetworks?.map(caipNetwork => caipNetwork.chainNamespace))
149
+ ];
150
+ this.defaultCaipNetwork = this.extendDefaultCaipNetwork(options);
151
+ this.chainAdapters = this.createAdapters(options.adapters);
152
+ this.initialize(options);
153
+ this.sendInitializeEvent(options);
154
+ }
155
+ async initialize(options) {
156
+ this.initControllers(options);
157
+ await this.initChainAdapters();
158
+ await this.injectModalUi();
159
+ await this.syncExistingConnection();
160
+ PublicStateController.set({ initialized: true });
161
+ }
162
+ sendInitializeEvent(options) {
163
+ const { ...optionsCopy } = options;
164
+ delete optionsCopy.adapters;
165
+ EventsController.sendEvent({
166
+ type: 'track',
167
+ event: 'INITIALIZE',
168
+ properties: {
169
+ ...optionsCopy,
170
+ networks: options.networks.map(n => n.id),
171
+ siweConfig: {
172
+ options: options.siweConfig?.options || {}
173
+ }
174
+ }
175
+ });
176
+ }
177
+ // -- Controllers initialization ---------------------------------------------------
178
+ initControllers(options) {
179
+ this.initializeOptionsController(options);
180
+ this.initializeChainController(options);
181
+ this.initializeThemeController(options);
182
+ this.initializeConnectionController(options);
183
+ }
184
+ initializeThemeController(options) {
185
+ if (options.themeMode) {
186
+ ThemeController.setThemeMode(options.themeMode);
187
+ }
188
+ if (options.themeVariables) {
189
+ ThemeController.setThemeVariables(options.themeVariables);
190
+ }
191
+ }
192
+ initializeChainController(options) {
193
+ if (!this.connectionControllerClient || !this.networkControllerClient) {
194
+ throw new Error('ConnectionControllerClient and NetworkControllerClient must be set');
195
+ }
196
+ ChainController.initialize(options.adapters ?? [], this.caipNetworks, {
197
+ connectionControllerClient: this.connectionControllerClient,
198
+ networkControllerClient: this.networkControllerClient
199
+ });
200
+ const network = this.getDefaultNetwork();
201
+ if (network) {
202
+ ChainController.setActiveCaipNetwork(network);
203
+ }
204
+ }
205
+ initializeConnectionController(options) {
206
+ ConnectionController.setWcBasic(options.basic ?? false);
207
+ }
208
+ initializeOptionsController(options) {
209
+ OptionsController.setDebug(options.debug !== false);
210
+ if (!options.projectId) {
211
+ AlertController.open(ErrorUtil.ALERT_ERRORS.PROJECT_ID_NOT_CONFIGURED, 'error');
212
+ return;
213
+ }
214
+ // On by default
215
+ OptionsController.setEnableWalletConnect(options.enableWalletConnect !== false);
216
+ OptionsController.setEnableWalletGuide(options.enableWalletGuide !== false);
217
+ OptionsController.setEnableWallets(options.enableWallets !== false);
218
+ OptionsController.setEIP6963Enabled(options.enableEIP6963 !== false);
219
+ OptionsController.setEnableAuthLogger(options.enableAuthLogger !== false);
220
+ OptionsController.setSdkVersion(options.sdkVersion);
221
+ OptionsController.setProjectId(options.projectId);
222
+ OptionsController.setEnableEmbedded(options.enableEmbedded);
223
+ OptionsController.setAllWallets(options.allWallets);
224
+ OptionsController.setIncludeWalletIds(options.includeWalletIds);
225
+ OptionsController.setExcludeWalletIds(options.excludeWalletIds);
226
+ OptionsController.setFeaturedWalletIds(options.featuredWalletIds);
227
+ OptionsController.setTokens(options.tokens);
228
+ OptionsController.setTermsConditionsUrl(options.termsConditionsUrl);
229
+ OptionsController.setPrivacyPolicyUrl(options.privacyPolicyUrl);
230
+ OptionsController.setCustomWallets(options.customWallets);
231
+ OptionsController.setFeatures(options.features);
232
+ OptionsController.setAllowUnsupportedChain(options.allowUnsupportedChain);
233
+ OptionsController.setDefaultAccountTypes(options.defaultAccountTypes);
234
+ const defaultMetaData = this.getDefaultMetaData();
235
+ if (!options.metadata && defaultMetaData) {
236
+ options.metadata = defaultMetaData;
237
+ }
238
+ OptionsController.setMetadata(options.metadata);
239
+ OptionsController.setDisableAppend(options.disableAppend);
240
+ OptionsController.setEnableEmbedded(options.enableEmbedded);
241
+ OptionsController.setSIWX(options.siwx);
242
+ const evmAdapter = options.adapters?.find(adapter => adapter.namespace === ConstantsUtil.CHAIN.EVM);
243
+ // Set the SIWE client for EVM chains
244
+ if (evmAdapter) {
245
+ if (options.siweConfig) {
246
+ if (options.siwx) {
247
+ throw new Error('Cannot set both `siweConfig` and `siwx` options');
248
+ }
249
+ OptionsController.setSIWX(options.siweConfig.mapToSIWX());
250
+ }
251
+ }
252
+ }
253
+ getDefaultMetaData() {
254
+ if (typeof window !== 'undefined' && typeof document !== 'undefined') {
255
+ return {
256
+ name: document.getElementsByTagName('title')?.[0]?.textContent || '',
257
+ description: document.querySelector('meta[property="og:description"]')?.content || '',
258
+ url: window.location.origin,
259
+ icons: [document.querySelector('link[rel~="icon"]')?.href || '']
260
+ };
261
+ }
262
+ return null;
263
+ }
264
+ // -- Network Initialization ---------------------------------------------------
265
+ getUnsupportedNetwork(caipNetworkId) {
266
+ return {
267
+ id: caipNetworkId.split(':')[1],
268
+ caipNetworkId,
269
+ name: ConstantsUtil.UNSUPPORTED_NETWORK_NAME,
270
+ chainNamespace: caipNetworkId.split(':')[0],
271
+ nativeCurrency: {
272
+ name: '',
273
+ decimals: 0,
274
+ symbol: ''
275
+ },
276
+ rpcUrls: {
277
+ default: {
278
+ http: []
279
+ }
280
+ }
281
+ };
282
+ }
283
+ setUnsupportedNetwork(chainId) {
284
+ const namespace = this.getActiveChainNamespace();
285
+ if (namespace) {
286
+ const unsupportedNetwork = this.getUnsupportedNetwork(`${namespace}:${chainId}`);
287
+ ChainController.setActiveCaipNetwork(unsupportedNetwork);
288
+ }
289
+ }
290
+ getDefaultNetwork() {
291
+ const caipNetworkIdFromStorage = StorageUtil.getActiveCaipNetworkId();
292
+ if (caipNetworkIdFromStorage) {
293
+ const caipNetwork = this.caipNetworks?.find(n => n.caipNetworkId === caipNetworkIdFromStorage);
294
+ if (caipNetwork) {
295
+ return caipNetwork;
296
+ }
297
+ if (this.defaultCaipNetwork) {
298
+ // It's still a case that the network in storage might not be found in the networks array
299
+ return this.defaultCaipNetwork;
300
+ }
301
+ return this.getUnsupportedNetwork(caipNetworkIdFromStorage);
302
+ }
303
+ if (this.defaultCaipNetwork) {
304
+ return this.defaultCaipNetwork;
305
+ }
306
+ return this.caipNetworks?.[0];
307
+ }
308
+ extendCaipNetwork(network, options) {
309
+ const extendedNetwork = CaipNetworksUtil.extendCaipNetwork(network, {
310
+ customNetworkImageUrls: options.chainImages,
311
+ projectId: options.projectId
312
+ });
313
+ return extendedNetwork;
314
+ }
315
+ extendCaipNetworks(options) {
316
+ const extendedNetworks = CaipNetworksUtil.extendCaipNetworks(options.networks, {
317
+ customNetworkImageUrls: options.chainImages,
318
+ projectId: options.projectId
319
+ });
320
+ return extendedNetworks;
321
+ }
322
+ extendDefaultCaipNetwork(options) {
323
+ const defaultNetwork = options.networks.find(n => n.id === options.defaultNetwork?.id);
324
+ const extendedNetwork = defaultNetwork
325
+ ? CaipNetworksUtil.extendCaipNetwork(defaultNetwork, {
326
+ customNetworkImageUrls: options.chainImages,
327
+ projectId: options.projectId
328
+ })
329
+ : undefined;
330
+ return extendedNetwork;
331
+ }
332
+ // -- Client Initialization ---------------------------------------------------
333
+ createClients() {
334
+ this.connectionControllerClient = {
335
+ connectWalletConnect: async () => {
336
+ const adapter = this.getAdapter(ChainController.state.activeChain);
337
+ if (!adapter) {
338
+ throw new Error('Adapter not found');
339
+ }
340
+ const result = await adapter.connectWalletConnect(this.getCaipNetwork()?.id);
341
+ this.close();
342
+ this.setClientId(result?.clientId || null);
343
+ StorageUtil.setConnectedNamespaces([...ChainController.state.chains.keys()]);
344
+ await this.syncWalletConnectAccount();
345
+ },
346
+ connectExternal: async ({ id, info, type, provider, chain, caipNetwork }) => {
347
+ const activeChain = ChainController.state.activeChain;
348
+ const chainToUse = chain || activeChain;
349
+ const adapter = this.getAdapter(chainToUse);
350
+ if (chain && chain !== activeChain && !caipNetwork) {
351
+ const toConnectNetwork = this.caipNetworks?.find(network => network.chainNamespace === chain);
352
+ if (toConnectNetwork) {
353
+ this.setCaipNetwork(toConnectNetwork);
354
+ }
355
+ }
356
+ if (!adapter) {
357
+ throw new Error('Adapter not found');
358
+ }
359
+ const res = await adapter.connect({
360
+ id,
361
+ info,
362
+ type,
363
+ provider,
364
+ chainId: caipNetwork?.id || this.getCaipNetwork()?.id,
365
+ rpcUrl: caipNetwork?.rpcUrls?.default?.http?.[0] ||
366
+ this.getCaipNetwork()?.rpcUrls?.default?.http?.[0]
367
+ });
368
+ if (!res) {
369
+ return;
370
+ }
371
+ StorageUtil.addConnectedNamespace(chainToUse);
372
+ this.syncProvider({ ...res, chainNamespace: chainToUse });
373
+ await this.syncAccount({ ...res, chainNamespace: chainToUse });
374
+ const { accounts } = await adapter.getAccounts({ namespace: chainToUse, id });
375
+ this.setAllAccounts(accounts, chainToUse);
376
+ },
377
+ reconnectExternal: async ({ id, info, type, provider }) => {
378
+ const namespace = ChainController.state.activeChain;
379
+ const adapter = this.getAdapter(namespace);
380
+ if (adapter?.reconnect) {
381
+ await adapter?.reconnect({ id, info, type, provider, chainId: this.getCaipNetwork()?.id });
382
+ StorageUtil.addConnectedNamespace(namespace);
383
+ }
384
+ },
385
+ disconnect: async () => {
386
+ const namespace = ChainController.state.activeChain;
387
+ const adapter = this.getAdapter(namespace);
388
+ const provider = ProviderUtil.getProvider(namespace);
389
+ const providerType = ProviderUtil.state.providerIds[namespace];
390
+ await adapter?.disconnect({ provider, providerType });
391
+ StorageUtil.removeConnectedNamespace(namespace);
392
+ ProviderUtil.resetChain(namespace);
393
+ this.setUser(undefined, namespace);
394
+ this.setStatus('disconnected', namespace);
395
+ },
396
+ checkInstalled: (ids) => {
397
+ if (!ids) {
398
+ return Boolean(window.ethereum);
399
+ }
400
+ return ids.some(id => Boolean(window.ethereum?.[String(id)]));
401
+ },
402
+ signMessage: async (message) => {
403
+ const adapter = this.getAdapter(ChainController.state.activeChain);
404
+ const result = await adapter?.signMessage({
405
+ message,
406
+ address: AccountController.state.address,
407
+ provider: ProviderUtil.getProvider(ChainController.state.activeChain)
408
+ });
409
+ return result?.signature || '';
410
+ },
411
+ sendTransaction: async (args) => {
412
+ if (args.chainNamespace === ConstantsUtil.CHAIN.EVM) {
413
+ const adapter = this.getAdapter(ChainController.state.activeChain);
414
+ const provider = ProviderUtil.getProvider(ChainController.state.activeChain);
415
+ const result = await adapter?.sendTransaction({ ...args, provider });
416
+ return result?.hash || '';
417
+ }
418
+ return '';
419
+ },
420
+ estimateGas: async (args) => {
421
+ if (args.chainNamespace === ConstantsUtil.CHAIN.EVM) {
422
+ const adapter = this.getAdapter(ChainController.state.activeChain);
423
+ const provider = ProviderUtil.getProvider(ChainController.state.activeChain);
424
+ const caipNetwork = this.getCaipNetwork();
425
+ if (!caipNetwork) {
426
+ throw new Error('CaipNetwork is undefined');
427
+ }
428
+ const result = await adapter?.estimateGas({
429
+ ...args,
430
+ provider,
431
+ caipNetwork
432
+ });
433
+ return result?.gas || 0n;
434
+ }
435
+ return 0n;
436
+ },
437
+ getEnsAvatar: async () => {
438
+ const adapter = this.getAdapter(ChainController.state.activeChain);
439
+ const result = await adapter?.getProfile({
440
+ address: AccountController.state.address,
441
+ chainId: Number(this.getCaipNetwork()?.id)
442
+ });
443
+ return result?.profileImage || false;
444
+ },
445
+ getEnsAddress: async (name) => {
446
+ const adapter = this.getAdapter(ChainController.state.activeChain);
447
+ const caipNetwork = this.getCaipNetwork();
448
+ if (!caipNetwork) {
449
+ return false;
450
+ }
451
+ const result = await adapter?.getEnsAddress({
452
+ name,
453
+ caipNetwork
454
+ });
455
+ return result?.address || false;
456
+ },
457
+ writeContract: async (args) => {
458
+ const adapter = this.getAdapter(ChainController.state.activeChain);
459
+ const caipNetwork = this.getCaipNetwork();
460
+ const caipAddress = this.getCaipAddress();
461
+ const provider = ProviderUtil.getProvider(ChainController.state.activeChain);
462
+ if (!caipNetwork || !caipAddress) {
463
+ throw new Error('CaipNetwork or CaipAddress is undefined');
464
+ }
465
+ const result = await adapter?.writeContract({ ...args, caipNetwork, provider, caipAddress });
466
+ return result?.hash;
467
+ },
468
+ parseUnits: (value, decimals) => {
469
+ const adapter = this.getAdapter(ChainController.state.activeChain);
470
+ return adapter?.parseUnits({ value, decimals }) ?? 0n;
471
+ },
472
+ formatUnits: (value, decimals) => {
473
+ const adapter = this.getAdapter(ChainController.state.activeChain);
474
+ return adapter?.formatUnits({ value, decimals }) ?? '0';
475
+ },
476
+ getCapabilities: async (params) => {
477
+ const adapter = this.getAdapter(ChainController.state.activeChain);
478
+ return await adapter?.getCapabilities(params);
479
+ },
480
+ grantPermissions: async (params) => {
481
+ const adapter = this.getAdapter(ChainController.state.activeChain);
482
+ return await adapter?.grantPermissions(params);
483
+ },
484
+ revokePermissions: async (params) => {
485
+ const adapter = this.getAdapter(ChainController.state.activeChain);
486
+ if (adapter?.revokePermissions) {
487
+ return await adapter.revokePermissions(params);
488
+ }
489
+ return '0x';
490
+ },
491
+ walletGetAssets: async (params) => {
492
+ const adapter = this.getAdapter(ChainController.state.activeChain);
493
+ return (await adapter?.walletGetAssets(params)) ?? {};
494
+ }
495
+ };
496
+ this.networkControllerClient = {
497
+ switchCaipNetwork: async (caipNetwork) => await this.switchCaipNetwork(caipNetwork),
498
+ // eslint-disable-next-line @typescript-eslint/require-await
499
+ getApprovedCaipNetworksData: async () => this.getApprovedCaipNetworksData()
500
+ };
501
+ ConnectionController.setClient(this.connectionControllerClient);
502
+ }
503
+ getApprovedCaipNetworksData() {
504
+ const providerType = ProviderUtil.state.providerIds[ChainController.state.activeChain];
505
+ if (providerType === UtilConstantsUtil.CONNECTOR_TYPE_WALLET_CONNECT) {
506
+ const namespaces = this.universalProvider?.session?.namespaces;
507
+ return {
508
+ /*
509
+ * MetaMask Wallet only returns 1 namespace in the session object. This makes it imposible
510
+ * to switch to other networks. Setting supportsAllNetworks to true for MetaMask Wallet
511
+ * will make it possible to switch to other networks.
512
+ */
513
+ supportsAllNetworks: this.universalProvider?.session?.peer?.metadata.name === 'MetaMask Wallet',
514
+ approvedCaipNetworkIds: this.getChainsFromNamespaces(namespaces)
515
+ };
516
+ }
517
+ return { supportsAllNetworks: true, approvedCaipNetworkIds: [] };
518
+ }
519
+ async switchCaipNetwork(caipNetwork) {
520
+ if (!caipNetwork) {
521
+ return;
522
+ }
523
+ if (AccountController.state.address) {
524
+ if (caipNetwork.chainNamespace === ChainController.state.activeChain) {
525
+ const adapter = this.getAdapter(ChainController.state.activeChain);
526
+ const provider = ProviderUtil.getProvider(ChainController.state.activeChain);
527
+ const providerType = ProviderUtil.state.providerIds[ChainController.state.activeChain];
528
+ await adapter?.switchNetwork({ caipNetwork, provider, providerType });
529
+ this.setCaipNetwork(caipNetwork);
530
+ await this.syncAccount({
531
+ address: AccountController.state.address,
532
+ chainId: caipNetwork.id,
533
+ chainNamespace: caipNetwork.chainNamespace
534
+ });
535
+ }
536
+ else {
537
+ const providerType = ProviderUtil.state.providerIds[ChainController.state.activeChain];
538
+ this.setCaipNetwork(caipNetwork);
539
+ if (providerType === 'WALLET_CONNECT') {
540
+ this.syncWalletConnectAccount();
541
+ }
542
+ else {
543
+ const address = this.getAddressByChainNamespace(caipNetwork.chainNamespace);
544
+ if (address) {
545
+ this.syncAccount({
546
+ address,
547
+ chainId: caipNetwork.id,
548
+ chainNamespace: caipNetwork.chainNamespace
549
+ });
550
+ }
551
+ }
552
+ }
553
+ }
554
+ else {
555
+ this.setCaipNetwork(caipNetwork);
556
+ }
557
+ }
558
+ getChainsFromNamespaces(namespaces = {}) {
559
+ return Object.values(namespaces).flatMap((namespace) => {
560
+ const chains = (namespace.chains || []);
561
+ const accountsChains = namespace.accounts.map(account => {
562
+ const { chainId, chainNamespace } = ParseUtil.parseCaipAddress(account);
563
+ return `${chainNamespace}:${chainId}`;
564
+ });
565
+ return Array.from(new Set([...chains, ...accountsChains]));
566
+ });
567
+ }
568
+ // -- Adapter Initialization ---------------------------------------------------
569
+ createAdapters(blueprints) {
570
+ this.createClients();
571
+ return this.chainNamespaces.reduce((adapters, namespace) => {
572
+ const blueprint = blueprints?.find(b => b.namespace === namespace);
573
+ if (blueprint) {
574
+ adapters[namespace] = blueprint;
575
+ adapters[namespace].namespace = namespace;
576
+ adapters[namespace].construct({
577
+ namespace,
578
+ projectId: this.options?.projectId,
579
+ networks: this.caipNetworks
580
+ });
581
+ }
582
+ else {
583
+ adapters[namespace] = new UniversalAdapter({
584
+ namespace,
585
+ networks: this.caipNetworks
586
+ });
587
+ }
588
+ return adapters;
589
+ // eslint-disable-next-line @typescript-eslint/prefer-reduce-type-parameter
590
+ }, {});
591
+ }
592
+ async initChainAdapter(namespace) {
593
+ this.onConnectors(namespace);
594
+ this.listenAdapter(namespace);
595
+ this.chainAdapters?.[namespace].syncConnectors(this.options, this);
596
+ await this.createUniversalProviderForAdapter(namespace);
597
+ }
598
+ async initChainAdapters() {
599
+ await Promise.all(this.chainNamespaces.map(async (namespace) => {
600
+ await this.initChainAdapter(namespace);
601
+ }));
602
+ }
603
+ onConnectors(chainNamespace) {
604
+ const adapter = this.getAdapter(chainNamespace);
605
+ adapter?.on('connectors', this.setConnectors.bind(this));
606
+ }
607
+ listenAdapter(chainNamespace) {
608
+ const adapter = this.getAdapter(chainNamespace);
609
+ if (!adapter) {
610
+ return;
611
+ }
612
+ const connectionStatus = StorageUtil.getConnectionStatus();
613
+ if (connectionStatus === 'connected') {
614
+ this.setStatus('connecting', chainNamespace);
615
+ }
616
+ else if (connectionStatus === 'disconnected') {
617
+ /*
618
+ * Address cache is kept after disconnecting from the wallet
619
+ * but should be cleared if appkit is launched in disconnected state
620
+ */
621
+ StorageUtil.clearAddressCache();
622
+ this.setStatus(connectionStatus, chainNamespace);
623
+ }
624
+ else {
625
+ this.setStatus(connectionStatus, chainNamespace);
626
+ }
627
+ adapter.on('switchNetwork', ({ address, chainId }) => {
628
+ if (chainId &&
629
+ this.caipNetworks?.find(n => n.id === chainId || n.caipNetworkId === chainId)) {
630
+ if (ChainController.state.activeChain === chainNamespace && address) {
631
+ this.syncAccount({ address, chainId, chainNamespace });
632
+ }
633
+ else if (ChainController.state.activeChain === chainNamespace &&
634
+ AccountController.state.address) {
635
+ this.syncAccount({
636
+ address: AccountController.state.address,
637
+ chainId,
638
+ chainNamespace
639
+ });
640
+ }
641
+ }
642
+ else {
643
+ this.setUnsupportedNetwork(chainId);
644
+ }
645
+ });
646
+ adapter.on('disconnect', this.disconnect.bind(this));
647
+ adapter.on('pendingTransactions', () => {
648
+ const address = AccountController.state.address;
649
+ const activeCaipNetwork = ChainController.state.activeCaipNetwork;
650
+ if (!address || !activeCaipNetwork?.id) {
651
+ return;
652
+ }
653
+ this.updateNativeBalance();
654
+ });
655
+ adapter.on('accountChanged', ({ address, chainId }) => {
656
+ if (ChainController.state.activeChain === chainNamespace && chainId) {
657
+ this.syncAccount({
658
+ address,
659
+ chainId,
660
+ chainNamespace
661
+ });
662
+ }
663
+ else if (ChainController.state.activeChain === chainNamespace &&
664
+ ChainController.state.activeCaipNetwork?.id) {
665
+ this.syncAccount({
666
+ address,
667
+ chainId: ChainController.state.activeCaipNetwork?.id,
668
+ chainNamespace
669
+ });
670
+ }
671
+ });
672
+ }
673
+ async createUniversalProviderForAdapter(chainNamespace) {
674
+ await this.getUniversalProvider();
675
+ if (this.universalProvider) {
676
+ this.chainAdapters?.[chainNamespace]?.setUniversalProvider?.(this.universalProvider);
677
+ }
678
+ }
679
+ // -- Connection Sync ---------------------------------------------------
680
+ async syncExistingConnection() {
681
+ await Promise.allSettled(this.chainNamespaces.map(namespace => this.syncNamespaceConnection(namespace)));
682
+ }
683
+ async syncNamespaceConnection(namespace) {
684
+ try {
685
+ const connectorId = StorageUtil.getConnectedConnectorId(namespace);
686
+ this.setStatus('connecting', namespace);
687
+ switch (connectorId) {
688
+ case ConstantsUtil.CONNECTOR_ID.WALLET_CONNECT:
689
+ await this.syncWalletConnectAccount();
690
+ break;
691
+ case ConstantsUtil.CONNECTOR_ID.AUTH:
692
+ // Handled during initialization of adapters' auth provider
693
+ break;
694
+ default:
695
+ await this.syncAdapterConnection(namespace);
696
+ }
697
+ }
698
+ catch (err) {
699
+ console.warn("AppKit couldn't sync existing connection", err);
700
+ StorageUtil.deleteConnectedConnectorId(namespace);
701
+ this.setStatus('disconnected', namespace);
702
+ }
703
+ }
704
+ async syncAdapterConnection(namespace) {
705
+ const adapter = this.getAdapter(namespace);
706
+ const connectorId = StorageUtil.getConnectedConnectorId(namespace);
707
+ const caipNetwork = this.getCaipNetwork();
708
+ try {
709
+ if (!adapter || !connectorId) {
710
+ throw new Error(`Adapter or connectorId not found for namespace ${namespace}`);
711
+ }
712
+ const connection = await adapter?.syncConnection({
713
+ namespace,
714
+ id: connectorId,
715
+ chainId: caipNetwork?.id,
716
+ rpcUrl: caipNetwork?.rpcUrls?.default?.http?.[0]
717
+ });
718
+ if (connection) {
719
+ const accounts = await adapter?.getAccounts({
720
+ namespace,
721
+ id: connectorId
722
+ });
723
+ if (accounts && accounts.accounts.length > 0) {
724
+ this.setAllAccounts(accounts.accounts, namespace);
725
+ }
726
+ else {
727
+ this.setAllAccounts([CoreHelperUtil.createAccount(namespace, connection.address, 'eoa')], namespace);
728
+ }
729
+ this.syncProvider({ ...connection, chainNamespace: namespace });
730
+ await this.syncAccount({ ...connection, chainNamespace: namespace });
731
+ this.setStatus('connected', namespace);
732
+ }
733
+ else {
734
+ this.setStatus('disconnected', namespace);
735
+ }
736
+ }
737
+ catch (e) {
738
+ StorageUtil.deleteConnectedConnectorId(namespace);
739
+ this.setStatus('disconnected', namespace);
740
+ }
741
+ }
742
+ async syncWalletConnectAccount() {
743
+ this.chainNamespaces.forEach(async (chainNamespace) => {
744
+ const adapter = this.getAdapter(chainNamespace);
745
+ const namespaceAccounts = this.universalProvider?.session?.namespaces?.[chainNamespace]?.accounts || [];
746
+ // We try and find the address for this network in the session object.
747
+ const activeChainId = ChainController.state.activeCaipNetwork?.id;
748
+ const sessionAddress = namespaceAccounts.find(account => {
749
+ const { chainId } = ParseUtil.parseCaipAddress(account);
750
+ return chainId === activeChainId?.toString();
751
+ }) || namespaceAccounts[0];
752
+ if (sessionAddress) {
753
+ const caipAddress = ParseUtil.validateCaipAddress(sessionAddress);
754
+ const { chainId, address } = ParseUtil.parseCaipAddress(caipAddress);
755
+ ProviderUtil.setProviderId(chainNamespace, UtilConstantsUtil.CONNECTOR_TYPE_WALLET_CONNECT);
756
+ if (this.caipNetworks &&
757
+ ChainController.state.activeCaipNetwork &&
758
+ adapter?.namespace !== ConstantsUtil.CHAIN.EVM) {
759
+ const provider = adapter?.getWalletConnectProvider({
760
+ caipNetworks: this.caipNetworks,
761
+ provider: this.universalProvider,
762
+ activeCaipNetwork: ChainController.state.activeCaipNetwork
763
+ });
764
+ ProviderUtil.setProvider(chainNamespace, provider);
765
+ }
766
+ else {
767
+ ProviderUtil.setProvider(chainNamespace, this.universalProvider);
768
+ }
769
+ StorageUtil.setConnectedConnectorId(chainNamespace, ConstantsUtil.CONNECTOR_ID.WALLET_CONNECT);
770
+ StorageUtil.addConnectedNamespace(chainNamespace);
771
+ this.syncWalletConnectAccounts(chainNamespace);
772
+ await this.syncAccount({
773
+ address,
774
+ chainId,
775
+ chainNamespace
776
+ });
777
+ }
778
+ });
779
+ await ChainController.setApprovedCaipNetworksData(ChainController.state.activeChain);
780
+ }
781
+ syncWalletConnectAccounts(chainNamespace) {
782
+ const addresses = this.universalProvider?.session?.namespaces?.[chainNamespace]?.accounts
783
+ ?.map(account => {
784
+ const { address } = ParseUtil.parseCaipAddress(account);
785
+ return address;
786
+ })
787
+ .filter((address, index, self) => self.indexOf(address) === index);
788
+ if (addresses) {
789
+ this.setAllAccounts(addresses.map(address => CoreHelperUtil.createAccount(chainNamespace, address, chainNamespace === 'bip122' ? 'payment' : 'eoa')), chainNamespace);
790
+ }
791
+ }
792
+ syncProvider({ type, provider, id, chainNamespace }) {
793
+ ProviderUtil.setProviderId(chainNamespace, type);
794
+ ProviderUtil.setProvider(chainNamespace, provider);
795
+ StorageUtil.setConnectedConnectorId(chainNamespace, id);
796
+ }
797
+ async syncAccount(params) {
798
+ const { address, chainId, chainNamespace } = params;
799
+ const { chainId: activeChainId } = StorageUtil.getActiveNetworkProps();
800
+ const chainIdToUse = chainId || activeChainId;
801
+ const isUnsupportedNetwork = ChainController.state.activeCaipNetwork?.name === ConstantsUtil.UNSUPPORTED_NETWORK_NAME;
802
+ const shouldSupportAllNetworks = ChainController.getNetworkProp('supportsAllNetworks', chainNamespace);
803
+ // Only update state when needed
804
+ if (!HelpersUtil.isLowerCaseMatch(address, AccountController.state.address)) {
805
+ this.setCaipAddress(`${chainNamespace}:${chainId}:${address}`, chainNamespace);
806
+ await this.syncIdentity({ address, chainId, chainNamespace });
807
+ }
808
+ this.setStatus('connected', chainNamespace);
809
+ if (isUnsupportedNetwork && !shouldSupportAllNetworks) {
810
+ return;
811
+ }
812
+ if (chainIdToUse) {
813
+ let caipNetwork = this.caipNetworks?.find(n => n.id.toString() === chainIdToUse.toString());
814
+ let fallbackCaipNetwork = this.caipNetworks?.find(n => n.chainNamespace === chainNamespace);
815
+ // If doesn't support all networks, we need to use approved networks
816
+ if (!shouldSupportAllNetworks && !caipNetwork && !fallbackCaipNetwork) {
817
+ // Connection can be requested for a chain that is not supported by the wallet so we need to use approved networks here
818
+ const caipNetworkIds = this.getApprovedCaipNetworkIds() || [];
819
+ const caipNetworkId = caipNetworkIds.find(id => ParseUtil.parseCaipNetworkId(id)?.chainId === chainIdToUse.toString());
820
+ const fallBackCaipNetworkId = caipNetworkIds.find(id => ParseUtil.parseCaipNetworkId(id)?.chainNamespace === chainNamespace);
821
+ caipNetwork = this.caipNetworks?.find(n => n.caipNetworkId === caipNetworkId);
822
+ fallbackCaipNetwork = this.caipNetworks?.find(n => n.caipNetworkId === fallBackCaipNetworkId ||
823
+ // This is a workaround used in Solana network to support deprecated caipNetworkId
824
+ ('deprecatedCaipNetworkId' in n && n.deprecatedCaipNetworkId === fallBackCaipNetworkId));
825
+ }
826
+ const network = caipNetwork || fallbackCaipNetwork;
827
+ if (network?.chainNamespace === ChainController.state.activeChain) {
828
+ // If the network is unsupported and the user doesn't allow unsupported chains, we show the unsupported chain UI
829
+ if (!OptionsController.state.allowUnsupportedChain &&
830
+ ChainController.state.activeCaipNetwork?.name === ConstantsUtil.UNSUPPORTED_NETWORK_NAME) {
831
+ ChainController.showUnsupportedChainUI();
832
+ }
833
+ else {
834
+ this.setCaipNetwork(network);
835
+ }
836
+ }
837
+ this.syncConnectedWalletInfo(chainNamespace);
838
+ // Only update state when needed
839
+ if (!HelpersUtil.isLowerCaseMatch(address, AccountController.state.address)) {
840
+ this.setCaipAddress(`${chainNamespace}:${network?.id}:${address}`, chainNamespace);
841
+ await this.syncIdentity({
842
+ address,
843
+ chainId: network?.id,
844
+ chainNamespace
845
+ });
846
+ }
847
+ await this.syncBalance({ address, chainId: network?.id, chainNamespace });
848
+ }
849
+ }
850
+ async syncIdentity({ address, chainId, chainNamespace }) {
851
+ const caipNetworkId = `${chainNamespace}:${chainId}`;
852
+ const activeCaipNetwork = this.caipNetworks?.find(n => n.caipNetworkId === caipNetworkId);
853
+ if (chainNamespace !== ConstantsUtil.CHAIN.EVM || activeCaipNetwork?.testnet) {
854
+ return;
855
+ }
856
+ try {
857
+ const { name, avatar } = await this.fetchIdentity({
858
+ address,
859
+ caipNetworkId
860
+ });
861
+ this.setProfileName(name, chainNamespace);
862
+ this.setProfileImage(avatar, chainNamespace);
863
+ if (!name) {
864
+ await this.syncReownName(address, chainNamespace);
865
+ const adapter = this.getAdapter(chainNamespace);
866
+ const result = await adapter?.getProfile({
867
+ address,
868
+ chainId: Number(chainId)
869
+ });
870
+ if (result?.profileName) {
871
+ this.setProfileName(result.profileName, chainNamespace);
872
+ if (result.profileImage) {
873
+ this.setProfileImage(result.profileImage, chainNamespace);
874
+ }
875
+ }
876
+ else {
877
+ await this.syncReownName(address, chainNamespace);
878
+ this.setProfileImage(null, chainNamespace);
879
+ }
880
+ }
881
+ }
882
+ catch {
883
+ if (chainId === 1) {
884
+ await this.syncReownName(address, chainNamespace);
885
+ }
886
+ else {
887
+ await this.syncReownName(address, chainNamespace);
888
+ this.setProfileImage(null, chainNamespace);
889
+ }
890
+ }
891
+ }
892
+ async syncReownName(address, chainNamespace) {
893
+ try {
894
+ const registeredWcNames = await this.getReownName(address);
895
+ if (registeredWcNames[0]) {
896
+ const wcName = registeredWcNames[0];
897
+ this.setProfileName(wcName.name, chainNamespace);
898
+ }
899
+ else {
900
+ this.setProfileName(null, chainNamespace);
901
+ }
902
+ }
903
+ catch {
904
+ this.setProfileName(null, chainNamespace);
905
+ }
906
+ }
907
+ syncConnectedWalletInfo(chainNamespace) {
908
+ const connectorId = StorageUtil.getConnectedConnectorId(chainNamespace);
909
+ const providerType = ProviderUtil.getProviderId(chainNamespace);
910
+ if (providerType === UtilConstantsUtil.CONNECTOR_TYPE_ANNOUNCED ||
911
+ providerType === UtilConstantsUtil.CONNECTOR_TYPE_INJECTED) {
912
+ if (connectorId) {
913
+ const connector = this.getConnectors().find(c => c.id === connectorId);
914
+ if (connector) {
915
+ const { info, name, imageUrl } = connector;
916
+ const icon = imageUrl || this.getConnectorImage(connector);
917
+ this.setConnectedWalletInfo({ name, icon, ...info }, chainNamespace);
918
+ }
919
+ }
920
+ }
921
+ else if (providerType === UtilConstantsUtil.CONNECTOR_TYPE_WALLET_CONNECT) {
922
+ const provider = ProviderUtil.getProvider(chainNamespace);
923
+ if (provider?.session) {
924
+ this.setConnectedWalletInfo({
925
+ ...provider.session.peer.metadata,
926
+ name: provider.session.peer.metadata.name,
927
+ icon: provider.session.peer.metadata.icons?.[0]
928
+ }, chainNamespace);
929
+ }
930
+ }
931
+ else if (connectorId) {
932
+ if (connectorId === ConstantsUtil.CONNECTOR_ID.COINBASE) {
933
+ const connector = this.getConnectors().find(c => c.id === ConstantsUtil.CONNECTOR_ID.COINBASE);
934
+ this.setConnectedWalletInfo({ name: 'Coinbase Wallet', icon: this.getConnectorImage(connector) }, chainNamespace);
935
+ }
936
+ else {
937
+ this.setConnectedWalletInfo({ name: connectorId }, chainNamespace);
938
+ }
939
+ }
940
+ }
941
+ async syncBalance(params) {
942
+ const caipNetwork = NetworkUtil.getNetworksByNamespace(this.caipNetworks, params.chainNamespace).find(n => n.id.toString() === params.chainId?.toString());
943
+ if (!caipNetwork) {
944
+ return;
945
+ }
946
+ await this.updateNativeBalance();
947
+ }
948
+ async updateNativeBalance() {
949
+ const adapter = this.getAdapter(ChainController.state.activeChain);
950
+ if (adapter && ChainController.state.activeChain && AccountController.state.address) {
951
+ const balance = await adapter.getBalance({
952
+ address: AccountController.state.address,
953
+ chainId: ChainController.state.activeCaipNetwork?.id,
954
+ caipNetwork: this.getCaipNetwork(),
955
+ tokens: this.options.tokens
956
+ });
957
+ this.setBalance(balance.balance, balance.symbol, ChainController.state.activeChain);
958
+ }
959
+ }
960
+ // -- Universal Provider ---------------------------------------------------
961
+ async initializeUniversalAdapter() {
962
+ const logger = LoggerUtil.createLogger((error, ...args) => {
963
+ if (error) {
964
+ this.handleAlertError(error);
965
+ }
966
+ // eslint-disable-next-line no-console
967
+ console.error(...args);
968
+ });
969
+ const universalProviderOptions = {
970
+ projectId: this.options?.projectId,
971
+ metadata: {
972
+ name: this.options?.metadata ? this.options?.metadata.name : '',
973
+ description: this.options?.metadata ? this.options?.metadata.description : '',
974
+ url: this.options?.metadata ? this.options?.metadata.url : '',
975
+ icons: this.options?.metadata ? this.options?.metadata.icons : ['']
976
+ },
977
+ logger
978
+ };
979
+ OptionsController.setManualWCControl(Boolean(this.options?.manualWCControl));
980
+ this.universalProvider =
981
+ this.options.universalProvider ?? (await UniversalProvider.init(universalProviderOptions));
982
+ this.listenWalletConnect();
983
+ }
984
+ listenWalletConnect() {
985
+ if (this.universalProvider) {
986
+ this.universalProvider.on('display_uri', (uri) => {
987
+ ConnectionController.setUri(uri);
988
+ });
989
+ this.universalProvider.on('connect', ConnectionController.finalizeWcConnection);
990
+ this.universalProvider.on('disconnect', () => {
991
+ this.chainNamespaces.forEach(namespace => {
992
+ this.resetAccount(namespace);
993
+ });
994
+ ConnectionController.resetWcConnection();
995
+ });
996
+ this.universalProvider.on('chainChanged', (chainId) => {
997
+ // eslint-disable-next-line eqeqeq
998
+ const caipNetwork = this.caipNetworks?.find(c => c.id == chainId);
999
+ const currentCaipNetwork = this.getCaipNetwork();
1000
+ if (!caipNetwork) {
1001
+ this.setUnsupportedNetwork(chainId);
1002
+ return;
1003
+ }
1004
+ if (currentCaipNetwork?.id !== caipNetwork?.id) {
1005
+ this.setCaipNetwork(caipNetwork);
1006
+ }
1007
+ });
1008
+ this.universalProvider.on('session_event', (callbackData) => {
1009
+ if (WcHelpersUtil.isSessionEventData(callbackData)) {
1010
+ const { name, data } = callbackData.params.event;
1011
+ if (name === 'accountsChanged' &&
1012
+ Array.isArray(data) &&
1013
+ CoreHelperUtil.isCaipAddress(data[0])) {
1014
+ this.syncAccount(ParseUtil.parseCaipAddress(data[0]));
1015
+ }
1016
+ }
1017
+ });
1018
+ }
1019
+ }
1020
+ createUniversalProvider() {
1021
+ if (!this.universalProviderInitPromise &&
1022
+ CoreHelperUtil.isClient() &&
1023
+ this.options?.projectId) {
1024
+ this.universalProviderInitPromise = this.initializeUniversalAdapter();
1025
+ }
1026
+ return this.universalProviderInitPromise;
1027
+ }
1028
+ async getUniversalProvider() {
1029
+ if (!this.universalProvider) {
1030
+ try {
1031
+ await this.createUniversalProvider();
1032
+ }
1033
+ catch (error) {
1034
+ throw new Error('AppKit:getUniversalProvider - Cannot create provider');
1035
+ }
1036
+ }
1037
+ return this.universalProvider;
1038
+ }
1039
+ // - Utils -------------------------------------------------------------------
1040
+ handleAlertError(error) {
1041
+ const matchedUniversalProviderError = Object.entries(ErrorUtil.UniversalProviderErrors).find(([, { message }]) => error.message.includes(message));
1042
+ const [errorKey, errorValue] = matchedUniversalProviderError ?? [];
1043
+ const { message, alertErrorKey } = errorValue ?? {};
1044
+ if (errorKey && message && !this.reportedAlertErrors[errorKey]) {
1045
+ const alertError = ErrorUtil.ALERT_ERRORS[alertErrorKey];
1046
+ if (alertError) {
1047
+ AlertController.open(alertError, 'error');
1048
+ this.reportedAlertErrors[errorKey] = true;
1049
+ }
1050
+ }
1051
+ }
1052
+ getAdapter(namespace) {
1053
+ if (!namespace) {
1054
+ return undefined;
1055
+ }
1056
+ return this.chainAdapters?.[namespace];
1057
+ }
1058
+ createAdapter(blueprint) {
1059
+ if (!blueprint) {
1060
+ return;
1061
+ }
1062
+ const namespace = blueprint.namespace;
1063
+ if (!namespace) {
1064
+ return;
1065
+ }
1066
+ this.createClients();
1067
+ const adapterBlueprint = blueprint;
1068
+ adapterBlueprint.namespace = namespace;
1069
+ adapterBlueprint.construct({
1070
+ namespace,
1071
+ projectId: this.options?.projectId,
1072
+ networks: this.caipNetworks
1073
+ });
1074
+ if (!this.chainNamespaces.includes(namespace)) {
1075
+ this.chainNamespaces.push(namespace);
1076
+ }
1077
+ if (this.chainAdapters) {
1078
+ this.chainAdapters[namespace] = adapterBlueprint;
1079
+ }
1080
+ }
1081
+ // -- Public -------------------------------------------------------------------
1082
+ async open(options) {
1083
+ await this.injectModalUi();
1084
+ if (options?.uri) {
1085
+ ConnectionController.setUri(options.uri);
1086
+ }
1087
+ if (options?.namespace) {
1088
+ ConnectorController.setFilterByNamespace(options.namespace);
1089
+ }
1090
+ await ModalController.open(options);
1091
+ }
1092
+ async close() {
1093
+ await this.injectModalUi();
1094
+ ModalController.close();
1095
+ }
1096
+ setLoading(loading) {
1097
+ ModalController.setLoading(loading);
1098
+ }
1099
+ async disconnect() {
1100
+ await ConnectionController.disconnect();
1101
+ }
1102
+ // -- review these -------------------------------------------------------------------
1103
+ getError() {
1104
+ return '';
1105
+ }
1106
+ getChainId() {
1107
+ return ChainController.state.activeCaipNetwork?.id;
1108
+ }
1109
+ async switchNetwork(appKitNetwork) {
1110
+ const network = this.caipNetworks?.find(n => n.id === appKitNetwork.id);
1111
+ if (!network) {
1112
+ AlertController.open(ErrorUtil.ALERT_ERRORS.SWITCH_NETWORK_NOT_FOUND, 'error');
1113
+ return;
1114
+ }
1115
+ await ChainController.switchActiveNetwork(network);
1116
+ }
1117
+ getWalletProvider() {
1118
+ return ChainController.state.activeChain
1119
+ ? ProviderUtil.state.providers[ChainController.state.activeChain]
1120
+ : null;
1121
+ }
1122
+ getWalletProviderType() {
1123
+ return ChainController.state.activeChain
1124
+ ? ProviderUtil.state.providerIds[ChainController.state.activeChain]
1125
+ : null;
1126
+ }
1127
+ subscribeProviders(callback) {
1128
+ return ProviderUtil.subscribeProviders(callback);
1129
+ }
1130
+ getThemeMode() {
1131
+ return ThemeController.state.themeMode;
1132
+ }
1133
+ getThemeVariables() {
1134
+ return ThemeController.state.themeVariables;
1135
+ }
1136
+ setThemeMode(themeMode) {
1137
+ ThemeController.setThemeMode(themeMode);
1138
+ setColorTheme(ThemeController.state.themeMode);
1139
+ }
1140
+ setTermsConditionsUrl(termsConditionsUrl) {
1141
+ OptionsController.setTermsConditionsUrl(termsConditionsUrl);
1142
+ }
1143
+ setPrivacyPolicyUrl(privacyPolicyUrl) {
1144
+ OptionsController.setPrivacyPolicyUrl(privacyPolicyUrl);
1145
+ }
1146
+ setThemeVariables(themeVariables) {
1147
+ ThemeController.setThemeVariables(themeVariables);
1148
+ setThemeVariables(ThemeController.state.themeVariables);
1149
+ }
1150
+ subscribeTheme(callback) {
1151
+ return ThemeController.subscribe(callback);
1152
+ }
1153
+ getWalletInfo() {
1154
+ return AccountController.state.connectedWalletInfo;
1155
+ }
1156
+ subscribeAccount(callback, namespace) {
1157
+ function updateVal() {
1158
+ const authConnector = ConnectorController.getAuthConnector(namespace);
1159
+ const accountState = ChainController.getAccountDataByChainNamespace(namespace);
1160
+ if (!accountState) {
1161
+ return;
1162
+ }
1163
+ callback({
1164
+ allAccounts: accountState.allAccounts,
1165
+ caipAddress: accountState.caipAddress,
1166
+ address: CoreHelperUtil.getPlainAddress(accountState.caipAddress),
1167
+ isConnected: Boolean(accountState.caipAddress),
1168
+ status: accountState.status,
1169
+ embeddedWalletInfo: authConnector
1170
+ ? {
1171
+ user: accountState.user,
1172
+ authProvider: accountState.socialProvider || 'email',
1173
+ accountType: accountState.preferredAccountType,
1174
+ isSmartAccountDeployed: Boolean(accountState.smartAccountDeployed)
1175
+ }
1176
+ : undefined
1177
+ });
1178
+ }
1179
+ if (namespace) {
1180
+ ChainController.subscribeChainProp('accountState', updateVal, namespace);
1181
+ }
1182
+ else {
1183
+ ChainController.subscribe(updateVal);
1184
+ }
1185
+ ConnectorController.subscribe(updateVal);
1186
+ }
1187
+ subscribeNetwork(callback) {
1188
+ return ChainController.subscribe(({ activeCaipNetwork }) => {
1189
+ callback({
1190
+ caipNetwork: activeCaipNetwork,
1191
+ chainId: activeCaipNetwork?.id,
1192
+ caipNetworkId: activeCaipNetwork?.caipNetworkId
1193
+ });
1194
+ });
1195
+ }
1196
+ subscribeWalletInfo(callback) {
1197
+ return AccountController.subscribeKey('connectedWalletInfo', callback);
1198
+ }
1199
+ subscribeShouldUpdateToAddress(callback) {
1200
+ AccountController.subscribeKey('shouldUpdateToAddress', callback);
1201
+ }
1202
+ subscribeCaipNetworkChange(callback) {
1203
+ ChainController.subscribeKey('activeCaipNetwork', callback);
1204
+ }
1205
+ getState() {
1206
+ return PublicStateController.state;
1207
+ }
1208
+ subscribeState(callback) {
1209
+ return PublicStateController.subscribe(callback);
1210
+ }
1211
+ showErrorMessage(message) {
1212
+ SnackController.showError(message);
1213
+ }
1214
+ showSuccessMessage(message) {
1215
+ SnackController.showSuccess(message);
1216
+ }
1217
+ getEvent() {
1218
+ return { ...EventsController.state };
1219
+ }
1220
+ subscribeEvents(callback) {
1221
+ return EventsController.subscribe(callback);
1222
+ }
1223
+ replace(route) {
1224
+ RouterController.replace(route);
1225
+ }
1226
+ redirect(route) {
1227
+ RouterController.push(route);
1228
+ }
1229
+ popTransactionStack(cancel) {
1230
+ RouterController.popTransactionStack(cancel);
1231
+ }
1232
+ isOpen() {
1233
+ return ModalController.state.open;
1234
+ }
1235
+ isTransactionStackEmpty() {
1236
+ return RouterController.state.transactionStack.length === 0;
1237
+ }
1238
+ isTransactionShouldReplaceView() {
1239
+ return RouterController.state.transactionStack[RouterController.state.transactionStack.length - 1]?.replace;
1240
+ }
1241
+ static getInstance() {
1242
+ return this.instance;
1243
+ }
1244
+ updateFeatures(newFeatures) {
1245
+ OptionsController.setFeatures(newFeatures);
1246
+ }
1247
+ updateOptions(newOptions) {
1248
+ const currentOptions = OptionsController.state || {};
1249
+ const updatedOptions = { ...currentOptions, ...newOptions };
1250
+ OptionsController.setOptions(updatedOptions);
1251
+ }
1252
+ setConnectMethodsOrder(connectMethodsOrder) {
1253
+ OptionsController.setConnectMethodsOrder(connectMethodsOrder);
1254
+ }
1255
+ setWalletFeaturesOrder(walletFeaturesOrder) {
1256
+ OptionsController.setWalletFeaturesOrder(walletFeaturesOrder);
1257
+ }
1258
+ setCollapseWallets(collapseWallets) {
1259
+ OptionsController.setCollapseWallets(collapseWallets);
1260
+ }
1261
+ setSocialsOrder(socialsOrder) {
1262
+ OptionsController.setSocialsOrder(socialsOrder);
1263
+ }
1264
+ getConnectMethodsOrder() {
1265
+ return WalletUtil.getConnectOrderMethod(OptionsController.state.features, ConnectorController.getConnectors());
1266
+ }
1267
+ /**
1268
+ * Removes an adapter from the AppKit.
1269
+ * @param namespace - The namespace of the adapter to remove.
1270
+ */
1271
+ removeAdapter(namespace) {
1272
+ const isConnected = this.getIsConnectedState();
1273
+ const adapter = this.getAdapter(namespace);
1274
+ if (!adapter || !this.chainAdapters || isConnected) {
1275
+ return;
1276
+ }
1277
+ const newCaipNetworks = this.caipNetworks?.filter(network => network.chainNamespace !== namespace);
1278
+ ChainController.removeAdapter(namespace);
1279
+ ConnectorController.removeAdapter(namespace);
1280
+ this.chainNamespaces = this.chainNamespaces.filter(n => n !== namespace);
1281
+ this.caipNetworks = newCaipNetworks;
1282
+ adapter.removeAllEventListeners();
1283
+ Reflect.deleteProperty(this.chainAdapters, namespace);
1284
+ }
1285
+ /**
1286
+ * Adds an adapter to the AppKit.
1287
+ * @param adapter - The adapter instance.
1288
+ * @param networks - The list of networks that this adapter supports / uses.
1289
+ */
1290
+ addAdapter(adapter, networks) {
1291
+ const namespace = adapter.namespace;
1292
+ if (!this.connectionControllerClient || !this.networkControllerClient) {
1293
+ return;
1294
+ }
1295
+ if (!this.chainAdapters || !namespace) {
1296
+ return;
1297
+ }
1298
+ const extendedAdapterNetworks = this.extendCaipNetworks({ ...this.options, networks });
1299
+ this.caipNetworks = [...(this.caipNetworks || []), ...extendedAdapterNetworks];
1300
+ this.createAdapter(adapter);
1301
+ this.initChainAdapter(namespace);
1302
+ ChainController.addAdapter(adapter, {
1303
+ connectionControllerClient: this.connectionControllerClient,
1304
+ networkControllerClient: this.networkControllerClient
1305
+ }, extendedAdapterNetworks);
1306
+ }
1307
+ /**
1308
+ * Adds a network to an existing adapter in AppKit.
1309
+ * @param namespace - The chain namespace to add the network to (e.g. 'eip155', 'solana')
1310
+ * @param network - The network configuration to add
1311
+ * @throws Error if adapter for namespace doesn't exist
1312
+ */
1313
+ addNetwork(namespace, network) {
1314
+ if (this.chainAdapters && !this.chainAdapters[namespace]) {
1315
+ throw new Error(`Adapter for namespace ${namespace} doesn't exist`);
1316
+ }
1317
+ const extendedNetwork = this.extendCaipNetwork(network, this.options);
1318
+ ChainController.addNetwork(extendedNetwork);
1319
+ if (this.caipNetworks && !this.caipNetworks?.find(n => n.id === extendedNetwork.id)) {
1320
+ this.caipNetworks.push(extendedNetwork);
1321
+ }
1322
+ }
1323
+ /**
1324
+ * Removes a network from an existing adapter in AppKit.
1325
+ * @param namespace - The chain namespace the network belongs to
1326
+ * @param networkId - The network ID to remove
1327
+ * @throws Error if adapter for namespace doesn't exist or if removing last network
1328
+ */
1329
+ removeNetwork(namespace, networkId) {
1330
+ if (this.chainAdapters && !this.chainAdapters[namespace]) {
1331
+ throw new Error(`Adapter for namespace ${namespace} doesn't exist`);
1332
+ }
1333
+ const networkToRemove = this.caipNetworks?.find(n => n.id === networkId);
1334
+ if (!networkToRemove) {
1335
+ throw new Error(`Network with ID ${networkId} not found`);
1336
+ }
1337
+ if (!this.caipNetworks) {
1338
+ return;
1339
+ }
1340
+ const remainingNetworks = this.caipNetworks.filter(n => n.chainNamespace === namespace && n.id !== networkId);
1341
+ if (!remainingNetworks?.length) {
1342
+ throw new Error('Cannot remove last network for a namespace');
1343
+ }
1344
+ ChainController.removeNetwork(namespace, networkId);
1345
+ this.caipNetworks = [...remainingNetworks];
1346
+ }
1347
+ }
1348
+ //# sourceMappingURL=core.js.map