@reclack/walletkit 0.0.0-stage → 0.1.0

package/dist/intent.d.ts

@@ -0,0 +1,60 @@
+import type { Asset, Balance } from './balance.js';
+import type { ChainFamily, Eip1193Provider } from './types.js';
+/**
+ * What the caller wants out of connecting a wallet.
+ *
+ * A list rather than a mode, because these are not alternatives: a page may
+ * want an address and a balance from one connection, and a later one will
+ * want an authorization signed in the same breath. Each member says what the
+ * result must carry, and the picker itself is identical for all of them.
+ *
+ * `address` is the by-product of connecting at all, so it is always obtained;
+ * asking for it only says the caller wants it handed back.
+ *
+ * `balance` needs an asset to be a balance of. Asking for it without one is a
+ * programming error, not a runtime condition.
+ *
+ * `authorize` is the embedded checkout's signing step. Reserved here so the
+ * shape does not have to change when it arrives.
+ */
+export type Intent = 'address' | 'balance' | 'authorize';
+export interface ConnectRequest {
+    intent: Intent[];
+    /**
+     * Which family of wallets to offer. Omitted means both, which is right
+     * for a checkout that settles on either and wrong for a form whose
+     * address has to be one format.
+     */
+    family?: ChainFamily;
+    /**
+     * The EVM chain the wallet must end up on.
+     *
+     * Enforced only when given. A page collecting an address should leave it
+     * out: the same address receives on every EVM chain, and asking somebody
+     * to switch networks in their wallet to read an address back is theatre.
+     */
+    chainId?: number;
+    /** What to read a balance of. Required when `intent` includes 'balance'. */
+    assets?: Asset[];
+    /**
+     * Hold the connection open after the result is handed back, following
+     * account and chain changes.
+     *
+     * True for a checkout, which signs later. False for a form, which wanted
+     * a value and is done.
+     */
+    keepAlive?: boolean;
+}
+export interface ConnectResult {
+    walletId: string;
+    name: string;
+    icon?: string;
+    family: ChainFamily;
+    address: string;
+    /** The chain the wallet was on. EVM only; Solana has nothing to be on. */
+    chainId?: number;
+    /** Present when 'balance' was asked for, in the order the assets were given. */
+    balances?: Balance[];
+    /** Present only when `keepAlive` was set. */
+    provider?: Eip1193Provider;
+}

package/dist/intent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"intent.d.ts","sourceRoot":"","sources":["../src/intent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAClD,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAE9D;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,MAAM,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,WAAW,CAAA;AAExD,MAAM,WAAW,cAAc;IAC9B,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB;;;;OAIG;IACH,MAAM,CAAC,EAAE,WAAW,CAAA;IACpB;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,4EAA4E;IAC5E,MAAM,CAAC,EAAE,KAAK,EAAE,CAAA;IAChB;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,OAAO,CAAA;CACnB;AAED,MAAM,WAAW,aAAa;IAC7B,QAAQ,EAAE,MAAM,CAAA;IAChB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,WAAW,CAAA;IACnB,OAAO,EAAE,MAAM,CAAA;IACf,0EAA0E;IAC1E,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,gFAAgF;IAChF,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAA;IACpB,6CAA6C;IAC7C,QAAQ,CAAC,EAAE,eAAe,CAAA;CAC1B"}

package/dist/intent.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=intent.js.map

package/dist/intent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"intent.js","sourceRoot":"","sources":["../src/intent.ts"],"names":[],"mappings":""}

package/dist/kit.d.ts

@@ -0,0 +1,124 @@
+import { type Asset, type Balance } from './balance.js';
+import type { WalletEntry } from './catalog.js';
+import { type ColorScheme, type WalletKitTheme } from './theme.js';
+import type { ConnectRequest, ConnectResult } from './intent.js';
+import type { ChainFamily, ConnectedEvmWallet, ConnectedSvmWallet, DetectedEvmWallet, DetectedSvmWallet } from './types.js';
+import { type WalletConnectOptions } from './walletconnect.js';
+export interface EvmState {
+    available: DetectedEvmWallet[];
+    connected?: ConnectedEvmWallet;
+    connecting: boolean;
+    switchingChain: boolean;
+    error: string;
+}
+export interface SvmState {
+    available: DetectedSvmWallet[];
+    connected?: ConnectedSvmWallet;
+    connecting: boolean;
+    error: string;
+}
+export interface WalletKitState {
+    catalog: WalletEntry[];
+    /** False until the catalogue has been asked for and answered, or failed. */
+    catalogLoaded: boolean;
+    handheld: boolean;
+    /** Where the wallet artwork is served from. */
+    assetBase: string;
+    /**
+     * The theme as the host set it, not as it resolved.
+     *
+     * Carried so a picker that was given no theme of its own can wear the
+     * one the page is wearing. A branded checkout sets it once, on the kit,
+     * and every picker on the page follows.
+     */
+    theme?: WalletKitTheme;
+    /** What the theme's mode resolved to, following the system when it says so. */
+    scheme: ColorScheme;
+    /** The theme as custom properties, ready to set on an element. */
+    variables: Record<string, string>;
+    evm: EvmState;
+    svm: SvmState;
+}
+/**
+ * Every option is an override, and a kit created with none of them works.
+ *
+ * What the kit needs to run is Reclack's own infrastructure, so it ships with
+ * it rather than asking each host to supply what it could not know. See
+ * config.ts. These exist for a sandbox, a private endpoint, or a partner
+ * running the kit under its own name.
+ */
+export interface WalletKitOptions {
+    /** A different Reclack to talk to, such as a sandbox. */
+    apiUrl?: string;
+    /**
+     * The catalogue outright, skipping the round trip. What a host that
+     * renders on a server passes, having already fetched it there.
+     */
+    catalog?: WalletEntry[];
+    /** A different relay project, or different metadata on the approval screen. */
+    walletConnect?: WalletConnectOptions;
+    /**
+     * Where the host serves this package's `assets/` directory from.
+     *
+     * Served by the host rather than fetched from ours, so a page taking a
+     * payment still makes no third-party image request. A wallet's own
+     * EIP-6963 icon wins over these anyway, so getting it wrong costs the
+     * artwork of wallets that are not installed, not the ability to pay.
+     */
+    assetBase?: string;
+    /**
+     * Colours, corner radius, type and light or dark.
+     *
+     * Held here rather than passed to a renderer so that the resolved mode is
+     * part of the state every framework is already subscribed to: when the
+     * reader's system flips to dark, the picker follows without the host
+     * wiring up a second listener.
+     */
+    theme?: WalletKitTheme;
+    /**
+     * Read endpoints per EVM chain id, and one for Solana, for balances.
+     *
+     * The pinned public endpoints are used for any chain not named here.
+     * Worth overriding for anything heavier than a balance or two: they are
+     * shared and rate-limited.
+     */
+    rpcUrls?: Record<number, string>;
+    svmRpcUrl?: string;
+}
+export interface WalletKit {
+    getState(): WalletKitState;
+    /** Calls back on every change. Returns the unsubscribe. */
+    subscribe(listener: () => void): () => void;
+    connectEvm(wallet: DetectedEvmWallet): Promise<void>;
+    connectSvm(wallet: DetectedSvmWallet): Promise<void>;
+    /** Pairs with a wallet that injects nothing. `onUri` fires before approval. */
+    connectRemote(wallet: {
+        id: string;
+        name: string;
+    }, chainId: number, onUri: (uri: string) => void): Promise<void>;
+    disconnect(family?: ChainFamily): void;
+    ensureChain(chainId: number): Promise<boolean>;
+    /** Changes the theme after the fact, such as when a merchant's branding lands. */
+    setTheme(theme: WalletKitTheme | undefined): void;
+    /** Whether this kit can offer WalletConnect at all. */
+    canPairRemotely(): boolean;
+    /** Reads balances for an already-connected wallet. */
+    readBalances(family: ChainFamily, assets: Asset[]): Promise<Balance[]>;
+    /** Shapes a connected wallet into what a caller's intent asked for. */
+    resolveIntent(family: ChainFamily, request: ConnectRequest): Promise<ConnectResult>;
+    destroy(): void;
+}
+/**
+ * Everything a page needs to connect a wallet, with nothing on screen.
+ *
+ * A store with `getState` and `subscribe` rather than a hook, because this
+ * package renders nothing and belongs to no framework. That pair is the one
+ * shape every framework can consume: React reads it with useSyncExternalStore,
+ * Vue with a shallowRef, Svelte with a store contract, and plain JavaScript by
+ * calling it. A hook would have picked React for everybody.
+ *
+ * Nothing touches the window until the first subscriber arrives, so importing
+ * this on a server is safe and a host that renders on one does not have to
+ * guard every call site.
+ */
+export declare function createWalletKit(options?: WalletKitOptions): WalletKit;

package/dist/kit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kit.d.ts","sourceRoot":"","sources":["../src/kit.ts"],"names":[],"mappings":"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"}

package/dist/kit.js

@@ -0,0 +1,362 @@
+import { readEvmBalance, readSvmBalance } from './balance.js';
+import { fetchWalletCatalog, walletCatalogUrl } from './catalog-fetch.js';
+import { DEFAULT_API_URL, DEFAULT_SVM_RPC_URL, DEFAULT_WALLETCONNECT_PROJECT_ID, defaultRpcUrl, } from './config.js';
+import { subscribeHandheld } from './device.js';
+import { DEFAULT_LOGO_BASE } from './icons.js';
+import { resolveScheme, subscribeScheme, themeVariables, } from './theme.js';
+import { connectEvmWallet, discoverEvmWallets, switchEvmChain, } from './evm.js';
+import { walletErrorMessage } from './errors.js';
+import { connectSvmWallet, disconnectSvmWallet, discoverSvmWallets } from './svm.js';
+import { openWalletConnectSession, walletConnectReady, } from './walletconnect.js';
+/**
+ * Everything a page needs to connect a wallet, with nothing on screen.
+ *
+ * A store with `getState` and `subscribe` rather than a hook, because this
+ * package renders nothing and belongs to no framework. That pair is the one
+ * shape every framework can consume: React reads it with useSyncExternalStore,
+ * Vue with a shallowRef, Svelte with a store contract, and plain JavaScript by
+ * calling it. A hook would have picked React for everybody.
+ *
+ * Nothing touches the window until the first subscriber arrives, so importing
+ * this on a server is safe and a host that renders on one does not have to
+ * guard every call site.
+ */
+export function createWalletKit(options = {}) {
+    const initialScheme = resolveScheme(options.theme?.mode);
+    let state = {
+        catalog: options.catalog ?? [],
+        catalogLoaded: Boolean(options.catalog),
+        handheld: false,
+        assetBase: options.assetBase ?? DEFAULT_LOGO_BASE,
+        // Resolved up front rather than deferred to the first subscriber. An
+        // explicit mode needs no window to resolve, and a kit read before
+        // anything subscribes, which is every server render, would otherwise
+        // report light while the host had asked for dark. `system` still
+        // falls back to light where there is no window to ask.
+        theme: options.theme,
+        scheme: initialScheme,
+        variables: themeVariables(options.theme, initialScheme),
+        evm: {
+            available: [],
+            connecting: false,
+            switchingChain: false,
+            error: '',
+        },
+        svm: { available: [], connecting: false, error: '' },
+    };
+    const listeners = new Set();
+    const cleanups = [];
+    let theme = options.theme;
+    let stopScheme;
+    let started = false;
+    let destroyed = false;
+    // How to end a WalletConnect session, when the connection is one.
+    let closeRemote;
+    // One object replaced wholesale rather than mutated. Callers compare the
+    // reference to decide whether to re-render, and a mutated object is the
+    // same reference, so the render never happens.
+    function set(patch) {
+        if (destroyed) {
+            return;
+        }
+        state = { ...state, ...patch };
+        for (const listener of listeners) {
+            listener();
+        }
+    }
+    function setEvm(patch) {
+        set({ evm: { ...state.evm, ...patch } });
+    }
+    function setSvm(patch) {
+        set({ svm: { ...state.svm, ...patch } });
+    }
+    /**
+     * Begins discovery, once, when somebody is listening.
+     *
+     * Discovery is re-run when the catalogue lands: a wallet that announces
+     * itself is found without it, but one that only injects a global is found
+     * by a rule the catalogue carries, so the list is incomplete until then.
+     */
+    function start() {
+        if (started || typeof window === 'undefined') {
+            return;
+        }
+        started = true;
+        cleanups.push(subscribeHandheld((handheld) => set({ handheld })));
+        watchScheme();
+        restartDiscovery();
+        if (!state.catalogLoaded) {
+            const url = walletCatalogUrl(options.apiUrl ?? DEFAULT_API_URL);
+            void fetchWalletCatalog(url).then((catalog) => {
+                if (destroyed) {
+                    return;
+                }
+                set({ catalog, catalogLoaded: true });
+                restartDiscovery();
+            });
+        }
+    }
+    function watchScheme() {
+        stopScheme?.();
+        stopScheme = subscribeScheme(theme?.mode, (scheme) => {
+            set({ theme, scheme, variables: themeVariables(theme, scheme) });
+        });
+    }
+    let stopDiscovery = [];
+    function restartDiscovery() {
+        for (const stop of stopDiscovery) {
+            stop();
+        }
+        stopDiscovery = [
+            discoverEvmWallets(state.catalog, (available) => setEvm({ available })),
+            discoverSvmWallets(state.catalog, (available) => setSvm({ available })),
+        ];
+    }
+    // The payer can switch account or network in the wallet at any time, and
+    // the page has to follow: showing one address while asking somebody to
+    // sign from another is how money goes to the wrong place.
+    let unwatch;
+    function watchEvm(connected) {
+        unwatch?.();
+        unwatch = undefined;
+        const provider = connected?.provider;
+        if (!provider?.on || !provider.removeListener) {
+            return;
+        }
+        const onAccounts = (...args) => {
+            const accounts = args[0];
+            const next = Array.isArray(accounts) ? accounts[0] : undefined;
+            if (typeof next !== 'string') {
+                setEvm({ connected: undefined });
+                return;
+            }
+            setEvm({
+                connected: state.evm.connected
+                    ? { ...state.evm.connected, address: next }
+                    : undefined,
+            });
+        };
+        const onChain = (...args) => {
+            const raw = args[0];
+            const chainId = typeof raw === 'string' ? Number.parseInt(raw, 16) : Number(raw);
+            setEvm({
+                connected: state.evm.connected
+                    ? { ...state.evm.connected, chainId }
+                    : undefined,
+            });
+        };
+        provider.on('accountsChanged', onAccounts);
+        provider.on('chainChanged', onChain);
+        unwatch = () => {
+            provider.removeListener?.('accountsChanged', onAccounts);
+            provider.removeListener?.('chainChanged', onChain);
+        };
+    }
+    /** The host's endpoint for a chain, or the pinned public one. */
+    function rpcFor(chainId) {
+        return options.rpcUrls?.[chainId] ?? defaultRpcUrl(chainId);
+    }
+    function walletConnectOptions() {
+        return (options.walletConnect
+            ?? { projectId: DEFAULT_WALLETCONNECT_PROJECT_ID });
+    }
+    const kit = {
+        getState: () => state,
+        subscribe(listener) {
+            listeners.add(listener);
+            start();
+            return () => {
+                listeners.delete(listener);
+            };
+        },
+        async connectEvm(wallet) {
+            setEvm({ connecting: true, error: '' });
+            try {
+                const connected = await connectEvmWallet(wallet);
+                setEvm({ connected });
+                watchEvm(connected);
+            }
+            catch (error) {
+                setEvm({
+                    error: walletErrorMessage(error, 'Could not connect to your wallet.'),
+                });
+            }
+            finally {
+                setEvm({ connecting: false });
+            }
+        },
+        async connectSvm(wallet) {
+            setSvm({ connecting: true, error: '' });
+            try {
+                const { address, account } = await connectSvmWallet(wallet);
+                setSvm({
+                    connected: {
+                        walletId: wallet.id,
+                        name: wallet.name,
+                        icon: wallet.icon,
+                        address,
+                        account,
+                        standard: wallet.standard,
+                        provider: wallet.provider,
+                    },
+                });
+            }
+            catch (error) {
+                setSvm({
+                    error: walletErrorMessage(error, 'Could not connect to your wallet.'),
+                });
+            }
+            finally {
+                setSvm({ connecting: false });
+            }
+        },
+        async connectRemote(wallet, chainId, onUri) {
+            setEvm({ connecting: true, error: '' });
+            try {
+                const session = await openWalletConnectSession(walletConnectOptions(), chainId, onUri);
+                closeRemote = session.close;
+                const connected = {
+                    walletId: wallet.id,
+                    name: wallet.name,
+                    address: session.address,
+                    chainId: session.chainId,
+                    provider: session.provider,
+                };
+                setEvm({ connected });
+                watchEvm(connected);
+            }
+            catch (error) {
+                setEvm({
+                    error: walletErrorMessage(error, 'Could not connect to your wallet.'),
+                });
+            }
+            finally {
+                setEvm({ connecting: false });
+            }
+        },
+        disconnect(family) {
+            if (family !== 'svm') {
+                // A page cannot revoke an extension's permission; that only
+                // clears this side. A WalletConnect session is ours to end,
+                // though, and leaving it open would have the wallet showing
+                // this page as connected long after everyone has gone.
+                void closeRemote?.();
+                closeRemote = undefined;
+                unwatch?.();
+                unwatch = undefined;
+                setEvm({ connected: undefined, error: '' });
+            }
+            if (family !== 'evm') {
+                // Asked of the wallet as well, unlike the EVM side, because
+                // Solana wallets do expose it. Best effort: this side has let
+                // go either way.
+                if (state.svm.connected) {
+                    void disconnectSvmWallet(state.svm.connected).catch(() => undefined);
+                }
+                setSvm({ connected: undefined, error: '' });
+            }
+        },
+        async ensureChain(chainId) {
+            const connected = state.evm.connected;
+            if (!connected) {
+                return false;
+            }
+            if (connected.chainId === chainId) {
+                return true;
+            }
+            setEvm({ error: '', switchingChain: true });
+            try {
+                // May prompt twice: once to add the network, once to select
+                // it, so the caller stays pending throughout.
+                await switchEvmChain(connected.provider, chainId);
+                return true;
+            }
+            catch (error) {
+                setEvm({ error: walletErrorMessage(error, 'Could not switch network.') });
+                return false;
+            }
+            finally {
+                setEvm({ switchingChain: false });
+            }
+        },
+        setTheme(next) {
+            theme = next;
+            if (started) {
+                // Re-subscribed rather than recomputed: the mode may have
+                // moved to or from `system`, which changes whether the
+                // reader's own setting is being followed at all.
+                watchScheme();
+                return;
+            }
+            // Nobody is listening yet, so there is nothing to follow; the
+            // mode still has to be resolved again, because it may have
+            // changed.
+            const scheme = resolveScheme(theme?.mode);
+            set({ theme, scheme, variables: themeVariables(theme, scheme) });
+        },
+        canPairRemotely: () => walletConnectReady(walletConnectOptions()),
+        async readBalances(family, assets) {
+            const connected = family === 'evm' ? state.evm.connected : state.svm.connected;
+            if (!connected) {
+                throw new Error('No wallet is connected.');
+            }
+            return Promise.all(assets.map(async (asset) => {
+                if (asset.family === 'svm') {
+                    return readSvmBalance(options.svmRpcUrl ?? DEFAULT_SVM_RPC_URL, asset, connected.address);
+                }
+                // The endpoint when there is one, so reading a balance
+                // never drags a wallet onto another network. The wallet's
+                // own provider otherwise, which is the pre-flight case and
+                // does require it to be on that chain already.
+                const url = rpcFor(asset.chainId);
+                const source = url
+                    ? { rpcUrl: url }
+                    : { provider: connected.provider };
+                return readEvmBalance(source, asset, connected.address);
+            }));
+        },
+        async resolveIntent(family, request) {
+            // The request is checked before the connection, because an
+            // intent that asks for a balance of nothing is a mistake in the
+            // caller rather than a state somebody can get out of by
+            // connecting a wallet, and it should fail the same way either
+            // way.
+            if (request.intent.includes('balance') && !request.assets?.length) {
+                throw new Error("intent 'balance' needs at least one asset.");
+            }
+            const connected = family === 'evm' ? state.evm.connected : state.svm.connected;
+            if (!connected) {
+                throw new Error('No wallet is connected.');
+            }
+            const evm = family === 'evm' ? connected : undefined;
+            const result = {
+                walletId: connected.walletId,
+                name: connected.name,
+                icon: connected.icon,
+                family,
+                address: connected.address,
+                chainId: evm?.chainId,
+            };
+            if (request.intent.includes('balance')) {
+                result.balances = await kit.readBalances(family, request.assets ?? []);
+            }
+            if (request.keepAlive && evm) {
+                result.provider = evm.provider;
+            }
+            return result;
+        },
+        destroy() {
+            destroyed = true;
+            for (const stop of [...stopDiscovery, ...cleanups]) {
+                stop();
+            }
+            stopDiscovery = [];
+            stopScheme?.();
+            unwatch?.();
+            void closeRemote?.();
+            listeners.clear();
+        },
+    };
+    return kit;
+}
+//# sourceMappingURL=kit.js.map

package/dist/kit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"kit.js","sourceRoot":"","sources":["../src/kit.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,cAAc,EAA4B,MAAM,cAAc,CAAA;AACvF,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AACzE,OAAO,EACN,eAAe,EACf,mBAAmB,EACnB,gCAAgC,EAChC,aAAa,GACb,MAAM,aAAa,CAAA;AAEpB,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;AAC/C,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA;AAC9C,OAAO,EACN,aAAa,EACb,eAAe,EACf,cAAc,GAGd,MAAM,YAAY,CAAA;AACnB,OAAO,EACN,gBAAgB,EAChB,kBAAkB,EAClB,cAAc,GACd,MAAM,UAAU,CAAA;AACjB,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAChD,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAA;AASpF,OAAO,EACN,wBAAwB,EACxB,kBAAkB,GAElB,MAAM,oBAAoB,CAAA;AAgH3B;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,eAAe,CAAE,UAA4B,EAAE;IAC9D,MAAM,aAAa,GAAG,aAAa,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,CAAA;IAExD,IAAI,KAAK,GAAmB;QAC3B,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,EAAE;QAC9B,aAAa,EAAE,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC;QACvC,QAAQ,EAAE,KAAK;QACf,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,iBAAiB;QACjD,qEAAqE;QACrE,kEAAkE;QAClE,qEAAqE;QACrE,iEAAiE;QACjE,uDAAuD;QACvD,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,MAAM,EAAE,aAAa;QACrB,SAAS,EAAE,cAAc,CAAC,OAAO,CAAC,KAAK,EAAE,aAAa,CAAC;QACvD,GAAG,EAAE;YACJ,SAAS,EAAE,EAAE;YACb,UAAU,EAAE,KAAK;YACjB,cAAc,EAAE,KAAK;YACrB,KAAK,EAAE,EAAE;SACT;QACD,GAAG,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE;KACpD,CAAA;IAED,MAAM,SAAS,GAAG,IAAI,GAAG,EAAc,CAAA;IACvC,MAAM,QAAQ,GAAsB,EAAE,CAAA;IACtC,IAAI,KAAK,GAAG,OAAO,CAAC,KAAK,CAAA;IACzB,IAAI,UAAoC,CAAA;IACxC,IAAI,OAAO,GAAG,KAAK,CAAA;IACnB,IAAI,SAAS,GAAG,KAAK,CAAA;IACrB,kEAAkE;IAClE,IAAI,WAA8C,CAAA;IAElD,yEAAyE;IACzE,wEAAwE;IACxE,+CAA+C;IAC/C,SAAS,GAAG,CAAE,KAA8B;QAC3C,IAAI,SAAS,EAAE,CAAC;YACf,OAAM;QACP,CAAC;QACD,KAAK,GAAG,EAAE,GAAG,KAAK,EAAE,GAAG,KAAK,EAAE,CAAA;QAC9B,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;YAClC,QAAQ,EAAE,CAAA;QACX,CAAC;IACF,CAAC;IAED,SAAS,MAAM,CAAE,KAAwB;QACxC,GAAG,CAAC,EAAE,GAAG,EAAE,EAAE,GAAG,KAAK,CAAC,GAAG,EAAE,GAAG,KAAK,EAAE,EAAE,CAAC,CAAA;IACzC,CAAC;IAED,SAAS,MAAM,CAAE,KAAwB;QACxC,GAAG,CAAC,EAAE,GAAG,EAAE,EAAE,GAAG,KAAK,CAAC,GAAG,EAAE,GAAG,KAAK,EAAE,EAAE,CAAC,CAAA;IACzC,CAAC;IAED;;;;;;OAMG;IACH,SAAS,KAAK;QACb,IAAI,OAAO,IAAI,OAAO,MAAM,KAAK,WAAW,EAAE,CAAC;YAC9C,OAAM;QACP,CAAC;QACD,OAAO,GAAG,IAAI,CAAA;QAEd,QAAQ,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,GAAG,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,CAAA;QACjE,WAAW,EAAE,CAAA;QACb,gBAAgB,EAAE,CAAA;QAElB,IAAI,CAAC,KAAK,CAAC,aAAa,EAAE,CAAC;YAC1B,MAAM,GAAG,GAAG,gBAAgB,CAAC,OAAO,CAAC,MAAM,IAAI,eAAe,CAAC,CAAA;YAC/D,KAAK,kBAAkB,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE;gBAC7C,IAAI,SAAS,EAAE,CAAC;oBACf,OAAM;gBACP,CAAC;gBACD,GAAG,CAAC,EAAE,OAAO,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAA;gBACrC,gBAAgB,EAAE,CAAA;YACnB,CAAC,CAAC,CAAA;QACH,CAAC;IACF,CAAC;IAED,SAAS,WAAW;QACnB,UAAU,EAAE,EAAE,CAAA;QACd,UAAU,GAAG,eAAe,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,MAAM,EAAE,EAAE;YACpD,GAAG,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,cAAc,CAAC,KAAK,EAAE,MAAM,CAAC,EAAE,CAAC,CAAA;QACjE,CAAC,CAAC,CAAA;IACH,CAAC;IAED,IAAI,aAAa,GAAsB,EAAE,CAAA;IAEzC,SAAS,gBAAgB;QACxB,KAAK,MAAM,IAAI,IAAI,aAAa,EAAE,CAAC;YAClC,IAAI,EAAE,CAAA;QACP,CAAC;QACD,aAAa,GAAG;YACf,kBAAkB,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,SAAS,EAAE,EAAE,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC;YACvE,kBAAkB,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,SAAS,EAAE,EAAE,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC;SACvE,CAAA;IACF,CAAC;IAED,yEAAyE;IACzE,uEAAuE;IACvE,0DAA0D;IAC1D,IAAI,OAAiC,CAAA;IAErC,SAAS,QAAQ,CAAE,SAAyC;QAC3D,OAAO,EAAE,EAAE,CAAA;QACX,OAAO,GAAG,SAAS,CAAA;QACnB,MAAM,QAAQ,GAAG,SAAS,EAAE,QAAQ,CAAA;QACpC,IAAI,CAAC,QAAQ,EAAE,EAAE,IAAI,CAAC,QAAQ,CAAC,cAAc,EAAE,CAAC;YAC/C,OAAM;QACP,CAAC;QACD,MAAM,UAAU,GAAG,CAAC,GAAG,IAAe,EAAE,EAAE;YACzC,MAAM,QAAQ,GAAG,IAAI,CAAC,CAAC,CAAC,CAAA;YACxB,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;YAC9D,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;gBAC9B,MAAM,CAAC,EAAE,SAAS,EAAE,SAAS,EAAE,CAAC,CAAA;gBAChC,OAAM;YACP,CAAC;YACD,MAAM,CAAC;gBACN,SAAS,EAAE,KAAK,CAAC,GAAG,CAAC,SAAS;oBAC7B,CAAC,CAAC,EAAE,GAAG,KAAK,CAAC,GAAG,CAAC,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE;oBAC3C,CAAC,CAAC,SAAS;aACZ,CAAC,CAAA;QACH,CAAC,CAAA;QACD,MAAM,OAAO,GAAG,CAAC,GAAG,IAAe,EAAE,EAAE;YACtC,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAA;YACnB,MAAM,OAAO,GACZ,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;YACjE,MAAM,CAAC;gBACN,SAAS,EAAE,KAAK,CAAC,GAAG,CAAC,SAAS;oBAC7B,CAAC,CAAC,EAAE,GAAG,KAAK,CAAC,GAAG,CAAC,SAAS,EAAE,OAAO,EAAE;oBACrC,CAAC,CAAC,SAAS;aACZ,CAAC,CAAA;QACH,CAAC,CAAA;QACD,QAAQ,CAAC,EAAE,CAAC,iBAAiB,EAAE,UAAU,CAAC,CAAA;QAC1C,QAAQ,CAAC,EAAE,CAAC,cAAc,EAAE,OAAO,CAAC,CAAA;QACpC,OAAO,GAAG,GAAG,EAAE;YACd,QAAQ,CAAC,cAAc,EAAE,CAAC,iBAAiB,EAAE,UAAU,CAAC,CAAA;YACxD,QAAQ,CAAC,cAAc,EAAE,CAAC,cAAc,EAAE,OAAO,CAAC,CAAA;QACnD,CAAC,CAAA;IACF,CAAC;IAED,iEAAiE;IACjE,SAAS,MAAM,CAAE,OAAe;QAC/B,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,aAAa,CAAC,OAAO,CAAC,CAAA;IAC5D,CAAC;IAED,SAAS,oBAAoB;QAC5B,OAAO,CACN,OAAO,CAAC,aAAa;eAClB,EAAE,SAAS,EAAE,gCAAgC,EAAE,CAClD,CAAA;IACF,CAAC;IAED,MAAM,GAAG,GAAc;QACtB,QAAQ,EAAE,GAAG,EAAE,CAAC,KAAK;QAErB,SAAS,CAAE,QAAQ;YAClB,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;YACvB,KAAK,EAAE,CAAA;YACP,OAAO,GAAG,EAAE;gBACX,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAA;YAC3B,CAAC,CAAA;QACF,CAAC;QAED,KAAK,CAAC,UAAU,CAAE,MAAM;YACvB,MAAM,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAA;YACvC,IAAI,CAAC;gBACJ,MAAM,SAAS,GAAG,MAAM,gBAAgB,CAAC,MAAM,CAAC,CAAA;gBAChD,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC,CAAA;gBACrB,QAAQ,CAAC,SAAS,CAAC,CAAA;YACpB,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBAChB,MAAM,CAAC;oBACN,KAAK,EAAE,kBAAkB,CAAC,KAAK,EAAE,mCAAmC,CAAC;iBACrE,CAAC,CAAA;YACH,CAAC;oBAAS,CAAC;gBACV,MAAM,CAAC,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,CAAA;YAC9B,CAAC;QACF,CAAC;QAED,KAAK,CAAC,UAAU,CAAE,MAAM;YACvB,MAAM,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAA;YACvC,IAAI,CAAC;gBACJ,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,MAAM,gBAAgB,CAAC,MAAM,CAAC,CAAA;gBAC3D,MAAM,CAAC;oBACN,SAAS,EAAE;wBACV,QAAQ,EAAE,MAAM,CAAC,EAAE;wBACnB,IAAI,EAAE,MAAM,CAAC,IAAI;wBACjB,IAAI,EAAE,MAAM,CAAC,IAAI;wBACjB,OAAO;wBACP,OAAO;wBACP,QAAQ,EAAE,MAAM,CAAC,QAAQ;wBACzB,QAAQ,EAAE,MAAM,CAAC,QAAQ;qBACzB;iBACD,CAAC,CAAA;YACH,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBAChB,MAAM,CAAC;oBACN,KAAK,EAAE,kBAAkB,CAAC,KAAK,EAAE,mCAAmC,CAAC;iBACrE,CAAC,CAAA;YACH,CAAC;oBAAS,CAAC;gBACV,MAAM,CAAC,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,CAAA;YAC9B,CAAC;QACF,CAAC;QAED,KAAK,CAAC,aAAa,CAAE,MAAM,EAAE,OAAO,EAAE,KAAK;YAC1C,MAAM,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAA;YACvC,IAAI,CAAC;gBACJ,MAAM,OAAO,GAAG,MAAM,wBAAwB,CAC7C,oBAAoB,EAAE,EACtB,OAAO,EACP,KAAK,CACL,CAAA;gBACD,WAAW,GAAG,OAAO,CAAC,KAAK,CAAA;gBAC3B,MAAM,SAAS,GAAuB;oBACrC,QAAQ,EAAE,MAAM,CAAC,EAAE;oBACnB,IAAI,EAAE,MAAM,CAAC,IAAI;oBACjB,OAAO,EAAE,OAAO,CAAC,OAAO;oBACxB,OAAO,EAAE,OAAO,CAAC,OAAO;oBACxB,QAAQ,EAAE,OAAO,CAAC,QAAQ;iBAC1B,CAAA;gBACD,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC,CAAA;gBACrB,QAAQ,CAAC,SAAS,CAAC,CAAA;YACpB,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBAChB,MAAM,CAAC;oBACN,KAAK,EAAE,kBAAkB,CAAC,KAAK,EAAE,mCAAmC,CAAC;iBACrE,CAAC,CAAA;YACH,CAAC;oBAAS,CAAC;gBACV,MAAM,CAAC,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,CAAA;YAC9B,CAAC;QACF,CAAC;QAED,UAAU,CAAE,MAAM;YACjB,IAAI,MAAM,KAAK,KAAK,EAAE,CAAC;gBACtB,4DAA4D;gBAC5D,4DAA4D;gBAC5D,4DAA4D;gBAC5D,uDAAuD;gBACvD,KAAK,WAAW,EAAE,EAAE,CAAA;gBACpB,WAAW,GAAG,SAAS,CAAA;gBACvB,OAAO,EAAE,EAAE,CAAA;gBACX,OAAO,GAAG,SAAS,CAAA;gBACnB,MAAM,CAAC,EAAE,SAAS,EAAE,SAAS,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAA;YAC5C,CAAC;YACD,IAAI,MAAM,KAAK,KAAK,EAAE,CAAC;gBACtB,4DAA4D;gBAC5D,8DAA8D;gBAC9D,iBAAiB;gBACjB,IAAI,KAAK,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC;oBACzB,KAAK,mBAAmB,CAAC,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAA;gBACrE,CAAC;gBACD,MAAM,CAAC,EAAE,SAAS,EAAE,SAAS,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAA;YAC5C,CAAC;QACF,CAAC;QAED,KAAK,CAAC,WAAW,CAAE,OAAO;YACzB,MAAM,SAAS,GAAG,KAAK,CAAC,GAAG,CAAC,SAAS,CAAA;YACrC,IAAI,CAAC,SAAS,EAAE,CAAC;gBAChB,OAAO,KAAK,CAAA;YACb,CAAC;YACD,IAAI,SAAS,CAAC,OAAO,KAAK,OAAO,EAAE,CAAC;gBACnC,OAAO,IAAI,CAAA;YACZ,CAAC;YACD,MAAM,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,cAAc,EAAE,IAAI,EAAE,CAAC,CAAA;YAC3C,IAAI,CAAC;gBACJ,4DAA4D;gBAC5D,8CAA8C;gBAC9C,MAAM,cAAc,CAAC,SAAS,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAA;gBACjD,OAAO,IAAI,CAAA;YACZ,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBAChB,MAAM,CAAC,EAAE,KAAK,EAAE,kBAAkB,CAAC,KAAK,EAAE,2BAA2B,CAAC,EAAE,CAAC,CAAA;gBACzE,OAAO,KAAK,CAAA;YACb,CAAC;oBAAS,CAAC;gBACV,MAAM,CAAC,EAAE,cAAc,EAAE,KAAK,EAAE,CAAC,CAAA;YAClC,CAAC;QACF,CAAC;QAED,QAAQ,CAAE,IAAI;YACb,KAAK,GAAG,IAAI,CAAA;YACZ,IAAI,OAAO,EAAE,CAAC;gBACb,0DAA0D;gBAC1D,uDAAuD;gBACvD,iDAAiD;gBACjD,WAAW,EAAE,CAAA;gBACb,OAAM;YACP,CAAC;YACD,8DAA8D;YAC9D,2DAA2D;YAC3D,WAAW;YACX,MAAM,MAAM,GAAG,aAAa,CAAC,KAAK,EAAE,IAAI,CAAC,CAAA;YACzC,GAAG,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,cAAc,CAAC,KAAK,EAAE,MAAM,CAAC,EAAE,CAAC,CAAA;QACjE,CAAC;QAED,eAAe,EAAE,GAAG,EAAE,CAAC,kBAAkB,CAAC,oBAAoB,EAAE,CAAC;QAEjE,KAAK,CAAC,YAAY,CAAE,MAAM,EAAE,MAAM;YACjC,MAAM,SAAS,GACd,MAAM,KAAK,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,SAAS,CAAA;YAC7D,IAAI,CAAC,SAAS,EAAE,CAAC;gBAChB,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAA;YAC3C,CAAC;YACD,OAAO,OAAO,CAAC,GAAG,CACjB,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE;gBAC1B,IAAI,KAAK,CAAC,MAAM,KAAK,KAAK,EAAE,CAAC;oBAC5B,OAAO,cAAc,CACpB,OAAO,CAAC,SAAS,IAAI,mBAAmB,EACxC,KAAK,EACL,SAAS,CAAC,OAAO,CACjB,CAAA;gBACF,CAAC;gBACD,uDAAuD;gBACvD,0DAA0D;gBAC1D,2DAA2D;gBAC3D,+CAA+C;gBAC/C,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;gBACjC,MAAM,MAAM,GAAG,GAAG;oBACjB,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE;oBACjB,CAAC,CAAC,EAAE,QAAQ,EAAG,SAAgC,CAAC,QAAQ,EAAE,CAAA;gBAC3D,OAAO,cAAc,CAAC,MAAM,EAAE,KAAK,EAAE,SAAS,CAAC,OAAO,CAAC,CAAA;YACxD,CAAC,CAAC,CACF,CAAA;QACF,CAAC;QAED,KAAK,CAAC,aAAa,CAAE,MAAM,EAAE,OAAO;YACnC,2DAA2D;YAC3D,gEAAgE;YAChE,wDAAwD;YACxD,8DAA8D;YAC9D,OAAO;YACP,IAAI,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;gBACnE,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAA;YAC9D,CAAC;YACD,MAAM,SAAS,GACd,MAAM,KAAK,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,SAAS,CAAA;YAC7D,IAAI,CAAC,SAAS,EAAE,CAAC;gBAChB,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAA;YAC3C,CAAC;YAED,MAAM,GAAG,GAAG,MAAM,KAAK,KAAK,CAAC,CAAC,CAAE,SAAgC,CAAC,CAAC,CAAC,SAAS,CAAA;YAC5E,MAAM,MAAM,GAAkB;gBAC7B,QAAQ,EAAE,SAAS,CAAC,QAAQ;gBAC5B,IAAI,EAAE,SAAS,CAAC,IAAI;gBACpB,IAAI,EAAE,SAAS,CAAC,IAAI;gBACpB,MAAM;gBACN,OAAO,EAAE,SAAS,CAAC,OAAO;gBAC1B,OAAO,EAAE,GAAG,EAAE,OAAO;aACrB,CAAA;YACD,IAAI,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;gBACxC,MAAM,CAAC,QAAQ,GAAG,MAAM,GAAG,CAAC,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,EAAE,CAAC,CAAA;YACvE,CAAC;YACD,IAAI,OAAO,CAAC,SAAS,IAAI,GAAG,EAAE,CAAC;gBAC9B,MAAM,CAAC,QAAQ,GAAG,GAAG,CAAC,QAAQ,CAAA;YAC/B,CAAC;YACD,OAAO,MAAM,CAAA;QACd,CAAC;QAED,OAAO;YACN,SAAS,GAAG,IAAI,CAAA;YAChB,KAAK,MAAM,IAAI,IAAI,CAAC,GAAG,aAAa,EAAE,GAAG,QAAQ,CAAC,EAAE,CAAC;gBACpD,IAAI,EAAE,CAAA;YACP,CAAC;YACD,aAAa,GAAG,EAAE,CAAA;YAClB,UAAU,EAAE,EAAE,CAAA;YACd,OAAO,EAAE,EAAE,CAAA;YACX,KAAK,WAAW,EAAE,EAAE,CAAA;YACpB,SAAS,CAAC,KAAK,EAAE,CAAA;QAClB,CAAC;KACD,CAAA;IAED,OAAO,GAAG,CAAA;AACX,CAAC"}

package/dist/svm.d.ts

@@ -0,0 +1,45 @@
+import { type WalletEntry } from './catalog.js';
+import { type StandardAccount } from './wallet-standard.js';
+import type { ConnectedSvmWallet, DetectedSvmWallet } from './types.js';
+/**
+ * Prompts the wallet for an account.
+ *
+ * Two routes because there are two kinds of wallet here. A registered one is
+ * asked through its connect feature and hands back accounts; an injected one
+ * is asked through its provider. The account object from the first is kept,
+ * because signing needs it back.
+ */
+export declare function connectSvmWallet(wallet: DetectedSvmWallet): Promise<{
+    address: string;
+    account?: StandardAccount;
+}>;
+/** Ends the session where the wallet offers a way to. */
+export declare function disconnectSvmWallet(wallet: ConnectedSvmWallet): Promise<void>;
+/**
+ * Signs the prepared transaction and lets the wallet submit it.
+ *
+ * Nothing here builds or alters a transaction: the plan arrives built, in
+ * both the forms a wallet might want, and this picks the one its route takes.
+ * The payer still sees the wallet decode and display it before approving.
+ *
+ * Letting the wallet send it, rather than signing and sending separately,
+ * means one prompt and no RPC endpoint in this bundle.
+ */
+export declare function signAndSendSvm(wallet: ConnectedSvmWallet, plan: {
+    message: string;
+    transaction: string;
+    chain: string;
+}): Promise<string>;
+/** Truncates a base58 address for display: 5e9y…xAQf. */
+export declare function shortSvmAddress(address: string): string;
+/**
+ * Finds the Solana wallets available in this browser.
+ *
+ * The Wallet Standard first: it is how wallets announce Solana support, it
+ * survives several being installed at once, and the wallet supplies its own
+ * name and icon. Sniffing globals is only a fallback for one that has not
+ * adopted it, and never overrides a registered wallet.
+ *
+ * Returns a cleanup function; callers must call it to drop the listener.
+ */
+export declare function discoverSvmWallets(catalog: WalletEntry[], onChange: (wallets: DetectedSvmWallet[]) => void): () => void;

package/dist/svm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"svm.d.ts","sourceRoot":"","sources":["../src/svm.ts"],"names":[],"mappings":"AACA,OAAO,EAAgC,KAAK,WAAW,EAAE,MAAM,cAAc,CAAA;AAE7E,OAAO,EAMN,KAAK,eAAe,EAEpB,MAAM,sBAAsB,CAAA;AAC7B,OAAO,KAAK,EACX,kBAAkB,EAClB,iBAAiB,EAEjB,MAAM,YAAY,CAAA;AAqBnB;;;;;;;GAOG;AACH,wBAAsB,gBAAgB,CACrC,MAAM,EAAE,iBAAiB,GACvB,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,eAAe,CAAA;CAAE,CAAC,CA4BzD;AAED,yDAAyD;AACzD,wBAAsB,mBAAmB,CACxC,MAAM,EAAE,kBAAkB,GACxB,OAAO,CAAC,IAAI,CAAC,CAMf;AAED;;;;;;;;;GASG;AACH,wBAAsB,cAAc,CACnC,MAAM,EAAE,kBAAkB,EAC1B,IAAI,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAC3D,OAAO,CAAC,MAAM,CAAC,CAgDjB;AAED,yDAAyD;AACzD,wBAAgB,eAAe,CAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAKxD;AAmBD;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CACjC,OAAO,EAAE,WAAW,EAAE,EACtB,QAAQ,EAAE,CAAC,OAAO,EAAE,iBAAiB,EAAE,KAAK,IAAI,GAC9C,MAAM,IAAI,CAuDZ"}