@ledgerhq/hw-transport-webusb
Version:
Ledger Hardware Wallet WebUSB implementation of the communication layer
186 lines • 6.87 kB
JavaScript
;
var __importDefault = (this && this.__importDefault) || function (mod) {
return (mod && mod.__esModule) ? mod : { "default": mod };
};
Object.defineProperty(exports, "__esModule", { value: true });
const hw_transport_1 = __importDefault(require("@ledgerhq/hw-transport"));
const hid_framing_1 = __importDefault(require("@ledgerhq/devices/hid-framing"));
const devices_1 = require("@ledgerhq/devices");
const logs_1 = require("@ledgerhq/logs");
const errors_1 = require("@ledgerhq/errors");
const webusb_1 = require("./webusb");
const configurationValue = 1;
const endpointNumber = 3;
/**
* WebUSB Transport implementation
* @example
* import TransportWebUSB from "@ledgerhq/hw-transport-webusb";
* ...
* TransportWebUSB.create().then(transport => ...)
*/
class TransportWebUSB extends hw_transport_1.default {
device;
deviceModel;
channel = Math.floor(Math.random() * 0xffff);
packetSize = 64;
interfaceNumber;
constructor(device, interfaceNumber) {
super();
this.device = device;
this.interfaceNumber = interfaceNumber;
this.deviceModel = (0, devices_1.identifyUSBProductId)(device.productId);
}
/**
* Check if WebUSB transport is supported.
*/
static isSupported = webusb_1.isSupported;
/**
* List the WebUSB devices that was previously authorized by the user.
*/
static list = webusb_1.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) => {
let unsubscribed = false;
(0, webusb_1.getFirstLedgerDevice)().then(device => {
if (!unsubscribed) {
const deviceModel = (0, devices_1.identifyUSBProductId)(device.productId);
observer.next({
type: "add",
descriptor: device,
deviceModel,
});
observer.complete();
}
}, error => {
if (window.DOMException && error instanceof window.DOMException && error.code === 18) {
observer.error(new errors_1.TransportWebUSBGestureRequired(error.message));
}
else {
observer.error(new errors_1.TransportOpenUserCancelled(error.message));
}
});
function unsubscribe() {
unsubscribed = true;
}
return {
unsubscribe,
};
};
/**
* Similar to create() except it will always display the device permission (even if some devices are already accepted).
*/
static async request() {
const device = await (0, webusb_1.requestLedgerDevice)();
return TransportWebUSB.open(device);
}
/**
* 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 async openConnected() {
const devices = await (0, webusb_1.getLedgerDevices)();
if (devices.length === 0)
return null;
return TransportWebUSB.open(devices[0]);
}
/**
* Create a Ledger transport with a USBDevice
*/
static async open(device) {
await device.open();
if (device.configuration === null) {
await device.selectConfiguration(configurationValue);
}
await gracefullyResetDevice(device);
const iface = device.configurations[0].interfaces.find(({ alternates }) => alternates.some(a => a.interfaceClass === 255));
if (!iface) {
throw new errors_1.TransportInterfaceNotAvailable("No WebUSB interface found for your Ledger device. Please upgrade firmware or contact techsupport.");
}
const interfaceNumber = iface.interfaceNumber;
try {
await device.claimInterface(interfaceNumber);
}
catch (e) {
await device.close();
throw new errors_1.TransportInterfaceNotAvailable(e.message);
}
const transport = new TransportWebUSB(device, interfaceNumber);
const onDisconnect = e => {
if (device === e.device) {
// $FlowFixMe
navigator.usb.removeEventListener("disconnect", onDisconnect);
transport._emitDisconnect(new errors_1.DisconnectedDevice());
}
};
// $FlowFixMe
navigator.usb.addEventListener("disconnect", onDisconnect);
return transport;
}
_disconnectEmitted = false;
_emitDisconnect = (e) => {
if (this._disconnectEmitted)
return;
this._disconnectEmitted = true;
this.emit("disconnect", e);
};
/**
* Release the transport device
*/
async close() {
await this.exchangeBusyPromise;
await this.device.releaseInterface(this.interfaceNumber);
await gracefullyResetDevice(this.device);
await this.device.close();
}
/**
* Exchange with the device using APDU protocol.
* @param apdu
* @returns a promise of apdu response
*/
async exchange(apdu) {
const b = await this.exchangeAtomicImpl(async () => {
const { channel, packetSize } = this;
(0, logs_1.log)("apdu", "=> " + apdu.toString("hex"));
const framing = (0, hid_framing_1.default)(channel, packetSize);
// Write...
const blocks = framing.makeBlocks(apdu);
for (let i = 0; i < blocks.length; i++) {
await this.device.transferOut(endpointNumber, blocks[i]);
}
// Read...
let result;
let acc;
while (!(result = framing.getReducedResult(acc))) {
const r = await this.device.transferIn(endpointNumber, packetSize);
// eslint-disable-next-line @typescript-eslint/ban-ts-comment
// @ts-ignore
const buffer = Buffer.from(r.data.buffer);
acc = framing.reduceResponse(acc, buffer);
}
(0, logs_1.log)("apdu", "<= " + result.toString("hex"));
return result;
}).catch(e => {
if (e && e.message && e.message.includes("disconnected")) {
this._emitDisconnect(e);
throw new errors_1.DisconnectedDeviceDuringOperation(e.message);
}
throw e;
});
return b;
}
setScrambleKey() { }
}
exports.default = TransportWebUSB;
async function gracefullyResetDevice(device) {
try {
await device.reset();
}
catch (err) {
console.warn(err);
}
}
//# sourceMappingURL=TransportWebUSB.js.map