Hashbot

Automated Bitcoin hashrate arbitrage for the Braiins Hashpower Market.

Self-hosted · Mobile-first dashboard · One-command Docker deploy · API key encrypted at rest.

New to Braiins + OCEAN? Start with rentsomehash.com — a step-by-step guide to setting up your DATUM node, connecting it to Braiins, and mining on OCEAN. Once your bid is live, come back here to automate it with Hashbot.

Hashbot monitors the Braiins Hashpower Market orderbook every 2 minutes and keeps your bid at the optimal price automatically. Set which rank to target (default: 5th lowest active bid + 1 tick) and Hashbot handles the rest

• Automated bid price tracking and updates on a configurable interval
• Strategy: track the Nth lowest active bid + configurable tick offset
• Auto top-up when remaining budget drops below threshold
• Real-time mobile-first dashboard (Material Design 3, Bitcoin orange)
• Price history chart — 1D / 1W / 1M / 6M
• API key validated against Braiins on entry, then encrypted with AES-128 (Fernet) and stored on disk — never in env vars, config files, or logs
• Timezone-aware activity log and timestamps

• Docker 24+ with the Compose plugin (docker compose version to check)
• A Braiins Hashpower Market account with an active bid
• Not set up yet? Follow the guide at rentsomehash.com to go from zero to a working Braiins → DATUM → OCEAN setup, then come back here

git clone https://github.com/m1xb3r/braiins-hashbot.git
cd braiins-hashbot

make setup

Checks all required files are present and creates .env from .env.example.

make up

Open http://localhost:8000 in your browser.

A setup prompt appears on first boot — paste your Braiins Owner Token and click Validate & Connect. The key is validated live against the Braiins API, then encrypted and stored in the Docker volume. The engine starts automatically once the key is saved.

Everything is configurable through the dashboard UI under Settings:

Operational parameters (poll interval, top-up threshold, speed limit) are managed internally and synced automatically from your live Braiins bid on first connect.

braiins-hashbot/
  engine     — main.py      polls orderbook every 2 min, updates bid, auto top-up
  dashboard  — dashboard.py FastAPI + UI on :8000

Shared Docker volume at /data:
  config.json           runtime config
  master.key            Fernet encryption key (chmod 600)
  api.key               encrypted Braiins API key
  price_history.json    bid price time series
  engine_state.json     cooldown / error state
  settings.json         bid rank, tick offset, display unit, timezone
  hashbot.log           rotating activity log (1MB x 2)

Both containers share a single named Docker volume. The API key is the only credential — it never touches an environment variable, config file, or log line.

• API key encrypted at rest with Fernet (AES-128-CBC + HMAC-SHA256)
• Machine-specific master.key generated on first boot, stored in the Docker volume
• Key file overwritten with zeros before deletion
• ScrubAPIKeyFilter strips the key from all log output
• Container runs as non-root user (hashbot)
• No sensitive values in environment variables or config.json

MIT

If Hashbot saves you money on hashrate, consider sending some sats back.

Onchain BTC

bc1qjsddvw9f6kqxnh4ghl48n3r6yyucepp7fq5ryj

Lightning

selfishoption774@walletofsatoshi.com