@ledgerhq/hw-transport-node-speculos-http

A transport for https://github.com/LedgerHQ/speculos Nano simulator using its HTTP API.

GitHub, Ledger Devs Discord, Developer Portal

Getting started

• Install https://github.com/LedgerHQ/speculos
• Make sure to have a speculos running with an API port (default port is 5000).

1import SpeculosTransport from "@ledgerhq/hw-transport-node-speculos-http";
2
3async function exampleSimple() {
4  const transport = await SpeculosTransport.open();
5  const res = await transport.send(0xE0, 0x01, 0x00, 0x00);
6}
7
8async function exampleAdvanced() {
9  const transport = await SpeculosTransport.open({ baseURL: "http://localhost:5000" });
10  transport.eventStream.once("data", {
11    // we will click right when the display changes
12    transport.button("right");
13  });
14  // we can also use eventStream.on and match the data buffer with the expected display before taking action
15  // derivate btc address and ask for device verification
16  const res = await transport.send(0xE0, 0x40, 0x01, 0x00, Buffer.from("058000002c8000000080000000000000000000000f"));
17}

API

Table of Contents

• SpeculosHttpTransport
  • Parameters
  • Examples
  • button
    • Parameters

SpeculosHttpTransport

Extends Transport

Speculos TCP transport implementation

Parameters

• instance AxiosInstance
• opts SpeculosHttpTransportOpts

Examples

1import SpeculosHttpTransport from "@ledgerhq/hw-transport-node-speculos-http";
2const transport = await SpeculosHttpTransport.open();
3const res = await transport.send(0xE0, 0x01, 0, 0);

button

Press and release button buttons available: left, right, both

Parameters

• but any

Returns Promise<void>