Skip to content

Releases

Lotus Root v12.4.16

Choose a tag to compare

@Boblepointu Boblepointu released this 17 Nov 09:51

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=0 keeps the old path.
  • Batch submission and light templates. sendrawtransactions admits up to 1,000 transactions per call, 2.2 to 2.7 times faster than separate calls; getblocktemplatelight answers 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.gz
one 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.zip
one 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.gz
one 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 miner

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

docker pull ghcr.io/lotusdevorg/lotusd@sha256:f3bcd9ab77ee0100662d297a23e394571b61e04b9d1e36ba6db2014d62c19d92

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.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 # 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.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 (-maxreceivebuffer still 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
    -trustedblocksource peers, 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 as pow and 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...

Read more

Lotus Root v12.4.15

Choose a tag to compare

@Boblepointu Boblepointu released this 16 Nov 22:51

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. createwallet and loadwallet work 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, getmempoolinfo and 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.gz
one 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.zip
one 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.gz
one 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, AMD

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

docker pull ghcr.io/lotusdevorg/lotusd@sha256:ab97d22d60a12ca9d5d9953a3b59df6d01da127e5aeb4e36e1c4a677c33bdc10

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.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 # 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.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: createwallet and loadwallet of 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
    -trustedblocksource peers get preferred download, transaction
    announcements without the inbound trickle and the relay permission, in
    both directions; they are still scored and disconnected for misbehaviour
    (no noban). getpeerinfo shows fleet_relay. A startup warning lists
    private -trustedblocksource ranges: 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,
    getmempoolinfo and the REST chain and mempool summaries take neither
    cs_main nor the mempool lock; no JSON is built under cs_main. The
    ~1 s outliers of heavy RPCs under concurrent clients are gone (HTTP
    listen backlog).
  • contrib/bench/: an in-tree regtest benchmark kit; three lotus-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: getcoins batched (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 ...
Read more

Lotus Root v12.4.14

Choose a tag to compare

@Boblepointu Boblepointu released this 16 Nov 20:46

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...
Read more

Lotus Root v12.4.13

Choose a tag to compare

@Boblepointu Boblepointu released this 16 Nov 20:00

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_RETURN outputs 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.gz
one 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.zip
one 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.gz
one 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, AMD

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

docker pull ghcr.io/lotusdevorg/lotusd@sha256:f5e8b35f7d6b1016c4e0c7822aea851d95d878df7ea831c5cffc21b3e9afd94e

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.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 # 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.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, and counters.localShareDrops, localBlockShareDrops and
    localJobsRestored report 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>/raw looks 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.
  • getblocktemplate gives 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 under check.

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
    loadtxoutset RPC) 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...
Read more