Linea Besu v2.0.0

Release Artifact: Linea Besu Package

Name: linea-besu-package-2.0.0-20260714-6a92ee2.tar.gz
SHA256: a810c50a861432de893f155057e879d42a8436a103f00c3d1a8c87e3b2a7b9b0
From: main (workflow_dispatch)

Besu and Plugin Details

Module	Version	SHA-256
linea-besu	26.6.1-3fd233a	34120dc6aab2af2205a63818d234e500d03727645a8d1c6218cd640f86b8dcbe
linea-sequencer-plugin	linea-6a92ee2	02b8755056ec974244ddb8f61ef91582b73512febe2589da734d2a6f21621734
linea-tracer-plugin	linea-6a92ee2	70b015f6ec45b0affef54d9f9a5eff833bd0c56044af22edc9f2462dd658c476
linea-staterecovery-plugin	1.0.4	11f10ca84e9ab26b5d95e6f09cefb42c0c0063f237a0586700477d9fbeceaea7
shomei-plugin	1.0.7	f23397b6bb1d0887ef7ecb21e4fce66890d3a17b3fb4f7b0cef9595b54bdca15
besu-fleet-plugin	0.4.0	dca5935dbaa2d095cbcbf7ef55ca7dc269beee5a6369f17c260c2b0831543eee

Docker Image Details

To pull the image, use any of the following commands:

docker pull consensys/linea-besu-package:2.0.0-20260714-6a92ee2

To pull the image with Besu fleet plugin, use any of the following commands:

docker pull consensys/linea-besu-package-with-fleet:2.0.0-20260714-6a92ee2

Digest	OS	Architecture
sha256:d0efb760b87c5593439a37585726ebeff404c7f5b268acfa23868400b9325626	linux	arm64
sha256:fdba8d813f482d0051710ded4d99509108b19213f1b1cb3287d3e027dca06752	linux	amd64

What's Changed

[2.0.0] - 2026-07-14

🚀 Features

• (coordinator) [breaking] Web3j upgrade to onboard 7594 support (#3514)

🐛 Bug Fixes

• (misc) Web3j-solc solidity resolution workaround (#3516)
• (linea-besu) Updating Besu version (#3535)

⚙️ Miscellaneous Tasks

• (coordinator) Update kotlin to v2.4 (#3454)
• (ci) Update image tags (#3553)
• (deps) Align bouncycastle catalog pin to 1.84 (#3562)

zkevm-fixtures-input-mainnet-500-Q12026

Blocks from Ethereum mainnet to test the guest program.

Coordinator v0.3.0

[0.3.0] - 2026-07-07

🚀 Features

• (coordinator) Add config schema walker for docs generation (#3488)

🐛 Bug Fixes

• (coordinator) Pretty-print startup config logs (#3203)
• (coordinator) Bound eth_getLogs in finalized-state lookup (#3519)
• (coordinator) Bound eth_getLogs in deployment-block lookup (#3520)
• (coordinator) L1FinalizationPriorityFeeCalculator feeLowerBound config (#3517)

Docker Image Details

To pull the image, use any of the following commands:

docker pull consensys/linea-coordinator:0.3.0-20260707-2fc1581

Coordinator v0.2.0

[0.2.0] - 2026-07-03

🚀 Features

• (coordinator) Add config documentation annotations (#3463)
• (coordinator) First draft of risc-v prover client (#3269)

🐛 Bug Fixes

• (coordinator, jvm-libs, e2e, state-recovery, prover, docker, misc) Remove state manager request version (#3099)
• (coordinator) Remove traces version from requests (#3110)
• (coordinator) Export FTX number metrics (#3165)
• (coordinator) Drop insecure FileWriter temp-file fallback (CodeQL 21207) (#3413)
• (coordinator) Fixed a flacky test by closing the ftxInvalidityProofService in the ForcedTransactionsApp (#3438)
• (coordinator) Forced transactions concurrency update (#3444)
• (coordinator) Bound eth_getLogs queries to provider block-range limits (#3473)

🚜 Refactor

• (misc) Rename Linea to Lineth across documentation and codebase (#3316)

⚙️ Miscellaneous Tasks

• (coordinator) Make persistence module flat (#3066)
• (coordinator) Rename package net.consensys.zkevm.persistence to linea.persistence #3073
• (2876) Rename catch variable from it to e in GoBackedBlobShnarfCalculator (#2889)
• (2876) Coordinator review fixes — dead code, null safety, exception handling, dedup (#2882)
• (coordinator) Move Web3SignerTxSignService into web3j-extensions lib (#3091)
• (coordinator) Remove "build" prefix from package names
• (coordinator) Rename packages net.consensys.zkevm.* -> linea.* (#3105)
• (coordinator) Log and message error improvements (#3193)
• (coordinator) Favour generic name ChainSecurityRuleViolation over specific implementation Phylax (#3330)
• (coordinator) Update kotlin to v2.4 (#3454)
• (coordinator) LSP violation fix (#3386)

Docker Image Details

To pull the image, use any of the following commands:

docker pull consensys/linea-coordinator:0.2.0-20260703-696e42e

@lfdt-lineth/sdk-viem@1.1.0

1.1.0 (2026-06-29)

• refactor(sdk-viem): extract inlined contract ABIs into shared module (#3460) (1be49d0)
• fix(sdk-viem): bound eth_getLogs queries to avoid provider block-range limits issue (#3450) (a47dc30)

Linea Besu v1.1.1

Release Artifact: Linea Besu Package

Name: linea-besu-package-1.1.1-20260626-d9f04f0.tar.gz
SHA256: fb4c4659cf87540299d5bfbffc78ba3de9226f86f580f65744ced7ecabaecbfb
From: main (workflow_dispatch)

Besu and Plugin Details

Module	Version	SHA-256
linea-besu	26.5.0-9fcf3cc	33209cd1e06517af362c17878c9bd582e1a030931482c0a894ac963761669c34
linea-sequencer-plugin	linea-d9f04f0	18a4d60a1f601ef97eaf2bd67859ad353ee81afffc7eb111456c902083fc4b46
linea-tracer-plugin	linea-d9f04f0	c425f018fc4e8b07f763627ada84d650bd916630aeb8a80eae762b4e41d4c9a1
linea-staterecovery-plugin	1.0.4	11f10ca84e9ab26b5d95e6f09cefb42c0c0063f237a0586700477d9fbeceaea7
shomei-plugin	1.0.6	9d583172831aba52a1fd3d20c799d3b7ef89b8535c872ebd6a39a679f286c6a5
besu-fleet-plugin	0.4.0	dca5935dbaa2d095cbcbf7ef55ca7dc269beee5a6369f17c260c2b0831543eee

Docker Image Details

To pull the image, use any of the following commands:

docker pull consensys/linea-besu-package:1.1.1-20260626-d9f04f0

To pull the image with Besu fleet plugin, use any of the following commands:

docker pull consensys/linea-besu-package-with-fleet:1.1.1-20260626-d9f04f0

Digest	OS	Architecture
sha256:d0a60e143ce2f0397c5f7f5e442386d581dae6e6efe79350df0ee8f1df5f9f0b	linux	arm64
sha256:4978e3be6dce0b3415521e1b4eedd5780f7af0707ec8a96581dd7a83cb87b2a3	linux	amd64

What's Changed

[1.1.1] - 2026-06-26

🐛 Bug Fixes

• (e2e) Trying to fix rare profitability issues, FTX fix (#3388)
• (besu-plugins) Removed mutual exclusiveness of the txpool and blo… (#3416)
• (Maru) Fixed a bug when simultaneous mutual connection attempts r… (#3439)

Linea Besu v1.1.0-rc1

Release Artifact: Linea Besu Package

Name: linea-besu-package-1.1.0-rc1-20260611-7bc1962.tar.gz
SHA256: 2063738bc9e777952ee07d9dbee27a50b42afb0c2f0654a912b3f22585ae079f
From: ci/chore-add-maru-tag-as-develop-in-e2e (workflow_dispatch)

Besu and Plugin Details

Module	Version	SHA-256
linea-besu	26.5.0-9fcf3cc	33209cd1e06517af362c17878c9bd582e1a030931482c0a894ac963761669c34
linea-sequencer-plugin	linea-7bc1962	b552c04d5e139e90b807bb37ae10fdf35310b48b39b31b72da191e37c6204ea0
linea-tracer-plugin	linea-7bc1962	371519763589c0412ddefea1762488c98d8a1b88e79457751c495bf894b79378
linea-staterecovery-plugin	1.0.4	11f10ca84e9ab26b5d95e6f09cefb42c0c0063f237a0586700477d9fbeceaea7
shomei-plugin	1.0.6	9d583172831aba52a1fd3d20c799d3b7ef89b8535c872ebd6a39a679f286c6a5
besu-fleet-plugin	0.4.0	dca5935dbaa2d095cbcbf7ef55ca7dc269beee5a6369f17c260c2b0831543eee

Docker Image Details

To pull the image, use any of the following commands:

docker pull consensys/linea-besu-package:1.1.0-rc1-20260611-7bc1962

To pull the image with Besu fleet plugin, use any of the following commands:

docker pull consensys/linea-besu-package-with-fleet:1.1.0-rc1-20260611-7bc1962

Digest	OS	Architecture
sha256:50e5bcd5815164718c229d61522c7bb44916e2c4fafcce2a2ec425ba0d64552a	linux	arm64
sha256:57cd1dbf7e9f74f92af6a35727bced595e67aab26bb8be60da8b91fecdc6dc7e	linux	amd64

What's Changed

[1.1.0-rc1] - 2026-06-11

🚀 Features

• (linea-besu) Add interfaces module: security and LineaTransactionSelectionResult (#3238)
• (linea-besu) Forced transactions integration with security policy transaction selector (#3295)

🐛 Bug Fixes

• (sequencer) Bypass background scheduler collision in buildNewBlockAndWait(Long) (#3072)
• (tracer) No parallelism (#2957)
• (arithmetization) Fix alert 514 (#3246)
• (arithmetization) Security alert 513 on loop condition in BlockDataInstruction (#3253)

🚜 Refactor

• (misc) Rename Linea to Lineth across documentation and codebase (#3316)

⚙️ Miscellaneous Tasks

• (linea-besu) Move besu project under nested directory (#3063)
• (linea-besu) Move linea-besu-package into linea-besu/package (#3069)
• (linea-besu) Move besu-plugins into linea-besu/plugins (#3075)
• (misc) Besu-plugin acceptance test cleanup of deadcode (#3152)
• (maru) Remove spring dependency management (#3205)
• (misc) Rename Consensys/linea-monorepo references to LFDT-Lineth/lineth-monorepo (#3297)
• (misc) Point references at in-tree paths for previously-external repos (#3309)

Linea Besu v1.1.0

Release Artifact: Linea Besu Package

Name: linea-besu-package-1.1.0-20260611-4b80178.tar.gz
SHA256: 93dc14813f4183e6e8488ca92e6b5c93b25e65b72dd8e387f764ad6538b14b7f
From: main (workflow_dispatch)

Besu and Plugin Details

Module	Version	SHA-256
linea-besu	26.5.0-9fcf3cc	33209cd1e06517af362c17878c9bd582e1a030931482c0a894ac963761669c34
linea-sequencer-plugin	linea-4b80178	c76eb2833d7826b8b6fd147f6cff335f183b78e71df8053e5b03911229699d8e
linea-tracer-plugin	linea-4b80178	a102c008b3f19cf86f033e2108326b60368efd4816bd0feac32a718cc79a5982
linea-staterecovery-plugin	1.0.4	11f10ca84e9ab26b5d95e6f09cefb42c0c0063f237a0586700477d9fbeceaea7
shomei-plugin	1.0.6	9d583172831aba52a1fd3d20c799d3b7ef89b8535c872ebd6a39a679f286c6a5
besu-fleet-plugin	0.4.0	dca5935dbaa2d095cbcbf7ef55ca7dc269beee5a6369f17c260c2b0831543eee

Docker Image Details

To pull the image, use any of the following commands:

docker pull consensys/linea-besu-package:1.1.0-20260611-4b80178

To pull the image with Besu fleet plugin, use any of the following commands:

docker pull consensys/linea-besu-package-with-fleet:1.1.0-20260611-4b80178

Digest	OS	Architecture
sha256:3f82db58642bca38620824c812325a129d20eea3d872f2efc3acb4ad9d3ccbdc	linux	arm64
sha256:29f78a8fe2ecdf7000c9f527a56f197aaebd00964198a4934b2b72d1106d176a	linux	amd64

What's Changed

[1.1.0] - 2026-06-11

🚀 Features

• (linea-besu) Add interfaces module: security and LineaTransactionSelectionResult (#3238)
• (linea-besu) Forced transactions integration with security policy transaction selector (#3295)

🐛 Bug Fixes

• (sequencer) Bypass background scheduler collision in buildNewBlockAndWait(Long) (#3072)
• (tracer) No parallelism (#2957)
• (arithmetization) Fix alert 514 (#3246)
• (arithmetization) Security alert 513 on loop condition in BlockDataInstruction (#3253)

🚜 Refactor

• (misc) Rename Linea to Lineth across documentation and codebase (#3316)

⚙️ Miscellaneous Tasks

• (linea-besu) Move besu project under nested directory (#3063)
• (linea-besu) Move linea-besu-package into linea-besu/package (#3069)
• (linea-besu) Move besu-plugins into linea-besu/plugins (#3075)
• (misc) Besu-plugin acceptance test cleanup of deadcode (#3152)
• (maru) Remove spring dependency management (#3205)
• (misc) Rename Consensys/linea-monorepo references to LFDT-Lineth/lineth-monorepo (#3297)
• (misc) Point references at in-tree paths for previously-external repos (#3309)

@lfdt-lineth/sdk-viem@1.0.0

1.0.0 (2026-06-10)

Initial release of @lfdt-lineth/sdk-viem, a TypeScript SDK for interacting with the Linea bridge and messaging system built on Viem.

Features

• ETH and ERC-20 deposits -- deposit action to bridge tokens or native ETH from L1 to L2 via the Linea Token Bridge
• ETH and ERC-20 withdrawals -- withdraw action to bridge tokens or native ETH from L2 to L1
• L1 message claiming -- claimOnL1 action to finalize an L2-to-L1 message with a Merkle proof (auto-fetched or caller-supplied)
• L2 message claiming -- claimOnL2 action to finalize an L1-to-L2 message on the L2 Message Service
• L1-to-L2 message status -- getL1ToL2MessageStatus to query whether an L1-to-L2 message is unknown, claimable, or claimed
• L2-to-L1 message status -- getL2ToL1MessageStatus to query whether an L2-to-L1 message is unknown, claimable, or claimed, including finalization checks
• Message proof retrieval -- getMessageProof to fetch the Merkle proof required for claiming an L2-to-L1 message on L1
• Message lookup by hash -- getMessageByMessageHash to retrieve full message details from on-chain MessageSent events
• Message lookup by transaction -- getMessagesByTransactionHash to retrieve all messages emitted in a given transaction
• Receipt lookup by message hash -- getTransactionReceiptByMessageHash to find the transaction receipt that contains a specific message
• MessageSent event queries -- getMessageSentEvents to fetch MessageSent logs for a given block range
• Block extra data parsing -- getBlockExtraData to decode Linea-specific block extraData into version and fee parameters
• Message hash computation -- computeMessageHash utility to deterministically hash message parameters

Decorators

• publicActionsL1 / publicActionsL2 -- extend a Viem public client with all Linea read actions (message status, proofs, events, block extra data)
• walletActionsL1 / walletActionsL2 -- extend a Viem wallet client with all Linea write actions (deposit, withdraw, claim)
• All decorators accept optional custom contract addresses for non-standard deployments

Network Support

• Ethereum Mainnet, Linea Mainnet, Sepolia, and Linea Sepolia with automatic contract address resolution via @lfdt-lineth/sdk-core

Error Handling

• Structured Viem BaseError subclasses: MessageNotFoundError, L2BlockNotFinalizedError, MessagesNotFoundInBlockRangeError, MerkleRootNotFoundInFinalizationDataError, EventNotFoundInFinalizationDataError, MissingMessageProofOrClientForClaimingOnL1Error, AccountNotFoundError

@lfdt-lineth/sdk-core@1.0.0

1.0.0 (2026-06-10)

Initial release of @lfdt-lineth/sdk-core, the framework-agnostic foundation for Linea bridge SDKs.

Features

• Sparse Merkle Tree -- SparseMerkleTree class with configurable depth and hash function; leaf management, root computation, and Merkle proof generation returning MessageProof
• Block extra data parsing -- parseBlockExtraData to decode Linea block extraData into version and fee parameters
• Message status formatting -- formatMessageStatus mapping on-chain numeric statuses to OnChainMessageStatus enum (UNKNOWN, CLAIMABLE, CLAIMED)
• Contract address resolution -- getContractsAddressesByChainId returning canonical addresses (Linea Rollup, Message Service, Token Bridge) for Ethereum Mainnet, Sepolia, Linea Mainnet, and Linea Sepolia
• Chain identification -- isMainnet, isSepolia, isLineaMainnet, isLineaSepolia predicates

Types

Bridge client surface:

• L1PublicClient / L2PublicClient -- read-only bridge operations (message lookup, status, proof retrieval, block extra data)
• L1WalletClient / L2WalletClient -- write bridge operations (deposit, withdraw, claim)
• Message, ExtendedMessage, MessageProof, OnChainMessageStatus
• Framework-agnostic transaction types (logs, receipts, EIP-compliant request variants)