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