From 337e21454cc7ad1700602612446bfe5d67699880 Mon Sep 17 00:00:00 2001
From: Lincon Vidal <lincon.vidal@cardanofoundation.org>
Date: Mon, 24 Feb 2025 16:48:32 -0300
Subject: [PATCH] Update node-installation-process.md

- Add a new step for installing BLST, as described in [this guide](https://developers.cardano.org/docs/get-started/cardano-node/installing-cardano-node/#installing-blst).
- Bump the Cabal version to match other sources.
---
 .../node-installation-process.md              | 39 +++++++++++++++++--
 1 file changed, 36 insertions(+), 3 deletions(-)

diff --git a/docs/operate-a-stake-pool/node-installation-process.md b/docs/operate-a-stake-pool/node-installation-process.md
index 1b25d402f9..b6ddc1da7d 100644
--- a/docs/operate-a-stake-pool/node-installation-process.md
+++ b/docs/operate-a-stake-pool/node-installation-process.md
@@ -86,7 +86,7 @@ ghcup install ghc 8.10.7
 ghcup set ghc 8.10.7
 ```
 
-`ghcup` will install the latest stable version of `cabal`. However, as of the time of writing this, [Input-Output](https://iohk.io) recommends using `cabal 3.6.2.0`. So, we will use `ghcup` to install and switch to the required version.
+`ghcup` will install the latest stable version of `cabal`. However, as of the time of writing this, [Input-Output](https://iohk.io) recommends using `cabal 3.8.1.0`. So, we will use `ghcup` to install and switch to the required version.
 
 ```bash
 ghcup install cabal 3.8.1.0
@@ -114,8 +114,8 @@ cabal --version
 You should see something like this:
 
 ```
-cabal-install version 3.6.2.0
-compiled using version 3.6.2.0 of the Cabal library
+cabal-install version 3.8.1.0
+compiled using version 3.8.1.0 of the Cabal library
 ```
 
 :::important
@@ -190,6 +190,39 @@ git checkout $(curl -s https://api.github.com/repos/IntersectMBO/cardano-node/re
 If upgrading an existing node, please ensure that you have read the [release notes on GitHub](https://github.com/IntersectMBO/cardano-node/releases) for any changes.
 :::
 
+## Installing `blst`
+
+Find out the correct `blst` version:
+```bash
+BLST_VERSION=$(curl https://raw.githubusercontent.com/input-output-hk/iohk-nix/master/flake.lock | jq -r '.nodes.blst.original.ref')
+echo "Using blst version: ${BLST_VERSION}"
+```
+
+Download and install `blst` so that `cardano-base` can pick it up (assuming that `pkg-config` is installed):
+```bash
+: ${BLST_VERSION:='v0.3.11'}
+git clone --depth 1 --branch ${BLST_VERSION} https://github.com/supranational/blst
+cd blst
+./build.sh
+cat > libblst.pc << EOF
+prefix=/usr/local
+exec_prefix=\${prefix}
+libdir=\${exec_prefix}/lib
+includedir=\${prefix}/include
+
+Name: libblst
+Description: Multilingual BLS12-381 signature library
+URL: https://github.com/supranational/blst
+Version: ${BLST_VERSION#v}
+Cflags: -I\${includedir}
+Libs: -L\${libdir} -lblst
+EOF
+sudo cp libblst.pc /usr/local/lib/pkgconfig/
+sudo cp bindings/blst_aux.h bindings/blst.h bindings/blst.hpp  /usr/local/include/
+sudo cp libblst.a /usr/local/lib
+sudo chmod u=rw,go=r /usr/local/{lib/{libblst.a,pkgconfig/libblst.pc},include/{blst.{h,hpp},blst_aux.h}}
+```
+
 ## Configuring the build options
 
 We explicitly use the `ghc` version that we installed earlier. This avoids defaulting to a system version of `ghc` that might be newer or older than the one you have installed.