walletpair-sdk 1.0.0

package/dist/evm/wagmi.d.ts

@@ -0,0 +1,118 @@
+/**
+ * Wagmi connector for WalletPair.
+ *
+ * Usage:
+ *   import { walletPair } from 'walletpair-sdk/evm/wagmi'
+ *   import { createConfig } from 'wagmi'
+ *
+ *   const config = createConfig({
+ *     connectors: [
+ *       walletPair({
+ *         relayUrl: 'wss://relay.walletpair.org/v1',
+ *         meta: { name: 'MyDApp', description: 'A dApp', url: 'https://mydapp.com', icon: 'https://mydapp.com/icon.png' },
+ *         onPairingUri: (uri) => { showQrCode(uri) },
+ *         onSessionFingerprint: (fp) => { showFingerprint(fp) },
+ *       }),
+ *     ],
+ *   })
+ */
+import type { Transport } from '../types.js';
+import { WalletPairProvider } from './eip1193.js';
+interface Chain {
+    id: number;
+    name: string;
+    [key: string]: unknown;
+}
+interface ConnectorEventMap {
+    change: {
+        accounts?: readonly string[] | undefined;
+        chainId?: number | undefined;
+    };
+    connect: {
+        accounts: readonly string[];
+        chainId: number;
+    };
+    disconnect: never;
+    error: {
+        error: Error;
+    };
+    message: {
+        type: string;
+        data?: unknown | undefined;
+    };
+}
+interface WagmiEmitter {
+    emit<K extends keyof ConnectorEventMap>(event: K, data: ConnectorEventMap[K]): void;
+    on<K extends keyof ConnectorEventMap>(event: K, handler: (data: ConnectorEventMap[K]) => void): void;
+    off<K extends keyof ConnectorEventMap>(event: K, handler: (data: ConnectorEventMap[K]) => void): void;
+    listenerCount(event: keyof ConnectorEventMap): number;
+}
+interface Storage {
+    getItem(key: string): Promise<string | null>;
+    setItem(key: string, value: string): Promise<void>;
+    removeItem(key: string): Promise<void>;
+}
+interface ConnectorConfig {
+    chains: readonly [Chain, ...Chain[]];
+    emitter: WagmiEmitter;
+    storage?: Storage | null | undefined;
+}
+type CreateConnectorFn = (config: ConnectorConfig) => {
+    id: string;
+    name: string;
+    type: string;
+    icon?: string | undefined;
+    connect(params?: {
+        chainId?: number | undefined;
+        isReconnecting?: boolean | undefined;
+    }): Promise<{
+        accounts: readonly string[];
+        chainId: number;
+    }>;
+    disconnect(): Promise<void>;
+    getAccounts(): Promise<readonly string[]>;
+    getChainId(): Promise<number>;
+    getProvider(params?: {
+        chainId?: number | undefined;
+    }): Promise<WalletPairProvider>;
+    isAuthorized(): Promise<boolean>;
+    onAccountsChanged(accounts: string[]): void;
+    onChainChanged(chainId: string): void;
+    onConnect?(connectInfo: {
+        chainId: string;
+    }): void;
+    onDisconnect(error?: Error | undefined): void;
+    setup?(): Promise<void>;
+    switchChain?(params: {
+        chainId: number;
+    }): Promise<Chain>;
+};
+export interface WalletPairConnectorOptions {
+    /** WebSocket relay URL. Used when `transport` is not provided. */
+    relayUrl?: string | undefined;
+    /** Custom transport instance. Overrides relayUrl when provided. */
+    transport?: Transport | undefined;
+    /** DApp metadata (name, description, url, icon). */
+    meta: {
+        name: string;
+        description: string;
+        url: string;
+        icon: string;
+    };
+    /** Request timeout in ms. */
+    requestTimeout?: number | undefined;
+    /** Called when a pairing URI is generated (display QR code). */
+    onPairingUri?: ((uri: string) => void) | undefined;
+    /** Called when the session fingerprint is ready (display alongside QR). */
+    onSessionFingerprint?: ((fingerprint: string) => void) | undefined;
+    /**
+     * Called after QR is shown but before transport connects (BLE mode).
+     * The returned Promise must resolve when the user is ready to scan.
+     * This gives the wallet time to scan the QR before the BLE device picker opens.
+     * Only relevant when using a custom transport (e.g. WebBleCentralTransport).
+     */
+    onBeforeTransportConnect?: (() => Promise<void>) | undefined;
+}
+export declare function walletPair(options: WalletPairConnectorOptions): CreateConnectorFn;
+export {};
+//# sourceMappingURL=wagmi.d.ts.map

package/dist/evm/wagmi.d.ts.map

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

package/dist/evm/wagmi.js

@@ -0,0 +1,205 @@
+/**
+ * Wagmi connector for WalletPair.
+ *
+ * Usage:
+ *   import { walletPair } from 'walletpair-sdk/evm/wagmi'
+ *   import { createConfig } from 'wagmi'
+ *
+ *   const config = createConfig({
+ *     connectors: [
+ *       walletPair({
+ *         relayUrl: 'wss://relay.walletpair.org/v1',
+ *         meta: { name: 'MyDApp', description: 'A dApp', url: 'https://mydapp.com', icon: 'https://mydapp.com/icon.png' },
+ *         onPairingUri: (uri) => { showQrCode(uri) },
+ *         onSessionFingerprint: (fp) => { showFingerprint(fp) },
+ *       }),
+ *     ],
+ *   })
+ */
+import { DAppSession } from '../dapp-session.js';
+import { evmNumericChainId } from '../types.js';
+import { WebSocketTransport } from '../ws-transport.js';
+import { WalletPairProvider } from './eip1193.js';
+// ---------------------------------------------------------------------------
+// Connector factory
+// ---------------------------------------------------------------------------
+export function walletPair(options) {
+    let session = null;
+    let provider = null;
+    let sessionEventsBound = false;
+    function persistenceFromStorage(storage) {
+        if (!storage)
+            return undefined;
+        return {
+            save: (snapshot) => storage.setItem('walletPair.session', snapshot),
+            load: () => storage.getItem('walletPair.session'),
+            clear: () => storage.removeItem('walletPair.session'),
+        };
+    }
+    function getOrCreateSession(config) {
+        if (!session) {
+            const transport = options.transport ??
+                (() => {
+                    if (!options.relayUrl) {
+                        throw new Error('WalletPair requires either relayUrl or transport');
+                    }
+                    return new WebSocketTransport(options.relayUrl);
+                })();
+            session = new DAppSession({
+                transport,
+                meta: options.meta,
+                requestTimeout: options.requestTimeout,
+                persistence: persistenceFromStorage(config?.storage),
+            });
+        }
+        return session;
+    }
+    function getOrCreateProvider(chainId, config) {
+        if (!provider) {
+            provider = new WalletPairProvider({
+                session: getOrCreateSession(config),
+                chainId,
+            });
+        }
+        return provider;
+    }
+    function bindSessionEvents(config, chainId) {
+        const s = getOrCreateSession(config);
+        if (sessionEventsBound)
+            return;
+        sessionEventsBound = true;
+        // Bridge WalletPair events → wagmi emitter
+        s.on('event', ({ event, data }) => {
+            if (event === 'accountsChanged') {
+                const accts = data?.accounts ?? data;
+                if (Array.isArray(accts)) {
+                    config.emitter.emit('change', { accounts: accts });
+                }
+            }
+            else if (event === 'chainChanged') {
+                const raw = data?.chainId ?? data;
+                let newId;
+                if (typeof raw === 'string' && raw.startsWith('eip155:')) {
+                    newId = evmNumericChainId(raw) ?? chainId;
+                }
+                else if (typeof raw === 'string') {
+                    newId = Number.parseInt(raw, raw.startsWith('0x') ? 16 : 10);
+                }
+                else {
+                    newId = raw;
+                }
+                config.emitter.emit('change', { chainId: newId });
+            }
+        });
+    }
+    async function requestAccountsWhenConnected(s, p) {
+        if (s.phase === 'connected') {
+            return (await p.request({ method: 'eth_requestAccounts' }));
+        }
+        return new Promise((resolve, reject) => {
+            const cleanup = [];
+            cleanup.push(s.on('phase', async (phase) => {
+                if (phase === 'connected') {
+                    try {
+                        const accts = (await p.request({ method: 'eth_requestAccounts' }));
+                        for (const off of cleanup)
+                            off();
+                        resolve(accts);
+                    }
+                    catch (e) {
+                        for (const off of cleanup)
+                            off();
+                        reject(e);
+                    }
+                }
+                else if (phase === 'closed') {
+                    for (const off of cleanup)
+                        off();
+                    reject(new Error('Session closed'));
+                }
+            }));
+        });
+    }
+    return (config) => {
+        return {
+            id: 'walletPair',
+            name: options.meta.name,
+            type: 'walletPair',
+            async connect(params) {
+                const chainId = params?.chainId ?? config.chains[0].id;
+                const s = getOrCreateSession(config);
+                const p = getOrCreateProvider(chainId, config);
+                bindSessionEvents(config, chainId);
+                if (params?.isReconnecting) {
+                    const restored = await s.restoreFromPersistence();
+                    if (!restored)
+                        throw new Error('No persisted WalletPair session');
+                    await s.reconnect();
+                    const accounts = await requestAccountsWhenConnected(s, p);
+                    return { accounts, chainId };
+                }
+                // Start pairing flow
+                // If onBeforeTransportConnect is set (BLE mode), defer transport connection
+                // so the wallet can scan the QR before the BLE device picker opens.
+                const deferTransport = !!options.onBeforeTransportConnect;
+                const uri = await s.createPairing({ deferTransport });
+                options.onPairingUri?.(uri);
+                if (deferTransport && options.onBeforeTransportConnect) {
+                    await options.onBeforeTransportConnect();
+                    await s.connectTransport();
+                }
+                // Emit session fingerprint for display alongside QR
+                options.onSessionFingerprint?.(s.sessionFingerprint);
+                // Wait for wallet to join (auto-accepted after sealed_join verification)
+                const accounts = await requestAccountsWhenConnected(s, p);
+                // DAppSession persists snapshots write-ahead through config.storage.
+                return { accounts, chainId };
+            },
+            async disconnect() {
+                session?.close();
+                session = null;
+                provider = null;
+                sessionEventsBound = false;
+                if (config.storage) {
+                    await config.storage.removeItem('walletPair.session');
+                }
+            },
+            async getAccounts() {
+                return getOrCreateProvider(undefined, config).getAccounts();
+            },
+            async getChainId() {
+                return Number.parseInt(getOrCreateProvider(undefined, config).getChainId(), 16);
+            },
+            async getProvider() {
+                return getOrCreateProvider(undefined, config);
+            },
+            async isAuthorized() {
+                if (!config.storage)
+                    return false;
+                return getOrCreateSession(config).restoreFromPersistence();
+            },
+            onAccountsChanged(accounts) {
+                config.emitter.emit('change', { accounts });
+            },
+            onChainChanged(chainId) {
+                config.emitter.emit('change', { chainId: Number.parseInt(chainId, 16) });
+            },
+            onDisconnect() {
+                config.emitter.emit('disconnect', undefined);
+            },
+            async switchChain(params) {
+                const p = getOrCreateProvider(undefined, config);
+                await p.request({
+                    method: 'wallet_switchEthereumChain',
+                    params: [{ chainId: `0x${params.chainId.toString(16)}` }],
+                });
+                config.emitter.emit('change', { chainId: params.chainId });
+                const chain = config.chains.find((c) => c.id === params.chainId);
+                if (!chain)
+                    throw new Error(`Chain ${params.chainId} not configured`);
+                return chain;
+            },
+        };
+    };
+}
+//# sourceMappingURL=wagmi.js.map

package/dist/evm/wagmi.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,22 @@
+/**
+ * WalletPair SDK — connect dApps and wallets over the WalletPair protocol.
+ *
+ * Main entry point re-exports everything needed for both dApp and wallet sides.
+ *
+ * Subpath exports:
+ *   - walletpair-sdk            Core (this file)
+ *   - walletpair-sdk/evm        EVM: EIP-1193 provider + wagmi connector
+ *   - walletpair-sdk/evm/eip1193  EIP-1193 provider only
+ *   - walletpair-sdk/evm/wagmi    Wagmi connector only
+ *   - walletpair-sdk/ble        BLE transport + framing utilities
+ */
+export type { DirectionalSessionKeys, SessionCryptoContext, X25519KeyPair } from './crypto.js';
+export { b64urlDecode, b64urlEncode, buildPairingUri, bytesToHex, canonicalJson, computeHandshakeTranscriptHash, computeSessionFingerprint, computeSharedSecret, deriveDirectionalSessionKeys, deriveJoinEncryptionKey, deriveSessionKey, generateChannelId, generateX25519KeyPair, getPublicKey, hexToBytes, parsePairingUri, sealJoin, sealPayload, sha256Hex, signSnapshot, unsealJoin, unsealPayload, verifySnapshot, } from './crypto.js';
+export { DAppSession } from './dapp-session.js';
+export { Emitter } from './emitter.js';
+export type { AcceptMessage, Capabilities, CloseMessage, CloseReason, CreateMessage, DAppMeta, DAppPhase, DAppSessionEvents, DAppSessionOptions, EventMessage, JoinMessage, PairingParams, PendingRequest, PingMessage, PongMessage, ProtocolMessage, ProtocolMessageBase, ReadyMessage, RequestMessage, ResponseMessage, SessionPersistence, TerminateMessage, Transport, TransportState, WalletMeta, WalletPhase, WalletSessionEvents, WalletSessionOptions, } from './types.js';
+export { evmChainId, evmNumericChainId, formatChainId, parseChainId, } from './types.js';
+export { WalletSession } from './wallet-session.js';
+export type { WebSocketTransportOptions } from './ws-transport.js';
+export { WebSocketTransport } from './ws-transport.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,YAAY,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAE9F,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,eAAe,EACf,UAAU,EACV,aAAa,EACb,8BAA8B,EAC9B,yBAAyB,EACzB,mBAAmB,EACnB,4BAA4B,EAC5B,uBAAuB,EACvB,gBAAgB,EAChB,iBAAiB,EACjB,qBAAqB,EACrB,YAAY,EACZ,UAAU,EACV,eAAe,EACf,QAAQ,EACR,WAAW,EACX,SAAS,EACT,YAAY,EACZ,UAAU,EACV,aAAa,EACb,cAAc,GACf,MAAM,aAAa,CAAA;AAEpB,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAE/C,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAEtC,YAAY,EACV,aAAa,EACb,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,aAAa,EACb,QAAQ,EACR,SAAS,EACT,iBAAiB,EACjB,kBAAkB,EAClB,YAAY,EACZ,WAAW,EACX,aAAa,EACb,cAAc,EACd,WAAW,EACX,WAAW,EACX,eAAe,EACf,mBAAmB,EACnB,YAAY,EACZ,cAAc,EACd,eAAe,EACf,kBAAkB,EAClB,gBAAgB,EAChB,SAAS,EACT,cAAc,EACd,UAAU,EACV,WAAW,EACX,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,YAAY,CAAA;AAEnB,OAAO,EACL,UAAU,EACV,iBAAiB,EACjB,aAAa,EACb,YAAY,GACb,MAAM,YAAY,CAAA;AACnB,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AACnD,YAAY,EAAE,yBAAyB,EAAE,MAAM,mBAAmB,CAAA;AAElE,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAA"}

package/dist/index.js

@@ -0,0 +1,24 @@
+/**
+ * WalletPair SDK — connect dApps and wallets over the WalletPair protocol.
+ *
+ * Main entry point re-exports everything needed for both dApp and wallet sides.
+ *
+ * Subpath exports:
+ *   - walletpair-sdk            Core (this file)
+ *   - walletpair-sdk/evm        EVM: EIP-1193 provider + wagmi connector
+ *   - walletpair-sdk/evm/eip1193  EIP-1193 provider only
+ *   - walletpair-sdk/evm/wagmi    Wagmi connector only
+ *   - walletpair-sdk/ble        BLE transport + framing utilities
+ */
+// Crypto
+export { b64urlDecode, b64urlEncode, buildPairingUri, bytesToHex, canonicalJson, computeHandshakeTranscriptHash, computeSessionFingerprint, computeSharedSecret, deriveDirectionalSessionKeys, deriveJoinEncryptionKey, deriveSessionKey, generateChannelId, generateX25519KeyPair, getPublicKey, hexToBytes, parsePairingUri, sealJoin, sealPayload, sha256Hex, signSnapshot, unsealJoin, unsealPayload, verifySnapshot, } from './crypto.js';
+// Sessions
+export { DAppSession } from './dapp-session.js';
+// Emitter
+export { Emitter } from './emitter.js';
+// Chain ID helpers (CAIP-2)
+export { evmChainId, evmNumericChainId, formatChainId, parseChainId, } from './types.js';
+export { WalletSession } from './wallet-session.js';
+// Transport
+export { WebSocketTransport } from './ws-transport.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,SAAS;AACT,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,eAAe,EACf,UAAU,EACV,aAAa,EACb,8BAA8B,EAC9B,yBAAyB,EACzB,mBAAmB,EACnB,4BAA4B,EAC5B,uBAAuB,EACvB,gBAAgB,EAChB,iBAAiB,EACjB,qBAAqB,EACrB,YAAY,EACZ,UAAU,EACV,eAAe,EACf,QAAQ,EACR,WAAW,EACX,SAAS,EACT,YAAY,EACZ,UAAU,EACV,aAAa,EACb,cAAc,GACf,MAAM,aAAa,CAAA;AACpB,WAAW;AACX,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAC/C,UAAU;AACV,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAgCtC,4BAA4B;AAC5B,OAAO,EACL,UAAU,EACV,iBAAiB,EACjB,aAAa,EACb,YAAY,GACb,MAAM,YAAY,CAAA;AACnB,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAEnD,YAAY;AACZ,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAA"}

package/dist/types.d.ts

@@ -0,0 +1,225 @@
+/**
+ * WalletPair SDK — shared types and interfaces.
+ *
+ * Multi-chain ready: uses CAIP-2 chain IDs throughout (e.g. "eip155:1").
+ */
+export type TransportState = 'disconnected' | 'connecting' | 'connected';
+export interface Transport {
+    readonly state: TransportState;
+    send(msg: ProtocolMessage): void;
+    connect(): Promise<void>;
+    disconnect(): void;
+    onMessage(handler: (msg: ProtocolMessage) => void): void;
+    onClose(handler: () => void): void;
+    onOpen(handler: () => void): void;
+}
+export interface ProtocolMessageBase {
+    v: 1;
+    t: string;
+    ch: string;
+    ts: number;
+    from: string;
+    body: Record<string, unknown>;
+}
+export interface CreateMessage extends ProtocolMessageBase {
+    t: 'create';
+    body: {
+        meta: DAppMeta;
+    };
+}
+export interface JoinMessage extends ProtocolMessageBase {
+    t: 'join';
+    body: {
+        sealed_join: string | null;
+    };
+}
+export interface AcceptMessage extends ProtocolMessageBase {
+    t: 'accept';
+    body: {
+        target: string;
+    };
+}
+export interface ReadyMessage extends ProtocolMessageBase {
+    t: 'ready';
+    body: {
+        state: 'waiting' | 'connected';
+        role: 'dapp' | 'wallet';
+        self: string;
+        remote: string | null;
+        reconnect: boolean;
+    };
+}
+export interface RequestMessage extends ProtocolMessageBase {
+    t: 'req';
+    body: {
+        id: string;
+        sealed: string;
+    };
+}
+export interface ResponseMessage extends ProtocolMessageBase {
+    t: 'res';
+    body: {
+        id: string;
+        sealed: string;
+    };
+}
+export interface EventMessage extends ProtocolMessageBase {
+    t: 'evt';
+    body: {
+        id: string;
+        sealed: string;
+    };
+}
+export interface PingMessage extends ProtocolMessageBase {
+    t: 'ping';
+    body: Record<string, never>;
+}
+export interface PongMessage extends ProtocolMessageBase {
+    t: 'pong';
+    body: Record<string, never>;
+}
+export interface CloseMessage extends ProtocolMessageBase {
+    t: 'close';
+    body: {
+        reason: CloseReason;
+    };
+}
+export interface TerminateMessage extends ProtocolMessageBase {
+    t: 'terminate';
+    from: '_adapter';
+    body: {
+        reason: CloseReason;
+    };
+}
+export type ProtocolMessage = CreateMessage | JoinMessage | AcceptMessage | ReadyMessage | RequestMessage | ResponseMessage | EventMessage | PingMessage | PongMessage | CloseMessage | TerminateMessage;
+export type CloseReason = 'normal' | 'user_rejected' | 'unsupported_capability' | 'channel_not_found' | 'channel_exists' | 'already_connected' | 'invalid_state' | 'invalid_role' | 'timeout' | 'rate_limited' | 'payload_too_large' | 'protocol_error' | 'unsupported_version' | 'decryption_failed';
+export interface Capabilities {
+    /** Supported RPC methods (e.g. "wallet_getAccounts", "wallet_signMessage"). */
+    methods: string[];
+    /** Supported events (e.g. "accountsChanged", "chainChanged"). */
+    events: string[];
+    /** CAIP-2 chain IDs (e.g. "eip155:1", "solana:mainnet"). */
+    chains: string[];
+    /** Sub-protocol version map (e.g. { evm: 1 }). §8 */
+    version?: Record<string, number> | undefined;
+}
+export interface DAppMeta {
+    name: string;
+    description: string;
+    url: string;
+    icon: string;
+}
+export interface WalletMeta {
+    name: string;
+    description: string;
+    url: string;
+    icon: string;
+    [key: string]: unknown;
+}
+export type DAppPhase = 'idle' | 'waiting' | 'pending_accept' | 'connected' | 'disconnected' | 'closed';
+export type WalletPhase = 'idle' | 'waiting' | 'waiting_accept' | 'connected' | 'disconnected' | 'closed';
+export interface DAppSessionEvents {
+    [key: string]: unknown;
+    phase: DAppPhase;
+    pairingUri: string;
+    sessionFingerprint: string;
+    walletJoined: {
+        capabilities?: Capabilities | undefined;
+        meta?: WalletMeta | undefined;
+    };
+    response: {
+        id: string;
+        ok: boolean;
+        result: unknown;
+    };
+    event: {
+        event: string;
+        data: unknown;
+    };
+    error: Error;
+}
+export interface WalletSessionEvents {
+    [key: string]: unknown;
+    phase: WalletPhase;
+    sessionFingerprint: string;
+    request: {
+        id: string;
+        method: string;
+        params: unknown;
+    };
+    error: Error;
+}
+export interface PairingParams {
+    ch: string;
+    pubkey: string;
+    /** Relay URL. Undefined when using direct transport (BLE). */
+    relay?: string | undefined;
+    name: string;
+    /** DApp website URL. */
+    url: string;
+    /** DApp icon URL. */
+    icon: string;
+    /** Methods the dApp intends to call (§9.1). */
+    methods?: string[] | undefined;
+    /** CAIP-2 chains the dApp intends to use (§9.1). */
+    chains?: string[] | undefined;
+}
+export interface PendingRequest {
+    id: string;
+    method: string;
+    resolve: (result: unknown) => void;
+    reject: (error: Error) => void;
+    timer?: ReturnType<typeof setTimeout>;
+}
+export interface SessionPersistence {
+    /**
+     * Persist a complete serialized session snapshot. Implementations used for
+     * reconnect MUST make this durable before resolving; the SDK calls this
+     * before sending each encrypted message after advancing `sendSeq`.
+     */
+    save(snapshot: string): void | Promise<void>;
+    /** Load the most recent durable snapshot. */
+    load?(): string | null | Promise<string | null>;
+    /** Remove the durable snapshot when the channel closes. */
+    clear?(): void | Promise<void>;
+}
+export interface DAppSessionOptions {
+    transport: Transport;
+    /** DApp metadata (name, description, url, icon). Included in pairing URI and create message. */
+    meta: DAppMeta;
+    /** Methods the dApp intends to call (included in pairing URI §9.1). */
+    methods?: string[] | undefined;
+    /** CAIP-2 chains the dApp intends to use (included in pairing URI §9.1). */
+    chains?: string[] | undefined;
+    /** Request timeout in ms (default 120_000). */
+    requestTimeout?: number | undefined;
+    /** Session lifetime in ms (default 86_400_000 = 24h). §16 rule 16. */
+    sessionTtl?: number | undefined;
+    /** Auto-accept known wallets on rejoin (default true). */
+    autoAccept?: boolean | undefined;
+    /** Durable snapshot persistence for reconnect and write-ahead counters. */
+    persistence?: SessionPersistence | undefined;
+}
+export interface WalletSessionOptions {
+    transport: Transport;
+    /** Wallet capabilities to advertise. */
+    capabilities: Capabilities;
+    /** Wallet metadata (name, description, url, icon). */
+    meta: WalletMeta;
+    /** Session lifetime in ms (default 86_400_000 = 24h). §16 rule 16. */
+    sessionTtl?: number | undefined;
+    /** Durable snapshot persistence for reconnect and write-ahead counters. */
+    persistence?: SessionPersistence | undefined;
+}
+/** Parse CAIP-2 chain ID into namespace and reference. */
+export declare function parseChainId(caip2: string): {
+    namespace: string;
+    reference: string;
+};
+/** Build CAIP-2 chain ID from namespace and reference. */
+export declare function formatChainId(namespace: string, reference: string): string;
+/** Convert EVM numeric chain ID to CAIP-2. */
+export declare function evmChainId(id: number): string;
+/** Extract EVM numeric chain ID from CAIP-2. Returns null if not eip155. */
+export declare function evmNumericChainId(caip2: string): number | null;
+//# sourceMappingURL=types.d.ts.map

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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"}