docs-site: v1.29.1

1.29.1 (2025-06-18)

Documentation

• docs-site: update based-preconfirmation.mdx to avoid legal implications (#19612) (a8f600e)

docs-site: v1.29.0

1.29.0 (2025-06-16)

Features

• docs-site: general docs update (#19624) (8910049)

Bug Fixes

• docs-site: use "preconfer" to replace "preconfirmer" (#19616) (288f61e)

Chores

• docs-site: record alethia addresses in contract-addresses page (#19622) (95c7f38)

docs-site: v1.28.3

1.28.3 (2025-06-10)

Bug Fixes

• docs-site: fix eth-docker docs link in run-an-ethereum-testnet-node.mdx (#19595) (d010b6e)

docs-site: v1.28.2

1.28.2 (2025-06-10)

Chores

• docs-site: update api3 description (#19590) (55962b3)

taiko-alethia-client: v1.6.2

1.6.2 (2025-06-05) is a pre-release for the Hekla testnet for enabling based preconfirmations.

Note that since this is Stage 1 Whitelisted Preconfirmations, community members WILL NOT be able to propose/prove blocks. Community proposer/provers are encouraged to disable their proposer/provers to prevent loss of funds. Read more about the based preconfirmations rollout here.

Required Software Versions

The versions listed below are the minimum required for the upgrade. Please note that newer versions may be released, and it's advised to stay updated.

• taiko-geth v1.16.0
• taiko-client v1.6.2
• simple-taiko-node v1.17.2
• raiko v1.9.0-rc.1

Failure to upgrade may lead to proof operation failure or operational issues.

Command-Line Flag Changes

Driver Flag Changes

• --taikoL1 has been replaced by --taikoInbox. Functionally remains the same.
• --taikoL2 has been replaced by --taikoAnchor. Functionally remains the same.
• --preconfirmation.serverPort: Optional config. HTTP port of the preconfirmation block server, 0 means disabled.
• --preconfirmation.jwtSecret: Optional config. Path to a JWT secret to use for the preconfirmation block server.
• --preconfirmation.corsOrigins: Optional config. CORS Origins settings for the preconfirmation block server, default value is *.
• --preconfirmation.whitelist: Optional config. PreconfWhitelist contract L1 address.
• --preconfirmation.handoverSkipSlots: Optional config. Handover slots to provide a boundary at the end of an epoch, default value is 4.

Proposer Flag Changes

• --txPool.locals: DEPRECATED Priority inclusion accounts list has been deprecated.
• --txPool.localsOnly: DEPRECATED Same as above.

Prover Flag Changes

• --prover.startingBlockID has been replaced by --prover.startingBatchID.
• --prover.localProposerAddresses: Optional config. Comma separated list of local proposer addresses, if set, prover will prove the batches proposed by these addresses before the assignment expiration time.
• --graffiti: DEPRECATED Adding additional graffiti info to proof evidence has been deprecated.
• --mode.contester: DEPRECATED Contesters no longer part of protocol.
• --prover.port: DEPRECATED
• --http.maxExpiry: DEPRECATED
• --prover.guardianProverHealthCheckServerEndpoint: DEPRECATED Guardians no longer part of protocol.
• --guardianProverMinority: DEPRECATED
• --guardianProverMajority: DEPRECATED
• --guardian.submissionDelay: DEPRECATED
• --prover.enableLivenessBondProof: DEPRECATED
• --prover.l1NodeVersion: DEPRECATED
• --prover.l2NodeVersion: DEPRECATED

Bug Fixes

• taiko-client: dont use c.Request().Context() (#19592) (f1bcc4a)

docs-site: v1.28.1

1.28.1 (2025-06-03)

Bug Fixes

• docs-site: fix incorrect link (#19565) (4ae5483)
• docs-site: reflect actual live releases (#19579) (52c08af)

taiko-alethia-client: v1.6.1

1.6.1 (2025-06-02)

taiko-alethia-client: v1.6.0

1.6.0 (2025-05-31)

Features

• taiko-client: add checks to ensure preconfirmation blocks are based on canonical chain (#19379) (22e8a64)
• taiko-client: add more double-checks in isKnownCanonicalBlock (#19473) (bf86754)
• taiko-client: add more preconfirmation metrics (#19523) (b599ffe)
• taiko-client: check router on taiko wrapper before allowing preconf block to be made (#19525) (0c4bd86)
• taiko-client: cherry-pick a missing proposer change in 0.43.2 (#19482) (3a90600)
• taiko-client: gossip req/resp + endofsequencer mark + ws endpoint (#19361) (efc6f91)
• taiko-client: improve FetchPacaya (#19438) (e903eec)
• taiko-client: improve isBatchPreconfirmed (#19373) (efe2d99)
• taiko-client: improve RequestProof (#19433) (3580ac1)
• taiko-client: introduce --prover.localProposerAddresses flag (#19517) (e7b8f05)
• taiko-client: introduce BuildPayloadArgsID for L1Origin (#19444) (883a356)
• taiko-client: introduce GET /status for preconfirmation API server (#19358) (1dce498)
• taiko-client: introduce ImportPendingBlocksFromCache in PreconfBlockAPIServer (#19339) (0da05f5)
• taiko-client: introduce payloadQueue for P2P gossip messages (#19195) (f981f59)
• taiko-client: lookahead sliding window (#19322) (abcc6a6)
• taiko-client: preconf handover skip slots (#19271) (f7fef81)
• taiko-client: remove DELETE /preconfBlocks API (#19537) (9678be5)
• taiko-client: remove an unused field in BatchProposedIterator (#19524) (827cd89)
• taiko-client: remove Guardian Prover ABI (#19506) (349ad4b)
• taiko-client: remove two unused flags (#19434) (84f5631)
• taiko-client: run tests post Pacaya fork (#19313) (461bf65)
• taiko-client: set pacayaForkHeightMainnet (#19448) (ddc2408)
• taiko-client: validate the payload before caching it && only cache the preconf block request after sent (#19487) (973929b)

Bug Fixes

• repo: codecov integration fix (#19326) (2d6673f)
• taiko-client: a Pacaya height that the mainnet won't reach temporarily (#19299) (fe7833b)
• taiko-client: check pointer before logging (#19466) (0310690)
• taiko-client: curr range lookahead fix (#19529) (38f7ad4)
• taiko-client: fix an issue for inserting Anchor block after precomfirmation (#19425) (d7b11d1)
• taiko-client: fix an issue in isBatchPreconfirmed (#19314) (17346cf)
• taiko-client: fix an issue in RemovePreconfBlocks when no HeadL1Origin in L2 EE (#19307) (602bdd3)
• taiko-client: fix an issue in missing ancients search (#19323) (ac7ba74)
• taiko-client: fix an occasional engine.SYNCING error when receiving P2P preconf blocks (#19262) (23e4bc5)
• taiko-client: make metrics about sgx-geth more accurate (#19352) (b5c1f96)
• taiko-client: only update the lookahead once per epoch (#19483) (5c32d6a)
• taiko-client: reduce slot required for updating lookahead (#19526) (a804cb2)
• taiko-client: update highestUnsafeL2PayloadBlockID if reorging via POST /preconfBlocks (#19490) (ecc71f5)
• taiko-client: update highest unsafe payload on import child blocks (#19556) (9a0a4aa)
• taiko-client: update slots in epoch for handover (#19282) (ea4a197)

Chores

• protocol, taiko-client: general typos fix (#19272) (c22e86d)
• taiko-client: add a log for local proposer addresses (#19518) (bb1fec4)
• taiko-client: add more preconfirmation metrics (#19342) (669ab99)
• taiko-client: clean up the unused code (#19547) (87fc74f)
• taiko-client: cleanup the Ontake fork decompression method (#19528) ([e30687c](e30687c4df3...

fork-diff: v0.7.0

0.7.0 (2025-05-20)

Features

• fork-diff: update forkdiff (#19492) (b02d134)

taiko-alethia-client-v1.5.1

1.5.1 (2025-05-15) is a release for the mainnet, with support for the upcoming Pacaya fork.

Mandatory Update

Key Dates

• The contract upgrade will take place at 2:00 PM on May 20, 2025(UTC +8).
• Pacaya Fork: Estimated for May 21, 2025 UTC at block height 1,166,000. The exact time may vary due to block time variability.

Required Software Versions

The versions listed below are the minimum required for the upgrade. Please note that newer versions may be released, and it's advised to stay updated.

• Taiko BCR Protocol v2.3.0 — If using a ProverSet for block proposals, update to the new implementation.
• taiko-geth v1.15.1-hotfix
• taiko-client v1.5.1
• simple-taiko-node v1.16.1
• raiko v1.8.0

Failure to upgrade may lead to proof operation failure or operational issues.

Command-Line Flags

New Proposer Flags

• --taikoWrapper: Required config. TaikoWrapper contract address. For the mainnet, the value is 0x9F9D2fC7abe74C79f86F0D1212107692430eef72.
• --forcedInclusionStore: Required config. ForcedInclusionStore contract address. For the mainnet, the value is 0x05d88855361808fA1d7fc28084Ef3fCa191c4e03.

New Prover Flags

• --prover.proofPollingInterval: Optional config. Time interval to poll proofs from raiko host.