Version Packages (#2751 )

Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
feat: 1155 extensions (#2744 )
2024-04-11 13:50:17 -07:00 · 2024-04-11 13:15:02 -07:00 · 2024-04-11 18:51:13 +00:00 · 2024-04-11 17:33:00 +00:00 · 2024-04-11 16:47:39 +00:00 · 2024-04-11 16:25:28 +00:00
6053 changed files with 319854 additions and 96325 deletions
@@ -15,7 +15,14 @@
  "access": "public",
  "baseBranch": "main",
  "updateInternalDependencies": "patch",
-  "ignore": ["e2e-cra-5", "e2e-next-13", "e2e-vite-3"],
+  "ignore": [
+    "bundlers-esbuild",
+    "bundlers-vite",
+    "bundlers-webpack",
+    "bundlers-swc",
+    "runtimes-node-commonjs",
+    "runtimes-node-module"
+  ],
  "___experimentalUnsafeOptions_WILL_CHANGE_IN_PATCH": {
    "updateInternalDependents": "always",
    "onlyUpdatePeerDependentsWhenOutOfRange": true
@@ -3,4 +3,5 @@

 # used for unit tests that hit real IPFS gateway
 # get a secret key from https://thirdweb.com/create-api-key
-TW_SECRET_KEY=""
+# Learn more about API keys. https://portal.thirdweb.com/account/api-keys
+TW_SECRET_KEY=""
@@ -2,28 +2,52 @@

 # Platform team owns everything by default

-* @thirdweb-dev/platform
+- @jnsdls @joaquim-verges @MananTank

-# Devrel owns all markdown files (README etc.)
+# legacy packages

-*.md @thirdweb-dev/devrel
-.changeset/
+legacy_packages/auth/ @jnsdls
+legacy_packages/chains/ @jnsdls
+legacy_packages/cli/ @jnsdls
+legacy_packages/contracts-js/ @jnsdls
+legacy_packages/crypto/ @jnsdls
+legacy_packages/generated-abis/ @jnsdls
+legacy_packages/merkletree/ @jnsdls
+legacy_packages/pay/ @jnsdls
+legacy_packages/payments/ @jnsdls
+legacy_packages/react/ @MananTank @jnsdls
+legacy_packages/react-core/ @MananTank @jnsdls
+legacy_packages/react-native/ @jnsdls
+legacy_packages/react-native-compat/ @jnsdls
+legacy_packages/sdk/ @joaquim-verges @jnsdls
+legacy_packages/storage/ @jnsdls
+legacy_packages/wallets/ @MananTank @jnsdls

-# Shared ownership of the react and react-core packages
+# legacy e2e

-packages/react/ @thirdweb-dev/product @thirdweb-dev/platform
-packages/react-core/ @thirdweb-dev/product @thirdweb-dev/platform
+legacy_e2e/ @jnsdls

-# Shared ownership of the CLI
+# packages

-packages/cli/ @thirdweb-dev/product @thirdweb-dev/platform
+## specific thirdweb pieces

-# Chains is owned specifically by jonas for now
+packages/thirdweb/src/react/ @MananTank
+packages/thirdweb/src/reactive/ @MananTank
+packages/thirdweb/src/gas/ @joaquim-verges
+packages/thirdweb/src/pay/ @MananTank @IDubuque

-packages/chains/ @jnsdls
+packages/typedoc-gen/ @MananTank

-# .github folder + .changeset + turbo config is owned by joaquim and jonas for now
+# owned by phil for now

-.github/ @jnsdls @joaquim-verges
-.changeset/config.json @jnsdls @joaquim-verges
-turbo.json @joaquim-verges @jnsdls
+packages/service-utils/ @arcoraven
+packages/eslint-config-thirdweb/ @jnsdls
+packages/tw-tsconfig/ @jnsdls
+packages/unity-js-bridge/ @joaquim-verges @0xFirekeeper
+
+# .github folder + .changeset + turbo config is owned by jonas for now
+
+scripts/ @jnsdls
+.github/ @jnsdls
+.changeset/config.json @jnsdls
+turbo.json @jnsdls
@@ -4,13 +4,20 @@ description: "Sets up Node.js and runs install"
 runs:
  using: composite
  steps:
-    - uses: pnpm/action-setup@v2
+    # we use bun for some test suites
+    - name: Setup bun
+      uses: oven-sh/setup-bun@v1
+      with:
+        bun-version: 1.0.35
+    # pnpm for our dependencies
+    - uses: pnpm/action-setup@v3
      with:
        version: 8
    - name: Setup Node.js
-      uses: actions/setup-node@v3
+      uses: actions/setup-node@v4
      with:
        node-version: 20
+        check-latest: true
        registry-url: "https://registry.npmjs.org"
        cache: "pnpm"

@@ -22,13 +22,13 @@ We use [Turborepo](https://turborepo.org/docs/getting-started) to manage the mon

 You can see a quick outline of each of the projects within this repo below, each living within the [/packages](/packages) directory:

-| Package                        | Description                                                          | Latest Version                                                                                                                                                                   |
-| ------------------------------ | -------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| [/sdk](./packages/sdk)         | Best in class web3 SDK for Browser, Node and Mobile apps             | <a href="https://www.npmjs.com/package/@thirdweb-dev/sdk"><img src="https://img.shields.io/npm/v/@thirdweb-dev/sdk?color=red&label=npm&logo=npm" alt="npm version"/></a>         |
-| [/react](./packages/react)     | Ultimate collection of React hooks for your web3 apps                | <a href="https://www.npmjs.com/package/@thirdweb-dev/react"><img src="https://img.shields.io/npm/v/@thirdweb-dev/react?color=red&label=npm&logo=npm" alt="npm version"/></a>     |
-| [/auth](./packages/auth)       | Best in class wallet authentication for Node backends                | <a href="https://www.npmjs.com/package/@thirdweb-dev/auth"><img src="https://img.shields.io/npm/v/@thirdweb-dev/auth?color=red&label=npm&logo=npm" alt="npm version"/></a>       |
-| [/storage](./packages/storage) | Best in class decentralized storage SDK for Browser and Node         | <a href="https://www.npmjs.com/package/@thirdweb-dev/storage"><img src="https://img.shields.io/npm/v/@thirdweb-dev/storage?color=red&label=npm&logo=npm" alt="npm version"/></a> |
-| [/cli](./packages/cli)         | Publish and deploy smart contracts without dealing with private keys | <a href="https://www.npmjs.com/package/thirdweb"><img src="https://img.shields.io/npm/v/thirdweb?color=red&label=npm&logo=npm" alt="npm version"/></a>                           |
+| Package                               | Description                                                          | Latest Version                                                                                                                                                                   |
+| ------------------------------------- | -------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| [/sdk](./legacy_packages/sdk)         | Best in class web3 SDK for Browser, Node and Mobile apps             | <a href="https://www.npmjs.com/package/@thirdweb-dev/sdk"><img src="https://img.shields.io/npm/v/@thirdweb-dev/sdk?color=red&label=npm&logo=npm" alt="npm version"/></a>         |
+| [/react](./legacy_packages/react)     | Ultimate collection of React hooks for your web3 apps                | <a href="https://www.npmjs.com/package/@thirdweb-dev/react"><img src="https://img.shields.io/npm/v/@thirdweb-dev/react?color=red&label=npm&logo=npm" alt="npm version"/></a>     |
+| [/auth](./legacy_packages/auth)       | Best in class wallet authentication for Node backends                | <a href="https://www.npmjs.com/package/@thirdweb-dev/auth"><img src="https://img.shields.io/npm/v/@thirdweb-dev/auth?color=red&label=npm&logo=npm" alt="npm version"/></a>       |
+| [/storage](./legacy_packages/storage) | Best in class decentralized storage SDK for Browser and Node         | <a href="https://www.npmjs.com/package/@thirdweb-dev/storage"><img src="https://img.shields.io/npm/v/@thirdweb-dev/storage?color=red&label=npm&logo=npm" alt="npm version"/></a> |
+| [/cli](./legacy_packages/cli)         | Publish and deploy smart contracts without dealing with private keys | <a href="https://www.npmjs.com/package/thirdweb"><img src="https://img.shields.io/npm/v/thirdweb?color=red&label=npm&logo=npm" alt="npm version"/></a>                           |

 ## How to contribute

@@ -9,3 +9,8 @@ updates:
    directory: "/" # Location of package manifests
    schedule:
      interval: "weekly"
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      # Check for updates to GitHub Actions every week
+      interval: "weekly"
@@ -11,3 +11,9 @@ Short description of the bug fixed or feature added

 - [ ] Automated tests: link to unit test file
 - [ ] Manual tests: step by step instructions on how to test
+
+## Contributor NFT
+
+Paste in your wallet address below and we will airdrop you a special NFT when your pull request is merged. 
+
+```Address: ```
@@ -0,0 +1,136 @@
+name: CI
+
+on:
+  push:
+    branches: ["main"]
+    paths:
+      - "packages/**"
+      - "package.json"
+  pull_request:
+    types: [opened, synchronize]
+    paths:
+      - "packages/**"
+      - "package.json"
+  # trigger on merge group as well (merge queue)
+  merge_group:
+    types: [checks_requested]
+    branches: ["main"]
+  workflow_dispatch:
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+  # To use Remote Caching, uncomment the next lines and follow the steps below.
+env:
+  TURBO_TOKEN: ${{ secrets.TURBO_TOKEN }}
+  TURBO_TEAM: ${{ secrets.TURBO_TEAM }}
+  TW_SECRET_KEY: ${{ secrets.TW_SECRET_KEY }}
+  CODECOV_TOKEN: ${{ secrets.CODECOV_TOKEN }}
+
+jobs:
+  build:
+    runs-on: ubuntu-latest-16
+    name: Build Packages
+    steps:
+      - name: Check out the code
+        uses: actions/checkout@v4
+
+      - name: Setup & Install
+        uses: ./.github/composite-actions/install
+
+      - name: Build Packages
+        run: pnpm build:packages
+
+  lint:
+    timeout-minutes: 15
+    name: Lint Packages
+    runs-on: ubuntu-latest
+    steps:
+      - name: Check out the code
+        uses: actions/checkout@v4
+
+      - name: Setup & Install
+        uses: ./.github/composite-actions/install
+
+      - name: Setup Biome
+        uses: biomejs/setup-biome@v2
+        with:
+          version: latest  
+
+      - run: pnpm lint
+
+  test:
+    timeout-minutes: 15
+    name: Unit Tests
+    runs-on: ubuntu-latest-16
+    steps:
+      - name: Check out the code
+        uses: actions/checkout@v4
+
+      - name: Setup & Install
+        uses: ./.github/composite-actions/install
+
+      - name: Set up foundry
+        uses: foundry-rs/foundry-toolchain@v1
+
+      - run: pnpm test
+
+      - name: Upload coverage reports to Codecov
+        uses: codecov/codecov-action@v4
+        with:
+          directory: packages/
+          flags: packages
+          verbose: true
+
+  e2e:
+    timeout-minutes: 15
+    name: E2E Tests
+    runs-on: ubuntu-latest
+    steps:
+      - name: Check out the code
+        uses: actions/checkout@v4
+
+      - name: Setup & Install
+        uses: ./.github/composite-actions/install
+
+      # TODO actually run e2e tests
+
+  benchmark:
+    # cannot run benchmarks on merge group
+    if: github.event_name != 'merge_group'
+    timeout-minutes: 15
+    name: "Benchmarks"
+    runs-on: ubuntu-latest-16
+    steps:
+      - name: Check out the code
+        uses: actions/checkout@v4
+
+      - name: Setup & Install
+        uses: ./.github/composite-actions/install
+
+      - name: Run benchmarks
+        uses: CodSpeedHQ/action@v2
+        with:
+          token: ${{ secrets.CODSPEED_TOKEN }}
+          run: "pnpm bench"
+
+  size:
+    # only run on pull requests
+    if: github.event_name == 'pull_request'
+    timeout-minutes: 15
+    name: "Size"
+    runs-on: ubuntu-latest-16
+    steps:
+      - name: Check out the code
+        uses: actions/checkout@v4
+
+      - name: Setup & Install
+        uses: ./.github/composite-actions/install
+
+      - name: Report bundle size
+        uses: andresz1/size-limit-action@master
+        with:
+          github_token: ${{ secrets.GITHUB_TOKEN }}
+          package_manager: pnpm
+          directory: packages/thirdweb
@@ -0,0 +1,98 @@
+name: CI (Legacy Packages)
+
+on:
+  push:
+    branches: ["main"]
+    paths:
+      - "legacy_packages/**"
+      - "legacy_e2e/**"
+      - "package.json"
+  pull_request:
+    types: [opened, synchronize]
+    paths:
+      - "legacy_packages/**"
+      - "legacy_e2e/**"
+      - "package.json"
+  # trigger on merge group as well (merge queue)
+  merge_group:
+    types: [checks_requested]
+    branches: ["main"]
+  workflow_dispatch:
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+  # To use Remote Caching, uncomment the next lines and follow the steps below.
+env:
+  TURBO_TOKEN: ${{ secrets.TURBO_TOKEN }}
+  TURBO_TEAM: ${{ secrets.TURBO_TEAM }}
+  TW_SECRET_KEY: ${{ secrets.TW_SECRET_KEY }}
+  CODECOV_TOKEN: ${{ secrets.CODECOV_TOKEN }}
+
+jobs:
+  build:
+    runs-on: ubuntu-latest-16
+    name: Build Packages
+    steps:
+      - name: Check out the code
+        uses: actions/checkout@v4
+
+      - name: Setup & Install
+        uses: ./.github/composite-actions/install
+
+      - name: Build Packages
+        run: pnpm build:legacy_packages
+
+  lint:
+    timeout-minutes: 15
+    name: Lint Packages
+    runs-on: ubuntu-latest
+    steps:
+      - name: Check out the code
+        uses: actions/checkout@v4
+
+      - name: Setup & Install
+        uses: ./.github/composite-actions/install
+
+      - run: pnpm lint:legacy
+
+  test:
+    timeout-minutes: 15
+    name: Unit Tests
+    runs-on: ubuntu-latest-16
+    steps:
+      - name: Check out the code
+        uses: actions/checkout@v4
+
+      - name: Setup & Install
+        uses: ./.github/composite-actions/install
+
+      - run: pnpm test:legacy
+
+      - name: Upload coverage reports to Codecov
+        uses: codecov/codecov-action@v4
+        with:
+          directory: legacy_packages/
+          flags: legacy_packages
+          verbose: true
+
+  e2e:
+    timeout-minutes: 15
+    name: E2E Tests
+    runs-on: ubuntu-latest-16
+    steps:
+      - name: Check out the code
+        uses: actions/checkout@v4
+
+      - name: Setup & Install
+        uses: ./.github/composite-actions/install
+
+      - name: Install Playwright
+        run: npx playwright install --with-deps
+
+      - name: Run e2e tests
+        run: pnpm e2e:legacy
+        env:
+          NODE_OPTIONS: "--max_old_space_size=4096"
+          CLI_E2E_API_KEY: ${{ secrets.CLI_E2E_API_KEY }}
@@ -1,135 +0,0 @@
-name: Build, Lint & Test
-
-on:
-  push:
-    branches: ["main"]
-  pull_request:
-    types: [opened, synchronize]
-  # trigger on merge group as well (merge queue)
-  merge_group:
-    types: [checks_requested]
-
-concurrency:
-  group: ${{ github.workflow }}-${{ github.ref }}
-  cancel-in-progress: true
-
-  # To use Remote Caching, uncomment the next lines and follow the steps below.
-env:
-  TURBO_TOKEN: ${{ secrets.TURBO_TOKEN }}
-  TURBO_TEAM: ${{ secrets.TURBO_TEAM }}
-  TW_SECRET_KEY: ${{ secrets.TW_SECRET_KEY }}
-
-jobs:
-  build:
-    timeout-minutes: 15
-    name: Build
-    runs-on: ubuntu-latest-16
-
-    steps:
-      - name: Check out code
-        uses: actions/checkout@v3
-        with:
-          fetch-depth: 25
-
-      - name: Install
-        uses: ./.github/composite-actions/install
-
-      - run: pnpm build
-
-        # We use week in the turbo cache key to keep the cache from infinitely growing
-      - id: get-week
-        run: echo "WEEK=$(date +%U)" >> $GITHUB_OUTPUT
-
-      - uses: actions/cache@v3
-        timeout-minutes: 5
-        id: cache-build
-        with:
-          path: ./*
-          key: ${{ github.sha }}-${{ github.run_number }}
-
-  lint:
-    timeout-minutes: 15
-    name: Lint Packages
-    runs-on: ubuntu-latest
-    needs: build
-    steps:
-      - name: Setup node
-        uses: actions/setup-node@v3
-        with:
-          node-version: 20
-          check-latest: true
-
-      - uses: pnpm/action-setup@v2
-        with:
-          version: 8
-
-      - uses: actions/cache@v3
-        timeout-minutes: 5
-        id: restore-build
-        with:
-          path: ./*
-          key: ${{ github.sha }}-${{ github.run_number }}
-
-      - run: pnpm lint
-
-  test:
-    timeout-minutes: 15
-    name: Unit Tests
-    runs-on: ubuntu-latest-16
-    needs: build
-    steps:
-      - name: Setup node
-        uses: actions/setup-node@v3
-        with:
-          node-version: 20
-          check-latest: true
-
-      - uses: pnpm/action-setup@v2
-        with:
-          version: 8
-
-      - uses: actions/cache@v3
-        timeout-minutes: 5
-        id: restore-build
-        with:
-          path: ./*
-          key: ${{ github.sha }}-${{ github.run_number }}
-
-      - run: pnpm test
-
-      - name: Upload coverage reports to Codecov
-        uses: codecov/codecov-action@v3
-        with:
-          files: ./packages/sdk/coverage/evm/lcov.info
-
-  e2e:
-    timeout-minutes: 15
-    name: E2E Tests
-    runs-on: ubuntu-latest-16
-    needs: build
-    steps:
-      - name: Setup node
-        uses: actions/setup-node@v3
-        with:
-          node-version: 20
-          check-latest: true
-
-      - uses: pnpm/action-setup@v2
-        with:
-          version: 8
-
-      - uses: actions/cache@v3
-        timeout-minutes: 5
-        id: restore-build
-        with:
-          path: ./*
-          key: ${{ github.sha }}-${{ github.run_number }}
-
-      - name: Install Playwright
-        run: npx playwright install --with-deps
-
-      - name: Run e2e tests
-        run: pnpm e2e
-        env:
-          NODE_OPTIONS: "--max_old_space_size=4096"
-          CLI_E2E_API_KEY: ${{ secrets.CLI_E2E_API_KEY }}
@@ -13,12 +13,16 @@ name: "CodeQL"

 on:
  push:
-    branches: [ "main" ]
+    branches: ["main"]
  pull_request:
    # The branches below must be a subset of the branches above
-    branches: [ "main" ]
+    branches: ["main"]
  schedule:
-    - cron: '37 9 * * 3'
+    - cron: "37 9 * * 3"
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true

 jobs:
  analyze:
@@ -32,41 +36,40 @@ jobs:
    strategy:
      fail-fast: false
      matrix:
-        language: [ 'javascript' ]
+        language: ["javascript"]
        # CodeQL supports [ 'cpp', 'csharp', 'go', 'java', 'javascript', 'python', 'ruby' ]
        # Learn more about CodeQL language support at https://aka.ms/codeql-docs/language-support

    steps:
-    - name: Checkout repository
-      uses: actions/checkout@v3
+      - name: Checkout repository
+        uses: actions/checkout@v4

-    # Initializes the CodeQL tools for scanning.
-    - name: Initialize CodeQL
-      uses: github/codeql-action/init@v2
-      with:
-        languages: ${{ matrix.language }}
-        # If you wish to specify custom queries, you can do so here or in a config file.
-        # By default, queries listed here will override any specified in a config file.
-        # Prefix the list here with "+" to use these queries and those in the config file.
-        
-        # Details on CodeQL's query packs refer to : https://docs.github.com/en/code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/configuring-code-scanning#using-queries-in-ql-packs
-        # queries: security-extended,security-and-quality
+      # Initializes the CodeQL tools for scanning.
+      - name: Initialize CodeQL
+        uses: github/codeql-action/init@v3
+        with:
+          languages: ${{ matrix.language }}
+          # If you wish to specify custom queries, you can do so here or in a config file.
+          # By default, queries listed here will override any specified in a config file.
+          # Prefix the list here with "+" to use these queries and those in the config file.

-        
-    # Autobuild attempts to build any compiled languages  (C/C++, C#, or Java).
-    # If this step fails, then you should remove it and run the build manually (see below)
-    - name: Autobuild
-      uses: github/codeql-action/autobuild@v2
+          # Details on CodeQL's query packs refer to : https://docs.github.com/en/code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/configuring-code-scanning#using-queries-in-ql-packs
+          # queries: security-extended,security-and-quality

-    # ℹ️ Command-line programs to run using the OS shell.
-    # 📚 See https://docs.github.com/en/actions/using-workflows/workflow-syntax-for-github-actions#jobsjob_idstepsrun
+      # Autobuild attempts to build any compiled languages  (C/C++, C#, or Java).
+      # If this step fails, then you should remove it and run the build manually (see below)
+      - name: Autobuild
+        uses: github/codeql-action/autobuild@v3

-    #   If the Autobuild fails above, remove it and uncomment the following three lines. 
-    #   modify them (or add more) to build your code if your project, please refer to the EXAMPLE below for guidance.
+      # ℹ️ Command-line programs to run using the OS shell.
+      # 📚 See https://docs.github.com/en/actions/using-workflows/workflow-syntax-for-github-actions#jobsjob_idstepsrun

-    # - run: |
-    #   echo "Run, Build Application using script"
-    #   ./location_of_script_within_repo/buildscript.sh
+      #   If the Autobuild fails above, remove it and uncomment the following three lines.
+      #   modify them (or add more) to build your code if your project, please refer to the EXAMPLE below for guidance.

-    - name: Perform CodeQL Analysis
-      uses: github/codeql-action/analyze@v2
+      # - run: |
+      #   echo "Run, Build Application using script"
+      #   ./location_of_script_within_repo/buildscript.sh
+
+      - name: Perform CodeQL Analysis
+        uses: github/codeql-action/analyze@v3
@@ -1,17 +0,0 @@
-name: Dispatch Doc Generation
-
-on:
-  push:
-    branches:
-      - main
-
-jobs:
-  dispatch:
-    runs-on: ubuntu-latest
-    steps:
-      - name: Repository Dispatch
-        uses: peter-evans/[email protected]
-        with:
-          token: ${{ secrets.REPO_ACCESS_TOKEN }}
-          repository: thirdweb-dev/docs
-          event-type: generate-docs
@@ -0,0 +1,75 @@
+# On the Version Packages branch
+# Generate and Commit the Typedoc JSON files and the Snippets JSON files
+
+name: Commit Release Artifacts
+
+on:
+  push:
+    branches:
+      - changeset-release/main
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  # cancel any previous runs if they were started before this one
+  cancel-in-progress: true
+
+env:
+  TURBO_TOKEN: ${{ secrets.TURBO_TOKEN }}
+  TURBO_TEAM: ${{ secrets.TURBO_TEAM }}
+  TW_SECRET_KEY: ${{ secrets.TW_SECRET_KEY }}
+
+jobs:
+  release-artifacts:
+    timeout-minutes: 15
+    runs-on: ubuntu-latest-16
+    steps:
+      - name: Checkout branch
+        uses: actions/checkout@v4
+
+      # bun setup is required, because pnpm typdoc will run pnpm build and some packages uses bun for build
+      - name: Setup bun
+        uses: oven-sh/setup-bun@v1
+        with:
+          bun-version: 1.0.35
+
+      - name: Install
+        uses: ./.github/composite-actions/install
+
+      - name: Build
+        run: pnpm build
+
+      - name: Typedoc
+        run: pnpm typedoc
+
+      - name: Generate Docs
+        run: |
+          cd legacy_packages/sdk
+          pnpm generate-docs
+          cd ../react-core
+          pnpm generate-docs
+          cd ../react
+          pnpm generate-docs
+          cd ../..
+
+      - name: Generate Snippets
+        run: pnpm generate-snippets
+
+      - name: Commit changes
+        run: |
+          git config --local user.email "[email protected]"
+          git config --local user.name "GitHub Action"
+          git status
+          git add legacy_packages/react/typedoc/documentation.json.gz
+          git add legacy_packages/react-core/typedoc/documentation.json.gz
+          git add legacy_packages/react-native/typedoc/documentation.json.gz
+          git add legacy_packages/sdk/typedoc/documentation.json.gz
+          git add legacy_packages/storage/typedoc/documentation.json.gz
+          git add legacy_packages/wallets/typedoc/documentation.json.gz
+          git add packages/thirdweb/typedoc/documentation.json.gz
+          git add snippets/feature_snippets_react.json
+          git add snippets/feature_snippets_sdk.json
+          git add snippets/snippets.json
+          git commit -m "Commit Release Artifacts [skip ci]"
+          git push
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
@@ -1,42 +0,0 @@
-name: Release Next
-
-on:
-  push:
-    paths:
-      - ".changeset/**"
-      - "packages/**"
-    branches:
-      - next
-
-env:
-  TURBO_TOKEN: ${{ secrets.TURBO_TOKEN }}
-  TURBO_TEAM: ${{ secrets.TURBO_TEAM }}
-
-concurrency:
-  group: ${{ github.workflow }}-${{ github.ref }}
-
-jobs:
-  release:
-    name: Release
-    timeout-minutes: 30
-    runs-on: ubuntu-latest-16
-    steps:
-      - name: Checkout branch
-        uses: actions/checkout@v3
-        with:
-          fetch-depth: 0
-
-      - name: Install
-        uses: ./.github/composite-actions/install
-
-      - name: Build
-        run: pnpm build
-
-      - name: Create @next release
-        run: |
-          git checkout next
-          pnpm version-packages:next
-          pnpm release:next
-        env:
-          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
@@ -51,7 +51,7 @@ jobs:
    steps:
      - name: get pull request ref
        id: get_pull_request_ref
-        uses: octokit/request-action@v2.1.0
+        uses: octokit/request-action@v2.3.0
        with:
          route: GET /repos/{owner}/{repository}/pulls/{issue_id}
          owner: ${{ github.repository_owner }}
@@ -61,12 +61,17 @@ jobs:
          GITHUB_TOKEN: "${{ secrets.GITHUB_TOKEN }}"

      - name: pull the repo.
-        uses: actions/checkout@v3
+        uses: actions/checkout@v4
        with:
          persist-credentials: true
          repository: ${{ fromJson(steps.get_pull_request_ref.outputs.data).head.repo.full_name }}
          ref: ${{ fromJson(steps.get_pull_request_ref.outputs.data).head.ref }}

+      - name: Setup bun
+        uses: oven-sh/setup-bun@v1
+        with:
+          bun-version: 1.0.35
+
      - name: Install
        uses: ./.github/composite-actions/install

@@ -1,3 +1,6 @@
+# Using CUSTOM_GITHUB_TOKEN instead of GITHUB_TOKEN is required to trigger workflows in "Version Packages" PR created by changesets/action
+# CUSTOM_GITHUB_TOKEN should be a PAT with write access to the repo and has to be created and set as a secret in the repo manually
+
 name: Release Nightly & Stable

 on:
@@ -5,6 +8,7 @@ on:
    paths:
      - ".changeset/**"
      - "packages/**"
+      - "legacy_packages/**"
    branches:
      - main

@@ -22,9 +26,16 @@ jobs:
    runs-on: ubuntu-latest-16
    steps:
      - name: Checkout branch
-        uses: actions/checkout@v3
+        uses: actions/checkout@v4
        with:
          fetch-depth: 0
+          # Do not use the GITHUB_TOKEN by default
+          token: ${{ secrets.CUSTOM_GITHUB_TOKEN }}
+
+      - name: Setup bun
+        uses: oven-sh/setup-bun@v1
+        with:
+          bun-version: 1.0.35

      - name: Install
        uses: ./.github/composite-actions/install
@@ -41,7 +52,7 @@ jobs:
        env:
          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
          NPM_TOKEN: ${{ secrets.NPM_TOKEN }}
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          GITHUB_TOKEN: ${{ secrets.CUSTOM_GITHUB_TOKEN }}

      - name: Create @nightly release
        if: steps.changesets.outputs.published != 'true'
@@ -51,4 +62,4 @@ jobs:
          pnpm release:nightly
        env:
          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          GITHUB_TOKEN: ${{ secrets.CUSTOM_GITHUB_TOKEN }}
@@ -10,33 +10,48 @@ jobs:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout Repository
-        uses: actions/checkout@v2
+        uses: actions/checkout@v4

      - name: Install bun
        uses: oven-sh/setup-bun@v1
+        with:
+          bun-version: 1.0.35

      - name: Run chains sync
        run: bun run db:sync
-        working-directory: ./packages/chains
+        working-directory: ./legacy_packages/chains

      - name: Check for Changes
        id: git-check
        run: |
-          git diff --exit-code || echo "step.git-check.outputs.changes=true" >> $GITHUB_ENV
+          if git diff --quiet; then
+            echo "CHANGES_FOUND=false" >> $GITHUB_ENV
+          else
+            echo "CHANGES_FOUND=true" >> $GITHUB_ENV
+          fi
+
+      - name: Create or Update sync-chains.md
+        if: env.CHANGES_FOUND == 'true'
+        run: |
+          echo '---' > .changeset/sync-chains.md
+          echo '"@thirdweb-dev/chains": patch' >> .changeset/sync-chains.md
+          echo '---' >> .changeset/sync-chains.md
+          echo '' >> .changeset/sync-chains.md
+          echo 'Synced Chains Package' >> .changeset/sync-chains.md

      - name: Commit Changes
-        if: env.step.git-check.outputs.changes == 'true'
+        if: env.CHANGES_FOUND == 'true'
        run: |
-          git config --local user.email "action@github.com"
-          git config --local user.name "GitHub Action"
+          git config --local user.email "41898282+github-actions[bot]@users.noreply.github.com"
+          git config --local user.name "github-actions[bot]"
          git add -A
          git commit -m "chore(chains): sync from db"

      - name: Create or Update Pull Request
-        if: env.step.git-check.outputs.changes == 'true'
-        uses: peter-evans/create-pull-request@v3
+        if: env.CHANGES_FOUND == 'true'
+        uses: peter-evans/create-pull-request@v6
        with:
          title: "chore(chains): update chains"
-          branch: "sync-chains" # You can specify a different branch name if you wish
+          branch: "sync-chains"
          body: "This PR was automatically created by a GitHub Action. It updates the chains package with the latest changes from the database."
          commit-message: "chore(chains): sync from db"
@@ -10,16 +10,16 @@ dist-ssr
 .cache
 server/dist
 public/dist
-./packages/contracts-js/abis
+./legacy_packages/contracts-js/abis
 .idea/
 .yalc/
 yalc.lock
 build/
 playwright-report/
-.vscode/
 .env/

 # Artifacts
-packages/cli/artifacts/
+legacy_packages/cli/artifacts/

-typedoc
+# codecov binary
+codecov
@@ -0,0 +1,7 @@
+{
+	"recommendations": ["biomejs.biome"],
+	"unwantedRecommendations": [
+		"dbaeumer.vscode-eslint",
+		"esbenp.prettier-vscode"
+	]
+}
@@ -0,0 +1,12 @@
+{
+  "editor.formatOnSave": true,
+  "editor.defaultFormatter": "biomejs.biome",
+  "editor.codeActionsOnSave": {
+    "quickfix.biome": "explicit",
+    "source.organizeImports.biome": "explicit"
+  },
+  "typescript.preferences.importModuleSpecifier": "relative",
+  "[typescriptreact]": {
+    "editor.defaultFormatter": "biomejs.biome"
+  }
+}
@@ -1,53 +1,70 @@
 <p align="center">
    <br />
    <a href="https://thirdweb.com">
-        <img src="https://github.com/thirdweb-dev/js/blob/main/packages/sdk/logo.svg?raw=true" width="200" alt=""/></a>
+        <img src="https://github.com/thirdweb-dev/js/blob/main/legacy_packages/sdk/logo.svg?raw=true" width="200" alt=""/></a>
    <br />
 </p>

-<h1 align="center"><a href='https://thirdweb.com/'>thirdweb</a> JavaScript/TypeScript monorepo</h1>
+<h1 align="center"><a href='https://thirdweb.com/'>thirdweb</a> TypeScript SDK</h1>

 <p align="center">
-    <a href="https://github.com/thirdweb-dev/js/actions/workflows/build-test-lint.yml">
-        <img alt="Build Status" src="https://github.com/thirdweb-dev/js/actions/workflows/build-test-lint.yml/badge.svg"/>
+    <a href="https://github.com/thirdweb-dev/js/actions/workflows/CI.yml">
+        <img alt="Build Status" src="https://github.com/thirdweb-dev/js/actions/workflows/CI.yml/badge.svg"/>
    </a>
    <a href="https://discord.gg/thirdweb">
        <img alt="Join our Discord!" src="https://img.shields.io/discord/834227967404146718.svg?color=7289da&label=discord&logo=discord&style=flat"/>
    </a>
 </p>

-<p align="center"><strong>Best in class web3 SDKs for Browser, Node and Mobile apps</strong></p>
+<p align="center"><strong>All-in-one web3 SDK for Browser, Node and Mobile apps</strong></p>

-## Packages
+## Features

-| Package                                  | Description                                                                 | Latest Version                                                                                                                                                                             |
-| ---------------------------------------- | --------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
-| [/sdk](./packages/sdk)                   | Best in class web3 SDK for Browser, Node and Mobile apps                    | <a href="https://www.npmjs.com/package/@thirdweb-dev/sdk"><img src="https://img.shields.io/npm/v/@thirdweb-dev/sdk?color=red&label=npm&logo=npm" alt="npm version"/></a>                   |
-| [/wallets](./packages/wallets)           | Unified web3 Wallet library to integrate any wallet into your applications. | <a href="https://www.npmjs.com/package/@thirdweb-dev/wallets"><img src="https://img.shields.io/npm/v/@thirdweb-dev/wallets?color=red&label=npm&logo=npm" alt="npm version"/></a>           |
-| [/react](./packages/react)               | Ultimate collection of React hooks for your web3 apps                       | <a href="https://www.npmjs.com/package/@thirdweb-dev/react"><img src="https://img.shields.io/npm/v/@thirdweb-dev/react?color=red&label=npm&logo=npm" alt="npm version"/></a>               |
-| [/react-native](./packages/react-native) | Ultimate collection of React hooks for your native mobile web3 apps         | <a href="https://www.npmjs.com/package/@thirdweb-dev/react-native"><img src="https://img.shields.io/npm/v/@thirdweb-dev/react-native?color=red&label=npm&logo=npm" alt="npm version"/></a> |
-| [/auth](./packages/auth)                 | Best in class wallet authentication for Node backends                       | <a href="https://www.npmjs.com/package/@thirdweb-dev/auth"><img src="https://img.shields.io/npm/v/@thirdweb-dev/auth?color=red&label=npm&logo=npm" alt="npm version"/></a>                 |
-| [/storage](./packages/storage)           | Best in class decentralized storage SDK for Browser and Node                | <a href="https://www.npmjs.com/package/@thirdweb-dev/storage"><img src="https://img.shields.io/npm/v/@thirdweb-dev/storage?color=red&label=npm&logo=npm" alt="npm version"/></a>           |
-| [/cli](./packages/cli)                   | Publish and deploy smart contracts without dealing with private keys        | <a href="https://www.npmjs.com/package/thirdweb"><img src="https://img.shields.io/npm/v/thirdweb?color=red&label=npm&logo=npm" alt="npm version"/></a>                                     |
-| [/chains](./packages/chains)             | All EVM chain information as JS objects for easy handling                   | <a href="https://www.npmjs.com/package/@thirdweb-dev/chains"><img src="https://img.shields.io/npm/v/@thirdweb-dev/chains?color=red&label=npm&logo=npm" alt="npm version"/></a>             |
+- Support for React & React-Native
+- First party support for [Embedded Wallets](https://portal.thirdweb.com/connect/embedded-wallet/overview) (social/email login)
+- First party support for [Account Abstraction](https://portal.thirdweb.com/connect/account-abstraction)
+- Instant connection to any chain with RPC Edge integration
+- Integrated IPFS upload/download
+- UI Components for connection, transactions, nft rendering
+- High level contract extensions for interacting with common standards
+- Automatic ABI resolution

-## Documentation
+## Library Comparison

-Visit [https://portal.thirdweb.com/](https://portal.thirdweb.com/) to view the full documentation.
-
-<br />
+|                                           | thirdweb | Wagmi              | Viem               | Ethers@6 |
+| ----------------------------------------- | -------- | ------------------ | ------------------ | -------- |
+| Type safe contract API                    | ✅       | ✅                 | ✅                 | ✅       |
+| Type safe wallet API                      | ✅       | ✅                 | ✅                 | ✅       |
+| EVM utils                                 | ✅       | ❌                 | ✅                 | ✅       |
+| RPC for any EVM                           | ✅       | ⚠️ public RPC only | ⚠️ public RPC only | ❌       |
+| Automatic ABI Resolution                  | ✅       | ❌                 | ❌                 | ❌       |
+| IPFS Upload/Download                      | ✅       | ❌                 | ❌                 | ❌       |
+| Embedded wallet (email/ social login)     | ✅       | ⚠️ via 3rd party   | ❌                 | ❌       |
+| Account abstraction (ERC4337) support     | ✅       | ⚠️ via 3rd party   | ⚠️ via 3rd party   | ❌       |
+| Web3 wallet connectors                    | ✅       | ✅                 | ❌                 | ❌       |
+| Local wallet creation                     | ✅       | ❌                 | ✅                 | ✅       |
+| Auth (SIWE)                               | ✅       | ⚠️ via 3rd party   | ❌                 | ❌       |
+| Extensions functions for common standards | ✅       | ❌                 | ❌                 | ❌       |
+| React Hooks                               | ✅       | ✅                 | ❌                 | ❌       |
+| React UI components                       | ✅       | ❌                 | ❌                 | ❌       |
+| React Native Hooks                        | ✅       | ❌                 | ❌                 | ❌       |
+| React Native UI Components                | ✅       | ❌                 | ❌                 | ❌       |

 ## Contributing

-We welcome contributions from all developers, regardless of experience level. If you are interested in contributing, please read our [Contributing Guide](.github/contributing.md) where you'll learn how the repo works, how to test your changes, and how to submit a pull request.
+We welcome contributions from all developers regardless of experience level. If you are interested in contributing, please read our [Contributing Guide](.github/contributing.md) to learn how the repo works, how to test your changes, and how to submit a pull request.

-<br />
+See our [open source page](https://thirdweb.com/open-source) for more information on our open-source bounties and program.

-## Community
+## Additional Resources

-The best place to discuss your ideas, ask questions, and troubleshoot issues is our [Discord server](https://discord.gg/thirdweb).
+- [Documentation](https://portal.thirdweb.com/typescript/v5)
+- [Templates](https://thirdweb.com/templates)
+- [YouTube](https://www.youtube.com/c/thirdweb)

-<br/>
+## Support
+
+For help or feedback, please [visit our support site](https://thirdweb.com/support)

 ## Security

@@ -0,0 +1,25 @@
+{
+  "$schema": "https://biomejs.dev/schemas/1.6.4/schema.json",
+  "organizeImports": {
+    "enabled": true
+  },
+  "linter": {
+    "enabled": true,
+    "rules": {
+      "recommended": true
+    }
+  },
+  "formatter": {
+    "enabled": true,
+    "indentStyle": "space"
+  },
+  "files": {
+    "ignore": [
+      "legacy_packages/**",
+      "packages/thirdweb/src/crypto/aes/lib/md5.ts",
+      "packages/thirdweb/src/utils/promise/p-limit.ts",
+      "packages/thirdweb/src/utils/bytecode/cbor-decode.ts",
+      "packages/thirdweb/src/**/__generated__/**"
+    ]
+  }
+}
@@ -0,0 +1,30 @@
+coverage:
+  status:
+    project:
+      default:
+        target: auto
+    patch:
+      packages:
+        target: auto
+        flags:
+          - packages
+      legacy_packages:
+        target: auto
+        flags:
+          - legacy_packages 
+      
+
+github_checks:
+    annotations: true
+
+flag_management:
+  default_rules:
+    carryforward: true
+
+comment:
+  layout: "newheader, diff, flags, files"
+  require_changes: false  # if true: only post the comment if coverage changes
+  require_base: false        # [yes :: must have a base report to post]
+  require_head: true       # [yes :: must have a head report to post]
+  show_carryforward_flags: true 
+  hide_comment_details: true #collapse all the "detailed info" for the PR comment
@@ -0,0 +1,3 @@
+import { ThirdwebAuth } from "@thirdweb-dev/auth";
+
+new ThirdwebAuth();
@@ -0,0 +1,3 @@
+import { Ethereum, getChainBySlug } from "@thirdweb-dev/chains";
+
+getChainBySlug("ethereum");
@@ -0,0 +1,3 @@
+import { sha256 } from "@thirdweb-dev/crypto";
+
+sha256("hello world");
@@ -0,0 +1,3 @@
+import { MerkleTree } from "@thirdweb-dev/merkletree";
+
+new MerkleTree([]);
@@ -0,0 +1,3 @@
+import { ThirdwebSDK } from "@thirdweb-dev/sdk";
+
+new ThirdwebSDK(1);
@@ -0,0 +1,3 @@
+import { ThirdwebStorage } from "@thirdweb-dev/storage";
+
+new ThirdwebStorage();
@@ -0,0 +1,3 @@
+import { LocalWallet } from "@thirdweb-dev/wallets";
+
+new LocalWallet();
@@ -0,0 +1,20 @@
+{
+  "name": "bundlers-esbuild",
+  "private": true,
+  "dependencies": {
+    "@thirdweb-dev/auth": "workspace:*",
+    "@thirdweb-dev/chains": "workspace:*",
+    "@thirdweb-dev/crypto": "workspace:*",
+    "@thirdweb-dev/merkletree": "workspace:*",
+    "@thirdweb-dev/sdk": "workspace:*",
+    "@thirdweb-dev/storage": "workspace:*",
+    "@thirdweb-dev/wallets": "workspace:*"
+  },
+  "scripts": {
+    "e2e": "bun run.ts"
+  },
+  "devDependencies": {
+    "esbuild": "0.20.2",
+    "ora": "^6.3.1"
+  }
+}
@@ -0,0 +1,27 @@
+import { $ } from "bun";
+import fs from "node:fs/promises";
+import ora from "ora";
+
+const fixtures = await fs.readdir("./fixtures");
+
+const spinner = ora("Running fixtures: ").start();
+
+for (const fixture of fixtures) {
+  spinner.suffixText = fixture;
+  try {
+    await $`esbuild fixtures/${fixture} --bundle`.text();
+  } catch (error) {
+    if (error.exitCode !== 0) {
+      console.error(error);
+      spinner.fail("Failed to run fixture: " + fixture);
+      // await fs.rm("./fixtures/index.html");
+
+      process.exit(1);
+    }
+  }
+}
+
+// await fs.rm("./fixtures/index.html");
+
+spinner.suffixText = "";
+spinner.succeed("All fixtures ran successfully");
@@ -0,0 +1,3 @@
+import { ThirdwebAuth } from "@thirdweb-dev/auth";
+
+new ThirdwebAuth();
@@ -0,0 +1,3 @@
+import { Ethereum, getChainBySlug } from "@thirdweb-dev/chains";
+
+getChainBySlug("ethereum");
@@ -0,0 +1,3 @@
+import { sha256 } from "@thirdweb-dev/crypto";
+
+sha256("hello world");
@@ -0,0 +1,3 @@
+import { MerkleTree } from "@thirdweb-dev/merkletree";
+
+new MerkleTree([]);
@@ -0,0 +1,3 @@
+import { ThirdwebSDK } from "@thirdweb-dev/sdk";
+
+new ThirdwebSDK(1);
@@ -0,0 +1,3 @@
+import { ThirdwebStorage } from "@thirdweb-dev/storage";
+
+new ThirdwebStorage();
@@ -0,0 +1,3 @@
+import { LocalWallet } from "@thirdweb-dev/wallets";
+
+new LocalWallet();
@@ -0,0 +1,21 @@
+{
+  "name": "bundlers-swc",
+  "private": true,
+  "dependencies": {
+    "@thirdweb-dev/auth": "workspace:*",
+    "@thirdweb-dev/chains": "workspace:*",
+    "@thirdweb-dev/crypto": "workspace:*",
+    "@thirdweb-dev/merkletree": "workspace:*",
+    "@thirdweb-dev/sdk": "workspace:*",
+    "@thirdweb-dev/storage": "workspace:*",
+    "@thirdweb-dev/wallets": "workspace:*"
+  },
+  "scripts": {
+    "e2e": "bun run.ts"
+  },
+  "devDependencies": {
+    "@swc/cli": "0.3.10",
+    "@swc/core": "^1.4.12",
+    "ora": "^6.3.1"
+  }
+}
@@ -0,0 +1,27 @@
+import { $ } from "bun";
+import fs from "node:fs/promises";
+import ora from "ora";
+
+const fixtures = await fs.readdir("./fixtures");
+
+const spinner = ora("Running fixtures: ").start();
+
+for (const fixture of fixtures) {
+  spinner.suffixText = fixture;
+  try {
+    await $`bunx swc fixtures/${fixture}`.text();
+  } catch (error) {
+    if (error.exitCode !== 0) {
+      console.error(error);
+      spinner.fail("Failed to run fixture: " + fixture);
+      // await fs.rm("./fixtures/index.html");
+
+      process.exit(1);
+    }
+  }
+}
+
+// await fs.rm("./fixtures/index.html");
+
+spinner.suffixText = "";
+spinner.succeed("All fixtures ran successfully");
@@ -0,0 +1,3 @@
+import { ThirdwebAuth } from "@thirdweb-dev/auth";
+
+new ThirdwebAuth();
@@ -0,0 +1,3 @@
+import { Ethereum, getChainBySlug } from "@thirdweb-dev/chains";
+
+getChainBySlug("ethereum");
@@ -0,0 +1,3 @@
+import { sha256 } from "@thirdweb-dev/crypto";
+
+sha256("hello world");
@@ -0,0 +1,3 @@
+import { MerkleTree } from "@thirdweb-dev/merkletree";
+
+new MerkleTree([]);
@@ -0,0 +1,3 @@
+import { ThirdwebSDK } from "@thirdweb-dev/sdk";
+
+new ThirdwebSDK(1);
@@ -0,0 +1,3 @@
+import { ThirdwebStorage } from "@thirdweb-dev/storage";
+
+new ThirdwebStorage();
@@ -0,0 +1,3 @@
+import { LocalWallet } from "@thirdweb-dev/wallets";
+
+new LocalWallet();
@@ -0,0 +1,20 @@
+{
+  "name": "bundlers-vite",
+  "private": true,
+  "dependencies": {
+    "@thirdweb-dev/auth": "workspace:*",
+    "@thirdweb-dev/chains": "workspace:*",
+    "@thirdweb-dev/crypto": "workspace:*",
+    "@thirdweb-dev/merkletree": "workspace:*",
+    "@thirdweb-dev/sdk": "workspace:*",
+    "@thirdweb-dev/storage": "workspace:*",
+    "@thirdweb-dev/wallets": "workspace:*"
+  },
+  "scripts": {
+    "e2e": "bun run.ts"
+  },
+  "devDependencies": {
+    "ora": "^6.3.1",
+    "vite": "^5.2.8"
+  }
+}
@@ -0,0 +1,39 @@
+import { $ } from "bun";
+import fs from "node:fs/promises";
+import ora from "ora";
+
+const fixtures = await fs.readdir("./fixtures");
+
+const spinner = ora("Running fixtures: ").start();
+
+for (const fixture of fixtures) {
+  spinner.suffixText = fixture;
+  try {
+    // write a basic template index.html file that includes the fixture
+    await fs.writeFile(
+      "./fixtures/index.html",
+      `<html>
+  <head>
+    <script type="module" src="./${fixture}"></script>
+  </head>
+</html>
+`,
+    );
+
+    await $`vite build fixtures/`.text();
+  } catch (error) {
+    if (error.exitCode !== 0) {
+      console.error(error);
+      spinner.fail("Failed to run fixture: " + fixture);
+      await fs.rm("./fixtures/index.html");
+      await fs.rmdir("./fixtures/dist", { recursive: true });
+      process.exit(1);
+    }
+  }
+}
+
+await fs.rm("./fixtures/index.html");
+await fs.rmdir("./fixtures/dist", { recursive: true });
+
+spinner.suffixText = "";
+spinner.succeed("All fixtures ran successfully");
@@ -0,0 +1,3 @@
+import { ThirdwebAuth } from "@thirdweb-dev/auth";
+
+new ThirdwebAuth();
@@ -0,0 +1,3 @@
+import { Ethereum, getChainBySlug } from "@thirdweb-dev/chains";
+
+getChainBySlug("ethereum");
@@ -0,0 +1,3 @@
+import { sha256 } from "@thirdweb-dev/crypto";
+
+sha256("hello world");
@@ -0,0 +1,3 @@
+import { MerkleTree } from "@thirdweb-dev/merkletree";
+
+new MerkleTree([]);
@@ -0,0 +1,3 @@
+import { ThirdwebSDK } from "@thirdweb-dev/sdk";
+
+new ThirdwebSDK(1);
@@ -0,0 +1,3 @@
+import { ThirdwebStorage } from "@thirdweb-dev/storage";
+
+new ThirdwebStorage();
@@ -0,0 +1,3 @@
+import { LocalWallet } from "@thirdweb-dev/wallets";
+
+new LocalWallet();
@@ -0,0 +1,21 @@
+{
+  "name": "bundlers-webpack",
+  "private": true,
+  "dependencies": {
+    "@thirdweb-dev/auth": "workspace:*",
+    "@thirdweb-dev/chains": "workspace:*",
+    "@thirdweb-dev/crypto": "workspace:*",
+    "@thirdweb-dev/merkletree": "workspace:*",
+    "@thirdweb-dev/sdk": "workspace:*",
+    "@thirdweb-dev/storage": "workspace:*",
+    "@thirdweb-dev/wallets": "workspace:*"
+  },
+  "scripts": {
+    "e2e": "bun run.ts"
+  },
+  "devDependencies": {
+    "ora": "^6.3.1",
+    "webpack": "^5.91.0",
+    "webpack-cli": "^5.1.4"
+  }
+}
@@ -0,0 +1,28 @@
+import { $ } from "bun";
+import fs from "node:fs/promises";
+import ora from "ora";
+
+const fixtures = await fs.readdir("./fixtures");
+
+const spinner = ora("Running fixtures: ").start();
+
+for (const fixture of fixtures) {
+  spinner.suffixText = fixture;
+  try {
+    await $`webpack build ./fixtures/${fixture} --mode=production`.text();
+  } catch (error) {
+    if (error.exitCode !== 0) {
+      console.error(error);
+
+      spinner.fail("Fixture failed:");
+
+      await fs.rmdir("./dist", { recursive: true });
+      process.exit(1);
+    }
+  }
+}
+
+await fs.rmdir("./dist", { recursive: true });
+
+spinner.suffixText = "";
+spinner.succeed("All fixtures ran successfully");
@@ -0,0 +1,3 @@
+const { ThirdwebAuth } = require("@thirdweb-dev/auth");
+
+new ThirdwebAuth();
@@ -0,0 +1,3 @@
+const { Ethereum, getChainBySlug } = require("@thirdweb-dev/chains");
+
+getChainBySlug("ethereum");
@@ -0,0 +1,3 @@
+const { sha256 } = require("@thirdweb-dev/crypto");
+
+sha256("hello world");
@@ -0,0 +1,3 @@
+const { MerkleTree } = require("@thirdweb-dev/merkletree");
+
+new MerkleTree([]);
@@ -0,0 +1,3 @@
+const { ThirdwebSDK } = require("@thirdweb-dev/sdk");
+
+new ThirdwebSDK(1);
@@ -0,0 +1,3 @@
+const { ThirdwebStorage } = require("@thirdweb-dev/storage");
+
+new ThirdwebStorage();
@@ -0,0 +1,3 @@
+const { LocalWallet } = require("@thirdweb-dev/wallets");
+
+new LocalWallet();
@@ -0,0 +1,20 @@
+{
+  "name": "runtimes-node-commonjs",
+  "private": true,
+  "type": "commonjs",
+  "dependencies": {
+    "@thirdweb-dev/auth": "workspace:*",
+    "@thirdweb-dev/chains": "workspace:*",
+    "@thirdweb-dev/crypto": "workspace:*",
+    "@thirdweb-dev/merkletree": "workspace:*",
+    "@thirdweb-dev/sdk": "workspace:*",
+    "@thirdweb-dev/storage": "workspace:*",
+    "@thirdweb-dev/wallets": "workspace:*"
+  },
+  "scripts": {
+    "e2e": "bun run.ts"
+  },
+  "devDependencies": {
+    "ora": "^6.3.1"
+  }
+}
@@ -0,0 +1,22 @@
+import { $ } from "bun";
+import fs from "node:fs/promises";
+import ora from "ora";
+
+const fixtures = await fs.readdir("./fixtures");
+
+const spinner = ora("Running fixtures: ").start();
+
+for (const fixture of fixtures) {
+  spinner.suffixText = fixture;
+  try {
+    await $`node fixtures/${fixture}`.text();
+  } catch (error) {
+    if (error.exitCode !== 0) {
+      console.error(error);
+      spinner.fail("Failed to run fixture: " + fixture);
+      process.exit(1);
+    }
+  }
+}
+
+spinner.succeed("All fixtures ran successfully");
@@ -0,0 +1,3 @@
+import { ThirdwebAuth } from "@thirdweb-dev/auth";
+
+new ThirdwebAuth();
@@ -0,0 +1,3 @@
+import { Ethereum, getChainBySlug } from "@thirdweb-dev/chains";
+
+getChainBySlug("ethereum");
@@ -0,0 +1,3 @@
+import { sha256 } from "@thirdweb-dev/crypto";
+
+sha256("hello world");
@@ -0,0 +1,3 @@
+import { MerkleTree } from "@thirdweb-dev/merkletree";
+
+new MerkleTree([]);
@@ -0,0 +1,3 @@
+import { ThirdwebSDK } from "@thirdweb-dev/sdk";
+
+new ThirdwebSDK(1);
@@ -0,0 +1,3 @@
+import { ThirdwebStorage } from "@thirdweb-dev/storage";
+
+new ThirdwebStorage();
@@ -0,0 +1,3 @@
+import { LocalWallet } from "@thirdweb-dev/wallets";
+
+new LocalWallet();
@@ -0,0 +1,20 @@
+{
+  "name": "runtimes-node-module",
+  "private": true,
+  "type": "module",
+  "dependencies": {
+    "@thirdweb-dev/auth": "workspace:*",
+    "@thirdweb-dev/chains": "workspace:*",
+    "@thirdweb-dev/crypto": "workspace:*",
+    "@thirdweb-dev/merkletree": "workspace:*",
+    "@thirdweb-dev/sdk": "workspace:*",
+    "@thirdweb-dev/storage": "workspace:*",
+    "@thirdweb-dev/wallets": "workspace:*"
+  },
+  "scripts": {
+    "e2e": "bun run.ts"
+  },
+  "devDependencies": {
+    "ora": "^6.3.1"
+  }
+}
@@ -0,0 +1,22 @@
+import { $ } from "bun";
+import fs from "node:fs/promises";
+import ora from "ora";
+
+const fixtures = await fs.readdir("./fixtures");
+
+const spinner = ora("Running fixtures: ").start();
+
+for (const fixture of fixtures) {
+  spinner.suffixText = fixture;
+  try {
+    await $`node fixtures/${fixture}`.text();
+  } catch (error) {
+    if (error.exitCode !== 0) {
+      console.error(error);
+      spinner.fail("Failed to run fixture: " + fixture);
+      process.exit(1);
+    }
+  }
+}
+
+spinner.succeed("All fixtures ran successfully");
@@ -0,0 +1,38 @@
+<p align="center">
+<br />
+<a href="https://thirdweb.com"><img src="https://github.com/thirdweb-dev/js/blob/main/legacy_packages/sdk/logo.svg?raw=true" width="200" alt=""/></a>
+<br />
+</p>
+<h1 align="center">thirdweb Auth</h1>
+<p align="center">
+<a href="https://www.npmjs.com/package/@thirdweb-dev/auth"><img src="https://img.shields.io/npm/v/@thirdweb-dev/auth?color=red&label=npm&logo=npm" alt="npm version"/></a>
+<a href="https://github.com/thirdweb-dev/js/actions/workflows/build-test-lint.yml"><img alt="Build Status" src="https://github.com/thirdweb-dev/js/actions/workflows/build-test-lint.yml/badge.svg"/></a>
+<a href="https://discord.gg/thirdweb"><img alt="Join our Discord!" src="https://img.shields.io/discord/834227967404146718.svg?color=7289da&label=discord&logo=discord&style=flat"/></a>
+
+</p>
+<p align="center"><strong>Best in class wallet authentication for Node backends</strong></p>
+<br />
+
+## Overview
+
+Auth is a developer SDK that lets you integrate passwordless web3-native authentication and authorization into your applications.
+
+It enables users to sign in with their wallets, allowing apps to access rich blockchain-level data and interact with their users on-chain.
+
+With Auth, developers can build applications that have secure, self-custodied, web3-first authentication.
+
+## Installation
+
+Install the latest version of the SDK with either `npm` or `yarn`:
+
+```shell
+npm install @thirdweb-dev/auth
+```
+
+```shell
+yarn add @thirdweb-dev/auth
+```
+
+## Resources
+
+- Check out the [Auth Documentation](https://portal.thirdweb.com/auth) for full guides and API references on how to use Auth.
@@ -0,0 +1,147 @@
+{
+  "name": "@thirdweb-dev/auth",
+  "version": "4.1.60",
+  "main": "dist/thirdweb-dev-auth.cjs.js",
+  "module": "dist/thirdweb-dev-auth.esm.js",
+  "browser": {
+    "./dist/thirdweb-dev-auth.esm.js": "./dist/thirdweb-dev-auth.browser.esm.js"
+  },
+  "exports": {
+    ".": {
+      "module": {
+        "browser": "./dist/thirdweb-dev-auth.browser.esm.js",
+        "default": "./dist/thirdweb-dev-auth.esm.js"
+      },
+      "default": "./dist/thirdweb-dev-auth.cjs.js"
+    },
+    "./evm": {
+      "module": {
+        "browser": "./evm/dist/thirdweb-dev-auth-evm.browser.esm.js",
+        "default": "./evm/dist/thirdweb-dev-auth-evm.esm.js"
+      },
+      "default": "./evm/dist/thirdweb-dev-auth-evm.cjs.js"
+    },
+    "./next": {
+      "module": {
+        "browser": "./next/dist/thirdweb-dev-auth-next.browser.esm.js",
+        "default": "./next/dist/thirdweb-dev-auth-next.esm.js"
+      },
+      "default": "./next/dist/thirdweb-dev-auth-next.cjs.js"
+    },
+    "./express": {
+      "module": {
+        "browser": "./express/dist/thirdweb-dev-auth-express.browser.esm.js",
+        "default": "./express/dist/thirdweb-dev-auth-express.esm.js"
+      },
+      "default": "./express/dist/thirdweb-dev-auth-express.cjs.js"
+    },
+    "./fastify": {
+      "module": {
+        "browser": "./fastify/dist/thirdweb-dev-auth-fastify.browser.esm.js",
+        "default": "./fastify/dist/thirdweb-dev-auth-fastify.esm.js"
+      },
+      "default": "./fastify/dist/thirdweb-dev-auth-fastify.cjs.js"
+    },
+    "./next-auth": {
+      "module": {
+        "browser": "./next-auth/dist/thirdweb-dev-auth-next-auth.browser.esm.js",
+        "default": "./next-auth/dist/thirdweb-dev-auth-next-auth.esm.js"
+      },
+      "default": "./next-auth/dist/thirdweb-dev-auth-next-auth.cjs.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "repository": "https://github.com/thirdweb-dev/js/tree/main/legacy_packages/auth",
+  "author": "thirdweb eng <[email protected]>",
+  "license": "Apache-2.0",
+  "sideEffects": false,
+  "scripts": {
+    "build": "preconstruct build",
+    "format": "prettier --write 'src/**/*'",
+    "lint": "eslint src/",
+    "fix": "eslint src/ --fix",
+    "clean": "rm -rf dist/ && rm -rf node_modules/",
+    "test": "vitest run",
+    "push": "yalc push"
+  },
+  "preconstruct": {
+    "entrypoints": [
+      "index.ts",
+      "express/index.ts",
+      "next/index.ts",
+      "next-auth/index.ts",
+      "fastify/index.ts",
+      "evm/index.ts"
+    ],
+    "exports": {
+      "envConditions": [
+        "browser"
+      ]
+    }
+  },
+  "devDependencies": {
+    "@microsoft/api-documenter": "^7.24.1",
+    "@microsoft/api-extractor": "^7.43.0",
+    "@microsoft/tsdoc": "^0.14.2",
+    "@preconstruct/cli": "2.7.0",
+    "@swc-node/register": "^1.9.0",
+    "@swc/core": "^1.4.12",
+    "@thirdweb-dev/tsconfig": "workspace:*",
+    "@types/cookie": "^0.6.0",
+    "@types/cookie-parser": "^1.4.7",
+    "@types/express": "^4.17.21",
+    "@types/uuid": "^9.0.8",
+    "cookie-parser": "^1.4.6",
+    "eslint": "8.57.0",
+    "eslint-config-thirdweb": "workspace:*",
+    "eslint-plugin-import": "^2.29.1",
+    "eslint-plugin-inclusive-language": "^2.2.1",
+    "eslint-plugin-prettier": "^5.1.3",
+    "eslint-plugin-tsdoc": "^0.2.17",
+    "ethers": "^5.7.2",
+    "express": "^4.19.2",
+    "fastify": "^4.26.2",
+    "next": "^13.5.6",
+    "next-auth": "^4.24.7",
+    "typescript": "5.4.4"
+  },
+  "peerDependencies": {
+    "cookie-parser": "^1.4.6",
+    "ethers": "^5",
+    "express": "^4",
+    "fastify": "^4.25.2",
+    "next": "^13.4 || ^14",
+    "next-auth": "^4"
+  },
+  "peerDependenciesMeta": {
+    "cookie-parser": {
+      "optional": true
+    },
+    "ethers": {
+      "optional": true
+    },
+    "express": {
+      "optional": true
+    },
+    "fastify": {
+      "optional": true
+    },
+    "next": {
+      "optional": true
+    },
+    "next-auth": {
+      "optional": true
+    }
+  },
+  "dependencies": {
+    "@fastify/cookie": "^9.3.1",
+    "@thirdweb-dev/wallets": "workspace:*",
+    "cookie": "^0.6.0",
+    "fastify-type-provider-zod": "^1.1.9",
+    "uuid": "^9.0.1",
+    "zod": "^3.22.4"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}
@@ -0,0 +1,127 @@
+import {
+  authenticateJWT,
+  generateJWT,
+  parseJWT,
+  refreshJWT,
+} from "./functions/jwt";
+import {
+  buildAndSignLoginPayload,
+  buildLoginPayload,
+  signLoginPayload,
+  verifyLoginPayload,
+} from "./functions/login";
+import type { GenericAuthWallet } from "@thirdweb-dev/wallets";
+import { Json, User } from "./schema/common";
+import {
+  LoginOptionsWithOptionalDomain,
+  LoginPayload,
+  LoginPayloadData,
+} from "./schema/login";
+import { VerifyOptionsWithOptionalDomain } from "./schema/verify";
+import { GenerateOptionsWithOptionalDomain } from "./schema/generate";
+import {
+  AuthenticateOptionsWithOptionalDomain,
+  AuthenticationPayload,
+} from "./schema/authenticate";
+import { ThirdwebAuthOptions } from "./types";
+
+export class ThirdwebAuth {
+  private domain: string;
+  private wallet: GenericAuthWallet;
+  private options: ThirdwebAuthOptions;
+
+  constructor(
+    wallet: GenericAuthWallet,
+    domain: string,
+    options: ThirdwebAuthOptions = {},
+  ) {
+    this.wallet = wallet;
+    this.domain = domain;
+    this.options = options;
+  }
+
+  public updateWallet(wallet: GenericAuthWallet) {
+    this.wallet = wallet;
+  }
+
+  public async payload(
+    options?: LoginOptionsWithOptionalDomain,
+  ): Promise<LoginPayloadData> {
+    return buildLoginPayload({
+      wallet: this.wallet,
+      options: this.formatOptions(options),
+    });
+  }
+
+  public async loginWithPayload(
+    payload: LoginPayloadData,
+  ): Promise<LoginPayload> {
+    return signLoginPayload({ wallet: this.wallet, payload });
+  }
+
+  public async login(
+    options?: LoginOptionsWithOptionalDomain,
+  ): Promise<LoginPayload> {
+    return buildAndSignLoginPayload({
+      wallet: this.wallet,
+      options: this.formatOptions(options),
+    });
+  }
+
+  public async verify(
+    payload: LoginPayload,
+    options?: VerifyOptionsWithOptionalDomain,
+  ): Promise<string> {
+    return verifyLoginPayload({
+      payload,
+      options: this.formatOptions(options),
+      clientOptions: this.options,
+    });
+  }
+
+  public async generate(
+    payload: LoginPayload,
+    options?: GenerateOptionsWithOptionalDomain,
+  ): Promise<string> {
+    return generateJWT({
+      wallet: this.wallet,
+      payload,
+      options: this.formatOptions(options),
+      clientOptions: this.options,
+    });
+  }
+
+  public async refresh(jwt: string, expirationTime?: Date): Promise<string> {
+    return refreshJWT({
+      wallet: this.wallet,
+      jwt,
+      options: { expirationTime },
+    });
+  }
+
+  public async authenticate<TSession extends Json = Json>(
+    jwt: string,
+    options?: AuthenticateOptionsWithOptionalDomain,
+  ): Promise<User<TSession>> {
+    return authenticateJWT({
+      wallet: this.wallet,
+      jwt,
+      options: this.formatOptions(options),
+      clientOptions: this.options,
+    });
+  }
+
+  public parseToken(jwt: string): AuthenticationPayload {
+    return parseJWT(jwt);
+  }
+
+  private formatOptions<TOptions extends { domain?: string }>(
+    options?: TOptions,
+  ): Omit<TOptions, "domain"> & { domain: string } {
+    return options
+      ? { ...options, domain: options?.domain || this.domain }
+      : ({ domain: this.domain } as Omit<TOptions, "domain"> & {
+          domain: string;
+        });
+  }
+}
@@ -14,6 +14,7 @@ import {
 import { GenerateOptionsSchema } from "../schema/generate";
 import { RefreshOptionsSchema } from "../schema/refresh";
 import { verifyLoginPayload } from "./login";
+import { verifySignature } from "./verify-signature";

 function isBrowser() {
  return typeof window !== "undefined";
@@ -71,15 +72,16 @@ export async function generateJWT({
  wallet,
  payload,
  options,
+  clientOptions,
 }: GenerateJwtParams): Promise<string> {
  const parsedOptions = GenerateOptionsSchema.parse(options);
  const userAddress = await verifyLoginPayload({
-    wallet,
    payload,
    options: {
      domain: parsedOptions.domain,
      ...parsedOptions.verifyOptions,
    },
+    clientOptions,
  });

  let session: Json | undefined = undefined;
@@ -156,6 +158,7 @@ export async function authenticateJWT<TSession extends Json = Json>({
  wallet,
  jwt,
  options,
+  clientOptions,
 }: AuthenticateJwtParams): Promise<User<TSession>> {
  const parsedOptions = AuthenticateOptionsSchema.parse(options);
  const { payload, signature } = parseJWT(jwt);
@@ -210,11 +213,13 @@ export async function authenticateJWT<TSession extends Json = Json>({
    }
  }

-  const verified = await wallet.verifySignature(
+  const verified = await verifySignature(
    JSON.stringify(payload),
    signature,
    issuerAddress,
    chainId,
+    clientOptions.clientId,
+    clientOptions.secretKey,
  );
  if (!verified) {
    throw new Error(
@@ -0,0 +1,222 @@
+import {
+  BuildLoginPayloadParams,
+  SignLoginPayloadParams,
+  VerifyLoginPayloadParams,
+} from "../schema/functions";
+import {
+  LoginOptionsSchema,
+  LoginPayload,
+  LoginPayloadData,
+  LoginPayloadDataSchema,
+} from "../schema/login";
+import { VerifyOptionsSchema } from "../schema/verify";
+import { verifySignature } from "./verify-signature";
+
+/**
+ * Create an EIP-4361 & CAIP-122 compliant message to sign based on the login payload
+ */
+function createLoginMessage(payload: LoginPayloadData): string {
+  const typeField = "Ethereum";
+  const header = `${payload.domain} wants you to sign in with your ${typeField} account:`;
+  let prefix = [header, payload.address].join("\n");
+  prefix = [prefix, payload.statement].join("\n\n");
+  if (payload.statement) {
+    prefix += "\n";
+  }
+
+  const suffixArray = [];
+  if (payload.uri) {
+    const uriField = `URI: ${payload.uri}`;
+    suffixArray.push(uriField);
+  }
+
+  const versionField = `Version: ${payload.version}`;
+  suffixArray.push(versionField);
+
+  if (payload.chain_id) {
+    const chainField = `Chain ID: ` + payload.chain_id || "1";
+    suffixArray.push(chainField);
+  }
+
+  const nonceField = `Nonce: ${payload.nonce}`;
+  suffixArray.push(nonceField);
+
+  const issuedAtField = `Issued At: ${payload.issued_at}`;
+  suffixArray.push(issuedAtField);
+
+  const expiryField = `Expiration Time: ${payload.expiration_time}`;
+  suffixArray.push(expiryField);
+
+  if (payload.invalid_before) {
+    const invalidBeforeField = `Not Before: ${payload.invalid_before}`;
+    suffixArray.push(invalidBeforeField);
+  }
+
+  if (payload.resources) {
+    suffixArray.push(
+      [`Resources:`, ...payload.resources.map((x) => `- ${x}`)].join("\n"),
+    );
+  }
+
+  const suffix = suffixArray.join("\n");
+  return [prefix, suffix].join("\n");
+}
+
+export async function buildLoginPayload({
+  wallet,
+  options,
+}: BuildLoginPayloadParams): Promise<LoginPayloadData> {
+  const parsedOptions = LoginOptionsSchema.parse(options);
+
+  let chainId: string | undefined = parsedOptions?.chainId;
+  if (!chainId && wallet.getChainId) {
+    try {
+      chainId = (await wallet.getChainId()).toString();
+    } catch {
+      // ignore error
+    }
+  }
+
+  return LoginPayloadDataSchema.parse({
+    type: wallet.type,
+    domain: parsedOptions.domain,
+    address: parsedOptions?.address || (await wallet.getAddress()),
+    statement: parsedOptions?.statement,
+    version: parsedOptions?.version,
+    uri: parsedOptions?.uri,
+    chain_id: chainId,
+    nonce: parsedOptions?.nonce,
+    expiration_time: parsedOptions.expirationTime,
+    invalid_before: parsedOptions.invalidBefore,
+    resources: parsedOptions?.resources,
+  });
+}
+
+export async function signLoginPayload({
+  wallet,
+  payload,
+}: SignLoginPayloadParams): Promise<LoginPayload> {
+  const message = createLoginMessage(payload);
+  const signature = await wallet.signMessage(message);
+
+  return {
+    payload,
+    signature,
+  };
+}
+
+export async function buildAndSignLoginPayload({
+  wallet,
+  options,
+}: BuildLoginPayloadParams): Promise<LoginPayload> {
+  const payload = await buildLoginPayload({ wallet, options });
+  return signLoginPayload({ wallet, payload });
+}
+
+export async function verifyLoginPayload({
+  payload,
+  options,
+  clientOptions,
+}: VerifyLoginPayloadParams): Promise<string> {
+  const parsedOptions = VerifyOptionsSchema.parse(options);
+
+  // Check that the intended domain matches the domain of the payload
+  if (payload.payload.domain !== parsedOptions.domain) {
+    throw new Error(
+      `Expected domain '${parsedOptions.domain}' does not match domain on payload '${payload.payload.domain}'`,
+    );
+  }
+
+  // Check that the payload statement matches the expected statement
+  if (parsedOptions?.statement) {
+    if (payload.payload.statement !== parsedOptions.statement) {
+      throw new Error(
+        `Expected statement '${parsedOptions.statement}' does not match statement on payload '${payload.payload.statement}'`,
+      );
+    }
+  }
+
+  // Check that the intended URI matches the URI of the payload
+  if (parsedOptions?.uri) {
+    if (payload.payload.uri !== parsedOptions.uri) {
+      throw new Error(
+        `Expected URI '${parsedOptions.uri}' does not match URI on payload '${payload.payload.uri}'`,
+      );
+    }
+  }
+
+  // Check that the intended version matches the version of the payload
+  if (parsedOptions?.version) {
+    if (payload.payload.version !== parsedOptions.version) {
+      throw new Error(
+        `Expected version '${parsedOptions.version}' does not match version on payload '${payload.payload.version}'`,
+      );
+    }
+  }
+
+  // Check that the intended chain ID matches the chain ID of the payload
+  if (parsedOptions?.chainId) {
+    if (payload.payload.chain_id !== parsedOptions.chainId) {
+      throw new Error(
+        `Expected chain ID '${parsedOptions.chainId}' does not match chain ID on payload '${payload.payload.chain_id}'`,
+      );
+    }
+  }
+
+  // Check that the payload nonce is valid
+  if (parsedOptions?.validateNonce !== undefined) {
+    try {
+      await parsedOptions.validateNonce(payload.payload.nonce);
+    } catch (err) {
+      throw new Error(`Login request nonce is invalid`);
+    }
+  }
+
+  // Check that it isn't before the invalid before time
+  const currentTime = new Date();
+  if (currentTime < new Date(payload.payload.invalid_before)) {
+    throw new Error(`Login request is not yet valid`);
+  }
+
+  // Check that the payload hasn't expired
+  if (currentTime > new Date(payload.payload.expiration_time)) {
+    throw new Error(`Login request has expired`);
+  }
+
+  // Check that the specified resources are present on the payload
+  if (parsedOptions?.resources) {
+    const missingResources = parsedOptions.resources.filter(
+      (resource) => !payload.payload.resources?.includes(resource),
+    );
+    if (missingResources.length > 0) {
+      throw new Error(
+        `Login request is missing required resources: ${missingResources.join(
+          ", ",
+        )}`,
+      );
+    }
+  }
+
+  // Check that the signing address is the claimed wallet address
+  const message = createLoginMessage(payload.payload);
+  const chainId = payload.payload.chain_id
+    ? parseInt(payload.payload.chain_id)
+    : undefined;
+
+  const verified = await verifySignature(
+    message,
+    payload.signature,
+    payload.payload.address,
+    chainId,
+    clientOptions?.clientId,
+    clientOptions?.secretKey,
+  );
+
+  if (!verified) {
+    throw new Error(
+      `Signer address does not match payload address '${payload.payload.address.toLowerCase()}'`,
+    );
+  }
+
+  return payload.payload.address;
+}
@@ -0,0 +1,35 @@
+import { checkContractWalletSignature } from "@thirdweb-dev/wallets";
+import { utils } from "ethers";
+
+export async function verifySignature(
+  message: string,
+  signature: string,
+  address: string,
+  chainId?: number,
+  clientId?: string,
+  secretKey?: string,
+): Promise<boolean> {
+  try {
+    const messageHash = utils.hashMessage(message);
+    const messageHashBytes = utils.arrayify(messageHash);
+    const recoveredAddress = utils.recoverAddress(messageHashBytes, signature);
+
+    if (recoveredAddress === address) {
+      return true;
+    }
+  } catch {
+    // no-op
+  }
+
+  if (!chainId) {
+    return false;
+  }
+  return checkContractWalletSignature(
+    message,
+    signature,
+    address,
+    chainId,
+    clientId,
+    secretKey,
+  );
+}
@@ -7,6 +7,7 @@ import {
 } from "./authenticate";
 import { RefreshOptions } from "./refresh";
 import { GenerateOptions } from "./generate";
+import { ThirdwebAuthOptions } from "../types";

 export type BuildLoginPayloadParams = {
  wallet: GenericAuthWallet;
@@ -19,9 +20,9 @@ export type SignLoginPayloadParams = {
 };

 export type VerifyLoginPayloadParams = {
-  wallet: GenericAuthWallet;
  payload: LoginPayload;
  options: VerifyOptions;
+  clientOptions: ThirdwebAuthOptions;
 };

 export type BuildJwtParams = {
@@ -33,6 +34,7 @@ export type GenerateJwtParams = {
  wallet: GenericAuthWallet;
  payload: LoginPayload;
  options: GenerateOptions;
+  clientOptions: ThirdwebAuthOptions;
 };

 export type RefreshJwtParams = {
@@ -45,4 +47,5 @@ export type AuthenticateJwtParams = {
  wallet: GenericAuthWallet;
  jwt: string;
  options: AuthenticateOptions;
+  clientOptions: ThirdwebAuthOptions;
 };
--- a/Show More
+++ b/Show More