doc: automate and document release process

Author: jamaljsr

Makefile

@@ -76,6 +76,10 @@ wasm:
 	cd cmd/wasm-client; CGO_ENABLED=0 GOOS=js GOARCH=wasm go build -trimpath -ldflags="$(LDFLAGS)" -tags="$(RPC_TAGS)" -v -o wasm-client.wasm .
 	$(CP) cmd/wasm-client/wasm-client.wasm example/wasm-client.wasm
 
+clean:
+	@$(call print, "Cleaning up.")
+	$(RM) -r $(MOBILE_BUILD_DIR)
+
 apple:
 	@$(call print, "Building iOS and macOS cxframework ($(IOS_BUILD)).")
 	mkdir -p $(IOS_BUILD_DIR)
@@ -120,6 +124,9 @@ repro-wasm:
 	#Remove the repro-wasm-image
 	docker image rm repro-wasm-image
 
+release: clean mobile repro-wasm
+	./scripts/release.sh $(version)
+
 # =======
 # TESTING
 # =======

RELEASE.md

@@ -0,0 +1,71 @@
+# LNC Release Process
+
+This document describes the steps needed to release a new version of LNC binaries.
+
+### System Requirements
+
+1. Android Studio with Android SDK (API level 16 or newer)
+2. Xcode (latest version)
+3. Go v1.19.8 or newer
+
+### Build Release Binaries
+
+From the root of the project, run the following command. Replace `X.Y.Z`
+with the next version number (ex: 0.2.0)
+
+```sh
+$ make release version=X.Y.Z
+```
+
+When this completes, a `build` dir will be created with four files:
+
+- **lnc-vX.Y.Z-alpha.wasm**: the WASM reproducible binary
+- **lnc-vX.Y.Z-alpha-android.zip**: the gomobile library for android
+- **lnc-vX.Y.Z-alpha-ios.zip**: the gomobile library for iOS
+- **manifest-vX.Y.Z-alpha.txt**: the sha256 hash manifest file
+
+### Sign the manifest and rename the signature file
+
+#### Sign the manifest file using your PGP key.
+
+- Replace `{PGP_EMAIL}` with your email address associated with your PGP key
+
+```sh
+$ gpg --default-key {PGP_EMAIL} --detach-sign manifest-vX.Y.Z-alpha.txt
+```
+
+#### Rename the manifest file.
+
+- Replace `{GITHUB_USERNAME}` with your github username
+
+```sh
+$ mv manifest-vX.Y.Z-alpha.txt.sig manifest-{GITHUB_USERNAME}-vX.Y.Z-alpha.sig
+```
+
+### Create a tag and push to Github
+
+```sh
+$ git tag -s vX.Y.Z-alpha -m "lightning-node-connect vX.Y.Z-alpha"
+$ git push origin vX.Y.Z-alpha
+```
+
+### Create Github Release
+
+On Github create a new release. Select the tag you just pushed, then click the
+"Auto-generate release notes" button.
+
+Take the rest of the content from a previous release. Be sure to update the
+version number and update the verification examples to use your own PGP key.
+
+In the assets, include these five files:
+
+- lnc-vX.Y.Z-alpha.wasm
+- lnc-vX.Y.Z-alpha-android.zip
+- lnc-vX.Y.Z-alpha-ios.zip
+- manifest-vX.Y.Z-alpha.txt
+- manifest-{GITHUB_USERNAME}-vX.Y.Z-alpha.sig
+
+### Deploy the WASM binary to CDN
+
+The `lnc-vX.Y.Z-alpha.wasm` should be deployed to our CDN so it is available
+at the url `https://lightning.engineering/lnc-vX.Y.Z-alpha.wasm`.

scripts/release.sh

@@ -0,0 +1,31 @@
+# /bin/bash
+
+set -e
+
+VERSION=${1}
+
+if [ -z "${VERSION}" ]; then
+    echo "usage: $0 <version>"
+    exit 1
+fi
+
+rm -rf build/
+mkdir build/
+cd build/
+
+# Copy the WASM binary
+cp ../reproducible-builds/wasm-client.wasm lnc-v${VERSION}-alpha.wasm
+
+# Zip up the iOS and Android binaries
+pushd ~/gocode/src/github.com/lightninglabs/lightning-node-connect/build/
+zip -r -X lnc-v${VERSION}-alpha-ios.zip ios/
+zip -r -X lnc-v${VERSION}-alpha-android.zip android/
+popd
+
+# Copy the iOS and Android binaries
+cp ${GOPATH}/src/github.com/lightninglabs/lightning-node-connect/build/*.zip .
+
+# Create manifest file
+shasum -a 256 * >> "manifest-v${VERSION}-alpha.txt"
+
+cd ..