Repository navigation
Lotus Root v12.4.14
Thin mode, explorer paging, safer RPC behind a proxy
Important
Napoleon, 2026-12-21 20:50 UTC: every node must run 12.4.13 or later by then. This version qualifies.
Warning
Known issue, fixed in 12.4.15: these binaries cannot create or load an SQLite wallet, and a node started with -wallet= on such a wallet does not start. If you use the wallet, install 12.4.15.
- Thin mode.
-thin=1runs a node without the history: it proves the coins it needs from peers and checks them against the header chain.-thin=utxostarts from a UTXO snapshot. - UTXO snapshots. Full nodes write a snapshot every 100 blocks, once its commitment is buried in the chain, and serve the newest one for download.
- Explorer. Address history with cursor paging, and batch endpoints for transactions and addresses.
- Security. JSON-RPC and the operator routes refuse a request that arrives through a reverse proxy, unless you set
-rpcallowforwarded=1. - Dashboard. A second polish pass of the node's web interface.
New here? The install and upgrade guide takes you from download to a running node.
Downloads
Node and tools
The archive holds lotusd and its tools (lotus-cli, lotus-tx, lotus-wallet, and lotus-seeder where it is built).
| Platform | File | Size |
|---|---|---|
| Linux x86_64 | lotus-binaries-12.4.14-linux-x86_64.tar.gzone program only: lotusd · lotus-cli · lotus-tx · lotus-wallet · lotus-seeder |
31.3 MB |
| Windows x86_64 | lotus-binaries-12.4.14-windows-x86_64.zipone program only: lotusd · lotus-cli · lotus-tx · lotus-wallet |
17.2 MB |
| macOS Intel (x86_64) | lotus-binaries-12.4.14-macos-x86_64.tar.gzone program only: lotusd · lotus-cli · lotus-tx · lotus-wallet · lotus-seeder |
28.0 MB |
GPU miner
| Platform | File | Size |
|---|---|---|
| Linux x86_64, NVIDIA | lotus-gpu-miner-nvidia-12.4.14-linux-x86_64.tar.gz |
2.7 MB |
| Linux x86_64, AMD | lotus-gpu-miner-amd-12.4.14-linux-x86_64.tar.gz |
2.7 MB |
Lotus Miner desktop app
| Platform | File | Size |
|---|---|---|
| Linux x86_64 | lotus-miner-gui-12.4.14-linux-x86_64.tar.gz |
20.8 MB |
| Windows x86_64 | lotus-miner-gui-12.4.14-windows-x86_64.zip |
10.2 MB |
| macOS Intel (x86_64) | lotus-miner-gui-12.4.14-macos-x86_64.zip |
9.7 MB |
| macOS Apple Silicon (arm64) | lotus-miner-gui-12.4.14-macos-arm64.zip |
8.8 MB |
| macOS universal (Intel + Apple Silicon) | lotus-miner-gui-12.4.14-macos-universal.zip |
18.0 MB |
Checksums of every file: SHA256SUMS.
Docker
docker pull ghcr.io/lotusdevorg/lotusd:12.4.14 # the node
docker pull ghcr.io/lotusdevorg/lotus-cli:12.4.14 # command-line client
docker pull ghcr.io/lotusdevorg/lotus-tx:12.4.14 # transaction tool
docker pull ghcr.io/lotusdevorg/lotus-seeder:12.4.14 # DNS seeder
docker pull ghcr.io/lotusdevorg/lotus-wallet:12.4.14 # wallet tool
docker pull ghcr.io/lotusdevorg/lotus-gpu-miner:12.4.14 # GPU miner, NVIDIA
docker pull ghcr.io/lotusdevorg/lotus-gpu-miner-amd:12.4.14 # GPU miner, AMDTo pin the exact node image, pull it by digest:
docker pull ghcr.io/lotusdevorg/lotusd@sha256:7433dad3821570a0607fe61a85ff333338368823e9dbe6b00adb5d0dcc5ae1afVerify your download
Every file of this release is listed in SHA256SUMS. Download it next to your file and check:
curl -fsSLO https://github.com/LotusDevOrg/lotusd-releases/releases/download/v12.4.14/SHA256SUMS
curl -fsSLO https://github.com/LotusDevOrg/lotusd-releases/releases/download/v12.4.14/lotus-binaries-12.4.14-linux-x86_64.tar.gz
sha256sum -c --ignore-missing SHA256SUMS # Linux; must print: OK
shasum -a 256 -c --ignore-missing SHA256SUMS # macOSOn Windows, Get-FileHash <file> -Algorithm SHA256 in PowerShell must give the value on that file's line. The files are not signed: download them from this page only.
Full release notes
12.4.14 is 12.4.13 plus thin mode, keyset paging for the explorer, and a
second dashboard polish pass. No consensus change: the Napoleon rules
and their activation (median time past 1797886200, 2026-12-21 20:50:00 UTC)
are those of 12.4.13. A 12.4.14 node validates, relays and mines exactly
like 12.4.13.
Thin mode (-thin=1, -thin=utxo) — doc/thin-mode.md
-thin=1: a node without the history. After its headers sync it adopts a
base a few blocks below the tip and proves the older coins it needs from
peers that serve proofs (service bitNODE_PROOFS, 31): every coin is
checked against our header chain, unspent needs k agreeing peers
(-thinpeers, default 3), a single valid spend proof wins, provable lies
are banned. Blocks and transactions are validated on the normal code with
those coins. A block whose inputs cannot be proven yet waits; it is never
marked invalid.-thin=utxo: the whole UTXO set from a snapshot (-loadutxosnapshot),
trusted through the coinbase commitment buried under-thincommitdepth
headers or the release's entry, without the history.-thin=0on the
same datadir upgrades it to a full node (background validation).- Thin wallet (BIP157/158 filter rescans), thin pool member, quorum answers
for the REST routes with athinlabel (X-Lotus-Thinheader). - User agent: a thin node reports
/lotusd:12.4.14-thin(EB32.0)/; a full
node is unchanged (/lotusd:12.4.14(EB32.0)/). - Full nodes serve the proofs only with
-proofserver=1(off by default;
ignored on a pruned node; needs the explorer index, on by default).
Fleet configuration (operators of proof servers)
-proofserver=1
-blockfilterindex=basic
-peerblockfilters=1
- The filter index costs about 0.3 GB of disk on mainnet (estimate at height
1,426,690: ~45 MB of filters, the rest per-block index entries), built
once in the background on the first start with the flag; the node serves
meanwhile. Its cache is taken from-dbcache. - The proof server keeps less than ~100 MB of caches; requests are rate
limited per peer (-proofratelimit, 20/10/2 per second) and limited to
-proofpeers(32) peers per 10 minutes. - A thin node chooses its proof peers in distinct /16 network groups on
mainnet. Proof servers that share a /16 count as one; a thin node that
only knows such servers needs-thindistinctgroups=0.
UTXO snapshots
- Full nodes write a UTXO snapshot every 100 blocks (heights that are
multiples of 100), once its commitment is buried (at tip H + 110); one is
kept besides the one being written, and a busy writer skips rather than
queues. The REST list gives latest, interval, lag, writing and next;
downloadutxosnapshotheight 0 means the newest and survives a rotation
during the download.dumptxoutsetbelow the tip is fixed for blocks
where a child comes before its parent in canonical order.
Explorer
GET /api/v1/addresses/{address}/history: keyset paging with full
transaction rows (before/aftercursors, total from the maintained
counter, never aCOUNT(*))./txsis unchanged; itsoffsetis
documented as deprecated.- Batch endpoints for transactions and addresses.
- One atomic write per block with the explorer tip marker; startup check;
explorer schema version with forward-only migrations (version 2: the tip
marker, no table rewrite). doc/explorer-sql.md.
Pool
gossip_eventsis bounded (-poolgossiplogkeephours=24,
-poolgossiplogmaxrows=100000,-poolgossiplograte=30per kind and
minute) and pruned in small background batches (an existing large table
drains in under an hour; the file stops growing, it does not shrink).- Pool P2P messages are handled on their own thread (
b-poolmsg), so block
and header serving never waits on pool work. Its queue is small (2,000
messages / 32 MiB); when it is full the node stops reading that peer's
pool messages (TCP backpressure), it never drops them. An accepted job
re-checks only its own orphan shares.getpoolinfo.gossipLogshows
msgQueue,msgQueueFull,msgQueueBackpressure,msgQueueDropped
(always 0). doc/pool-payouts.md 4.1, 5.3.
Test networks
- Fractional merged-mining multiplier as a launch parameter
(-auxpowmultiplier=<scrypt|sha256d>:<M>,-auxpowmultiplieractivationtime),
per-algorithm aux vardiff floors and ceilings, a 3-algorithm CPU miner
(contrib/testnet/cpuminer.py); the web UI shows M, the difficulty and why.
Every one of these options is refused on mainnet. - Coinbase tag: see 12.4.13 (
_allowed from Napoleon, FRENCH_BTC).
Security
-rpcallowforwarded(default 0): JSON-RPC and the authenticated operator
REST routes (stratum, sharechain, scryptchains, pool) answer 403 to a
request that carries a reverse-proxy header (X-Forwarded-For, X-Real-IP,
Forwarded, CF-Connecting-IP, True-Client-IP, X-Forwarded-Host), checked
before the credentials. Set it to 1 only if you deliberately proxy
JSON-RPC.- Wallet-category RPCs are refused on
/api/v1/rpc/*and the NNG tunnel. - Dashboard: HTML escaping of quotes, token URLs as links for http(s) only,
JSON-LD escaping, BLOB raw answers with nosniff and a sandbox CSP. - Wallet PWA: asks for persistent storage and warns when the browser may
evict it.
Dashboard
- Polish pass 2 (layout, UI kit, browser miner panel, wallet styles).
SHA-256 of every file
fc347efb1003ee27126d56e784c788d9c61a9cd7c42b16d7dc9ada710784eb13 lotus-binaries-12.4.14-linux-x86_64.tar.gz
d3dac6473d1002f7c58adbfeda33ae67cee480c7e8944f78fb927237ef377463 lotus-binaries-12.4.14-macos-x86_64.tar.gz
673d7a9db06ba02caa0ced04875c271a77c2addf540759fbc36c19f16c381f30 lotus-cli-12.4.14-linux-x86_64.tar.gz
1a4444514257ae355b271dcc7c32b76a139f902854328d8e700d2a66190ee783 lotus-cli-12.4.14-macos-x86_64.tar.gz
f4e8d23c9516177bf4e714a954fe5361388342808cfb561f0da2bd1d4a7a9baa lotus-gpu-miner-amd-12.4.14-linux-x86_64.tar.gz
7fc4dc041b4151e4a172361aa1b0fe7fb017fa9650f9b821812a8839fb3d3f47 lotus-gpu-miner-nvidia-12.4.14-linux-x86_64.tar.gz
1edf5d8087366f7eb32327f78039568c244e232b3cc0922c8daf010dd96c7398 lotus-miner-gui-12.4.14-linux-x86_64.tar.gz
8f1878fb305b80616d4e1566942b3d91f43dea3afe58cf59db1f7a5789f1173c lotus-seeder-12.4.14-linux-x86_64.tar.gz
98d4c1bf82108b2dd67428b8276ff6e45986c9b0e25da8c58d2c2c9e2385cf73 lotus-seeder-12.4.14-macos-x86_64.tar.gz
1eabbdd926e42229ec5a298f4b0111989975c9cb614b7940e64e190d63ffac62 lotus-tx-12.4.14-linux-x86_64.tar.gz
69a677b598bf76b8caff944b3dad75a9553eb021d7f25fb42e6d73819abe20dd lotus-tx-12.4.14-macos-x86_64.tar.gz
bd9730cc86190946fe54521aecc90e3504e1411430d539abe1c60a86e86b86f6 lotus-wallet-12.4.14-linux-x86_64.tar.gz
4280c707f90d0600a7816502280bd6e589bd9624105acedcbf92f6e67fca56ea lotus-wallet-12.4.14-macos-x86_64.tar.gz
396888f770b6876fc97eea23b1967e129652d4823286ce7390114303ae694b78 lotusd-12.4.14-linux-x86_64.tar.gz
737e656c9a0fe83af5de03fb9adf8ee2a3321a7286669df95f2ac0f8b021801d lotusd-12.4.14-macos-x86_64.tar.gz
4dc6f0743d7a271a96672da1a4a114eb20066731dc63742c556a8d78088c6631 lotus-binaries-12.4.14-windows-x86_64.zip
c251d3e23f47f8291a3b9dfbbf87af9c38fc439c7ccfeea7fc273b072aa669d8 lotus-cli-12.4.14-windows-x86_64.zip
3c1a9124a397e2c6e1196efeeac140339680298a5d874a688fac8d4a6cc14714 lotus-miner-gui-12.4.14-macos-arm64.zip
9d574f17560805606979e723c04bd04c8aeb7690017dd7c85f675ef7165ce9fd lotus-miner-gui-12.4.14-macos-universal.zip
c9008b225c1d88ae59f3b8d8a7137160564a7c4c00bca201dd3717a4bc5f1051 lotus-miner-gui-12.4.14-macos-x86_64.zip
3a040381d3aefe894aa3f5891e2c0e63c9139e081f4df5fa3fd768b23691a6c0 lotus-miner-gui-12.4.14-windows-x86_64.zip
ab71eb87bdce219e452ea177e8fe8b5e60b36bf22b3807d3607f309aece144bb lotus-tx-12.4.14-windows-x86_64.zip
806f0659115fd3b3e5faf3daf71d115008edc324099aa6a9a1f9e1bce8591dc3 lotus-wallet-12.4.14-windows-x86_64.zip
9a044aac544fa9d65abcd17afcc1d9b3b69be5b20f306aca6c41694a5cbe1fa9 lotusd-12.4.14-windows-x86_64.zip
Consensus changes: none. The rules and the activation time are those of 12.4.13 · Minimum version on the network: 12.4.13, required from Napoleon (2026-12-21 20:50 UTC)
Install and upgrade guide · Web wallet · All releases · Container images · Report a problem