KEYCRACKER.IO
BUILD YOUR DEVICE

Build your own Bitcoin key collider. A small, portable device that generates random private keys and checks them against 43,497 known whale wallets — 24/7.

Will it ever find one? Almost certainly not. But almost isn't never.

1 WHAT YOU NEED

REQUIRED
Heltec WiFi LoRa 32 V3
ESP32-S3 board with built-in 128×64 OLED display. The brain of the operation.
Both V3 and V3.2 (HTIT-WB32LAF) are supported. Available on AliExpress, Amazon, and Heltec's store.
REQUIRED
USB-C Cable
For flashing firmware and powering the device. Any USB-C data cable works.
OPTIONAL
3.7V LiPo Battery (JST 1.25mm)
Makes it portable. The Heltec has a built-in battery connector and charging circuit — just plug in and go.
500mAh–1000mAh recommended. Charges via USB-C when plugged in.
OPTIONAL
3D Printed Case
Protects the board and looks cool. Search "Heltec V3 case" on Thingiverse or Printables.

2 FLASH THE FIRMWARE

Flashing loads the keycracker software onto your board. You only need a browser — no coding required.

💡 Safari, Firefox, and mobile browsers don't support Web Serial. Use Chrome or Edge on desktop.

3 SETUP WIFI

After flashing, the device starts in WiFi setup mode (first time only). The OLED will show:

WiFi Setup Mode
Connect to WiFi:
KEYFINDER-XXXXX
💡 WiFi credentials are saved to the device. After initial setup, the device connects automatically on boot — even after firmware updates. No need to set up WiFi again unless you change networks.
⚠️ The device needs WiFi to report stats to your live dashboard. It will still crunch keys without WiFi, but you won't see progress online.

4 START HUNTING

After WiFi connects (or if WiFi is unavailable), you'll see the splash screen. Press the PRG button to start immediately, or wait 5 seconds and the device starts automatically.

💡 If the device can't reach your WiFi (e.g. you're out of range), it skips WiFi and starts hunting offline automatically. No more getting stuck — just plug in and go.

Your device gets a unique 5-character shortcode (based on its MAC address). View your live dashboard at:

keycracker.io/your-code

The shortcode is shown on the device's main screen and the dedicated Device ID screen (large text for easy identification).

5 USING YOUR DEVICE

💡 Your Heltec board has two small buttons on the side. PRG is the top button (closer to the USB port) — this is the one you'll use. RST is the bottom button — this reboots the device.

PRG button (short press) — cycles through screens:

PRG button (hold 5 seconds) — powers off the device. Press RST or unplug/replug to wake up.

PRG button (hold during boot animation) — forces WiFi setup mode. Use this to change WiFi networks without reflashing. Hold PRG while the boot animation plays on startup, and the device will open the WiFi setup portal instead of connecting automatically.

Screensaver — after 60 seconds of inactivity, the display switches to a Matrix-style rain animation with KEYCRACKER.IO periodically decoding from the hex rain. Press PRG to wake the screen.

💡 Your lifetime key count is saved to the server. If you reflash or update firmware, your progress syncs back automatically.

6 UPDATING FIRMWARE

When a firmware update is available, your device dashboard will show an update banner. To update:

FLASH YOUR DEVICE BACK TO HOME
← keycracker.io