@reclack/walletkit 0.0.0-stage → 0.1.0

package/dist/types.d.ts

@@ -0,0 +1,144 @@
+import type { StandardAccount, StandardWallet } from './wallet-standard.js';
+/**
+ * An EIP-1193 provider: the only interface this app talks to.
+ *
+ * Deliberately hand-typed rather than pulled from a wallet SDK: every wallet
+ * below speaks this, and a checkout page that handles other people's money
+ * should ship as little third-party code as possible.
+ */
+export interface Eip1193Provider {
+    request(args: {
+        method: string;
+        params?: unknown[] | object;
+    }): Promise<unknown>;
+    on?(event: string, handler: (...args: unknown[]) => void): void;
+    removeListener?(event: string, handler: (...args: unknown[]) => void): void;
+}
+/** A wallet Reclack knows how to name and find. */
+export interface EvmWalletDefinition {
+    id: string;
+    name: string;
+    /** EIP-6963 reverse-DNS ids, when the wallet announces any. */
+    rdns?: string[];
+    /**
+     * Fallback detector for wallets that inject a global but do not yet
+     * announce themselves over EIP-6963.
+     */
+    detect?: (win: Window) => Eip1193Provider | undefined;
+    /** Where to send someone who does not have it installed. */
+    installUrl: string;
+}
+/** A wallet actually available in this browser, ready to connect. */
+export interface DetectedEvmWallet {
+    id: string;
+    name: string;
+    /** Data-URI supplied by the wallet itself over EIP-6963, when present. */
+    icon?: string;
+    provider: Eip1193Provider;
+    /** True when discovered via EIP-6963 rather than a global sniff. */
+    announced: boolean;
+}
+export interface ConnectedEvmWallet {
+    walletId: string;
+    name: string;
+    icon?: string;
+    address: string;
+    chainId: number;
+    provider: Eip1193Provider;
+}
+/**
+ * A Solana wallet's injected provider: the only interface this app talks to.
+ *
+ * Hand-typed, like the EIP-1193 one above it, and for the same reason: a
+ * checkout page handling other people's money should ship as little
+ * third-party code as it can. No wallet SDK is needed because the transaction
+ * arrives already built, so nothing here constructs one.
+ *
+ * Every field is optional because wallets disagree about which of these they
+ * expose. What they must have is `request`; see signAndSendSvm.
+ */
+export interface SvmProvider {
+    publicKey?: unknown;
+    request?(args: {
+        method: string;
+        params?: unknown;
+    }): Promise<unknown>;
+    connect?(options?: {
+        onlyIfTrusted?: boolean;
+    }): Promise<unknown>;
+    disconnect?(): Promise<void>;
+    on?(event: string, handler: (...args: unknown[]) => void): void;
+    removeListener?(event: string, handler: (...args: unknown[]) => void): void;
+}
+/**
+ * A Solana wallet Reclack knows how to name and find.
+ *
+ * Separate from EvmWalletDefinition rather than a family field on it. The two
+ * share a name and an install link and nothing else: no EIP-6963
+ * announcement, no chain to switch to, a different provider interface and a
+ * different address format. One definition covering both would be a struct
+ * whose fields are half-populated depending on which family you meant.
+ */
+export interface SvmWalletDefinition {
+    id: string;
+    name: string;
+    installUrl: string;
+}
+/**
+ * A Solana wallet available in this browser, ready to connect.
+ *
+ * Reached one of two ways, and it matters which. A wallet that registered
+ * through the Wallet Standard is driven by its feature objects; one found by
+ * sniffing a global is driven by its injected provider. Most wallets that
+ * sign Solana announce themselves the first way, including every EVM wallet
+ * that has added it, so that is the one to prefer.
+ */
+export interface DetectedSvmWallet {
+    id: string;
+    name: string;
+    icon?: string;
+    /** Set when the wallet registered through the Wallet Standard. */
+    standard?: StandardWallet;
+    /** Set when it was found as an injected global instead. */
+    provider?: SvmProvider;
+}
+export interface ConnectedSvmWallet {
+    walletId: string;
+    name: string;
+    icon?: string;
+    /** Base58. Never lowercased: the case is part of the key. */
+    address: string;
+    standard?: StandardWallet;
+    /** The account the standard wallet connected, which signing needs back. */
+    account?: StandardAccount;
+    provider?: SvmProvider;
+}
+/**
+ * The least a wallet picker needs to know about a detected wallet.
+ *
+ * The picker is shared between families, which have different providers and
+ * different connect calls but the same job on screen: name a wallet, show its
+ * mark, and hand the whole thing back when it is chosen. Typing the UI
+ * against this rather than against either family's wallet keeps one picker
+ * instead of two that drift apart.
+ */
+export interface WalletChoice {
+    id: string;
+    name: string;
+    icon?: string;
+}
+/** The chain families a wallet can sign for. */
+export type ChainFamily = 'evm' | 'svm';
+/** The least the picker needs about a wallet that may not be installed. */
+export interface WalletOption {
+    id: string;
+    name: string;
+    installUrl: string;
+    /**
+     * The wallet's mobile app has a browser of its own, which this checkout
+     * can be opened in. Decides how a wallet that injects nothing into an
+     * ordinary page is reached: the hand-off carries the checkout to that
+     * browser, and only a wallet without one needs a WalletConnect session.
+     */
+    browser?: boolean;
+}

package/dist/types.d.ts.map

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

package/dist/types.js

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

package/dist/types.js.map

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

package/dist/wallet-standard.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Solana wallet discovery through the Wallet Standard.
+ *
+ * The Solana equivalent of EIP-6963, and here for the same reason: sniffing
+ * globals finds only the wallets that claim one. MetaMask, Brave, Coinbase
+ * Wallet and others all sign Solana now, and they announce it this way rather
+ * than by injecting `window.solana`, so a list built from globals is a list
+ * of three wallets that is wrong about every other.
+ *
+ * Hand-typed against the protocol rather than pulled from @wallet-standard:
+ * the handshake is two events and one method, and a checkout page handling
+ * other people's money should ship as little third-party code as it can.
+ *
+ * The protocol: a wallet already loaded listens for `app-ready` and registers
+ * itself with the API it carries; a wallet that loads later dispatches
+ * `register-wallet` with a callback for the app to hand that API to. An app
+ * must do both or it misses one group or the other.
+ */
+/** One account a wallet has connected. */
+export interface StandardAccount {
+    /** Base58, which is what this app wants. */
+    address: string;
+    chains: readonly string[];
+    features: readonly string[];
+}
+interface ConnectFeature {
+    connect(input?: {
+        silent?: boolean;
+    }): Promise<{
+        accounts: readonly StandardAccount[];
+    }>;
+}
+interface SignAndSendFeature {
+    signAndSendTransaction(...inputs: {
+        account: StandardAccount;
+        chain: string;
+        transaction: Uint8Array;
+    }[]): Promise<readonly {
+        signature: Uint8Array;
+    }[]>;
+}
+/** A wallet as the standard describes it. */
+export interface StandardWallet {
+    name: string;
+    icon?: string;
+    version: string;
+    chains: readonly string[];
+    accounts: readonly StandardAccount[];
+    features: Record<string, unknown>;
+}
+export declare const CONNECT = "standard:connect";
+export declare const SIGN_AND_SEND = "solana:signAndSendTransaction";
+/**
+ * Whether this wallet can do what a checkout needs: connect, and sign and
+ * send a Solana transaction.
+ *
+ * Both are required. A wallet that can sign but not send would leave this
+ * page needing an RPC endpoint and a submission path of its own, which is
+ * exactly what the plan was built to avoid.
+ */
+export declare function usable(wallet: StandardWallet): boolean;
+export declare function connectFeature(wallet: StandardWallet): ConnectFeature;
+export declare function signFeature(wallet: StandardWallet): SignAndSendFeature;
+export declare function disconnectFeature(wallet: StandardWallet): {
+    disconnect(): Promise<void>;
+} | undefined;
+export declare function eventsFeature(wallet: StandardWallet): {
+    on(event: string, listener: () => void): () => void;
+} | undefined;
+/**
+ * Collects the wallets registered in this page, now and as they arrive.
+ *
+ * Returns a cleanup function; callers must call it to drop the listener. The
+ * same contract as the EIP-6963 discovery beside it.
+ */
+export declare function discoverStandardWallets(onChange: (wallets: StandardWallet[]) => void): () => void;
+export {};

package/dist/wallet-standard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wallet-standard.d.ts","sourceRoot":"","sources":["../src/wallet-standard.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,0CAA0C;AAC1C,MAAM,WAAW,eAAe;IAC/B,4CAA4C;IAC5C,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,SAAS,MAAM,EAAE,CAAA;IACzB,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAA;CAC3B;AAED,UAAU,cAAc;IACvB,OAAO,CAAC,KAAK,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC;QAC9C,QAAQ,EAAE,SAAS,eAAe,EAAE,CAAA;KACpC,CAAC,CAAA;CACF;AAED,UAAU,kBAAkB;IAC3B,sBAAsB,CACrB,GAAG,MAAM,EAAE;QACV,OAAO,EAAE,eAAe,CAAA;QACxB,KAAK,EAAE,MAAM,CAAA;QACb,WAAW,EAAE,UAAU,CAAA;KACvB,EAAE,GACD,OAAO,CAAC,SAAS;QAAE,SAAS,EAAE,UAAU,CAAA;KAAE,EAAE,CAAC,CAAA;CAChD;AAED,6CAA6C;AAC7C,MAAM,WAAW,cAAc;IAC9B,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,SAAS,MAAM,EAAE,CAAA;IACzB,QAAQ,EAAE,SAAS,eAAe,EAAE,CAAA;IACpC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACjC;AAED,eAAO,MAAM,OAAO,qBAAqB,CAAA;AACzC,eAAO,MAAM,aAAa,kCAAkC,CAAA;AAI5D;;;;;;;GAOG;AACH,wBAAgB,MAAM,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAMtD;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,cAAc,GAAG,cAAc,CAErE;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,cAAc,GAAG,kBAAkB,CAEtE;AAED,wBAAgB,iBAAiB,CAChC,MAAM,EAAE,cAAc,GACpB;IAAE,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CAAE,GAAG,SAAS,CAE7C;AAED,wBAAgB,aAAa,CAC5B,MAAM,EAAE,cAAc,GACpB;IAAE,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAA;CAAE,GAAG,SAAS,CAIrE;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACtC,QAAQ,EAAE,CAAC,OAAO,EAAE,cAAc,EAAE,KAAK,IAAI,GAC3C,MAAM,IAAI,CAyCZ"}

package/dist/wallet-standard.js

@@ -0,0 +1,89 @@
+/**
+ * Solana wallet discovery through the Wallet Standard.
+ *
+ * The Solana equivalent of EIP-6963, and here for the same reason: sniffing
+ * globals finds only the wallets that claim one. MetaMask, Brave, Coinbase
+ * Wallet and others all sign Solana now, and they announce it this way rather
+ * than by injecting `window.solana`, so a list built from globals is a list
+ * of three wallets that is wrong about every other.
+ *
+ * Hand-typed against the protocol rather than pulled from @wallet-standard:
+ * the handshake is two events and one method, and a checkout page handling
+ * other people's money should ship as little third-party code as it can.
+ *
+ * The protocol: a wallet already loaded listens for `app-ready` and registers
+ * itself with the API it carries; a wallet that loads later dispatches
+ * `register-wallet` with a callback for the app to hand that API to. An app
+ * must do both or it misses one group or the other.
+ */
+export const CONNECT = 'standard:connect';
+export const SIGN_AND_SEND = 'solana:signAndSendTransaction';
+const DISCONNECT = 'standard:disconnect';
+const EVENTS = 'standard:events';
+/**
+ * Whether this wallet can do what a checkout needs: connect, and sign and
+ * send a Solana transaction.
+ *
+ * Both are required. A wallet that can sign but not send would leave this
+ * page needing an RPC endpoint and a submission path of its own, which is
+ * exactly what the plan was built to avoid.
+ */
+export function usable(wallet) {
+    return (Boolean(wallet.features?.[CONNECT])
+        && Boolean(wallet.features?.[SIGN_AND_SEND])
+        && wallet.chains.some((chain) => chain.startsWith('solana:')));
+}
+export function connectFeature(wallet) {
+    return wallet.features[CONNECT];
+}
+export function signFeature(wallet) {
+    return wallet.features[SIGN_AND_SEND];
+}
+export function disconnectFeature(wallet) {
+    return wallet.features[DISCONNECT];
+}
+export function eventsFeature(wallet) {
+    return wallet.features[EVENTS];
+}
+/**
+ * Collects the wallets registered in this page, now and as they arrive.
+ *
+ * Returns a cleanup function; callers must call it to drop the listener. The
+ * same contract as the EIP-6963 discovery beside it.
+ */
+export function discoverStandardWallets(onChange) {
+    const found = new Map();
+    function register(...wallets) {
+        let added = false;
+        for (const wallet of wallets) {
+            // Keyed by name: the standard has no stable id, and a wallet
+            // registering twice is a duplicate row rather than two wallets.
+            if (wallet?.name && !found.has(wallet.name)) {
+                found.set(wallet.name, wallet);
+                added = true;
+            }
+        }
+        if (added) {
+            onChange([...found.values()]);
+        }
+        // The standard's register returns an unregister function. Nothing
+        // here unregisters anyone, so this is a no-op rather than a lie
+        // about what it does.
+        return () => undefined;
+    }
+    const api = Object.freeze({ register });
+    function onRegister(event) {
+        const callback = event.detail;
+        if (typeof callback === 'function') {
+            callback(api);
+        }
+    }
+    window.addEventListener('wallet-standard:register-wallet', onRegister);
+    // Wakes the wallets that were already loaded when this page was: they
+    // listen for this and register themselves in response.
+    window.dispatchEvent(new CustomEvent('wallet-standard:app-ready', { detail: api }));
+    return () => {
+        window.removeEventListener('wallet-standard:register-wallet', onRegister);
+    };
+}
+//# sourceMappingURL=wallet-standard.js.map

package/dist/wallet-standard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wallet-standard.js","sourceRoot":"","sources":["../src/wallet-standard.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAoCH,MAAM,CAAC,MAAM,OAAO,GAAG,kBAAkB,CAAA;AACzC,MAAM,CAAC,MAAM,aAAa,GAAG,+BAA+B,CAAA;AAC5D,MAAM,UAAU,GAAG,qBAAqB,CAAA;AACxC,MAAM,MAAM,GAAG,iBAAiB,CAAA;AAEhC;;;;;;;GAOG;AACH,MAAM,UAAU,MAAM,CAAC,MAAsB;IAC5C,OAAO,CACN,OAAO,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,CAAC;WAChC,OAAO,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC,aAAa,CAAC,CAAC;WACzC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAC7D,CAAA;AACF,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,MAAsB;IACpD,OAAO,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAmB,CAAA;AAClD,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,MAAsB;IACjD,OAAO,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAuB,CAAA;AAC5D,CAAC;AAED,MAAM,UAAU,iBAAiB,CAChC,MAAsB;IAEtB,OAAO,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAgD,CAAA;AAClF,CAAC;AAED,MAAM,UAAU,aAAa,CAC5B,MAAsB;IAEtB,OAAO,MAAM,CAAC,QAAQ,CAAC,MAAM,CAEjB,CAAA;AACb,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,uBAAuB,CACtC,QAA6C;IAE7C,MAAM,KAAK,GAAG,IAAI,GAAG,EAA0B,CAAA;IAE/C,SAAS,QAAQ,CAAC,GAAG,OAAyB;QAC7C,IAAI,KAAK,GAAG,KAAK,CAAA;QACjB,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC9B,6DAA6D;YAC7D,gEAAgE;YAChE,IAAI,MAAM,EAAE,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC7C,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;gBAC9B,KAAK,GAAG,IAAI,CAAA;YACb,CAAC;QACF,CAAC;QACD,IAAI,KAAK,EAAE,CAAC;YACX,QAAQ,CAAC,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAA;QAC9B,CAAC;QACD,kEAAkE;QAClE,gEAAgE;QAChE,sBAAsB;QACtB,OAAO,GAAG,EAAE,CAAC,SAAS,CAAA;IACvB,CAAC;IAED,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAA;IAEvC,SAAS,UAAU,CAAC,KAAY;QAC/B,MAAM,QAAQ,GAAI,KAA6C,CAAC,MAAM,CAAA;QACtE,IAAI,OAAO,QAAQ,KAAK,UAAU,EAAE,CAAC;YACpC,QAAQ,CAAC,GAAG,CAAC,CAAA;QACd,CAAC;IACF,CAAC;IAED,MAAM,CAAC,gBAAgB,CAAC,iCAAiC,EAAE,UAAU,CAAC,CAAA;IACtE,sEAAsE;IACtE,uDAAuD;IACvD,MAAM,CAAC,aAAa,CACnB,IAAI,WAAW,CAAC,2BAA2B,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAC7D,CAAA;IAED,OAAO,GAAG,EAAE;QACX,MAAM,CAAC,mBAAmB,CAAC,iCAAiC,EAAE,UAAU,CAAC,CAAA;IAC1E,CAAC,CAAA;AACF,CAAC"}

package/dist/walletconnect.d.ts

@@ -0,0 +1,74 @@
+import type { Eip1193Provider } from "./types.js";
+/**
+ * Connecting a wallet that puts nothing into the page.
+ *
+ * Safe, Kraken, BitPay, Bitcoin.com and Blockchain.com inject no provider and
+ * have no dapp browser to open this page in. They reach an app over
+ * WalletConnect instead: the page and the wallet pass messages through a
+ * relay, paired by a code the payer scans or a link their phone opens, and
+ * the payment is approved in the wallet.
+ *
+ * The SDK is loaded only when one of those is chosen. It is far larger than
+ * the rest of this checkout put together, and a payer using an extension
+ * should never pay for bytes they do not use.
+ *
+ * What comes back is an ordinary EIP-1193 provider, so everything after the
+ * connection, signing, switching network, watching for an account change,
+ * is the same code that serves an injected wallet.
+ */
+/**
+ * What the wallet prints on its approval screen.
+ *
+ * Reclack's own by default, branded checkout or not: this names who the
+ * session is with, and the session is with Reclack. A host that is not
+ * Reclack, a partner embedding this kit, passes its own.
+ *
+ * The icon was once the USDC mark, which is why a payer approving in Binance
+ * was shown a dollar coin above our name: the wallet draws exactly what it is
+ * sent. A PNG comes first and the SVG behind it, because wallets take the
+ * first icon they can decode and a wallet application draws these with the
+ * platform's own image loader rather than a browser, which is not always told
+ * about SVG.
+ */
+export interface SessionMetadata {
+    name: string;
+    description: string;
+    url: string;
+    icons: string[];
+}
+/**
+ * Where the pairing is made, and what the wallet is told about who is asking.
+ *
+ * The project id is public by design: it identifies the page to the relay and
+ * carries no authority. It is an option rather than an environment variable
+ * because this package is built once and run by several hosts, each with its
+ * own. Without one, WalletConnect is simply not offered.
+ */
+export interface WalletConnectOptions {
+    projectId: string;
+    metadata?: SessionMetadata;
+}
+/** Reclack's own session metadata, derived from wherever this is served. */
+export declare function defaultMetadata(): SessionMetadata;
+/** Whether a host has given this kit what a session needs. */
+export declare function walletConnectReady(options: WalletConnectOptions | undefined): boolean;
+export interface RemoteSession {
+    provider: Eip1193Provider;
+    address: string;
+    chainId: number;
+    /** Ends the session. A pairing the payer walked away from must not linger. */
+    close: () => Promise<void>;
+}
+/**
+ * Pairs with a wallet and waits for the payer to approve.
+ *
+ * `onUri` is called once with the pairing string, which is what the code and
+ * the link are made of. It arrives before the payer has done anything, so the
+ * caller can show it while this promise is still pending.
+ *
+ * The chain is optional rather than required. A wallet that does not have it
+ * would otherwise refuse the pairing outright, which reads as "this wallet is
+ * broken"; connecting first and asking it to switch afterwards is the same
+ * path an injected wallet on the wrong network already takes.
+ */
+export declare function openWalletConnectSession(options: WalletConnectOptions, chainId: number, onUri: (uri: string) => void): Promise<RemoteSession>;

package/dist/walletconnect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"walletconnect.d.ts","sourceRoot":"","sources":["../src/walletconnect.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAEjD;;;;;;;;;;;;;;;;GAgBG;AAEH;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,eAAe;IAC/B,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,MAAM,EAAE,CAAA;CACf;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,oBAAoB;IACpC,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,CAAC,EAAE,eAAe,CAAA;CAC1B;AAED,4EAA4E;AAC5E,wBAAgB,eAAe,IAAI,eAAe,CAWjD;AAyBD,8DAA8D;AAC9D,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,oBAAoB,GAAG,SAAS,GAAG,OAAO,CAErF;AAED,MAAM,WAAW,aAAa;IAC7B,QAAQ,EAAE,eAAe,CAAA;IACzB,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,MAAM,CAAA;IACf,8EAA8E;IAC9E,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAC1B;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,wBAAwB,CAC7C,OAAO,EAAE,oBAAoB,EAC7B,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,GAC1B,OAAO,CAAC,aAAa,CAAC,CA0FxB"}

package/dist/walletconnect.js

@@ -0,0 +1,133 @@
+import { WalletError } from "./errors.js";
+/** Reclack's own session metadata, derived from wherever this is served. */
+export function defaultMetadata() {
+    // The frame's origin, not the page's, when this runs embedded. That is
+    // correct: the icons have to be fetchable, and only this origin is known
+    // to serve them.
+    const origin = typeof window === "undefined" ? "" : window.location.origin;
+    return {
+        name: "Reclack",
+        description: "Pay using stablecoins",
+        url: origin,
+        icons: [`${origin}/apple-touch-icon.png`, `${origin}/favicon.svg`],
+    };
+}
+/**
+ * How long to wait for the relay before giving up on it.
+ *
+ * Neither of the two waits below is the payer's. Reaching the relay and being
+ * handed a pairing code happen before anybody is asked to do anything, so a
+ * relay that never answers is a failure, not somebody taking their time.
+ * Approving in the wallet is the payer's wait and is never timed.
+ *
+ * Unbounded, this was a spinner that never stopped: a project id the relay
+ * refuses, or a blocked WebSocket, and the panel sat on "Preparing a
+ * connection..." with nothing to press.
+ */
+const RELAY_TIMEOUT = 12_000;
+/** Rejects if `work` has not settled in time, leaving `work` to its fate. */
+function within(work, ms, message) {
+    let timer;
+    const limit = new Promise((_, reject) => {
+        timer = setTimeout(() => reject(new WalletError(message)), ms);
+    });
+    return Promise.race([work, limit]).finally(() => clearTimeout(timer));
+}
+/** Whether a host has given this kit what a session needs. */
+export function walletConnectReady(options) {
+    return Boolean(options?.projectId?.trim());
+}
+/**
+ * Pairs with a wallet and waits for the payer to approve.
+ *
+ * `onUri` is called once with the pairing string, which is what the code and
+ * the link are made of. It arrives before the payer has done anything, so the
+ * caller can show it while this promise is still pending.
+ *
+ * The chain is optional rather than required. A wallet that does not have it
+ * would otherwise refuse the pairing outright, which reads as "this wallet is
+ * broken"; connecting first and asking it to switch afterwards is the same
+ * path an injected wallet on the wrong network already takes.
+ */
+export async function openWalletConnectSession(options, chainId, onUri) {
+    if (!walletConnectReady(options)) {
+        throw new Error("WalletConnect is not configured for this checkout.");
+    }
+    const { EthereumProvider } = await import("@walletconnect/ethereum-provider");
+    // Bounded: init opens the relay socket, and a socket that cannot be
+    // opened leaves this pending rather than throwing.
+    const provider = await within(EthereumProvider.init({
+        projectId: options.projectId.trim(),
+        optionalChains: [chainId],
+        // Our own code and our own panel. The bundled modal would be a second
+        // design to keep in step with this one, and it is most of the weight.
+        showQrModal: false,
+        // What the wallet prints on the approval screen. See SessionMetadata.
+        metadata: options.metadata ?? defaultMetadata(),
+    }), RELAY_TIMEOUT, "Could not reach the connection service. Check your network and try again.");
+    const close = async () => {
+        try {
+            await provider.disconnect();
+        }
+        catch {
+            // Already gone, or the relay is unreachable. Nothing to undo.
+        }
+    };
+    // A session the browser still holds from a previous visit. Reusing it
+    // saves the payer scanning anything, which is the whole point of the
+    // wallet having remembered it.
+    if (provider.session && provider.accounts.length > 0) {
+        return {
+            provider: provider,
+            address: provider.accounts[0],
+            chainId: provider.chainId,
+            close,
+        };
+    }
+    // Two waits, and only the first is bounded. The code has to arrive before
+    // anybody can scan it; what happens after is the payer deciding, and a
+    // wallet may sit on that for as long as they like.
+    let issued = false;
+    const handleUri = (uri) => {
+        issued = true;
+        onUri(uri);
+    };
+    provider.on("display_uri", handleUri);
+    const approved = provider.connect();
+    // Nothing rethrows this on its own: it is raced below, and an unhandled
+    // rejection here would be reported before the race reports it.
+    approved.catch(() => undefined);
+    let watchdog;
+    try {
+        await Promise.race([
+            approved,
+            new Promise((_, reject) => {
+                watchdog = setTimeout(() => {
+                    if (!issued) {
+                        reject(new WalletError("The connection code did not arrive. Try again."));
+                    }
+                }, RELAY_TIMEOUT);
+            }),
+        ]);
+    }
+    catch (failure) {
+        await close();
+        throw failure;
+    }
+    finally {
+        clearTimeout(watchdog);
+        provider.removeListener("display_uri", handleUri);
+    }
+    const address = provider.accounts[0];
+    if (!address) {
+        await close();
+        throw new Error("No account was shared by the wallet.");
+    }
+    return {
+        provider: provider,
+        address,
+        chainId: provider.chainId,
+        close,
+    };
+}
+//# sourceMappingURL=walletconnect.js.map

package/dist/walletconnect.js.map

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

package/package.json

@@ -1,6 +1,74 @@
 {
   "name": "@reclack/walletkit",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.0",
+  "description": "Connect a wallet, read an address, read a balance. Framework-free, no wallet SDK, no dependencies.",
+  "license": "MIT",
+  "author": "Reclack",
+  "homepage": "https://github.com/reclack/walletkit#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/reclack/walletkit.git"
+  },
+  "bugs": {
+    "url": "https://github.com/reclack/walletkit/issues"
+  },
+  "type": "module",
+  "sideEffects": [
+    "./dist/element.js",
+    "./src/element/index.ts"
+  ],
+  "keywords": [
+    "wallet",
+    "ethereum",
+    "solana",
+    "eip-1193",
+    "eip-6963",
+    "walletconnect",
+    "stablecoin",
+    "usdc"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./assets/*": "./assets/*",
+    "./package.json": "./package.json",
+    "./element": {
+      "types": "./dist/element/index.d.ts",
+      "default": "./dist/element.js"
+    }
+  },
+  "files": [
+    "dist",
+    "assets",
+    "custom-elements.json",
+    "vscode.html-custom-data.json",
+    "README.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "@walletconnect/ethereum-provider": "2.26.0"
+  },
+  "devDependencies": {
+    "@preact/preset-vite": "^2.10.6",
+    "preact": "^10.29.8",
+    "typescript": "~5.9.3",
+    "uqr": "^0.1.3",
+    "vite": "^8.3.7",
+    "vitest": "^3.2.4"
+  },
+  "customElements": "custom-elements.json",
+  "scripts": {
+    "build": "rm -rf dist && tsc -p tsconfig.build.json && tsc -p tsconfig.element.json && vite build",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run",
+    "playground": "node playground/build.mjs"
+  }
 }