Feature/add monad

README.md

@@ -42,6 +42,7 @@ Battlefield supports testing across various forks of Ethereum. Usually, you need
 | Polygon (fh 3.0)         | `./scripts/run_firehose_polygon.sh`                                                           | `pnpm test:fh3.0:polygon-dev`, ` ./scripts/polygon-bridge` | Heavy on dependencies (kurtosis, cast, polycli, bats...)                       |
 | Besu (fh 3.0)            | `./scripts/run_firehose_besu_devnet.sh`                                                       | `pnpm test:fh3.0:besu-devnet`                              | Requires [besu](https://besu.hyperledger.org/) binary, [builder-playground](https://github.com/flashbots/builder-playground) |
 | Optimism Devnet (fh 3.0) | `./scripts/optimism/run_optimism_devnet.sh` then `./scripts/run_firehose_optimism_devnet.sh`. | `pnpm test:fh3.0:optimism-devnet`                          | Requires [builder-playground](https://github.com/flashbots/builder-playground) |
+| Monad (fh 3.0)           | `./scripts/run_monad_devnet.sh`                                                               | `pnpm test:fh3.0:monad-dev`                                | Requires Monad node with event ring enabled                                  |
 
 After each test, you should also run:
 

hardhat.config.ts

@@ -36,6 +36,14 @@ const config: HardhatUserConfig = {
     "polygon-dev": firehoseNetwork([]),
     "optimism-devnet": { ...firehoseNetwork([]), url: "http://127.0.0.1:8547" },
     "besu-devnet": { ...firehoseNetwork([]), url: "http://127.0.0.1:8545" },
+    "monad-dev": {
+      ...firehoseNetwork([]),
+      url: "http://127.0.0.1:18080",
+      //   accounts: [
+      //   ^  // Foundry pre-funded account with massive balance on localnet
+      //     "0xac0974bec39a17e36ba4a6b4d238ff944bacb478cbed5efcae784d7bf4f2ff80",
+      //   ],
+    },
   },
 
   mocha: {

package.json

@@ -18,6 +18,7 @@
     "test:fh3.0:optimism-geth-dev": "cross-env SNAPSHOTS_TAG=fh3.0/optimism-geth-dev hardhat test --network optimism-geth-dev",
     "test:fh3.0:besu-devnet": "cross-env SNAPSHOTS_TAG=fh3.0/besu-devnet hardhat test --network besu-devnet",
     "test:fh3.0:amoy": "cross-env SNAPSHOTS_TAG=fh3.0/amoy hardhat test --network amoy",
+    "test:fh3.0:monad-dev": "cross-env SNAPSHOTS_TAG=fh3.0/monad-dev bash scripts/run_monad_devnet.sh",
     "test:fh2.3:arbitrum-geth-dev": "cross-env SNAPSHOTS_TAG=fh2.3/arbitrum-geth-dev hardhat test --network arbitrum-geth-dev"
   },
   "keywords": [],
@@ -65,4 +66,4 @@
   "pnpm": {
     "onlyBuiltDependencies": ["c-kzg", "keccak", "secp256k1"]
   }
-}
+}

scripts/lib.sh

@@ -6,6 +6,8 @@ private_key_to_fund="${PRIVATE_KEY_TO_FUND:-"0x52e1cc4b9c8b4fc9b202adf06462bdcc2
 # FIXME: Ideally we would derive the address from the private key to fund directly, for now, they must both match
 address_to_fund="${ADDRESS_TO_FUND:-"0x821b55d8abe79bc98f05eb675fdc50dfe796b7ab"}"
 
+monad_devnet_genesis_private_key="${MONAD_DEVNET_GENESIS_PRIVATE_KEY:-"0xac0974bec39a17e36ba4a6b4d238ff944bacb478cbed5efcae784d7bf4f2ff80"}"
+
 fireeth="${FIREETH_BINARY:-fireeth}"
 geth="${GETH_BINARY:-geth}"
 nitro="${NITRO_BINARY:-nitro}"
@@ -220,6 +222,15 @@ check_sd() {
   fi
 }
 
+check_monad() {
+  if ! command -v "monad" &> /dev/null; then
+    echo ""
+    echo "The 'monad' binary could not be found."
+    echo ""
+    exit 1
+  fi
+}
+
 check_builder_playground() {
   if ! command -v builder-playground &> /dev/null; then
     echo "The 'builder-playground' command is required for this script, please install it"

scripts/monad-devnet/README.md

@@ -0,0 +1,46 @@
+# Monad Devnet Setup for Battlefield Testing
+
+Before running the Monad battlefield tests, ensure you have a monad node configured. ([Monad docs](https://docs.monad.xyz/node-ops/full-node-installation))
+## Configuration Files
+
+This directory contains pre-configured files for running Monad devnet:
+
+[For all docs related](https://docs.monad.xyz/node-ops/)
+- **node/node.toml** - Node configuration (peer discovery, statesync settings)
+- **node/forkpoint.toml** - Genesis configuration
+- **node/validators.toml** - Validator set configuration
+- **node/id-bls** - BLS identity key
+- **node/id-secp** - SECP256k1 identity key
+- **node/profile.json** - Seccomp security profile
+- **compose.yaml** - Docker Compose configuration for Monad services
+- **compose.prebuilt.yaml** - Docker image overrides for images
+- **docker-compose.localnet-firehose.yml** - Firehose and Substreams infrastructure
+
+### Configuration Origins
+
+Configuration files can be obtained from:
+
+Validators: `https://bucket.monadinfra.com/validators/devnet/validators.toml`
+Forkpoint: `https://bucket.monadinfra.com/forkpoint/devnet/forkpoint.toml`
+
+## Running Tests
+
+Once setup is complete, run the Monad battlefield tests:
+
+```bash
+pnpm test:fh3.0:monad-dev
+```
+
+The script will:
+1. Validate your environment and prerequisites
+2. Start Monad devnet containers
+3. Wait for Monad RPC to be ready
+4. Wait for the event ring to be created
+5. Start Firehose infrastructure
+6. Run the battlefield test suite
+
+## Docker Images
+
+- **monad-execution**: `ghcr.io/streamingfast/monad-execution:73ef8ec`
+- **monad-node**: `ghcr.io/streamingfast/monad-node:eede85a`
+- **monad-rpc**: `ghcr.io/streamingfast/monad-rpc:eede85a`

scripts/monad-devnet/compose.prebuilt.yaml

@@ -0,0 +1,11 @@
+services:
+  build_triedb:
+    image: ghcr.io/streamingfast/monad-execution:cb8a4ce
+  build_genesis:
+    image: ghcr.io/streamingfast/monad-execution:cb8a4ce
+  monad_execution:
+    image: ghcr.io/streamingfast/monad-execution:cb8a4ce
+  monad_node:
+    image: ghcr.io/streamingfast/monad-node:d090722
+  monad_rpc:
+    image: ghcr.io/streamingfast/monad-rpc:d090722

scripts/monad-devnet/compose.yaml

@@ -0,0 +1,114 @@
+services:
+  build_triedb:
+    image: monad-execution-builder:latest
+    command: monad-mpt --storage /monad/triedb/test.db --create
+    volumes:
+      - /dev/hugepages/monad-localnet:/monad/event-ring
+      - ./node:/monad
+    security_opt:
+      - "seccomp:./node/config/profile.json"
+
+  build_genesis:
+    image: monad-execution-builder:latest
+    depends_on:
+      build_triedb:
+        condition: service_completed_successfully
+    volumes:
+      - /dev/hugepages/monad-localnet:/monad/event-ring
+      - ./node:/monad
+    security_opt:
+      - "seccomp:./node/config/profile.json"
+    command:
+      monad
+      --chain monad_devnet
+      --db /monad/triedb/test.db
+      --block_db /monad/ledger
+      --nblocks 0
+      --log_level ERROR
+    ulimits:
+      memlock:
+        soft: "16770785280"
+        hard: "16770785280"
+
+  monad_execution:
+    image: monad-execution-builder:latest
+    depends_on:
+      build_triedb:
+        condition: service_completed_successfully
+      build_genesis:
+        condition: service_completed_successfully
+    volumes:
+      - /dev/hugepages/monad-localnet:/monad/event-ring
+      - ./node:/monad
+    security_opt:
+      - "seccomp:./node/config/profile.json"
+    command: |
+      monad
+      --chain monad_devnet
+      --db /monad/triedb/test.db
+      --block_db /monad/ledger
+      --statesync /monad/statesync.sock
+      --exec-event-ring /monad/event-ring/monad-events
+      --trace-calls
+      --log_level ERROR
+    ulimits:
+      memlock:
+        soft: "16770785280"
+        hard: "16770785280"
+
+  monad_node:
+    image: monad-node:latest
+    depends_on:
+      - build_triedb
+      - monad_execution
+    environment:
+      - RUST_LOG=
+    volumes:
+      - /dev/hugepages/monad-localnet:/monad/event-ring
+      - ./node:/monad
+    security_opt:
+      - "seccomp:./node/config/profile.json"
+    command: |
+      monad-node
+      --secp-identity /monad/config/id-secp
+      --bls-identity /monad/config/id-bls
+      --node-config /monad/config/node.toml
+      --forkpoint-config /monad/config/forkpoint.genesis.toml
+      --validators-path /monad/config/validators.toml
+      --statesync-ipc-path /monad/statesync.sock
+      --wal-path /monad/wal
+      --mempool-ipc-path /monad/mempool.sock
+      --control-panel-ipc-path /monad/controlpanel.sock
+      --ledger-path /monad/ledger
+      --triedb-path /monad/triedb
+      --persisted-peers-path /monad/peers
+    ulimits:
+      memlock:
+        soft: "16770785280"
+        hard: "16770785280"
+
+  monad_rpc:
+    image: monad-rpc:latest
+    depends_on:
+      - build_triedb
+      - monad_node
+    volumes:
+      - /dev/hugepages/monad-localnet:/monad/event-ring
+      - ./node:/monad
+    security_opt:
+      - "seccomp:./node/config/profile.json"
+    ports:
+      - "18080:8080"
+    command: |
+      monad-rpc
+      --ipc-path /monad/mempool.sock
+      --triedb-path /monad/triedb
+      --node-config /monad/config/node.toml
+    ulimits:
+      memlock:
+        soft: "16770785280"
+        hard: "16770785280"
+
+networks:
+  default:
+    driver: bridge

scripts/monad-devnet/docker-compose.localnet-firehose.yml

@@ -0,0 +1,108 @@
+version: "3.9"
+
+services:
+  localnet-firehose:
+    image: ghcr.io/streamingfast/evm-firehose-tracer-rs/monad:d05cc89
+    container_name: monad-localnet-extended-firehose
+    environment:
+      - MONAD_TRACER_LOG=1
+    entrypoint: ["/app/fireeth"]
+    command:
+      - start
+      - reader-node
+      - --config-file=
+      - --log-to-file=false
+      - --data-dir=/data/firehose
+      - --common-first-streamable-block=76
+      - --common-one-block-store-url=file:///data/firehose/storage/one-blocks
+      - --reader-node-path=/app/monad-firehose-tracer
+      - --reader-node-data-dir=/data/firehose/reader
+      - --reader-node-working-dir=/data/firehose/work
+      - --reader-node-grpc-listen-addr=:9000
+      - --reader-node-manager-api-addr=:8081
+      - --reader-node-blocks-chan-capacity=1000
+      - --reader-node-arguments=--debug --chain-id=20143 --network-name=monad-localnet --monad-event-ring-path=/dev/hugepages/monad-localnet/monad-events --buffer-size=524288
+      - --metrics-listen-addr=:9102
+    volumes:
+      - ../../localnet-firehose-data:/data/firehose
+      - /dev/hugepages/monad-localnet:/dev/hugepages/monad-localnet:ro
+    ports:
+      - "10000:9000"
+      - "10102:9102"
+    restart: unless-stopped
+
+  localnet-firehose-api:
+    image: ghcr.io/streamingfast/evm-firehose-tracer-rs/monad:d05cc89
+    container_name: monad-localnet-extended-firehose-api
+    entrypoint: ["/app/fireeth"]
+    command:
+      - start
+      - firehose
+      - --config-file=
+      - --log-to-file=false
+      - --data-dir=/data/firehose
+      - --common-first-streamable-block=76
+      - --advertise-chain-name=monad-localnet
+      - --ignore-advertise-validation
+      - --common-one-block-store-url=file:///data/firehose/storage/one-blocks
+      - --common-live-blocks-addr=localnet-firehose:9000
+      - --firehose-grpc-listen-addr=:20028
+      - --metrics-listen-addr=:9103
+    volumes:
+      - ../../localnet-firehose-data:/data/firehose
+    ports:
+      - "20028:20028"
+      - "10103:9103"
+    depends_on:
+      - localnet-firehose
+    restart: unless-stopped
+
+  localnet-substreams-tier2:
+    image: ghcr.io/streamingfast/evm-firehose-tracer-rs/monad:d05cc89
+    container_name: monad-localnet-substreams-tier2
+    entrypoint: ["/app/fireeth"]
+    command:
+      - start
+      - substreams-tier2
+      - --config-file=
+      - --log-to-file=false
+      - --data-dir=/data/substreams
+      - --common-first-streamable-block=76
+      - --common-one-block-store-url=file:///data/firehose/storage/one-blocks
+      - --common-merged-blocks-store-url=file:///data/firehose/storage/merged-blocks
+      - --common-live-blocks-addr=
+      - --substreams-tier2-grpc-listen-addr=:10017
+    volumes:
+      - ../../localnet-firehose-data:/data/firehose
+      - ../../localnet-substreams-data:/data/substreams
+    ports:
+      - "10017:10017"
+    restart: unless-stopped
+
+  localnet-substreams-tier1:
+    image: ghcr.io/streamingfast/evm-firehose-tracer-rs/monad:d05cc89
+    container_name: monad-localnet-substreams-tier1
+    entrypoint: ["/app/fireeth"]
+    command:
+      - start
+      - substreams-tier1
+      - --config-file=
+      - --log-to-file=false
+      - --data-dir=/data/substreams
+      - --common-first-streamable-block=76
+      - --common-one-block-store-url=file:///data/firehose/storage/one-blocks
+      - --common-merged-blocks-store-url=file:///data/firehose/storage/merged-blocks
+      - --common-live-blocks-addr=
+      - --ignore-advertise-validation
+      - --substreams-tier1-grpc-listen-addr=:10016
+      - --substreams-tier1-subrequests-endpoint=localnet-substreams-tier2:10017
+      - --substreams-tier1-subrequests-plaintext
+      - --substreams-tier1-block-type=sf.ethereum.type.v2.Block
+    volumes:
+      - ../../localnet-firehose-data:/data/firehose
+      - ../../localnet-substreams-data:/data/substreams
+    ports:
+      - "10016:10016"
+    depends_on:
+      - localnet-substreams-tier2
+    restart: unless-stopped

scripts/monad-devnet/node/.gitignore

@@ -0,0 +1,14 @@
+ledger/
+triedb/
+event-ring/
+
+config/*.rlp
+config/*.rlp.*
+config/forkpoint.toml.*
+config/forkpoint.genesis.toml
+config/forkpoint.genesis.toml.*
+config/validators.toml.*
+
+*.sock
+
+wal_*

scripts/monad-devnet/node/config/forkpoint.toml

@@ -0,0 +1,13 @@
+root = "0x0000000000000000000000000000000000000000000000000000000000000000"
+
+[high_certificate.Qc]
+signatures = "0xf865c28080b860c00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000"
+
+[high_certificate.Qc.info]
+id = "0x0000000000000000000000000000000000000000000000000000000000000000"
+round = 0
+epoch = 1
+
+[[validator_sets]]
+epoch = 1
+round = 0