From 5600ad17fe1b3c827017eba3b564361941353d9f Mon Sep 17 00:00:00 2001
From: Paul Razvan Berg <paul.razvan.berg@gmail.com>
Date: Sun, 31 Dec 2023 13:45:20 +0200
Subject: [PATCH 1/2] build: switch to bun for dep management

---
 .github/workflows/ci-deep.yml |  32 ++++++++----------------------
 .github/workflows/ci.yml      |  36 ++++++++++------------------------
 .gitignore                    |   1 +
 .prettierignore               |   1 +
 CONTRIBUTING.md               |   5 ++---
 README.md                     |   6 ++++--
 bun.lockb                     | Bin 0 -> 43293 bytes
 package.json                  |  10 +++++-----
 shell/prepare-artifacts.sh    |   4 ++--
 9 files changed, 33 insertions(+), 62 deletions(-)
 create mode 100755 bun.lockb

diff --git a/.github/workflows/ci-deep.yml b/.github/workflows/ci-deep.yml
index f80fc622..924f546f 100644
--- a/.github/workflows/ci-deep.yml
+++ b/.github/workflows/ci-deep.yml
@@ -23,22 +23,14 @@ jobs:
       - name: "Install Foundry"
         uses: "foundry-rs/foundry-toolchain@v1"
 
-      - name: "Install Pnpm"
-        uses: "pnpm/action-setup@v2"
-        with:
-          version: "8"
-
-      - name: "Install Node.js"
-        uses: "actions/setup-node@v3"
-        with:
-          cache: "pnpm"
-          node-version: "lts/*"
+      - name: "Install Bun"
+        uses: "oven-sh/setup-bun@v1"
 
       - name: "Install the Node.js dependencies"
-        run: "pnpm install"
+        run: "bun install"
 
-      - name: "Lint the contracts"
-        run: "pnpm lint"
+      - name: "Lint the code"
+        run: "bun run lint"
 
       - name: "Add lint summary"
         run: |
@@ -57,19 +49,11 @@ jobs:
       - name: "Install Foundry"
         uses: "foundry-rs/foundry-toolchain@v1"
 
-      - name: "Install Pnpm"
-        uses: "pnpm/action-setup@v2"
-        with:
-          version: "8"
-
-      - name: "Install Node.js"
-        uses: "actions/setup-node@v3"
-        with:
-          cache: "pnpm"
-          node-version: "lts/*"
+      - name: "Install Bun"
+        uses: "oven-sh/setup-bun@v1"
 
       - name: "Install the Node.js dependencies"
-        run: "pnpm install"
+        run: "bun install"
 
       - name: "Produce an optimized build with --via-ir"
         run: "FOUNDRY_PROFILE=optimized forge build"
diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index 96a07403..dc3b23aa 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -24,22 +24,14 @@ jobs:
       - name: "Install Foundry"
         uses: "foundry-rs/foundry-toolchain@v1"
 
-      - name: "Install Pnpm"
-        uses: "pnpm/action-setup@v2"
-        with:
-          version: "8"
-
-      - name: "Install Node.js"
-        uses: "actions/setup-node@v3"
-        with:
-          cache: "pnpm"
-          node-version: "lts/*"
+      - name: "Install Bun"
+        uses: "oven-sh/setup-bun@v1"
 
       - name: "Install the Node.js dependencies"
-        run: "pnpm install"
+        run: "bun install"
 
-      - name: "Lint the contracts"
-        run: "pnpm lint"
+      - name: "Lint the code"
+        run: "bun run lint"
 
       - name: "Add lint summary"
         run: |
@@ -55,19 +47,11 @@ jobs:
         - name: "Install Foundry"
           uses: "foundry-rs/foundry-toolchain@v1"
 
-        - name: "Install Pnpm"
-          uses: "pnpm/action-setup@v2"
-          with:
-            version: "8"
-
-        - name: "Install Node.js"
-          uses: "actions/setup-node@v3"
-          with:
-            cache: "pnpm"
-            node-version: "lts/*"
+        - name: "Install Bun"
+          uses: "oven-sh/setup-bun@v1"
 
         - name: "Install the Node.js dependencies"
-          run: "pnpm install"
+          run: "bun install"
 
         - name: "Show the Foundry config"
           run: "forge config"
@@ -76,7 +60,7 @@ jobs:
           run: "./shell/prepare-artifacts.sh"
 
         - name: "Build the test contracts"
-          run: "FOUNDRY_PROFILE=test-optimized forge build"   
+          run: "FOUNDRY_PROFILE=test-optimized forge build"
 
         - name: "Cache the build and the node modules so that they can be re-used by the other jobs"
           uses: "actions/cache/save@v3"
@@ -195,7 +179,7 @@ jobs:
     runs-on: "ubuntu-latest"
     steps:
       - name: "Check out the repo"
-        uses: "actions/checkout@v3"  
+        uses: "actions/checkout@v3"
 
       - name: "Restore the cached build and the node modules"
         uses: "actions/cache/restore@v3"
diff --git a/.gitignore b/.gitignore
index 30006812..bdad7088 100644
--- a/.gitignore
+++ b/.gitignore
@@ -15,4 +15,5 @@ out
 .pnp.*
 lcov.info
 package-lock.json
+pnpm-lock.yaml
 yarn.lock
diff --git a/.prettierignore b/.prettierignore
index 801408fa..4bd66a9d 100644
--- a/.prettierignore
+++ b/.prettierignore
@@ -16,6 +16,7 @@ test
 *.log
 .DS_Store
 .pnp.*
+bun.lockb
 lcov.info
 package-lock.json
 pnpm-lock.yaml
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 52d437e0..9e5f1fbb 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -14,7 +14,7 @@ You will need the following software on your machine:
 - [Git](https://git-scm.com/downloads)
 - [Foundry](https://github.com/foundry-rs/foundry)
 - [Node.Js](https://nodejs.org/en/download/)
-- [Pnpm](https://pnpm.io/)
+- [Bun](https://bun.sh)
 
 In addition, familiarity with [Solidity](https://soliditylang.org/) is requisite.
 
@@ -29,7 +29,7 @@ $ git clone --recurse-submodules -j8 git@github.com:sablier-labs/v2-periphery.gi
 Then, inside the project's directory, run this to install the Node.js dependencies:
 
 ```shell
-$ pnpm install
+$ bun install
 ```
 
 Now you can start making changes.
@@ -48,7 +48,6 @@ When making a pull request, ensure that:
   - Gas snapshots are provided and demonstrate an improvement (or an acceptable deficit given other improvements).
   - Reference contracts are modified correspondingly if relevant.
   - New tests are included for all new features or code paths.
-- If making a modification to third-party Node.js dependencies, `pnpm audit` passes.
 - A descriptive summary of the PR has been provided.
 
 ## Environment Variables
diff --git a/README.md b/README.md
index 4425b4ce..bda4176d 100644
--- a/README.md
+++ b/README.md
@@ -20,10 +20,10 @@ In-depth documentation is available at [docs.sablier.com](https://docs.sablier.c
 
 This is the recommended approach.
 
-Install Sablier V2 Periphery as a Node.js package:
+Install Sablier V2 Periphery using your favorite package manager, e.g., with Bun:
 
 ```shell
-yarn add @sablier/v2-periphery
+bun add @sablier/v2-periphery
 ```
 
 Then, if you are using Foundry, add these to your `remappings.txt` file:
@@ -36,6 +36,8 @@ Then, if you are using Foundry, add these to your `remappings.txt` file:
 
 ### Git Submodules
 
+This installation method is not recommended, but it is available for those who prefer it.
+
 First, install the submodule using Forge:
 
 ```sh
diff --git a/bun.lockb b/bun.lockb
new file mode 100755
index 0000000000000000000000000000000000000000..47adad30ae5cb275f714732bb2d2d87ed4aac712
GIT binary patch
literal 43293
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

literal 0
HcmV?d00001

diff --git a/package.json b/package.json
index 3adac6a0..b7bad1e6 100644
--- a/package.json
+++ b/package.json
@@ -61,14 +61,14 @@
     "clean": "rm -rf artifacts broadcast cache docs out-optimized out",
     "gas:report": "forge test --gas-report --no-match-test \"test(Fuzz)?_RevertWhen_\\w{1,}?\"",
     "gas:snapshot": "forge snapshot --no-match-test \"test(Fuzz)?_RevertWhen_\\w{1,}?\"",
-    "gas:snapshot:optimized": "pnpm build:optimized && FOUNDRY_PROFILE=test-optimized forge snapshot --no-match-test \"test(Fork)?(Fuzz)?_RevertWhen_\\w{1,}?\"",
-    "lint": "pnpm lint:sol && pnpm prettier:check",
-    "lint:sol": "forge fmt --check && pnpm solhint \"{script,src,test}/**/*.sol\"",
-    "prepack": "pnpm install && bash ./shell/prepare-artifacts.sh",
+    "gas:snapshot:optimized": "bun run build:optimized && FOUNDRY_PROFILE=test-optimized forge snapshot --no-match-test \"test(Fork)?(Fuzz)?_RevertWhen_\\w{1,}?\"",
+    "lint": "bun run lint:sol && bun run prettier:check",
+    "lint:sol": "forge fmt --check && bun solhint \"{script,src,test}/**/*.sol\"",
+    "prepack": "bun install && bash ./shell/prepare-artifacts.sh",
     "prettier:check": "prettier --check \"**/*.{json,md,yml}\"",
     "prettier:write": "prettier --write \"**/*.{json,md,yml}\"",
     "test": "forge test",
     "test:lite": "FOUNDRY_PROFILE=lite forge test",
-    "test:optimized": "pnpm build:optimized && FOUNDRY_PROFILE=test-optimized forge test"
+    "test:optimized": "bun run build:optimized && FOUNDRY_PROFILE=test-optimized forge test"
   }
 }
diff --git a/shell/prepare-artifacts.sh b/shell/prepare-artifacts.sh
index 671063fa..e417fdd2 100755
--- a/shell/prepare-artifacts.sh
+++ b/shell/prepare-artifacts.sh
@@ -5,7 +5,7 @@
 
 # Pre-requisites:
 # - foundry (https://getfoundry.sh)
-# - pnpm (https://pnpm.io)
+# - bun (https://bun.sh)
 
 # Strict mode: https://gist.github.com/vncsna/64825d5609c146e80de8b1fd623011ca
 set -euo pipefail
@@ -40,4 +40,4 @@ libraries=./artifacts/libraries
 cp out-optimized/Errors.sol/Errors.json $libraries
 
 # Format the artifacts with Prettier
-pnpm prettier --write ./artifacts
+bun prettier --write ./artifacts

From 44c82eeac960ac2e1315bae6c144f10368821105 Mon Sep 17 00:00:00 2001
From: Paul Razvan Berg <paul.razvan.berg@gmail.com>
Date: Mon, 1 Jan 2024 11:49:29 +0200
Subject: [PATCH 2/2] docs: add more context in contributing guide

---
 CONTRIBUTING.md | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 9e5f1fbb..17248ea3 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -26,14 +26,21 @@ Clone this repository including submodules:
 $ git clone --recurse-submodules -j8 git@github.com:sablier-labs/v2-periphery.git
 ```
 
-Then, inside the project's directory, run this to install the Node.js dependencies:
+Then, inside the project's directory, run this to install the Node.js dependencies and build the contracts:
 
 ```shell
 $ bun install
+$ bun run build
 ```
 
 Now you can start making changes.
 
+To see a list of all available scripts:
+
+```shell
+$ bun run
+```
+
 ## Pull Requests
 
 When making a pull request, ensure that: