walletpair-sdk 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025-present 
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,415 @@
+# walletpair-sdk
+
+TypeScript SDK for the [WalletPair Protocol](../walletpair-protocol-v1.md) -- connect dApps and wallets with end-to-end encrypted, relay-based or BLE communication.
+
+## Features
+
+- **Chain-agnostic core** -- uses [CAIP-2](https://github.com/ChainAgnostic/CAIPs/blob/main/CAIPs/caip-2.md) chain IDs (`eip155:1`, `solana:mainnet`), ready for multi-chain
+- **EVM support** -- EIP-1193 provider + wagmi connector (under `walletpair-sdk/evm`)
+- **Transport-agnostic** -- WebSocket relay and Web Bluetooth (BLE) transports included, pluggable `Transport` interface for custom transports
+- **End-to-end encrypted** -- X25519 key exchange + ChaCha20-Poly1305 AEAD, relay never sees payload content
+- **Session snapshots** -- `serialize()` / `restore()` for controlled reconnect flows; production crash recovery requires write-ahead counter persistence
+- **Zero native dependencies** -- pure JS crypto via [noble](https://github.com/paulmillr/noble-curves) libraries
+
+## Architecture
+
+```
+walletpair-sdk
+├── Core (chain-agnostic)
+│   ├── crypto.ts          X25519, HKDF, ChaCha20-Poly1305, seal/unseal
+│   ├── types.ts           Transport interface, CAIP-2 helpers, protocol messages
+│   ├── emitter.ts         Typed event emitter
+│   ├── ws-transport.ts    WebSocket transport (browser/Node/Deno/Bun)
+│   ├── dapp-session.ts    DApp-side session state machine
+│   └── wallet-session.ts  Wallet-side session state machine
+├── BLE (walletpair-sdk/ble)
+│   ├── framing.ts         BLE message fragmentation/reassembly (Section 19.5)
+│   └── web-ble-transport.ts  Web Bluetooth Central transport (runtime detection)
+└── EVM (walletpair-sdk/evm)
+    ├── eip1193.ts         EIP-1193 provider (maps eth_ methods to WalletPair)
+    └── wagmi.ts           wagmi connector factory
+```
+
+### Data Flow
+
+```
+┌──────────┐                              ┌──────────┐
+│   dApp   │                              │  Wallet  │
+│          │                              │          │
+│ DAppSession                        WalletSession  │
+│     │    │                              │    │     │
+│     ▼    │     ┌──────────────┐         │    ▼     │
+│ Transport├────►│ Relay / BLE  │◄────────┤Transport │
+│          │     └──────────────┘         │          │
+└──────────┘     (sees only routing       └──────────┘
+                  metadata -- payloads
+                  are E2E encrypted)
+```
+
+## Install
+
+```bash
+npm install walletpair-sdk
+```
+
+## Quick Start
+
+### DApp Side (Vanilla JS/TS)
+
+```ts
+import { DAppSession, WebSocketTransport } from 'walletpair-sdk'
+
+const transport = new WebSocketTransport('wss://relay.walletpair.org/v1')
+const session = new DAppSession({
+  transport,
+  meta: { name: 'My dApp', description: 'Example dApp', url: 'https://example.com', icon: 'https://example.com/icon.png' },
+})
+
+// 1. Create pairing -- display the URI as a QR code
+const uri = await session.createPairing()
+console.log('Scan this:', uri)
+
+// 2. When wallet joins, show session fingerprint for visual verification
+//    (DApp auto-accepts after sealed_join verification)
+session.on('sessionFingerprint', (fingerprint) => {
+  console.log('Session fingerprint:', fingerprint)
+  // Display to user so they can verify it matches wallet display
+})
+
+// 3. Once connected, send requests
+session.on('phase', async (phase) => {
+  if (phase === 'connected') {
+    const accounts = await session.request('wallet_getAccounts')
+    console.log('Accounts:', accounts)
+  }
+})
+
+// 4. Listen for wallet events
+session.on('event', ({ event, data }) => {
+  console.log(`Event: ${event}`, data)
+})
+```
+
+### Wallet Side (JS/TS / React Native)
+
+```ts
+import { WalletSession, WebSocketTransport } from 'walletpair-sdk'
+
+const transport = new WebSocketTransport('wss://relay.walletpair.org/v1')
+const session = new WalletSession({
+  transport,
+  capabilities: {
+    methods: ['wallet_getAccounts', 'wallet_signMessage'],
+    events: ['accountsChanged', 'chainChanged'],
+    chains: ['eip155:1', 'eip155:137'],
+  },
+  meta: { name: 'My Wallet', description: 'Example Wallet', url: 'https://mywallet.app', icon: 'https://mywallet.app/icon.png' },
+})
+
+// 1. Join from pairing URI (scanned from QR code)
+const fingerprint = await session.joinFromUri(uri)
+console.log('Session fingerprint:', fingerprint) // show to user for visual verification
+
+// 2. Handle incoming requests
+session.on('request', ({ id, method, params }) => {
+  switch (method) {
+    case 'wallet_getAccounts':
+      session.approve(id, ['0xYourAddress'])
+      break
+    case 'wallet_signMessage':
+      // Sign and return, or reject
+      session.approve(id, { signature: '0x...' })
+      // session.reject(id, 'user_rejected', 'User declined')
+      break
+  }
+})
+
+// 3. Push events to dApp
+session.pushEvent('accountsChanged', { accounts: ['0xNewAddress'] })
+```
+
+### EVM dApp with EIP-1193 Provider
+
+```ts
+import { DAppSession, WebSocketTransport } from 'walletpair-sdk'
+import { WalletPairProvider } from 'walletpair-sdk/evm'
+
+const transport = new WebSocketTransport('wss://relay.walletpair.org/v1')
+const session = new DAppSession({
+  transport,
+  meta: { name: 'My dApp', description: 'Example dApp', url: 'https://example.com', icon: 'https://example.com/icon.png' },
+})
+const provider = new WalletPairProvider({ session, chainId: 1 })
+
+// Use like any EIP-1193 provider
+const accounts = await provider.request({ method: 'eth_requestAccounts' })
+const chainId = await provider.request({ method: 'eth_chainId' })
+
+// Standard EIP-1193 events
+provider.on('accountsChanged', (accounts) => { /* ... */ })
+provider.on('chainChanged', (chainId) => { /* ... */ })
+provider.on('disconnect', (error) => { /* ... */ })
+```
+
+### EVM dApp with wagmi
+
+```ts
+import { walletPair } from 'walletpair-sdk/evm/wagmi'
+import { createConfig, http } from 'wagmi'
+import { mainnet, polygon } from 'wagmi/chains'
+
+const config = createConfig({
+  chains: [mainnet, polygon],
+  connectors: [
+    walletPair({
+      relayUrl: 'wss://relay.walletpair.org/v1',
+      meta: { name: 'My dApp', description: 'Example dApp', url: 'https://example.com', icon: 'https://example.com/icon.png' },
+      onPairingUri: (uri) => {
+        // Display QR code with this URI
+        showQrCode(uri)
+      },
+      onSessionFingerprint: (fingerprint) => {
+        // Display session fingerprint for user visual verification
+        showSessionFingerprint(fingerprint)
+      },
+    }),
+  ],
+  transports: {
+    [mainnet.id]: http(),
+    [polygon.id]: http(),
+  },
+})
+```
+
+### BLE Transport (Web Bluetooth)
+
+```ts
+import { DAppSession } from 'walletpair-sdk'
+import { WebBleCentralTransport, isWebBleSupported } from 'walletpair-sdk/ble'
+
+if (isWebBleSupported()) {
+  const transport = new WebBleCentralTransport()
+  const session = new DAppSession({
+    transport,
+    meta: { name: 'My dApp', description: 'Example dApp', url: 'https://example.com', icon: 'https://example.com/icon.png' },
+  })
+
+  // BLE pairing URI has no relay parameter
+  const uri = await session.createPairing()
+  // uri = "walletpair:?ch=...&pubkey=..."
+}
+```
+
+## Session Snapshots
+
+`serialize()` and `restore()` can be used in controlled reconnect flows,
+but they are not enough for production crash recovery by themselves. The
+protocol requires sequence counters to be persisted before every encrypted
+send. A crash after sending but before saving a new snapshot can roll back a
+counter and cause nonce reuse with the same traffic key.
+
+For production, persist `{ traffic_keys, sendSeq, recvSeq }` with a
+write-ahead store before each send, or disable reconnect after process/page
+termination and require fresh pairing.
+
+Demo-only page reload snapshot:
+
+```ts
+// Save before unload
+window.addEventListener('beforeunload', () => {
+  sessionStorage.setItem('wp', session.serialize())
+})
+
+// Restore on load
+const saved = sessionStorage.getItem('wp')
+if (saved && session.restore(saved)) {
+  await session.reconnect()
+}
+```
+
+## API Reference
+
+### Core
+
+#### `DAppSession`
+
+```ts
+new DAppSession({ transport, meta: { name, description, url, icon }, requestTimeout?, autoAccept? })
+```
+
+| Method | Description |
+|--------|-------------|
+| `createPairing(): Promise<string>` | Create channel, returns pairing URI for QR display |
+| `acceptWallet()` | Accept wallet (called automatically after sealed_join verification) |
+| `rejectWallet()` | Reject wallet pairing |
+| `request<T>(method, params?): Promise<T>` | Send encrypted request, returns decrypted response |
+| `ping()` | Send heartbeat ping |
+| `close()` | Gracefully close session |
+| `destroy()` | Close + remove all event listeners |
+| `serialize(): string` | Serialize a session snapshot |
+| `restore(json): boolean` | Restore a session snapshot |
+| `reconnect(): Promise<void>` | Reconnect after restore |
+
+**Events:**
+
+| Event | Payload | Description |
+|-------|---------|-------------|
+| `phase` | `DAppPhase` | State machine transition |
+| `pairingUri` | `string` | Pairing URI generated |
+| `sessionFingerprint` | `string` | Session fingerprint for visual verification |
+| `walletJoined` | `{ pubkey, capabilities?, meta }` | Wallet joined the channel |
+| `response` | `{ id, ok, data }` | Response received |
+| `event` | `{ event, data }` | Wallet pushed an event |
+| `error` | `Error` | Error occurred |
+
+**Phases:** `idle` -> `waiting` -> `pending_accept` -> `connected` -> `closed`
+
+#### `WalletSession`
+
+```ts
+new WalletSession({ transport, capabilities, meta: { name, description, url, icon } })
+```
+
+| Method | Description |
+|--------|-------------|
+| `joinFromUri(uri): Promise<string>` | Join channel, returns session fingerprint |
+| `approve(requestId, result)` | Approve request with encrypted result |
+| `reject(requestId, code?, message?)` | Reject request with error |
+| `pushEvent(event, data)` | Push event to dApp |
+| `ping()` | Send heartbeat ping |
+| `close()` | Gracefully close session |
+| `destroy()` | Close + remove all event listeners |
+| `serialize()` / `restore(json)` | Session snapshot/restore |
+
+**Events:**
+
+| Event | Payload | Description |
+|-------|---------|-------------|
+| `phase` | `WalletPhase` | State machine transition |
+| `sessionFingerprint` | `string` | Session fingerprint for visual verification |
+| `request` | `{ id, method, params }` | Incoming request from dApp |
+| `error` | `Error` | Error occurred |
+
+**Phases:** `idle` -> `waiting` -> `connected` -> `closed`
+
+#### `WebSocketTransport`
+
+```ts
+new WebSocketTransport(url: string)
+new WebSocketTransport({ url: string, protocols?: string[] })
+```
+
+#### Transport Interface
+
+Implement this to create custom transports (e.g., for React Native BLE peripheral):
+
+```ts
+interface Transport {
+  readonly state: 'disconnected' | 'connecting' | 'connected'
+  send(msg: ProtocolMessage): void
+  connect(): Promise<void>
+  disconnect(): void
+  onMessage(handler: (msg: ProtocolMessage) => void): void
+  onClose(handler: () => void): void
+  onOpen(handler: () => void): void
+}
+```
+
+### CAIP-2 Chain ID Helpers
+
+```ts
+import { parseChainId, formatChainId, evmChainId, evmNumericChainId } from 'walletpair-sdk'
+
+parseChainId('eip155:1')           // { namespace: 'eip155', reference: '1' }
+formatChainId('eip155', '137')     // 'eip155:137'
+evmChainId(1)                      // 'eip155:1'
+evmNumericChainId('eip155:1')      // 1
+evmNumericChainId('solana:mainnet') // null
+```
+
+### EVM
+
+#### `WalletPairProvider` (EIP-1193)
+
+```ts
+import { WalletPairProvider } from 'walletpair-sdk/evm'
+
+new WalletPairProvider({ session, chainId?, mapper? })
+```
+
+**Default method mapping:**
+
+| EIP-1193 Method | WalletPair Method |
+|----------------|-------------------|
+| `eth_requestAccounts` | `wallet_getAccounts` |
+| `eth_accounts` | `wallet_getAccounts` |
+| `personal_sign` | `wallet_signMessage` |
+| `eth_signTypedData_v4` | `wallet_signTypedData` |
+| `eth_sendTransaction` | `wallet_signTransaction` |
+| `wallet_switchEthereumChain` | `wallet_switchChain` |
+| `wallet_addEthereumChain` | `wallet_addChain` |
+| `eth_chainId` | Handled locally (returns cached chain ID) |
+| `net_version` | Handled locally (returns cached chain ID) |
+| Others | Passed through as-is |
+
+Override with a custom `MethodMapper` for specialized behavior.
+
+#### `walletPair()` (wagmi connector)
+
+```ts
+import { walletPair } from 'walletpair-sdk/evm/wagmi'
+
+walletPair({
+  relayUrl: string,          // WebSocket relay URL
+  meta: { name, description, url, icon }, // DApp metadata
+  requestTimeout?: number,   // Request timeout in ms
+  onPairingUri?: (uri) => void,            // QR code display callback
+  onSessionFingerprint?: (fingerprint) => void, // Session fingerprint display callback
+})
+```
+
+### BLE
+
+```ts
+import {
+  WebBleCentralTransport,  // Web Bluetooth Central (dApp side)
+  isWebBleSupported,        // Runtime availability check
+  frameMessage,             // Low-level: split JSON into BLE frames
+  Defragmenter,             // Low-level: reassemble BLE frames
+  BLE_SERVICE_UUID,         // WalletPair BLE service UUID
+  BLE_WRITE_CHAR_UUID,      // DApp -> Wallet characteristic
+  BLE_NOTIFY_CHAR_UUID,     // Wallet -> DApp characteristic
+} from 'walletpair-sdk/ble'
+```
+
+## Extending for New Chains
+
+To add support for a new chain (e.g., Solana):
+
+1. Create `src/solana/` directory
+2. Implement a provider that maps Solana RPC methods to WalletPair requests
+3. Add subpath export in `package.json`:
+   ```json
+   { "./solana": "./src/solana/index.ts" }
+   ```
+4. Wallet side: declare Solana chains in capabilities:
+   ```ts
+   capabilities: {
+     methods: ['wallet_signTransaction', 'wallet_signMessage'],
+     chains: ['solana:mainnet', 'solana:devnet'],
+   }
+   ```
+
+The core protocol is chain-agnostic -- `DAppSession.request()` and `WalletSession.approve()` work with any method/params structure.
+
+## Security
+
+- **E2E Encryption**: X25519 ECDH -> HKDF-SHA256 -> ChaCha20-Poly1305 AEAD
+- **MITM Protection**: Session fingerprint derived from SHA256(prefix || channel_id || dapp_pubkey) for visual verification on both devices
+- **Replay Protection**: Sequence-number-based nonces, monotonically increasing
+- **Channel Isolation**: 256-bit random channel IDs
+- **Zero Trust Relay**: Relay sees routing metadata only, never plaintext payloads
+
+## License
+
+MIT

package/dist/ble/framing.d.ts

@@ -0,0 +1,23 @@
+/**
+ * BLE message framing per WalletPair Protocol Section 19.5.
+ *
+ * Frame format: [1 byte flags] [2 bytes total_length BE] [payload fragment]
+ *
+ *   flags bit 0: first fragment
+ *   flags bit 1: last fragment
+ */
+export declare const DEFAULT_FRAME_PAYLOAD = 509;
+export declare const MIN_FRAME_PAYLOAD = 20;
+export declare const BLE_SERVICE_UUID = "e3a10001-7770-4270-8000-000077700001";
+export declare const BLE_WRITE_CHAR_UUID = "e3a10002-7770-4270-8000-000077700001";
+export declare const BLE_NOTIFY_CHAR_UUID = "e3a10003-7770-4270-8000-000077700001";
+/** Split a JSON string into BLE frames. */
+export declare function frameMessage(jsonStr: string, maxPayload?: number): Uint8Array[];
+/** Accumulates BLE frames and emits complete JSON strings. */
+export declare class Defragmenter {
+    private buffer;
+    private offset;
+    push(data: Uint8Array): string | null;
+    reset(): void;
+}
+//# sourceMappingURL=framing.d.ts.map

package/dist/ble/framing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"framing.d.ts","sourceRoot":"","sources":["../../src/ble/framing.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,eAAO,MAAM,qBAAqB,MAAM,CAAC;AACzC,eAAO,MAAM,iBAAiB,KAAK,CAAC;AAEpC,eAAO,MAAM,gBAAgB,yCAAyC,CAAC;AACvE,eAAO,MAAM,mBAAmB,yCAAyC,CAAC;AAC1E,eAAO,MAAM,oBAAoB,yCAAyC,CAAC;AAE3E,2CAA2C;AAC3C,wBAAgB,YAAY,CAC1B,OAAO,EAAE,MAAM,EACf,UAAU,SAAwB,GACjC,UAAU,EAAE,CA6Bd;AAED,8DAA8D;AAC9D,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAA2B;IACzC,OAAO,CAAC,MAAM,CAAK;IAEnB,IAAI,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,GAAG,IAAI;IAoCrC,KAAK,IAAI,IAAI;CAId"}

package/dist/ble/framing.js

@@ -0,0 +1,83 @@
+/**
+ * BLE message framing per WalletPair Protocol Section 19.5.
+ *
+ * Frame format: [1 byte flags] [2 bytes total_length BE] [payload fragment]
+ *
+ *   flags bit 0: first fragment
+ *   flags bit 1: last fragment
+ */
+const FLAG_FIRST = 0x01;
+const FLAG_LAST = 0x02;
+export const DEFAULT_FRAME_PAYLOAD = 509;
+export const MIN_FRAME_PAYLOAD = 20;
+export const BLE_SERVICE_UUID = 'e3a10001-7770-4270-8000-000077700001';
+export const BLE_WRITE_CHAR_UUID = 'e3a10002-7770-4270-8000-000077700001';
+export const BLE_NOTIFY_CHAR_UUID = 'e3a10003-7770-4270-8000-000077700001';
+/** Split a JSON string into BLE frames. */
+export function frameMessage(jsonStr, maxPayload = DEFAULT_FRAME_PAYLOAD) {
+    const payload = new TextEncoder().encode(jsonStr);
+    const frames = [];
+    if (payload.length === 0) {
+        const frame = new Uint8Array(3);
+        frame[0] = FLAG_FIRST | FLAG_LAST;
+        return [frame];
+    }
+    const chunkSize = Math.max(maxPayload, MIN_FRAME_PAYLOAD);
+    for (let offset = 0; offset < payload.length; offset += chunkSize) {
+        const isFirst = offset === 0;
+        const end = Math.min(offset + chunkSize, payload.length);
+        const isLast = end === payload.length;
+        const fragment = payload.subarray(offset, end);
+        const frame = new Uint8Array(3 + fragment.length);
+        frame[0] = (isFirst ? FLAG_FIRST : 0) | (isLast ? FLAG_LAST : 0);
+        if (isFirst) {
+            frame[1] = (payload.length >> 8) & 0xff;
+            frame[2] = payload.length & 0xff;
+        }
+        frame.set(fragment, 3);
+        frames.push(frame);
+    }
+    return frames;
+}
+/** Accumulates BLE frames and emits complete JSON strings. */
+export class Defragmenter {
+    buffer = null;
+    offset = 0;
+    push(data) {
+        if (data.length < 3)
+            return null;
+        const flags = data[0];
+        const isFirst = !!(flags & FLAG_FIRST);
+        const isLast = !!(flags & FLAG_LAST);
+        const fragment = data.subarray(3);
+        if (isFirst) {
+            const totalLength = (data[1] << 8) | data[2];
+            this.buffer = new Uint8Array(totalLength || fragment.length);
+            this.offset = 0;
+        }
+        if (this.buffer) {
+            if (this.offset + fragment.length <= this.buffer.length) {
+                this.buffer.set(fragment, this.offset);
+            }
+            else {
+                const grown = new Uint8Array(this.offset + fragment.length);
+                grown.set(this.buffer.subarray(0, this.offset));
+                grown.set(fragment, this.offset);
+                this.buffer = grown;
+            }
+            this.offset += fragment.length;
+        }
+        if (isLast && this.buffer) {
+            const result = new TextDecoder().decode(this.buffer.subarray(0, this.offset));
+            this.buffer = null;
+            this.offset = 0;
+            return result;
+        }
+        return null;
+    }
+    reset() {
+        this.buffer = null;
+        this.offset = 0;
+    }
+}
+//# sourceMappingURL=framing.js.map

package/dist/ble/framing.js.map

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

package/dist/ble/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * BLE transport exports.
+ *
+ * Re-exports framing utilities and provides the Web Bluetooth Central transport.
+ * Safe to import on any platform — Web Bluetooth availability is checked at runtime.
+ */
+export { frameMessage, Defragmenter, DEFAULT_FRAME_PAYLOAD, MIN_FRAME_PAYLOAD, BLE_SERVICE_UUID, BLE_WRITE_CHAR_UUID, BLE_NOTIFY_CHAR_UUID, } from './framing.js';
+export { WebBleCentralTransport, isWebBleSupported } from './web-ble-transport.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/ble/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ble/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,qBAAqB,EACrB,iBAAiB,EACjB,gBAAgB,EAChB,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/ble/index.js

@@ -0,0 +1,9 @@
+/**
+ * BLE transport exports.
+ *
+ * Re-exports framing utilities and provides the Web Bluetooth Central transport.
+ * Safe to import on any platform — Web Bluetooth availability is checked at runtime.
+ */
+export { frameMessage, Defragmenter, DEFAULT_FRAME_PAYLOAD, MIN_FRAME_PAYLOAD, BLE_SERVICE_UUID, BLE_WRITE_CHAR_UUID, BLE_NOTIFY_CHAR_UUID, } from './framing.js';
+export { WebBleCentralTransport, isWebBleSupported } from './web-ble-transport.js';
+//# sourceMappingURL=index.js.map

package/dist/ble/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/ble/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,qBAAqB,EACrB,iBAAiB,EACjB,gBAAgB,EAChB,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/ble/web-ble-transport.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Web Bluetooth Central transport for dApp side.
+ *
+ * The dApp acts as BLE Central and connects to the wallet's GATT Peripheral.
+ * Safe to import anywhere — checks Web Bluetooth availability at runtime.
+ */
+import type { Transport, TransportState, ProtocolMessage } from '../types.js';
+export declare function isWebBleSupported(): boolean;
+export declare class WebBleCentralTransport implements Transport {
+    state: TransportState;
+    private device;
+    private writeChar;
+    private notifyChar;
+    private defrag;
+    private mtuPayload;
+    private messageHandler;
+    private closeHandler;
+    private openHandler;
+    onMessage(handler: (msg: ProtocolMessage) => void): void;
+    onClose(handler: () => void): void;
+    onOpen(handler: () => void): void;
+    connect(): Promise<void>;
+    send(msg: ProtocolMessage): void;
+    disconnect(): void;
+    private onNotification;
+    private onDisconnect;
+    private cleanup;
+}
+//# sourceMappingURL=web-ble-transport.d.ts.map

package/dist/ble/web-ble-transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-ble-transport.d.ts","sourceRoot":"","sources":["../../src/ble/web-ble-transport.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,SAAS,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAS9E,wBAAgB,iBAAiB,IAAI,OAAO,CAE3C;AAED,qBAAa,sBAAuB,YAAW,SAAS;IACtD,KAAK,EAAE,cAAc,CAAkB;IAEvC,OAAO,CAAC,MAAM,CAAgC;IAC9C,OAAO,CAAC,SAAS,CAAkD;IACnE,OAAO,CAAC,UAAU,CAAkD;IACpE,OAAO,CAAC,MAAM,CAAsB;IACpC,OAAO,CAAC,UAAU,CAAO;IAEzB,OAAO,CAAC,cAAc,CAAiD;IACvE,OAAO,CAAC,YAAY,CAA6B;IACjD,OAAO,CAAC,WAAW,CAA6B;IAEhD,SAAS,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,eAAe,KAAK,IAAI,GAAG,IAAI;IACxD,OAAO,CAAC,OAAO,EAAE,MAAM,IAAI,GAAG,IAAI;IAClC,MAAM,CAAC,OAAO,EAAE,MAAM,IAAI,GAAG,IAAI;IAE3B,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IA+B9B,IAAI,CAAC,GAAG,EAAE,eAAe,GAAG,IAAI;IAUhC,UAAU,IAAI,IAAI;IAOlB,OAAO,CAAC,cAAc,CAQpB;IAEF,OAAO,CAAC,YAAY,CAGlB;IAEF,OAAO,CAAC,OAAO;CAahB"}