hexforge

Vanity Ethereum address forge — generate 0x… addresses that contain a chosen word at the start, anywhere, or the end, through a minimalist native GUI for Linux / Fedora.

Status: usable. CPU engine + minimalist GUI shipped and installable as a desktop app. GPU mode and extra UX polish are on the roadmap.

What it does

• Searches for ETH addresses matching a hex word (0-9a-f), e.g. 0x…deadbeef.
• CPU engine produces full wallets with a 12-word BIP-39 mnemonic.
• (Planned) GPU mode via an external OpenCL tool for long words — raw key only.

Security

This tool generates private keys. Treat it accordingly:

• Keys come from the operating-system CSPRNG; secrets are zeroized in memory.
• Nothing is written to disk unless you explicitly export.
• For real funds, run it offline and write the mnemonic / key to paper.
• Never commit generated wallets — they are git-ignored by default.

Build (Fedora)

The release artifact is a single binary, but building the GUI needs desktop development libraries:

sudo dnf install gcc libxkbcommon-devel wayland-devel mesa-libGL-devel
cargo build --release

Install as an app (Linux / GNOME)

Make hexforge a real desktop app — a launcher icon in the GNOME app grid, no terminal, no root:

./packaging/install.sh

It builds the release binary, installs it to ~/.local/bin, and adds a .desktop entry + icon under ~/.local/share. Then search hexforge in Activities and pin it to the dash. Remove everything with ./packaging/uninstall.sh.

Roadmap

• Scaffold + input-validation primitives
• PR1 — core CPU engine (mnemonic, match modes, derivation) + tests
• PR2 — egui GUI (search, live progress, accumulating results)
• PR5 — packaging (local .desktop install + icon)
• Design — egui theme (Inter / JetBrains Mono, amber accent, cards, match highlight)
• PR3 — security / UX (masked secrets, clipboard auto-clear, export, offline badge)
• PR4 — optional GPU engine (external profanity2 + safe key combine)
• (later) RPM / Flatpak distribution

Fonts

The UI bundles Inter and JetBrains Mono, both under the SIL Open Font License 1.1 (see crates/gui/assets/fonts/OFL-*.txt).

License

Project code: MIT. Bundled fonts: SIL OFL 1.1 (see above).