Technical FAQ
Short, source-checked answers about the Lotus chain and the lotusd node: launch, units, issuance, addresses, upgrades, ports, sync, mining payouts and the API.
Each answer links to the page that has the details.
When did the Lotus blockchain launch? #
The genesis block has the timestamp 1624246260, 21 June 2021 at 03:31:00 UTC. Its hash is 000000000abc0cde58ee7e919d3d4de183e6844add1fd5d14b4eac89d958f470 and its coinbase carries the text John 1:1 In the beginning was the Logos. See Block header.
What are the units? #
The ticker is XPI. One XPI (one Lotus) is 1,000,000 satoshis, so amounts have 6 decimal places.
How many Lotus does a block create? #
It depends on the difficulty of the block, not on its height: 260 XPI x (log2(difficulty) + 1), between 260 XPI and 57,460 XPI. There is no halving. See Block subsidy.
Is there a maximum supply? #
No. The node only refuses a single amount above 2,100,000,000 XPI, as a sanity check against overflows.
Who receives the block reward? #
The block reward is the subsidy plus half of the fees; the other half of the fees is burned. Half of the block reward must be paid to the miner fund address compiled into the node, and the miner keeps the rest. A block that does not pay the fund is invalid. See Block subsidy.
How often are blocks found, and how large can they be? #
The target spacing is 2 minutes. The default block size limit is 32 MB (32,000,000 bytes). The standard transaction size limit of 100,000 bytes also applies to transactions in blocks. A coinbase output can be spent after 100 blocks.
How does the difficulty adjust? #
At every block, with ASERT: the target follows how far the chain is ahead of or behind a schedule of one block every 2 minutes, with a half-life of 2 days on mainnet. See Difficulty adjustment.
What does a Lotus address look like? #
lotus_ followed by Base58 text on mainnet, lotusT on testnet and lotusR on regtest. The Base58 part holds a type byte, the output script (or the Taproot commitment) and a 4-byte checksum. See Address format.
Does Lotus support Taproot? #
Yes, since the 2nd Samuel upgrade (21 December 2025). The output is OP_SCRIPTTYPE OP_1 <33-byte commitment>, with an optional 32-byte state, and the key path requires a Schnorr signature with SIGHASH_LOTUS. See Taproot and Signature hash.
Why does a transaction id not change when a signature changes? #
The transaction id does not cover the unlocking scripts of the inputs. It is computed from Merkle roots of the inputs (outpoint and sequence only) and of the outputs. See Transaction id.
How does the upgrade schedule work? #
Consensus changes are grouped in upgrades about every six months. Each upgrade is a Unix time compiled into the node, and it applies to a block when the median time of the 11 blocks before it has reached that time. The full list with dates is in Network upgrades; a node reports it at /api/v1/upgrades.
What is the next upgrade, and which version do I need? #
Napoleon, at median time past 1797886200 (21 December 2026, 20:50 UTC) on mainnet. It is a hard fork: a node that does not know the Napoleon rules stops following the chain. The dashboard counts a peer as ready when it runs 12.4.12 or later; run the current release, 12.4.15. See Napoleon and Upgrade.
Which ports does the node use? #
| Service | Mainnet | Testnet |
|---|---|---|
| P2P | 10605 | 11605 |
| RPC, REST API, dashboard and wallet | 10604 | 11604 |
| Incoming Tor connections | 10606 | 11606 |
| Stratum (when enabled) | 3334 | 3334 |
The Napoleon testnet uses the mainnet ports plus 10,000 (20605, 20604), and 20633 for Stratum. See Configuration and Security before you open a port.
Where does the node keep its data? #
In the data directory: ~/.lotus/ on Linux, ~/Library/Application Support/Lotus/ on macOS and %APPDATA%\Lotus\ on Windows, or the directory given with -datadir. Testnet data is in the testnet3/ subdirectory and Napoleon testnet data in napoleontest/. The configuration file is lotus.conf.
| Path | Content |
|---|---|
blocks/ | Block files, and index.sqlite with the block index and the explorer tables |
chainstate/chainstate.sqlite | The unspent coins |
modules/ | One SQLite file per chain module |
wallets/ | Wallets |
utxosnapshots/ | Periodic UTXO snapshots |
debug.log | The log |
How do I check that my node is in sync? #
curl -s http://127.0.0.1:10604/api/v1/healthlotus-cli getblockchaininfo/api/v1/health answers "status": "ok" once the initial block download is over and "syncing" before; it also gives height and ibd. In getblockchaininfo, compare blocks with headers and read initialblockdownload. See Run a node.
Can I start a node without downloading the whole history? #
Yes, from a UTXO snapshot: the node becomes usable at the snapshot's block and checks the history in the background. It needs -explorerindex=0 -modules=none until that check is done. See UTXO snapshots and Thin mode.
How do I mine? #
Point a miner at a node's Stratum port, or at a pool. See Mining, GPU miner and Stratum.
From Napoleon, Bitcoin (SHA-256d) and Litecoin (Scrypt) mining hardware can mine Lotus at the same time as its own chain. See Merged mining.
How are pool miners paid? #
A node started with -poolpayouts pays every miner of its share window directly in the coinbase of each block it finds: there is no pool wallet and no withdrawal. Balances below the minimum payout (-poolminpayout, 1 XPI by default) carry over to a later block. See Pool and the live Pool page.
How do I get the OpenAPI document of the REST API? #
curl -s http://127.0.0.1:10604/api/v1/openapi.jsonIt is generated by the node and lists every route of that version. See REST API; for the JSON-RPC interface see RPC.
What is replay protection and when does it start? #
At the 1st Chronicles upgrade (median time past 1813587000, 21 June 2027, 14:10 UTC on mainnet), signatures are hashed with the fork value 0xffdead instead of 0, so a transaction signed for Lotus cannot be replayed on a chain that kept the old rules. The current state is in the replay_protection object of /api/v1/chain. See Replay protection and Signature hash.
What is the UTXO commitment? #
From Napoleon, every block commits in its coinbase to a hash of the whole set of unspent coins as it was 10 blocks earlier. It lets a node trust a UTXO snapshot by proof of work. See UTXO commitment.
Is there a test network? #
Two. Testnet (-testnet) activates every upgrade 21 days before mainnet. The Napoleon testnet (-napoleontestnet) is a separate network where the Napoleon rules are active from block 1. Their addresses start with lotusT.
