run-morph-node

run-morph-node is a repository designed to facilitate the deployment and management of Morph nodes using Docker. Morph is an innovative platform that enhances Ethereum Layer 2 scalability by combining optimistic rollups and zk technology, aiming to revolutionize consumer blockchain applications.

Features

• Dockerized Deployment: Simplifies the process of setting up Morph validator nodes using Docker containers.
• Network Support: Provides configurations for both Mainnet and Hoodi testnet environments.
• Snapshot Synchronization: Supports synchronizing node data from snapshots to expedite the setup process.

Prerequisites

Before setting up a Morph node, ensure you have the following installed:

• Docker: Containerization platform to run the node.
• Docker Compose: Tool for defining and running multi-container Docker applications.

Quick Start

1. Clone the Repository:

   git clone https://github.com/morph-l2/run-morph-node.git

2. Navigate to the Project Directory:

   cd run-morph-node

3. Configure Environment Variables:

   Edit the .env file to set the appropriate values for your setup if needed. For instance, specify the MORPH_HOME if you plan to user your specified directory as your node data home. By default, it takes ./mainnet as the node data home for mainnet network.

4. Download and Decompress Snapshot (Optional but Recommended):

• To expedite synchronization, download the latest snapshot:

  make download-and-decompress-mainnet-snapshot

• For Hoodi testnet, use the corresponding command:

  make download-and-decompress-hoodi-snapshot

• After downloading the snapshot, you need to manually place the decompressed data files in the appropriate node data directories.

  • For example, if the snapshot folder is named snapshot-20250122-1, move the directory snapshot-20250122-1/geth to the MORPH_HOME/geth-data directory and the contents from snapshot-20250122-1/data to the ${NODE_DATA_DIR}/data directory.

    mv ./morph-node/snapshot-20250122-1/geth ${MORPH_HOME}/geth-data
    mv ./morph-node/snapshot-20250122-1/data/* ${MORPH_HOME}/node-data/data
    

  • The folder structure will be like

    └── ${MORPH_HOME}
        ├── geth-data // data directory for geth
        │   └── static-nodes.json
        │   └── geth // directory from snapshot/geth   
        └── node-data // data directory for node
            ├── config
            │   ├── config.toml
            │   └── genesis.json
            └── data // data directory from snapshot/node
    

5. Run the Node:

• Start the node using Docker Compose:

  make run-node

  For testnet, run

  make run-hoodi-node

• This command will set up and run the node based on the configurations specified in your .env file.

Snapshot Information

The table below provides the node snapshot data and corresponding download URLs. When starting the validator, ensure the DERIVATION_START_HEIGHT and L1_MSG_START_HEIGHT variables defined in the .env(or .env_hoodi if testnet)match the selected snapshot.

For mainnet:

Snapshot Name	Derivation Start Height	L1 Msg Start Height	L2 Base Height
snapshot-20251209-1	23974107	23972111	19063835
snapshot-20251126-1	23881820	23881511	18759307
snapshot-20251022-1	23630329	23630265	17926367

For hoodi testnet:

Snapshot Name	Derivation Start Height	L1 Msg Start Height	L2 Base Height
snapshot-20251209-1	1787123	1786515	1774247
snapshot-20251126-1	1699277	1693399	1498597
snapshot-20251022-1	1464134	1463803	741619

For holesky testnet(legacy):

Snapshot Name	Derivation Start Height	L1 Msg Start Height	L2 Base Height
snapshot-20250903-1	4445350	4445989	19741862
snapshot-20250818-1	4360545	4359976	19432113
snapshot-20250428-1	3748991	3748974	17193670

Documentation

For detailed information on Morph and its ecosystem, refer to the official documentation:

• Morph Documentation

By following these steps, you can set up and run a Morph node efficiently using Docker. For any questions or support, please refer to the official Morph community channels.