Open-source firmware for the OneKey Pro hardware wallet.
Security-first · Fully verifiable · Community-driven
This repository contains the firmware source code for the OneKey Pro hardware wallet. Every release is built via GitHub CI, multi-signed by the OneKey team, and can be independently verified against this open-source codebase — ensuring full supply chain transparency from code to device.
Verify your device's firmware: see Open Source Code Verification for step-by-step instructions.
📖 Deep Wiki — Full Architecture & Codebase Guide
- Nix (package manager)
- Git
# 1. Clone the repo (with submodules)
git clone --recurse-submodules https://github.com/OneKeyHQ/firmware-pro.git
cd firmware-pro
# 2. Enter the Nix development shell & install dependencies
nix-shell
poetry install
# 3. Build the Unix emulator
cd core && poetry run make build_unix
# 4. Start the emulator
poetry run ./emu.py
# 5. (Optional) Install the CLI client to interact with the emulator
cd ../python && poetry run python3 -m pip install .We welcome contributions of all sizes. Before you start, please read the contributing docs — especially the misc chapter for useful background knowledge.
- Bug fixes & small features — File a PR directly. See CONTRIBUTING.md for PR requirements.
- New coin / token / network — Follow the guide in COINS.md.
If you discover a vulnerability, please report it responsibly.
- 📬 Email security@onekey.so — do not open a public issue.
- 💰 We run a Bug Bounty Program to reward responsible disclosure.
- 💬 Community Forum — Questions, ideas, and best practices.
- 🐛 GitHub Issues — Bug reports and feature requests.
- 🐦 Twitter / X — News and announcements.