Skip to content

Lotus Root v12.4.14

Choose a tag to compare

@Boblepointu Boblepointu released this 16 Nov 20:46
· 2 commits to main since this release

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=1 runs a node without the history: it proves the coins it needs from peers and checks them against the header chain. -thin=utxo starts 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.gz
one 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.zip
one 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.gz
one 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, AMD

To pin the exact node image, pull it by digest:

docker pull ghcr.io/lotusdevorg/lotusd@sha256:7433dad3821570a0607fe61a85ff333338368823e9dbe6b00adb5d0dcc5ae1af

Verify 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 # macOS

On 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 bit NODE_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=0 on 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 a thin label (X-Lotus-Thin header).
  • 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;
    downloadutxosnapshot height 0 means the newest and survives a rotation
    during the download. dumptxoutset below 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 / after cursors, total from the maintained
    counter, never a COUNT(*)). /txs is unchanged; its offset is
    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_events is bounded (-poolgossiplogkeephours=24,
    -poolgossiplogmaxrows=100000, -poolgossiplograte=30 per 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.gossipLog shows
    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