feat(exit-certificate-claimer): expose build/version info

Add a --version flag (via cli.VersionPrinter) and include the aggkit
build traceability (version, git rev/branch, build date, Go version,
OS/arch) in the GET /health response through the new HealthResponse /
VersionInfo types. Build the binary with ldflags in the Makefile so the
values are populated. Docs updated in README and SPEC.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Author: joanestebanr

Makefile

@@ -107,7 +107,7 @@ $(GOBIN)/exit_certificate:
 
 .PHONY: $(GOBIN)/exit_certificate_claimer
 $(GOBIN)/exit_certificate_claimer:
-	$(GOENVVARS) go build -o $(GOBIN)/exit_certificate_claimer ./tools/exit_certificate_claimer/service/cmd
+	$(GOENVVARS) go build -ldflags "all=$(LDFLAGS)" -o $(GOBIN)/exit_certificate_claimer ./tools/exit_certificate_claimer/service/cmd
 
 .PHONY: build-docker
 build-docker: ## Builds a docker image with the aggkit binary

tools/exit_certificate_claimer/README.md

@@ -111,10 +111,17 @@ CGO_ENABLED=1 go build -o exit-certificate-claimer ./tools/exit_certificate_clai
 
 # override the bind host/port from the command line (works in both modes):
 ./exit-certificate-claimer --config config.toml --address 127.0.0.1 --port 9090
+
+# print the full build/version info and exit (same fields as GET /health):
+./exit-certificate-claimer --version
 ```
 
 `CGO_ENABLED=1` is required (SQLite via `mattn/go-sqlite3`).
 
+`--version` (alias `-v`) prints the build traceability info — version, git revision/branch, build
+date, Go version and OS/arch — the same data served by `GET /claimer/v1/health`. The values are
+injected at build time via ldflags (use the Makefile target so they are populated).
+
 ## Tests
 
 ```bash

tools/exit_certificate_claimer/SPEC.md

@@ -114,14 +114,24 @@ Liveness/readiness probe.
 ```json
 {
   "status": "ok",
-  "network_id": 1
+  "network_id": 1,
+  "version": {
+    "version": "v0.1.0",
+    "git_rev": "abc1234",
+    "git_branch": "feature/exit-certificate-tool",
+    "build_date": "Mon, 30 Jun 2026 10:00:00 +0200",
+    "go_version": "go1.22.0",
+    "os": "linux",
+    "arch": "amd64"
+  }
 }
 ```
 
 | Field | Type | Description |
 | ----- | ---- | ----------- |
 | `status` | string | Always `ok`. The HTTP server only starts after the L1 Info Tree has been synced up to the certificate's settlement GER, so a reachable endpoint is always ready to serve claim requests. |
 | `network_id` | number | The source network ID the claimer is serving. |
+| `version` | object | Build/version info (same fields the exit_certificate tool prints in its startup banner): `version`, `git_rev`, `git_branch`, `build_date`, `go_version`, `os`, `arch`. Populated at build time via ldflags. |
 
 ### `GET /bridges`
 

tools/exit_certificate_claimer/service/cmd/main.go

@@ -10,6 +10,10 @@ import (
 )
 
 func main() {
+	cli.VersionPrinter = func(*cli.Context) {
+		aggkit.PrintVersion(os.Stdout)
+	}
+
 	app := cli.NewApp()
 	app.Name = "exit-certificate-claimer"
 	app.Usage = "Serve claimAsset parameters for the bridge exits of a settled exit certificate"

tools/exit_certificate_claimer/service/server.go

@@ -7,6 +7,7 @@ import (
 	"strconv"
 	"time"
 
+	aggkit "github.com/agglayer/aggkit"
 	"github.com/agglayer/aggkit/log"
 	"github.com/ethereum/go-ethereum/common"
 	"github.com/gin-gonic/gin"
@@ -80,7 +81,20 @@ func (s *Server) Start(ctx context.Context) error {
 }
 
 func (s *Server) handleHealth(c *gin.Context) {
-	c.JSON(http.StatusOK, gin.H{"status": "ok", "network_id": s.claimer.NetworkID()})
+	v := aggkit.GetVersion()
+	c.JSON(http.StatusOK, HealthResponse{
+		Status:    "ok",
+		NetworkID: s.claimer.NetworkID(),
+		Version: VersionInfo{
+			Version:   v.Version,
+			GitRev:    v.GitRev,
+			GitBranch: v.GitBranch,
+			BuildDate: v.BuildDate,
+			GoVersion: v.GoVersion,
+			OS:        v.OS,
+			Arch:      v.Arch,
+		},
+	})
 }
 
 func (s *Server) handleBridges(c *gin.Context) {

tools/exit_certificate_claimer/service/server_test.go

@@ -39,10 +39,14 @@ func TestServerHealth(t *testing.T) {
 	rec := doRequest(t, srv, apiBasePath+"/health")
 	require.Equal(t, http.StatusOK, rec.Code)
 
-	var body map[string]any
+	var body HealthResponse
 	require.NoError(t, json.Unmarshal(rec.Body.Bytes(), &body))
-	require.Equal(t, "ok", body["status"])
-	require.Equal(t, float64(1), body["network_id"])
+	require.Equal(t, "ok", body.Status)
+	require.Equal(t, uint32(1), body.NetworkID)
+	require.NotEmpty(t, body.Version.Version)
+	require.NotEmpty(t, body.Version.GoVersion)
+	require.NotEmpty(t, body.Version.OS)
+	require.NotEmpty(t, body.Version.Arch)
 }
 
 func TestServerBridges(t *testing.T) {

tools/exit_certificate_claimer/service/types.go

@@ -66,6 +66,24 @@ type ClaimParamsResponse struct {
 	Claims             []ClaimAssetParams `json:"claims"`
 }
 
+// VersionInfo mirrors aggkit.FullVersion as a JSON-friendly payload.
+type VersionInfo struct {
+	Version   string `json:"version"`
+	GitRev    string `json:"git_rev"`
+	GitBranch string `json:"git_branch"`
+	BuildDate string `json:"build_date"`
+	GoVersion string `json:"go_version"`
+	OS        string `json:"os"`
+	Arch      string `json:"arch"`
+}
+
+// HealthResponse is the body returned by GET /health.
+type HealthResponse struct {
+	Status    string      `json:"status"`
+	NetworkID uint32      `json:"network_id"`
+	Version   VersionInfo `json:"version"`
+}
+
 // errorResponse is the JSON body returned on error.
 type errorResponse struct {
 	Error string `json:"error"`