Practical overview
When it fits
Use it to explore address derivation and the scale of the matching odds through a game, or consult its repository when examining a documented JavaScript build and static deployment workflow.
Who it is for
- People interested in a playful illustration of Bitcoin private-key-to-address derivation.
- Developers exploring a browser-based probability simulator or static JavaScript project.
Documented uses
- See how a random 256-bit candidate produces a Bitcoin address.
- Play a slot-style game that checks derived addresses against a curated local target set.
- Inspect or build a static JavaScript implementation of the address-generation game.
Requirements & limits
- Each spin checks a generated candidate against the project’s curated target set; the README puts the chance of a match at about one in 5.27 × 10⁷².
- The repository describes the address checks as browser-side, with bundled data and no server or API call.
- The documented local development setup requires Node 22 or newer.
- The project is JavaScript and has an MIT license.
Check current requirements in the official documentation. Source-based guidance does not mean OpenViST has run or independently tested this project.
Run the game locally
Start the documented local development server for Satoshiguesser.
Before you start
- Node.js 22 or newer
- The Satoshiguesser repository
Steps
Run the command below in the repository.
npm installRun the command below.
npm run devOpen the local development address shown in the README:
http://localhost:5173.
Expected outcome
The project’s local development server is started at the documented address.
Guide limitations
- The guide covers local startup only; it does not verify a successful run.
- The README says the predev hook regenerates wallet data artifacts from
data/wallets.csv.
Build a static site for Cloudflare Pages
Create the documented static build output for a Cloudflare Pages deployment.
Before you start
- Node.js 22 or newer
- The Satoshiguesser repository
Steps
Run the command below.
npm installRun the command below.
npm run buildUse
distas the build output directory in the documented Cloudflare Pages setup.
Expected outcome
The build command produces the documented production bundle in `dist`, ready to be used as the Pages output directory.
Guide limitations
- The README also describes connecting a GitHub repository and configuring Pages; this guide does not cover account setup or verify deployment.
- The documentation describes a static site and says no Workers, Durable Objects or R2 are needed.
Sources & review
Source record details
- Source availability
- Active
- Sources checked
- 14 October 2026
- Original website title
- Pathos0925/SatoshiGuesser · Official homepage title · retained in its source language

