@shadow-corp/nearconnect 1.0.0

package/build/hardware/transport.d.ts

@@ -0,0 +1,94 @@
+/**
+ * Ledger Transport Layer
+ *
+ * Low-level WebHID communication with Ledger devices
+ */
+import { type APDUCommand, type APDUResponse, type LedgerModel } from './types';
+declare global {
+    interface Navigator {
+        hid?: HID;
+    }
+    interface HID {
+        requestDevice(options: {
+            filters: Array<{
+                vendorId: number;
+            }>;
+        }): Promise<HIDDevice[]>;
+    }
+    interface HIDDevice {
+        opened: boolean;
+        vendorId: number;
+        productId: number;
+        open(): Promise<void>;
+        close(): Promise<void>;
+        sendReport(reportId: number, data: Uint8Array): Promise<void>;
+        addEventListener(type: 'inputreport', listener: (event: HIDInputReportEvent) => void): void;
+    }
+    interface HIDInputReportEvent {
+        data: DataView;
+    }
+}
+/**
+ * Ledger WebHID Transport
+ *
+ * Handles low-level communication with Ledger devices via WebHID API.
+ * Implements the Ledger HID framing protocol.
+ */
+export declare class LedgerTransport {
+    private device;
+    private responseBuffer;
+    private pendingResolve;
+    private pendingReject;
+    constructor();
+    /**
+     * Check if WebHID is supported in this browser
+     */
+    static isSupported(): boolean;
+    /**
+     * Request user to select a Ledger device
+     */
+    connect(): Promise<void>;
+    /**
+     * Disconnect from the device
+     */
+    disconnect(): Promise<void>;
+    /**
+     * Check if connected to a device
+     */
+    isConnected(): boolean;
+    /**
+     * Get device info
+     */
+    getDeviceInfo(): {
+        vendorId: number;
+        productId: number;
+    } | null;
+    /**
+     * Send an APDU command and receive response
+     */
+    send(command: APDUCommand, timeout?: number): Promise<APDUResponse>;
+    /**
+     * Build APDU buffer from command
+     */
+    private buildAPDU;
+    /**
+     * Frame APDU into HID packets
+     *
+     * Ledger HID protocol:
+     * - First packet: [channel (2)] [tag (1)] [seq (2)] [length (2)] [data...]
+     * - Subsequent: [channel (2)] [tag (1)] [seq (2)] [data...]
+     */
+    private frameAPDU;
+    /**
+     * Handle incoming HID report
+     */
+    private handleInputReport;
+    /**
+     * Wait for response with timeout
+     */
+    private waitForResponse;
+}
+/**
+ * Detect Ledger model from product ID
+ */
+export declare function detectLedgerModel(productId: number): LedgerModel;

package/build/hardware/transport.js

@@ -0,0 +1,267 @@
+"use strict";
+/**
+ * Ledger Transport Layer
+ *
+ * Low-level WebHID communication with Ledger devices
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LedgerTransport = void 0;
+exports.detectLedgerModel = detectLedgerModel;
+const types_1 = require("./types");
+const errors_1 = require("./errors");
+// =============================================================================
+// Constants
+// =============================================================================
+const LEDGER_VENDOR_ID = 0x2c97;
+const HID_PACKET_SIZE = 64;
+const CHANNEL_ID = 0x0101;
+const TAG_APDU = 0x05;
+// =============================================================================
+// Transport Class
+// =============================================================================
+/**
+ * Ledger WebHID Transport
+ *
+ * Handles low-level communication with Ledger devices via WebHID API.
+ * Implements the Ledger HID framing protocol.
+ */
+class LedgerTransport {
+    device = null;
+    responseBuffer = new Uint8Array(0);
+    pendingResolve = null;
+    pendingReject = null;
+    constructor() {
+        // Check WebHID support on construction
+        if (!LedgerTransport.isSupported()) {
+            throw (0, errors_1.createHardwareError)(types_1.HardwareErrorCode.WEBHID_NOT_SUPPORTED);
+        }
+    }
+    /**
+     * Check if WebHID is supported in this browser
+     */
+    static isSupported() {
+        return typeof navigator !== 'undefined' && 'hid' in navigator;
+    }
+    /**
+     * Request user to select a Ledger device
+     */
+    async connect() {
+        if (this.device?.opened) {
+            return;
+        }
+        try {
+            // Request device from user
+            const devices = await navigator.hid.requestDevice({
+                filters: [{ vendorId: LEDGER_VENDOR_ID }],
+            });
+            if (devices.length === 0) {
+                throw (0, errors_1.createHardwareError)(types_1.HardwareErrorCode.DEVICE_NOT_FOUND);
+            }
+            this.device = devices[0];
+            await this.device.open();
+            // Set up input report handler
+            this.device.addEventListener('inputreport', this.handleInputReport.bind(this));
+        }
+        catch (error) {
+            if (error instanceof DOMException) {
+                if (error.name === 'NotAllowedError') {
+                    throw (0, errors_1.createHardwareError)(types_1.HardwareErrorCode.USER_REJECTED, 'User cancelled device selection');
+                }
+                if (error.name === 'NotFoundError') {
+                    throw (0, errors_1.createHardwareError)(types_1.HardwareErrorCode.DEVICE_NOT_FOUND);
+                }
+            }
+            throw error;
+        }
+    }
+    /**
+     * Disconnect from the device
+     */
+    async disconnect() {
+        if (this.device) {
+            try {
+                await this.device.close();
+            }
+            catch {
+                // Ignore close errors
+            }
+            this.device = null;
+        }
+        this.responseBuffer = new Uint8Array(0);
+        this.pendingResolve = null;
+        this.pendingReject = null;
+    }
+    /**
+     * Check if connected to a device
+     */
+    isConnected() {
+        return this.device?.opened ?? false;
+    }
+    /**
+     * Get device info
+     */
+    getDeviceInfo() {
+        if (!this.device)
+            return null;
+        return {
+            vendorId: this.device.vendorId,
+            productId: this.device.productId,
+        };
+    }
+    /**
+     * Send an APDU command and receive response
+     */
+    async send(command, timeout = 30000) {
+        if (!this.device?.opened) {
+            throw (0, errors_1.createHardwareError)(types_1.HardwareErrorCode.DEVICE_NOT_FOUND);
+        }
+        // Build APDU
+        const apdu = this.buildAPDU(command);
+        // Frame into HID packets
+        const packets = this.frameAPDU(apdu);
+        // Send all packets
+        for (const packet of packets) {
+            await this.device.sendReport(0, packet);
+        }
+        // Wait for response with timeout
+        const responseData = await this.waitForResponse(timeout);
+        // Parse response
+        const statusCode = (responseData[responseData.length - 2] << 8) | responseData[responseData.length - 1];
+        const data = responseData.slice(0, -2);
+        return { data, statusCode };
+    }
+    /**
+     * Build APDU buffer from command
+     */
+    buildAPDU(command) {
+        const dataLength = command.data?.length ?? 0;
+        const apdu = new Uint8Array(5 + dataLength);
+        apdu[0] = command.cla;
+        apdu[1] = command.ins;
+        apdu[2] = command.p1;
+        apdu[3] = command.p2;
+        apdu[4] = dataLength;
+        if (command.data) {
+            apdu.set(command.data, 5);
+        }
+        return apdu;
+    }
+    /**
+     * Frame APDU into HID packets
+     *
+     * Ledger HID protocol:
+     * - First packet: [channel (2)] [tag (1)] [seq (2)] [length (2)] [data...]
+     * - Subsequent: [channel (2)] [tag (1)] [seq (2)] [data...]
+     */
+    frameAPDU(apdu) {
+        const packets = [];
+        let offset = 0;
+        let sequence = 0;
+        // First packet includes length
+        const firstPacket = new Uint8Array(HID_PACKET_SIZE);
+        firstPacket[0] = CHANNEL_ID >> 8;
+        firstPacket[1] = CHANNEL_ID & 0xff;
+        firstPacket[2] = TAG_APDU;
+        firstPacket[3] = sequence >> 8;
+        firstPacket[4] = sequence & 0xff;
+        firstPacket[5] = apdu.length >> 8;
+        firstPacket[6] = apdu.length & 0xff;
+        const firstDataLength = Math.min(apdu.length, HID_PACKET_SIZE - 7);
+        firstPacket.set(apdu.slice(0, firstDataLength), 7);
+        packets.push(firstPacket);
+        offset = firstDataLength;
+        sequence++;
+        // Subsequent packets
+        while (offset < apdu.length) {
+            const packet = new Uint8Array(HID_PACKET_SIZE);
+            packet[0] = CHANNEL_ID >> 8;
+            packet[1] = CHANNEL_ID & 0xff;
+            packet[2] = TAG_APDU;
+            packet[3] = sequence >> 8;
+            packet[4] = sequence & 0xff;
+            const dataLength = Math.min(apdu.length - offset, HID_PACKET_SIZE - 5);
+            packet.set(apdu.slice(offset, offset + dataLength), 5);
+            packets.push(packet);
+            offset += dataLength;
+            sequence++;
+        }
+        return packets;
+    }
+    /**
+     * Handle incoming HID report
+     */
+    handleInputReport(event) {
+        const data = new Uint8Array(event.data.buffer);
+        // Check channel and tag
+        const channel = (data[0] << 8) | data[1];
+        const tag = data[2];
+        if (channel !== CHANNEL_ID || tag !== TAG_APDU) {
+            return;
+        }
+        const sequence = (data[3] << 8) | data[4];
+        if (sequence === 0) {
+            // First packet - get total length
+            const totalLength = (data[5] << 8) | data[6];
+            this.responseBuffer = new Uint8Array(totalLength);
+            const dataStart = 7;
+            const dataLength = Math.min(totalLength, HID_PACKET_SIZE - dataStart);
+            this.responseBuffer.set(data.slice(dataStart, dataStart + dataLength), 0);
+        }
+        else {
+            // Subsequent packet
+            const dataStart = 5;
+            const offset = HID_PACKET_SIZE - 7 + (sequence - 1) * (HID_PACKET_SIZE - 5);
+            const remaining = this.responseBuffer.length - offset;
+            const dataLength = Math.min(remaining, HID_PACKET_SIZE - dataStart);
+            this.responseBuffer.set(data.slice(dataStart, dataStart + dataLength), offset);
+        }
+        // Check if we have complete response
+        const expectedPackets = Math.ceil((this.responseBuffer.length + 7) / (HID_PACKET_SIZE - 5));
+        const isComplete = sequence >= expectedPackets - 1;
+        if (isComplete && this.pendingResolve) {
+            this.pendingResolve(this.responseBuffer);
+            this.pendingResolve = null;
+            this.pendingReject = null;
+        }
+    }
+    /**
+     * Wait for response with timeout
+     */
+    waitForResponse(timeout) {
+        return new Promise((resolve, reject) => {
+            this.pendingResolve = resolve;
+            this.pendingReject = reject;
+            this.responseBuffer = new Uint8Array(0);
+            const timeoutId = setTimeout(() => {
+                this.pendingResolve = null;
+                this.pendingReject = null;
+                reject((0, errors_1.createHardwareError)(types_1.HardwareErrorCode.TIMEOUT));
+            }, timeout);
+            // Store original resolve to clear timeout
+            const originalResolve = this.pendingResolve;
+            this.pendingResolve = (data) => {
+                clearTimeout(timeoutId);
+                originalResolve(data);
+            };
+        });
+    }
+}
+exports.LedgerTransport = LedgerTransport;
+/**
+ * Detect Ledger model from product ID
+ */
+function detectLedgerModel(productId) {
+    switch (productId) {
+        case types_1.LEDGER_PRODUCT_IDS.NANO_S:
+            return 'nano-s';
+        case types_1.LEDGER_PRODUCT_IDS.NANO_S_PLUS:
+            return 'nano-s-plus';
+        case types_1.LEDGER_PRODUCT_IDS.NANO_X:
+            return 'nano-x';
+        case types_1.LEDGER_PRODUCT_IDS.STAX:
+            return 'stax';
+        default:
+            return 'unknown';
+    }
+}
+//# sourceMappingURL=transport.js.map

package/build/hardware/transport.js.map

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

package/build/hardware/types.d.ts

@@ -0,0 +1,98 @@
+/**
+ * Hardware Wallet Types
+ *
+ * Types, constants, and interfaces for hardware wallet support
+ */
+export type HardwareWalletType = 'ledger' | 'trezor';
+/** NEAR app CLA byte */
+export declare const NEAR_CLA = 128;
+/** NEAR app instruction codes */
+export declare const NEAR_INS: {
+    readonly GET_VERSION: 0;
+    readonly GET_PUBLIC_KEY: 4;
+    readonly SIGN_TRANSACTION: 2;
+    readonly SIGN_NEP413_MESSAGE: 7;
+};
+/** Ledger status codes */
+export declare const LEDGER_STATUS: {
+    readonly OK: 36864;
+    readonly WRONG_LENGTH: 26368;
+    readonly INVALID_DATA: 27264;
+    readonly CONDITIONS_NOT_SATISFIED: 27013;
+    readonly COMMAND_NOT_ALLOWED: 27014;
+    readonly INS_NOT_SUPPORTED: 27904;
+    readonly CLA_NOT_SUPPORTED: 28160;
+    readonly APP_NOT_OPEN: 28161;
+    readonly UNKNOWN: 28416;
+    readonly USER_REJECTED: 27013;
+    readonly DEVICE_LOCKED: 27010;
+};
+/** Default BIP44 derivation path for NEAR */
+export declare const DEFAULT_DERIVATION_PATH = "44'/397'/0'/0'/1'";
+/** Ledger device product IDs for model detection */
+export declare const LEDGER_PRODUCT_IDS: {
+    readonly NANO_S: 4113;
+    readonly NANO_S_PLUS: 20497;
+    readonly NANO_X: 16401;
+    readonly STAX: 24593;
+};
+export declare enum HardwareErrorCode {
+    DEVICE_NOT_FOUND = "DEVICE_NOT_FOUND",
+    DEVICE_LOCKED = "DEVICE_LOCKED",
+    DEVICE_BUSY = "DEVICE_BUSY",
+    CONNECTION_FAILED = "CONNECTION_FAILED",
+    DISCONNECTED = "DISCONNECTED",
+    APP_NOT_OPEN = "APP_NOT_OPEN",
+    WRONG_APP = "WRONG_APP",
+    APP_VERSION_UNSUPPORTED = "APP_VERSION_UNSUPPORTED",
+    USER_REJECTED = "USER_REJECTED",
+    TIMEOUT = "TIMEOUT",
+    INVALID_DATA = "INVALID_DATA",
+    DERIVATION_PATH_ERROR = "DERIVATION_PATH_ERROR",
+    TRANSACTION_TOO_LARGE = "TRANSACTION_TOO_LARGE",
+    TRANSPORT_ERROR = "TRANSPORT_ERROR",
+    WEBHID_NOT_SUPPORTED = "WEBHID_NOT_SUPPORTED",
+    UNKNOWN = "UNKNOWN"
+}
+export interface LedgerConfig {
+    enabled?: boolean;
+    derivationPath?: string;
+}
+export interface TrezorConfig {
+    enabled?: boolean;
+    derivationPath?: string;
+}
+export interface HardwareConfig {
+    ledger?: LedgerConfig | boolean;
+    trezor?: TrezorConfig | boolean;
+}
+export type LedgerModel = 'nano-s' | 'nano-s-plus' | 'nano-x' | 'stax' | 'unknown';
+export interface LedgerDeviceInfo {
+    model: LedgerModel;
+    nearAppVersion?: string;
+}
+export interface APDUCommand {
+    cla: number;
+    ins: number;
+    p1: number;
+    p2: number;
+    data?: Uint8Array;
+}
+export interface APDUResponse {
+    data: Uint8Array;
+    statusCode: number;
+}
+export interface HardwareWaitingEvent {
+    walletId: string;
+    action: 'connect' | 'get_public_key' | 'sign' | 'sign_message';
+    message: string;
+}
+export interface HardwareConfirmEvent {
+    walletId: string;
+    action: 'connect' | 'get_public_key' | 'sign' | 'sign_message';
+}
+export interface HardwareRejectedEvent {
+    walletId: string;
+    action: 'connect' | 'get_public_key' | 'sign' | 'sign_message';
+    reason: string;
+}

package/build/hardware/types.js

@@ -0,0 +1,72 @@
+"use strict";
+/**
+ * Hardware Wallet Types
+ *
+ * Types, constants, and interfaces for hardware wallet support
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HardwareErrorCode = exports.LEDGER_PRODUCT_IDS = exports.DEFAULT_DERIVATION_PATH = exports.LEDGER_STATUS = exports.NEAR_INS = exports.NEAR_CLA = void 0;
+// =============================================================================
+// Ledger Constants
+// =============================================================================
+/** NEAR app CLA byte */
+exports.NEAR_CLA = 0x80;
+/** NEAR app instruction codes */
+exports.NEAR_INS = {
+    GET_VERSION: 0x00,
+    GET_PUBLIC_KEY: 0x04,
+    SIGN_TRANSACTION: 0x02,
+    SIGN_NEP413_MESSAGE: 0x07,
+};
+/** Ledger status codes */
+exports.LEDGER_STATUS = {
+    OK: 0x9000,
+    WRONG_LENGTH: 0x6700,
+    INVALID_DATA: 0x6a80,
+    CONDITIONS_NOT_SATISFIED: 0x6985,
+    COMMAND_NOT_ALLOWED: 0x6986,
+    INS_NOT_SUPPORTED: 0x6d00,
+    CLA_NOT_SUPPORTED: 0x6e00,
+    APP_NOT_OPEN: 0x6e01,
+    UNKNOWN: 0x6f00,
+    USER_REJECTED: 0x6985,
+    DEVICE_LOCKED: 0x6982,
+};
+/** Default BIP44 derivation path for NEAR */
+exports.DEFAULT_DERIVATION_PATH = "44'/397'/0'/0'/1'";
+/** Ledger device product IDs for model detection */
+exports.LEDGER_PRODUCT_IDS = {
+    NANO_S: 0x1011,
+    NANO_S_PLUS: 0x5011,
+    NANO_X: 0x4011,
+    STAX: 0x6011,
+};
+// =============================================================================
+// Hardware Error Codes
+// =============================================================================
+var HardwareErrorCode;
+(function (HardwareErrorCode) {
+    // Device errors
+    HardwareErrorCode["DEVICE_NOT_FOUND"] = "DEVICE_NOT_FOUND";
+    HardwareErrorCode["DEVICE_LOCKED"] = "DEVICE_LOCKED";
+    HardwareErrorCode["DEVICE_BUSY"] = "DEVICE_BUSY";
+    HardwareErrorCode["CONNECTION_FAILED"] = "CONNECTION_FAILED";
+    HardwareErrorCode["DISCONNECTED"] = "DISCONNECTED";
+    // App errors
+    HardwareErrorCode["APP_NOT_OPEN"] = "APP_NOT_OPEN";
+    HardwareErrorCode["WRONG_APP"] = "WRONG_APP";
+    HardwareErrorCode["APP_VERSION_UNSUPPORTED"] = "APP_VERSION_UNSUPPORTED";
+    // User errors
+    HardwareErrorCode["USER_REJECTED"] = "USER_REJECTED";
+    HardwareErrorCode["TIMEOUT"] = "TIMEOUT";
+    // Data errors
+    HardwareErrorCode["INVALID_DATA"] = "INVALID_DATA";
+    HardwareErrorCode["DERIVATION_PATH_ERROR"] = "DERIVATION_PATH_ERROR";
+    HardwareErrorCode["TRANSACTION_TOO_LARGE"] = "TRANSACTION_TOO_LARGE";
+    // Transport errors
+    HardwareErrorCode["TRANSPORT_ERROR"] = "TRANSPORT_ERROR";
+    HardwareErrorCode["WEBHID_NOT_SUPPORTED"] = "WEBHID_NOT_SUPPORTED";
+    // Unknown
+    HardwareErrorCode["UNKNOWN"] = "UNKNOWN";
+})(HardwareErrorCode || (exports.HardwareErrorCode = HardwareErrorCode = {}));
+//# sourceMappingURL=types.js.map

package/build/hardware/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/hardware/types.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAQH,gFAAgF;AAChF,mBAAmB;AACnB,gFAAgF;AAEhF,wBAAwB;AACX,QAAA,QAAQ,GAAG,IAAI,CAAC;AAE7B,iCAAiC;AACpB,QAAA,QAAQ,GAAG;IACtB,WAAW,EAAE,IAAI;IACjB,cAAc,EAAE,IAAI;IACpB,gBAAgB,EAAE,IAAI;IACtB,mBAAmB,EAAE,IAAI;CACjB,CAAC;AAEX,0BAA0B;AACb,QAAA,aAAa,GAAG;IAC3B,EAAE,EAAE,MAAM;IACV,YAAY,EAAE,MAAM;IACpB,YAAY,EAAE,MAAM;IACpB,wBAAwB,EAAE,MAAM;IAChC,mBAAmB,EAAE,MAAM;IAC3B,iBAAiB,EAAE,MAAM;IACzB,iBAAiB,EAAE,MAAM;IACzB,YAAY,EAAE,MAAM;IACpB,OAAO,EAAE,MAAM;IACf,aAAa,EAAE,MAAM;IACrB,aAAa,EAAE,MAAM;CACb,CAAC;AAEX,6CAA6C;AAChC,QAAA,uBAAuB,GAAG,mBAAmB,CAAC;AAE3D,oDAAoD;AACvC,QAAA,kBAAkB,GAAG;IAChC,MAAM,EAAE,MAAM;IACd,WAAW,EAAE,MAAM;IACnB,MAAM,EAAE,MAAM;IACd,IAAI,EAAE,MAAM;CACJ,CAAC;AAEX,gFAAgF;AAChF,uBAAuB;AACvB,gFAAgF;AAEhF,IAAY,iBA4BX;AA5BD,WAAY,iBAAiB;IAC3B,gBAAgB;IAChB,0DAAqC,CAAA;IACrC,oDAA+B,CAAA;IAC/B,gDAA2B,CAAA;IAC3B,4DAAuC,CAAA;IACvC,kDAA6B,CAAA;IAE7B,aAAa;IACb,kDAA6B,CAAA;IAC7B,4CAAuB,CAAA;IACvB,wEAAmD,CAAA;IAEnD,cAAc;IACd,oDAA+B,CAAA;IAC/B,wCAAmB,CAAA;IAEnB,cAAc;IACd,kDAA6B,CAAA;IAC7B,oEAA+C,CAAA;IAC/C,oEAA+C,CAAA;IAE/C,mBAAmB;IACnB,wDAAmC,CAAA;IACnC,kEAA6C,CAAA;IAE7C,UAAU;IACV,wCAAmB,CAAA;AACrB,CAAC,EA5BW,iBAAiB,iCAAjB,iBAAiB,QA4B5B"}