Repository navigation
Releases
Lotus Root v12.4.16
Pool links that no longer stall, faster block connection, Taproot addresses, one GPU miner
Important
Napoleon, 2026-12-21 20:50 UTC: every node must run 12.4.13 or later by then. This version qualifies.
Warning
GPU miner users: the lotus-gpu-miner-amd image and the -nvidia / -amd archives are no longer produced. Use lotus-gpu-miner for both vendors, and pass your own payout address: there is no built-in one any more. AMD cards were not tested on real hardware for this release.
- Pool links. Two pool nodes that connect no longer stop reading each other while both send their catch-up; such links used to stay dead until the ping timeout.
- Faster block connection. The explorer and module databases are written after the block, in order, on their own thread: connecting a large block takes about half the time.
-asyncindex=0keeps the old path. - Batch submission and light templates.
sendrawtransactionsadmits up to 1,000 transactions per call, 2.2 to 2.7 times faster than separate calls;getblocktemplatelightanswers in under a millisecond. - Taproot addresses. The node wallet, the web wallet, the miners and the pool can create, receive on and spend from Taproot (
lotus_J…) addresses. Legacy addresses stay the default. - One GPU miner. A single program and image for NVIDIA and AMD, with
--backend auto|nvidia|amd.
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.16-linux-x86_64.tar.gzone program only: lotusd · lotus-cli · lotus-tx · lotus-wallet · lotus-seeder |
32.8 MB |
| Windows x86_64 | lotus-binaries-12.4.16-windows-x86_64.zipone program only: lotusd · lotus-cli · lotus-tx · lotus-wallet |
17.9 MB |
| macOS Intel (x86_64) | lotus-binaries-12.4.16-macos-x86_64.tar.gzone program only: lotusd · lotus-cli · lotus-tx · lotus-wallet · lotus-seeder |
29.3 MB |
GPU miner
| Platform | File | Size |
|---|---|---|
| Linux x86_64 | lotus-gpu-miner-12.4.16-linux-x86_64.tar.gz |
2.7 MB |
Lotus Miner desktop app
| Platform | File | Size |
|---|---|---|
| Linux x86_64 | lotus-miner-gui-12.4.16-linux-x86_64.tar.gz |
20.9 MB |
| Windows x86_64 | lotus-miner-gui-12.4.16-windows-x86_64.zip |
10.3 MB |
| macOS Intel (x86_64) | lotus-miner-gui-12.4.16-macos-x86_64.zip |
9.8 MB |
| macOS Apple Silicon (arm64) | lotus-miner-gui-12.4.16-macos-arm64.zip |
8.9 MB |
| macOS universal (Intel + Apple Silicon) | lotus-miner-gui-12.4.16-macos-universal.zip |
18.3 MB |
Checksums of every file: SHA256SUMS.
Docker
docker pull ghcr.io/lotusdevorg/lotusd:12.4.16 # the node
docker pull ghcr.io/lotusdevorg/lotus-cli:12.4.16 # command-line client
docker pull ghcr.io/lotusdevorg/lotus-tx:12.4.16 # transaction tool
docker pull ghcr.io/lotusdevorg/lotus-seeder:12.4.16 # DNS seeder
docker pull ghcr.io/lotusdevorg/lotus-wallet:12.4.16 # wallet tool
docker pull ghcr.io/lotusdevorg/lotus-gpu-miner:12.4.16 # GPU minerTo pin the exact node image, pull it by digest:
docker pull ghcr.io/lotusdevorg/lotusd@sha256:f3bcd9ab77ee0100662d297a23e394571b61e04b9d1e36ba6db2014d62c19d92Verify 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.16/SHA256SUMS
curl -fsSLO https://github.com/LotusDevOrg/lotusd-releases/releases/download/v12.4.16/lotus-binaries-12.4.16-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.16 is 12.4.15 plus a fix for pool links that stalled right after
connecting, an asynchronous explorer and module indexer that takes most of
the work out of block connection, batch transaction submission and light
block templates, faster block storage and UTXO set hashing, a thin share relay, mining views by scope and unified
documentation in the node web UI, Taproot (P2TR) addresses in the wallets, the miners and
the pool, and one GPU miner for NVIDIA and AMD. 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 to 12.4.15,
and Taproot is valid on mainnet since Second Samuel (median time past
1766329380, 2025-12-21, block 1189225). A 12.4.16 node validates, relays
and mines exactly like 12.4.15.
P2P: pool links no longer stall at connect
- Two pool nodes that connect push their pool catch-up at each other (jobs
of 1.5-2.2 MB, shares, aux shares). Once the kernel buffers were full,
both had writes pending, and a socket with a pending write was only
watched for writing ("drain the write buffer first"): neither node read
the other, and the link stayed dead (lastrecv= connect time, no pong,
header or block) until the ping timeout. Seen on mainnet 12.4.14
(120-123, 119-123, 123-124) and on testnet 12.4.15 (all links of a
restarted node). A socket with pending writes is now also read while its
receive queue has room (-maxreceivebufferstill bounds it), as Bitcoin
Core does since v26. A TLS handshake step that must write first is
unchanged. - While a peer's send buffer is full or getdata answers are pending, its
pool messages are still taken, in order, and handed to the pool message
thread; its other messages wait as before. Pool answers only ever go to
-trustedblocksourcepeers, within their rate limits. -testsocketbuffer=<bytes>(regtest, debug): kernel buffer size of every
P2P socket. Test:p2p_pool_connect_burst_stall.py.
Pool
-
A block share is checked against the bits the chain requires at its own
header time, not at the time it is verified. On testnet (minimum
difficulty allowed 2 x the target spacing after the parent) a block share
relayed, re-sent or retried more than 4 minutes after its parent was
refused aspowand charged as a violation. Mainnet computes the same
bits as before. -
Honest pool peers are no longer disconnected for "invalid shares". The
shares a node asks of every pool peer (missing shares of a pending or
degraded block) were checked as the sender's own fresh work, so an answer
carrying another node's shares, or our own old ones, scored a violation per
share, and ten in a minute disconnected the peer (on mainnet about every
2 minutes on some links; on testnet it triggered a 76-block split).
Origin mismatches, our own shares sent back, late relayed shares and
answers over the credit to ids we asked for are now refused withou...
Lotus Root v12.4.15
Faster relay, faster reads, and the wallet fix
Important
Napoleon, 2026-12-21 20:50 UTC: every node must run 12.4.13 or later by then. This version qualifies.
- Wallet fix.
createwalletandloadwalletwork again on the release binaries. They failed for SQLite wallets in 12.4.13 and 12.4.14. - Faster relay. Between trusted nodes a burst of 500 transactions crosses each hop in 0.1 to 0.2 s instead of about 2 s, and a burst of 5,000 always arrives between ordinary peers.
- Faster reads.
getblockchaininfo,getmempoolinfoand the chain and mempool summaries no longer wait for the node's main locks; the one-second outliers under load are gone. - Thin mode. A thin node no longer floods its proof servers when a block has many inputs it does not hold. Upgrade proof servers to 12.4.15 first.
- Pool. Less CPU spent on pool messages, with no change to the ledger.
- Web interface. A refreshed look for the node's dashboard.
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.15-linux-x86_64.tar.gzone program only: lotusd · lotus-cli · lotus-tx · lotus-wallet · lotus-seeder |
31.6 MB |
| Windows x86_64 | lotus-binaries-12.4.15-windows-x86_64.zipone program only: lotusd · lotus-cli · lotus-tx · lotus-wallet |
17.3 MB |
| macOS Intel (x86_64) | lotus-binaries-12.4.15-macos-x86_64.tar.gzone program only: lotusd · lotus-cli · lotus-tx · lotus-wallet · lotus-seeder |
28.2 MB |
GPU miner
| Platform | File | Size |
|---|---|---|
| Linux x86_64, NVIDIA | lotus-gpu-miner-nvidia-12.4.15-linux-x86_64.tar.gz |
2.7 MB |
| Linux x86_64, AMD | lotus-gpu-miner-amd-12.4.15-linux-x86_64.tar.gz |
2.7 MB |
Lotus Miner desktop app
| Platform | File | Size |
|---|---|---|
| Linux x86_64 | lotus-miner-gui-12.4.15-linux-x86_64.tar.gz |
20.8 MB |
| Windows x86_64 | lotus-miner-gui-12.4.15-windows-x86_64.zip |
10.2 MB |
| macOS Intel (x86_64) | lotus-miner-gui-12.4.15-macos-x86_64.zip |
9.7 MB |
| macOS Apple Silicon (arm64) | lotus-miner-gui-12.4.15-macos-arm64.zip |
8.8 MB |
| macOS universal (Intel + Apple Silicon) | lotus-miner-gui-12.4.15-macos-universal.zip |
18.0 MB |
Checksums of every file: SHA256SUMS.
Docker
docker pull ghcr.io/lotusdevorg/lotusd:12.4.15 # the node
docker pull ghcr.io/lotusdevorg/lotus-cli:12.4.15 # command-line client
docker pull ghcr.io/lotusdevorg/lotus-tx:12.4.15 # transaction tool
docker pull ghcr.io/lotusdevorg/lotus-seeder:12.4.15 # DNS seeder
docker pull ghcr.io/lotusdevorg/lotus-wallet:12.4.15 # wallet tool
docker pull ghcr.io/lotusdevorg/lotus-gpu-miner:12.4.15 # GPU miner, NVIDIA
docker pull ghcr.io/lotusdevorg/lotus-gpu-miner-amd:12.4.15 # GPU miner, AMDTo pin the exact node image, pull it by digest:
docker pull ghcr.io/lotusdevorg/lotusd@sha256:ab97d22d60a12ca9d5d9953a3b59df6d01da127e5aeb4e36e1c4a677c33bdc10Verify 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.15/SHA256SUMS
curl -fsSLO https://github.com/LotusDevOrg/lotusd-releases/releases/download/v12.4.15/lotus-binaries-12.4.15-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.15 is 12.4.14 plus faster transaction relay between fleet nodes and
lock-free summary reads, less CPU on the pool message thread, a thin mode
that no longer storms its proof servers and a moderate re-theme of the node
web UI. 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 and 12.4.14. A 12.4.15 node validates, relays and mines
exactly like 12.4.14.
Node web UI
- Family look shared with lotusia.network: DM Sans for text and JetBrains
Mono for code, both embedded in the binary
(/dashboard/assets/ui/fonts/, SIL OFL 1.1, see
doc/assets-attribution.md); figures stay on the system face. Violet
companion accent, title treatment, more air at page level, 12 px card
radius and soft washes, as tokens in both themes. doc/dashboard-ui-kit.md. - A link to lotusia.network in the page footer; the Napoleon upgrade guide
is linked from the upgrade banner and from Network › Upgrades.
Wallet
- SQLite (descriptor) wallets work on release binaries built with SQLite
older than 3.42 (the depends build: 3.32.1). Since 12.4.12 the node opens
its own SQLite databases first, and the wallet's error-log setup then
failed:createwalletandloadwalletof an SQLite wallet failed and a
node started with-wallet=<sqlite wallet>refused to start (12.4.13 and
12.4.14 release binaries). Closing the last wallet no longer shuts SQLite
down under the node's other databases.
Relay and read path
- Fleet relay (
-trustedpeerrelay, default 1): connections to and from the
-trustedblocksourcepeers get preferred download, transaction
announcements without the inbound trickle and the relay permission, in
both directions; they are still scored and disconnected for misbehaviour
(nonoban).getpeerinfoshowsfleet_relay. A startup warning lists
private-trustedblocksourceranges: P2P through a proxy or NAT must not
be source-NATed to them. Measured on a fleet link: a 500-transaction burst
crosses in 0.1-0.2 s per hop instead of ~2 s. - Shorter inbound trickle and higher request limits for default peers (a
5,000-transaction burst now always arrives). - Lock-free summary reads:
getblockchaininfo,getdifficulty,
getmempoolinfoand the REST chain and mempool summaries take neither
cs_mainnor the mempool lock; no JSON is built undercs_main. The
~1 s outliers of heavy RPCs under concurrent clients are gone (HTTP
listen backlog). contrib/bench/: an in-tree regtest benchmark kit; threelotus-bench
cases that aborted now run.
Thin mode
- No request storm on undecided coins (12.4.14 mainnet incident: a thin
node meeting a block with ~2,000 inputs it did not hold sent thousands of
requests per proof peer). Client:getcoinsbatched (200 outpoints), a
per-peer budget (10/s, burst 100, at most 4 in flight), BUSY handled as a
cool-down (exponential with jitter), not a fault; lookups of the same coin
joined; a block whose inputs are not ...
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...
Lotus Root v12.4.13
The Napoleon network upgrade: required before 21 December 2026
Important
Every node operator, pool and exchange must run 12.4.13 or later before 2026-12-21 20:50 UTC.
A node on an older version, or on any LotusiaStewardship release, leaves the chain at the first block that uses the new rules. There is no grace period.
Miners and pools that build their own coinbase must add the UTXO set commitment before that date.
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.
- Merged mining. From Napoleon a Lotus block can be mined together with Bitcoin or Litecoin: one parent header proves one Lotus block.
- Contract opcodes. New script opcodes for contracts (introspection,
OP_MUL,OP_MULDIV, Taproot state,OP_CHECKBLOCKHASHVERIFY) activate at Napoleon. - UTXO set commitment. From Napoleon every block commits to the UTXO set in its coinbase, so a snapshot can be checked against the chain.
- UTXO snapshots. A node can start from a UTXO snapshot and validate the history in the background. Full nodes write one every 100 blocks.
- No more limit of 3
OP_RETURNoutputs per transaction, from Napoleon. - Before Napoleon nothing changes: a 12.4.13 node validates, relays and mines exactly like 12.4.11.
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.13-linux-x86_64.tar.gzone program only: lotusd · lotus-cli · lotus-tx · lotus-wallet · lotus-seeder |
30.4 MB |
| Windows x86_64 | lotus-binaries-12.4.13-windows-x86_64.zipone program only: lotusd · lotus-cli · lotus-tx · lotus-wallet |
16.7 MB |
| macOS Intel (x86_64) | lotus-binaries-12.4.13-macos-x86_64.tar.gzone program only: lotusd · lotus-cli · lotus-tx · lotus-wallet · lotus-seeder |
27.0 MB |
GPU miner
| Platform | File | Size |
|---|---|---|
| Linux x86_64, NVIDIA | lotus-gpu-miner-nvidia-12.4.13-linux-x86_64.tar.gz |
2.7 MB |
| Linux x86_64, AMD | lotus-gpu-miner-amd-12.4.13-linux-x86_64.tar.gz |
2.7 MB |
Lotus Miner desktop app
| Platform | File | Size |
|---|---|---|
| Linux x86_64 | lotus-miner-gui-12.4.13-linux-x86_64.tar.gz |
20.8 MB |
| Windows x86_64 | lotus-miner-gui-12.4.13-windows-x86_64.zip |
10.2 MB |
| macOS Intel (x86_64) | lotus-miner-gui-12.4.13-macos-x86_64.zip |
9.7 MB |
| macOS Apple Silicon (arm64) | lotus-miner-gui-12.4.13-macos-arm64.zip |
8.8 MB |
| macOS universal (Intel + Apple Silicon) | lotus-miner-gui-12.4.13-macos-universal.zip |
18.0 MB |
Checksums of every file: SHA256SUMS.
Docker
docker pull ghcr.io/lotusdevorg/lotusd:12.4.13 # the node
docker pull ghcr.io/lotusdevorg/lotus-cli:12.4.13 # command-line client
docker pull ghcr.io/lotusdevorg/lotus-tx:12.4.13 # transaction tool
docker pull ghcr.io/lotusdevorg/lotus-seeder:12.4.13 # DNS seeder
docker pull ghcr.io/lotusdevorg/lotus-wallet:12.4.13 # wallet tool
docker pull ghcr.io/lotusdevorg/lotus-gpu-miner:12.4.13 # GPU miner, NVIDIA
docker pull ghcr.io/lotusdevorg/lotus-gpu-miner-amd:12.4.13 # GPU miner, AMDTo pin the exact node image, pull it by digest:
docker pull ghcr.io/lotusdevorg/lotusd@sha256:f5e8b35f7d6b1016c4e0c7822aea851d95d878df7ea831c5cffc21b3e9afd94eVerify 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.13/SHA256SUMS
curl -fsSLO https://github.com/LotusDevOrg/lotusd-releases/releases/download/v12.4.13/lotus-binaries-12.4.13-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.13 is the release first planned as 12.4.12 (no v12.4.12 tag was
published; the mainnet fleet ran 12.4.12 release candidates before it), plus
the fixes below.
Consensus release. 12.4.13 activates new consensus rules on mainnet at
Napoleon (called Second Kings upstream): median time past of the previous block at or after
1797886200 (2026-12-21 20:50:00 UTC), the same test as every other Napoleon
rule. Until then a 12.4.13 node validates, relays and mines exactly like
12.4.11.
Fixes since the 12.4.12 release candidates
- Pool: a node's own shares are no longer lost when blocks arrive in a
burst (the job cache evicted the tip job by arrival time, so about 10% of
the fleet's own blocks were classed as spoofs); eviction is now by height
and never at or above the tip, a missing job is restored from the stratum
job served, andcounters.localShareDrops,localBlockShareDropsand
localJobsRestoredreport it. The round effort (luck) is computed from
the share heights above the last settled pool block. - Dashboard: the Social overview sits on one 12-column grid with rows of
equal height; the upgrade banner and checklist say operators must run
12.4.13 or later. - Pool: re-hello of unknown peers after a restart (a one-sided
poolhello
is repaired;counters.rehellos); deep catch-up to the block-proof
retention horizon. - REST:
txs/<txid>/rawlooks again on the shared connection before
answering 404 (a transaction indexed in a batch not yet committed during
IBD was reported missing). - HTTP: over-long request and header lines are cut while being read
(400/414), so a client cannot make the server buffer an unbounded line. getblocktemplategives the coinbase tag output
(coinbasetxn.coinbasetag) for external pools that build their own
coinbase.- Startup page and
debug.log: real progress (%) for the one-time UTXO set
hash build on the first start (reporting only; the hash is unchanged). - Dashboard: the ASIC login builder uses the node's network address prefix
and refuses addresses of another network. - Build: MuHash3072 compiles with the macOS toolchain (no semantic change);
the UTXO commitment chain tests now run undercheck.
New in 12.4.13 (non-consensus)
- UTXO snapshots (doc/utxo-snapshot.md): a node can start from a
release-pinned UTXO snapshot (-loadutxosnapshot=<file>, or the
loadtxoutsetRPC) and validates the history in the background
(-snapshotverify, default on; the node stops if the history disagrees).
Snapshots are checked against the Napoleon UTXO comm...