@neuraiproject/neurai-sign-esp32 0.3.0 → 0.3.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +20 -0
- package/dist/index.cjs +17 -0
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.ts +21 -1
- package/dist/index.d.ts.map +1 -1
- package/dist/index.mjs +17 -0
- package/dist/index.mjs.map +1 -1
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -18,6 +18,7 @@ This library supports:
|
|
|
18
18
|
- XNA transfers
|
|
19
19
|
- Asset transfers
|
|
20
20
|
- BIP32 account discovery via `get_bip32_pubkey`
|
|
21
|
+
- Message signing (prove address ownership)
|
|
21
22
|
|
|
22
23
|
Asset transfers use the same PSBT signing flow as XNA transfers. The transaction
|
|
23
24
|
outputs are still signed from the raw unsigned transaction, while optional
|
|
@@ -153,6 +154,23 @@ This metadata is especially useful for asset transfers because a standard PSBT
|
|
|
153
154
|
does not expose high-level fields such as `assetName` or `assetAmount` in a
|
|
154
155
|
simple, display-ready form.
|
|
155
156
|
|
|
157
|
+
### Sign a message (prove address ownership)
|
|
158
|
+
|
|
159
|
+
```javascript
|
|
160
|
+
const device = new NeuraiESP32();
|
|
161
|
+
await device.connect();
|
|
162
|
+
|
|
163
|
+
// User must press Confirm on device
|
|
164
|
+
const result = await device.signMessage("Hello, I own this address");
|
|
165
|
+
console.log(result.signature); // base64-encoded recoverable signature
|
|
166
|
+
console.log(result.address); // address that signed the message
|
|
167
|
+
console.log(result.message); // the original message
|
|
168
|
+
```
|
|
169
|
+
|
|
170
|
+
The signature uses the standard Bitcoin message signing format with the
|
|
171
|
+
`"Neurai Signed Message:\n"` prefix. It is compatible with
|
|
172
|
+
`NeuraiMessage.verify()` from the Neurai addon.
|
|
173
|
+
|
|
156
174
|
### Get BIP32 extended public key
|
|
157
175
|
|
|
158
176
|
```javascript
|
|
@@ -223,6 +241,7 @@ using JSON messages. Supported commands:
|
|
|
223
241
|
| `get_address` | Physical button | 30s |
|
|
224
242
|
| `get_bip32_pubkey` | Physical button | 30s |
|
|
225
243
|
| `sign_psbt` | Physical button + TX review | 60s |
|
|
244
|
+
| `sign_message` | Physical button | 30s |
|
|
226
245
|
|
|
227
246
|
## API
|
|
228
247
|
|
|
@@ -239,6 +258,7 @@ Main class for device interaction.
|
|
|
239
258
|
| `getBip32Pubkey()` | Get account xpub (requires confirmation) |
|
|
240
259
|
| `signPsbt(base64)` | Sign a PSBT (requires confirmation) |
|
|
241
260
|
| `signPsbt(base64, display?)` | Sign a PSBT and optionally send display metadata |
|
|
261
|
+
| `signMessage(message)` | Sign a message to prove address ownership (requires confirmation) |
|
|
242
262
|
| `signTransaction(opts)` | Build + sign + finalize in one call |
|
|
243
263
|
|
|
244
264
|
### `buildPSBT(options)`
|
package/dist/index.cjs
CHANGED
|
@@ -631,6 +631,23 @@ class $4f193116bbff8497$export$fa10ee8b91a777b7 {
|
|
|
631
631
|
return response;
|
|
632
632
|
}
|
|
633
633
|
/**
|
|
634
|
+
* Sign a message to prove address ownership.
|
|
635
|
+
* Requires user physical confirmation on the device (30s timeout).
|
|
636
|
+
*
|
|
637
|
+
* The signature is base64-encoded, compatible with Bitcoin/Neurai message
|
|
638
|
+
* signing (recoverable ECDSA with "Neurai Signed Message:\n" prefix).
|
|
639
|
+
*
|
|
640
|
+
* @param message - The message string to sign (max 1024 bytes)
|
|
641
|
+
* @returns Signature (base64), address, and the original message
|
|
642
|
+
*/ async signMessage(message) {
|
|
643
|
+
const response = await this.serial.sendCommand({
|
|
644
|
+
action: "sign_message",
|
|
645
|
+
message: message
|
|
646
|
+
}, 35000);
|
|
647
|
+
this.assertSuccess(response);
|
|
648
|
+
return response;
|
|
649
|
+
}
|
|
650
|
+
/**
|
|
634
651
|
* Send a raw PSBT (base64) to the device for signing.
|
|
635
652
|
* Requires user physical confirmation on the device (60s timeout).
|
|
636
653
|
*
|
package/dist/index.cjs.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"mappings":"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","sources":["src/index.ts","src/NeuraiESP32.ts","src/serial.ts","src/psbt.ts","src/networks.ts","src/display.ts"],"sourcesContent":["/**\n * @neuraiproject/neurai-sign-esp32\n *\n * Library for creating and signing Neurai (XNA) PSBTs\n * via ESP32 hardware wallet (NeuraiHW).\n */\n\n// Main class\nexport { NeuraiESP32 } from \"./NeuraiESP32.js\";\n\n// PSBT utilities\nexport {\n buildPSBT,\n buildPSBTFromRawTransaction,\n finalizePSBT,\n finalizeSignedPSBT,\n validatePSBT,\n} from \"./psbt.js\";\n\n// Display metadata helpers\nexport { buildAssetTransferDisplayMetadata } from \"./display.js\";\n\n// Serial connection (for advanced use)\nexport { SerialConnection } from \"./serial.js\";\n\n// Network configs\nexport {\n getNetwork,\n neuraiMainnet,\n neuraiTestnet,\n neuraiLegacyMainnet,\n neuraiLegacyTestnet,\n} from \"./networks.js\";\n\n// Types\nexport type {\n IUTXO,\n ITxOutput,\n IBuildPSBTOptions,\n IBuildPSBTFromRawOptions,\n IBuildAssetTransferDisplayMetadataOptions,\n IPSBTInputMetadata,\n IAssetTransferDisplayMetadata,\n ISigningDisplayMetadata,\n IDeviceInfo,\n IAddressResponse,\n IBip32PubkeyResponse,\n ISignPsbtResponse,\n IErrorResponse,\n ISerialOptions,\n ISignResult,\n NetworkType,\n} from \"./types.js\";\n","/**\n * NeuraiESP32 — Main class for interacting with a NeuraiHW hardware wallet.\n *\n * Orchestrates:\n * - USB Serial connection via Web Serial API\n * - Device info, address, and BIP32 pubkey retrieval\n * - PSBT creation, signing, and finalization\n *\n * Usage:\n * ```ts\n * const device = new NeuraiESP32();\n * await device.connect();\n * const info = await device.getInfo();\n * const { address, pubkey } = await device.getAddress();\n * const result = await device.signTransaction({ utxos, outputs, changeAddress: address });\n * console.log(result.txHex); // ready to broadcast\n * await device.disconnect();\n * ```\n */\n\nimport { SerialConnection } from \"./serial.js\";\nimport { buildPSBT, finalizeSignedPSBT } from \"./psbt.js\";\nimport type {\n DeviceResponse,\n IAddressResponse,\n IBip32PubkeyResponse,\n IDeviceInfo,\n IErrorResponse,\n ISerialOptions,\n ISigningDisplayMetadata,\n ISignPsbtResponse,\n ISignResult,\n IUTXO,\n ITxOutput,\n NetworkType,\n} from \"./types.js\";\n\nexport class NeuraiESP32 {\n private serial: SerialConnection;\n private deviceInfo: IDeviceInfo | null = null;\n\n constructor(options?: ISerialOptions) {\n this.serial = new SerialConnection(options);\n }\n\n /**\n * Check if Web Serial API is supported in this browser.\n */\n static isSupported(): boolean {\n return SerialConnection.isSupported();\n }\n\n /**\n * Whether the device is currently connected.\n */\n get connected(): boolean {\n return this.serial.connected;\n }\n\n /**\n * Cached device info from the last getInfo() call.\n */\n get info(): IDeviceInfo | null {\n return this.deviceInfo;\n }\n\n // ─── Connection ─────────────────────────────────────────────────────────\n\n /**\n * Connect to the ESP32 hardware wallet.\n * Opens the browser port selection dialog.\n */\n async connect(): Promise<void> {\n await this.serial.open();\n }\n\n /**\n * Disconnect from the device.\n */\n async disconnect(): Promise<void> {\n this.deviceInfo = null;\n await this.serial.close();\n }\n\n // ─── Device commands ────────────────────────────────────────────────────\n\n /**\n * Get device information (no user confirmation needed).\n * Returns device name, version, network, address, pubkey, etc.\n */\n async getInfo(): Promise<IDeviceInfo> {\n const response = await this.serial.sendCommand(\n { action: \"info\" },\n 5000\n );\n\n this.assertSuccess(response);\n this.deviceInfo = response as IDeviceInfo;\n return this.deviceInfo;\n }\n\n /**\n * Request the device address and public key.\n * Requires user physical confirmation on the device (30s timeout).\n */\n async getAddress(): Promise<IAddressResponse> {\n const response = await this.serial.sendCommand(\n { action: \"get_address\" },\n 35000\n );\n\n this.assertSuccess(response);\n return response as IAddressResponse;\n }\n\n /**\n * Request the BIP32 account extended public key (xpub).\n * Requires user physical confirmation on the device (30s timeout).\n */\n async getBip32Pubkey(): Promise<IBip32PubkeyResponse> {\n const response = await this.serial.sendCommand(\n { action: \"get_bip32_pubkey\" },\n 35000\n );\n\n this.assertSuccess(response);\n return response as IBip32PubkeyResponse;\n }\n\n /**\n * Send a raw PSBT (base64) to the device for signing.\n * Requires user physical confirmation on the device (60s timeout).\n *\n * Use this if you build the PSBT yourself.\n */\n async signPsbt(\n psbtBase64: string,\n display?: ISigningDisplayMetadata\n ): Promise<ISignPsbtResponse> {\n const response = await this.serial.sendCommandFinal(\n {\n action: \"sign_psbt\",\n psbt: psbtBase64,\n ...(display ? { display } : {}),\n },\n 65000\n );\n\n this.assertSuccess(response);\n return response as ISignPsbtResponse;\n }\n\n // ─── High-level transaction flow ────────────────────────────────────────\n\n /**\n * Build, sign, and finalize a transaction in one call.\n *\n * This is the main method for sending XNA. It:\n * 1. Builds an unsigned PSBT from the provided UTXOs and outputs\n * 2. Sends it to the ESP32 for signing (user confirms on device)\n * 3. Finalizes the signed PSBT and extracts the raw transaction\n *\n * @param options.network - Network type (default: uses device info)\n * @param options.utxos - UTXOs to spend (must include rawTxHex)\n * @param options.outputs - Destination outputs [{address, value}]\n * @param options.changeAddress - Address for change (typically device address)\n * @param options.pubkey - Compressed public key hex (from getAddress)\n * @param options.masterFingerprint - From getInfo().master_fingerprint\n * @param options.derivationPath - From getAddress().path\n * @param options.feeRate - Fee rate in sat/byte (default: 1024)\n * @returns ISignResult with txHex ready to broadcast\n */\n async signTransaction(options: {\n network?: NetworkType;\n utxos: IUTXO[];\n outputs: ITxOutput[];\n changeAddress: string;\n pubkey?: string;\n masterFingerprint?: string;\n derivationPath?: string;\n feeRate?: number;\n display?: ISigningDisplayMetadata;\n }): Promise<ISignResult> {\n // Use cached device info if available for defaults\n const info = this.deviceInfo;\n\n const network =\n options.network ?? this.inferNetworkType(info);\n const pubkey =\n options.pubkey ?? info?.pubkey;\n const masterFingerprint =\n options.masterFingerprint ?? info?.master_fingerprint;\n const derivationPath =\n options.derivationPath ?? info?.path;\n\n if (!pubkey) {\n throw new Error(\n \"pubkey required. Call getInfo() first or provide it explicitly.\"\n );\n }\n if (!masterFingerprint) {\n throw new Error(\n \"masterFingerprint required. Call getInfo() first or provide it explicitly.\"\n );\n }\n if (!derivationPath) {\n throw new Error(\n \"derivationPath required. Call getInfo() first or provide it explicitly.\"\n );\n }\n\n // 1. Build unsigned PSBT\n const psbtBase64 = buildPSBT({\n network,\n utxos: options.utxos,\n outputs: options.outputs,\n changeAddress: options.changeAddress,\n pubkey,\n masterFingerprint,\n derivationPath,\n feeRate: options.feeRate,\n });\n\n // 2. Send to ESP32 for signing\n const signResponse = await this.signPsbt(psbtBase64, options.display);\n\n // 3. Finalize and extract raw transaction\n const { txHex, txId } = finalizeSignedPSBT(\n psbtBase64,\n signResponse.psbt,\n network\n );\n\n return {\n signedPsbtBase64: signResponse.psbt,\n txHex,\n txId,\n signedInputs: signResponse.signed_inputs,\n };\n }\n\n // ─── Private helpers ────────────────────────────────────────────────────\n\n private assertSuccess(response: DeviceResponse): void {\n if (response.status === \"error\") {\n throw new Error(\n `Device error: ${(response as IErrorResponse).message}`\n );\n }\n }\n\n /**\n * Infer the NetworkType from cached device info.\n */\n private inferNetworkType(info: IDeviceInfo | null): NetworkType {\n if (!info) {\n return \"xna\"; // default\n }\n\n const networkName = info.network?.toLowerCase() ?? \"\";\n const coinType = info.coin_type;\n\n if (networkName.includes(\"test\")) {\n return coinType === 1900 ? \"xna-test\" : \"xna-legacy-test\";\n }\n if (networkName.includes(\"legacy\") || coinType === 0) {\n return \"xna-legacy\";\n }\n return \"xna\";\n }\n}\n","/**\n * Web Serial API communication layer for ESP32 hardware wallet.\n *\n * Handles USB Serial connection, JSON command/response protocol,\n * and line-based buffering matching the NeuraiHW firmware protocol.\n */\n\nimport type { DeviceResponse, ISerialOptions } from \"./types.js\";\n\n// Default USB filters for ESP32 devices\nconst DEFAULT_FILTERS: SerialPortFilter[] = [\n { usbVendorId: 0x303a, usbProductId: 0x1001 }, // ESP32-S3 USB JTAG/Serial\n { usbVendorId: 0x303a }, // Espressif generic\n { usbVendorId: 0x10c4, usbProductId: 0xea60 }, // Silicon Labs CP210x\n { usbVendorId: 0x1a86, usbProductId: 0x7523 }, // CH340\n { usbVendorId: 0x0403, usbProductId: 0x6001 }, // FTDI FT232\n { usbVendorId: 0x067b, usbProductId: 0x2303 }, // Prolific PL2303\n { usbVendorId: 0x2886 }, // Seeed Studio (XIAO)\n];\n\nconst DEFAULT_BAUD_RATE = 115200;\n\nexport class SerialConnection {\n private port: SerialPort | null = null;\n private reader: ReadableStreamDefaultReader<string> | null = null;\n private writer: WritableStreamDefaultWriter<string> | null = null;\n private readableStreamClosed: Promise<void> | null = null;\n private writableStreamClosed: Promise<void> | null = null;\n private isReading = false;\n private responseQueue: DeviceResponse[] = [];\n private baudRate: number;\n private filters: SerialPortFilter[];\n\n constructor(options?: ISerialOptions) {\n this.baudRate = options?.baudRate ?? DEFAULT_BAUD_RATE;\n this.filters = options?.filters ?? DEFAULT_FILTERS;\n }\n\n /**\n * Check if Web Serial API is available.\n */\n static isSupported(): boolean {\n return typeof navigator !== \"undefined\" && \"serial\" in navigator;\n }\n\n /**\n * Open a serial connection to the ESP32.\n * Triggers browser port selection dialog.\n */\n async open(): Promise<void> {\n if (!SerialConnection.isSupported()) {\n throw new Error(\n \"Web Serial API not supported. Use Chrome, Edge, or Opera.\"\n );\n }\n\n this.port = await navigator.serial.requestPort({ filters: this.filters });\n await this.port.open({\n baudRate: this.baudRate,\n dataBits: 8,\n stopBits: 1,\n parity: \"none\",\n flowControl: \"none\",\n bufferSize: 8192,\n });\n\n // Set up readable stream (text decoding)\n const decoder = new TextDecoderStream();\n this.readableStreamClosed = this.port.readable!.pipeTo(decoder.writable as unknown as WritableStream<Uint8Array>);\n this.reader = decoder.readable.getReader();\n\n // Set up writable stream (text encoding)\n const encoder = new TextEncoderStream();\n this.writableStreamClosed = encoder.readable.pipeTo(this.port.writable!);\n this.writer = encoder.writable.getWriter();\n\n // Start background read loop\n this.isReading = true;\n void this.readLoop();\n\n // Give the ESP32 CDC port time to settle after connect/re-enumeration.\n await this.delay(1200);\n this.responseQueue = [];\n }\n\n /**\n * Close the serial connection.\n */\n async close(): Promise<void> {\n this.isReading = false;\n\n if (this.reader) {\n await this.reader.cancel();\n await this.readableStreamClosed?.catch(() => {});\n this.reader = null;\n }\n\n if (this.writer) {\n await this.writer.close();\n await this.writableStreamClosed;\n this.writer = null;\n }\n\n if (this.port) {\n await this.port.close();\n this.port = null;\n }\n\n this.responseQueue = [];\n }\n\n /**\n * Whether the serial port is currently connected.\n */\n get connected(): boolean {\n return this.port !== null && this.writer !== null;\n }\n\n /**\n * Send a JSON command to the device and wait for a JSON response.\n *\n * @param command - The command object (e.g. { action: \"info\" })\n * @param timeoutMs - Response timeout in milliseconds (default: 65000 for sign operations)\n * @returns The parsed device response\n */\n async sendCommand(\n command: Record<string, unknown>,\n timeoutMs = 65000\n ): Promise<DeviceResponse> {\n if (!this.writer) {\n throw new Error(\"Serial port not connected\");\n }\n\n // Clear stale responses\n this.responseQueue = [];\n\n // Send JSON in small chunks, then newline to trigger processing.\n // The ESP32 CDC serial buffer can lose data if sent too fast in one write.\n const json = JSON.stringify(command);\n console.debug(\"[NeuraiESP32 Serial] Sending command\", {\n action: command.action,\n payloadLength: json.length + 1,\n timeoutMs,\n });\n await this.writeChunked(json);\n await this.writer.ready;\n await this.writer.write(\"\\n\");\n\n // Wait for response\n const response = await this.waitForResponse(timeoutMs);\n if (!response) {\n throw new Error(\"Device response timeout\");\n }\n\n return response;\n }\n\n /**\n * Send a command and wait, skipping intermediate \"processing\" status messages.\n * Useful for sign_psbt which sends a processing ACK before the actual response.\n */\n async sendCommandFinal(\n command: Record<string, unknown>,\n timeoutMs = 65000\n ): Promise<DeviceResponse> {\n if (!this.writer) {\n throw new Error(\"Serial port not connected\");\n }\n\n this.responseQueue = [];\n\n const json = JSON.stringify(command);\n console.debug(\"[NeuraiESP32 Serial] Sending command\", {\n action: command.action,\n payloadLength: json.length + 1,\n timeoutMs,\n });\n await this.writeChunked(json);\n await this.writer.ready;\n await this.writer.write(\"\\n\");\n\n // Wait for a non-processing response\n const startTime = Date.now();\n while (Date.now() - startTime < timeoutMs) {\n const response = await this.waitForResponse(\n timeoutMs - (Date.now() - startTime)\n );\n if (!response) {\n throw new Error(\"Device response timeout\");\n }\n // Skip intermediate \"processing\" status\n if (response.status === \"processing\") {\n continue;\n }\n return response;\n }\n\n throw new Error(\"Device response timeout\");\n }\n\n // ─── Private ──────────────────────────────────────────────────────────────\n\n private async readLoop(): Promise<void> {\n let buffer = \"\";\n\n while (this.isReading && this.reader) {\n try {\n const { value, done } = await this.reader.read();\n if (done) break;\n\n buffer += value;\n\n // Process complete lines\n const lines = buffer.split(\"\\n\");\n buffer = lines.pop() ?? \"\"; // Keep incomplete line in buffer\n\n for (const rawLine of lines) {\n const line = rawLine.trim().replace(/\\r/g, \"\");\n if (line.length === 0) continue;\n\n // Try to parse as JSON response\n if (line.startsWith(\"{\")) {\n try {\n const data = JSON.parse(line) as DeviceResponse;\n console.debug(\"[NeuraiESP32 Serial] JSON line received\", data);\n this.responseQueue.push(data);\n } catch {\n console.debug(\"[NeuraiESP32 Serial] Invalid JSON line\", line);\n }\n } else {\n console.debug(\"[NeuraiESP32 Serial] Non-JSON serial line\", line);\n }\n }\n } catch {\n // Read error — connection may have been closed\n break;\n }\n }\n }\n\n private waitForResponse(timeoutMs: number): Promise<DeviceResponse | null> {\n return new Promise((resolve) => {\n const startTime = Date.now();\n const check = () => {\n if (this.responseQueue.length > 0) {\n const response = this.responseQueue.shift()!;\n console.debug(\"[NeuraiESP32 Serial] Response dequeued\", {\n waitedMs: Date.now() - startTime,\n pendingResponses: this.responseQueue.length,\n status: response.status,\n });\n resolve(response);\n } else if (Date.now() - startTime > timeoutMs) {\n console.error(\"[NeuraiESP32 Serial] Response timeout\", {\n timeoutMs,\n queuedResponses: this.responseQueue.length,\n });\n resolve(null);\n } else {\n setTimeout(check, 50);\n }\n };\n check();\n });\n }\n\n /**\n * Write data in small chunks with pauses between them.\n *\n * The ESP32 CDC serial buffer can lose data when the host sends a large\n * payload in a single write. Splitting into 32-byte chunks with a 4 ms\n * pause gives the firmware time to drain its receive buffer.\n */\n private async writeChunked(\n data: string,\n chunkSize = 32,\n pauseMs = 4\n ): Promise<void> {\n if (!this.writer) {\n throw new Error(\"Serial port not connected\");\n }\n\n for (let offset = 0; offset < data.length; offset += chunkSize) {\n const chunk = data.slice(offset, offset + chunkSize);\n await this.writer.ready;\n await this.writer.write(chunk);\n if (offset + chunkSize < data.length) {\n await this.delay(pauseMs);\n }\n }\n }\n\n private delay(ms: number): Promise<void> {\n return new Promise((resolve) => setTimeout(resolve, ms));\n }\n}\n","/**\n * PSBT helpers for Neurai P2PKH transactions.\n *\n * This package supports two build paths:\n * - high-level build from UTXOs + outputs + fee estimation\n * - low-level build from an already-created raw unsigned transaction\n *\n * The second path matches the webwallet integration, where coin selection\n * and fee calculation already happen elsewhere.\n */\n\nimport { Buffer } from \"buffer\";\nimport * as bitcoin from \"bitcoinjs-lib\";\nimport { getNetwork } from \"./networks.js\";\nimport type {\n IBuildPSBTFromRawOptions,\n IBuildPSBTOptions,\n IPSBTInputMetadata,\n NetworkType,\n} from \"./types.js\";\n\nconst DEFAULT_FEE_RATE = 1024; // sat/byte\n\nconst TX_OVERHEAD = 10;\nconst INPUT_SIZE = 148;\nconst OUTPUT_SIZE = 34;\n\nfunction estimateTxSize(inputCount: number, outputCount: number): number {\n return TX_OVERHEAD + inputCount * INPUT_SIZE + outputCount * OUTPUT_SIZE;\n}\n\nfunction parseMasterFingerprint(hex: string): Buffer {\n if (hex.length !== 8) {\n throw new Error(\n `Invalid master fingerprint: expected 8 hex chars, got ${hex.length}`\n );\n }\n return Buffer.from(hex, \"hex\");\n}\n\nexport function buildPSBT(options: IBuildPSBTOptions): string {\n const {\n network,\n utxos,\n outputs,\n changeAddress,\n pubkey,\n masterFingerprint,\n derivationPath,\n feeRate = DEFAULT_FEE_RATE,\n } = options;\n\n if (utxos.length === 0) {\n throw new Error(\"No UTXOs provided\");\n }\n if (outputs.length === 0) {\n throw new Error(\"No outputs provided\");\n }\n\n const totalOutputValue = outputs.reduce((sum, output) => sum + output.value, 0);\n const totalInputValue = utxos.reduce((sum, utxo) => sum + utxo.satoshis, 0);\n const estimatedSize = estimateTxSize(utxos.length, outputs.length + 1);\n const fee = estimatedSize * feeRate;\n const change = totalInputValue - totalOutputValue - fee;\n\n if (change < 0) {\n throw new Error(\n `Insufficient funds: inputs=${totalInputValue}, outputs=${totalOutputValue}, fee=${fee}`\n );\n }\n\n const psbt = new bitcoin.Psbt({ network: getNetwork(network) });\n const bip32Derivation = [\n {\n masterFingerprint: parseMasterFingerprint(masterFingerprint),\n path: derivationPath,\n pubkey: Buffer.from(pubkey, \"hex\"),\n },\n ];\n\n for (const utxo of utxos) {\n psbt.addInput({\n hash: utxo.txid,\n index: utxo.vout,\n nonWitnessUtxo: Buffer.from(utxo.rawTxHex, \"hex\"),\n bip32Derivation,\n });\n }\n\n for (const output of outputs) {\n psbt.addOutput({\n address: output.address,\n value: BigInt(output.value),\n });\n }\n\n const DUST_THRESHOLD = 546;\n if (change >= DUST_THRESHOLD) {\n psbt.addOutput({\n address: changeAddress,\n value: BigInt(change),\n bip32Derivation,\n });\n }\n\n return psbt.toBase64();\n}\n\nexport function buildPSBTFromRawTransaction(options: IBuildPSBTFromRawOptions): string {\n const network = getNetwork(options.network);\n const tx = bitcoin.Transaction.fromHex(options.rawUnsignedTransaction);\n const psbt = new bitcoin.Psbt({ network });\n\n psbt.setVersion(tx.version);\n psbt.setLocktime(tx.locktime);\n\n for (let index = 0; index < tx.ins.length; index += 1) {\n const input = tx.ins[index];\n const metadata = options.inputs[index];\n\n if (!metadata) {\n throw new Error(`Missing input metadata for input #${index}`);\n }\n\n psbt.addInput({\n hash: metadata.txid,\n index: metadata.vout,\n sequence: metadata.sequence ?? input.sequence,\n nonWitnessUtxo: Buffer.from(metadata.rawTxHex, \"hex\"),\n bip32Derivation: [\n {\n masterFingerprint: parseMasterFingerprint(metadata.masterFingerprint),\n path: metadata.derivationPath,\n pubkey: Buffer.from(metadata.pubkey, \"hex\"),\n },\n ],\n });\n }\n\n for (const output of tx.outs) {\n psbt.addOutput({\n script: Buffer.from(output.script),\n value: output.value,\n });\n }\n\n return psbt.toBase64();\n}\n\nexport function finalizePSBT(\n signedPsbtBase64: string,\n network: NetworkType\n): { txHex: string; txId: string } {\n const psbt = bitcoin.Psbt.fromBase64(signedPsbtBase64, {\n network: getNetwork(network),\n });\n\n psbt.finalizeAllInputs();\n\n const tx = psbt.extractTransaction();\n return {\n txHex: tx.toHex(),\n txId: tx.getId(),\n };\n}\n\nexport function finalizeSignedPSBT(\n originalPsbtBase64: string,\n signedPsbtBase64: string,\n network: NetworkType\n): { txHex: string; txId: string } {\n const net = getNetwork(network);\n const psbt = bitcoin.Psbt.fromBase64(originalPsbtBase64, { network: net });\n\n let mergedWithStandardPsbt = false;\n try {\n const signedPsbt = bitcoin.Psbt.fromBase64(signedPsbtBase64, { network: net });\n psbt.combine(signedPsbt);\n mergedWithStandardPsbt = true;\n } catch {\n // uNeurai can return a minimal signed PSBT that bitcoinjs-lib cannot fully parse.\n }\n\n if (!mergedWithStandardPsbt) {\n const partialSigsByInput = extractPartialSigsFromUNeuraiPsbt(\n originalPsbtBase64,\n signedPsbtBase64,\n psbt.inputCount\n );\n\n partialSigsByInput.forEach((partialSig, index) => {\n if (partialSig.length === 0) {\n return;\n }\n psbt.updateInput(index, { partialSig });\n });\n }\n\n try {\n psbt.finalizeAllInputs();\n } catch {\n finalizeLegacyP2pkhInputs(psbt);\n }\n\n const tx = psbt.extractTransaction(true);\n return {\n txHex: tx.toHex(),\n txId: tx.getId(),\n };\n}\n\nexport function validatePSBT(psbtBase64: string, network: NetworkType): boolean {\n try {\n bitcoin.Psbt.fromBase64(psbtBase64, { network: getNetwork(network) });\n return true;\n } catch {\n return false;\n }\n}\n\nfunction extractPartialSigsFromUNeuraiPsbt(\n originalBase64: string,\n signedBase64: string,\n inputCount: number\n) {\n const originalBuffer = Buffer.from(originalBase64, \"base64\");\n const buffer = Buffer.from(signedBase64, \"base64\");\n const partialSigsByInput: { pubkey: Buffer; signature: Buffer }[][] = Array.from(\n { length: inputCount },\n () => []\n );\n\n if (buffer.length < 5 || buffer.toString(\"ascii\", 0, 4) !== \"psbt\" || buffer[4] !== 0xff) {\n throw new Error(\"NeuraiHW returned an invalid PSBT header\");\n }\n\n let offset = getFirstInputSectionOffset(originalBuffer);\n\n for (let inputIndex = 0; inputIndex < inputCount; inputIndex += 1) {\n while (offset < buffer.length) {\n const keyLen = readPsbtVarInt(buffer, offset);\n offset += keyLen.size;\n\n if (keyLen.value === 0) {\n break;\n }\n\n const key = buffer.subarray(offset, offset + keyLen.value);\n offset += keyLen.value;\n\n const valueLen = readPsbtVarInt(buffer, offset);\n offset += valueLen.size;\n const value = buffer.subarray(offset, offset + valueLen.value);\n offset += valueLen.value;\n\n if (key.length > 1 && key[0] === 0x02) {\n partialSigsByInput[inputIndex].push({\n pubkey: Buffer.from(key.subarray(1)),\n signature: Buffer.from(value),\n });\n }\n }\n }\n\n return partialSigsByInput;\n}\n\nfunction getFirstInputSectionOffset(buffer: Buffer) {\n if (buffer.length < 5 || buffer.toString(\"ascii\", 0, 4) !== \"psbt\" || buffer[4] !== 0xff) {\n throw new Error(\"Invalid original PSBT header\");\n }\n\n let offset = 5;\n\n const globalKeyLen = readPsbtVarInt(buffer, offset);\n offset += globalKeyLen.size + globalKeyLen.value;\n\n const globalValueLen = readPsbtVarInt(buffer, offset);\n offset += globalValueLen.size + globalValueLen.value;\n\n if (offset >= buffer.length || buffer[offset] !== 0x00) {\n throw new Error(\"Invalid original PSBT global section\");\n }\n\n return offset + 1;\n}\n\nfunction readPsbtVarInt(buffer: Buffer, offset: number) {\n if (offset >= buffer.length) {\n throw new Error(\"Format Error: Unexpected End of PSBT\");\n }\n\n const first = buffer[offset];\n if (first < 0xfd) {\n return { value: first, size: 1 };\n }\n if (first === 0xfd) {\n if (offset + 2 >= buffer.length) {\n throw new Error(\"Format Error: Unexpected End of PSBT\");\n }\n return { value: buffer.readUInt16LE(offset + 1), size: 3 };\n }\n if (first === 0xfe) {\n if (offset + 4 >= buffer.length) {\n throw new Error(\"Format Error: Unexpected End of PSBT\");\n }\n return { value: buffer.readUInt32LE(offset + 1), size: 5 };\n }\n throw new Error(\"PSBT values larger than 32 bits are not supported\");\n}\n\nfunction finalizeLegacyP2pkhInputs(psbt: bitcoin.Psbt) {\n for (let index = 0; index < psbt.inputCount; index += 1) {\n const input = psbt.data.inputs[index];\n if (input.finalScriptSig || input.finalScriptWitness) {\n continue;\n }\n\n const partialSig = input.partialSig?.[0];\n const nonWitnessUtxo = input.nonWitnessUtxo;\n const txInput = psbt.txInputs[index];\n\n if (!partialSig || !nonWitnessUtxo || !txInput) {\n throw new Error(`Missing data to finalize input #${index}`);\n }\n\n const prevTx = bitcoin.Transaction.fromBuffer(nonWitnessUtxo);\n const prevOut = prevTx.outs[txInput.index];\n if (!prevOut) {\n throw new Error(`Missing prevout to finalize input #${index}`);\n }\n\n psbt.finalizeInput(index, () => ({\n finalScriptSig: bitcoin.script.compile([\n partialSig.signature,\n partialSig.pubkey,\n ]),\n finalScriptWitness: undefined,\n }));\n }\n}\n","/**\n * Neurai network configurations for bitcoinjs-lib\n *\n * Defines all Neurai networks (mainnet, testnet, legacy variants)\n * in the format required by bitcoinjs-lib v7.\n */\n\nimport type { Network } from \"bitcoinjs-lib\";\nimport type { NetworkType } from \"./types.js\";\n\n// ─── Neurai Mainnet (coin type 1900) ────────────────────────────────────────\n\nexport const neuraiMainnet: Network = {\n messagePrefix: \"Neurai Signed Message:\\n\",\n bech32: \"\",\n bip32: {\n public: 76067358,\n private: 76066276,\n },\n pubKeyHash: 53, // 0x35 → prefix \"N\"\n scriptHash: 117, // 0x75\n wif: 128, // 0x80\n};\n\n// ─── Neurai Testnet ──────────────────────────────────────────────────────────\n\nexport const neuraiTestnet: Network = {\n messagePrefix: \"Neurai Signed Message:\\n\",\n bech32: \"\",\n bip32: {\n public: 70617039,\n private: 70615956,\n },\n pubKeyHash: 127, // 0x7f\n scriptHash: 196, // 0xc4\n wif: 239, // 0xef\n};\n\n// ─── Neurai Legacy Mainnet (coin type 0) ─────────────────────────────────────\n\nexport const neuraiLegacyMainnet: Network = {\n messagePrefix: \"Neurai Signed Message:\\n\",\n bech32: \"\",\n bip32: {\n public: 76067358,\n private: 76066276,\n },\n pubKeyHash: 53,\n scriptHash: 117,\n wif: 128,\n};\n\n// ─── Neurai Legacy Testnet ───────────────────────────────────────────────────\n\nexport const neuraiLegacyTestnet: Network = {\n messagePrefix: \"Neurai Signed Message:\\n\",\n bech32: \"\",\n bip32: {\n public: 70617039,\n private: 70615956,\n },\n pubKeyHash: 127,\n scriptHash: 196,\n wif: 239,\n};\n\n// ─── Network map ─────────────────────────────────────────────────────────────\n\nconst networkMap: Record<NetworkType, Network> = {\n xna: neuraiMainnet,\n \"xna-test\": neuraiTestnet,\n \"xna-legacy\": neuraiLegacyMainnet,\n \"xna-legacy-test\": neuraiLegacyTestnet,\n};\n\n/**\n * Get the bitcoinjs-lib Network object for a given Neurai network type.\n */\nexport function getNetwork(network: NetworkType): Network {\n const net = networkMap[network];\n if (!net) {\n throw new Error(`Unknown network: ${network}`);\n }\n return net;\n}\n","import type {\n IAssetTransferDisplayMetadata,\n IBuildAssetTransferDisplayMetadataOptions,\n} from \"./types.js\";\n\nfunction formatAmount(value: number | string): string {\n if (typeof value === \"string\") {\n return value;\n }\n return value.toFixed(8);\n}\n\nexport function buildAssetTransferDisplayMetadata(\n options: IBuildAssetTransferDisplayMetadataOptions\n): IAssetTransferDisplayMetadata {\n return {\n kind: \"asset_transfer\",\n assetName: options.assetName,\n assetAmount: formatAmount(options.assetAmount),\n destinationAddress: options.destinationAddress,\n destinationCount: options.destinationCount ?? 1,\n changeAddress: options.changeAddress,\n changeCount: options.changeCount ?? 0,\n inputAddresses: options.inputAddresses ?? [],\n feeAmount:\n options.feeAmount === undefined ? undefined : formatAmount(options.feeAmount),\n baseCurrency: options.baseCurrency ?? \"XNA\",\n };\n}\n"],"names":[],"version":3,"file":"index.cjs.map"}
|
|
1
|
+
{"mappings":"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","sources":["src/index.ts","src/NeuraiESP32.ts","src/serial.ts","src/psbt.ts","src/networks.ts","src/display.ts"],"sourcesContent":["/**\n * @neuraiproject/neurai-sign-esp32\n *\n * Library for creating and signing Neurai (XNA) PSBTs\n * via ESP32 hardware wallet (NeuraiHW).\n */\n\n// Main class\nexport { NeuraiESP32 } from \"./NeuraiESP32.js\";\n\n// PSBT utilities\nexport {\n buildPSBT,\n buildPSBTFromRawTransaction,\n finalizePSBT,\n finalizeSignedPSBT,\n validatePSBT,\n} from \"./psbt.js\";\n\n// Display metadata helpers\nexport { buildAssetTransferDisplayMetadata } from \"./display.js\";\n\n// Serial connection (for advanced use)\nexport { SerialConnection } from \"./serial.js\";\n\n// Network configs\nexport {\n getNetwork,\n neuraiMainnet,\n neuraiTestnet,\n neuraiLegacyMainnet,\n neuraiLegacyTestnet,\n} from \"./networks.js\";\n\n// Types\nexport type {\n IUTXO,\n ITxOutput,\n IBuildPSBTOptions,\n IBuildPSBTFromRawOptions,\n IBuildAssetTransferDisplayMetadataOptions,\n IPSBTInputMetadata,\n IAssetTransferDisplayMetadata,\n ISigningDisplayMetadata,\n IDeviceInfo,\n IAddressResponse,\n IBip32PubkeyResponse,\n ISignPsbtResponse,\n ISignMessageResponse,\n IErrorResponse,\n ISerialOptions,\n ISignResult,\n NetworkType,\n} from \"./types.js\";\n","/**\n * NeuraiESP32 — Main class for interacting with a NeuraiHW hardware wallet.\n *\n * Orchestrates:\n * - USB Serial connection via Web Serial API\n * - Device info, address, and BIP32 pubkey retrieval\n * - PSBT creation, signing, and finalization\n *\n * Usage:\n * ```ts\n * const device = new NeuraiESP32();\n * await device.connect();\n * const info = await device.getInfo();\n * const { address, pubkey } = await device.getAddress();\n * const result = await device.signTransaction({ utxos, outputs, changeAddress: address });\n * console.log(result.txHex); // ready to broadcast\n * await device.disconnect();\n * ```\n */\n\nimport { SerialConnection } from \"./serial.js\";\nimport { buildPSBT, finalizeSignedPSBT } from \"./psbt.js\";\nimport type {\n DeviceResponse,\n IAddressResponse,\n IBip32PubkeyResponse,\n IDeviceInfo,\n IErrorResponse,\n ISerialOptions,\n ISigningDisplayMetadata,\n ISignMessageResponse,\n ISignPsbtResponse,\n ISignResult,\n IUTXO,\n ITxOutput,\n NetworkType,\n} from \"./types.js\";\n\nexport class NeuraiESP32 {\n private serial: SerialConnection;\n private deviceInfo: IDeviceInfo | null = null;\n\n constructor(options?: ISerialOptions) {\n this.serial = new SerialConnection(options);\n }\n\n /**\n * Check if Web Serial API is supported in this browser.\n */\n static isSupported(): boolean {\n return SerialConnection.isSupported();\n }\n\n /**\n * Whether the device is currently connected.\n */\n get connected(): boolean {\n return this.serial.connected;\n }\n\n /**\n * Cached device info from the last getInfo() call.\n */\n get info(): IDeviceInfo | null {\n return this.deviceInfo;\n }\n\n // ─── Connection ─────────────────────────────────────────────────────────\n\n /**\n * Connect to the ESP32 hardware wallet.\n * Opens the browser port selection dialog.\n */\n async connect(): Promise<void> {\n await this.serial.open();\n }\n\n /**\n * Disconnect from the device.\n */\n async disconnect(): Promise<void> {\n this.deviceInfo = null;\n await this.serial.close();\n }\n\n // ─── Device commands ────────────────────────────────────────────────────\n\n /**\n * Get device information (no user confirmation needed).\n * Returns device name, version, network, address, pubkey, etc.\n */\n async getInfo(): Promise<IDeviceInfo> {\n const response = await this.serial.sendCommand(\n { action: \"info\" },\n 5000\n );\n\n this.assertSuccess(response);\n this.deviceInfo = response as IDeviceInfo;\n return this.deviceInfo;\n }\n\n /**\n * Request the device address and public key.\n * Requires user physical confirmation on the device (30s timeout).\n */\n async getAddress(): Promise<IAddressResponse> {\n const response = await this.serial.sendCommand(\n { action: \"get_address\" },\n 35000\n );\n\n this.assertSuccess(response);\n return response as IAddressResponse;\n }\n\n /**\n * Request the BIP32 account extended public key (xpub).\n * Requires user physical confirmation on the device (30s timeout).\n */\n async getBip32Pubkey(): Promise<IBip32PubkeyResponse> {\n const response = await this.serial.sendCommand(\n { action: \"get_bip32_pubkey\" },\n 35000\n );\n\n this.assertSuccess(response);\n return response as IBip32PubkeyResponse;\n }\n\n /**\n * Sign a message to prove address ownership.\n * Requires user physical confirmation on the device (30s timeout).\n *\n * The signature is base64-encoded, compatible with Bitcoin/Neurai message\n * signing (recoverable ECDSA with \"Neurai Signed Message:\\n\" prefix).\n *\n * @param message - The message string to sign (max 1024 bytes)\n * @returns Signature (base64), address, and the original message\n */\n async signMessage(message: string): Promise<ISignMessageResponse> {\n const response = await this.serial.sendCommand(\n { action: \"sign_message\", message },\n 35000\n );\n\n this.assertSuccess(response);\n return response as ISignMessageResponse;\n }\n\n /**\n * Send a raw PSBT (base64) to the device for signing.\n * Requires user physical confirmation on the device (60s timeout).\n *\n * Use this if you build the PSBT yourself.\n */\n async signPsbt(\n psbtBase64: string,\n display?: ISigningDisplayMetadata\n ): Promise<ISignPsbtResponse> {\n const response = await this.serial.sendCommandFinal(\n {\n action: \"sign_psbt\",\n psbt: psbtBase64,\n ...(display ? { display } : {}),\n },\n 65000\n );\n\n this.assertSuccess(response);\n return response as ISignPsbtResponse;\n }\n\n // ─── High-level transaction flow ────────────────────────────────────────\n\n /**\n * Build, sign, and finalize a transaction in one call.\n *\n * This is the main method for sending XNA. It:\n * 1. Builds an unsigned PSBT from the provided UTXOs and outputs\n * 2. Sends it to the ESP32 for signing (user confirms on device)\n * 3. Finalizes the signed PSBT and extracts the raw transaction\n *\n * @param options.network - Network type (default: uses device info)\n * @param options.utxos - UTXOs to spend (must include rawTxHex)\n * @param options.outputs - Destination outputs [{address, value}]\n * @param options.changeAddress - Address for change (typically device address)\n * @param options.pubkey - Compressed public key hex (from getAddress)\n * @param options.masterFingerprint - From getInfo().master_fingerprint\n * @param options.derivationPath - From getAddress().path\n * @param options.feeRate - Fee rate in sat/byte (default: 1024)\n * @returns ISignResult with txHex ready to broadcast\n */\n async signTransaction(options: {\n network?: NetworkType;\n utxos: IUTXO[];\n outputs: ITxOutput[];\n changeAddress: string;\n pubkey?: string;\n masterFingerprint?: string;\n derivationPath?: string;\n feeRate?: number;\n display?: ISigningDisplayMetadata;\n }): Promise<ISignResult> {\n // Use cached device info if available for defaults\n const info = this.deviceInfo;\n\n const network =\n options.network ?? this.inferNetworkType(info);\n const pubkey =\n options.pubkey ?? info?.pubkey;\n const masterFingerprint =\n options.masterFingerprint ?? info?.master_fingerprint;\n const derivationPath =\n options.derivationPath ?? info?.path;\n\n if (!pubkey) {\n throw new Error(\n \"pubkey required. Call getInfo() first or provide it explicitly.\"\n );\n }\n if (!masterFingerprint) {\n throw new Error(\n \"masterFingerprint required. Call getInfo() first or provide it explicitly.\"\n );\n }\n if (!derivationPath) {\n throw new Error(\n \"derivationPath required. Call getInfo() first or provide it explicitly.\"\n );\n }\n\n // 1. Build unsigned PSBT\n const psbtBase64 = buildPSBT({\n network,\n utxos: options.utxos,\n outputs: options.outputs,\n changeAddress: options.changeAddress,\n pubkey,\n masterFingerprint,\n derivationPath,\n feeRate: options.feeRate,\n });\n\n // 2. Send to ESP32 for signing\n const signResponse = await this.signPsbt(psbtBase64, options.display);\n\n // 3. Finalize and extract raw transaction\n const { txHex, txId } = finalizeSignedPSBT(\n psbtBase64,\n signResponse.psbt,\n network\n );\n\n return {\n signedPsbtBase64: signResponse.psbt,\n txHex,\n txId,\n signedInputs: signResponse.signed_inputs,\n };\n }\n\n // ─── Private helpers ────────────────────────────────────────────────────\n\n private assertSuccess(response: DeviceResponse): void {\n if (response.status === \"error\") {\n throw new Error(\n `Device error: ${(response as IErrorResponse).message}`\n );\n }\n }\n\n /**\n * Infer the NetworkType from cached device info.\n */\n private inferNetworkType(info: IDeviceInfo | null): NetworkType {\n if (!info) {\n return \"xna\"; // default\n }\n\n const networkName = info.network?.toLowerCase() ?? \"\";\n const coinType = info.coin_type;\n\n if (networkName.includes(\"test\")) {\n return coinType === 1900 ? \"xna-test\" : \"xna-legacy-test\";\n }\n if (networkName.includes(\"legacy\") || coinType === 0) {\n return \"xna-legacy\";\n }\n return \"xna\";\n }\n}\n","/**\n * Web Serial API communication layer for ESP32 hardware wallet.\n *\n * Handles USB Serial connection, JSON command/response protocol,\n * and line-based buffering matching the NeuraiHW firmware protocol.\n */\n\nimport type { DeviceResponse, ISerialOptions } from \"./types.js\";\n\n// Default USB filters for ESP32 devices\nconst DEFAULT_FILTERS: SerialPortFilter[] = [\n { usbVendorId: 0x303a, usbProductId: 0x1001 }, // ESP32-S3 USB JTAG/Serial\n { usbVendorId: 0x303a }, // Espressif generic\n { usbVendorId: 0x10c4, usbProductId: 0xea60 }, // Silicon Labs CP210x\n { usbVendorId: 0x1a86, usbProductId: 0x7523 }, // CH340\n { usbVendorId: 0x0403, usbProductId: 0x6001 }, // FTDI FT232\n { usbVendorId: 0x067b, usbProductId: 0x2303 }, // Prolific PL2303\n { usbVendorId: 0x2886 }, // Seeed Studio (XIAO)\n];\n\nconst DEFAULT_BAUD_RATE = 115200;\n\nexport class SerialConnection {\n private port: SerialPort | null = null;\n private reader: ReadableStreamDefaultReader<string> | null = null;\n private writer: WritableStreamDefaultWriter<string> | null = null;\n private readableStreamClosed: Promise<void> | null = null;\n private writableStreamClosed: Promise<void> | null = null;\n private isReading = false;\n private responseQueue: DeviceResponse[] = [];\n private baudRate: number;\n private filters: SerialPortFilter[];\n\n constructor(options?: ISerialOptions) {\n this.baudRate = options?.baudRate ?? DEFAULT_BAUD_RATE;\n this.filters = options?.filters ?? DEFAULT_FILTERS;\n }\n\n /**\n * Check if Web Serial API is available.\n */\n static isSupported(): boolean {\n return typeof navigator !== \"undefined\" && \"serial\" in navigator;\n }\n\n /**\n * Open a serial connection to the ESP32.\n * Triggers browser port selection dialog.\n */\n async open(): Promise<void> {\n if (!SerialConnection.isSupported()) {\n throw new Error(\n \"Web Serial API not supported. Use Chrome, Edge, or Opera.\"\n );\n }\n\n this.port = await navigator.serial.requestPort({ filters: this.filters });\n await this.port.open({\n baudRate: this.baudRate,\n dataBits: 8,\n stopBits: 1,\n parity: \"none\",\n flowControl: \"none\",\n bufferSize: 8192,\n });\n\n // Set up readable stream (text decoding)\n const decoder = new TextDecoderStream();\n this.readableStreamClosed = this.port.readable!.pipeTo(decoder.writable as unknown as WritableStream<Uint8Array>);\n this.reader = decoder.readable.getReader();\n\n // Set up writable stream (text encoding)\n const encoder = new TextEncoderStream();\n this.writableStreamClosed = encoder.readable.pipeTo(this.port.writable!);\n this.writer = encoder.writable.getWriter();\n\n // Start background read loop\n this.isReading = true;\n void this.readLoop();\n\n // Give the ESP32 CDC port time to settle after connect/re-enumeration.\n await this.delay(1200);\n this.responseQueue = [];\n }\n\n /**\n * Close the serial connection.\n */\n async close(): Promise<void> {\n this.isReading = false;\n\n if (this.reader) {\n await this.reader.cancel();\n await this.readableStreamClosed?.catch(() => {});\n this.reader = null;\n }\n\n if (this.writer) {\n await this.writer.close();\n await this.writableStreamClosed;\n this.writer = null;\n }\n\n if (this.port) {\n await this.port.close();\n this.port = null;\n }\n\n this.responseQueue = [];\n }\n\n /**\n * Whether the serial port is currently connected.\n */\n get connected(): boolean {\n return this.port !== null && this.writer !== null;\n }\n\n /**\n * Send a JSON command to the device and wait for a JSON response.\n *\n * @param command - The command object (e.g. { action: \"info\" })\n * @param timeoutMs - Response timeout in milliseconds (default: 65000 for sign operations)\n * @returns The parsed device response\n */\n async sendCommand(\n command: Record<string, unknown>,\n timeoutMs = 65000\n ): Promise<DeviceResponse> {\n if (!this.writer) {\n throw new Error(\"Serial port not connected\");\n }\n\n // Clear stale responses\n this.responseQueue = [];\n\n // Send JSON in small chunks, then newline to trigger processing.\n // The ESP32 CDC serial buffer can lose data if sent too fast in one write.\n const json = JSON.stringify(command);\n console.debug(\"[NeuraiESP32 Serial] Sending command\", {\n action: command.action,\n payloadLength: json.length + 1,\n timeoutMs,\n });\n await this.writeChunked(json);\n await this.writer.ready;\n await this.writer.write(\"\\n\");\n\n // Wait for response\n const response = await this.waitForResponse(timeoutMs);\n if (!response) {\n throw new Error(\"Device response timeout\");\n }\n\n return response;\n }\n\n /**\n * Send a command and wait, skipping intermediate \"processing\" status messages.\n * Useful for sign_psbt which sends a processing ACK before the actual response.\n */\n async sendCommandFinal(\n command: Record<string, unknown>,\n timeoutMs = 65000\n ): Promise<DeviceResponse> {\n if (!this.writer) {\n throw new Error(\"Serial port not connected\");\n }\n\n this.responseQueue = [];\n\n const json = JSON.stringify(command);\n console.debug(\"[NeuraiESP32 Serial] Sending command\", {\n action: command.action,\n payloadLength: json.length + 1,\n timeoutMs,\n });\n await this.writeChunked(json);\n await this.writer.ready;\n await this.writer.write(\"\\n\");\n\n // Wait for a non-processing response\n const startTime = Date.now();\n while (Date.now() - startTime < timeoutMs) {\n const response = await this.waitForResponse(\n timeoutMs - (Date.now() - startTime)\n );\n if (!response) {\n throw new Error(\"Device response timeout\");\n }\n // Skip intermediate \"processing\" status\n if (response.status === \"processing\") {\n continue;\n }\n return response;\n }\n\n throw new Error(\"Device response timeout\");\n }\n\n // ─── Private ──────────────────────────────────────────────────────────────\n\n private async readLoop(): Promise<void> {\n let buffer = \"\";\n\n while (this.isReading && this.reader) {\n try {\n const { value, done } = await this.reader.read();\n if (done) break;\n\n buffer += value;\n\n // Process complete lines\n const lines = buffer.split(\"\\n\");\n buffer = lines.pop() ?? \"\"; // Keep incomplete line in buffer\n\n for (const rawLine of lines) {\n const line = rawLine.trim().replace(/\\r/g, \"\");\n if (line.length === 0) continue;\n\n // Try to parse as JSON response\n if (line.startsWith(\"{\")) {\n try {\n const data = JSON.parse(line) as DeviceResponse;\n console.debug(\"[NeuraiESP32 Serial] JSON line received\", data);\n this.responseQueue.push(data);\n } catch {\n console.debug(\"[NeuraiESP32 Serial] Invalid JSON line\", line);\n }\n } else {\n console.debug(\"[NeuraiESP32 Serial] Non-JSON serial line\", line);\n }\n }\n } catch {\n // Read error — connection may have been closed\n break;\n }\n }\n }\n\n private waitForResponse(timeoutMs: number): Promise<DeviceResponse | null> {\n return new Promise((resolve) => {\n const startTime = Date.now();\n const check = () => {\n if (this.responseQueue.length > 0) {\n const response = this.responseQueue.shift()!;\n console.debug(\"[NeuraiESP32 Serial] Response dequeued\", {\n waitedMs: Date.now() - startTime,\n pendingResponses: this.responseQueue.length,\n status: response.status,\n });\n resolve(response);\n } else if (Date.now() - startTime > timeoutMs) {\n console.error(\"[NeuraiESP32 Serial] Response timeout\", {\n timeoutMs,\n queuedResponses: this.responseQueue.length,\n });\n resolve(null);\n } else {\n setTimeout(check, 50);\n }\n };\n check();\n });\n }\n\n /**\n * Write data in small chunks with pauses between them.\n *\n * The ESP32 CDC serial buffer can lose data when the host sends a large\n * payload in a single write. Splitting into 32-byte chunks with a 4 ms\n * pause gives the firmware time to drain its receive buffer.\n */\n private async writeChunked(\n data: string,\n chunkSize = 32,\n pauseMs = 4\n ): Promise<void> {\n if (!this.writer) {\n throw new Error(\"Serial port not connected\");\n }\n\n for (let offset = 0; offset < data.length; offset += chunkSize) {\n const chunk = data.slice(offset, offset + chunkSize);\n await this.writer.ready;\n await this.writer.write(chunk);\n if (offset + chunkSize < data.length) {\n await this.delay(pauseMs);\n }\n }\n }\n\n private delay(ms: number): Promise<void> {\n return new Promise((resolve) => setTimeout(resolve, ms));\n }\n}\n","/**\n * PSBT helpers for Neurai P2PKH transactions.\n *\n * This package supports two build paths:\n * - high-level build from UTXOs + outputs + fee estimation\n * - low-level build from an already-created raw unsigned transaction\n *\n * The second path matches the webwallet integration, where coin selection\n * and fee calculation already happen elsewhere.\n */\n\nimport { Buffer } from \"buffer\";\nimport * as bitcoin from \"bitcoinjs-lib\";\nimport { getNetwork } from \"./networks.js\";\nimport type {\n IBuildPSBTFromRawOptions,\n IBuildPSBTOptions,\n IPSBTInputMetadata,\n NetworkType,\n} from \"./types.js\";\n\nconst DEFAULT_FEE_RATE = 1024; // sat/byte\n\nconst TX_OVERHEAD = 10;\nconst INPUT_SIZE = 148;\nconst OUTPUT_SIZE = 34;\n\nfunction estimateTxSize(inputCount: number, outputCount: number): number {\n return TX_OVERHEAD + inputCount * INPUT_SIZE + outputCount * OUTPUT_SIZE;\n}\n\nfunction parseMasterFingerprint(hex: string): Buffer {\n if (hex.length !== 8) {\n throw new Error(\n `Invalid master fingerprint: expected 8 hex chars, got ${hex.length}`\n );\n }\n return Buffer.from(hex, \"hex\");\n}\n\nexport function buildPSBT(options: IBuildPSBTOptions): string {\n const {\n network,\n utxos,\n outputs,\n changeAddress,\n pubkey,\n masterFingerprint,\n derivationPath,\n feeRate = DEFAULT_FEE_RATE,\n } = options;\n\n if (utxos.length === 0) {\n throw new Error(\"No UTXOs provided\");\n }\n if (outputs.length === 0) {\n throw new Error(\"No outputs provided\");\n }\n\n const totalOutputValue = outputs.reduce((sum, output) => sum + output.value, 0);\n const totalInputValue = utxos.reduce((sum, utxo) => sum + utxo.satoshis, 0);\n const estimatedSize = estimateTxSize(utxos.length, outputs.length + 1);\n const fee = estimatedSize * feeRate;\n const change = totalInputValue - totalOutputValue - fee;\n\n if (change < 0) {\n throw new Error(\n `Insufficient funds: inputs=${totalInputValue}, outputs=${totalOutputValue}, fee=${fee}`\n );\n }\n\n const psbt = new bitcoin.Psbt({ network: getNetwork(network) });\n const bip32Derivation = [\n {\n masterFingerprint: parseMasterFingerprint(masterFingerprint),\n path: derivationPath,\n pubkey: Buffer.from(pubkey, \"hex\"),\n },\n ];\n\n for (const utxo of utxos) {\n psbt.addInput({\n hash: utxo.txid,\n index: utxo.vout,\n nonWitnessUtxo: Buffer.from(utxo.rawTxHex, \"hex\"),\n bip32Derivation,\n });\n }\n\n for (const output of outputs) {\n psbt.addOutput({\n address: output.address,\n value: BigInt(output.value),\n });\n }\n\n const DUST_THRESHOLD = 546;\n if (change >= DUST_THRESHOLD) {\n psbt.addOutput({\n address: changeAddress,\n value: BigInt(change),\n bip32Derivation,\n });\n }\n\n return psbt.toBase64();\n}\n\nexport function buildPSBTFromRawTransaction(options: IBuildPSBTFromRawOptions): string {\n const network = getNetwork(options.network);\n const tx = bitcoin.Transaction.fromHex(options.rawUnsignedTransaction);\n const psbt = new bitcoin.Psbt({ network });\n\n psbt.setVersion(tx.version);\n psbt.setLocktime(tx.locktime);\n\n for (let index = 0; index < tx.ins.length; index += 1) {\n const input = tx.ins[index];\n const metadata = options.inputs[index];\n\n if (!metadata) {\n throw new Error(`Missing input metadata for input #${index}`);\n }\n\n psbt.addInput({\n hash: metadata.txid,\n index: metadata.vout,\n sequence: metadata.sequence ?? input.sequence,\n nonWitnessUtxo: Buffer.from(metadata.rawTxHex, \"hex\"),\n bip32Derivation: [\n {\n masterFingerprint: parseMasterFingerprint(metadata.masterFingerprint),\n path: metadata.derivationPath,\n pubkey: Buffer.from(metadata.pubkey, \"hex\"),\n },\n ],\n });\n }\n\n for (const output of tx.outs) {\n psbt.addOutput({\n script: Buffer.from(output.script),\n value: output.value,\n });\n }\n\n return psbt.toBase64();\n}\n\nexport function finalizePSBT(\n signedPsbtBase64: string,\n network: NetworkType\n): { txHex: string; txId: string } {\n const psbt = bitcoin.Psbt.fromBase64(signedPsbtBase64, {\n network: getNetwork(network),\n });\n\n psbt.finalizeAllInputs();\n\n const tx = psbt.extractTransaction();\n return {\n txHex: tx.toHex(),\n txId: tx.getId(),\n };\n}\n\nexport function finalizeSignedPSBT(\n originalPsbtBase64: string,\n signedPsbtBase64: string,\n network: NetworkType\n): { txHex: string; txId: string } {\n const net = getNetwork(network);\n const psbt = bitcoin.Psbt.fromBase64(originalPsbtBase64, { network: net });\n\n let mergedWithStandardPsbt = false;\n try {\n const signedPsbt = bitcoin.Psbt.fromBase64(signedPsbtBase64, { network: net });\n psbt.combine(signedPsbt);\n mergedWithStandardPsbt = true;\n } catch {\n // uNeurai can return a minimal signed PSBT that bitcoinjs-lib cannot fully parse.\n }\n\n if (!mergedWithStandardPsbt) {\n const partialSigsByInput = extractPartialSigsFromUNeuraiPsbt(\n originalPsbtBase64,\n signedPsbtBase64,\n psbt.inputCount\n );\n\n partialSigsByInput.forEach((partialSig, index) => {\n if (partialSig.length === 0) {\n return;\n }\n psbt.updateInput(index, { partialSig });\n });\n }\n\n try {\n psbt.finalizeAllInputs();\n } catch {\n finalizeLegacyP2pkhInputs(psbt);\n }\n\n const tx = psbt.extractTransaction(true);\n return {\n txHex: tx.toHex(),\n txId: tx.getId(),\n };\n}\n\nexport function validatePSBT(psbtBase64: string, network: NetworkType): boolean {\n try {\n bitcoin.Psbt.fromBase64(psbtBase64, { network: getNetwork(network) });\n return true;\n } catch {\n return false;\n }\n}\n\nfunction extractPartialSigsFromUNeuraiPsbt(\n originalBase64: string,\n signedBase64: string,\n inputCount: number\n) {\n const originalBuffer = Buffer.from(originalBase64, \"base64\");\n const buffer = Buffer.from(signedBase64, \"base64\");\n const partialSigsByInput: { pubkey: Buffer; signature: Buffer }[][] = Array.from(\n { length: inputCount },\n () => []\n );\n\n if (buffer.length < 5 || buffer.toString(\"ascii\", 0, 4) !== \"psbt\" || buffer[4] !== 0xff) {\n throw new Error(\"NeuraiHW returned an invalid PSBT header\");\n }\n\n let offset = getFirstInputSectionOffset(originalBuffer);\n\n for (let inputIndex = 0; inputIndex < inputCount; inputIndex += 1) {\n while (offset < buffer.length) {\n const keyLen = readPsbtVarInt(buffer, offset);\n offset += keyLen.size;\n\n if (keyLen.value === 0) {\n break;\n }\n\n const key = buffer.subarray(offset, offset + keyLen.value);\n offset += keyLen.value;\n\n const valueLen = readPsbtVarInt(buffer, offset);\n offset += valueLen.size;\n const value = buffer.subarray(offset, offset + valueLen.value);\n offset += valueLen.value;\n\n if (key.length > 1 && key[0] === 0x02) {\n partialSigsByInput[inputIndex].push({\n pubkey: Buffer.from(key.subarray(1)),\n signature: Buffer.from(value),\n });\n }\n }\n }\n\n return partialSigsByInput;\n}\n\nfunction getFirstInputSectionOffset(buffer: Buffer) {\n if (buffer.length < 5 || buffer.toString(\"ascii\", 0, 4) !== \"psbt\" || buffer[4] !== 0xff) {\n throw new Error(\"Invalid original PSBT header\");\n }\n\n let offset = 5;\n\n const globalKeyLen = readPsbtVarInt(buffer, offset);\n offset += globalKeyLen.size + globalKeyLen.value;\n\n const globalValueLen = readPsbtVarInt(buffer, offset);\n offset += globalValueLen.size + globalValueLen.value;\n\n if (offset >= buffer.length || buffer[offset] !== 0x00) {\n throw new Error(\"Invalid original PSBT global section\");\n }\n\n return offset + 1;\n}\n\nfunction readPsbtVarInt(buffer: Buffer, offset: number) {\n if (offset >= buffer.length) {\n throw new Error(\"Format Error: Unexpected End of PSBT\");\n }\n\n const first = buffer[offset];\n if (first < 0xfd) {\n return { value: first, size: 1 };\n }\n if (first === 0xfd) {\n if (offset + 2 >= buffer.length) {\n throw new Error(\"Format Error: Unexpected End of PSBT\");\n }\n return { value: buffer.readUInt16LE(offset + 1), size: 3 };\n }\n if (first === 0xfe) {\n if (offset + 4 >= buffer.length) {\n throw new Error(\"Format Error: Unexpected End of PSBT\");\n }\n return { value: buffer.readUInt32LE(offset + 1), size: 5 };\n }\n throw new Error(\"PSBT values larger than 32 bits are not supported\");\n}\n\nfunction finalizeLegacyP2pkhInputs(psbt: bitcoin.Psbt) {\n for (let index = 0; index < psbt.inputCount; index += 1) {\n const input = psbt.data.inputs[index];\n if (input.finalScriptSig || input.finalScriptWitness) {\n continue;\n }\n\n const partialSig = input.partialSig?.[0];\n const nonWitnessUtxo = input.nonWitnessUtxo;\n const txInput = psbt.txInputs[index];\n\n if (!partialSig || !nonWitnessUtxo || !txInput) {\n throw new Error(`Missing data to finalize input #${index}`);\n }\n\n const prevTx = bitcoin.Transaction.fromBuffer(nonWitnessUtxo);\n const prevOut = prevTx.outs[txInput.index];\n if (!prevOut) {\n throw new Error(`Missing prevout to finalize input #${index}`);\n }\n\n psbt.finalizeInput(index, () => ({\n finalScriptSig: bitcoin.script.compile([\n partialSig.signature,\n partialSig.pubkey,\n ]),\n finalScriptWitness: undefined,\n }));\n }\n}\n","/**\n * Neurai network configurations for bitcoinjs-lib\n *\n * Defines all Neurai networks (mainnet, testnet, legacy variants)\n * in the format required by bitcoinjs-lib v7.\n */\n\nimport type { Network } from \"bitcoinjs-lib\";\nimport type { NetworkType } from \"./types.js\";\n\n// ─── Neurai Mainnet (coin type 1900) ────────────────────────────────────────\n\nexport const neuraiMainnet: Network = {\n messagePrefix: \"Neurai Signed Message:\\n\",\n bech32: \"\",\n bip32: {\n public: 76067358,\n private: 76066276,\n },\n pubKeyHash: 53, // 0x35 → prefix \"N\"\n scriptHash: 117, // 0x75\n wif: 128, // 0x80\n};\n\n// ─── Neurai Testnet ──────────────────────────────────────────────────────────\n\nexport const neuraiTestnet: Network = {\n messagePrefix: \"Neurai Signed Message:\\n\",\n bech32: \"\",\n bip32: {\n public: 70617039,\n private: 70615956,\n },\n pubKeyHash: 127, // 0x7f\n scriptHash: 196, // 0xc4\n wif: 239, // 0xef\n};\n\n// ─── Neurai Legacy Mainnet (coin type 0) ─────────────────────────────────────\n\nexport const neuraiLegacyMainnet: Network = {\n messagePrefix: \"Neurai Signed Message:\\n\",\n bech32: \"\",\n bip32: {\n public: 76067358,\n private: 76066276,\n },\n pubKeyHash: 53,\n scriptHash: 117,\n wif: 128,\n};\n\n// ─── Neurai Legacy Testnet ───────────────────────────────────────────────────\n\nexport const neuraiLegacyTestnet: Network = {\n messagePrefix: \"Neurai Signed Message:\\n\",\n bech32: \"\",\n bip32: {\n public: 70617039,\n private: 70615956,\n },\n pubKeyHash: 127,\n scriptHash: 196,\n wif: 239,\n};\n\n// ─── Network map ─────────────────────────────────────────────────────────────\n\nconst networkMap: Record<NetworkType, Network> = {\n xna: neuraiMainnet,\n \"xna-test\": neuraiTestnet,\n \"xna-legacy\": neuraiLegacyMainnet,\n \"xna-legacy-test\": neuraiLegacyTestnet,\n};\n\n/**\n * Get the bitcoinjs-lib Network object for a given Neurai network type.\n */\nexport function getNetwork(network: NetworkType): Network {\n const net = networkMap[network];\n if (!net) {\n throw new Error(`Unknown network: ${network}`);\n }\n return net;\n}\n","import type {\n IAssetTransferDisplayMetadata,\n IBuildAssetTransferDisplayMetadataOptions,\n} from \"./types.js\";\n\nfunction formatAmount(value: number | string): string {\n if (typeof value === \"string\") {\n return value;\n }\n return value.toFixed(8);\n}\n\nexport function buildAssetTransferDisplayMetadata(\n options: IBuildAssetTransferDisplayMetadataOptions\n): IAssetTransferDisplayMetadata {\n return {\n kind: \"asset_transfer\",\n assetName: options.assetName,\n assetAmount: formatAmount(options.assetAmount),\n destinationAddress: options.destinationAddress,\n destinationCount: options.destinationCount ?? 1,\n changeAddress: options.changeAddress,\n changeCount: options.changeCount ?? 0,\n inputAddresses: options.inputAddresses ?? [],\n feeAmount:\n options.feeAmount === undefined ? undefined : formatAmount(options.feeAmount),\n baseCurrency: options.baseCurrency ?? \"XNA\",\n };\n}\n"],"names":[],"version":3,"file":"index.cjs.map"}
|
package/dist/index.d.ts
CHANGED
|
@@ -106,6 +106,15 @@ export interface ISignPsbtResponse {
|
|
|
106
106
|
psbt: string;
|
|
107
107
|
signed_inputs: number;
|
|
108
108
|
}
|
|
109
|
+
export interface ISignMessageResponse {
|
|
110
|
+
status: string;
|
|
111
|
+
/** Base64-encoded recoverable signature (65 bytes) */
|
|
112
|
+
signature: string;
|
|
113
|
+
/** Address that signed the message */
|
|
114
|
+
address: string;
|
|
115
|
+
/** The original message that was signed */
|
|
116
|
+
message: string;
|
|
117
|
+
}
|
|
109
118
|
export interface IErrorResponse {
|
|
110
119
|
status: "error";
|
|
111
120
|
message: string;
|
|
@@ -114,7 +123,7 @@ interface IProcessingResponse {
|
|
|
114
123
|
status: "processing";
|
|
115
124
|
stage: string;
|
|
116
125
|
}
|
|
117
|
-
type DeviceResponse = IDeviceInfo | IAddressResponse | IBip32PubkeyResponse | ISignPsbtResponse | IErrorResponse | IProcessingResponse;
|
|
126
|
+
type DeviceResponse = IDeviceInfo | IAddressResponse | IBip32PubkeyResponse | ISignPsbtResponse | ISignMessageResponse | IErrorResponse | IProcessingResponse;
|
|
118
127
|
export interface ISerialOptions {
|
|
119
128
|
/** Baud rate (default: 115200) */
|
|
120
129
|
baudRate?: number;
|
|
@@ -222,6 +231,17 @@ export class NeuraiESP32 {
|
|
|
222
231
|
* Requires user physical confirmation on the device (30s timeout).
|
|
223
232
|
*/
|
|
224
233
|
getBip32Pubkey(): Promise<IBip32PubkeyResponse>;
|
|
234
|
+
/**
|
|
235
|
+
* Sign a message to prove address ownership.
|
|
236
|
+
* Requires user physical confirmation on the device (30s timeout).
|
|
237
|
+
*
|
|
238
|
+
* The signature is base64-encoded, compatible with Bitcoin/Neurai message
|
|
239
|
+
* signing (recoverable ECDSA with "Neurai Signed Message:\n" prefix).
|
|
240
|
+
*
|
|
241
|
+
* @param message - The message string to sign (max 1024 bytes)
|
|
242
|
+
* @returns Signature (base64), address, and the original message
|
|
243
|
+
*/
|
|
244
|
+
signMessage(message: string): Promise<ISignMessageResponse>;
|
|
225
245
|
/**
|
|
226
246
|
* Send a raw PSBT (base64) to the device for signing.
|
|
227
247
|
* Requires user physical confirmation on the device (60s timeout).
|
package/dist/index.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"mappings":";AAAA;;GAEG;AAIH;IACE,qBAAqB;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,sCAAsC;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,uBAAuB;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,wBAAwB;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,mEAAmE;IACnE,QAAQ,EAAE,MAAM,CAAC;CAClB;AAID;IACE,0BAA0B;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,wBAAwB;IACxB,KAAK,EAAE,MAAM,CAAC;CACf;AAID;IACE,qEAAqE;IACrE,OAAO,EAAE,WAAW,CAAC;IACrB,qBAAqB;IACrB,KAAK,EAAE,KAAK,EAAE,CAAC;IACf,6CAA6C;IAC7C,OAAO,EAAE,SAAS,EAAE,CAAC;IACrB,sCAAsC;IACtC,aAAa,EAAE,MAAM,CAAC;IACtB,8CAA8C;IAC9C,MAAM,EAAE,MAAM,CAAC;IACf,gDAAgD;IAChD,iBAAiB,EAAE,MAAM,CAAC;IAC1B,uDAAuD;IACvD,cAAc,EAAE,MAAM,CAAC;IACvB,oDAAoD;IACpD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;IACE,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,iBAAiB,EAAE,MAAM,CAAC;IAC1B,cAAc,EAAE,MAAM,CAAC;CACxB;AAED;IACE,IAAI,EAAE,gBAAgB,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,sCAAsC,6BAA6B,CAAC;AAEpE;IACE,OAAO,EAAE,WAAW,CAAC;IACrB,sBAAsB,EAAE,MAAM,CAAC;IAC/B,MAAM,EAAE,kBAAkB,EAAE,CAAC;IAC7B,OAAO,CAAC,EAAE,uBAAuB,CAAC;CACnC;AAED;IACE,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,GAAG,MAAM,CAAC;IAC7B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC5B,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAID;IACE,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;IACE,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd;AAED;IACE,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,IAAI,EAAE,MAAM,CAAC;CACd;AAED;IACE,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;IACE,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;IACE,MAAM,EAAE,YAAY,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,sBACI,WAAW,GACX,gBAAgB,GAChB,oBAAoB,GACpB,iBAAiB,GACjB,cAAc,GACd,mBAAmB,CAAC;AAIxB;IACE,kCAAkC;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oDAAoD;IACpD,OAAO,CAAC,EAAE,gBAAgB,EAAE,CAAC;CAC9B;AAID,0BAA0B,KAAK,GAAG,UAAU,GAAG,YAAY,GAAG,iBAAiB,CAAC;AAIhF;IACE,4BAA4B;IAC5B,gBAAgB,EAAE,MAAM,CAAC;IACzB,wDAAwD;IACxD,KAAK,EAAE,MAAM,CAAC;IACd,qBAAqB;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,4CAA4C;IAC5C,YAAY,EAAE,MAAM,CAAC;CACtB;
|
|
1
|
+
{"mappings":"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","sources":["src/src/types.ts","src/src/serial.ts","src/src/networks.ts","src/src/psbt.ts","src/src/NeuraiESP32.ts","src/src/display.ts","src/src/index.ts","src/index.ts"],"sourcesContent":[null,null,null,null,null,null,null,"/**\n * @neuraiproject/neurai-sign-esp32\n *\n * Library for creating and signing Neurai (XNA) PSBTs\n * via ESP32 hardware wallet (NeuraiHW).\n */\n\n// Main class\nexport { NeuraiESP32 } from \"./NeuraiESP32.js\";\n\n// PSBT utilities\nexport {\n buildPSBT,\n buildPSBTFromRawTransaction,\n finalizePSBT,\n finalizeSignedPSBT,\n validatePSBT,\n} from \"./psbt.js\";\n\n// Display metadata helpers\nexport { buildAssetTransferDisplayMetadata } from \"./display.js\";\n\n// Serial connection (for advanced use)\nexport { SerialConnection } from \"./serial.js\";\n\n// Network configs\nexport {\n getNetwork,\n neuraiMainnet,\n neuraiTestnet,\n neuraiLegacyMainnet,\n neuraiLegacyTestnet,\n} from \"./networks.js\";\n\n// Types\nexport type {\n IUTXO,\n ITxOutput,\n IBuildPSBTOptions,\n IBuildPSBTFromRawOptions,\n IBuildAssetTransferDisplayMetadataOptions,\n IPSBTInputMetadata,\n IAssetTransferDisplayMetadata,\n ISigningDisplayMetadata,\n IDeviceInfo,\n IAddressResponse,\n IBip32PubkeyResponse,\n ISignPsbtResponse,\n ISignMessageResponse,\n IErrorResponse,\n ISerialOptions,\n ISignResult,\n NetworkType,\n} from \"./types.js\";\n"],"names":[],"version":3,"file":"index.d.ts.map"}
|
package/dist/index.mjs
CHANGED
|
@@ -613,6 +613,23 @@ class $a6c8409f4f68b3eb$export$fa10ee8b91a777b7 {
|
|
|
613
613
|
return response;
|
|
614
614
|
}
|
|
615
615
|
/**
|
|
616
|
+
* Sign a message to prove address ownership.
|
|
617
|
+
* Requires user physical confirmation on the device (30s timeout).
|
|
618
|
+
*
|
|
619
|
+
* The signature is base64-encoded, compatible with Bitcoin/Neurai message
|
|
620
|
+
* signing (recoverable ECDSA with "Neurai Signed Message:\n" prefix).
|
|
621
|
+
*
|
|
622
|
+
* @param message - The message string to sign (max 1024 bytes)
|
|
623
|
+
* @returns Signature (base64), address, and the original message
|
|
624
|
+
*/ async signMessage(message) {
|
|
625
|
+
const response = await this.serial.sendCommand({
|
|
626
|
+
action: "sign_message",
|
|
627
|
+
message: message
|
|
628
|
+
}, 35000);
|
|
629
|
+
this.assertSuccess(response);
|
|
630
|
+
return response;
|
|
631
|
+
}
|
|
632
|
+
/**
|
|
616
633
|
* Send a raw PSBT (base64) to the device for signing.
|
|
617
634
|
* Requires user physical confirmation on the device (60s timeout).
|
|
618
635
|
*
|
package/dist/index.mjs.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"mappings":"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","sources":["src/index.ts","src/NeuraiESP32.ts","src/serial.ts","src/psbt.ts","src/networks.ts","src/display.ts"],"sourcesContent":["/**\n * @neuraiproject/neurai-sign-esp32\n *\n * Library for creating and signing Neurai (XNA) PSBTs\n * via ESP32 hardware wallet (NeuraiHW).\n */\n\n// Main class\nexport { NeuraiESP32 } from \"./NeuraiESP32.js\";\n\n// PSBT utilities\nexport {\n buildPSBT,\n buildPSBTFromRawTransaction,\n finalizePSBT,\n finalizeSignedPSBT,\n validatePSBT,\n} from \"./psbt.js\";\n\n// Display metadata helpers\nexport { buildAssetTransferDisplayMetadata } from \"./display.js\";\n\n// Serial connection (for advanced use)\nexport { SerialConnection } from \"./serial.js\";\n\n// Network configs\nexport {\n getNetwork,\n neuraiMainnet,\n neuraiTestnet,\n neuraiLegacyMainnet,\n neuraiLegacyTestnet,\n} from \"./networks.js\";\n\n// Types\nexport type {\n IUTXO,\n ITxOutput,\n IBuildPSBTOptions,\n IBuildPSBTFromRawOptions,\n IBuildAssetTransferDisplayMetadataOptions,\n IPSBTInputMetadata,\n IAssetTransferDisplayMetadata,\n ISigningDisplayMetadata,\n IDeviceInfo,\n IAddressResponse,\n IBip32PubkeyResponse,\n ISignPsbtResponse,\n IErrorResponse,\n ISerialOptions,\n ISignResult,\n NetworkType,\n} from \"./types.js\";\n","/**\n * NeuraiESP32 — Main class for interacting with a NeuraiHW hardware wallet.\n *\n * Orchestrates:\n * - USB Serial connection via Web Serial API\n * - Device info, address, and BIP32 pubkey retrieval\n * - PSBT creation, signing, and finalization\n *\n * Usage:\n * ```ts\n * const device = new NeuraiESP32();\n * await device.connect();\n * const info = await device.getInfo();\n * const { address, pubkey } = await device.getAddress();\n * const result = await device.signTransaction({ utxos, outputs, changeAddress: address });\n * console.log(result.txHex); // ready to broadcast\n * await device.disconnect();\n * ```\n */\n\nimport { SerialConnection } from \"./serial.js\";\nimport { buildPSBT, finalizeSignedPSBT } from \"./psbt.js\";\nimport type {\n DeviceResponse,\n IAddressResponse,\n IBip32PubkeyResponse,\n IDeviceInfo,\n IErrorResponse,\n ISerialOptions,\n ISigningDisplayMetadata,\n ISignPsbtResponse,\n ISignResult,\n IUTXO,\n ITxOutput,\n NetworkType,\n} from \"./types.js\";\n\nexport class NeuraiESP32 {\n private serial: SerialConnection;\n private deviceInfo: IDeviceInfo | null = null;\n\n constructor(options?: ISerialOptions) {\n this.serial = new SerialConnection(options);\n }\n\n /**\n * Check if Web Serial API is supported in this browser.\n */\n static isSupported(): boolean {\n return SerialConnection.isSupported();\n }\n\n /**\n * Whether the device is currently connected.\n */\n get connected(): boolean {\n return this.serial.connected;\n }\n\n /**\n * Cached device info from the last getInfo() call.\n */\n get info(): IDeviceInfo | null {\n return this.deviceInfo;\n }\n\n // ─── Connection ─────────────────────────────────────────────────────────\n\n /**\n * Connect to the ESP32 hardware wallet.\n * Opens the browser port selection dialog.\n */\n async connect(): Promise<void> {\n await this.serial.open();\n }\n\n /**\n * Disconnect from the device.\n */\n async disconnect(): Promise<void> {\n this.deviceInfo = null;\n await this.serial.close();\n }\n\n // ─── Device commands ────────────────────────────────────────────────────\n\n /**\n * Get device information (no user confirmation needed).\n * Returns device name, version, network, address, pubkey, etc.\n */\n async getInfo(): Promise<IDeviceInfo> {\n const response = await this.serial.sendCommand(\n { action: \"info\" },\n 5000\n );\n\n this.assertSuccess(response);\n this.deviceInfo = response as IDeviceInfo;\n return this.deviceInfo;\n }\n\n /**\n * Request the device address and public key.\n * Requires user physical confirmation on the device (30s timeout).\n */\n async getAddress(): Promise<IAddressResponse> {\n const response = await this.serial.sendCommand(\n { action: \"get_address\" },\n 35000\n );\n\n this.assertSuccess(response);\n return response as IAddressResponse;\n }\n\n /**\n * Request the BIP32 account extended public key (xpub).\n * Requires user physical confirmation on the device (30s timeout).\n */\n async getBip32Pubkey(): Promise<IBip32PubkeyResponse> {\n const response = await this.serial.sendCommand(\n { action: \"get_bip32_pubkey\" },\n 35000\n );\n\n this.assertSuccess(response);\n return response as IBip32PubkeyResponse;\n }\n\n /**\n * Send a raw PSBT (base64) to the device for signing.\n * Requires user physical confirmation on the device (60s timeout).\n *\n * Use this if you build the PSBT yourself.\n */\n async signPsbt(\n psbtBase64: string,\n display?: ISigningDisplayMetadata\n ): Promise<ISignPsbtResponse> {\n const response = await this.serial.sendCommandFinal(\n {\n action: \"sign_psbt\",\n psbt: psbtBase64,\n ...(display ? { display } : {}),\n },\n 65000\n );\n\n this.assertSuccess(response);\n return response as ISignPsbtResponse;\n }\n\n // ─── High-level transaction flow ────────────────────────────────────────\n\n /**\n * Build, sign, and finalize a transaction in one call.\n *\n * This is the main method for sending XNA. It:\n * 1. Builds an unsigned PSBT from the provided UTXOs and outputs\n * 2. Sends it to the ESP32 for signing (user confirms on device)\n * 3. Finalizes the signed PSBT and extracts the raw transaction\n *\n * @param options.network - Network type (default: uses device info)\n * @param options.utxos - UTXOs to spend (must include rawTxHex)\n * @param options.outputs - Destination outputs [{address, value}]\n * @param options.changeAddress - Address for change (typically device address)\n * @param options.pubkey - Compressed public key hex (from getAddress)\n * @param options.masterFingerprint - From getInfo().master_fingerprint\n * @param options.derivationPath - From getAddress().path\n * @param options.feeRate - Fee rate in sat/byte (default: 1024)\n * @returns ISignResult with txHex ready to broadcast\n */\n async signTransaction(options: {\n network?: NetworkType;\n utxos: IUTXO[];\n outputs: ITxOutput[];\n changeAddress: string;\n pubkey?: string;\n masterFingerprint?: string;\n derivationPath?: string;\n feeRate?: number;\n display?: ISigningDisplayMetadata;\n }): Promise<ISignResult> {\n // Use cached device info if available for defaults\n const info = this.deviceInfo;\n\n const network =\n options.network ?? this.inferNetworkType(info);\n const pubkey =\n options.pubkey ?? info?.pubkey;\n const masterFingerprint =\n options.masterFingerprint ?? info?.master_fingerprint;\n const derivationPath =\n options.derivationPath ?? info?.path;\n\n if (!pubkey) {\n throw new Error(\n \"pubkey required. Call getInfo() first or provide it explicitly.\"\n );\n }\n if (!masterFingerprint) {\n throw new Error(\n \"masterFingerprint required. Call getInfo() first or provide it explicitly.\"\n );\n }\n if (!derivationPath) {\n throw new Error(\n \"derivationPath required. Call getInfo() first or provide it explicitly.\"\n );\n }\n\n // 1. Build unsigned PSBT\n const psbtBase64 = buildPSBT({\n network,\n utxos: options.utxos,\n outputs: options.outputs,\n changeAddress: options.changeAddress,\n pubkey,\n masterFingerprint,\n derivationPath,\n feeRate: options.feeRate,\n });\n\n // 2. Send to ESP32 for signing\n const signResponse = await this.signPsbt(psbtBase64, options.display);\n\n // 3. Finalize and extract raw transaction\n const { txHex, txId } = finalizeSignedPSBT(\n psbtBase64,\n signResponse.psbt,\n network\n );\n\n return {\n signedPsbtBase64: signResponse.psbt,\n txHex,\n txId,\n signedInputs: signResponse.signed_inputs,\n };\n }\n\n // ─── Private helpers ────────────────────────────────────────────────────\n\n private assertSuccess(response: DeviceResponse): void {\n if (response.status === \"error\") {\n throw new Error(\n `Device error: ${(response as IErrorResponse).message}`\n );\n }\n }\n\n /**\n * Infer the NetworkType from cached device info.\n */\n private inferNetworkType(info: IDeviceInfo | null): NetworkType {\n if (!info) {\n return \"xna\"; // default\n }\n\n const networkName = info.network?.toLowerCase() ?? \"\";\n const coinType = info.coin_type;\n\n if (networkName.includes(\"test\")) {\n return coinType === 1900 ? \"xna-test\" : \"xna-legacy-test\";\n }\n if (networkName.includes(\"legacy\") || coinType === 0) {\n return \"xna-legacy\";\n }\n return \"xna\";\n }\n}\n","/**\n * Web Serial API communication layer for ESP32 hardware wallet.\n *\n * Handles USB Serial connection, JSON command/response protocol,\n * and line-based buffering matching the NeuraiHW firmware protocol.\n */\n\nimport type { DeviceResponse, ISerialOptions } from \"./types.js\";\n\n// Default USB filters for ESP32 devices\nconst DEFAULT_FILTERS: SerialPortFilter[] = [\n { usbVendorId: 0x303a, usbProductId: 0x1001 }, // ESP32-S3 USB JTAG/Serial\n { usbVendorId: 0x303a }, // Espressif generic\n { usbVendorId: 0x10c4, usbProductId: 0xea60 }, // Silicon Labs CP210x\n { usbVendorId: 0x1a86, usbProductId: 0x7523 }, // CH340\n { usbVendorId: 0x0403, usbProductId: 0x6001 }, // FTDI FT232\n { usbVendorId: 0x067b, usbProductId: 0x2303 }, // Prolific PL2303\n { usbVendorId: 0x2886 }, // Seeed Studio (XIAO)\n];\n\nconst DEFAULT_BAUD_RATE = 115200;\n\nexport class SerialConnection {\n private port: SerialPort | null = null;\n private reader: ReadableStreamDefaultReader<string> | null = null;\n private writer: WritableStreamDefaultWriter<string> | null = null;\n private readableStreamClosed: Promise<void> | null = null;\n private writableStreamClosed: Promise<void> | null = null;\n private isReading = false;\n private responseQueue: DeviceResponse[] = [];\n private baudRate: number;\n private filters: SerialPortFilter[];\n\n constructor(options?: ISerialOptions) {\n this.baudRate = options?.baudRate ?? DEFAULT_BAUD_RATE;\n this.filters = options?.filters ?? DEFAULT_FILTERS;\n }\n\n /**\n * Check if Web Serial API is available.\n */\n static isSupported(): boolean {\n return typeof navigator !== \"undefined\" && \"serial\" in navigator;\n }\n\n /**\n * Open a serial connection to the ESP32.\n * Triggers browser port selection dialog.\n */\n async open(): Promise<void> {\n if (!SerialConnection.isSupported()) {\n throw new Error(\n \"Web Serial API not supported. Use Chrome, Edge, or Opera.\"\n );\n }\n\n this.port = await navigator.serial.requestPort({ filters: this.filters });\n await this.port.open({\n baudRate: this.baudRate,\n dataBits: 8,\n stopBits: 1,\n parity: \"none\",\n flowControl: \"none\",\n bufferSize: 8192,\n });\n\n // Set up readable stream (text decoding)\n const decoder = new TextDecoderStream();\n this.readableStreamClosed = this.port.readable!.pipeTo(decoder.writable as unknown as WritableStream<Uint8Array>);\n this.reader = decoder.readable.getReader();\n\n // Set up writable stream (text encoding)\n const encoder = new TextEncoderStream();\n this.writableStreamClosed = encoder.readable.pipeTo(this.port.writable!);\n this.writer = encoder.writable.getWriter();\n\n // Start background read loop\n this.isReading = true;\n void this.readLoop();\n\n // Give the ESP32 CDC port time to settle after connect/re-enumeration.\n await this.delay(1200);\n this.responseQueue = [];\n }\n\n /**\n * Close the serial connection.\n */\n async close(): Promise<void> {\n this.isReading = false;\n\n if (this.reader) {\n await this.reader.cancel();\n await this.readableStreamClosed?.catch(() => {});\n this.reader = null;\n }\n\n if (this.writer) {\n await this.writer.close();\n await this.writableStreamClosed;\n this.writer = null;\n }\n\n if (this.port) {\n await this.port.close();\n this.port = null;\n }\n\n this.responseQueue = [];\n }\n\n /**\n * Whether the serial port is currently connected.\n */\n get connected(): boolean {\n return this.port !== null && this.writer !== null;\n }\n\n /**\n * Send a JSON command to the device and wait for a JSON response.\n *\n * @param command - The command object (e.g. { action: \"info\" })\n * @param timeoutMs - Response timeout in milliseconds (default: 65000 for sign operations)\n * @returns The parsed device response\n */\n async sendCommand(\n command: Record<string, unknown>,\n timeoutMs = 65000\n ): Promise<DeviceResponse> {\n if (!this.writer) {\n throw new Error(\"Serial port not connected\");\n }\n\n // Clear stale responses\n this.responseQueue = [];\n\n // Send JSON in small chunks, then newline to trigger processing.\n // The ESP32 CDC serial buffer can lose data if sent too fast in one write.\n const json = JSON.stringify(command);\n console.debug(\"[NeuraiESP32 Serial] Sending command\", {\n action: command.action,\n payloadLength: json.length + 1,\n timeoutMs,\n });\n await this.writeChunked(json);\n await this.writer.ready;\n await this.writer.write(\"\\n\");\n\n // Wait for response\n const response = await this.waitForResponse(timeoutMs);\n if (!response) {\n throw new Error(\"Device response timeout\");\n }\n\n return response;\n }\n\n /**\n * Send a command and wait, skipping intermediate \"processing\" status messages.\n * Useful for sign_psbt which sends a processing ACK before the actual response.\n */\n async sendCommandFinal(\n command: Record<string, unknown>,\n timeoutMs = 65000\n ): Promise<DeviceResponse> {\n if (!this.writer) {\n throw new Error(\"Serial port not connected\");\n }\n\n this.responseQueue = [];\n\n const json = JSON.stringify(command);\n console.debug(\"[NeuraiESP32 Serial] Sending command\", {\n action: command.action,\n payloadLength: json.length + 1,\n timeoutMs,\n });\n await this.writeChunked(json);\n await this.writer.ready;\n await this.writer.write(\"\\n\");\n\n // Wait for a non-processing response\n const startTime = Date.now();\n while (Date.now() - startTime < timeoutMs) {\n const response = await this.waitForResponse(\n timeoutMs - (Date.now() - startTime)\n );\n if (!response) {\n throw new Error(\"Device response timeout\");\n }\n // Skip intermediate \"processing\" status\n if (response.status === \"processing\") {\n continue;\n }\n return response;\n }\n\n throw new Error(\"Device response timeout\");\n }\n\n // ─── Private ──────────────────────────────────────────────────────────────\n\n private async readLoop(): Promise<void> {\n let buffer = \"\";\n\n while (this.isReading && this.reader) {\n try {\n const { value, done } = await this.reader.read();\n if (done) break;\n\n buffer += value;\n\n // Process complete lines\n const lines = buffer.split(\"\\n\");\n buffer = lines.pop() ?? \"\"; // Keep incomplete line in buffer\n\n for (const rawLine of lines) {\n const line = rawLine.trim().replace(/\\r/g, \"\");\n if (line.length === 0) continue;\n\n // Try to parse as JSON response\n if (line.startsWith(\"{\")) {\n try {\n const data = JSON.parse(line) as DeviceResponse;\n console.debug(\"[NeuraiESP32 Serial] JSON line received\", data);\n this.responseQueue.push(data);\n } catch {\n console.debug(\"[NeuraiESP32 Serial] Invalid JSON line\", line);\n }\n } else {\n console.debug(\"[NeuraiESP32 Serial] Non-JSON serial line\", line);\n }\n }\n } catch {\n // Read error — connection may have been closed\n break;\n }\n }\n }\n\n private waitForResponse(timeoutMs: number): Promise<DeviceResponse | null> {\n return new Promise((resolve) => {\n const startTime = Date.now();\n const check = () => {\n if (this.responseQueue.length > 0) {\n const response = this.responseQueue.shift()!;\n console.debug(\"[NeuraiESP32 Serial] Response dequeued\", {\n waitedMs: Date.now() - startTime,\n pendingResponses: this.responseQueue.length,\n status: response.status,\n });\n resolve(response);\n } else if (Date.now() - startTime > timeoutMs) {\n console.error(\"[NeuraiESP32 Serial] Response timeout\", {\n timeoutMs,\n queuedResponses: this.responseQueue.length,\n });\n resolve(null);\n } else {\n setTimeout(check, 50);\n }\n };\n check();\n });\n }\n\n /**\n * Write data in small chunks with pauses between them.\n *\n * The ESP32 CDC serial buffer can lose data when the host sends a large\n * payload in a single write. Splitting into 32-byte chunks with a 4 ms\n * pause gives the firmware time to drain its receive buffer.\n */\n private async writeChunked(\n data: string,\n chunkSize = 32,\n pauseMs = 4\n ): Promise<void> {\n if (!this.writer) {\n throw new Error(\"Serial port not connected\");\n }\n\n for (let offset = 0; offset < data.length; offset += chunkSize) {\n const chunk = data.slice(offset, offset + chunkSize);\n await this.writer.ready;\n await this.writer.write(chunk);\n if (offset + chunkSize < data.length) {\n await this.delay(pauseMs);\n }\n }\n }\n\n private delay(ms: number): Promise<void> {\n return new Promise((resolve) => setTimeout(resolve, ms));\n }\n}\n","/**\n * PSBT helpers for Neurai P2PKH transactions.\n *\n * This package supports two build paths:\n * - high-level build from UTXOs + outputs + fee estimation\n * - low-level build from an already-created raw unsigned transaction\n *\n * The second path matches the webwallet integration, where coin selection\n * and fee calculation already happen elsewhere.\n */\n\nimport { Buffer } from \"buffer\";\nimport * as bitcoin from \"bitcoinjs-lib\";\nimport { getNetwork } from \"./networks.js\";\nimport type {\n IBuildPSBTFromRawOptions,\n IBuildPSBTOptions,\n IPSBTInputMetadata,\n NetworkType,\n} from \"./types.js\";\n\nconst DEFAULT_FEE_RATE = 1024; // sat/byte\n\nconst TX_OVERHEAD = 10;\nconst INPUT_SIZE = 148;\nconst OUTPUT_SIZE = 34;\n\nfunction estimateTxSize(inputCount: number, outputCount: number): number {\n return TX_OVERHEAD + inputCount * INPUT_SIZE + outputCount * OUTPUT_SIZE;\n}\n\nfunction parseMasterFingerprint(hex: string): Buffer {\n if (hex.length !== 8) {\n throw new Error(\n `Invalid master fingerprint: expected 8 hex chars, got ${hex.length}`\n );\n }\n return Buffer.from(hex, \"hex\");\n}\n\nexport function buildPSBT(options: IBuildPSBTOptions): string {\n const {\n network,\n utxos,\n outputs,\n changeAddress,\n pubkey,\n masterFingerprint,\n derivationPath,\n feeRate = DEFAULT_FEE_RATE,\n } = options;\n\n if (utxos.length === 0) {\n throw new Error(\"No UTXOs provided\");\n }\n if (outputs.length === 0) {\n throw new Error(\"No outputs provided\");\n }\n\n const totalOutputValue = outputs.reduce((sum, output) => sum + output.value, 0);\n const totalInputValue = utxos.reduce((sum, utxo) => sum + utxo.satoshis, 0);\n const estimatedSize = estimateTxSize(utxos.length, outputs.length + 1);\n const fee = estimatedSize * feeRate;\n const change = totalInputValue - totalOutputValue - fee;\n\n if (change < 0) {\n throw new Error(\n `Insufficient funds: inputs=${totalInputValue}, outputs=${totalOutputValue}, fee=${fee}`\n );\n }\n\n const psbt = new bitcoin.Psbt({ network: getNetwork(network) });\n const bip32Derivation = [\n {\n masterFingerprint: parseMasterFingerprint(masterFingerprint),\n path: derivationPath,\n pubkey: Buffer.from(pubkey, \"hex\"),\n },\n ];\n\n for (const utxo of utxos) {\n psbt.addInput({\n hash: utxo.txid,\n index: utxo.vout,\n nonWitnessUtxo: Buffer.from(utxo.rawTxHex, \"hex\"),\n bip32Derivation,\n });\n }\n\n for (const output of outputs) {\n psbt.addOutput({\n address: output.address,\n value: BigInt(output.value),\n });\n }\n\n const DUST_THRESHOLD = 546;\n if (change >= DUST_THRESHOLD) {\n psbt.addOutput({\n address: changeAddress,\n value: BigInt(change),\n bip32Derivation,\n });\n }\n\n return psbt.toBase64();\n}\n\nexport function buildPSBTFromRawTransaction(options: IBuildPSBTFromRawOptions): string {\n const network = getNetwork(options.network);\n const tx = bitcoin.Transaction.fromHex(options.rawUnsignedTransaction);\n const psbt = new bitcoin.Psbt({ network });\n\n psbt.setVersion(tx.version);\n psbt.setLocktime(tx.locktime);\n\n for (let index = 0; index < tx.ins.length; index += 1) {\n const input = tx.ins[index];\n const metadata = options.inputs[index];\n\n if (!metadata) {\n throw new Error(`Missing input metadata for input #${index}`);\n }\n\n psbt.addInput({\n hash: metadata.txid,\n index: metadata.vout,\n sequence: metadata.sequence ?? input.sequence,\n nonWitnessUtxo: Buffer.from(metadata.rawTxHex, \"hex\"),\n bip32Derivation: [\n {\n masterFingerprint: parseMasterFingerprint(metadata.masterFingerprint),\n path: metadata.derivationPath,\n pubkey: Buffer.from(metadata.pubkey, \"hex\"),\n },\n ],\n });\n }\n\n for (const output of tx.outs) {\n psbt.addOutput({\n script: Buffer.from(output.script),\n value: output.value,\n });\n }\n\n return psbt.toBase64();\n}\n\nexport function finalizePSBT(\n signedPsbtBase64: string,\n network: NetworkType\n): { txHex: string; txId: string } {\n const psbt = bitcoin.Psbt.fromBase64(signedPsbtBase64, {\n network: getNetwork(network),\n });\n\n psbt.finalizeAllInputs();\n\n const tx = psbt.extractTransaction();\n return {\n txHex: tx.toHex(),\n txId: tx.getId(),\n };\n}\n\nexport function finalizeSignedPSBT(\n originalPsbtBase64: string,\n signedPsbtBase64: string,\n network: NetworkType\n): { txHex: string; txId: string } {\n const net = getNetwork(network);\n const psbt = bitcoin.Psbt.fromBase64(originalPsbtBase64, { network: net });\n\n let mergedWithStandardPsbt = false;\n try {\n const signedPsbt = bitcoin.Psbt.fromBase64(signedPsbtBase64, { network: net });\n psbt.combine(signedPsbt);\n mergedWithStandardPsbt = true;\n } catch {\n // uNeurai can return a minimal signed PSBT that bitcoinjs-lib cannot fully parse.\n }\n\n if (!mergedWithStandardPsbt) {\n const partialSigsByInput = extractPartialSigsFromUNeuraiPsbt(\n originalPsbtBase64,\n signedPsbtBase64,\n psbt.inputCount\n );\n\n partialSigsByInput.forEach((partialSig, index) => {\n if (partialSig.length === 0) {\n return;\n }\n psbt.updateInput(index, { partialSig });\n });\n }\n\n try {\n psbt.finalizeAllInputs();\n } catch {\n finalizeLegacyP2pkhInputs(psbt);\n }\n\n const tx = psbt.extractTransaction(true);\n return {\n txHex: tx.toHex(),\n txId: tx.getId(),\n };\n}\n\nexport function validatePSBT(psbtBase64: string, network: NetworkType): boolean {\n try {\n bitcoin.Psbt.fromBase64(psbtBase64, { network: getNetwork(network) });\n return true;\n } catch {\n return false;\n }\n}\n\nfunction extractPartialSigsFromUNeuraiPsbt(\n originalBase64: string,\n signedBase64: string,\n inputCount: number\n) {\n const originalBuffer = Buffer.from(originalBase64, \"base64\");\n const buffer = Buffer.from(signedBase64, \"base64\");\n const partialSigsByInput: { pubkey: Buffer; signature: Buffer }[][] = Array.from(\n { length: inputCount },\n () => []\n );\n\n if (buffer.length < 5 || buffer.toString(\"ascii\", 0, 4) !== \"psbt\" || buffer[4] !== 0xff) {\n throw new Error(\"NeuraiHW returned an invalid PSBT header\");\n }\n\n let offset = getFirstInputSectionOffset(originalBuffer);\n\n for (let inputIndex = 0; inputIndex < inputCount; inputIndex += 1) {\n while (offset < buffer.length) {\n const keyLen = readPsbtVarInt(buffer, offset);\n offset += keyLen.size;\n\n if (keyLen.value === 0) {\n break;\n }\n\n const key = buffer.subarray(offset, offset + keyLen.value);\n offset += keyLen.value;\n\n const valueLen = readPsbtVarInt(buffer, offset);\n offset += valueLen.size;\n const value = buffer.subarray(offset, offset + valueLen.value);\n offset += valueLen.value;\n\n if (key.length > 1 && key[0] === 0x02) {\n partialSigsByInput[inputIndex].push({\n pubkey: Buffer.from(key.subarray(1)),\n signature: Buffer.from(value),\n });\n }\n }\n }\n\n return partialSigsByInput;\n}\n\nfunction getFirstInputSectionOffset(buffer: Buffer) {\n if (buffer.length < 5 || buffer.toString(\"ascii\", 0, 4) !== \"psbt\" || buffer[4] !== 0xff) {\n throw new Error(\"Invalid original PSBT header\");\n }\n\n let offset = 5;\n\n const globalKeyLen = readPsbtVarInt(buffer, offset);\n offset += globalKeyLen.size + globalKeyLen.value;\n\n const globalValueLen = readPsbtVarInt(buffer, offset);\n offset += globalValueLen.size + globalValueLen.value;\n\n if (offset >= buffer.length || buffer[offset] !== 0x00) {\n throw new Error(\"Invalid original PSBT global section\");\n }\n\n return offset + 1;\n}\n\nfunction readPsbtVarInt(buffer: Buffer, offset: number) {\n if (offset >= buffer.length) {\n throw new Error(\"Format Error: Unexpected End of PSBT\");\n }\n\n const first = buffer[offset];\n if (first < 0xfd) {\n return { value: first, size: 1 };\n }\n if (first === 0xfd) {\n if (offset + 2 >= buffer.length) {\n throw new Error(\"Format Error: Unexpected End of PSBT\");\n }\n return { value: buffer.readUInt16LE(offset + 1), size: 3 };\n }\n if (first === 0xfe) {\n if (offset + 4 >= buffer.length) {\n throw new Error(\"Format Error: Unexpected End of PSBT\");\n }\n return { value: buffer.readUInt32LE(offset + 1), size: 5 };\n }\n throw new Error(\"PSBT values larger than 32 bits are not supported\");\n}\n\nfunction finalizeLegacyP2pkhInputs(psbt: bitcoin.Psbt) {\n for (let index = 0; index < psbt.inputCount; index += 1) {\n const input = psbt.data.inputs[index];\n if (input.finalScriptSig || input.finalScriptWitness) {\n continue;\n }\n\n const partialSig = input.partialSig?.[0];\n const nonWitnessUtxo = input.nonWitnessUtxo;\n const txInput = psbt.txInputs[index];\n\n if (!partialSig || !nonWitnessUtxo || !txInput) {\n throw new Error(`Missing data to finalize input #${index}`);\n }\n\n const prevTx = bitcoin.Transaction.fromBuffer(nonWitnessUtxo);\n const prevOut = prevTx.outs[txInput.index];\n if (!prevOut) {\n throw new Error(`Missing prevout to finalize input #${index}`);\n }\n\n psbt.finalizeInput(index, () => ({\n finalScriptSig: bitcoin.script.compile([\n partialSig.signature,\n partialSig.pubkey,\n ]),\n finalScriptWitness: undefined,\n }));\n }\n}\n","/**\n * Neurai network configurations for bitcoinjs-lib\n *\n * Defines all Neurai networks (mainnet, testnet, legacy variants)\n * in the format required by bitcoinjs-lib v7.\n */\n\nimport type { Network } from \"bitcoinjs-lib\";\nimport type { NetworkType } from \"./types.js\";\n\n// ─── Neurai Mainnet (coin type 1900) ────────────────────────────────────────\n\nexport const neuraiMainnet: Network = {\n messagePrefix: \"Neurai Signed Message:\\n\",\n bech32: \"\",\n bip32: {\n public: 76067358,\n private: 76066276,\n },\n pubKeyHash: 53, // 0x35 → prefix \"N\"\n scriptHash: 117, // 0x75\n wif: 128, // 0x80\n};\n\n// ─── Neurai Testnet ──────────────────────────────────────────────────────────\n\nexport const neuraiTestnet: Network = {\n messagePrefix: \"Neurai Signed Message:\\n\",\n bech32: \"\",\n bip32: {\n public: 70617039,\n private: 70615956,\n },\n pubKeyHash: 127, // 0x7f\n scriptHash: 196, // 0xc4\n wif: 239, // 0xef\n};\n\n// ─── Neurai Legacy Mainnet (coin type 0) ─────────────────────────────────────\n\nexport const neuraiLegacyMainnet: Network = {\n messagePrefix: \"Neurai Signed Message:\\n\",\n bech32: \"\",\n bip32: {\n public: 76067358,\n private: 76066276,\n },\n pubKeyHash: 53,\n scriptHash: 117,\n wif: 128,\n};\n\n// ─── Neurai Legacy Testnet ───────────────────────────────────────────────────\n\nexport const neuraiLegacyTestnet: Network = {\n messagePrefix: \"Neurai Signed Message:\\n\",\n bech32: \"\",\n bip32: {\n public: 70617039,\n private: 70615956,\n },\n pubKeyHash: 127,\n scriptHash: 196,\n wif: 239,\n};\n\n// ─── Network map ─────────────────────────────────────────────────────────────\n\nconst networkMap: Record<NetworkType, Network> = {\n xna: neuraiMainnet,\n \"xna-test\": neuraiTestnet,\n \"xna-legacy\": neuraiLegacyMainnet,\n \"xna-legacy-test\": neuraiLegacyTestnet,\n};\n\n/**\n * Get the bitcoinjs-lib Network object for a given Neurai network type.\n */\nexport function getNetwork(network: NetworkType): Network {\n const net = networkMap[network];\n if (!net) {\n throw new Error(`Unknown network: ${network}`);\n }\n return net;\n}\n","import type {\n IAssetTransferDisplayMetadata,\n IBuildAssetTransferDisplayMetadataOptions,\n} from \"./types.js\";\n\nfunction formatAmount(value: number | string): string {\n if (typeof value === \"string\") {\n return value;\n }\n return value.toFixed(8);\n}\n\nexport function buildAssetTransferDisplayMetadata(\n options: IBuildAssetTransferDisplayMetadataOptions\n): IAssetTransferDisplayMetadata {\n return {\n kind: \"asset_transfer\",\n assetName: options.assetName,\n assetAmount: formatAmount(options.assetAmount),\n destinationAddress: options.destinationAddress,\n destinationCount: options.destinationCount ?? 1,\n changeAddress: options.changeAddress,\n changeCount: options.changeCount ?? 0,\n inputAddresses: options.inputAddresses ?? [],\n feeAmount:\n options.feeAmount === undefined ? undefined : formatAmount(options.feeAmount),\n baseCurrency: options.baseCurrency ?? \"XNA\",\n };\n}\n"],"names":[],"version":3,"file":"index.mjs.map"}
|
|
1
|
+
{"mappings":"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","sources":["src/index.ts","src/NeuraiESP32.ts","src/serial.ts","src/psbt.ts","src/networks.ts","src/display.ts"],"sourcesContent":["/**\n * @neuraiproject/neurai-sign-esp32\n *\n * Library for creating and signing Neurai (XNA) PSBTs\n * via ESP32 hardware wallet (NeuraiHW).\n */\n\n// Main class\nexport { NeuraiESP32 } from \"./NeuraiESP32.js\";\n\n// PSBT utilities\nexport {\n buildPSBT,\n buildPSBTFromRawTransaction,\n finalizePSBT,\n finalizeSignedPSBT,\n validatePSBT,\n} from \"./psbt.js\";\n\n// Display metadata helpers\nexport { buildAssetTransferDisplayMetadata } from \"./display.js\";\n\n// Serial connection (for advanced use)\nexport { SerialConnection } from \"./serial.js\";\n\n// Network configs\nexport {\n getNetwork,\n neuraiMainnet,\n neuraiTestnet,\n neuraiLegacyMainnet,\n neuraiLegacyTestnet,\n} from \"./networks.js\";\n\n// Types\nexport type {\n IUTXO,\n ITxOutput,\n IBuildPSBTOptions,\n IBuildPSBTFromRawOptions,\n IBuildAssetTransferDisplayMetadataOptions,\n IPSBTInputMetadata,\n IAssetTransferDisplayMetadata,\n ISigningDisplayMetadata,\n IDeviceInfo,\n IAddressResponse,\n IBip32PubkeyResponse,\n ISignPsbtResponse,\n ISignMessageResponse,\n IErrorResponse,\n ISerialOptions,\n ISignResult,\n NetworkType,\n} from \"./types.js\";\n","/**\n * NeuraiESP32 — Main class for interacting with a NeuraiHW hardware wallet.\n *\n * Orchestrates:\n * - USB Serial connection via Web Serial API\n * - Device info, address, and BIP32 pubkey retrieval\n * - PSBT creation, signing, and finalization\n *\n * Usage:\n * ```ts\n * const device = new NeuraiESP32();\n * await device.connect();\n * const info = await device.getInfo();\n * const { address, pubkey } = await device.getAddress();\n * const result = await device.signTransaction({ utxos, outputs, changeAddress: address });\n * console.log(result.txHex); // ready to broadcast\n * await device.disconnect();\n * ```\n */\n\nimport { SerialConnection } from \"./serial.js\";\nimport { buildPSBT, finalizeSignedPSBT } from \"./psbt.js\";\nimport type {\n DeviceResponse,\n IAddressResponse,\n IBip32PubkeyResponse,\n IDeviceInfo,\n IErrorResponse,\n ISerialOptions,\n ISigningDisplayMetadata,\n ISignMessageResponse,\n ISignPsbtResponse,\n ISignResult,\n IUTXO,\n ITxOutput,\n NetworkType,\n} from \"./types.js\";\n\nexport class NeuraiESP32 {\n private serial: SerialConnection;\n private deviceInfo: IDeviceInfo | null = null;\n\n constructor(options?: ISerialOptions) {\n this.serial = new SerialConnection(options);\n }\n\n /**\n * Check if Web Serial API is supported in this browser.\n */\n static isSupported(): boolean {\n return SerialConnection.isSupported();\n }\n\n /**\n * Whether the device is currently connected.\n */\n get connected(): boolean {\n return this.serial.connected;\n }\n\n /**\n * Cached device info from the last getInfo() call.\n */\n get info(): IDeviceInfo | null {\n return this.deviceInfo;\n }\n\n // ─── Connection ─────────────────────────────────────────────────────────\n\n /**\n * Connect to the ESP32 hardware wallet.\n * Opens the browser port selection dialog.\n */\n async connect(): Promise<void> {\n await this.serial.open();\n }\n\n /**\n * Disconnect from the device.\n */\n async disconnect(): Promise<void> {\n this.deviceInfo = null;\n await this.serial.close();\n }\n\n // ─── Device commands ────────────────────────────────────────────────────\n\n /**\n * Get device information (no user confirmation needed).\n * Returns device name, version, network, address, pubkey, etc.\n */\n async getInfo(): Promise<IDeviceInfo> {\n const response = await this.serial.sendCommand(\n { action: \"info\" },\n 5000\n );\n\n this.assertSuccess(response);\n this.deviceInfo = response as IDeviceInfo;\n return this.deviceInfo;\n }\n\n /**\n * Request the device address and public key.\n * Requires user physical confirmation on the device (30s timeout).\n */\n async getAddress(): Promise<IAddressResponse> {\n const response = await this.serial.sendCommand(\n { action: \"get_address\" },\n 35000\n );\n\n this.assertSuccess(response);\n return response as IAddressResponse;\n }\n\n /**\n * Request the BIP32 account extended public key (xpub).\n * Requires user physical confirmation on the device (30s timeout).\n */\n async getBip32Pubkey(): Promise<IBip32PubkeyResponse> {\n const response = await this.serial.sendCommand(\n { action: \"get_bip32_pubkey\" },\n 35000\n );\n\n this.assertSuccess(response);\n return response as IBip32PubkeyResponse;\n }\n\n /**\n * Sign a message to prove address ownership.\n * Requires user physical confirmation on the device (30s timeout).\n *\n * The signature is base64-encoded, compatible with Bitcoin/Neurai message\n * signing (recoverable ECDSA with \"Neurai Signed Message:\\n\" prefix).\n *\n * @param message - The message string to sign (max 1024 bytes)\n * @returns Signature (base64), address, and the original message\n */\n async signMessage(message: string): Promise<ISignMessageResponse> {\n const response = await this.serial.sendCommand(\n { action: \"sign_message\", message },\n 35000\n );\n\n this.assertSuccess(response);\n return response as ISignMessageResponse;\n }\n\n /**\n * Send a raw PSBT (base64) to the device for signing.\n * Requires user physical confirmation on the device (60s timeout).\n *\n * Use this if you build the PSBT yourself.\n */\n async signPsbt(\n psbtBase64: string,\n display?: ISigningDisplayMetadata\n ): Promise<ISignPsbtResponse> {\n const response = await this.serial.sendCommandFinal(\n {\n action: \"sign_psbt\",\n psbt: psbtBase64,\n ...(display ? { display } : {}),\n },\n 65000\n );\n\n this.assertSuccess(response);\n return response as ISignPsbtResponse;\n }\n\n // ─── High-level transaction flow ────────────────────────────────────────\n\n /**\n * Build, sign, and finalize a transaction in one call.\n *\n * This is the main method for sending XNA. It:\n * 1. Builds an unsigned PSBT from the provided UTXOs and outputs\n * 2. Sends it to the ESP32 for signing (user confirms on device)\n * 3. Finalizes the signed PSBT and extracts the raw transaction\n *\n * @param options.network - Network type (default: uses device info)\n * @param options.utxos - UTXOs to spend (must include rawTxHex)\n * @param options.outputs - Destination outputs [{address, value}]\n * @param options.changeAddress - Address for change (typically device address)\n * @param options.pubkey - Compressed public key hex (from getAddress)\n * @param options.masterFingerprint - From getInfo().master_fingerprint\n * @param options.derivationPath - From getAddress().path\n * @param options.feeRate - Fee rate in sat/byte (default: 1024)\n * @returns ISignResult with txHex ready to broadcast\n */\n async signTransaction(options: {\n network?: NetworkType;\n utxos: IUTXO[];\n outputs: ITxOutput[];\n changeAddress: string;\n pubkey?: string;\n masterFingerprint?: string;\n derivationPath?: string;\n feeRate?: number;\n display?: ISigningDisplayMetadata;\n }): Promise<ISignResult> {\n // Use cached device info if available for defaults\n const info = this.deviceInfo;\n\n const network =\n options.network ?? this.inferNetworkType(info);\n const pubkey =\n options.pubkey ?? info?.pubkey;\n const masterFingerprint =\n options.masterFingerprint ?? info?.master_fingerprint;\n const derivationPath =\n options.derivationPath ?? info?.path;\n\n if (!pubkey) {\n throw new Error(\n \"pubkey required. Call getInfo() first or provide it explicitly.\"\n );\n }\n if (!masterFingerprint) {\n throw new Error(\n \"masterFingerprint required. Call getInfo() first or provide it explicitly.\"\n );\n }\n if (!derivationPath) {\n throw new Error(\n \"derivationPath required. Call getInfo() first or provide it explicitly.\"\n );\n }\n\n // 1. Build unsigned PSBT\n const psbtBase64 = buildPSBT({\n network,\n utxos: options.utxos,\n outputs: options.outputs,\n changeAddress: options.changeAddress,\n pubkey,\n masterFingerprint,\n derivationPath,\n feeRate: options.feeRate,\n });\n\n // 2. Send to ESP32 for signing\n const signResponse = await this.signPsbt(psbtBase64, options.display);\n\n // 3. Finalize and extract raw transaction\n const { txHex, txId } = finalizeSignedPSBT(\n psbtBase64,\n signResponse.psbt,\n network\n );\n\n return {\n signedPsbtBase64: signResponse.psbt,\n txHex,\n txId,\n signedInputs: signResponse.signed_inputs,\n };\n }\n\n // ─── Private helpers ────────────────────────────────────────────────────\n\n private assertSuccess(response: DeviceResponse): void {\n if (response.status === \"error\") {\n throw new Error(\n `Device error: ${(response as IErrorResponse).message}`\n );\n }\n }\n\n /**\n * Infer the NetworkType from cached device info.\n */\n private inferNetworkType(info: IDeviceInfo | null): NetworkType {\n if (!info) {\n return \"xna\"; // default\n }\n\n const networkName = info.network?.toLowerCase() ?? \"\";\n const coinType = info.coin_type;\n\n if (networkName.includes(\"test\")) {\n return coinType === 1900 ? \"xna-test\" : \"xna-legacy-test\";\n }\n if (networkName.includes(\"legacy\") || coinType === 0) {\n return \"xna-legacy\";\n }\n return \"xna\";\n }\n}\n","/**\n * Web Serial API communication layer for ESP32 hardware wallet.\n *\n * Handles USB Serial connection, JSON command/response protocol,\n * and line-based buffering matching the NeuraiHW firmware protocol.\n */\n\nimport type { DeviceResponse, ISerialOptions } from \"./types.js\";\n\n// Default USB filters for ESP32 devices\nconst DEFAULT_FILTERS: SerialPortFilter[] = [\n { usbVendorId: 0x303a, usbProductId: 0x1001 }, // ESP32-S3 USB JTAG/Serial\n { usbVendorId: 0x303a }, // Espressif generic\n { usbVendorId: 0x10c4, usbProductId: 0xea60 }, // Silicon Labs CP210x\n { usbVendorId: 0x1a86, usbProductId: 0x7523 }, // CH340\n { usbVendorId: 0x0403, usbProductId: 0x6001 }, // FTDI FT232\n { usbVendorId: 0x067b, usbProductId: 0x2303 }, // Prolific PL2303\n { usbVendorId: 0x2886 }, // Seeed Studio (XIAO)\n];\n\nconst DEFAULT_BAUD_RATE = 115200;\n\nexport class SerialConnection {\n private port: SerialPort | null = null;\n private reader: ReadableStreamDefaultReader<string> | null = null;\n private writer: WritableStreamDefaultWriter<string> | null = null;\n private readableStreamClosed: Promise<void> | null = null;\n private writableStreamClosed: Promise<void> | null = null;\n private isReading = false;\n private responseQueue: DeviceResponse[] = [];\n private baudRate: number;\n private filters: SerialPortFilter[];\n\n constructor(options?: ISerialOptions) {\n this.baudRate = options?.baudRate ?? DEFAULT_BAUD_RATE;\n this.filters = options?.filters ?? DEFAULT_FILTERS;\n }\n\n /**\n * Check if Web Serial API is available.\n */\n static isSupported(): boolean {\n return typeof navigator !== \"undefined\" && \"serial\" in navigator;\n }\n\n /**\n * Open a serial connection to the ESP32.\n * Triggers browser port selection dialog.\n */\n async open(): Promise<void> {\n if (!SerialConnection.isSupported()) {\n throw new Error(\n \"Web Serial API not supported. Use Chrome, Edge, or Opera.\"\n );\n }\n\n this.port = await navigator.serial.requestPort({ filters: this.filters });\n await this.port.open({\n baudRate: this.baudRate,\n dataBits: 8,\n stopBits: 1,\n parity: \"none\",\n flowControl: \"none\",\n bufferSize: 8192,\n });\n\n // Set up readable stream (text decoding)\n const decoder = new TextDecoderStream();\n this.readableStreamClosed = this.port.readable!.pipeTo(decoder.writable as unknown as WritableStream<Uint8Array>);\n this.reader = decoder.readable.getReader();\n\n // Set up writable stream (text encoding)\n const encoder = new TextEncoderStream();\n this.writableStreamClosed = encoder.readable.pipeTo(this.port.writable!);\n this.writer = encoder.writable.getWriter();\n\n // Start background read loop\n this.isReading = true;\n void this.readLoop();\n\n // Give the ESP32 CDC port time to settle after connect/re-enumeration.\n await this.delay(1200);\n this.responseQueue = [];\n }\n\n /**\n * Close the serial connection.\n */\n async close(): Promise<void> {\n this.isReading = false;\n\n if (this.reader) {\n await this.reader.cancel();\n await this.readableStreamClosed?.catch(() => {});\n this.reader = null;\n }\n\n if (this.writer) {\n await this.writer.close();\n await this.writableStreamClosed;\n this.writer = null;\n }\n\n if (this.port) {\n await this.port.close();\n this.port = null;\n }\n\n this.responseQueue = [];\n }\n\n /**\n * Whether the serial port is currently connected.\n */\n get connected(): boolean {\n return this.port !== null && this.writer !== null;\n }\n\n /**\n * Send a JSON command to the device and wait for a JSON response.\n *\n * @param command - The command object (e.g. { action: \"info\" })\n * @param timeoutMs - Response timeout in milliseconds (default: 65000 for sign operations)\n * @returns The parsed device response\n */\n async sendCommand(\n command: Record<string, unknown>,\n timeoutMs = 65000\n ): Promise<DeviceResponse> {\n if (!this.writer) {\n throw new Error(\"Serial port not connected\");\n }\n\n // Clear stale responses\n this.responseQueue = [];\n\n // Send JSON in small chunks, then newline to trigger processing.\n // The ESP32 CDC serial buffer can lose data if sent too fast in one write.\n const json = JSON.stringify(command);\n console.debug(\"[NeuraiESP32 Serial] Sending command\", {\n action: command.action,\n payloadLength: json.length + 1,\n timeoutMs,\n });\n await this.writeChunked(json);\n await this.writer.ready;\n await this.writer.write(\"\\n\");\n\n // Wait for response\n const response = await this.waitForResponse(timeoutMs);\n if (!response) {\n throw new Error(\"Device response timeout\");\n }\n\n return response;\n }\n\n /**\n * Send a command and wait, skipping intermediate \"processing\" status messages.\n * Useful for sign_psbt which sends a processing ACK before the actual response.\n */\n async sendCommandFinal(\n command: Record<string, unknown>,\n timeoutMs = 65000\n ): Promise<DeviceResponse> {\n if (!this.writer) {\n throw new Error(\"Serial port not connected\");\n }\n\n this.responseQueue = [];\n\n const json = JSON.stringify(command);\n console.debug(\"[NeuraiESP32 Serial] Sending command\", {\n action: command.action,\n payloadLength: json.length + 1,\n timeoutMs,\n });\n await this.writeChunked(json);\n await this.writer.ready;\n await this.writer.write(\"\\n\");\n\n // Wait for a non-processing response\n const startTime = Date.now();\n while (Date.now() - startTime < timeoutMs) {\n const response = await this.waitForResponse(\n timeoutMs - (Date.now() - startTime)\n );\n if (!response) {\n throw new Error(\"Device response timeout\");\n }\n // Skip intermediate \"processing\" status\n if (response.status === \"processing\") {\n continue;\n }\n return response;\n }\n\n throw new Error(\"Device response timeout\");\n }\n\n // ─── Private ──────────────────────────────────────────────────────────────\n\n private async readLoop(): Promise<void> {\n let buffer = \"\";\n\n while (this.isReading && this.reader) {\n try {\n const { value, done } = await this.reader.read();\n if (done) break;\n\n buffer += value;\n\n // Process complete lines\n const lines = buffer.split(\"\\n\");\n buffer = lines.pop() ?? \"\"; // Keep incomplete line in buffer\n\n for (const rawLine of lines) {\n const line = rawLine.trim().replace(/\\r/g, \"\");\n if (line.length === 0) continue;\n\n // Try to parse as JSON response\n if (line.startsWith(\"{\")) {\n try {\n const data = JSON.parse(line) as DeviceResponse;\n console.debug(\"[NeuraiESP32 Serial] JSON line received\", data);\n this.responseQueue.push(data);\n } catch {\n console.debug(\"[NeuraiESP32 Serial] Invalid JSON line\", line);\n }\n } else {\n console.debug(\"[NeuraiESP32 Serial] Non-JSON serial line\", line);\n }\n }\n } catch {\n // Read error — connection may have been closed\n break;\n }\n }\n }\n\n private waitForResponse(timeoutMs: number): Promise<DeviceResponse | null> {\n return new Promise((resolve) => {\n const startTime = Date.now();\n const check = () => {\n if (this.responseQueue.length > 0) {\n const response = this.responseQueue.shift()!;\n console.debug(\"[NeuraiESP32 Serial] Response dequeued\", {\n waitedMs: Date.now() - startTime,\n pendingResponses: this.responseQueue.length,\n status: response.status,\n });\n resolve(response);\n } else if (Date.now() - startTime > timeoutMs) {\n console.error(\"[NeuraiESP32 Serial] Response timeout\", {\n timeoutMs,\n queuedResponses: this.responseQueue.length,\n });\n resolve(null);\n } else {\n setTimeout(check, 50);\n }\n };\n check();\n });\n }\n\n /**\n * Write data in small chunks with pauses between them.\n *\n * The ESP32 CDC serial buffer can lose data when the host sends a large\n * payload in a single write. Splitting into 32-byte chunks with a 4 ms\n * pause gives the firmware time to drain its receive buffer.\n */\n private async writeChunked(\n data: string,\n chunkSize = 32,\n pauseMs = 4\n ): Promise<void> {\n if (!this.writer) {\n throw new Error(\"Serial port not connected\");\n }\n\n for (let offset = 0; offset < data.length; offset += chunkSize) {\n const chunk = data.slice(offset, offset + chunkSize);\n await this.writer.ready;\n await this.writer.write(chunk);\n if (offset + chunkSize < data.length) {\n await this.delay(pauseMs);\n }\n }\n }\n\n private delay(ms: number): Promise<void> {\n return new Promise((resolve) => setTimeout(resolve, ms));\n }\n}\n","/**\n * PSBT helpers for Neurai P2PKH transactions.\n *\n * This package supports two build paths:\n * - high-level build from UTXOs + outputs + fee estimation\n * - low-level build from an already-created raw unsigned transaction\n *\n * The second path matches the webwallet integration, where coin selection\n * and fee calculation already happen elsewhere.\n */\n\nimport { Buffer } from \"buffer\";\nimport * as bitcoin from \"bitcoinjs-lib\";\nimport { getNetwork } from \"./networks.js\";\nimport type {\n IBuildPSBTFromRawOptions,\n IBuildPSBTOptions,\n IPSBTInputMetadata,\n NetworkType,\n} from \"./types.js\";\n\nconst DEFAULT_FEE_RATE = 1024; // sat/byte\n\nconst TX_OVERHEAD = 10;\nconst INPUT_SIZE = 148;\nconst OUTPUT_SIZE = 34;\n\nfunction estimateTxSize(inputCount: number, outputCount: number): number {\n return TX_OVERHEAD + inputCount * INPUT_SIZE + outputCount * OUTPUT_SIZE;\n}\n\nfunction parseMasterFingerprint(hex: string): Buffer {\n if (hex.length !== 8) {\n throw new Error(\n `Invalid master fingerprint: expected 8 hex chars, got ${hex.length}`\n );\n }\n return Buffer.from(hex, \"hex\");\n}\n\nexport function buildPSBT(options: IBuildPSBTOptions): string {\n const {\n network,\n utxos,\n outputs,\n changeAddress,\n pubkey,\n masterFingerprint,\n derivationPath,\n feeRate = DEFAULT_FEE_RATE,\n } = options;\n\n if (utxos.length === 0) {\n throw new Error(\"No UTXOs provided\");\n }\n if (outputs.length === 0) {\n throw new Error(\"No outputs provided\");\n }\n\n const totalOutputValue = outputs.reduce((sum, output) => sum + output.value, 0);\n const totalInputValue = utxos.reduce((sum, utxo) => sum + utxo.satoshis, 0);\n const estimatedSize = estimateTxSize(utxos.length, outputs.length + 1);\n const fee = estimatedSize * feeRate;\n const change = totalInputValue - totalOutputValue - fee;\n\n if (change < 0) {\n throw new Error(\n `Insufficient funds: inputs=${totalInputValue}, outputs=${totalOutputValue}, fee=${fee}`\n );\n }\n\n const psbt = new bitcoin.Psbt({ network: getNetwork(network) });\n const bip32Derivation = [\n {\n masterFingerprint: parseMasterFingerprint(masterFingerprint),\n path: derivationPath,\n pubkey: Buffer.from(pubkey, \"hex\"),\n },\n ];\n\n for (const utxo of utxos) {\n psbt.addInput({\n hash: utxo.txid,\n index: utxo.vout,\n nonWitnessUtxo: Buffer.from(utxo.rawTxHex, \"hex\"),\n bip32Derivation,\n });\n }\n\n for (const output of outputs) {\n psbt.addOutput({\n address: output.address,\n value: BigInt(output.value),\n });\n }\n\n const DUST_THRESHOLD = 546;\n if (change >= DUST_THRESHOLD) {\n psbt.addOutput({\n address: changeAddress,\n value: BigInt(change),\n bip32Derivation,\n });\n }\n\n return psbt.toBase64();\n}\n\nexport function buildPSBTFromRawTransaction(options: IBuildPSBTFromRawOptions): string {\n const network = getNetwork(options.network);\n const tx = bitcoin.Transaction.fromHex(options.rawUnsignedTransaction);\n const psbt = new bitcoin.Psbt({ network });\n\n psbt.setVersion(tx.version);\n psbt.setLocktime(tx.locktime);\n\n for (let index = 0; index < tx.ins.length; index += 1) {\n const input = tx.ins[index];\n const metadata = options.inputs[index];\n\n if (!metadata) {\n throw new Error(`Missing input metadata for input #${index}`);\n }\n\n psbt.addInput({\n hash: metadata.txid,\n index: metadata.vout,\n sequence: metadata.sequence ?? input.sequence,\n nonWitnessUtxo: Buffer.from(metadata.rawTxHex, \"hex\"),\n bip32Derivation: [\n {\n masterFingerprint: parseMasterFingerprint(metadata.masterFingerprint),\n path: metadata.derivationPath,\n pubkey: Buffer.from(metadata.pubkey, \"hex\"),\n },\n ],\n });\n }\n\n for (const output of tx.outs) {\n psbt.addOutput({\n script: Buffer.from(output.script),\n value: output.value,\n });\n }\n\n return psbt.toBase64();\n}\n\nexport function finalizePSBT(\n signedPsbtBase64: string,\n network: NetworkType\n): { txHex: string; txId: string } {\n const psbt = bitcoin.Psbt.fromBase64(signedPsbtBase64, {\n network: getNetwork(network),\n });\n\n psbt.finalizeAllInputs();\n\n const tx = psbt.extractTransaction();\n return {\n txHex: tx.toHex(),\n txId: tx.getId(),\n };\n}\n\nexport function finalizeSignedPSBT(\n originalPsbtBase64: string,\n signedPsbtBase64: string,\n network: NetworkType\n): { txHex: string; txId: string } {\n const net = getNetwork(network);\n const psbt = bitcoin.Psbt.fromBase64(originalPsbtBase64, { network: net });\n\n let mergedWithStandardPsbt = false;\n try {\n const signedPsbt = bitcoin.Psbt.fromBase64(signedPsbtBase64, { network: net });\n psbt.combine(signedPsbt);\n mergedWithStandardPsbt = true;\n } catch {\n // uNeurai can return a minimal signed PSBT that bitcoinjs-lib cannot fully parse.\n }\n\n if (!mergedWithStandardPsbt) {\n const partialSigsByInput = extractPartialSigsFromUNeuraiPsbt(\n originalPsbtBase64,\n signedPsbtBase64,\n psbt.inputCount\n );\n\n partialSigsByInput.forEach((partialSig, index) => {\n if (partialSig.length === 0) {\n return;\n }\n psbt.updateInput(index, { partialSig });\n });\n }\n\n try {\n psbt.finalizeAllInputs();\n } catch {\n finalizeLegacyP2pkhInputs(psbt);\n }\n\n const tx = psbt.extractTransaction(true);\n return {\n txHex: tx.toHex(),\n txId: tx.getId(),\n };\n}\n\nexport function validatePSBT(psbtBase64: string, network: NetworkType): boolean {\n try {\n bitcoin.Psbt.fromBase64(psbtBase64, { network: getNetwork(network) });\n return true;\n } catch {\n return false;\n }\n}\n\nfunction extractPartialSigsFromUNeuraiPsbt(\n originalBase64: string,\n signedBase64: string,\n inputCount: number\n) {\n const originalBuffer = Buffer.from(originalBase64, \"base64\");\n const buffer = Buffer.from(signedBase64, \"base64\");\n const partialSigsByInput: { pubkey: Buffer; signature: Buffer }[][] = Array.from(\n { length: inputCount },\n () => []\n );\n\n if (buffer.length < 5 || buffer.toString(\"ascii\", 0, 4) !== \"psbt\" || buffer[4] !== 0xff) {\n throw new Error(\"NeuraiHW returned an invalid PSBT header\");\n }\n\n let offset = getFirstInputSectionOffset(originalBuffer);\n\n for (let inputIndex = 0; inputIndex < inputCount; inputIndex += 1) {\n while (offset < buffer.length) {\n const keyLen = readPsbtVarInt(buffer, offset);\n offset += keyLen.size;\n\n if (keyLen.value === 0) {\n break;\n }\n\n const key = buffer.subarray(offset, offset + keyLen.value);\n offset += keyLen.value;\n\n const valueLen = readPsbtVarInt(buffer, offset);\n offset += valueLen.size;\n const value = buffer.subarray(offset, offset + valueLen.value);\n offset += valueLen.value;\n\n if (key.length > 1 && key[0] === 0x02) {\n partialSigsByInput[inputIndex].push({\n pubkey: Buffer.from(key.subarray(1)),\n signature: Buffer.from(value),\n });\n }\n }\n }\n\n return partialSigsByInput;\n}\n\nfunction getFirstInputSectionOffset(buffer: Buffer) {\n if (buffer.length < 5 || buffer.toString(\"ascii\", 0, 4) !== \"psbt\" || buffer[4] !== 0xff) {\n throw new Error(\"Invalid original PSBT header\");\n }\n\n let offset = 5;\n\n const globalKeyLen = readPsbtVarInt(buffer, offset);\n offset += globalKeyLen.size + globalKeyLen.value;\n\n const globalValueLen = readPsbtVarInt(buffer, offset);\n offset += globalValueLen.size + globalValueLen.value;\n\n if (offset >= buffer.length || buffer[offset] !== 0x00) {\n throw new Error(\"Invalid original PSBT global section\");\n }\n\n return offset + 1;\n}\n\nfunction readPsbtVarInt(buffer: Buffer, offset: number) {\n if (offset >= buffer.length) {\n throw new Error(\"Format Error: Unexpected End of PSBT\");\n }\n\n const first = buffer[offset];\n if (first < 0xfd) {\n return { value: first, size: 1 };\n }\n if (first === 0xfd) {\n if (offset + 2 >= buffer.length) {\n throw new Error(\"Format Error: Unexpected End of PSBT\");\n }\n return { value: buffer.readUInt16LE(offset + 1), size: 3 };\n }\n if (first === 0xfe) {\n if (offset + 4 >= buffer.length) {\n throw new Error(\"Format Error: Unexpected End of PSBT\");\n }\n return { value: buffer.readUInt32LE(offset + 1), size: 5 };\n }\n throw new Error(\"PSBT values larger than 32 bits are not supported\");\n}\n\nfunction finalizeLegacyP2pkhInputs(psbt: bitcoin.Psbt) {\n for (let index = 0; index < psbt.inputCount; index += 1) {\n const input = psbt.data.inputs[index];\n if (input.finalScriptSig || input.finalScriptWitness) {\n continue;\n }\n\n const partialSig = input.partialSig?.[0];\n const nonWitnessUtxo = input.nonWitnessUtxo;\n const txInput = psbt.txInputs[index];\n\n if (!partialSig || !nonWitnessUtxo || !txInput) {\n throw new Error(`Missing data to finalize input #${index}`);\n }\n\n const prevTx = bitcoin.Transaction.fromBuffer(nonWitnessUtxo);\n const prevOut = prevTx.outs[txInput.index];\n if (!prevOut) {\n throw new Error(`Missing prevout to finalize input #${index}`);\n }\n\n psbt.finalizeInput(index, () => ({\n finalScriptSig: bitcoin.script.compile([\n partialSig.signature,\n partialSig.pubkey,\n ]),\n finalScriptWitness: undefined,\n }));\n }\n}\n","/**\n * Neurai network configurations for bitcoinjs-lib\n *\n * Defines all Neurai networks (mainnet, testnet, legacy variants)\n * in the format required by bitcoinjs-lib v7.\n */\n\nimport type { Network } from \"bitcoinjs-lib\";\nimport type { NetworkType } from \"./types.js\";\n\n// ─── Neurai Mainnet (coin type 1900) ────────────────────────────────────────\n\nexport const neuraiMainnet: Network = {\n messagePrefix: \"Neurai Signed Message:\\n\",\n bech32: \"\",\n bip32: {\n public: 76067358,\n private: 76066276,\n },\n pubKeyHash: 53, // 0x35 → prefix \"N\"\n scriptHash: 117, // 0x75\n wif: 128, // 0x80\n};\n\n// ─── Neurai Testnet ──────────────────────────────────────────────────────────\n\nexport const neuraiTestnet: Network = {\n messagePrefix: \"Neurai Signed Message:\\n\",\n bech32: \"\",\n bip32: {\n public: 70617039,\n private: 70615956,\n },\n pubKeyHash: 127, // 0x7f\n scriptHash: 196, // 0xc4\n wif: 239, // 0xef\n};\n\n// ─── Neurai Legacy Mainnet (coin type 0) ─────────────────────────────────────\n\nexport const neuraiLegacyMainnet: Network = {\n messagePrefix: \"Neurai Signed Message:\\n\",\n bech32: \"\",\n bip32: {\n public: 76067358,\n private: 76066276,\n },\n pubKeyHash: 53,\n scriptHash: 117,\n wif: 128,\n};\n\n// ─── Neurai Legacy Testnet ───────────────────────────────────────────────────\n\nexport const neuraiLegacyTestnet: Network = {\n messagePrefix: \"Neurai Signed Message:\\n\",\n bech32: \"\",\n bip32: {\n public: 70617039,\n private: 70615956,\n },\n pubKeyHash: 127,\n scriptHash: 196,\n wif: 239,\n};\n\n// ─── Network map ─────────────────────────────────────────────────────────────\n\nconst networkMap: Record<NetworkType, Network> = {\n xna: neuraiMainnet,\n \"xna-test\": neuraiTestnet,\n \"xna-legacy\": neuraiLegacyMainnet,\n \"xna-legacy-test\": neuraiLegacyTestnet,\n};\n\n/**\n * Get the bitcoinjs-lib Network object for a given Neurai network type.\n */\nexport function getNetwork(network: NetworkType): Network {\n const net = networkMap[network];\n if (!net) {\n throw new Error(`Unknown network: ${network}`);\n }\n return net;\n}\n","import type {\n IAssetTransferDisplayMetadata,\n IBuildAssetTransferDisplayMetadataOptions,\n} from \"./types.js\";\n\nfunction formatAmount(value: number | string): string {\n if (typeof value === \"string\") {\n return value;\n }\n return value.toFixed(8);\n}\n\nexport function buildAssetTransferDisplayMetadata(\n options: IBuildAssetTransferDisplayMetadataOptions\n): IAssetTransferDisplayMetadata {\n return {\n kind: \"asset_transfer\",\n assetName: options.assetName,\n assetAmount: formatAmount(options.assetAmount),\n destinationAddress: options.destinationAddress,\n destinationCount: options.destinationCount ?? 1,\n changeAddress: options.changeAddress,\n changeCount: options.changeCount ?? 0,\n inputAddresses: options.inputAddresses ?? [],\n feeAmount:\n options.feeAmount === undefined ? undefined : formatAmount(options.feeAmount),\n baseCurrency: options.baseCurrency ?? \"XNA\",\n };\n}\n"],"names":[],"version":3,"file":"index.mjs.map"}
|