@dynamic-labs-sdk/client 1.2.0 → 1.3.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 (171) hide show
  1. package/dist/{InvalidParamError-Dhv4EhOy.native.esm.js → InvalidParamError-9kQBK3sP.native.esm.js} +2 -2
  2. package/dist/{InvalidParamError-Dhv4EhOy.native.esm.js.map → InvalidParamError-9kQBK3sP.native.esm.js.map} +1 -1
  3. package/dist/{InvalidParamError-CPzPxL0l.cjs → InvalidParamError-DQvZQdQ9.cjs} +3 -3
  4. package/dist/{InvalidParamError-CPzPxL0l.cjs.map → InvalidParamError-DQvZQdQ9.cjs.map} +1 -1
  5. package/dist/{InvalidParamError-BWWTxQ9d.esm.js → InvalidParamError-Za4cvW7K.esm.js} +2 -2
  6. package/dist/{InvalidParamError-BWWTxQ9d.esm.js.map → InvalidParamError-Za4cvW7K.esm.js.map} +1 -1
  7. package/dist/{NotWaasWalletAccountError-D_mLDrYD.native.esm.js → NotWaasWalletAccountError-BTMvHTA8.native.esm.js} +3 -3
  8. package/dist/{NotWaasWalletAccountError-D_mLDrYD.native.esm.js.map → NotWaasWalletAccountError-BTMvHTA8.native.esm.js.map} +1 -1
  9. package/dist/{NotWaasWalletAccountError-D1EuiYyR.esm.js → NotWaasWalletAccountError-By3Y4taq.esm.js} +3 -3
  10. package/dist/{NotWaasWalletAccountError-D1EuiYyR.esm.js.map → NotWaasWalletAccountError-By3Y4taq.esm.js.map} +1 -1
  11. package/dist/{NotWaasWalletAccountError-BcIbGm0s.cjs → NotWaasWalletAccountError-Ciq7b-Y6.cjs} +3 -3
  12. package/dist/{NotWaasWalletAccountError-BcIbGm0s.cjs.map → NotWaasWalletAccountError-Ciq7b-Y6.cjs.map} +1 -1
  13. package/dist/core.cjs +45 -5
  14. package/dist/core.cjs.map +1 -1
  15. package/dist/core.esm.js +45 -8
  16. package/dist/core.esm.js.map +1 -1
  17. package/dist/core.native.esm.js +43 -6
  18. package/dist/core.native.esm.js.map +1 -1
  19. package/dist/errors/ArrayMustNotBeEmptyError.d.ts +5 -0
  20. package/dist/errors/ArrayMustNotBeEmptyError.d.ts.map +1 -0
  21. package/dist/exports/core.d.ts +8 -0
  22. package/dist/exports/core.d.ts.map +1 -1
  23. package/dist/exports/index.d.ts +5 -0
  24. package/dist/exports/index.d.ts.map +1 -1
  25. package/dist/{getNetworkProviderFromNetworkId-D26TNjm4.cjs → getNetworkProviderFromNetworkId-BA0CHZzu.cjs} +30 -4
  26. package/dist/getNetworkProviderFromNetworkId-BA0CHZzu.cjs.map +1 -0
  27. package/dist/{getNetworkProviderFromNetworkId-VkHaRqMa.native.esm.js → getNetworkProviderFromNetworkId-COptFPwJ.native.esm.js} +25 -5
  28. package/dist/getNetworkProviderFromNetworkId-COptFPwJ.native.esm.js.map +1 -0
  29. package/dist/{getNetworkProviderFromNetworkId-C9QzgcLs.esm.js → getNetworkProviderFromNetworkId-RWcIZDgC.esm.js} +29 -9
  30. package/dist/getNetworkProviderFromNetworkId-RWcIZDgC.esm.js.map +1 -0
  31. package/dist/{getSignedSessionId-D52QC0hh.cjs → getSignedSessionId-BCU987hO.cjs} +3 -3
  32. package/dist/{getSignedSessionId-D52QC0hh.cjs.map → getSignedSessionId-BCU987hO.cjs.map} +1 -1
  33. package/dist/{getSignedSessionId-L0T26uTy.native.esm.js → getSignedSessionId-DzNCj6g_.native.esm.js} +3 -3
  34. package/dist/{getSignedSessionId-L0T26uTy.native.esm.js.map → getSignedSessionId-DzNCj6g_.native.esm.js.map} +1 -1
  35. package/dist/{getSignedSessionId-DcJl2sy8.esm.js → getSignedSessionId-la6RXITX.esm.js} +3 -3
  36. package/dist/{getSignedSessionId-DcJl2sy8.esm.js.map → getSignedSessionId-la6RXITX.esm.js.map} +1 -1
  37. package/dist/{getVerifiedCredentialForWalletAccount-Cm2e3Boz.esm.js → getVerifiedCredentialForWalletAccount-DKJcLLHq.native.esm.js} +3 -2
  38. package/dist/getVerifiedCredentialForWalletAccount-DKJcLLHq.native.esm.js.map +1 -0
  39. package/dist/{getVerifiedCredentialForWalletAccount-C94BZhqL.cjs → getVerifiedCredentialForWalletAccount-DSSDwOyq.cjs} +4 -3
  40. package/dist/getVerifiedCredentialForWalletAccount-DSSDwOyq.cjs.map +1 -0
  41. package/dist/{getVerifiedCredentialForWalletAccount-CMEe9e1b.native.esm.js → getVerifiedCredentialForWalletAccount-Ozctwnyv.esm.js} +3 -2
  42. package/dist/getVerifiedCredentialForWalletAccount-Ozctwnyv.esm.js.map +1 -0
  43. package/dist/index.cjs +967 -18
  44. package/dist/index.cjs.map +1 -1
  45. package/dist/index.esm.js +968 -22
  46. package/dist/index.esm.js.map +1 -1
  47. package/dist/index.native.esm.js +970 -24
  48. package/dist/index.native.esm.js.map +1 -1
  49. package/dist/{isMfaRequiredForAction-vbGFqLFc.esm.js → isMfaRequiredForAction-C1u4Z__n.esm.js} +2 -2
  50. package/dist/{isMfaRequiredForAction-vbGFqLFc.esm.js.map → isMfaRequiredForAction-C1u4Z__n.esm.js.map} +1 -1
  51. package/dist/{isMfaRequiredForAction-kxGzZLB_.cjs → isMfaRequiredForAction-CMClgbT0.cjs} +2 -2
  52. package/dist/{isMfaRequiredForAction-kxGzZLB_.cjs.map → isMfaRequiredForAction-CMClgbT0.cjs.map} +1 -1
  53. package/dist/{isMfaRequiredForAction-B6kjcIA2.native.esm.js → isMfaRequiredForAction-DSX-TV2z.native.esm.js} +2 -2
  54. package/dist/{isMfaRequiredForAction-B6kjcIA2.native.esm.js.map → isMfaRequiredForAction-DSX-TV2z.native.esm.js.map} +1 -1
  55. package/dist/modules/balances/getBalances/getBalances.d.ts +22 -10
  56. package/dist/modules/balances/getBalances/getBalances.d.ts.map +1 -1
  57. package/dist/modules/checkout/getCheckoutTransactionQuote/getCheckoutTransactionQuote.d.ts +6 -2
  58. package/dist/modules/checkout/getCheckoutTransactionQuote/getCheckoutTransactionQuote.d.ts.map +1 -1
  59. package/dist/modules/legacyWalletBook/excludeInstalledFromCatalog/collectInstalledGroupIds/collectInstalledGroupIds.d.ts +26 -0
  60. package/dist/modules/legacyWalletBook/excludeInstalledFromCatalog/collectInstalledGroupIds/collectInstalledGroupIds.d.ts.map +1 -0
  61. package/dist/modules/legacyWalletBook/excludeInstalledFromCatalog/collectInstalledGroupIds/index.d.ts +2 -0
  62. package/dist/modules/legacyWalletBook/excludeInstalledFromCatalog/collectInstalledGroupIds/index.d.ts.map +1 -0
  63. package/dist/modules/legacyWalletBook/excludeInstalledFromCatalog/excludeInstalledFromCatalog.d.ts +28 -0
  64. package/dist/modules/legacyWalletBook/excludeInstalledFromCatalog/excludeInstalledFromCatalog.d.ts.map +1 -0
  65. package/dist/modules/legacyWalletBook/excludeInstalledFromCatalog/index.d.ts +2 -0
  66. package/dist/modules/legacyWalletBook/excludeInstalledFromCatalog/index.d.ts.map +1 -0
  67. package/dist/modules/legacyWalletBook/getWalletConnectCatalog/shouldFilterWalletForWalletConnect/index.d.ts +2 -0
  68. package/dist/modules/legacyWalletBook/getWalletConnectCatalog/{shouldFilterWallet → shouldFilterWalletForWalletConnect}/index.d.ts.map +1 -1
  69. package/dist/modules/legacyWalletBook/getWalletConnectCatalog/shouldFilterWalletForWalletConnect/shouldFilterWalletForWalletConnect.d.ts +13 -0
  70. package/dist/modules/legacyWalletBook/getWalletConnectCatalog/shouldFilterWalletForWalletConnect/shouldFilterWalletForWalletConnect.d.ts.map +1 -0
  71. package/dist/modules/legacyWalletBook/matchWalletProvidersToCatalogGroup/index.d.ts +2 -0
  72. package/dist/modules/legacyWalletBook/matchWalletProvidersToCatalogGroup/index.d.ts.map +1 -0
  73. package/dist/modules/legacyWalletBook/matchWalletProvidersToCatalogGroup/matchWalletProvidersToCatalogGroup.d.ts +26 -0
  74. package/dist/modules/legacyWalletBook/matchWalletProvidersToCatalogGroup/matchWalletProvidersToCatalogGroup.d.ts.map +1 -0
  75. package/dist/modules/legacyWalletBook/priorityWalletKeys/priorityWalletKeys.d.ts +10 -0
  76. package/dist/modules/legacyWalletBook/priorityWalletKeys/priorityWalletKeys.d.ts.map +1 -0
  77. package/dist/modules/legacyWalletBook/shouldFilterWallet/index.d.ts +3 -0
  78. package/dist/modules/legacyWalletBook/shouldFilterWallet/index.d.ts.map +1 -0
  79. package/dist/modules/legacyWalletBook/shouldFilterWallet/shouldFilterWallet.d.ts +34 -0
  80. package/dist/modules/legacyWalletBook/shouldFilterWallet/shouldFilterWallet.d.ts.map +1 -0
  81. package/dist/modules/walletOptionsCatalogue/buildInAppBrowserOptions/buildInAppBrowserOptions.d.ts +22 -0
  82. package/dist/modules/walletOptionsCatalogue/buildInAppBrowserOptions/buildInAppBrowserOptions.d.ts.map +1 -0
  83. package/dist/modules/walletOptionsCatalogue/buildInAppBrowserOptions/getInAppBrowserUrl/getInAppBrowserUrl.d.ts +18 -0
  84. package/dist/modules/walletOptionsCatalogue/buildInAppBrowserOptions/getInAppBrowserUrl/getInAppBrowserUrl.d.ts.map +1 -0
  85. package/dist/modules/walletOptionsCatalogue/buildInAppBrowserOptions/getInAppBrowserUrl/index.d.ts +2 -0
  86. package/dist/modules/walletOptionsCatalogue/buildInAppBrowserOptions/getInAppBrowserUrl/index.d.ts.map +1 -0
  87. package/dist/modules/walletOptionsCatalogue/buildInAppBrowserOptions/index.d.ts +2 -0
  88. package/dist/modules/walletOptionsCatalogue/buildInAppBrowserOptions/index.d.ts.map +1 -0
  89. package/dist/modules/walletOptionsCatalogue/buildInstallationUrls/buildInstallationUrls.d.ts +21 -0
  90. package/dist/modules/walletOptionsCatalogue/buildInstallationUrls/buildInstallationUrls.d.ts.map +1 -0
  91. package/dist/modules/walletOptionsCatalogue/buildInstallationUrlsByWalletOptionKey/buildInstallationUrlsByWalletOptionKey.d.ts +27 -0
  92. package/dist/modules/walletOptionsCatalogue/buildInstallationUrlsByWalletOptionKey/buildInstallationUrlsByWalletOptionKey.d.ts.map +1 -0
  93. package/dist/modules/walletOptionsCatalogue/buildWalletConnectOptions/buildWalletConnectOptions.d.ts +23 -0
  94. package/dist/modules/walletOptionsCatalogue/buildWalletConnectOptions/buildWalletConnectOptions.d.ts.map +1 -0
  95. package/dist/modules/walletOptionsCatalogue/buildWalletOption/buildWalletOption.d.ts +39 -0
  96. package/dist/modules/walletOptionsCatalogue/buildWalletOption/buildWalletOption.d.ts.map +1 -0
  97. package/dist/modules/walletOptionsCatalogue/buildWithWalletProviderOptions/buildWithWalletProviderOptions.d.ts +54 -0
  98. package/dist/modules/walletOptionsCatalogue/buildWithWalletProviderOptions/buildWithWalletProviderOptions.d.ts.map +1 -0
  99. package/dist/modules/walletOptionsCatalogue/classifyWithWalletProviderSource/classifyWithWalletProviderSource.d.ts +31 -0
  100. package/dist/modules/walletOptionsCatalogue/classifyWithWalletProviderSource/classifyWithWalletProviderSource.d.ts.map +1 -0
  101. package/dist/modules/walletOptionsCatalogue/compareByRelevance/compareByRelevance.d.ts +18 -0
  102. package/dist/modules/walletOptionsCatalogue/compareByRelevance/compareByRelevance.d.ts.map +1 -0
  103. package/dist/modules/walletOptionsCatalogue/excludedWalletOptionKeys/excludedWalletOptionKeys.d.ts +15 -0
  104. package/dist/modules/walletOptionsCatalogue/excludedWalletOptionKeys/excludedWalletOptionKeys.d.ts.map +1 -0
  105. package/dist/modules/walletOptionsCatalogue/findWalletOptionKeyForProviderKey/findByNameMatch/findByNameMatch.d.ts +21 -0
  106. package/dist/modules/walletOptionsCatalogue/findWalletOptionKeyForProviderKey/findByNameMatch/findByNameMatch.d.ts.map +1 -0
  107. package/dist/modules/walletOptionsCatalogue/findWalletOptionKeyForProviderKey/findWalletOptionKeyForProviderKey.d.ts +44 -0
  108. package/dist/modules/walletOptionsCatalogue/findWalletOptionKeyForProviderKey/findWalletOptionKeyForProviderKey.d.ts.map +1 -0
  109. package/dist/modules/walletOptionsCatalogue/findWalletOptionKeyForProviderKey/resolveWalletOptionKey/resolveWalletOptionKey.d.ts +20 -0
  110. package/dist/modules/walletOptionsCatalogue/findWalletOptionKeyForProviderKey/resolveWalletOptionKey/resolveWalletOptionKey.d.ts.map +1 -0
  111. package/dist/modules/walletOptionsCatalogue/getConnectionOptionPriority/getConnectionOptionPriority.d.ts +15 -0
  112. package/dist/modules/walletOptionsCatalogue/getConnectionOptionPriority/getConnectionOptionPriority.d.ts.map +1 -0
  113. package/dist/modules/walletOptionsCatalogue/getPriorityIndex/getPriorityIndex.d.ts +16 -0
  114. package/dist/modules/walletOptionsCatalogue/getPriorityIndex/getPriorityIndex.d.ts.map +1 -0
  115. package/dist/modules/walletOptionsCatalogue/getWalletOptionsCatalogue/getWalletOptionsCatalogue.d.ts +24 -0
  116. package/dist/modules/walletOptionsCatalogue/getWalletOptionsCatalogue/getWalletOptionsCatalogue.d.ts.map +1 -0
  117. package/dist/modules/walletOptionsCatalogue/groupOptionsByWalletOption/groupOptionsByWalletOption.d.ts +49 -0
  118. package/dist/modules/walletOptionsCatalogue/groupOptionsByWalletOption/groupOptionsByWalletOption.d.ts.map +1 -0
  119. package/dist/modules/walletOptionsCatalogue/hasAnyConnectionOption/hasAnyConnectionOption.d.ts +18 -0
  120. package/dist/modules/walletOptionsCatalogue/hasAnyConnectionOption/hasAnyConnectionOption.d.ts.map +1 -0
  121. package/dist/modules/walletOptionsCatalogue/hasInstalledProvider/hasInstalledProvider.d.ts +18 -0
  122. package/dist/modules/walletOptionsCatalogue/hasInstalledProvider/hasInstalledProvider.d.ts.map +1 -0
  123. package/dist/modules/walletOptionsCatalogue/normalizeWalletDisplayName/normalizeWalletDisplayName.d.ts +23 -0
  124. package/dist/modules/walletOptionsCatalogue/normalizeWalletDisplayName/normalizeWalletDisplayName.d.ts.map +1 -0
  125. package/dist/modules/walletOptionsCatalogue/resolveWalletBookWalletOptionKey/resolveWalletBookWalletOptionKey.d.ts +22 -0
  126. package/dist/modules/walletOptionsCatalogue/resolveWalletBookWalletOptionKey/resolveWalletBookWalletOptionKey.d.ts.map +1 -0
  127. package/dist/modules/walletOptionsCatalogue/sortConnectionOptions/sortConnectionOptions.d.ts +20 -0
  128. package/dist/modules/walletOptionsCatalogue/sortConnectionOptions/sortConnectionOptions.d.ts.map +1 -0
  129. package/dist/modules/walletOptionsCatalogue/sortWalletOptions/sortWalletOptions.d.ts +34 -0
  130. package/dist/modules/walletOptionsCatalogue/sortWalletOptions/sortWalletOptions.d.ts.map +1 -0
  131. package/dist/modules/walletOptionsCatalogue/walletOptionsCatalogue.types.d.ts +164 -0
  132. package/dist/modules/walletOptionsCatalogue/walletOptionsCatalogue.types.d.ts.map +1 -0
  133. package/dist/modules/wallets/utils/getSignInMessage/createSignInMessageStatement/createSignInMessageStatement.d.ts.map +1 -1
  134. package/dist/modules/wallets/utils/getSignInMessage/getSignInMessage.d.ts.map +1 -1
  135. package/dist/modules/wallets/utils/stripChainSuffix/stripChainSuffix.d.ts +20 -0
  136. package/dist/modules/wallets/utils/stripChainSuffix/stripChainSuffix.d.ts.map +1 -0
  137. package/dist/modules/wallets/walletProviderRegistry/createWalletProviderRegistry/createWalletProviderRegistry.d.ts.map +1 -1
  138. package/dist/modules/wallets/walletProviderRegistry/index.d.ts +1 -1
  139. package/dist/modules/wallets/walletProviderRegistry/index.d.ts.map +1 -1
  140. package/dist/modules/wallets/walletProviderRegistry/walletProviderRegistry.types.d.ts +19 -0
  141. package/dist/modules/wallets/walletProviderRegistry/walletProviderRegistry.types.d.ts.map +1 -1
  142. package/dist/modules/wallets/walletProviderUriConnection.types.d.ts +23 -0
  143. package/dist/modules/wallets/walletProviderUriConnection.types.d.ts.map +1 -0
  144. package/dist/tsconfig.lib.tsbuildinfo +1 -1
  145. package/dist/utils/assertNonEmptyArray/assertNonEmptyArray.d.ts +19 -0
  146. package/dist/utils/assertNonEmptyArray/assertNonEmptyArray.d.ts.map +1 -0
  147. package/dist/utils/assertNonEmptyArray/index.d.ts +2 -0
  148. package/dist/utils/assertNonEmptyArray/index.d.ts.map +1 -0
  149. package/dist/utils/getAppMetadata/getAppMetadata.d.ts +16 -0
  150. package/dist/utils/getAppMetadata/getAppMetadata.d.ts.map +1 -0
  151. package/dist/utils/getAppMetadata/index.d.ts +3 -0
  152. package/dist/utils/getAppMetadata/index.d.ts.map +1 -0
  153. package/dist/waas.cjs +6 -5
  154. package/dist/waas.cjs.map +1 -1
  155. package/dist/waas.esm.js +5 -4
  156. package/dist/waas.esm.js.map +1 -1
  157. package/dist/waas.native.esm.js +5 -4
  158. package/dist/waas.native.esm.js.map +1 -1
  159. package/dist/waasCore.cjs +4 -4
  160. package/dist/waasCore.esm.js +3 -3
  161. package/dist/waasCore.native.esm.js +3 -3
  162. package/package.json +3 -3
  163. package/dist/getNetworkProviderFromNetworkId-C9QzgcLs.esm.js.map +0 -1
  164. package/dist/getNetworkProviderFromNetworkId-D26TNjm4.cjs.map +0 -1
  165. package/dist/getNetworkProviderFromNetworkId-VkHaRqMa.native.esm.js.map +0 -1
  166. package/dist/getVerifiedCredentialForWalletAccount-C94BZhqL.cjs.map +0 -1
  167. package/dist/getVerifiedCredentialForWalletAccount-CMEe9e1b.native.esm.js.map +0 -1
  168. package/dist/getVerifiedCredentialForWalletAccount-Cm2e3Boz.esm.js.map +0 -1
  169. package/dist/modules/legacyWalletBook/getWalletConnectCatalog/shouldFilterWallet/index.d.ts +0 -2
  170. package/dist/modules/legacyWalletBook/getWalletConnectCatalog/shouldFilterWallet/shouldFilterWallet.d.ts +0 -21
  171. package/dist/modules/legacyWalletBook/getWalletConnectCatalog/shouldFilterWallet/shouldFilterWallet.d.ts.map +0 -1
@@ -0,0 +1,164 @@
1
+ import type { Chain } from '../chain';
2
+ /**
3
+ * Identifies where a registered wallet provider came from. Used as the
4
+ * `source` discriminator on `WithWalletProviderConnectionOption` so customer
5
+ * UIs can label "browser extension" vs "wallet SDK" without having to inspect
6
+ * the registered provider's metadata.
7
+ *
8
+ * - `selfAnnounced`: announced via an in-page self-announcement standard
9
+ * (EIP-6963 on EVM, Wallet Standard on Solana / Sui / …).
10
+ * - `windowInjected`: legacy `window.*` injection (e.g. `window.ethereum`).
11
+ * - `sdk`: registered by a chain extension that wraps a vendor SDK
12
+ * (Base Account via `@base-org/account`, MetaMask Connect, etc.).
13
+ */
14
+ export type WithWalletProviderSource = 'selfAnnounced' | 'windowInjected' | 'sdk';
15
+ /**
16
+ * A wallet that the customer can connect to directly through a registered
17
+ * wallet provider. The customer resolves the live provider via
18
+ * `getWalletProviderByKey({ key: walletProviderKey })`, then calls
19
+ * `.connect()` / `.signMessage()` / etc. on it.
20
+ *
21
+ * `walletProviderKey` follows the standard format produced by
22
+ * `formatWalletProviderKey`:
23
+ * `<normalizedWalletNameWithChain>:<walletProviderType>[:<suffix>]`.
24
+ */
25
+ export type WithWalletProviderConnectionOption = {
26
+ chain: Chain;
27
+ source: WithWalletProviderSource;
28
+ type: 'withWalletProvider';
29
+ walletProviderKey: string;
30
+ };
31
+ /**
32
+ * A WalletConnect-capable wallet. Carries deeplinks only; the customer drives
33
+ * the WC pairing flow themselves by calling the chain-level
34
+ * `connectWithWalletConnect<Chain>` function, then appending the resulting WC
35
+ * URI onto one of the deeplinks via `appendWalletConnectUriToDeepLink`.
36
+ *
37
+ * The `WalletConnectWalletProvider` is only created after session approval,
38
+ * so there is no provider key to attach to the option at catalogue-build time.
39
+ */
40
+ export type WalletConnectConnectionOption = {
41
+ chain: Chain;
42
+ deeplinks: {
43
+ /** Native deeplink scheme (e.g. `metamask://`). */
44
+ native?: string;
45
+ /** Universal link (e.g. `https://metamask.app.link`). */
46
+ universal?: string;
47
+ };
48
+ type: 'walletConnect';
49
+ };
50
+ /**
51
+ * A mobile wallet that exposes an in-app browser entry URL. The URL is a
52
+ * template (e.g. `https://go.base.app/dapp?cb_url={{encodedDappURI}}`) — the
53
+ * customer substitutes `{{encodedDappURI}}` with the encoded current dapp URL
54
+ * before opening it.
55
+ */
56
+ export type InAppBrowserConnectionOption = {
57
+ chain: Chain;
58
+ type: 'inAppBrowser';
59
+ url: string;
60
+ };
61
+ /**
62
+ * Install / download links for a wallet option whose product can be
63
+ * installed by the user on this device. Surfaced on `WalletOption` when
64
+ * `includeInstallation: true` is passed to `getWalletOptionsCatalogue`.
65
+ *
66
+ * Installation is intentionally not a `WalletConnectionOption` — the user
67
+ * cannot "connect" with an install link, and rendering it inline with
68
+ * real connection actions misleads them. Each platform's URL is optional
69
+ * and only present when the wallet book carries the corresponding store
70
+ * ID.
71
+ */
72
+ export type InstallationUrls = {
73
+ android?: string;
74
+ chrome?: string;
75
+ edge?: string;
76
+ firefox?: string;
77
+ ios?: string;
78
+ native?: string;
79
+ opera?: string;
80
+ safari?: string;
81
+ };
82
+ /**
83
+ * One option for connecting to a wallet option. Each `WalletOption`
84
+ * carries an ordered array of these; the first element is always "the
85
+ * best available connection" by the priority documented on
86
+ * `getWalletOptionsCatalogue`.
87
+ */
88
+ export type WalletConnectionOption = WithWalletProviderConnectionOption | WalletConnectConnectionOption | InAppBrowserConnectionOption;
89
+ /**
90
+ * A wallet option surfaced by `getWalletOptionsCatalogue` — one wallet the
91
+ * user can sign in with (MetaMask, Coinbase, Phantom, …). A wallet option
92
+ * surfaces when it has at least one `connectionOption` OR a populated
93
+ * `installationUrls` bag — install-only wallets (no connection available
94
+ * but the user can install the product) are surfaced with empty
95
+ * `connectionOptions` so the customer UI can render the install links
96
+ * distinctly.
97
+ */
98
+ export type WalletOption = {
99
+ /**
100
+ * Ordered connection options for this wallet. Sorted by option-type
101
+ * priority (`withWalletProvider` > `walletConnect` > `inAppBrowser`),
102
+ * then by chain for stability. May be empty when only
103
+ * `installationUrls` are available.
104
+ */
105
+ connectionOptions: WalletConnectionOption[];
106
+ /** Full URL to the wallet's icon. */
107
+ iconUrl: string;
108
+ /**
109
+ * Install / download links for this wallet. Present when
110
+ * `includeInstallation: true` is passed to `getWalletOptionsCatalogue`
111
+ * and the wallet book carries at least one store ID / desktop URL for
112
+ * the wallet. The customer UI should render these as install actions,
113
+ * distinct from `connectionOptions`.
114
+ */
115
+ installationUrls?: InstallationUrls;
116
+ /** Stable key from the wallet book (e.g. `"metamask"`). */
117
+ key: string;
118
+ /** Display name for the wallet. */
119
+ name: string;
120
+ /** Brand color in hex (e.g. `"#f6851b"`). */
121
+ primaryColor?: string;
122
+ };
123
+ /**
124
+ * Controls how wallet options are ordered in the returned catalogue.
125
+ *
126
+ * - `'relevance'` (default): Dynamic's recommended order.
127
+ * - `'alphabetical'`: case-insensitive by wallet option `name`.
128
+ */
129
+ export type WalletOptionOrdering = 'relevance' | 'alphabetical';
130
+ /**
131
+ * Parameters for `getWalletOptionsCatalogue`.
132
+ *
133
+ * Only `includeWithWalletProvider` defaults to `true`. The remaining flags
134
+ * are opt-in — call sites that want WalletConnect or in-app-browser options
135
+ * must request them explicitly.
136
+ */
137
+ export type GetWalletOptionsCatalogueParams = {
138
+ /** Defaults to `false`. Mobile in-app browser launch URL. */
139
+ includeInAppBrowser?: boolean;
140
+ /** Defaults to `false`. Install / download links for wallets the user doesn't have yet. */
141
+ includeInstallation?: boolean;
142
+ /**
143
+ * Defaults to `false`. Meant to be used alongside our WalletConnect chain
144
+ * extensions (`addWalletConnectEvmExtension`,
145
+ * `addWalletConnectSolanaExtension`, …) so the WC pairing flow has
146
+ * something to connect to once the user picks a wallet from the catalogue.
147
+ */
148
+ includeWalletConnect?: boolean;
149
+ /**
150
+ * Defaults to `true`. Use this for users who already have the wallet
151
+ * available in the page — browser extensions discovered via EIP-6963,
152
+ * Wallet Standard, legacy window injection, or one of our SDK-backed
153
+ * providers (Base Account, MetaMask Connect, …).
154
+ */
155
+ includeWithWalletProvider?: boolean;
156
+ /** Defaults to `'relevance'`. See {@link WalletOptionOrdering}. */
157
+ walletOptionOrdering?: WalletOptionOrdering;
158
+ };
159
+ /**
160
+ * Return type of `getWalletOptionsCatalogue` — an ordered array of wallet
161
+ * options. See {@link WalletOptionOrdering} for ordering details.
162
+ */
163
+ export type WalletOptionsCatalogue = WalletOption[];
164
+ //# sourceMappingURL=walletOptionsCatalogue.types.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"walletOptionsCatalogue.types.d.ts","sourceRoot":"","sources":["../../../src/modules/walletOptionsCatalogue/walletOptionsCatalogue.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AAEtC;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,wBAAwB,GAChC,eAAe,GACf,gBAAgB,GAChB,KAAK,CAAC;AAEV;;;;;;;;;GASG;AACH,MAAM,MAAM,kCAAkC,GAAG;IAC/C,KAAK,EAAE,KAAK,CAAC;IACb,MAAM,EAAE,wBAAwB,CAAC;IACjC,IAAI,EAAE,oBAAoB,CAAC;IAC3B,iBAAiB,EAAE,MAAM,CAAC;CAC3B,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,MAAM,6BAA6B,GAAG;IAC1C,KAAK,EAAE,KAAK,CAAC;IACb,SAAS,EAAE;QACT,mDAAmD;QACnD,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,yDAAyD;QACzD,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,IAAI,EAAE,eAAe,CAAC;CACvB,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,4BAA4B,GAAG;IACzC,KAAK,EAAE,KAAK,CAAC;IACb,IAAI,EAAE,cAAc,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;CACb,CAAC;AAEF;;;;;;;;;;GAUG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,sBAAsB,GAC9B,kCAAkC,GAClC,6BAA6B,GAC7B,4BAA4B,CAAC;AAEjC;;;;;;;;GAQG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB;;;;;OAKG;IACH,iBAAiB,EAAE,sBAAsB,EAAE,CAAC;IAC5C,qCAAqC;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB;;;;;;OAMG;IACH,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,2DAA2D;IAC3D,GAAG,EAAE,MAAM,CAAC;IACZ,mCAAmC;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,6CAA6C;IAC7C,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,oBAAoB,GAAG,WAAW,GAAG,cAAc,CAAC;AAEhE;;;;;;GAMG;AACH,MAAM,MAAM,+BAA+B,GAAG;IAC5C,6DAA6D;IAC7D,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,2FAA2F;IAC3F,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B;;;;;OAKG;IACH,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B;;;;;OAKG;IACH,yBAAyB,CAAC,EAAE,OAAO,CAAC;IACpC,mEAAmE;IACnE,oBAAoB,CAAC,EAAE,oBAAoB,CAAC;CAC7C,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,sBAAsB,GAAG,YAAY,EAAE,CAAC"}
@@ -1 +1 @@
1
- {"version":3,"file":"createSignInMessageStatement.d.ts","sourceRoot":"","sources":["../../../../../../src/modules/wallets/utils/getSignInMessage/createSignInMessageStatement/createSignInMessageStatement.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAEjE,wBAAwB;AACxB,eAAO,MAAM,4BAA4B,WAAY,aAAa,WAOjE,CAAC"}
1
+ {"version":3,"file":"createSignInMessageStatement.d.ts","sourceRoot":"","sources":["../../../../../../src/modules/wallets/utils/getSignInMessage/createSignInMessageStatement/createSignInMessageStatement.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAGjE,wBAAwB;AACxB,eAAO,MAAM,4BAA4B,WAAY,aAAa,WAIjE,CAAC"}
@@ -1 +1 @@
1
- {"version":3,"file":"getSignInMessage.d.ts","sourceRoot":"","sources":["../../../../../src/modules/wallets/utils/getSignInMessage/getSignInMessage.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAI9D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAMzD,KAAK,sBAAsB,GAAG;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,aAAa,CAAC;CAC9B,CAAC;AAEF,wBAAwB;AACxB,eAAO,MAAM,gBAAgB,4CACc,sBAAsB,UACvD,aAAa,oBA+CtB,CAAC"}
1
+ {"version":3,"file":"getSignInMessage.d.ts","sourceRoot":"","sources":["../../../../../src/modules/wallets/utils/getSignInMessage/getSignInMessage.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAK9D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAMzD,KAAK,sBAAsB,GAAG;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,aAAa,CAAC;CAC9B,CAAC;AAEF,wBAAwB;AACxB,eAAO,MAAM,gBAAgB,4CACc,sBAAsB,UACvD,aAAa,oBA+CtB,CAAC"}
@@ -0,0 +1,20 @@
1
+ import type { Chain } from '../../../chain';
2
+ type StripChainSuffixParams = {
3
+ chain: Chain;
4
+ normalizedName: string;
5
+ };
6
+ /**
7
+ * Removes the lowercased chain suffix that `normalizeWalletNameWithChain`
8
+ * appends. Used by `findWalletOptionKeyForProviderKey` to recover the wallet
9
+ * book wallet key candidate from a `walletProviderKey`. If the suffix is
10
+ * not present (some chain extensions already bake the chain into the
11
+ * display name), the input is returned unchanged.
12
+ *
13
+ * @param params.chain - The chain whose suffix should be stripped.
14
+ * @param params.normalizedName - The normalized wallet-name-with-chain string.
15
+ * @returns The name with the chain suffix removed, or the input unchanged.
16
+ * @not-instrumented
17
+ */
18
+ export declare const stripChainSuffix: ({ chain, normalizedName, }: StripChainSuffixParams) => string;
19
+ export {};
20
+ //# sourceMappingURL=stripChainSuffix.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"stripChainSuffix.d.ts","sourceRoot":"","sources":["../../../../../src/modules/wallets/utils/stripChainSuffix/stripChainSuffix.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAE5C,KAAK,sBAAsB,GAAG;IAC5B,KAAK,EAAE,KAAK,CAAC;IACb,cAAc,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,gBAAgB,+BAG1B,sBAAsB,KAAG,MAQ3B,CAAC"}
@@ -1 +1 @@
1
- {"version":3,"file":"createWalletProviderRegistry.d.ts","sourceRoot":"","sources":["../../../../../src/modules/wallets/walletProviderRegistry/createWalletProviderRegistry/createWalletProviderRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAG9D,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AAE9E;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,4BAA4B,WAC/B,aAAa,KACpB,sBAyDF,CAAC"}
1
+ {"version":3,"file":"createWalletProviderRegistry.d.ts","sourceRoot":"","sources":["../../../../../src/modules/wallets/walletProviderRegistry/createWalletProviderRegistry/createWalletProviderRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAG9D,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AAE9E;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,4BAA4B,WAC/B,aAAa,KACpB,sBA0DF,CAAC"}
@@ -1,3 +1,3 @@
1
1
  export { getWalletProviderRegistry } from './getWalletProviderRegistry';
2
- export { WalletProviderPriority, type WalletProviderRegistry, } from './walletProviderRegistry.types';
2
+ export { WalletProviderPriority, type WalletProviderRegistry, type WalletProviderRegistryEntry, } from './walletProviderRegistry.types';
3
3
  //# sourceMappingURL=index.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/modules/wallets/walletProviderRegistry/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAC;AACxE,OAAO,EACL,sBAAsB,EACtB,KAAK,sBAAsB,GAC5B,MAAM,gCAAgC,CAAC"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/modules/wallets/walletProviderRegistry/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAC;AACxE,OAAO,EACL,sBAAsB,EACtB,KAAK,sBAAsB,EAC3B,KAAK,2BAA2B,GACjC,MAAM,gCAAgC,CAAC"}
@@ -1,4 +1,15 @@
1
1
  import type { WalletProvider } from '../walletProvider/walletProvider.types';
2
+ /**
3
+ * A single entry in the wallet provider registry — the registered
4
+ * `WalletProvider` together with the priority it was registered at. Returned
5
+ * by `WalletProviderRegistry.listProviderEntries` for callers that need to
6
+ * reason about *how* a provider was registered (e.g. classifying the source
7
+ * of an injected provider).
8
+ */
9
+ export type WalletProviderRegistryEntry = {
10
+ priority: number;
11
+ walletProvider: WalletProvider;
12
+ };
2
13
  export declare enum WalletProviderPriority {
3
14
  /**
4
15
  * Highest priority should be used by wallet providers that implement
@@ -27,6 +38,14 @@ export type WalletProviderRegistry = {
27
38
  * @returns The wallet provider.
28
39
  */
29
40
  getByKey: (key: string) => WalletProvider | undefined;
41
+ /**
42
+ * Retrieves all registry entries — each entry pairs a wallet provider with
43
+ * the priority it was registered at. Useful for callers that need to know
44
+ * *how* a provider was registered (e.g. classifying the source of an
45
+ * injected provider for the wallet options catalogue).
46
+ * @returns The registry entries.
47
+ */
48
+ listProviderEntries: () => WalletProviderRegistryEntry[];
30
49
  /**
31
50
  * Retrieves all wallet providers.
32
51
  * @returns The wallet providers.
@@ -1 +1 @@
1
- {"version":3,"file":"walletProviderRegistry.types.d.ts","sourceRoot":"","sources":["../../../../src/modules/wallets/walletProviderRegistry/walletProviderRegistry.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wCAAwC,CAAC;AAG7E,oBAAY,sBAAsB;IAChC;;;;OAIG;IACH,UAAU,MAAM;IAChB;;;;OAIG;IACH,iCAAiC,KAAK;IACtC;;;;;OAKG;IACH,aAAa,KAAK;CACnB;AAED,MAAM,MAAM,sBAAsB,GAAG;IACnC;;;;OAIG;IACH,QAAQ,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,cAAc,GAAG,SAAS,CAAC;IACtD;;;OAGG;IACH,aAAa,EAAE,MAAM,cAAc,EAAE,CAAC;IACtC;;;OAGG;IACH,QAAQ,EAAE,CAAC,IAAI,EAAE;QACf,QAAQ,EAAE,sBAAsB,CAAC;QACjC,cAAc,EAAE,cAAc,CAAC;KAChC,KAAK,IAAI,CAAC;IACX;;;OAGG;IACH,UAAU,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CACnC,CAAC"}
1
+ {"version":3,"file":"walletProviderRegistry.types.d.ts","sourceRoot":"","sources":["../../../../src/modules/wallets/walletProviderRegistry/walletProviderRegistry.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wCAAwC,CAAC;AAE7E;;;;;;GAMG;AACH,MAAM,MAAM,2BAA2B,GAAG;IACxC,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,cAAc,CAAC;CAChC,CAAC;AAGF,oBAAY,sBAAsB;IAChC;;;;OAIG;IACH,UAAU,MAAM;IAChB;;;;OAIG;IACH,iCAAiC,KAAK;IACtC;;;;;OAKG;IACH,aAAa,KAAK;CACnB;AAED,MAAM,MAAM,sBAAsB,GAAG;IACnC;;;;OAIG;IACH,QAAQ,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,cAAc,GAAG,SAAS,CAAC;IACtD;;;;;;OAMG;IACH,mBAAmB,EAAE,MAAM,2BAA2B,EAAE,CAAC;IACzD;;;OAGG;IACH,aAAa,EAAE,MAAM,cAAc,EAAE,CAAC;IACtC;;;OAGG;IACH,QAAQ,EAAE,CAAC,IAAI,EAAE;QACf,QAAQ,EAAE,sBAAsB,CAAC;QACjC,cAAc,EAAE,cAAc,CAAC;KAChC,KAAK,IAAI,CAAC;IACX;;;OAGG;IACH,UAAU,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CACnC,CAAC"}
@@ -0,0 +1,23 @@
1
+ import type { WalletAccount } from './walletAccount';
2
+ /**
3
+ * Return shape for wallet-provider connection flows that establish a
4
+ * pairing through an external URI (rendered as a QR code or used as a
5
+ * deep link). Shared by the WalletConnect and MetaMask SDK URI-based
6
+ * connect helpers so consumers can render a single QR / deep-link UI
7
+ * regardless of which protocol is in use.
8
+ */
9
+ export type WalletProviderUriConnectionResult = {
10
+ /**
11
+ * Resolves to the wallet accounts created once the connection is
12
+ * approved on the wallet side.
13
+ */
14
+ approval: () => Promise<{
15
+ walletAccounts: WalletAccount[];
16
+ }>;
17
+ /**
18
+ * The pairing URI to hand to the wallet application — typically
19
+ * rendered as a QR code or used as a deep link.
20
+ */
21
+ uri: string;
22
+ };
23
+ //# sourceMappingURL=walletProviderUriConnection.types.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"walletProviderUriConnection.types.d.ts","sourceRoot":"","sources":["../../../src/modules/wallets/walletProviderUriConnection.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAErD;;;;;;GAMG;AACH,MAAM,MAAM,iCAAiC,GAAG;IAC9C;;;OAGG;IACH,QAAQ,EAAE,MAAM,OAAO,CAAC;QAAE,cAAc,EAAE,aAAa,EAAE,CAAA;KAAE,CAAC,CAAC;IAE7D;;;OAGG;IACH,GAAG,EAAE,MAAM,CAAC;CACb,CAAC"}