DocsMining calculator

Bitflash mining calculator

scripts/bitflash-mining-calculator.py is a local WhatToMine-style calculator for Bitflash.

It does not fetch market prices, does not talk to exchanges, and does not change consensus. Price is a manual input until Bitflash has a reliable public market.

Examples

Estimate from network hashrate:

python3 scripts/bitflash-mining-calculator.py \
  --hashrate 21 --hashrate-unit kh/s \
  --network-hashrate 1.56 --network-hashrate-unit mh/s \
  --watts 140 --kwh-cost 0.10 \
  --price 0.001 --pool-fee 1

Estimate from Bitflash difficulty:

python3 scripts/bitflash-mining-calculator.py \
  --hashrate 21 --hashrate-unit kh/s \
  --difficulty 45600 \
  --watts 140 --kwh-cost 0.10

Machine-readable output:

python3 scripts/bitflash-mining-calculator.py \
  --hashrate 21 --hashrate-unit kh/s \
  --network-hashrate 1.56 --network-hashrate-unit mh/s \
  --json

Bitflash Difficulty Scale

Bitflash does not use Bitcoin's SHA256 difficulty-1 constant for pool shares. The chain's easiest RandomX target is bnProofOfWorkLimit = ~uint256(0) >> 12, so difficulty 1 expects about 4096 hashes.

The calculator uses:

network_hashrate = difficulty * 4096 / block_time_seconds

At the default two-minute block target:

network_hashrate = difficulty * 4096 / 120

If you already know network hashrate, pass --network-hashrate directly and the script derives the equivalent Bitflash difficulty for display.

Reward Estimate

The expected daily reward is:

blocks_per_day = 86400 / block_time_seconds
miner_share = miner_hashrate / network_hashrate
gross_btf_per_day = blocks_per_day * block_reward * miner_share
net_btf_per_day = gross_btf_per_day * (1 - pool_fee_percent / 100)

Electricity is:

electricity_per_day = watts / 1000 * 24 * kwh_cost

This is an expectation, not a promise. Solo mining variance can be very large, especially when the miner has a small share of the network.

Future Website Use

The script is intentionally standalone so the same math can later back a website widget or status dashboard. Until a public price exists, a website calculator should keep price as a manual field and label fiat profit as speculative.

Website Fields

A public calculator should ask for:

• miner hashrate and unit;
• power draw in watts;
• electricity price per kWh;
• pool fee percent;
• optional BTF price;
• either current Bitflash difficulty or current network hashrate.

The output should separate:

• estimated BTF per day;
• estimated gross fiat revenue, if a manual price was provided;
• electricity cost;
• net profit/loss;
• the difficulty/hashrate assumptions used.

Never present the fiat number as a market quote unless it comes from a real public market. Before that exists, label it as a manual scenario.

Rendered from docs/mining-calculator.md in the repository. Read the source.