Mainnet 0 to Mainnet Upgrade

Migrating rollup integrations from Mainnet 0 to Mainnet

This guide applies to chains that integrated Espresso on Mainnet 0 using Nitro-style batch posting to a parent chain.

If you have a rollup using the Espresso network version 0 for confirmations, some changes are necessary in order to be compatible with version 1. These changes should be minimal. They must be completed before April 15, 2025 for the Decaf testnet. Mainnet launched on March 4, 2026. Rollups should complete this migration to remain compatible.

Estimated Effort: 1 engineer-day

Rust Integrations

1. Update dependencies:

hotshot-types = { git = "https://github.com/EspressoSystems/espresso-network", default-features = false, tag = "20250412-dev-node-pos-preview" }
hotshot-query-service = { git = "https://github.com/espressosystems/espresso-network", tag = "20250412-dev-node-pos-preview" }
espresso-types = { git = "https://github.com/espressosystems/espresso-network", tag = "20250412-dev-node-pos-preview" }

1. The following types have been moved to different modules, so you may have to adjust some import statements:

use hotshot_query_service::VidCommon;
use hotshot_types::{data::VidCommitment, light_client::hash_bytes_to_field};

Go Integrations

1. Update the Espresso Go SDK:

require github.com/EspressoSystems/espresso-network-go v0.0.35

All Integrations

1. Change the API you use to connect to the Espresso query service from v0to v1(as in https://query.decaf.testnet.espresso.network/v1or https://query.main.net.espresso.network/v1.

2. Test your integration with the new version of Espresso. You can run a local Espresso network in v1mode using a fork of the Espresso dev node, with the usual options: ghcr.io/espressosystems/espresso-sequencer/espresso-dev-node:20250412-dev-node-pos-preview