34 lines (28 loc) · 1.78 KB

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

Unreleased

Added

Initial release of @metamask/hw-emulator (#TODO)
- Hardware wallet emulator lifecycle, transport, and device interaction for E2E testing
- Ledger emulator via Speculos with support for Nano S+, Nano X, Stax, and Flex devices
- Docker and native run modes
- SpeculosClient for APDU exchange and screen events
- ApduBridge for WebSocket-to-APDU bridge (WebHID mocking)
- DockerManager for Docker Compose lifecycle management
- ProcessManager for native Speculos process spawning
- Device interaction automation (button presses, touch gestures)
- Resilience utilities (withRetry, ExponentialBackoff)
- Ledger HID framing session utilities
- WebHID mock script generation for E2E tests
- Deterministic accounts with pre-configured seed
- Bundled ELF app binaries for all supported devices
- Docker Compose configuration for Speculos
- JSDoc documentation on all public types, classes, methods, and constants
- getElfFilePath utility for resolving ELF binary paths (native mode)
- startNative() defaults to @metamask/speculos-up managed binary when no binary option is provided
- Fix Docker mode ignoring custom apduPort / apiPort by passing host ports to docker-compose
- Fix Docker mode ignoring the seed option by wiring SPECULOS_SEED through docker-compose.yml
- Fix Docker mode ignoring the display option by wiring SPECULOS_DISPLAY through docker-compose.yml