feat: improve lotus-gateway build for network selection

[rjan90]

Related Issues

Closes #12967 #12767

Proposed Changes

• Add a marker file .calibnet-mode that gets created when running make calibnet
• Make lotus-gateway check for that markerfile
  • If the file exists, it builds with calibnet tags
  • If the file doesn’t exist, it builds for mainnet
• Make sure the marker file gets removed when running make clean

Additional Info

We discussed other approaches as well, but we wanted to keep current state intact and not add lotus-gateway to make calibnet since it is already overloaded, as having to build extra binaries is not ideal. And additionally we wanted to keep consistency, and prefer to build lotus-gateway instead of introducing a special lotus-gateway-calib.

Checklist

Before you mark the PR ready for review, please make sure that:

• Commits have a clear commit message.
• PR title conforms with contribution conventions
• Update CHANGELOG.md or signal that this change does not need it per contribution conventions
• New features have usage guidelines and / or documentation updates in
  • Lotus Documentation
  • Discussion Tutorials
• Tests exist for new functionality or change in behavior
• CI is green

[rjan90]

Testing it:

• Running make calibnet I can see that there is now a marker file:

ls -la | grep .calibnet-mode
-rw-rw-r--  1 filoz filoz         0 Mar 20 07:24 .calibnet-mode

• Running make lotus-gateway now outputs which tags its building lotus-gateway with:

make lotus-gateway
rm -f lotus-gateway
Building lotus-gateway with calibnet tags
go: downloading golang.org/x/time v0.11.0 

• Checking version:

./lotus-gateway -h
NAME:
   lotus-gateway - Public API server for lotus

USAGE:
   lotus-gateway [global options] command [command options]

VERSION:
   1.32.1-dev+calibnet+git.d2be3a825

• Running make clean to see if things get cleaned up properly:

make clean
rm -rf build/.filecoin-install build/.update-modules lotus lotus-miner lotus-worker lotus-shed lotus-gateway lotus-seed lotus-fountain lotus-bench lotus-stats lotus-pcr lotus-health lotus-wallet lotus-keygen testground tvx lotus-sim .calibnet-mode
make -C extern/filecoin-ffi/ clean
make[1]: Entering directory '/mnt/nvmeraid0/lotus/extern/filecoin-ffi'
go clean -cache -testcache
rm -rf filcrypto.h filcrypto.pc libfilcrypto.a .install-filcrypto
rm -f ./runner
cd rust && cargo clean && cd ..
     Removed 0 files
make[1]: Leaving directory '/mnt/nvmeraid0/lotus/extern/filecoin-ffi'
------
ls -la | grep .calibnet-mode

And I can see that there is no .calibnet-mode marker file there anymore.

[BigLep]

Requested review from @rvagg given he was the opener of the issues being fixed.

[rvagg]

I don't love this because of the marker file - which creates persistent and surprising state that's going to cause unintended consequences later (it also needs to be in .gitignore so nobody accidentally commits it). Ideally, the Makefile's state only persists for its execution lifetime and the remaining state comes from source files. Marker files being a last resort if you can't detect some state information about your source.

Anyway, after a few rounds with my mate Claude, we arrived at an alternative approach: #12972 - what do you think about that one instead?

[rjan90]

Closing in favour of #12972