Mine Lotus
The ways to mine Lotus, and the shortest path from a Lotus address to a first accepted share.
Lotus is issued by proof of work. Its own algorithm is LotusHash, mined with graphics cards. This page gets you mining, then points to the page for each part.
From the Napoleon activation (mainnet median time past 1797886200, 21 December 2026 20:50 UTC) a Lotus block can also be proven by a Bitcoin (SHA-256d) or Litecoin (Scrypt) block header. Before it, no mainnet block can come from an ASIC. See Merged mining.
Choose how to mine #
| You have | Use | Page |
|---|---|---|
| A browser, to try it | The miner built into the node's Pool page | GPU miner |
| A desktop with a graphics card | The Lotus Miner app | GPU miner |
| A Linux rig or a server | lotus-miner-cli, or its Docker image | GPU miner |
| Your own node | Its built-in stratum server | Stratum server |
| Bitcoin or Litecoin ASICs | The node's merged-mining listeners, from Napoleon | Merged mining |
Quick start on a pool #
A node running the pool pays each miner directly in the coinbase of the blocks the pool finds, in proportion to the work the miner contributed. There is no pool wallet between the block and you. The pool id written in those blocks is FRENCHBTC unless the operator changed -poolid. Details: Pool.
- Get a Lotus address to be paid on. The node's web wallet gives you one; see Wallet. Back up your recovery phrase first.
- Open the Pool page of a pool node and go to How to mine. It shows the stratum address and port of that node.
- Start a miner with your address as the stratum user:
./lotus-miner-cli -g 0 -o YOUR_LOTUS_ADDRESS \
--stratum stratum+tcp://POOL_NODE:PORT \
--stratum-user YOUR_LOTUS_ADDRESS.rig1- Watch for accepted shares in the miner's output. Your address then appears under Miners with its hashrate and its share of the next block.
The stratum user is <Lotus address>.<name>. The address is who gets paid; the name after the dot only tells your machines apart. The password is ignored (x by default).
Give --stratum twice, with two pool nodes, and the miner fails over by itself:
./lotus-miner-cli -g 0 -o YOUR_LOTUS_ADDRESS \
--stratum stratum+tcp://POOL_NODE_1:PORT \
--stratum stratum+tcp://POOL_NODE_2:PORTBalances below the pool's minimum payout (-poolminpayout, 1 XPI by default) are carried over to later blocks. They are backed by future pool blocks, not by a wallet. The Balances view lists them.
Check that you are paid #
curl -s http://127.0.0.1:10604/api/v1/pool-public/miner/YOUR_LOTUS_ADDRESSconst r = await fetch('/api/v1/pool-public/miner/' + address);
const miner = await r.json();Ask the pool node you mine on, not your own node, unless yours is part of that pool. The other public routes are listed on the Pool page.
Mine on your own node #
Your node can serve work itself. Turn on its stratum server and name the address that found blocks pay:
stratum=1
stratumlisten=0.0.0.0:3334:lotushash
stratumcoinbase=YOUR_LOTUS_ADDRESSThen point the miner at it:
./lotus-miner-cli -g 0 -o YOUR_LOTUS_ADDRESS \
--stratum stratum+tcp://127.0.0.1:3334Without a valid -stratumcoinbase the server still starts, logs a warning, and the reward of every block it finds is burnt. Without -poolpayouts, every block pays -stratumcoinbase, whatever the worker name says.
The GPU miner can also mine over the node's RPC, without stratum:
./lotus-miner-cli -g 0 -o YOUR_LOTUS_ADDRESS \
-a http://127.0.0.1:10604 -u RPC_USER -p RPC_PASSWORD -i 1Options, limits and the wire format are on the Stratum server page.
If you build your own coinbase #
A miner or pool that takes getblocktemplate and assembles the coinbase itself has two things to copy from the template's coinbasetxn object:
coinbasetag: the script of the first output, and whether the Napoleon rule applies to this height. See Coinbase tag.utxocommitment: present from Napoleon. ItsscriptPubKey(or itssegment) must be in the coinbase, or the block is rejected. See UTXO commitment.
Miners that use the node's stratum server, or lotus-miner-cli over RPC, do nothing: the node builds the coinbase.
Where the numbers come from #
| Figure | Where |
|---|---|
| Pool hashrate, miners, next block split | Pool page, GET /api/v1/pool-public/summary |
| This node's stratum server, listeners, shares | GET /api/v1/mining/status |
| Network difficulty and hashrate | lotus-cli getmininginfo |
