fix: update zeam CLI flags for API/metrics server separation

Author: chetanyb

ansible/roles/zeam/tasks/main.yml

@@ -87,6 +87,9 @@
     - name: Start Zeam container
       # TODO: Remove --platform linux/amd64 when blockblaz/zeam:latest multi-platform image is available on Docker Hub
       # Multi-platform support is being added in zeam CI (see .github/workflows/ci.yml docker-build-multiarch job)
+      # Zeam runs two HTTP servers:
+      #   - API server (default 9667): health, SSE events, forkchoice graph, checkpoint state
+      #   - Metrics server (--metrics-port): Prometheus /metrics endpoint
       command: >-
         docker run -d
         --pull=always
@@ -106,7 +109,7 @@
         --node-id {{ node_name }}
         --node-key /config/{{ node_name }}.key
         --metrics_enable
-        --api-port {{ zeam_metrics_port }}
+        --metrics-port {{ zeam_metrics_port }}
       register: zeam_container_result
       changed_when: zeam_container_result.rc == 0
 

client-cmds/zeam-cmd.sh

@@ -3,6 +3,14 @@
 #-----------------------zeam setup----------------------
 # setup where lean-quickstart is a submodule folder in zeam repo
 # update the path to your binary here if you want to use binary
+#
+# Zeam runs two HTTP servers:
+#   - API server (default port 9667): health, SSE events, forkchoice graph, checkpoint state
+#   - Metrics server (--metrics-port): Prometheus /metrics endpoint
+#
+# The metricsPort from validator-config.yaml is used for the metrics server.
+# API server uses the default port 9667 (override with --api-port if needed).
+#
 # Metrics enabled by default
 metrics_flag="--metrics_enable"
 
@@ -24,7 +32,7 @@ node_binary="$scriptDir/../zig-out/bin/zeam node \
       --data-dir $dataDir/$item \
       --node-id $item --node-key $configDir/$item.key \
       $metrics_flag \
-      --api-port $metricsPort \
+      --metrics-port $metricsPort \
       $aggregator_flag \
       $checkpoint_sync_flag"
 
@@ -34,7 +42,7 @@ node_docker="--security-opt seccomp=unconfined blockblaz/zeam:devnet2 node \
       --data-dir /data \
       --node-id $item --node-key /config/$item.key \
       $metrics_flag \
-      --api-port $metricsPort \
+      --metrics-port $metricsPort \
       $aggregator_flag \
       $checkpoint_sync_flag"