EspressoSystems/espresso-network 20260710

on GitHub

Release Notes for mainnet operators

This release stages a mainnet protocol upgrade to distribute the block rewards per epoch, instead of once per block.

Actions for all nodes

• If you set ESPRESSO_SEQUENCER_STORAGE_PATH also set
  ESPRESSO_NODE_STORAGE_PATH to the same value.

• You're encouraged to send logs and/or metrics to Espresso by setting
  ESPRESSO_NODE_TELEMETRY_LOGS_ENABLE=true
ESPRESSO_NODE_TELEMETRY_METRICS_ENABLE=true

• Please set ESPRESSO_NODE_IDENTITY_COMPANY_NAME and ESPRESSO_NODE_IDENTITY_NODE_NAME,
  or --company-name and --node-name when using CLI arguments.

Actions for query nodes (query module enabled)

Enable the light-client module to allow other nodes to catchup via
the new Light Client catchup feature.

E.g. ... -- storage-sql -- http -- query -- light-client -- [other modules]

Actions for nodes with manually configured genesis file

• Stage upgrade by using this mainnet.toml genesis file:
  https://github.com/EspressoSystems/espresso-network/blob/20260710/data/genesis/mainnet.toml

  For the official docker image the correct file will be loaded by default.

Notes

• Environment variables have been renamed in a backwards compatible way.
  You will see startup warnings for the deprecated env vars but it is not
  necessary to set the new variables for this binary upgrade. The old
  env vars are still supported. We recommend not modifying env vars and
  grepping startup logs for WARNING: to see which env vars need to be
  migrated.

• A DB migration will run in the background for query nodes:

  • DB load will be slightly elevated, 10 - 20% temporary storage bloat.
  • You can check /database/migration-status for the migration status.
  • The migration can potentially take weeks.
    • If you encounter issues please reach out to us: rolling back the binary
      will not succeed to start up the node.

--

What's Changed

• Remove Coordinator/Cliquenet. by @twittner in #4664
• [Backport release-mainnet-1.2.0-rc] fix(clippy): resolve lints and bump rust-overlay by @github-actions[bot] in #4666
• [Backport release-mainnet-1.2.0-rc] fix: demote spammy warn log to debug by @github-actions[bot] in #4668

Full Changelog: 2026070...2026071