Merge pull request #172 from Sunny6889/feat/replay-tool

feat(tools): add replay — mainnet tx replay HTTP client

Author: kuny0707

.goreleaser.yaml

@@ -24,8 +24,24 @@ builds:
       - -X github.com/tronprotocol/tron-deployment/cmd.commit={{.Commit}}
       - -X github.com/tronprotocol/tron-deployment/cmd.buildTime={{.Date}}
 
+  - id: replay
+    main: ./tools/replay
+    binary: replay
+    env:
+      - CGO_ENABLED=0
+    goos:
+      - linux
+      - darwin
+    goarch:
+      - amd64
+      - arm64
+    ldflags:
+      - -s -w
+
 archives:
   - id: default
+    builds:
+      - trond
     formats:
       - tar.gz
     name_template: "{{ .ProjectName }}_{{ .Version }}_{{ .Os }}_{{ .Arch }}"
@@ -35,6 +51,17 @@ archives:
       - examples/*
       - schemas/*
 
+  - id: replay
+    builds:
+      - replay
+    formats:
+      - tar.gz
+    name_template: "replay_{{ .Version }}_{{ .Os }}_{{ .Arch }}"
+    files:
+      - LICENSE*
+      - src: tools/replay/README.md
+        dst: README.md
+
 checksum:
   name_template: "checksums.txt"
   algorithm: sha256
@@ -123,6 +150,12 @@ nfpms:
 # path is still the cleaner UX for CLI tools.
 brews:
   - name: trond
+    # Scope to the trond archive only — the homebrew tap installs the
+    # main CLI, not the sibling replay tool. Without ids, goreleaser
+    # tries to package both archives under the same OS/Arch slot and
+    # errors with "one tap can handle only one archive".
+    ids:
+      - default
     repository:
       owner: tronprotocol
       name: homebrew-tap

Makefile

@@ -41,7 +41,7 @@ endif
 
 GOFLAGS    ?=
 
-.PHONY: build test lint e2e build-all clean clean-all fmt vet tidy sync-templates sync-schemas snapshot-schema-baseline update-render-golden refresh-builder-pins docs man cover vuln bootstrap-go
+.PHONY: build test lint e2e build-all clean clean-all fmt vet tidy sync-templates sync-schemas snapshot-schema-baseline update-render-golden docs man cover vuln bootstrap-go build-replay install-replay
 
 ## bootstrap-go: Download + verify the project-local Go toolchain
 ##               (idempotent; safe to re-run; no-op if already current)
@@ -164,9 +164,17 @@ update-render-golden: $(GO_BOOTSTRAP)
 	TROND_UPDATE_GOLDEN=1 $(GO) test -run TestRenderHOCON_Golden ./internal/render/
 	@echo "render golden files refreshed under internal/render/testdata/golden/."
 
-## refresh-builder-pins: Re-resolve Eclipse Temurin tags → sha256 digests
-##                       and rewrite internal/build/pins/builder_image_digests.json.
-##                       Run at trond release-prep so the binary ships current
-##                       digests. Requires docker + jq on PATH. spec/002 FR-012.
-refresh-builder-pins:
-	@./scripts/refresh-builder-pins.sh
+## build-replay: Build the tools/replay binary into bin/replay.
+##               replay is a standalone Go binary (no java-tron source
+##               dependency) that streams mainnet historical transactions
+##               from TronGrid to a private chain over HTTP. See
+##               tools/replay/README.md and tools/replay/IMPROVEMENTS.md.
+build-replay: $(GO_BOOTSTRAP)
+	@mkdir -p bin
+	$(GO) build -ldflags "$(LDFLAGS)" -o bin/replay ./tools/replay
+	@echo "✓ bin/replay built"
+
+## install-replay: Build + copy bin/replay into $(GOBIN).
+install-replay: build-replay
+	cp bin/replay $(GOBIN)/replay
+	@echo "✓ replay installed at $(GOBIN)/replay"

README.md

@@ -574,6 +574,26 @@ remain at the repo root. `make sync-templates` re-fetches them from
 upstream into both the root and the CLI's embedded copy so the two stay
 in lockstep.
 
+## Companion Tools
+
+In addition to the `trond` CLI, this repo ships sibling Go tools under
+`tools/` for adjacent test/operations workflows. They build into separate
+binaries and have separate release tarballs.
+
+| Tool | Path | Purpose                                                                                                                                                                                                        |
+|---|---|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| **`replay`** | [`tools/replay/`](tools/replay/README.md) | Streams mainnet historical transactions from TronGrid HTTP API to a private chain. Pure-Go external HTTP client (no java-tron source dependency). Used for testing setup, stress harness, snapshot validation. |
+
+Build:
+
+```bash
+make build-replay        # → bin/replay
+make install-replay      # → $(GOBIN)/replay
+```
+
+Each tool ships as its own tarball (`replay_<version>_<os>_<arch>.tar.gz`)
+in releases, alongside the main `trond` tarball.
+
 ## Configuration Templates
 
 Base java-tron configuration templates rendered into per-node HOCON. The