chore: migrate from Yarn Classic to Yarn Berry

* Migrate Yarn to v4 release and cleanup plugins
Replace Yarn Classic with the Yarn v4 release and update project config. Removed individual .yarn/plugins/*.cjs plugin files and added .yarn/releases/yarn-4.16.0.cjs; updated .yarnrc.yml and package.json to use the release, reordered .gitignore entries to ensure .yarn/releases is not ignored, and regenerated yarn.lock.

* chore: use workspace:* for internal packages
- Switch services to use the workspace:* protocol for internal packages (@guardian/common and @guardian/interfaces) to enable local monorepo resolution. Also normalize and tidy package.json entries across services.
- Remove the pinned packageManager: yarn@1.22.21 entries from package.json files in analytics-service, api-gateway, auth-service, indexer-api-gateway, logger-service, and notification-service. This unpins Yarn v1 at the package level and defers package manager choice to workspace/CI configuration.

* chore: Migrate Dockerfiles to Yarn Berry
Replace the old pack/install multi-stage flow with a Yarn Berry workspaces-based build. Enable corepack, add deps-dev/build/deps-prod stages, use yarn workspaces run build for interfaces/common/services and yarn workspaces focus --production to install target-native production deps. Copy workspace package.json/dist outputs into the final image and use a shared yarn cache mount (/root/.yarn/berry/cache). Changes applied to simplify and speed up workspace builds.

* chore: Use Corepack and yarn immutable in workflows
- Replace the old Yarn setup steps with Corepack (corepack enable)
- Update cache path to .yarn/cache, and switch yarn install to --immutable across CI workflow files.
- Remove the ipfs-version matrix entries and hardcode ipfs_version: 0.41.0 in the IPFS setup steps.
- Set YARN_ENABLE_GLOBAL_CACHE: 'false' in GitHub Actions jobs to disable Yarn's global cache during CI

* chore: use local BuildKit cache in workflows
Replace GH Actions registry cache with a local BuildKit cache at /tmp/buildkit-cache across API workflows. Updates cache-from to type=local,src=/tmp/buildkit-cache and cache-to to type=local,dest=/tmp/buildkit-cache,mode=min to use a local Docker buildx cache for the Cypress/Docker jobs.

* docs: Update Node.js version and Yarn links
Bump Node.js recommendation in README.md from v20.19 to v20.20 and replace legacy Yarn install URLs (classic.yarnpkg.com) with the current yarnpkg.com/getting-started/install links across README.md, contracts/README.md, and docs/guardian README. Documentation update to keep prerequisites and install links current; no code changes.

* fix: Scope volume mounts under service subdirs
Change docker-compose volume mount targets to include service-specific subdirectories under /usr/local/app (e.g. ./auth-service/configs -> /usr/local/app/auth-service/configs). Applied across all docker-compose variants

* chore: bump actions/checkout to 6.0.3 in workflows
Update actions/checkout references to the v6.0.3 commit (df4cb1c...) across GitHub Actions workflow files to pick up the latest fixes.
---------
Signed-off-by: Alex Piatakov <alex.piatakov@swirldslabs.com>

Author: Pyatakov

.github/workflows/add-documentation-to-repo.yaml

@@ -10,6 +10,8 @@ jobs:
   runService:
     name: Run Service
     runs-on: guardian-linux-medium
+    env:
+      YARN_ENABLE_GLOBAL_CACHE: 'false'
     strategy:
       matrix:
         node-version: [ 20.20.2 ]
@@ -21,31 +23,25 @@ jobs:
           egress-policy: audit
 
       - name: Checkout Code
-        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+        uses: actions/checkout@df4cb1c069e1874edd31b4311f1884172cec0e10 # v6.0.3
 
       - name: Use Node.js ${{ matrix.node-version }}
-        uses: actions/setup-node@48b55a011bda9f5d6aeb4c2d9c7362e8dae4041e #v6.4.0
+        uses: actions/setup-node@48b55a011bda9f5d6aeb4c2d9c7362e8dae4041e # v6.4.0
         with:
           node-version: ${{ matrix.node-version }}
 
-      - name: Setup Yarn
-        uses: Borales/actions-yarn@3766bb1335b98fb13c60eaf358fe20811b730a88 # v5.0.0
-        with:
-          cmd: --version
-
-      - name: Locate yarn cache
-        id: yarncache
-        run: echo "dir=$(yarn cache dir)" >> "$GITHUB_OUTPUT"
+      - name: Enable Corepack
+        run: corepack enable
 
       - name: Cache yarn
         uses: actions/cache@27d5ce7f107fe9357f9df03efb73ab90386fccae # v5.0.5
         with:
-          path: ${{ steps.yarncache.outputs.dir }}
+          path: .yarn/cache
           key: ${{ runner.os }}-yarn-${{ hashFiles('**/yarn.lock') }}
           restore-keys: ${{ runner.os }}-yarn-
 
       - name: Install dependencies
-        run: yarn install --frozen-lockfile
+        run: yarn install --immutable
 
       - name: Start NatsMQ
         uses: step-security/nats-action@2254b4cc4958120e36da3a096e8200dac968be1c # v0.1.4

.github/workflows/api-after-commit.yml

@@ -8,6 +8,8 @@ jobs:
   buildAndTest:
     name: Build and Test
     runs-on: guardian-linux-medium
+    env:
+      YARN_ENABLE_GLOBAL_CACHE: 'false'
     services:
       cache:
         image: registry.redict.io/redict
@@ -17,39 +19,32 @@ jobs:
       matrix:
         node-version: [ 20.20.2 ]
         mongodb-version: [ 7.0.21 ]
-        ipfs-version: [ 0.41.0 ]
     steps:
       - name: Harden Runner
         uses: step-security/harden-runner@9af89fc71515a100421586dfdb3dc9c984fbf411 # v2.19.4
         with:
           egress-policy: audit
 
       - name: Checkout Code
-        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+        uses: actions/checkout@df4cb1c069e1874edd31b4311f1884172cec0e10 # v6.0.3
 
       - name: Use Node.js ${{ matrix.node-version }}
-        uses: actions/setup-node@48b55a011bda9f5d6aeb4c2d9c7362e8dae4041e #v6.4.0
+        uses: actions/setup-node@48b55a011bda9f5d6aeb4c2d9c7362e8dae4041e # v6.4.0
         with:
           node-version: ${{ matrix.node-version }}
 
-      - name: Setup Yarn
-        uses: Borales/actions-yarn@3766bb1335b98fb13c60eaf358fe20811b730a88 # v5.0.0
-        with:
-          cmd: --version
-
-      - name: Locate yarn cache
-        id: yarncache
-        run: echo "dir=$(yarn cache dir)" >> "$GITHUB_OUTPUT"
+      - name: Enable Corepack
+        run: corepack enable
 
       - name: Cache yarn
         uses: actions/cache@27d5ce7f107fe9357f9df03efb73ab90386fccae # v5.0.5
         with:
-          path: ${{ steps.yarncache.outputs.dir }}
+          path: .yarn/cache
           key: ${{ runner.os }}-yarn-${{ hashFiles('**/yarn.lock') }}
           restore-keys: ${{ runner.os }}-yarn-
 
       - name: Install dependencies
-        run: yarn install --frozen-lockfile
+        run: yarn install --immutable
 
       - name: Build packages
         run: |
@@ -92,10 +87,10 @@ jobs:
         with:
           port: '4222'
 
-      - name: Set up IPFS ${{ matrix.ipfs-version }}
+      - name: Set up IPFS
         uses: oduwsdl/setup-ipfs@678755ac20f92d2dfca7e16138e40ae75f7a0f6f # v0.8.0
         with:
-          ipfs_version: ${{ matrix.ipfs-version }}
+          ipfs_version: 0.41.0
           run_daemon: true
 
       - name: Start MongoDB
@@ -151,8 +146,8 @@ jobs:
           context: ./e2e-tests
           tags: cypress-runner
           load: true
-          cache-from: type=gha
-          cache-to: type=gha,mode=max
+          cache-from: type=local,src=/tmp/buildkit-cache
+          cache-to: type=local,dest=/tmp/buildkit-cache,mode=min
 
       - name: Run Cypress Tests in Docker
         run: |

.github/workflows/api-manual.yml

@@ -16,6 +16,8 @@ jobs:
   buildAndTest:
     name: Build and Test (Manual)
     runs-on: guardian-linux-medium
+    env:
+      YARN_ENABLE_GLOBAL_CACHE: 'false'
     services:
       cache:
         image: registry.redict.io/redict
@@ -25,39 +27,32 @@ jobs:
       matrix:
         node-version: [20.20.2]
         mongodb-version: [7.0.21]
-        ipfs-version: [ 0.41.0 ]
     steps:
       - name: Harden Runner
         uses: step-security/harden-runner@9af89fc71515a100421586dfdb3dc9c984fbf411 # v2.19.4
         with:
           egress-policy: audit
 
       - name: Checkout Code
-        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+        uses: actions/checkout@df4cb1c069e1874edd31b4311f1884172cec0e10 # v6.0.3
 
       - name: Use Node.js ${{ matrix.node-version }}
-        uses: actions/setup-node@48b55a011bda9f5d6aeb4c2d9c7362e8dae4041e #v6.4.0
+        uses: actions/setup-node@48b55a011bda9f5d6aeb4c2d9c7362e8dae4041e # v6.4.0
         with:
           node-version: ${{ matrix.node-version }}
 
-      - name: Setup Yarn
-        uses: Borales/actions-yarn@3766bb1335b98fb13c60eaf358fe20811b730a88 # v5.0.0
-        with:
-          cmd: --version
-
-      - name: Locate yarn cache
-        id: yarncache
-        run: echo "dir=$(yarn cache dir)" >> "$GITHUB_OUTPUT"
+      - name: Enable Corepack
+        run: corepack enable
 
       - name: Cache yarn
         uses: actions/cache@27d5ce7f107fe9357f9df03efb73ab90386fccae # v5.0.5
         with:
-          path: ${{ steps.yarncache.outputs.dir }}
+          path: .yarn/cache
           key: ${{ runner.os }}-yarn-${{ hashFiles('**/yarn.lock') }}
           restore-keys: ${{ runner.os }}-yarn-
 
       - name: Install dependencies
-        run: yarn install --frozen-lockfile
+        run: yarn install --immutable
 
       - name: Build packages
         run: |
@@ -100,10 +95,10 @@ jobs:
         with:
           port: "4222"
 
-      - name: Set up IPFS ${{ matrix.ipfs-version }}
+      - name: Set up IPFS
         uses: oduwsdl/setup-ipfs@678755ac20f92d2dfca7e16138e40ae75f7a0f6f # v0.8.0
         with:
-          ipfs_version: ${{ matrix.ipfs-version }}
+          ipfs_version: 0.41.0
           run_daemon: true
 
       - name: Start MongoDB
@@ -159,8 +154,8 @@ jobs:
           context: ./e2e-tests
           tags: cypress-runner
           load: true
-          cache-from: type=gha
-          cache-to: type=gha,mode=max
+          cache-from: type=local,src=/tmp/buildkit-cache
+          cache-to: type=local,dest=/tmp/buildkit-cache,mode=min
 
       - name: Run Cypress API Tests in Docker
         run: |

.github/workflows/api-schedule-all.yml

@@ -7,6 +7,8 @@ jobs:
   buildAndTest:
     name: Build and Test
     runs-on: guardian-linux-medium
+    env:
+      YARN_ENABLE_GLOBAL_CACHE: 'false'
     services:
       cache:
         image: registry.redict.io/redict
@@ -16,41 +18,34 @@ jobs:
       matrix:
         node-version: [ 20.20.2 ]
         mongodb-version: [ 7.0.21 ]
-        ipfs-version: [ 0.41.0 ]
     steps:
       - name: Harden Runner
         uses: step-security/harden-runner@9af89fc71515a100421586dfdb3dc9c984fbf411 # v2.19.4
         with:
           egress-policy: audit
 
       - name: Checkout Code
-        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+        uses: actions/checkout@df4cb1c069e1874edd31b4311f1884172cec0e10 # v6.0.3
         with:
           ref: 'develop'
 
       - name: Use Node.js ${{ matrix.node-version }}
-        uses: actions/setup-node@48b55a011bda9f5d6aeb4c2d9c7362e8dae4041e #v6.4.0
+        uses: actions/setup-node@48b55a011bda9f5d6aeb4c2d9c7362e8dae4041e # v6.4.0
         with:
           node-version: ${{ matrix.node-version }}
 
-      - name: Setup Yarn
-        uses: Borales/actions-yarn@3766bb1335b98fb13c60eaf358fe20811b730a88 # v5.0.0
-        with:
-          cmd: --version
-
-      - name: Locate yarn cache
-        id: yarncache
-        run: echo "dir=$(yarn cache dir)" >> "$GITHUB_OUTPUT"
+      - name: Enable Corepack
+        run: corepack enable
 
       - name: Cache yarn
         uses: actions/cache@27d5ce7f107fe9357f9df03efb73ab90386fccae # v5.0.5
         with:
-          path: ${{ steps.yarncache.outputs.dir }}
+          path: .yarn/cache
           key: ${{ runner.os }}-yarn-${{ hashFiles('**/yarn.lock') }}
           restore-keys: ${{ runner.os }}-yarn-
 
       - name: Install dependencies
-        run: yarn install --frozen-lockfile
+        run: yarn install --immutable
 
       - name: Build packages
         run: |
@@ -93,10 +88,10 @@ jobs:
         with:
           port: '4222'
 
-      - name: Set up IPFS ${{ matrix.ipfs-version }}
+      - name: Set up IPFS
         uses: oduwsdl/setup-ipfs@678755ac20f92d2dfca7e16138e40ae75f7a0f6f # v0.8.0
         with:
-          ipfs_version: ${{ matrix.ipfs-version }}
+          ipfs_version: 0.41.0
           run_daemon: true
 
       - name: Start MongoDB
@@ -152,8 +147,8 @@ jobs:
           context: ./e2e-tests
           tags: cypress-runner
           load: true
-          cache-from: type=gha
-          cache-to: type=gha,mode=max
+          cache-from: type=local,src=/tmp/buildkit-cache
+          cache-to: type=local,dest=/tmp/buildkit-cache,mode=min
 
       - name: Run Cypress Tests in Docker
         run: |

.github/workflows/api-schedule-vm0033.yml

@@ -7,6 +7,8 @@ jobs:
   buildAndTest:
     name: Build and Test
     runs-on: guardian-linux-medium
+    env:
+      YARN_ENABLE_GLOBAL_CACHE: 'false'
     services:
       cache:
         image: registry.redict.io/redict
@@ -16,41 +18,34 @@ jobs:
       matrix:
         node-version: [ 20.20.2 ]
         mongodb-version: [ 7.0.21 ]
-        ipfs-version: [ 0.41.0 ]
     steps:
       - name: Harden Runner
         uses: step-security/harden-runner@9af89fc71515a100421586dfdb3dc9c984fbf411 # v2.19.4
         with:
           egress-policy: audit
 
       - name: Checkout Code
-        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+        uses: actions/checkout@df4cb1c069e1874edd31b4311f1884172cec0e10 # v6.0.3
         with:
           ref: 'develop'
 
       - name: Use Node.js ${{ matrix.node-version }}
-        uses: actions/setup-node@48b55a011bda9f5d6aeb4c2d9c7362e8dae4041e #v6.4.0
+        uses: actions/setup-node@48b55a011bda9f5d6aeb4c2d9c7362e8dae4041e # v6.4.0
         with:
           node-version: ${{ matrix.node-version }}
 
-      - name: Setup Yarn
-        uses: Borales/actions-yarn@3766bb1335b98fb13c60eaf358fe20811b730a88 # v5.0.0
-        with:
-          cmd: --version
-
-      - name: Locate yarn cache
-        id: yarncache
-        run: echo "dir=$(yarn cache dir)" >> "$GITHUB_OUTPUT"
+      - name: Enable Corepack
+        run: corepack enable
 
       - name: Cache yarn
         uses: actions/cache@27d5ce7f107fe9357f9df03efb73ab90386fccae # v5.0.5
         with:
-          path: ${{ steps.yarncache.outputs.dir }}
+          path: .yarn/cache
           key: ${{ runner.os }}-yarn-${{ hashFiles('**/yarn.lock') }}
           restore-keys: ${{ runner.os }}-yarn-
 
       - name: Install dependencies
-        run: yarn install --frozen-lockfile
+        run: yarn install --immutable
 
       - name: Build packages
         run: |
@@ -93,10 +88,10 @@ jobs:
         with:
           port: '4222'
 
-      - name: Set up IPFS ${{ matrix.ipfs-version }}
+      - name: Set up IPFS
         uses: oduwsdl/setup-ipfs@678755ac20f92d2dfca7e16138e40ae75f7a0f6f # v0.8.0
         with:
-          ipfs_version: ${{ matrix.ipfs-version }}
+          ipfs_version: 0.41.0
           run_daemon: true
 
       - name: Start MongoDB
@@ -152,8 +147,8 @@ jobs:
           context: ./e2e-tests
           tags: cypress-runner
           load: true
-          cache-from: type=gha
-          cache-to: type=gha,mode=max
+          cache-from: type=local,src=/tmp/buildkit-cache
+          cache-to: type=local,dest=/tmp/buildkit-cache,mode=min
 
       - name: Run Cypress Tests in Docker
         run: |