Zondax Zemu Testing Framework
We appreciate any contributions to this effort!
We recommend using the npmjs package in order to receive updates/fixes.
This project is under active development - API and usage guidelines are very likely to change
Integration and end-to-end testing of Ledger Apps is a manual and time consuming process. We believe that the Ledger apps ecosystem is lacking an adequate approach with respect to testing. The Zemu Framework is our solution for this problem. We stand on the shoulders of the giant greenknot’s speculos.
Zemu is an emulation and testing framework for Ledger Nano S/X devices.
- Minimal configuration + Docker based
- Speculous/Qemu based emulation
- Easy JS API
- Mocha / Jest compatible
- Parallelized testing
- Abstracted device control (buttons, reset, etc.)
- Screenshots + comparisons
- Debugging (support for CLion and vscode, even mixed C/Rust)
- Used by Zondax in multiple apps
Zemu class provides access and control to your emulated Ledger app running on a docker container.
Basic testing code:
Basic control commands examples:**
Take a screenshot and save it:
Send "click left":
Send "click right":
Send "click both":
Wait some time:
await Zemu.sleep(500) //Time in [ms]