Mine Lotus
Mining12.4.15+

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.

Napoleon upgrade

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 haveUsePage
A browser, to try itThe miner built into the node's Pool pageGPU miner
A desktop with a graphics cardThe Lotus Miner appGPU miner
A Linux rig or a serverlotus-miner-cli, or its Docker imageGPU miner
Your own nodeIts built-in stratum serverStratum server
Bitcoin or Litecoin ASICsThe node's merged-mining listeners, from NapoleonMerged 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.

  1. Get a Lotus address to be paid on. The node's web wallet gives you one; see Wallet. Back up your recovery phrase first.
  2. Open the Pool page of a pool node and go to How to mine. It shows the stratum address and port of that node.
  3. Start a miner with your address as the stratum user:
Shell
./lotus-miner-cli -g 0 -o YOUR_LOTUS_ADDRESS \
  --stratum stratum+tcp://POOL_NODE:PORT \
  --stratum-user YOUR_LOTUS_ADDRESS.rig1
  1. 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:

Shell
./lotus-miner-cli -g 0 -o YOUR_LOTUS_ADDRESS \
  --stratum stratum+tcp://POOL_NODE_1:PORT \
  --stratum stratum+tcp://POOL_NODE_2:PORT
Note

Balances 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 #

Shell
curl -s http://127.0.0.1:10604/api/v1/pool-public/miner/YOUR_LOTUS_ADDRESS

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:

Config
stratum=1
stratumlisten=0.0.0.0:3334:lotushash
stratumcoinbase=YOUR_LOTUS_ADDRESS

Then point the miner at it:

Shell
./lotus-miner-cli -g 0 -o YOUR_LOTUS_ADDRESS \
  --stratum stratum+tcp://127.0.0.1:3334
Warning

Without 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:

Shell
./lotus-miner-cli -g 0 -o YOUR_LOTUS_ADDRESS \
  -a http://127.0.0.1:10604 -u RPC_USER -p RPC_PASSWORD -i 1

Options, 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. Its scriptPubKey (or its segment) 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 #

FigureWhere
Pool hashrate, miners, next block splitPool page, GET /api/v1/pool-public/summary
This node's stratum server, listeners, sharesGET /api/v1/mining/status
Network difficulty and hashratelotus-cli getmininginfo
Source share/www/docs/mining.md in the lotusd repository
Checked against gpuminer/lotus-miner-cli/src/main.rs desktop/lotus-miner-gui/README.md src/stratum/stratumconfig.cpp src/pool/manager.cpp doc/pool-payouts.md doc/browser-miner.md doc/auxpow.md