@dynamic-labs-sdk/client 1.2.0 → 1.3.0

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

@@ -0,0 +1,39 @@
+import type { WalletBookSchema } from '../../legacyWalletBook/legacyWalletBook.types';
+import type { WithWalletProviderDisplayOverride } from '../buildWithWalletProviderOptions/buildWithWalletProviderOptions';
+import type { InstallationUrls, WalletConnectionOption, WalletOption } from '../walletOptionsCatalogue.types';
+type BuildWalletOptionParams = {
+    connectionOptions: WalletConnectionOption[];
+    displayOverride?: WithWalletProviderDisplayOverride;
+    installationUrls?: InstallationUrls;
+    walletBook: WalletBookSchema;
+    walletOptionKey: string;
+};
+/**
+ * Assembles a `WalletOption` for a resolved wallet option key, populated
+ * with the connection options the transformers produced for it plus an
+ * optional install / download URL bag.
+ *
+ * Display merge rules (provider self-announced metadata wins where set):
+ *
+ * - `name`: `displayOverride.name` ?? wallet book group name ?? bare key.
+ * - `iconUrl`: `displayOverride.iconUrl` ?? wallet book group sprite URL ?? `''`.
+ * - `primaryColor`: wallet book group brand color only (providers do not
+ *   ship a primary color in their announcement metadata).
+ * - `installationUrls`: copied through if present.
+ *
+ * Why provider precedence: a registered wallet provider knows its own
+ * brand best (EIP-6963 / Wallet Standard / vendor SDK announcement is the
+ * wallet authoring its own identity). The wallet book fills in fields the
+ * announcement does not carry — currently only `primaryColor`.
+ *
+ * @param params.connectionOptions - The connections to attach to this wallet option.
+ * @param [params.displayOverride] - Provider-announced display info that overrides the wallet book's name and iconUrl.
+ * @param [params.installationUrls] - Install/download URL bag for this wallet.
+ * @param params.walletBook - The fetched wallet book.
+ * @param params.walletOptionKey - The wallet option key.
+ * @returns The constructed wallet option.
+ * @not-instrumented
+ */
+export declare const buildWalletOption: ({ connectionOptions, displayOverride, installationUrls, walletBook, walletOptionKey, }: BuildWalletOptionParams) => WalletOption;
+export {};
+//# sourceMappingURL=buildWalletOption.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"buildWalletOption.d.ts","sourceRoot":"","sources":["../../../../src/modules/walletOptionsCatalogue/buildWalletOption/buildWalletOption.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+CAA+C,CAAC;AACtF,OAAO,KAAK,EAAE,iCAAiC,EAAE,MAAM,kEAAkE,CAAC;AAC1H,OAAO,KAAK,EACV,gBAAgB,EAChB,sBAAsB,EACtB,YAAY,EACb,MAAM,iCAAiC,CAAC;AAEzC,KAAK,uBAAuB,GAAG;IAC7B,iBAAiB,EAAE,sBAAsB,EAAE,CAAC;IAC5C,eAAe,CAAC,EAAE,iCAAiC,CAAC;IACpD,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,UAAU,EAAE,gBAAgB,CAAC;IAC7B,eAAe,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,eAAO,MAAM,iBAAiB,2FAM3B,uBAAuB,KAAG,YAe5B,CAAC"}

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

@@ -0,0 +1,54 @@
+import type { DynamicClient } from '../../../client/types/DynamicClient';
+import type { WalletBookSchema } from '../../legacyWalletBook/legacyWalletBook.types';
+import type { WalletProviderRegistryEntry } from '../../wallets/walletProviderRegistry';
+import type { WithWalletProviderConnectionOption } from '../walletOptionsCatalogue.types';
+/**
+ * Display override sourced from a registered wallet provider's announced
+ * metadata (EIP-6963 / Wallet Standard / vendor SDK). The outer
+ * transformer applies these on top of any wallet book group entry — the
+ * provider knows its own brand best, so `name` + `iconUrl` here win
+ * over the wallet book's values when both exist.
+ */
+export type WithWalletProviderDisplayOverride = {
+    iconUrl: string;
+    name: string;
+};
+/**
+ * One `WithWalletProviderConnectionOption` paired with the wallet option
+ * key it should be bucketed under, plus the provider's self-announced
+ * display metadata. The outer transformer groups by `walletOptionKey` and
+ * uses `displayOverride` to build the wallet option shell, with provider
+ * precedence over the wallet book's display fields.
+ */
+export type WithWalletProviderOptionForWalletOption = {
+    displayOverride: WithWalletProviderDisplayOverride;
+    option: WithWalletProviderConnectionOption;
+    walletOptionKey: string;
+};
+type BuildWithWalletProviderOptionsParams = {
+    entries: WalletProviderRegistryEntry[];
+    walletBook: WalletBookSchema;
+};
+/**
+ * Converts each registered wallet provider entry into a
+ * `WithWalletProviderConnectionOption` paired with its target wallet
+ * option key and the provider's display override. Every classifiable
+ * entry surfaces in the catalogue; the outer transformer uses the
+ * carried `displayOverride` to override any wallet book branding for
+ * that key (provider self-announcement wins over book).
+ *
+ * Entries whose registration priority is not recognised by
+ * `classifyWithWalletProviderSource` are dropped from the catalogue and
+ * an error is logged so Datadog surfaces the unknown registration path —
+ * in production this should never happen, every chain extension is
+ * expected to register with one of the documented priorities.
+ *
+ * @param params.entries - Snapshot of the registry's entries.
+ * @param params.walletBook - The fetched wallet book.
+ * @param client - The Dynamic client (used for logging unclassifiable entries).
+ * @returns An array of tagged options, in input order.
+ * @not-instrumented
+ */
+export declare const buildWithWalletProviderOptions: ({ entries, walletBook }: BuildWithWalletProviderOptionsParams, client: DynamicClient) => WithWalletProviderOptionForWalletOption[];
+export {};
+//# sourceMappingURL=buildWithWalletProviderOptions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"buildWithWalletProviderOptions.d.ts","sourceRoot":"","sources":["../../../../src/modules/walletOptionsCatalogue/buildWithWalletProviderOptions/buildWithWalletProviderOptions.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qCAAqC,CAAC;AACzE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+CAA+C,CAAC;AACtF,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,sCAAsC,CAAC;AAGxF,OAAO,KAAK,EAAE,kCAAkC,EAAE,MAAM,iCAAiC,CAAC;AAE1F;;;;;;GAMG;AACH,MAAM,MAAM,iCAAiC,GAAG;IAC9C,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,MAAM,uCAAuC,GAAG;IACpD,eAAe,EAAE,iCAAiC,CAAC;IACnD,MAAM,EAAE,kCAAkC,CAAC;IAC3C,eAAe,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF,KAAK,oCAAoC,GAAG;IAC1C,OAAO,EAAE,2BAA2B,EAAE,CAAC;IACvC,UAAU,EAAE,gBAAgB,CAAC;CAC9B,CAAC;AAEF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,8BAA8B,4BAChB,oCAAoC,UACrD,aAAa,KACpB,uCAAuC,EA0CzC,CAAC"}

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

@@ -0,0 +1,31 @@
+import type { WalletProviderRegistryEntry } from '../../wallets/walletProviderRegistry';
+import type { WithWalletProviderSource } from '../walletOptionsCatalogue.types';
+type ClassifyWithWalletProviderSourceParams = {
+    entry: WalletProviderRegistryEntry;
+};
+/**
+ * Maps a registered wallet provider's registration priority to the
+ * `WithWalletProviderSource` value that should appear on its catalogue option.
+ *
+ * Priority mapping (set by each chain extension when it calls
+ * `registry.register`):
+ *
+ * - `WALLET_SDK` → `'sdk'` — branded SDKs wrapped by chain extensions
+ *   (Base Account via `@base-org/account`, MetaMask Connect, …).
+ * - `WALLET_SELF_ANNOUNCEMENT_STANDARD` → `'selfAnnounced'` — in-page
+ *   self-announcement standards (EIP-6963 on EVM, Wallet Standard on
+ *   Solana / Sui / …).
+ * - `WINDOW_INJECT` → `'windowInjected'` — legacy `window.*` injection.
+ *
+ * Returns `undefined` for providers whose registration priority does not
+ * correspond to a connectable external-wallet source — callers filter these
+ * out before emitting catalogue options.
+ *
+ * @param params.entry - The registry entry to classify.
+ * @returns The matching source, or `undefined` if this entry should not
+ *   surface a `withWalletProvider` option.
+ * @not-instrumented
+ */
+export declare const classifyWithWalletProviderSource: ({ entry, }: ClassifyWithWalletProviderSourceParams) => WithWalletProviderSource | undefined;
+export {};
+//# sourceMappingURL=classifyWithWalletProviderSource.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"classifyWithWalletProviderSource.d.ts","sourceRoot":"","sources":["../../../../src/modules/walletOptionsCatalogue/classifyWithWalletProviderSource/classifyWithWalletProviderSource.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,sCAAsC,CAAC;AACxF,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AAEhF,KAAK,sCAAsC,GAAG;IAC5C,KAAK,EAAE,2BAA2B,CAAC;CACpC,CAAC;AAGF;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,eAAO,MAAM,gCAAgC,eAE1C,sCAAsC,KACrC,wBAAwB,GACxB,SAgBH,CAAC"}

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

@@ -0,0 +1,18 @@
+import type { WalletOption } from '../walletOptionsCatalogue.types';
+type CompareByRelevanceParams = {
+    a: WalletOption;
+    b: WalletOption;
+};
+/**
+ * Compares two wallet options for relevance ordering: priority-list index
+ * first, then alphabetical-by-name as the tie-break. Suitable for passing
+ * straight to `Array.prototype.sort`.
+ *
+ * @param params.a - First wallet option.
+ * @param params.b - Second wallet option.
+ * @returns Negative when `a` ranks first, positive when `b` ranks first.
+ * @not-instrumented
+ */
+export declare const compareByRelevance: ({ a, b, }: CompareByRelevanceParams) => number;
+export {};
+//# sourceMappingURL=compareByRelevance.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"compareByRelevance.d.ts","sourceRoot":"","sources":["../../../../src/modules/walletOptionsCatalogue/compareByRelevance/compareByRelevance.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAEpE,KAAK,wBAAwB,GAAG;IAC9B,CAAC,EAAE,YAAY,CAAC;IAChB,CAAC,EAAE,YAAY,CAAC;CACjB,CAAC;AAEF;;;;;;;;;GASG;AACH,eAAO,MAAM,kBAAkB,cAG5B,wBAAwB,KAAG,MAS7B,CAAC"}

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

@@ -0,0 +1,15 @@
+/**
+ * Wallet option keys `getWalletOptionsCatalogue` drops before returning.
+ * Curated, product-level suppression.
+ *
+ * Example: Base Account SDK is the recommended entry point for
+ * Coinbase-managed users, so the legacy Coinbase Wallet entries are
+ * suppressed in favor of the SDK-backed `baseaccount` tile. Both the
+ * wallet book group key (`coinbase`) and the normalized display-name
+ * key (`coinbasewallet`) are listed so suppression holds regardless of
+ * how the resolver lands on a key.
+ *
+ * Used in: `getWalletOptionsCatalogue`.
+ */
+export declare const EXCLUDED_WALLET_OPTION_KEYS: ReadonlySet<string>;
+//# sourceMappingURL=excludedWalletOptionKeys.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"excludedWalletOptionKeys.d.ts","sourceRoot":"","sources":["../../../../src/modules/walletOptionsCatalogue/excludedWalletOptionKeys/excludedWalletOptionKeys.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,2BAA2B,EAAE,WAAW,CAAC,MAAM,CAG1D,CAAC"}

package/dist/modules/walletOptionsCatalogue/findWalletOptionKeyForProviderKey/findByNameMatch/findByNameMatch.d.ts

@@ -0,0 +1,21 @@
+import type { WalletBookSchema } from '../../../legacyWalletBook/legacyWalletBook.types';
+type FindByNameMatchParams = {
+    candidate: string;
+    walletBook: WalletBookSchema;
+};
+/**
+ * Looks for a wallet book entry whose `name` or `shortName` normalizes to
+ * the same string as `candidate`. Used as a fallback by
+ * `findWalletOptionKeyForProviderKey` for providers whose
+ * `walletProviderKey` strips down to a value that does not match any
+ * `walletBook.wallets` key directly (e.g. an extension whose display name
+ * happens to match the wallet's `shortName` instead of its book key).
+ *
+ * @param params.candidate - The lowercased, chain-suffix-stripped candidate.
+ * @param params.walletBook - The fetched wallet book.
+ * @returns The matching wallet book wallet key, or `undefined`.
+ * @not-instrumented
+ */
+export declare const findByNameMatch: ({ candidate, walletBook, }: FindByNameMatchParams) => string | undefined;
+export {};
+//# sourceMappingURL=findByNameMatch.d.ts.map

package/dist/modules/walletOptionsCatalogue/findWalletOptionKeyForProviderKey/findByNameMatch/findByNameMatch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"findByNameMatch.d.ts","sourceRoot":"","sources":["../../../../../src/modules/walletOptionsCatalogue/findWalletOptionKeyForProviderKey/findByNameMatch/findByNameMatch.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kDAAkD,CAAC;AAEzF,KAAK,qBAAqB,GAAG;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,gBAAgB,CAAC;CAC9B,CAAC;AAKF;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,eAAe,+BAGzB,qBAAqB,KAAG,MAAM,GAAG,SAWnC,CAAC"}

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

@@ -0,0 +1,44 @@
+import type { Chain } from '../../chain';
+import type { WalletBookSchema } from '../../legacyWalletBook/legacyWalletBook.types';
+import type { WalletProvider } from '../../wallets/walletProvider/walletProvider.types';
+type FindWalletOptionKeyForProviderKeyParams = {
+    chain: Chain;
+    walletBook: WalletBookSchema;
+    walletProvider: WalletProvider;
+};
+/**
+ * Resolves a registered wallet provider to the wallet option key it should
+ * be bucketed under. Always returns a key — providers with no wallet book
+ * match fall back to their self-announced `metadata.displayName`, so the
+ * catalogue surfaces them as self-described tiles instead of silently
+ * dropping them.
+ *
+ * Resolution order (each step short-circuits on first hit):
+ *
+ * 1. **Direct wallet book lookup with chain suffix** — try
+ *    `walletBook.wallets[normalizedWalletNameWithChain]` as-is. Wallet
+ *    book entries are inconsistent about whether they keep the chain
+ *    suffix (e.g. `metamaskevm`) or strip it (e.g. `metamask`), so try
+ *    the suffixed form first.
+ * 2. **Direct wallet book lookup without chain suffix** — strip the
+ *    suffix and retry.
+ * 3. **Name match heuristic with chain suffix** — scan
+ *    `walletBook.wallets` for an entry whose normalized `name` or
+ *    `shortName` equals the suffixed candidate.
+ * 4. **Name match heuristic without chain suffix** — same scan on the
+ *    stripped candidate.
+ * 5. **Display-name fallback** — derive a stable key from
+ *    `walletProvider.metadata.displayName` via
+ *    {@link normalizeWalletDisplayName}. Multi-chain registrations of the
+ *    same self-described wallet (e.g. Phantom on EVM and Solana) collapse
+ *    onto the same tile because each announces the same display name.
+ *
+ * @param params.chain - The provider's chain (used to strip the suffix).
+ * @param params.walletBook - The fetched wallet book.
+ * @param params.walletProvider - The registered wallet provider.
+ * @returns The wallet option key for this provider.
+ * @not-instrumented
+ */
+export declare const findWalletOptionKeyForProviderKey: ({ chain, walletBook, walletProvider, }: FindWalletOptionKeyForProviderKeyParams) => string;
+export {};
+//# sourceMappingURL=findWalletOptionKeyForProviderKey.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"findWalletOptionKeyForProviderKey.d.ts","sourceRoot":"","sources":["../../../../src/modules/walletOptionsCatalogue/findWalletOptionKeyForProviderKey/findWalletOptionKeyForProviderKey.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+CAA+C,CAAC;AAGtF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mDAAmD,CAAC;AAKxF,KAAK,uCAAuC,GAAG;IAC7C,KAAK,EAAE,KAAK,CAAC;IACb,UAAU,EAAE,gBAAgB,CAAC;IAC7B,cAAc,EAAE,cAAc,CAAC;CAChC,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,eAAO,MAAM,iCAAiC,2CAI3C,uCAAuC,KAAG,MAoC5C,CAAC"}

package/dist/modules/walletOptionsCatalogue/findWalletOptionKeyForProviderKey/resolveWalletOptionKey/resolveWalletOptionKey.d.ts

@@ -0,0 +1,20 @@
+import type { WalletBookSchema } from '../../../legacyWalletBook/legacyWalletBook.types';
+type ResolveWalletOptionKeyParams = {
+    fallback: string;
+    wallet: WalletBookSchema['wallets'][string];
+};
+/**
+ * Picks the wallet option (group) key for a wallet book wallet. The wallet
+ * book carries the group association under a few different field names
+ * (`group`, `chainGroup`, `walletGroup`) depending on the wallet's
+ * provenance — this helper centralises the lookup. When none of those
+ * fields are set, the wallet key itself acts as its own wallet option key.
+ *
+ * @param params.fallback - Wallet key to return if no group field is set.
+ * @param params.wallet - The wallet book wallet entry.
+ * @returns The resolved wallet option key.
+ * @not-instrumented
+ */
+export declare const resolveWalletOptionKey: ({ fallback, wallet, }: ResolveWalletOptionKeyParams) => string;
+export {};
+//# sourceMappingURL=resolveWalletOptionKey.d.ts.map

package/dist/modules/walletOptionsCatalogue/findWalletOptionKeyForProviderKey/resolveWalletOptionKey/resolveWalletOptionKey.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveWalletOptionKey.d.ts","sourceRoot":"","sources":["../../../../../src/modules/walletOptionsCatalogue/findWalletOptionKeyForProviderKey/resolveWalletOptionKey/resolveWalletOptionKey.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kDAAkD,CAAC;AAEzF,KAAK,4BAA4B,GAAG;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,gBAAgB,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC;CAC7C,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,sBAAsB,0BAGhC,4BAA4B,KAAG,MACmC,CAAC"}

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

@@ -0,0 +1,15 @@
+import type { WalletConnectionOption } from '../walletOptionsCatalogue.types';
+type GetConnectionOptionPriorityParams = {
+    option: WalletConnectionOption;
+};
+/**
+ * Returns the numeric priority of a `WalletConnectionOption` for sorting.
+ * Lower numbers rank first.
+ *
+ * @param params.option - The connection option to inspect.
+ * @returns The numeric priority — lower is better.
+ * @not-instrumented
+ */
+export declare const getConnectionOptionPriority: ({ option, }: GetConnectionOptionPriorityParams) => number;
+export {};
+//# sourceMappingURL=getConnectionOptionPriority.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"getConnectionOptionPriority.d.ts","sourceRoot":"","sources":["../../../../src/modules/walletOptionsCatalogue/getConnectionOptionPriority/getConnectionOptionPriority.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AAiB9E,KAAK,iCAAiC,GAAG;IACvC,MAAM,EAAE,sBAAsB,CAAC;CAChC,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,2BAA2B,gBAErC,iCAAiC,KAAG,MACE,CAAC"}

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

@@ -0,0 +1,16 @@
+import type { WalletOption } from '../walletOptionsCatalogue.types';
+type GetPriorityIndexParams = {
+    walletOption: WalletOption;
+};
+/**
+ * Returns the index of a wallet option in `PRIORITY_WALLET_KEYS`, or
+ * `Number.POSITIVE_INFINITY` when the wallet is not in the hand-curated
+ * priority list. Lower index = higher priority.
+ *
+ * @param params.walletOption - The wallet option to inspect.
+ * @returns Numeric priority index — lower is better.
+ * @not-instrumented
+ */
+export declare const getPriorityIndex: ({ walletOption, }: GetPriorityIndexParams) => number;
+export {};
+//# sourceMappingURL=getPriorityIndex.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"getPriorityIndex.d.ts","sourceRoot":"","sources":["../../../../src/modules/walletOptionsCatalogue/getPriorityIndex/getPriorityIndex.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAEpE,KAAK,sBAAsB,GAAG;IAC5B,YAAY,EAAE,YAAY,CAAC;CAC5B,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,gBAAgB,sBAE1B,sBAAsB,KAAG,MAI3B,CAAC"}

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

@@ -0,0 +1,24 @@
+import type { GetWalletOptionsCatalogueParams, WalletOptionsCatalogue } from '../walletOptionsCatalogue.types';
+/**
+ * Returns a catalogue of the external wallet options a user can sign in
+ * with through this client. Each wallet option carries an ordered
+ * `connectionOptions` array — `withWalletProvider` (direct), `walletConnect`
+ * (deeplink/QR), or `inAppBrowser` (mobile webview). Wallet options without
+ * any matching connections are omitted.
+ *
+ * `includeWithWalletProvider` defaults to `true`; all other inclusion flags
+ * are opt-in. `walletOptionOrdering` defaults to `'relevance'` (Dynamic's
+ * recommended order); pass `'alphabetical'` to sort by wallet option name
+ * within each option-priority tier.
+ *
+ * The wallet book is fetched only when an enabled flag needs it
+ * (`includeWalletConnect`, `includeInAppBrowser`). Calls that only need
+ * `includeWithWalletProvider` skip the fetch entirely.
+ *
+ * @param [params] - Inclusion flags + ordering preference.
+ * @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.
+ * @returns A promise that resolves to the wallet options catalogue.
+ * @not-instrumented
+ */
+export declare const getWalletOptionsCatalogue: (params?: GetWalletOptionsCatalogueParams, client?: import("../../../exports").DynamicClient) => Promise<WalletOptionsCatalogue>;
+//# sourceMappingURL=getWalletOptionsCatalogue.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"getWalletOptionsCatalogue.d.ts","sourceRoot":"","sources":["../../../../src/modules/walletOptionsCatalogue/getWalletOptionsCatalogue/getWalletOptionsCatalogue.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EACV,+BAA+B,EAG/B,sBAAsB,EACvB,MAAM,iCAAiC,CAAC;AAIzC;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,yBAAyB,YAC5B,+BAA+B,wDAEtC,OAAO,CAAC,sBAAsB,CA8EhC,CAAC"}

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

@@ -0,0 +1,49 @@
+import type { WithWalletProviderDisplayOverride } from '../buildWithWalletProviderOptions/buildWithWalletProviderOptions';
+import type { WalletConnectionOption } from '../walletOptionsCatalogue.types';
+/**
+ * A `connectionOption` tagged with the wallet option key it belongs under.
+ * Transformer outputs produce these; the catalogue groups them by
+ * `walletOptionKey` before building wallet option shells.
+ *
+ * `displayOverride` is set only by the `withWalletProvider` transformer,
+ * carrying the provider's self-announced `name` + `iconUrl`. The shell
+ * builder applies it on top of any wallet book entry — provider
+ * metadata wins over book branding.
+ */
+export type ConnectionOptionForWalletOption = {
+    displayOverride?: WithWalletProviderDisplayOverride;
+    option: WalletConnectionOption;
+    walletOptionKey: string;
+};
+/**
+ * Bucket of grouped options for a single wallet option key, plus the
+ * first-seen display override (if any). Returned by
+ * `groupOptionsByWalletOption` for the catalogue to feed into the shell
+ * builder.
+ */
+export type GroupedWalletOption = {
+    connectionOptions: WalletConnectionOption[];
+    displayOverride?: WithWalletProviderDisplayOverride;
+};
+type GroupOptionsByWalletOptionParams = {
+    options: ConnectionOptionForWalletOption[];
+};
+/**
+ * Buckets tagged connection options by their wallet option key. Preserves
+ * first-seen order so that the caller's choice of
+ * `walletOptionOrdering: 'relevance'` naturally inherits the upstream input
+ * order (wallet book order for walletConnect/inAppBrowser/installation,
+ * registry order for withWalletProvider).
+ *
+ * Carries through the first-seen `displayOverride` per wallet option
+ * key, so the shell builder can apply provider-announced metadata on
+ * top of any wallet book entry.
+ *
+ * @param params.options - The tagged options to group.
+ * @returns A map from wallet option key to its grouped option bucket,
+ *   iterable in first-seen order.
+ * @not-instrumented
+ */
+export declare const groupOptionsByWalletOption: ({ options, }: GroupOptionsByWalletOptionParams) => Map<string, GroupedWalletOption>;
+export {};
+//# sourceMappingURL=groupOptionsByWalletOption.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"groupOptionsByWalletOption.d.ts","sourceRoot":"","sources":["../../../../src/modules/walletOptionsCatalogue/groupOptionsByWalletOption/groupOptionsByWalletOption.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iCAAiC,EAAE,MAAM,kEAAkE,CAAC;AAC1H,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AAE9E;;;;;;;;;GASG;AACH,MAAM,MAAM,+BAA+B,GAAG;IAC5C,eAAe,CAAC,EAAE,iCAAiC,CAAC;IACpD,MAAM,EAAE,sBAAsB,CAAC;IAC/B,eAAe,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAChC,iBAAiB,EAAE,sBAAsB,EAAE,CAAC;IAC5C,eAAe,CAAC,EAAE,iCAAiC,CAAC;CACrD,CAAC;AAEF,KAAK,gCAAgC,GAAG;IACtC,OAAO,EAAE,+BAA+B,EAAE,CAAC;CAC5C,CAAC;AAEF;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,0BAA0B,iBAEpC,gCAAgC,KAAG,GAAG,CAAC,MAAM,EAAE,mBAAmB,CAoBpE,CAAC"}

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

@@ -0,0 +1,18 @@
+import type { WalletOption } from '../walletOptionsCatalogue.types';
+type HasAnyConnectionOptionParams = {
+    walletOption: WalletOption;
+};
+/**
+ * True when the wallet option has at least one connection — i.e. the user
+ * can sign in right now. Install-only wallet options surface in the
+ * catalogue too (they carry `installationUrls`) but have an empty
+ * `connectionOptions` array; this predicate distinguishes them from
+ * actually connectable wallets in the relevance sort.
+ *
+ * @param params.walletOption - The wallet option to inspect.
+ * @returns True when `connectionOptions` is non-empty.
+ * @not-instrumented
+ */
+export declare const hasAnyConnectionOption: ({ walletOption, }: HasAnyConnectionOptionParams) => boolean;
+export {};
+//# sourceMappingURL=hasAnyConnectionOption.d.ts.map

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 (`walletConnect`,
+ * `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` > `walletConnect` > `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 (`walletConnect`
+ *        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"}