Karthik/5591/protos for ttp (stellar#5596)

* Ignore generated checksums file

* Commit protos, generated code, helper code, and Makefile target

* go mod tidy

* Change address proto to be an enum + strkey representation of address

* Update location of proto files from protos/ to protos/ingest to be consistent with where the generated code should appear

This also helps simply the Makefile target
Right now, yes, the protos that we need to work on need to be put in the
/ingest path.
Tomorrow, we may need to have generated go files in some other path for some other source code.
At that time, redoing protos might be hard.

* Add README.md

* remove address helper

* Add unit tests for ser-deser of Asset proto

* newline

* Test cases for token transfer event

* Rework test fixture

* variable names

Author: karthikiyer56

.gitignore

@@ -21,3 +21,4 @@ debug
 *.db
 *.conf
 *.lock
+.proto_checksums

Makefile

@@ -73,3 +73,48 @@ xdr-clean:
 	rm $(DOWNLOADABLE_XDRS) || true
 
 xdr-update: xdr-clean xdr
+
+
+##############
+PROTO_DIR := protos
+GEN_SUFFIX := .pb.go
+PROTO_FILES := $(shell find $(PROTO_DIR) -name "*.proto")
+PROTO_CHECKSUM := .proto_checksums
+
+generate-proto:
+	@echo "Regenerating proto files..."
+	@touch $(PROTO_CHECKSUM)
+	@current_checksum=$$(sha256sum $(PROTO_FILES) | sha256sum | awk '{print $$1}'); \
+	stored_checksum=$$(cat $(PROTO_CHECKSUM)); \
+	if [ "$${current_checksum}" != "$${stored_checksum}" ]; then \
+    	echo "Changes detected. Regenerating all proto files..."; \
+    	MAP_OPTS=$$(for file in $(PROTO_FILES); do \
+    		rel_path=$$(echo $$file | sed 's|$(PROTO_DIR)/||'); \
+    		pkg_path=$$(dirname $$rel_path); \
+    		go_pkg="github.com/stellar/go/$$pkg_path"; \
+    		printf "M%s=%s," "$$rel_path" "$$go_pkg"; \
+    	done); \
+    	MAP_OPTS=$${MAP_OPTS%,}; \
+    	echo "Running protoc with options:"; \
+    	echo "  --go_out=."; \
+    	echo "  --go_opt=paths=source_relative"; \
+    	echo "  --go_opt=$$MAP_OPTS"; \
+    	echo "Proto Files:  $(PROTO_FILES)"; \
+    	protoc -I=$(PROTO_DIR) \
+    	       --go_out=. --go_opt=paths=source_relative \
+    	       --go_opt=$$MAP_OPTS \
+    	       $(PROTO_FILES); \
+    	echo "$${current_checksum}" > $(PROTO_CHECKSUM); \
+    else \
+    	echo "No changes detected in proto files."; \
+    fi
+
+
+regenerate-proto: $(PROTO_CHECKSUM)
+	rm -f $(PROTO_CHECKSUM)
+	$(MAKE) generate-proto
+
+$(PROTO_CHECKSUM):
+	@touch $(PROTO_CHECKSUM)
+
+.PHONY: generate-proto regenerate-proto

README.md

@@ -45,6 +45,7 @@ In addition to the other top-level packages, there are a few special directories
 * **support/scripts** contains single-file go programs and bash scripts used to support the development of this repo. 
 * **services** contains packages that compile to applications that are long-running processes (such as API servers).
 * **tools** contains packages that compile to command line applications.
+* **protos** contains the protobuf definitions for data-models that we want to generate for use with external stakeholders. Refer to [protos/README.md](./protos/README.md) for more information about code structure in `protos` directory
 
 Each of these directories have their own README file that explain further the nature of their contents.
 

go.mod

@@ -178,7 +178,7 @@ require (
 	google.golang.org/appengine v1.6.8 // indirect
 	google.golang.org/genproto v0.0.0-20240528184218-531527333157 // indirect
 	google.golang.org/grpc v1.64.1 // indirect
-	google.golang.org/protobuf v1.34.2 // indirect
+	google.golang.org/protobuf v1.34.2
 	gopkg.in/tomb.v1 v1.0.0-20141024135613-dd632973f1e7 // indirect
 	gopkg.in/yaml.v3 v3.0.1 // indirect
 )

ingest/address/address.pb.go

@@ -0,0 +1,18 @@
+package asset
+
+// NewNativeAsset creates an Asset representing the native token (XLM).
+func NewNativeAsset() *Asset {
+	return &Asset{AssetType: &Asset_Native{Native: true}}
+}
+
+// NewIssuedAsset creates an Asset with an asset code and issuer.
+func NewIssuedAsset(assetCode, issuer string) *Asset {
+	return &Asset{
+		AssetType: &Asset_IssuedAsset{
+			IssuedAsset: &IssuedAsset{
+				AssetCode: assetCode,
+				Issuer:    issuer,
+			},
+		},
+	}
+}