v3.1.0

Security: this upgrade contains a fix for an issue where permissioned proposers can compromise user funds. Chain operators on v3.0.0 should upgrade immediately.

See the security advisory here.

Verification Key Hashes

Program	Verification Key Hash
Ethereum DA Range Verification Key	0x4aa69b1014c8bb84088b1fd535c4b3372d827bde7733153d0882ad326ee40f0b
Celestia DA Range Verification Key	0x16969f473c774e3166b5ebc7633a2c076feecd0047ef549c62cf477158819b89
Aggregation Verification Key	0x00921c654a366744f63d70f0e1835d29283d0d9811ff6f870033fcb71b580b18

What's Changed

• chore: unify binary name for celestia docker image by @fakedev9999 in #577
• feat: improve op-succinct-lite by @fakedev9999 in #583
• fix: use end exclusive range by @fakedev9999 in #585
• chore: bump hana by @fakedev9999 in #578
• feat: add cycles + prover gas metrics by @fakedev9999 in #579
• docs: update spn usage by @fakedev9999 in #592
• docs: make update parameters flow more clear by @yuwen01 in #590
• fix: kzg verification 3.1.0 by @yuwen01 in #594

Full Changelog: v3.0.0...v3.1.0

v2.3.1

Security: this upgrade contains a fix for an issue where permissioned proposers can compromise user funds. Chain operators on v2.3.0 should upgrade immediately.

See the security advisory here.

Verification key hashes

Program	Verification Key Hash
Ethereum DA Range Verification Key	0x490685ea27adbbb83301073734f40a5656c984fe352359d54dd637e828e66872
Celestia DA Range Verification Key	0x3bbdf4dc00db6ade0d258caf77fd78480add5e4c6703c3812a6a10e74f78ec02
Aggregation Verification Key	0x003991487ea72a40a1caa7c234b12c0da52fc4ccc748a07f6ebd354bbb54772e

What's Changed

• fix: kzg verification 2.3.1 by @yuwen01 in #593

Full Changelog: v2.3.0...v2.3.1

v3.0.0

Security: A vulnerability that allows permissioned proposers to compromise user funds has been identified. Chain operators should upgrade to 3.1.0 immediately.

Updated Verification Key Hashes

Please update your contracts with these new values before upgrading to v3.0.0.

Range Verification Key Hash

DA Layer	Verification Key Hash
Ethereum	0x449041861303f3876a6c8a8c1009f53363d1650c4bf250a7465900fb2dde1657
Celestia	0x2f4f8db862021f143c76ac121784a66b35fe7d4f027e11dc372289b001c8e2a4

Aggregation Verification Key Hash (same for all DAs)

0x00d95a511d8291249acb748c6acef9757c7b358301f6b2f7cfbcf24065c93eb6

What's Changed

• chore: update elfs by @fakedev9999 in #522
• fix: metrics and networking for lite docker compose by @yuwen01 in #527
• feat: add fallback proposal mechanism to L2OutputOracle by @puma314 in #526
• ci: large disk for docker builds by @yuwen01 in #530
• fix: fix l1 head selection for celestia da by @fakedev9999 in #528
• fix: use explicit transaction request for game prove calls by @fakedev9999 in #535
• feat: implement malicious challenge by @fakedev9999 in #538
• feat: rollup configs by @yuwen01 in #531
• feat: fault proof deployment qol by @yuwen01 in #534
• fix: refactor fault-proof proposer to use task-based concurrency by @fakedev9999 in #540
• fix: record proposal permissioning bug by @yuwen01 in #541
• fix: storage layout by @yuwen01 in #543
• fix: remove trace extension shortcut by @yuwen01 in #550
• feat: no more spot by @yuwen01 in #553
• feat: log exporting by @yuwen01 in #547
• chore: support contract verification for fp by @fakedev9999 in #555
• feat: validate agg by @yuwen01 in #552
• test: improve e2e testing with anvil by @fakedev9999 in #549
• ci: add link + spell checker by @fakedev9999 in #564
• feat: Add comprehensive logging for range and aggregation proof requests by @0xsharma in #560
• chore: bump kona by @fakedev9999 in #554
• feat: prove task improvements by @fakedev9999 in #558
• feat: improve fault proof by @fakedev9999 in #563
• feat: update to support celestia indexer changes by @fakedev9999 in #561
• chore: pin nightly rust toolchain by @yuwen01 in #580
• feat: audit fix by @yuwen01 in #575

New Contributors

• @0xsharma made their first contribution in #560

Full Changelog: v2.3.0...v3.0.0

v3.0.0-rc.1

Security note

This release candidate is not recommended for production usage. It contains significant contract changes, which have not yet been audited.

In every version <= 2.3.0, there is a vulnerability for both validity and fault proofs in permissionless mode which allows arbitrary proposers to halt withdrawals. No user funds are at risk, but this vulnerability can result in degraded user experience.

As of July 11th, 2025, we recommend using version 2.3.0 in permissioned mode for production use cases.

Thanks to cergyk for finding this vulnerability.

What's Changed

• chore: update elfs by @fakedev9999 in #522
• fix: metrics and networking for lite docker compose by @yuwen01 in #527
• feat: add fallback proposal mechanism to L2OutputOracle by @puma314 in #526
• ci: large disk for docker builds by @yuwen01 in #530
• fix: fix l1 head selection for celestia da by @fakedev9999 in #528
• fix: use explicit transaction request for game prove calls by @fakedev9999 in #535
• feat: implement malicious challenge by @fakedev9999 in #538
• feat: rollup configs by @yuwen01 in #531
• feat: fault proof deployment qol by @yuwen01 in #534
• fix: refactor fault-proof proposer to use task-based concurrency by @fakedev9999 in #540
• fix: record proposal permissioning bug by @yuwen01 in #541
• fix: storage layout by @yuwen01 in #543
• fix: remove trace extension shortcut by @yuwen01 in #550
• feat: no more spot by @yuwen01 in #553

Full Changelog: v2.3.0...v3.0.0-rc.1

v2.3.0

For Chain Operators

A vulnerability that allows permissioned proposers to compromise user funds has been identified. Upgrade to 2.3.1 or 3.1.0 immediately.

Updated Verification Key Hashes

Please update your contracts with these new values before upgrading to v2.3.0.

Range Verification Key Hash

DA Layer	Verification Key Hash
Ethereum	0x0ea16a87731757ad1753d1906cb006de1fdd6a760add547c0c691bcd0914de7e
Celestia	0x485320771abe7d175add74281532a8ca5f55331a618074f030fc909b450765a5

Aggregation Verification Key Hash (same for all DAs)

0x009db7eba2814292b350d8b18e3861fcf8cb387de821c3d4546b79552ee2afa5

What's Changed

• docs(architecture): BatchInbox.sol -> BatchInbox by @ratankaliani in #500
• docs: fix broken link and update link by @fakedev9999 in #499
• docs: guide with env var value by @fakedev9999 in #503
• feat: use alloy web3 signer by @fakedev9999 in #502
• chore(ci): run cycle count diff in release by @ratankaliani in #504
• feat(fetcher): concurrent headers by @ratankaliani in #505
• refac: remove conditional compilation over DA types by @fakedev9999 in #501
• refactor: move zkvm ELFs into a separate crate by @fakedev9999 in #508
• docs: add cost estimator docs by @fakedev9999 in #513
• feat: add web3 signer support for op-succinct-lite by @fakedev9999 in #514
• chore: bump hana by @fakedev9999 in #512
• chore: bump sp1 to 5.0.0 by @fakedev9999 in #519

Full Changelog: v2.2.0...v2.3.0

v2.2.0

Overview

Supports Isthumus Mainnet activation times.

Full Changelog: v2.1.1...v2.2.0

v2.1.1

What's Changed

• ci: add cycle count diff by @fakedev9999 in #459
• chore(dockerfile): add jq by @ratankaliani in #475

Full Changelog: v2.1.0...v2.1.1

v2.1.0

Overview

• Support for the Isthumus HF on Sepolia testnets from Kona. Mainnet activation times will be included in a future release. 🌊

What's Changed

• docs: update by @theedwardli in #465
• docs: update by @theedwardli in #466
• chore(book): typos by @ratankaliani in #467
• docs(book): update by @ratankaliani in #468
• chore(programs): bump kona by @ratankaliani in #470
• chore: bump kona to kona-client/v0.1.0-beta.15 by @fakedev9999 in #474

New Contributors

• @theedwardli made their first contribution in #465

Full Changelog: v2.0.0...v2.1.0

v2.0.0

v2.0.0

Overview

• Unified the validity proposer into a single Rust binary. 🔥
• Adds support for the OP Stack's L1 Pectra upgrade (v0.1.0-beta.13) from kona. ⭐️
• Add support for SP1 prover gas tracking. ⛽️
• Reduces memory usage for validity proposer. 📉

Changelist

• Validity Contract Changes
• FP Contract Changes
• New Verification Keys
  • Range Verification Key Commitment: 0x21dd1d9f4c2a3a8547746fad0cb0e1aa520e89874996df760f7e81a25d1435d0
  • Aggregation Verification Key Hash: 0x000c4887ab85d744c36666ede14c801f31fd5bcfe2c1905ba40ca0600e77d8ba
• New Rollup Config
• New Docker images

Full Changelog: v1.2.3...v2.0.0

Full Changelog: v1.2.3...v2.0.0

v2.0.0-alpha-2

Overview

Alpha release of OP Succinct 2.0.

New Contributors

• @jhkimqd made their first contribution in #407
• @TimTinkers made their first contribution in #406

Full Changelog: v1.2.2...v2.0.0-alpha-2