@dynamic-labs-sdk/client 1.2.1 → 1.4.0

package/dist/modules/walletOptionsCatalogue/hasAnyConnectionOption/hasAnyConnectionOption.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hasAnyConnectionOption.d.ts","sourceRoot":"","sources":["../../../../src/modules/walletOptionsCatalogue/hasAnyConnectionOption/hasAnyConnectionOption.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAEpE,KAAK,4BAA4B,GAAG;IAClC,YAAY,EAAE,YAAY,CAAC;CAC5B,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,sBAAsB,sBAEhC,4BAA4B,KAAG,OACS,CAAC"}

package/dist/modules/walletOptionsCatalogue/hasInstalledProvider/hasInstalledProvider.d.ts

@@ -0,0 +1,18 @@
+import type { WalletOption } from '../walletOptionsCatalogue.types';
+type HasInstalledProviderParams = {
+    walletOption: WalletOption;
+};
+/**
+ * True when the wallet option has a `withWalletProvider` connection — i.e.
+ * the user already has the wallet available in the page (browser extension,
+ * Wallet Standard announcement, window injection, or an SDK-backed provider
+ * one of our chain extensions registered). `connectionOptions` is
+ * pre-sorted, so a registered provider always sits at index 0 when present.
+ *
+ * @param params.walletOption - The wallet option to inspect.
+ * @returns True when an installed provider is available.
+ * @not-instrumented
+ */
+export declare const hasInstalledProvider: ({ walletOption, }: HasInstalledProviderParams) => boolean;
+export {};
+//# sourceMappingURL=hasInstalledProvider.d.ts.map

package/dist/modules/walletOptionsCatalogue/hasInstalledProvider/hasInstalledProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hasInstalledProvider.d.ts","sourceRoot":"","sources":["../../../../src/modules/walletOptionsCatalogue/hasInstalledProvider/hasInstalledProvider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAEpE,KAAK,0BAA0B,GAAG;IAChC,YAAY,EAAE,YAAY,CAAC;CAC5B,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,oBAAoB,sBAE9B,0BAA0B,KAAG,OACkC,CAAC"}

package/dist/modules/walletOptionsCatalogue/normalizeWalletDisplayName/normalizeWalletDisplayName.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Normalizes a wallet's self-announced `displayName` into a stable wallet
+ * option key. Used by `findWalletOptionKeyForProviderKey` as the off-book
+ * fallback — registered providers whose `walletProviderKey` does not
+ * resolve to any wallet book entry still surface in the catalogue under a
+ * key derived from the name they ship in their metadata.
+ *
+ * The normalization (lowercase + whitespace-strip) intentionally matches
+ * how the legacy wallet book composes its `wallets.<key>` keys, so a
+ * self-described provider's option will merge cleanly with its book entry
+ * if one ever lands later.
+ *
+ * Multi-chain registrations of the same wallet (e.g. Phantom announced via
+ * EIP-6963 on EVM and via Wallet Standard on Solana) collapse onto the
+ * same wallet option through this normalization, since each registration
+ * announces the same `displayName`.
+ *
+ * @param displayName - The provider's `metadata.displayName`.
+ * @returns The normalized wallet option key (lowercased, no whitespace).
+ * @not-instrumented
+ */
+export declare const normalizeWalletDisplayName: (displayName: string) => string;
+//# sourceMappingURL=normalizeWalletDisplayName.d.ts.map

package/dist/modules/walletOptionsCatalogue/normalizeWalletDisplayName/normalizeWalletDisplayName.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalizeWalletDisplayName.d.ts","sourceRoot":"","sources":["../../../../src/modules/walletOptionsCatalogue/normalizeWalletDisplayName/normalizeWalletDisplayName.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,0BAA0B,gBAAiB,MAAM,KAAG,MAClB,CAAC"}

package/dist/modules/walletOptionsCatalogue/resolveWalletBookWalletOptionKey/resolveWalletBookWalletOptionKey.d.ts

@@ -0,0 +1,22 @@
+import type { WalletSchema } from '../../legacyWalletBook/legacyWalletBook.types';
+type ResolveWalletBookWalletOptionKeyParams = {
+    wallet: WalletSchema;
+    walletKey: string;
+};
+/**
+ * Resolves which wallet option (group) a wallet book entry belongs to. Used
+ * by the catalogue's wallet-book-driven transformers (URI deeplink,
+ * `inAppBrowser`, `installation`) to bucket their emitted options.
+ *
+ * Wallet book entries inconsistently use `group` / `chainGroup` /
+ * `walletGroup` for the same idea. The wallet key itself acts as the wallet
+ * option key when no group field is set.
+ *
+ * @param params.wallet - The wallet entry.
+ * @param params.walletKey - The wallet's key in `walletBook.wallets`.
+ * @returns The wallet option key.
+ * @not-instrumented
+ */
+export declare const resolveWalletBookWalletOptionKey: ({ wallet, walletKey, }: ResolveWalletBookWalletOptionKeyParams) => string;
+export {};
+//# sourceMappingURL=resolveWalletBookWalletOptionKey.d.ts.map

package/dist/modules/walletOptionsCatalogue/resolveWalletBookWalletOptionKey/resolveWalletBookWalletOptionKey.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveWalletBookWalletOptionKey.d.ts","sourceRoot":"","sources":["../../../../src/modules/walletOptionsCatalogue/resolveWalletBookWalletOptionKey/resolveWalletBookWalletOptionKey.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+CAA+C,CAAC;AAElF,KAAK,sCAAsC,GAAG;IAC5C,MAAM,EAAE,YAAY,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,gCAAgC,2BAG1C,sCAAsC,KAAG,MAC0B,CAAC"}

package/dist/modules/walletOptionsCatalogue/sortConnectionOptions/sortConnectionOptions.d.ts

@@ -0,0 +1,20 @@
+import type { WalletConnectionOption } from '../walletOptionsCatalogue.types';
+type SortConnectionOptionsParams = {
+    options: WalletConnectionOption[];
+};
+/**
+ * Sorts a wallet option's `connectionOptions` so the most preferred option lands at
+ * index 0. Primary sort is by option-type priority
+ * (`withWalletProvider` > URI deeplink > `inAppBrowser`);
+ * within a type, ties break alphabetically by `chain` for deterministic
+ * output across calls.
+ *
+ * Returns a new array — the input is not mutated.
+ *
+ * @param params.options - The options to sort.
+ * @returns A new array in priority order.
+ * @not-instrumented
+ */
+export declare const sortConnectionOptions: ({ options, }: SortConnectionOptionsParams) => WalletConnectionOption[];
+export {};
+//# sourceMappingURL=sortConnectionOptions.d.ts.map

package/dist/modules/walletOptionsCatalogue/sortConnectionOptions/sortConnectionOptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sortConnectionOptions.d.ts","sourceRoot":"","sources":["../../../../src/modules/walletOptionsCatalogue/sortConnectionOptions/sortConnectionOptions.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AAE9E,KAAK,2BAA2B,GAAG;IACjC,OAAO,EAAE,sBAAsB,EAAE,CAAC;CACnC,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,qBAAqB,iBAE/B,2BAA2B,KAAG,sBAAsB,EAWnD,CAAC"}

package/dist/modules/walletOptionsCatalogue/sortWalletOptions/sortWalletOptions.d.ts

@@ -0,0 +1,34 @@
+import type { WalletOption, WalletOptionOrdering } from '../walletOptionsCatalogue.types';
+type SortWalletOptionsParams = {
+    ordering: WalletOptionOrdering;
+    walletOptions: WalletOption[];
+};
+/**
+ * Sorts the outer wallet-option list. This is the only ordering controlled
+ * by the customer; the inner `connectionOptions` array of each wallet
+ * option is ordered separately by `sortConnectionOptions` using a fixed
+ * option-type priority.
+ *
+ * - `'relevance'` (default): bucket wallet options into three tiers, in
+ *   this order:
+ *     1. **Installed provider** — user already has the wallet available
+ *        (`withWalletProvider` at index 0).
+ *     2. **Connectable** — has at least one connection (URI deeplink
+ *        or `inAppBrowser`) but no installed provider.
+ *     3. **Install-only** — no connection at all; only `installationUrls`.
+ *   Within each tier, rank by the hand-curated {@link PRIORITY_WALLET_KEYS}
+ *   list (MetaMask, Coinbase, Phantom, …); unknown wallets fall through to
+ *   alphabetical-by-name order at the tail of their tier.
+ * - `'alphabetical'`: case-insensitive sort by wallet option `name`,
+ *   without bucketing.
+ *
+ * Returns a new array — the input is not mutated.
+ *
+ * @param params.walletOptions - The wallet options to sort.
+ * @param params.ordering - The requested ordering.
+ * @returns A new array in the requested order.
+ * @not-instrumented
+ */
+export declare const sortWalletOptions: ({ walletOptions, ordering, }: SortWalletOptionsParams) => WalletOption[];
+export {};
+//# sourceMappingURL=sortWalletOptions.d.ts.map

package/dist/modules/walletOptionsCatalogue/sortWalletOptions/sortWalletOptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sortWalletOptions.d.ts","sourceRoot":"","sources":["../../../../src/modules/walletOptionsCatalogue/sortWalletOptions/sortWalletOptions.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,YAAY,EACZ,oBAAoB,EACrB,MAAM,iCAAiC,CAAC;AAEzC,KAAK,uBAAuB,GAAG;IAC7B,QAAQ,EAAE,oBAAoB,CAAC;IAC/B,aAAa,EAAE,YAAY,EAAE,CAAC;CAC/B,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,eAAO,MAAM,iBAAiB,iCAG3B,uBAAuB,KAAG,YAAY,EA0BxC,CAAC"}

package/dist/modules/walletOptionsCatalogue/walletOptionsCatalogue.types.d.ts

@@ -0,0 +1,152 @@
+import type { Chain } from '../chain';
+/**
+ * Identifies where a registered wallet provider came from. Used as the
+ * `source` discriminator on `WithWalletProviderConnectionOption` so customer
+ * UIs can label "browser extension" vs "wallet SDK" without having to inspect
+ * the registered provider's metadata.
+ *
+ * - `selfAnnounced`: announced via an in-page self-announcement standard
+ *   (EIP-6963 on EVM, Wallet Standard on Solana / Sui / …).
+ * - `windowInjected`: legacy `window.*` injection (e.g. `window.ethereum`).
+ * - `sdk`: registered by a chain extension that wraps a vendor SDK
+ *   (Base Account via `@base-org/account`, MetaMask Connect, etc.).
+ */
+export type WithWalletProviderSource = 'selfAnnounced' | 'windowInjected' | 'sdk';
+/**
+ * A wallet that the customer can connect to directly through a registered
+ * wallet provider. The customer resolves the live provider via
+ * `getWalletProviderByKey({ key: walletProviderKey })`, then calls
+ * `.connect()` / `.signMessage()` / etc. on it.
+ *
+ * `walletProviderKey` follows the standard format produced by
+ * `formatWalletProviderKey`:
+ * `<normalizedWalletNameWithChain>:<walletProviderType>[:<suffix>]`.
+ */
+export type WithWalletProviderConnectionOption = {
+    chain: Chain;
+    source: WithWalletProviderSource;
+    type: 'withWalletProvider';
+    walletProviderKey: string;
+};
+/**
+ * A wallet reachable through a URI deeplink. Carries deeplinks only;
+ * the customer drives the connection themselves by minting the
+ * appropriate URI and appending it onto one of the deeplinks via
+ * `appendConnectionUriToDeeplink`.
+ *
+ * The `type` discriminator picks the connection driver:
+ *
+ * - `'walletConnect'`: drive via WalletConnect — mint the URI with
+ *   `connectWithWalletConnect<Chain>`.
+ * - `'metamaskSdkUri'`: drive via MetaMask's own URI connection
+ *   extension — mint the URI with `connectWithMetaMaskUriEvm` or
+ *   `connectWithMetaMaskUriSolana`. Emitted only for the MetaMask
+ *   wallet entry.
+ */
+export type UriDeeplinkConnectionOption = {
+    chain: Chain;
+    deeplinks: {
+        /** Native deeplink scheme (e.g. `trust://`). */
+        native?: string;
+        /** Universal link (e.g. `https://link.trustwallet.com`). */
+        universal?: string;
+    };
+    type: 'walletConnect' | 'metamaskSdkUri';
+};
+/**
+ * A mobile wallet that exposes an in-app browser entry URL. The URL is a
+ * template (e.g. `https://go.base.app/dapp?cb_url={{encodedDappURI}}`) — the
+ * customer substitutes `{{encodedDappURI}}` with the encoded current dapp URL
+ * before opening it.
+ */
+export type InAppBrowserConnectionOption = {
+    chain: Chain;
+    type: 'inAppBrowser';
+    url: string;
+};
+/**
+ * Install / download links for a wallet option whose product can be
+ * installed by the user on this device. Surfaced on `WalletOption` when
+ * `includeMobileOptions: true` is passed to `getWalletOptionsCatalogue`.
+ *
+ * Installation is intentionally not a `WalletConnectionOption` — the user
+ * cannot "connect" with an install link, and rendering it inline with
+ * real connection actions misleads them. Each platform's URL is optional
+ * and only present when the wallet book carries the corresponding store
+ * ID.
+ */
+export type InstallationUrls = {
+    android?: string;
+    chrome?: string;
+    edge?: string;
+    firefox?: string;
+    ios?: string;
+    native?: string;
+    opera?: string;
+    safari?: string;
+};
+/**
+ * One option for connecting to a wallet option. Each `WalletOption`
+ * carries an ordered array of these; the first element is always "the
+ * best available connection" by the priority documented on
+ * `getWalletOptionsCatalogue`.
+ */
+export type WalletConnectionOption = WithWalletProviderConnectionOption | UriDeeplinkConnectionOption | InAppBrowserConnectionOption;
+/**
+ * A wallet option surfaced by `getWalletOptionsCatalogue` — one wallet the
+ * user can sign in with (MetaMask, Coinbase, Phantom, …). A wallet option
+ * surfaces when it has at least one `connectionOption` OR a populated
+ * `installationUrls` bag — install-only wallets (no connection available
+ * but the user can install the product) are surfaced with empty
+ * `connectionOptions` so the customer UI can render the install links
+ * distinctly.
+ */
+export type WalletOption = {
+    /**
+     * Ordered connection options for this wallet. Sorted by option-type
+     * priority (`withWalletProvider` > URI deeplink > `inAppBrowser`),
+     * then by chain for stability. May be empty when only
+     * `installationUrls` are available.
+     */
+    connectionOptions: WalletConnectionOption[];
+    /** Full URL to the wallet's icon. */
+    iconUrl: string;
+    /**
+     * Install / download links for this wallet. Present when
+     * `includeMobileOptions: true` is passed to `getWalletOptionsCatalogue`
+     * and the wallet book carries at least one store ID / desktop URL for
+     * the wallet. The customer UI should render these as install actions,
+     * distinct from `connectionOptions`.
+     */
+    installationUrls?: InstallationUrls;
+    /** Stable key from the wallet book (e.g. `"metamask"`). */
+    key: string;
+    /** Display name for the wallet. */
+    name: string;
+    /** Brand color in hex (e.g. `"#f6851b"`). */
+    primaryColor?: string;
+};
+/**
+ * Controls how wallet options are ordered in the returned catalogue.
+ *
+ * - `'relevance'` (default): Dynamic's recommended order.
+ * - `'alphabetical'`: case-insensitive by wallet option `name`.
+ */
+export type WalletOptionOrdering = 'relevance' | 'alphabetical';
+/** Parameters for `getWalletOptionsCatalogue`. */
+export type GetWalletOptionsCatalogueParams = {
+    /**
+     * Defaults to `false`. When `true`, additionally includes
+     * WalletConnect, in-app-browser, and install link surfaces. Adds
+     * network latency.
+     */
+    includeMobileOptions?: boolean;
+    /** Defaults to `'relevance'`. See {@link WalletOptionOrdering}. */
+    walletOptionOrdering?: WalletOptionOrdering;
+};
+/**
+ * Return type of `getWalletOptionsCatalogue` — an ordered array of wallet
+ * options. See {@link WalletOptionOrdering} for ordering details.
+ */
+export type WalletOptionsCatalogue = WalletOption[];
+//# sourceMappingURL=walletOptionsCatalogue.types.d.ts.map

package/dist/modules/walletOptionsCatalogue/walletOptionsCatalogue.types.d.ts.map

@@ -0,0 +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;;;;;;;;;;;;;;GAcG;AACH,MAAM,MAAM,2BAA2B,GAAG;IACxC,KAAK,EAAE,KAAK,CAAC;IACb,SAAS,EAAE;QACT,gDAAgD;QAChD,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,4DAA4D;QAC5D,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,IAAI,EAAE,eAAe,GAAG,gBAAgB,CAAC;CAC1C,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,2BAA2B,GAC3B,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,kDAAkD;AAClD,MAAM,MAAM,+BAA+B,GAAG;IAC5C;;;;OAIG;IACH,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,mEAAmE;IACnE,oBAAoB,CAAC,EAAE,oBAAoB,CAAC;CAC7C,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,sBAAsB,GAAG,YAAY,EAAE,CAAC"}

package/dist/modules/wallets/connectWithWalletProvider/connectWithWalletProvider.d.ts

@@ -19,7 +19,7 @@ type ConnectWithWalletProviderParams = {
  * @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.
  * @returns A promise that resolves to the connected wallet account.
  * @throws NoAddressFoundError If the request to connect was successful but no address is connected to your app.
-  * @instrumented
+ *  @instrumented
  */
 export declare const connectWithWalletProvider: ({ walletProviderKey, addToDynamicWalletAccounts, hardwareWalletVendor, }: ConnectWithWalletProviderParams, client?: import("../../../exports").DynamicClient) => Promise<WalletAccount>;
 export {};

package/dist/modules/wallets/connectWithWalletProvider/connectWithWalletProvider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"connectWithWalletProvider.d.ts","sourceRoot":"","sources":["../../../../src/modules/wallets/connectWithWalletProvider/connectWithWalletProvider.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,wCAAwC,CAAC;AAKnF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAGtD,KAAK,+BAA+B,GAAG;IACrC,0BAA0B,CAAC,EAAE,OAAO,CAAC;IACrC,oBAAoB,CAAC,EAAE,oBAAoB,CAAC;IAC5C,iBAAiB,EAAE,MAAM,CAAC;CAC3B,CAAC;AAEF;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,yBAAyB,6EAKjC,+BAA+B,wDAEjC,OAAO,CAAC,aAAa,CAgEvB,CAAC"}
+{"version":3,"file":"connectWithWalletProvider.d.ts","sourceRoot":"","sources":["../../../../src/modules/wallets/connectWithWalletProvider/connectWithWalletProvider.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,wCAAwC,CAAC;AAKnF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAGtD,KAAK,+BAA+B,GAAG;IACrC,0BAA0B,CAAC,EAAE,OAAO,CAAC;IACrC,oBAAoB,CAAC,EAAE,oBAAoB,CAAC;IAC5C,iBAAiB,EAAE,MAAM,CAAC;CAC3B,CAAC;AAEF;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,yBAAyB,6EAKjC,+BAA+B,wDAEjC,OAAO,CAAC,aAAa,CAqDvB,CAAC"}

package/dist/modules/wallets/reconcileWalletAccountsAgainstClient/index.d.ts

@@ -0,0 +1,2 @@
+export { reconcileWalletAccountsAgainstClient } from './reconcileWalletAccountsAgainstClient';
+//# sourceMappingURL=index.d.ts.map

package/dist/modules/wallets/reconcileWalletAccountsAgainstClient/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/modules/wallets/reconcileWalletAccountsAgainstClient/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oCAAoC,EAAE,MAAM,wCAAwC,CAAC"}

package/dist/modules/wallets/reconcileWalletAccountsAgainstClient/reconcileWalletAccountsAgainstClient.d.ts

@@ -0,0 +1,25 @@
+import type { DynamicClient } from '../../../client/types';
+import type { WalletAccount } from '../walletAccount';
+type ReconcileWalletAccountsAgainstClientParams = {
+    /** Whether to write new or updated unverified accounts to client state. Defaults to `true`. */
+    addToDynamicWalletAccounts?: boolean;
+    /** Freshly-connected wallet account candidates to reconcile. */
+    walletAccounts: WalletAccount[];
+    /** Wallet provider key these candidates were connected through. */
+    walletProviderKey: string;
+};
+/**
+ * Reconciles freshly-connected wallet accounts against the client state. For
+ * each candidate it classifies as new, a re-connect of an existing unverified
+ * account, or a re-connect of an already-verified account, then runs the
+ * appropriate state mutation (`setUnverifiedWalletAccounts`,
+ * `updateWalletProviderKeysForVerifiedCredentials`, `createVisit` for truly-new
+ * entries) and emits a single `walletAccountsChanged` event if anything
+ * actually changed. Returns the candidates with `verifiedCredentialId`
+ * populated when the address already corresponded to a verified credential.
+ *
+ * @not-instrumented
+ */
+export declare const reconcileWalletAccountsAgainstClient: ({ addToDynamicWalletAccounts, walletAccounts, walletProviderKey, }: ReconcileWalletAccountsAgainstClientParams, client: DynamicClient) => WalletAccount[];
+export {};
+//# sourceMappingURL=reconcileWalletAccountsAgainstClient.d.ts.map

package/dist/modules/wallets/reconcileWalletAccountsAgainstClient/reconcileWalletAccountsAgainstClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reconcileWalletAccountsAgainstClient.d.ts","sourceRoot":"","sources":["../../../../src/modules/wallets/reconcileWalletAccountsAgainstClient/reconcileWalletAccountsAgainstClient.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAK3D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAGtD,KAAK,0CAA0C,GAAG;IAChD,+FAA+F;IAC/F,0BAA0B,CAAC,EAAE,OAAO,CAAC;IACrC,gEAAgE;IAChE,cAAc,EAAE,aAAa,EAAE,CAAC;IAChC,mEAAmE;IACnE,iBAAiB,EAAE,MAAM,CAAC;CAC3B,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,oCAAoC,uEAK5C,0CAA0C,UACrC,aAAa,KACpB,aAAa,EAmFf,CAAC"}

package/dist/modules/wallets/utils/stripChainSuffix/stripChainSuffix.d.ts

@@ -0,0 +1,20 @@
+import type { Chain } from '../../../chain';
+type StripChainSuffixParams = {
+    chain: Chain;
+    normalizedName: string;
+};
+/**
+ * Removes the lowercased chain suffix that `normalizeWalletNameWithChain`
+ * appends. Used by `findWalletOptionKeyForProviderKey` to recover the wallet
+ * book wallet key candidate from a `walletProviderKey`. If the suffix is
+ * not present (some chain extensions already bake the chain into the
+ * display name), the input is returned unchanged.
+ *
+ * @param params.chain - The chain whose suffix should be stripped.
+ * @param params.normalizedName - The normalized wallet-name-with-chain string.
+ * @returns The name with the chain suffix removed, or the input unchanged.
+ * @not-instrumented
+ */
+export declare const stripChainSuffix: ({ chain, normalizedName, }: StripChainSuffixParams) => string;
+export {};
+//# sourceMappingURL=stripChainSuffix.d.ts.map

package/dist/modules/wallets/utils/stripChainSuffix/stripChainSuffix.d.ts.map

@@ -0,0 +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"}

package/dist/modules/wallets/walletProviderRegistry/createWalletProviderRegistry/createWalletProviderRegistry.d.ts.map

@@ -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"}
+{"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"}

package/dist/modules/wallets/walletProviderRegistry/index.d.ts

@@ -1,3 +1,3 @@
 export { getWalletProviderRegistry } from './getWalletProviderRegistry';
-export { WalletProviderPriority, type WalletProviderRegistry, } from './walletProviderRegistry.types';
+export { WalletProviderPriority, type WalletProviderRegistry, type WalletProviderRegistryEntry, } from './walletProviderRegistry.types';
 //# sourceMappingURL=index.d.ts.map

package/dist/modules/wallets/walletProviderRegistry/index.d.ts.map

@@ -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"}
+{"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"}

package/dist/modules/wallets/walletProviderRegistry/walletProviderRegistry.types.d.ts

@@ -1,4 +1,15 @@
 import type { WalletProvider } from '../walletProvider/walletProvider.types';
+/**
+ * A single entry in the wallet provider registry — the registered
+ * `WalletProvider` together with the priority it was registered at. Returned
+ * by `WalletProviderRegistry.listProviderEntries` for callers that need to
+ * reason about *how* a provider was registered (e.g. classifying the source
+ * of an injected provider).
+ */
+export type WalletProviderRegistryEntry = {
+    priority: number;
+    walletProvider: WalletProvider;
+};
 export declare enum WalletProviderPriority {
     /**
      * Highest priority should be used by wallet providers that implement
@@ -27,6 +38,14 @@ export type WalletProviderRegistry = {
      * @returns The wallet provider.
      */
     getByKey: (key: string) => WalletProvider | undefined;
+    /**
+     * Retrieves all registry entries — each entry pairs a wallet provider with
+     * the priority it was registered at. Useful for callers that need to know
+     * *how* a provider was registered (e.g. classifying the source of an
+     * injected provider for the wallet options catalogue).
+     * @returns The registry entries.
+     */
+    listProviderEntries: () => WalletProviderRegistryEntry[];
     /**
      * Retrieves all wallet providers.
      * @returns The wallet providers.

package/dist/modules/wallets/walletProviderRegistry/walletProviderRegistry.types.d.ts.map

@@ -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"}
+{"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"}

package/dist/modules/wallets/walletProviderUriConnection.types.d.ts

@@ -0,0 +1,23 @@
+import type { WalletAccount } from './walletAccount';
+/**
+ * Return shape for wallet-provider connection flows that establish a
+ * pairing through an external URI (rendered as a QR code or used as a
+ * deep link). Shared by the WalletConnect and MetaMask SDK URI-based
+ * connect helpers so consumers can render a single QR / deep-link UI
+ * regardless of which protocol is in use.
+ */
+export type WalletProviderUriConnectionResult = {
+    /**
+     * Resolves to the wallet accounts created once the connection is
+     * approved on the wallet side.
+     */
+    approval: () => Promise<{
+        walletAccounts: WalletAccount[];
+    }>;
+    /**
+     * The pairing URI to hand to the wallet application — typically
+     * rendered as a QR code or used as a deep link.
+     */
+    uri: string;
+};
+//# sourceMappingURL=walletProviderUriConnection.types.d.ts.map

package/dist/modules/wallets/walletProviderUriConnection.types.d.ts.map

@@ -0,0 +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"}

package/dist/services/instrumentation/connectLoggerToInstrumentation/connectLoggerToInstrumentation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"connectLoggerToInstrumentation.d.ts","sourceRoot":"","sources":["../../../../src/services/instrumentation/connectLoggerToInstrumentation/connectLoggerToInstrumentation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,2BAA2B,CAAC;AAExD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4CAA4C,CAAC;AAElF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAEhE,KAAK,oCAAoC,GAAG;IAC1C,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACxB,eAAe,EAAE,eAAe,CAAC;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,eAAe,CAAC,gBAAgB,CAAC,CAAC;CAC1C,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,8BAA8B,6FAQxC,oCAAoC,SAsBtC,CAAC"}
+{"version":3,"file":"connectLoggerToInstrumentation.d.ts","sourceRoot":"","sources":["../../../../src/services/instrumentation/connectLoggerToInstrumentation/connectLoggerToInstrumentation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,2BAA2B,CAAC;AAExD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4CAA4C,CAAC;AAElF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAGhE,KAAK,oCAAoC,GAAG;IAC1C,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACxB,eAAe,EAAE,eAAe,CAAC;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,eAAe,CAAC,gBAAgB,CAAC,CAAC;CAC1C,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,8BAA8B,6FAQxC,oCAAoC,SA8BtC,CAAC"}

package/dist/services/instrumentation/constants.d.ts

@@ -1,4 +1,26 @@
+/**
+ * Default key-based PII scrubber list, lowercased and matched against the
+ * lowercased object key.
+ *
+ * Two complementary mechanisms cover credential leakage:
+ *
+ * 1. Explicit keys listed here — matched exactly (case-insensitive). Use this
+ *    for keys that don't end in a generic credential suffix (e.g. `mnemonic`,
+ *    `seed`, `verificationCode`, `keyShare`).
+ * 2. Suffix matching in {@link scrubParameters} for the credential suffixes
+ *    enumerated by {@link PII_KEY_SUFFIXES} — catches any field whose name
+ *    ends in `token` or `jwt` (e.g. `mfaToken`, `minifiedJwt`, `accessToken`,
+ *    `idToken`, `captchaToken`, …) without needing to enumerate them here.
+ */
 export declare const DEFAULT_PII_FIELDS: string[];
+/**
+ * Lowercased suffixes used by {@link scrubParameters} to match credential-like
+ * keys without enumerating every variant (e.g. `mfaToken`, `accessToken`,
+ * `refreshToken`, `legacyToken`, `minifiedJwt`). Only suffixes that are
+ * unambiguously credentials belong here — `key` (matches `publicKey`) and
+ * `code` (matches `countryCode`) are too broad and must not be added.
+ */
+export declare const PII_KEY_SUFFIXES: string[];
 export declare const REDACTED_VALUE = "[REDACTED]";
 export declare const MAX_STRING_LENGTH = 500;
 export declare const TRUNCATED_SUFFIX = "...[truncated]";

package/dist/services/instrumentation/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/services/instrumentation/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,kBAAkB,UAY9B,CAAC;AAEF,eAAO,MAAM,cAAc,eAAe,CAAC;AAE3C,eAAO,MAAM,iBAAiB,MAAM,CAAC;AAErC,eAAO,MAAM,gBAAgB,mBAAmB,CAAC;AAEjD;;;;GAIG;AACH,eAAO,MAAM,YAAY,WAAW,CAAC;AAErC;;;;GAIG;AACH,eAAO,MAAM,cAAc,eAAe,CAAC"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/services/instrumentation/constants.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,kBAAkB,UAqB9B,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,UAAmB,CAAC;AAEjD,eAAO,MAAM,cAAc,eAAe,CAAC;AAE3C,eAAO,MAAM,iBAAiB,MAAM,CAAC;AAErC,eAAO,MAAM,gBAAgB,mBAAmB,CAAC;AAEjD;;;;GAIG;AACH,eAAO,MAAM,YAAY,WAAW,CAAC;AAErC;;;;GAIG;AACH,eAAO,MAAM,cAAc,eAAe,CAAC"}

package/dist/services/instrumentation/scrubParameters/scrubParameters.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scrubParameters.d.ts","sourceRoot":"","sources":["../../../../src/services/instrumentation/scrubParameters/scrubParameters.ts"],"names":[],"mappings":"AAcA,KAAK,qBAAqB,GAAG;IAC3B,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC,CAAC;AA6KF,wBAAwB;AAExB,eAAO,MAAM,eAAe,qCAIzB,qBAAqB,KAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAQhD,CAAC"}
+{"version":3,"file":"scrubParameters.d.ts","sourceRoot":"","sources":["../../../../src/services/instrumentation/scrubParameters/scrubParameters.ts"],"names":[],"mappings":"AAuCA,KAAK,qBAAqB,GAAG;IAC3B,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC,CAAC;AAmLF,wBAAwB;AAExB,eAAO,MAAM,eAAe,qCAIzB,qBAAqB,KAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAQhD,CAAC"}