feat!: pnpm migration

.codespell/.codespellrc

@@ -1,5 +1,5 @@
 [codespell]
-skip = .git,node_modules,yarn.lock,Cargo.lock,./typescript/helloworld,./rust/main/config
+skip = .git,node_modules,pnpm-lock.yaml,Cargo.lock,./typescript/helloworld,./rust/main/config
 count =
 quiet-level = 3
 ignore-words = ./.codespell/ignore.txt

.dockerignore

@@ -16,8 +16,7 @@ typescript/*/node_modules
 typescript/**/tsconfig.tsbuildinfo
 **/**/tsconfig.tsbuildinfo
 
-.yarn/install-state.gz
-.yarn/cache
-yarn-error.log
+.pnpm-store/
+pnpm-debug.log*
 
 .idea

.github/actions/checkout-registry/action.yml

@@ -17,7 +17,7 @@ runs:
         fi
 
     - name: Checkout hyperlane-registry
-      uses: actions/checkout@v5
+      uses: actions/checkout@v6
       with:
         repository: hyperlane-xyz/hyperlane-registry
         ref: ${{ env.REGISTRY_VERSION }}

.github/actions/install-cli/action.yml

@@ -13,32 +13,30 @@ inputs:
 runs:
   using: 'composite'
   steps:
-    - name: yarn-build-with-cache
+    - name: pnpm-build-with-cache
       if: inputs.no-cache == 'false'
-      uses: ./.github/actions/yarn-build-with-cache
-      with:
-        ref: ${{ inputs.ref }}
+      uses: ./.github/actions/pnpm-build-with-cache
 
     - name: Setup Foundry
       if: inputs.no-cache != 'false'
       uses: ./.github/actions/setup-foundry
 
-    - name: yarn-install-build-without-cache
+    - name: Setup pnpm (no-cache path)
+      if: inputs.no-cache != 'false'
+      uses: pnpm/action-setup@v4
+
+    - name: pnpm-install-build-without-cache
       if: inputs.no-cache != 'false'
       shell: bash
       run: |
-        yarn install
-        yarn build
+        pnpm install --frozen-lockfile
+        pnpm run build
 
     - name: Pack the CLI
       shell: bash
       id: pack-cli
-      run: |
-        cd typescript/cli
-        yarn pack
+      run: pnpm -C typescript/cli pack
 
     - name: Install the packaged CLI
       shell: bash
-      run: |
-        cd typescript/cli
-        npm i -g package.tgz
+      run: npm i -g typescript/cli/hyperlane-xyz-cli-*.tgz

.github/actions/pnpm-build-with-cache/action.yml

@@ -0,0 +1,22 @@
+name: 'PNPM Build with Cache'
+description: 'Run pnpm build using pnpm cache'
+
+runs:
+  using: 'composite'
+  steps:
+    - name: Setup Foundry
+      uses: ./.github/actions/setup-foundry
+
+    - name: pnpm-cache
+      id: pnpm-cache
+      uses: ./.github/actions/pnpm-cache
+
+    # Always run install - pnpm needs to create symlinks from the cached store
+    # The cache makes this much faster by restoring the pnpm store
+    - name: Install dependencies
+      shell: bash
+      run: pnpm install --frozen-lockfile
+
+    - name: Build
+      shell: bash
+      run: pnpm run build

.github/actions/yarn-cache/action.yml → .github/actions/pnpm-cache/action.yml

@@ -1,5 +1,5 @@
-name: 'Yarn Cache'
-description: 'Cache yarn dependencies for faster installs'
+name: 'PNPM Cache'
+description: 'Cache pnpm dependencies for faster installs'
 
 inputs:
   cache-provider:
@@ -19,33 +19,35 @@ runs:
     # But this is not available for non-depot runners.
     # So we default to github, and expect the workflow to set cache-provider=buildjet if needed.
     # https://depot.dev/docs/github-actions/overview#faster-caching
+    - name: Setup pnpm
+      uses: pnpm/action-setup@v4
+
     - name: Determine Cache Provider
       id: determine-cache
       shell: bash
-      run: echo "cache-provider=${{ inputs.cache-provider }}" >> $GITHUB_ENV
+      run: echo "cache_provider=${{ inputs.cache-provider }}" >> $GITHUB_ENV
+
+    - name: Get pnpm store directory
+      id: pnpm-store
+      shell: bash
+      run: echo "store_path=$(pnpm store path)" >> $GITHUB_OUTPUT
 
     - name: Cache (Buildjet)
       id: buildjet-cache
-      if: env.cache-provider == 'buildjet'
+      if: env.cache_provider == 'buildjet'
       uses: buildjet/cache@v4
       with:
-        path: |
-          **/node_modules
-          .yarn/cache
-          .yarn/install-state.gz
-        key: ${{ runner.os }}-yarn-4.5.1-cache-${{ hashFiles('./yarn.lock') }}
+        path: ${{ steps.pnpm-store.outputs.store_path }}
+        key: ${{ runner.os }}-pnpm-store-${{ hashFiles('**/pnpm-lock.yaml') }}
         restore-keys: |
-          ${{ runner.os }}-yarn-4.5.1-cache-
+          ${{ runner.os }}-pnpm-store-
 
     - name: Cache (GitHub)
       id: github-cache
-      if: env.cache-provider == 'github'
+      if: env.cache_provider == 'github'
       uses: actions/cache@v4
       with:
-        path: |
-          **/node_modules
-          .yarn/cache
-          .yarn/install-state.gz
-        key: ${{ runner.os }}-yarn-4.5.1-cache-${{ hashFiles('./yarn.lock') }}
+        path: ${{ steps.pnpm-store.outputs.store_path }}
+        key: ${{ runner.os }}-pnpm-store-${{ hashFiles('**/pnpm-lock.yaml') }}
         restore-keys: |
-          ${{ runner.os }}-yarn-4.5.1-cache-
+          ${{ runner.os }}-pnpm-store-

.github/workflows/agent-release-artifacts.yml

@@ -30,7 +30,7 @@ jobs:
     runs-on: ${{ matrix.OS }}
     steps:
       - name: checkout
-        uses: actions/checkout@v5
+        uses: actions/checkout@v6
       - name: ubuntu setup
         if: ${{ matrix.OS == 'depot-ubuntu-24.04-8' }}
         run: |

.github/workflows/bytecode-analysis.yml

@@ -20,7 +20,7 @@ jobs:
     steps:
       # Checkout the PR branch
       - name: Checkout PR branch
-        uses: actions/checkout@v5
+        uses: actions/checkout@v6
         with:
           ref: ${{ github.event.pull_request.head.sha || github.sha }}
           submodules: recursive
@@ -29,20 +29,20 @@ jobs:
         with:
           node-version-file: .nvmrc
 
-      - name: yarn-cache
-        uses: ./.github/actions/yarn-cache
+      - name: pnpm-cache
+        uses: ./.github/actions/pnpm-cache
         with:
           cache-provider: buildjet
 
-      - name: yarn-install
-        run: yarn install
+      - name: pnpm-install
+        run: pnpm install --frozen-lockfile
 
       - name: Setup Foundry
         uses: ./.github/actions/setup-foundry
 
       # Run the command on PR branch
       - name: Run command on PR branch
-        run: yarn workspace @hyperlane-xyz/core bytecode HEAD-bytecode
+        run: pnpm -C solidity run bytecode HEAD-bytecode
 
       # Checkout the target branch (base)
       - name: Checkout target branch (base) contracts
@@ -62,7 +62,7 @@ jobs:
 
       # Run the command on the target branch
       - name: Run command on target branch
-        run: yarn workspace @hyperlane-xyz/core bytecode base-bytecode
+        run: pnpm -C solidity run bytecode base-bytecode
 
       # Compare outputs
       - name: Compare outputs (fail on any changes)

.github/workflows/codespell.yml

@@ -19,7 +19,7 @@ jobs:
 
     steps:
       - name: Checkout the repository
-        uses: actions/checkout@v5
+        uses: actions/checkout@v6
 
       - name: Setup python
         uses: actions/setup-python@v6

.github/workflows/monorepo-docker.yml

@@ -16,7 +16,7 @@ on:
       - 'solidity/.foundryrc'
       - 'typescript/ccip-server/**'
       # Dependency changes that could affect the Docker build
-      - 'yarn.lock'
+      - 'pnpm-lock.yaml'
       - '**/package.json'
   workflow_dispatch:
     inputs:
@@ -63,7 +63,7 @@ jobs:
           app-id: ${{ secrets.HYPER_GONK_APP_ID }}
           private-key: ${{ secrets.HYPER_GONK_PRIVATE_KEY }}
 
-      - uses: actions/checkout@v5
+      - uses: actions/checkout@v6
         with:
           ref: ${{ github.event.pull_request.head.sha || github.sha }}
           submodules: recursive

.github/workflows/npm-beta-release.yml

@@ -32,7 +32,7 @@ jobs:
       id-token: write
     steps:
       - name: Checkout
-        uses: actions/checkout@v5
+        uses: actions/checkout@v6
         with:
           fetch-depth: 0
           submodules: recursive
@@ -50,18 +50,21 @@ jobs:
             echo "::error::No pending changesets found. Beta releases require pending changeset files."
             echo ""
             echo "To create a beta release:"
-            echo "1. Add a changeset: yarn changeset"
+            echo "1. Add a changeset: pnpm exec changeset"
             echo "2. Commit the changeset file"
             echo "3. Run this workflow again"
             exit 1
           fi
           echo "Found $CHANGESET_COUNT changeset(s)"
 
+      - name: Setup pnpm
+        uses: pnpm/action-setup@v4
+
       - name: Install dependencies
-        run: yarn install --immutable
+        run: pnpm install --frozen-lockfile
 
       - name: Create snapshot versions
-        run: yarn changeset version --snapshot ${{ inputs.snapshot_tag }}
+        run: pnpm exec changeset version --snapshot ${{ inputs.snapshot_tag }}
 
       - name: Get snapshot version
         id: version
@@ -74,10 +77,10 @@ jobs:
         uses: ./.github/actions/setup-foundry
 
       - name: Build packages
-        run: yarn build && yarn build:zk
+        run: pnpm run build && pnpm run build:zk
 
       - name: Publish beta packages
-        run: yarn changeset publish --tag ${{ inputs.snapshot_tag }} --no-git-tag
+        run: pnpm exec changeset publish --tag ${{ inputs.snapshot_tag }} --no-git-tag
         env:
           NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
           NPM_CONFIG_PROVENANCE: true