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

Author: chetanyb

ansible/roles/zeam/tasks/main.yml

@@ -89,6 +89,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
@@ -108,7 +111,7 @@
         --node-id {{ node_name }}
         --node-key /config/{{ node_name }}.key
         --metrics_enable
-        --api-port {{ zeam_metrics_port }}
+        --metrics-port {{ zeam_metrics_port }}
         {{ '--is-aggregator' if (zeam_is_aggregator | default('false')) == 'true' else '' }}
         {{ ('--checkpoint-sync-url ' + checkpoint_sync_url) if (checkpoint_sync_url is defined and checkpoint_sync_url | length > 0) else '' }}
       register: zeam_container_result

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"
 
@@ -30,7 +38,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 \
       $attestation_committee_flag \
       $aggregator_flag \
       $checkpoint_sync_flag"
@@ -41,7 +49,7 @@ node_docker="--security-opt seccomp=unconfined blockblaz/zeam:devnet3 node \
       --data-dir /data \
       --node-id $item --node-key /config/$item.key \
       $metrics_flag \
-      --api-port $metricsPort \
+      --metrics-port $metricsPort \
       $attestation_committee_flag \
       $aggregator_flag \
       $checkpoint_sync_flag"