# @unionkeyhq/hd-transport-emulator

> hardware emulator transport

Latest version **1.1.27-alpha.5** (published 2026-09-23) · ISC license · 0 weekly downloads

## Install

```sh
npm install @unionkeyhq/hd-transport-emulator
pnpm add @unionkeyhq/hd-transport-emulator
yarn add @unionkeyhq/hd-transport-emulator
bun add @unionkeyhq/hd-transport-emulator
```

## Health

**Score 60/100 (C)** — status: active.

Positive: has types; no vulnerabilities; recently updated; high maintenance score.

Warnings: low downloads; no esm support.

## Facts

| | |
|---|---|
| Version | 1.1.27-alpha.5 |
| Published | 2026-09-23 |
| First published | 2026-09-23 |
| Weekly downloads | 0 |
| License | ISC |
| TypeScript types | bundled |
| Module format | CommonJS |
| Dependencies | 4 |
| Unpacked size | 23.8 KB |
| Known vulnerabilities | 0 (+18 in 1 direct dependencies) |
| Install scripts | no |
| GitHub stars | 0 |
| Author | UnionKey |
| Maintainers | unionkeyhq |

## Links

- npm: https://www.npmjs.com/package/@unionkeyhq/hd-transport-emulator
- Repository: https://github.com/UnionKeyHQ/hardware-js-sdk
- Homepage: https://github.com/UnionKeyHQ/hardware-js-sdk#readme
- Issues: https://github.com/UnionKeyHQ/hardware-js-sdk/issues
- npm.io page: https://npm.io/package/@unionkeyhq/hd-transport-emulator

## Dependencies (4)

- [axios](https://npm.io/package/axios.md) 1.15.2
- [secure-json-parse](https://npm.io/package/secure-json-parse.md) ^4.0.0
- [@unionkeyhq/hd-shared](https://npm.io/package/@unionkeyhq/hd-shared.md) 1.1.27-alpha.5
- [@unionkeyhq/hd-transport](https://npm.io/package/@unionkeyhq/hd-transport.md) 1.1.27-alpha.5

## Recent versions

- 1.1.27-alpha.5 (latest) — 2026-09-23

## README

# UnionKey Hardware Emulator Transport

This package provides HTTP-based transport for connecting to UnionKey hardware emulator.

## Features

- HTTP-based communication with emulator server
- Compatible with UnionKey Connect SDK
- Support for switchTransport functionality
- Default emulator server URL: `http://localhost:21333`

## Installation

```bash
npm install @unionkeyhq/hd-transport-emulator
```

## Usage

### Basic Usage

```javascript
import EmulatorTransport from '@unionkeyhq/hd-transport-emulator';

// Create transport instance
const transport = new EmulatorTransport();
// or with custom URL
const transport = new EmulatorTransport('http://localhost:21333');

// Initialize transport
await transport.init(logger);

// Configure with protobuf messages
await transport.configure(signedData);
```

### With UnionKey Connect SDK

```javascript
import HardwareSDK from '@unionkeyhq/hd-web-sdk';

// Initialize with emulator environment
await HardwareSDK.init({
  env: 'emulator',
  debug: true
});

// Switch to emulator transport
await HardwareSDK.switchTransport('emulator');
```

### In Connect Examples

The emulator transport is integrated into the connect examples:

1. **Expo Example**: Select "Emulator" from the transport picker
2. **Electron Example**: Use switchTransport API to switch to emulator

## API

### Constructor

```javascript
new EmulatorTransport(url?: string)
```

- `url` (optional): Emulator server URL, defaults to `http://localhost:21333`

### Methods

All methods implement the standard UnionKey Transport interface:

- `init(logger)`: Initialize transport
- `configure(signedData)`: Configure protobuf messages
- `enumerate()`: List available devices
- `acquire(input)`: Acquire device session
- `release(session, onclose)`: Release device session
- `call(session, name, data)`: Call device method
- `stop()`: Stop transport

## Emulator Server

Make sure your UnionKey emulator server is running on the configured URL (default: `http://localhost:21333`) before using this transport.

## Development

```bash
# Build
npm run build

# Development mode
npm run dev
```

---
_Source: https://npm.io/package/@unionkeyhq/hd-transport-emulator · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._