Skip to main content

zkTrie -> MPT Migration

This page focuses on one task: migrating a node from zkTrie state storage to MPT.

What changes with MPT​

  • State format changes from zkTrie to MPT.
  • Data is not reusable across formats.
  • Migration is one-way for data directories.
danger

Do not reuse an existing zkTrie data directory for an MPT node. Prepare a fresh MPT data directory or restore from an MPT snapshot.

Pick your path​

1) Fresh deployment​

If you are deploying a new node, use the full node guide directly (MPT is the default path):

2) Existing zkTrie node, binary update only​

If you want to keep zkTrie storage for now, update binaries and restart using the same startup command.

3) Existing zkTrie node, migrate to MPT​

If you want to switch storage to MPT:

  1. Stop the current node.
  2. Prepare a fresh MPT data directory (or restore an MPT snapshot).
  3. Start the node with MPT configuration.

For setup details, follow:

Quick checks​

  • Can I reuse zkTrie data? No.
  • Can I roll back MPT data to zkTrie? No, there is no supported data rollback path.
  • Where are snapshot versions and matching heights? See Snapshot Information.