About — lotterypzl

lotterypzl is a conductor CLI and guided TUI for Bitcoin Puzzle lottery search. It coordinates bounded search windows across GPU sessions, records every ticket in a shared ledger, and ensures no two sessions ever search the same range.

Not a pool

There's no shared reward. If you find a key, 100% of the BTC is yours. lotterypzl only coordinates the search — it doesn't take a cut.

Not a marketplace

You can't buy or sell tickets. There are no accounts, no payments, no deposits. Just a CLI that helps you search efficiently.

Honest by design

The ledger prevents duplicate work. Dry-run mode shows exactly what will happen before you commit GPU time. Math is transparent — expected value is negative and we say so.

The ecosystem

lotterypzl (conductor)

The CLI and TUI that orchestrates everything. Configure backends, claim tickets, monitor sessions, tail logs, stop and resume by run ID. Supports --json output for scripting and --detach for remote GPU rentals.

GitHub →

PZL-Roo (kangaroo engine)

GPU Pollard's kangaroo implementation optimized for lottery-mode bounded windows. Used when the puzzle's public key is known (puzzles 135, 140, 145, 150, 155, 160).

GitHub →

PZL-Hunter (scanner engine)

GPU brute-force address scanner for puzzles without known public keys. Used for puzzle 71 and other address-only targets.

GitHub →

This website

The complete Bitcoin Puzzle reference — 160-puzzle database with live balance, history, theories, tools directory, claiming guide, and FAQ. Built with Eleventy, hosted on Cloudflare Pages.

GitHub →

Install

Repos are private today — use a read-scoped GITHUB_TOKEN until the public install host is live.

install.sh

# fetch and run the installer, then configure
export GITHUB_TOKEN=*** class="t-cmd">curl -fsSL \
  -H "Authorization: Bearer $GITHUB_TOKEN" \
  -H "Accept: application/vnd.github.raw" \
  "https://api.github.com/repos/paps-git/lotterypzl/contents/scripts/install.sh?ref=main" | bash
source ~/.lotterypzl/env.sh
lotterypzl config wizard
lotterypzl doctor --json

Core commands

Interactive launcher

lotterypzl

Plan a bounded search

lotterypzl search --puzzle 135 --gpus 2 \
  --wbits 96 --max-windows 5 --dry-run --json

Detached session

lotterypzl search --puzzle 135 --gpus 1 \
  --wbits 96 --max-windows 1 --detach

Monitor + logs

lotterypzl monitor <RUN_ID>
lotterypzl logs <RUN_ID>

Benchmark hardware

lotterypzl benchmark --puzzle 135 --wbits 40 --real --seconds 15 --json

Reality check

High puzzles are a lottery with negative expected value. lotterypzl helps you search honestly, coordinate distinct tickets with a shared ledger, and never waste GPU time on duplicate ranges. Verify any candidate key with independent tools. Not financial advice.