walletpair-sdk 1.0.0

package/dist/types.js

@@ -0,0 +1,31 @@
+/**
+ * WalletPair SDK — shared types and interfaces.
+ *
+ * Multi-chain ready: uses CAIP-2 chain IDs throughout (e.g. "eip155:1").
+ */
+// ---------------------------------------------------------------------------
+// Chain namespace helpers (for future multi-chain)
+// ---------------------------------------------------------------------------
+/** Parse CAIP-2 chain ID into namespace and reference. */
+export function parseChainId(caip2) {
+    const [namespace, reference] = caip2.split(':');
+    if (!namespace || !reference)
+        throw new Error(`Invalid CAIP-2 chain ID: ${caip2}`);
+    return { namespace, reference };
+}
+/** Build CAIP-2 chain ID from namespace and reference. */
+export function formatChainId(namespace, reference) {
+    return `${namespace}:${reference}`;
+}
+/** Convert EVM numeric chain ID to CAIP-2. */
+export function evmChainId(id) {
+    return `eip155:${id}`;
+}
+/** Extract EVM numeric chain ID from CAIP-2. Returns null if not eip155. */
+export function evmNumericChainId(caip2) {
+    const { namespace, reference } = parseChainId(caip2);
+    if (namespace !== 'eip155')
+        return null;
+    return Number.parseInt(reference, 10);
+}
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAkRH,8EAA8E;AAC9E,mDAAmD;AACnD,8EAA8E;AAE9E,0DAA0D;AAC1D,MAAM,UAAU,YAAY,CAAC,KAAa;IACxC,MAAM,CAAC,SAAS,EAAE,SAAS,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;IAC/C,IAAI,CAAC,SAAS,IAAI,CAAC,SAAS;QAAE,MAAM,IAAI,KAAK,CAAC,4BAA4B,KAAK,EAAE,CAAC,CAAA;IAClF,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,CAAA;AACjC,CAAC;AAED,0DAA0D;AAC1D,MAAM,UAAU,aAAa,CAAC,SAAiB,EAAE,SAAiB;IAChE,OAAO,GAAG,SAAS,IAAI,SAAS,EAAE,CAAA;AACpC,CAAC;AAED,8CAA8C;AAC9C,MAAM,UAAU,UAAU,CAAC,EAAU;IACnC,OAAO,UAAU,EAAE,EAAE,CAAA;AACvB,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,iBAAiB,CAAC,KAAa;IAC7C,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,GAAG,YAAY,CAAC,KAAK,CAAC,CAAA;IACpD,IAAI,SAAS,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAA;IACvC,OAAO,MAAM,CAAC,QAAQ,CAAC,SAAS,EAAE,EAAE,CAAC,CAAA;AACvC,CAAC"}

package/dist/wallet-session.d.ts

@@ -0,0 +1,107 @@
+/**
+ * Wallet-side WalletPair session.
+ *
+ * Manages: parse URI → join → connected → handle requests → push events.
+ */
+import { Emitter } from './emitter.js';
+import type { WalletPhase, WalletSessionEvents, WalletSessionOptions } from './types.js';
+export declare class WalletSession extends Emitter<WalletSessionEvents> {
+    phase: WalletPhase;
+    /** Channel ID (hex). Available after join. */
+    channelId: string;
+    /** 4-digit session fingerprint. Available after prepareJoin(). */
+    sessionFingerprint: string;
+    private transport;
+    private capabilities;
+    private meta;
+    private privKey;
+    private pubKeyB64;
+    private remotePubKey;
+    private sessionKey;
+    private sendKey;
+    private recvKey;
+    private sendSeq;
+    private recvSeq;
+    private relayUrl;
+    private dappName;
+    private intentionalClose;
+    private evtCounter;
+    /** dApp-declared method scope from pairing URI (§9.1 / §8.1). */
+    private dappDeclaredMethods;
+    /** dApp-declared chain scope from pairing URI (§9.1 / §8.1). */
+    private dappDeclaredChains;
+    /** Effective capabilities after scope intersection (§8.1). */
+    private effectiveCapabilities;
+    /** Session TTL in ms (§16 rule 16). */
+    private sessionTtl;
+    private sessionTtlTimer;
+    private sessionStartTime;
+    private reconnectTimer;
+    private reconnectAttempt;
+    private pendingRequestRecords;
+    private idempotencyCache;
+    private broadcastResponseCache;
+    private persistence;
+    constructor(options: WalletSessionOptions);
+    /**
+     * Prepare to join a channel by parsing a pairing URI.
+     * Computes local keys and the session fingerprint without connecting.
+     * Returns the 4-digit session fingerprint for user verification.
+     */
+    prepareJoin(uri: string): string;
+    /**
+     * Send the join message after the user has verified the session fingerprint.
+     */
+    confirmJoin(): Promise<void>;
+    /**
+     * Join a channel in one step (convenience method).
+     * Equivalent to prepareJoin() + confirmJoin().
+     */
+    joinFromUri(uri: string): Promise<string>;
+    /** Respond to a request with success. */
+    approve(requestId: string, result: unknown): boolean | Promise<boolean>;
+    /** Respond to a request with rejection. */
+    reject(requestId: string, code?: string, message?: string): boolean | Promise<boolean>;
+    /** Push an event to the dApp. */
+    pushEvent(event: string, data: unknown): boolean | Promise<boolean>;
+    /** Send ping. */
+    ping(): void;
+    /** Gracefully close. */
+    close(reason?: string): void;
+    /** Destroy and release all resources. */
+    destroy(): void;
+    serialize(): string;
+    restore(signed: string): boolean;
+    restoreFromPersistence(): Promise<boolean>;
+    reconnect(): Promise<void>;
+    private handleMessage;
+    private processRequest;
+    private sendResponse;
+    private cacheProcessedResponse;
+    private touchIdempotencyEntry;
+    private evictIdempotencyCache;
+    private evictBroadcastCache;
+    private sendRaw;
+    private sendJoin;
+    private sessionContext;
+    /**
+     * Compute the intersection of wallet capabilities with dApp-declared
+     * scope from the pairing URI (§8.1).
+     */
+    private computeScopeIntersection;
+    private nextSendSeq;
+    private persistSnapshot;
+    private persistSnapshotAsync;
+    private clearPersistence;
+    private observeSend;
+    private persistenceError;
+    private handleTransportClose;
+    private startReconnect;
+    private scheduleReconnect;
+    private doReconnectAttempt;
+    private stopReconnect;
+    private startSessionTtl;
+    private clearSessionTtl;
+    private setPhase;
+}
+//# sourceMappingURL=wallet-session.d.ts.map

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

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