PACKAGES=$(shell go list ./...) BUILDDIR?=$(CURDIR)/build OUTPUT?=$(BUILDDIR)/tendermint BUILD_TAGS?=tendermint # If building a release, please checkout the version tag to get the correct version setting ifneq ($(shell git symbolic-ref -q --short HEAD),) VERSION := unreleased-$(shell git symbolic-ref -q --short HEAD)-$(shell git rev-parse HEAD) else VERSION := $(shell git describe) endif LD_FLAGS = -X github.com/tendermint/tendermint/version.TMCoreSemVer=$(VERSION) BUILD_FLAGS = -mod=readonly -ldflags "$(LD_FLAGS)" HTTPS_GIT := https://github.com/tendermint/tendermint.git CGO_ENABLED ?= 0 # handle nostrip ifeq (,$(findstring nostrip,$(TENDERMINT_BUILD_OPTIONS))) BUILD_FLAGS += -trimpath LD_FLAGS += -s -w endif # handle race ifeq (race,$(findstring race,$(TENDERMINT_BUILD_OPTIONS))) CGO_ENABLED=1 BUILD_FLAGS += -race endif # handle cleveldb ifeq (cleveldb,$(findstring cleveldb,$(TENDERMINT_BUILD_OPTIONS))) CGO_ENABLED=1 BUILD_TAGS += cleveldb endif # handle badgerdb ifeq (badgerdb,$(findstring badgerdb,$(TENDERMINT_BUILD_OPTIONS))) BUILD_TAGS += badgerdb endif # handle rocksdb ifeq (rocksdb,$(findstring rocksdb,$(TENDERMINT_BUILD_OPTIONS))) CGO_ENABLED=1 BUILD_TAGS += rocksdb endif # handle boltdb ifeq (boltdb,$(findstring boltdb,$(TENDERMINT_BUILD_OPTIONS))) BUILD_TAGS += boltdb endif # allow users to pass additional flags via the conventional LDFLAGS variable LD_FLAGS += $(LDFLAGS) # Process Docker environment varible TARGETPLATFORM # in order to build binary with correspondent ARCH # by default will always build for linux/amd64 TARGETPLATFORM ?= GOOS ?= linux GOARCH ?= amd64 GOARM ?= ifeq (linux/arm,$(findstring linux/arm,$(TARGETPLATFORM))) GOOS=linux GOARCH=arm GOARM=7 endif ifeq (linux/arm/v6,$(findstring linux/arm/v6,$(TARGETPLATFORM))) GOOS=linux GOARCH=arm GOARM=6 endif ifeq (linux/arm64,$(findstring linux/arm64,$(TARGETPLATFORM))) GOOS=linux GOARCH=arm64 GOARM=7 endif ifeq (linux/386,$(findstring linux/386,$(TARGETPLATFORM))) GOOS=linux GOARCH=386 endif ifeq (linux/amd64,$(findstring linux/amd64,$(TARGETPLATFORM))) GOOS=linux GOARCH=amd64 endif ifeq (linux/mips,$(findstring linux/mips,$(TARGETPLATFORM))) GOOS=linux GOARCH=mips endif ifeq (linux/mipsle,$(findstring linux/mipsle,$(TARGETPLATFORM))) GOOS=linux GOARCH=mipsle endif ifeq (linux/mips64,$(findstring linux/mips64,$(TARGETPLATFORM))) GOOS=linux GOARCH=mips64 endif ifeq (linux/mips64le,$(findstring linux/mips64le,$(TARGETPLATFORM))) GOOS=linux GOARCH=mips64le endif ifeq (linux/riscv64,$(findstring linux/riscv64,$(TARGETPLATFORM))) GOOS=linux GOARCH=riscv64 endif all: check build test install .PHONY: all include tests.mk ############################################################################### ### Build Tendermint ### ############################################################################### build: CGO_ENABLED=$(CGO_ENABLED) go build $(BUILD_FLAGS) -tags '$(BUILD_TAGS)' -o $(OUTPUT) ./cmd/tendermint/ .PHONY: build install: CGO_ENABLED=$(CGO_ENABLED) go install $(BUILD_FLAGS) -tags $(BUILD_TAGS) ./cmd/tendermint .PHONY: install ############################################################################### ### Metrics ### ############################################################################### metrics: testdata-metrics go generate -run="scripts/metricsgen" ./... .PHONY: metrics # By convention, the go tool ignores subdirectories of directories named # 'testdata'. This command invokes the generate command on the folder directly # to avoid this. testdata-metrics: ls ./scripts/metricsgen/testdata | xargs -I{} go generate -v -run="scripts/metricsgen" ./scripts/metricsgen/testdata/{} .PHONY: testdata-metrics ############################################################################### ### Mocks ### ############################################################################### mockery: go generate -run="./scripts/mockery_generate.sh" ./... .PHONY: mockery ############################################################################### ### Protobuf ### ############################################################################### check-proto-deps: ifeq (,$(shell which protoc-gen-gogofaster)) @go install github.com/gogo/protobuf/protoc-gen-gogofaster@latest endif .PHONY: check-proto-deps check-proto-format-deps: ifeq (,$(shell which clang-format)) $(error "clang-format is required for Protobuf formatting. See instructions for your platform on how to install it.") endif .PHONY: check-proto-format-deps proto-gen: check-proto-deps @echo "Generating Protobuf files" @go run github.com/bufbuild/buf/cmd/buf generate @mv ./proto/tendermint/abci/types.pb.go ./abci/types/ .PHONY: proto-gen # These targets are provided for convenience and are intended for local # execution only. proto-lint: check-proto-deps @echo "Linting Protobuf files" @go run github.com/bufbuild/buf/cmd/buf lint .PHONY: proto-lint proto-format: check-proto-format-deps @echo "Formatting Protobuf files" @find . -name '*.proto' -path "./proto/*" -exec clang-format -i {} \; .PHONY: proto-format proto-check-breaking: check-proto-deps @echo "Checking for breaking changes in Protobuf files against local branch" @echo "Note: This is only useful if your changes have not yet been committed." @echo " Otherwise read up on buf's \"breaking\" command usage:" @echo " https://docs.buf.build/breaking/usage" @go run github.com/bufbuild/buf/cmd/buf breaking --against ".git" .PHONY: proto-check-breaking proto-check-breaking-ci: @go run github.com/bufbuild/buf/cmd/buf breaking --against $(HTTPS_GIT)#branch=v0.34.x .PHONY: proto-check-breaking-ci ############################################################################### ### Build ABCI ### ############################################################################### build_abci: @go build -mod=readonly -i ./abci/cmd/... .PHONY: build_abci install_abci: @go install -mod=readonly ./abci/cmd/... .PHONY: install_abci ############################################################################### ### Distribution ### ############################################################################### # dist builds binaries for all platforms and packages them for distribution # TODO add abci to these scripts dist: @BUILD_TAGS=$(BUILD_TAGS) sh -c "'$(CURDIR)/scripts/dist.sh'" .PHONY: dist go-mod-cache: go.sum @echo "--> Download go modules to local cache" @go mod download .PHONY: go-mod-cache go.sum: go.mod @echo "--> Ensure dependencies have not been modified" @go mod verify @go mod tidy draw_deps: @# requires brew install graphviz or apt-get install graphviz go get github.com/RobotsAndPencils/goviz @goviz -i github.com/tendermint/tendermint/cmd/tendermint -d 3 | dot -Tpng -o dependency-graph.png .PHONY: draw_deps get_deps_bin_size: @# Copy of build recipe with additional flags to perform binary size analysis $(eval $(shell go build -work -a $(BUILD_FLAGS) -tags $(BUILD_TAGS) -o $(OUTPUT) ./cmd/tendermint/ 2>&1)) @find $(WORK) -type f -name "*.a" | xargs -I{} du -hxs "{}" | sort -rh | sed -e s:${WORK}/::g > deps_bin_size.log @echo "Results can be found here: $(CURDIR)/deps_bin_size.log" .PHONY: get_deps_bin_size ############################################################################### ### Libs ### ############################################################################### # generates certificates for TLS testing in remotedb and RPC server gen_certs: clean_certs certstrap init --common-name "tendermint.com" --passphrase "" certstrap request-cert --common-name "server" -ip "127.0.0.1" --passphrase "" certstrap sign "server" --CA "tendermint.com" --passphrase "" mv out/server.crt rpc/jsonrpc/server/test.crt mv out/server.key rpc/jsonrpc/server/test.key rm -rf out .PHONY: gen_certs # deletes generated certificates clean_certs: rm -f rpc/jsonrpc/server/test.crt rm -f rpc/jsonrpc/server/test.key .PHONY: clean_certs ############################################################################### ### Formatting, linting, and vetting ### ############################################################################### format: find . -name '*.go' -type f -not -path "*.git*" -not -name '*.pb.go' -not -name '*pb_test.go' | xargs gofmt -w -s find . -name '*.go' -type f -not -path "*.git*" -not -name '*.pb.go' -not -name '*pb_test.go' | xargs goimports -w -local github.com/tendermint/tendermint .PHONY: format lint: @echo "--> Running linter" @golangci-lint run .PHONY: lint DESTINATION = ./index.html.md ############################################################################### ### Documentation ### ############################################################################### DOCS_OUTPUT?=/tmp/tendermint-core-docs # This builds a docs site for each branch/tag in `./docs/versions` and copies # each site to a version prefixed path. The last entry inside the `versions` # file will be the default root index.html. Only redirects that are built into # the "redirects" folder of each of the branches will be copied out to the root # of the build at the end. build-docs: @cd docs && \ while read -r branch path_prefix; do \ (git checkout $${branch} && npm ci && VUEPRESS_BASE="/$${path_prefix}/" npm run build) ; \ mkdir -p $(DOCS_OUTPUT)/$${path_prefix} ; \ cp -r .vuepress/dist/* $(DOCS_OUTPUT)/$${path_prefix}/ ; \ cp $(DOCS_OUTPUT)/$${path_prefix}/index.html $(DOCS_OUTPUT) ; \ cp $(DOCS_OUTPUT)/$${path_prefix}/404.html $(DOCS_OUTPUT) ; \ cp -r $(DOCS_OUTPUT)/$${path_prefix}/redirects/* $(DOCS_OUTPUT) || true ; \ done < versions ; .PHONY: build-docs # Build and serve the local version of the docs on the current branch from # http://0.0.0.0:8080 serve-docs: @cd docs && \ npm ci && \ npm run serve .PHONY: serve-docs sync-docs: cd ~/output && \ echo "role_arn = ${DEPLOYMENT_ROLE_ARN}" >> /root/.aws/config ; \ echo "CI job = ${CIRCLE_BUILD_URL}" >> version.html ; \ aws s3 sync . s3://${WEBSITE_BUCKET} --profile terraform --delete ; \ aws cloudfront create-invalidation --distribution-id ${CF_DISTRIBUTION_ID} --profile terraform --path "/*" ; .PHONY: sync-docs # Verify that important design docs have ToC entries. check-docs-toc: @./docs/presubmit.sh .PHONY: check-docs-toc ############################################################################### ### Docker image ### ############################################################################### build-docker: build-linux cp $(OUTPUT) DOCKER/tendermint docker build --label=tendermint --tag="tendermint/tendermint" DOCKER rm -rf DOCKER/tendermint .PHONY: build-docker ############################################################################### ### Local testnet using docker ### ############################################################################### # Build linux binary on other platforms build-linux: GOOS=$(GOOS) GOARCH=$(GOARCH) GOARM=$(GOARM) $(MAKE) build .PHONY: build-linux build-docker-localnode: @cd networks/local && make .PHONY: build-docker-localnode # Runs `make build TENDERMINT_BUILD_OPTIONS=cleveldb` from within an Amazon # Linux (v2)-based Docker build container in order to build an Amazon # Linux-compatible binary. Produces a compatible binary at ./build/tendermint build_c-amazonlinux: $(MAKE) -C ./DOCKER build_amazonlinux_buildimage docker run --rm -it -v `pwd`:/tendermint tendermint/tendermint:build_c-amazonlinux .PHONY: build_c-amazonlinux # Run a 4-node testnet locally localnet-start: localnet-stop build-docker-localnode @if ! [ -f build/node0/config/genesis.json ]; then docker run --rm -v $(CURDIR)/build:/tendermint:Z tendermint/localnode testnet --config /etc/tendermint/config-template.toml --o . --starting-ip-address 192.167.10.2; fi docker-compose up .PHONY: localnet-start # Stop testnet localnet-stop: docker-compose down .PHONY: localnet-stop # Build hooks for dredd, to skip or add information on some steps build-contract-tests-hooks: ifeq ($(OS),Windows_NT) go build -mod=readonly $(BUILD_FLAGS) -o build/contract_tests.exe ./cmd/contract_tests else go build -mod=readonly $(BUILD_FLAGS) -o build/contract_tests ./cmd/contract_tests endif .PHONY: build-contract-tests-hooks # Run a nodejs tool to test endpoints against a localnet # The command takes care of starting and stopping the network # prerequisits: build-contract-tests-hooks build-linux # the two build commands were not added to let this command run from generic containers or machines. # The binaries should be built beforehand contract-tests: dredd .PHONY: contract-tests # Implements test splitting and running. This is pulled directly from # the github action workflows for better local reproducibility. GO_TEST_FILES != find $(CURDIR) -name "*_test.go" # default to four splits by default NUM_SPLIT ?= 4 $(BUILDDIR): mkdir -p $@ # The format statement filters out all packages that don't have tests. # Note we need to check for both in-package tests (.TestGoFiles) and # out-of-package tests (.XTestGoFiles). $(BUILDDIR)/packages.txt:$(GO_TEST_FILES) $(BUILDDIR) go list -f "{{ if (or .TestGoFiles .XTestGoFiles) }}{{ .ImportPath }}{{ end }}" ./... | sort > $@ split-test-packages:$(BUILDDIR)/packages.txt split -d -n l/$(NUM_SPLIT) $< $<. test-group-%:split-test-packages cat $(BUILDDIR)/packages.txt.$* | xargs go test -mod=readonly -timeout=5m -race -coverprofile=$(BUILDDIR)/$*.profile.out