@ledgerhq/hw-transport-webhid
Version: 
Ledger Hardware Wallet WebHID implementation of the communication layer
66 lines • 2.41 kB
TypeScript
/// <reference types="w3c-web-hid" />
/// <reference types="node" />
import Transport from "@ledgerhq/hw-transport";
import type { Observer, DescriptorEvent, Subscription } from "@ledgerhq/hw-transport";
import type { DeviceModel } from "@ledgerhq/devices";
declare function getLedgerDevices(): Promise<HIDDevice[]>;
/**
 * WebHID Transport implementation
 * @example
 * import TransportWebHID from "@ledgerhq/hw-transport-webhid";
 * ...
 * TransportWebHID.create().then(transport => ...)
 */
export default class TransportWebHID extends Transport {
    device: HIDDevice;
    deviceModel: DeviceModel | null | undefined;
    channel: number;
    packetSize: number;
    constructor(device: HIDDevice);
    inputs: Buffer[];
    inputCallback: ((arg0: Buffer) => void) | null | undefined;
    read: () => Promise<Buffer>;
    onInputReport: (e: HIDInputReportEvent) => void;
    /**
     * Check if WebUSB transport is supported.
     */
    static isSupported: () => Promise<boolean>;
    /**
     * List the WebUSB devices that was previously authorized by the user.
     */
    static list: typeof getLedgerDevices;
    /**
     * Actively listen to WebUSB devices and emit ONE device
     * that was either accepted before, if not it will trigger the native permission UI.
     *
     * Important: it must be called in the context of a UI click!
     */
    static listen: (observer: Observer<DescriptorEvent<HIDDevice>>) => Subscription;
    /**
     * Similar to create() except it will always display the device permission (even if some devices are already accepted).
     */
    static request(): Promise<TransportWebHID>;
    /**
     * Similar to create() except it will never display the device permission (it returns a Promise<?Transport>, null if it fails to find a device).
     */
    static openConnected(): Promise<TransportWebHID | null>;
    /**
     * Create a Ledger transport with a HIDDevice
     */
    static open(device: HIDDevice): Promise<TransportWebHID>;
    _disconnectEmitted: boolean;
    _emitDisconnect: (e: Error) => void;
    /**
     * Release the transport device
     */
    close(): Promise<void>;
    /**
     * Exchange with the device using APDU protocol.
     * @param apdu
     * @returns a promise of apdu response
     */
    exchange: (apdu: Buffer) => Promise<Buffer>;
    setScrambleKey(): void;
}
export {};
//# sourceMappingURL=TransportWebHID.d.ts.map