Version Packages (#2633 )

fix(adapters): sendTransaction within viemAdapter.walletClient.toViem() (#2662 )
chore: Add job name for build step (#2665 )
2024-04-02 22:58:28 -07:00 · 2024-04-02 19:41:42 -07:00 · 2024-04-02 19:38:04 -07:00 · 2024-04-02 19:32:57 -07:00 · 2024-04-03 02:28:04 +00:00 · 2024-04-03 02:27:56 +00:00
6245 changed files with 361995 additions and 129173 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,48 @@

 # Platform team owns everything by default

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

-# Devrel owns all markdown files (README etc.)
+# legacy packages
+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 @jnsdls
+legacy_packages/storage/ @jnsdls
+legacy_packages/wallets/ @MananTank @jnsdls

-*.md @thirdweb-dev/devrel
-.changeset/

-# Shared ownership of the react and react-core packages
+# legacy e2e
+legacy_e2e/ @jnsdls

-packages/react/ @thirdweb-dev/product @thirdweb-dev/platform
-packages/react-core/ @thirdweb-dev/product @thirdweb-dev/platform
+# packages

-# Shared ownership of the CLI
+## specific thirdweb pieces
+packages/thirdweb/src/react/ @MananTank
+packages/thirdweb/src/reactive/ @MananTank
+packages/thirdweb/src/gas/ @joaquim
+packages/thirdweb/src/pay/ @MananTank @IDubuque

-packages/cli/ @thirdweb-dev/product @thirdweb-dev/platform
+packages/typedoc-gen/ @MananTank
+# owned by phil for now
+packages/service-utils/ @arcoraven
+packages/eslint-config-thirdweb/ @jnsdls
+packages/tw-tsconfig/ @jnsdls
+packages/unity-js-bridge/ @joaquim @0xFirekeeper

-# Chains is owned specifically by jonas for now

-packages/chains/ @jnsdls
-
-# .github folder + .changeset + turbo config is owned by joaquim and jonas for now
-
-.github/ @jnsdls @joaquim-verges
-.changeset/config.json @jnsdls @joaquim-verges
-turbo.json @joaquim-verges @jnsdls
+# .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: 16
+        node-version: 20
+        check-latest: true
        registry-url: "https://registry.npmjs.org"
        cache: "pnpm"

@@ -22,14 +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>                           |
-| [/solana](./packages/solana)   | Solana SDK for Browser, Node and React Native                        | <a href="https://www.npmjs.com/package/@thirdweb-dev/solana"><img src="https://img.shields.io/npm/v/@thirdweb-dev/solana?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

@@ -107,6 +106,27 @@ In your test project, you need to:
 1. Delete the dependencies cache. If you're using Next.js, that is the `.next` directory, and if you're using CRA, that is the `node_modules/.cache` directory.
 2. Restart the development server.

+#### Testing from npm
+
+You can also test your changes by publishing a dev package to npm and adding your package as you normally do in your projects.
+
+Once you have your PR up you can add a comment with the text: `/release-pr`. This will trigger a GitHub action that will publish a dev version to npm.
+
+You can see the action progress in GitHub's `Actions` tab, look for the workflow: `release-pr`.
+
+Once the action finishes executing, select it, click on deploy and look for the `Deploy pre-release` item. Scroll all the way to the bottom and you should see something like:
+
+```
+success packages published successfully:
+🦋  @***-dev/[email protected]
+🦋  @***-dev/[email protected]
+...
+```
+
+These are the versions the GH action published to npm for testing purposes. Let's assume you're working on the `@thirdweb-dev/react` package, you can then run:
+
+`yarn add @thirdweb-dev/react@0.0.0-dev-06a7cb1-20230901190619` to install the dev package.
+
 <br/>

 ### Publish Your Changes
@@ -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,109 @@
+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
+
+      - 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
+
+  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"
@@ -0,0 +1,96 @@
+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
+
+  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: 16
-          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: 16
-          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,./packages/sdk/coverage/solana/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: 16
-          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 }}
@@ -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.2.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 }}
@@ -0,0 +1,57 @@
+name: Sync chains every hour
+
+on:
+  schedule:
+    - cron: "0 * * * *" # Runs every hour
+  workflow_dispatch: # Allows you to manually run the workflow from the Actions tab
+
+jobs:
+  sync-chains:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout Repository
+        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: ./legacy_packages/chains
+
+      - name: Check for Changes
+        id: git-check
+        run: |
+          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.CHANGES_FOUND == 'true'
+        run: |
+          git config --local user.email "[email protected]"
+          git config --local user.name "GitHub Action"
+          git add -A
+          git commit -m "chore(chains): sync from db"
+
+      - name: Create or Update Pull Request
+        if: env.CHANGES_FOUND == 'true'
+        uses: peter-evans/create-pull-request@v6
+        with:
+          title: "chore(chains): update chains"
+          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,7 +10,7 @@ dist-ssr
 .cache
 server/dist
 public/dist
-./packages/contracts-js/abis
+./legacy_packages/contracts-js/abis
 .idea/
 .yalc/
 yalc.lock
@@ -20,4 +20,4 @@ playwright-report/
 .env/

 # Artifacts
-packages/cli/artifacts/
+legacy_packages/cli/artifacts/
@@ -1 +1 @@
-16
+20
@@ -1,11 +1,11 @@
 <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">
@@ -16,36 +16,55 @@
    </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>                   |
-| [/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>                                     |
+- 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,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.11",
+    "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.7"
+  }
+}
@@ -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,7 @@
+{
+  "main": "dist/thirdweb-dev-auth-fastify.cjs.js",
+  "module": "dist/thirdweb-dev-auth-fastify.esm.js",
+  "browser": {
+    "./dist/thirdweb-dev-auth-fastify.esm.js": "./dist/thirdweb-dev-auth-fastify.browser.esm.js"
+  }
+}
@@ -0,0 +1,147 @@
+{
+  "name": "@thirdweb-dev/auth",
+  "version": "4.1.54",
+  "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",
+    "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.11",
+    "@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.3"
+  },
+  "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";
@@ -38,7 +39,10 @@ function base64decode(data: string): string {
 /**
 * Build JWT token based on the authentication payload
 */
-async function buildJWT({ wallet, payload }: BuildJwtParams): Promise<string> {
+export async function buildJWT({
+  wallet,
+  payload,
+}: BuildJwtParams): Promise<string> {
  const payloadData = AuthenticationPayloadDataSchema.parse(payload);

  const message = JSON.stringify(payloadData);
@@ -68,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;
@@ -153,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);
@@ -207,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,
+  );
+}
@@ -0,0 +1,26 @@
+// Export thirdweb auth class
+export { ThirdwebAuth } from "./auth";
+
+// Export individual auth functions
+export {
+  buildJWT,
+  generateJWT,
+  parseJWT,
+  refreshJWT,
+  authenticateJWT,
+} from "./functions/jwt";
+export {
+  buildLoginPayload,
+  signLoginPayload,
+  buildAndSignLoginPayload,
+  verifyLoginPayload,
+} from "./functions/login";
+
+// Export schema files individually
+export * from "./schema/authenticate";
+export * from "./schema/common";
+export * from "./schema/functions";
+export * from "./schema/generate";
+export * from "./schema/login";
+export * from "./schema/refresh";
+export * from "./schema/verify";
@@ -9,7 +9,7 @@ export const AuthenticationPayloadDataSchema = z.object({
  exp: RawDateSchema,
  nbf: RawDateSchema,
  iat: RawDateSchema,
-  jti: z.string().default(uuidv4()),
+  jti: z.string().default(() => uuidv4()),
  ctx: JsonSchema.optional(),
 });

@@ -0,0 +1,31 @@
+import { utils } from "ethers";
+import { z } from "zod";
+
+const literalSchema = z.union([z.string(), z.number(), z.boolean(), z.null()]);
+type Literal = z.infer<typeof literalSchema>;
+export type Json = Literal | { [key: string]: Json } | Json[];
+
+export const JsonSchema: z.ZodType<Json> = z.lazy(
+  () => z.union([literalSchema, z.array(JsonSchema), z.record(JsonSchema)]),
+  { invalid_type_error: "Provided value was not valid JSON" },
+);
+
+export const AddressSchema = z.string().refine(
+  (arg) => utils.isAddress(arg),
+  (out) => {
+    return {
+      message: `${out} is not a valid address`,
+    };
+  },
+);
+
+export const RawDateSchema = z.date().transform((i) => {
+  return Math.floor(i.getTime() / 1000);
+});
+
+export const AccountTypeSchema = z.literal("evm");
+
+export type User<TContext extends Json = Json> = {
+  address: string;
+  session?: TContext;
+};
@@ -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;
 };
@@ -0,0 +1,81 @@
+import { z } from "zod";
+import { v4 as uuidv4 } from "uuid";
+import { AccountTypeSchema } from "./common";
+import { THIRDWEB_AUTH_DEFAULT_LOGIN_PAYLOAD_DURATION_IN_SECONDS } from "../../constants";
+
+export const LoginOptionsSchema = z.object({
+  domain: z.string(),
+  address: z.string().optional(),
+  statement: z.string().optional(),
+  uri: z.string().optional(),
+  version: z.string().optional(),
+  chainId: z.string().optional(),
+  nonce: z.string().optional(),
+  expirationTime: z
+    .date()
+    .default(
+      () =>
+        new Date(
+          Date.now() +
+            1000 * THIRDWEB_AUTH_DEFAULT_LOGIN_PAYLOAD_DURATION_IN_SECONDS,
+        ),
+    ),
+  invalidBefore: z
+    .date()
+    .default(
+      () =>
+        new Date(
+          Date.now() -
+            1000 * THIRDWEB_AUTH_DEFAULT_LOGIN_PAYLOAD_DURATION_IN_SECONDS,
+        ),
+    ),
+  resources: z.array(z.string()).optional(),
+});
+
+export const LoginPayloadDataSchema = z.object({
+  type: AccountTypeSchema,
+  domain: z.string(),
+  address: z.string(),
+  statement: z
+    .string()
+    .default(
+      "Please ensure that the domain above matches the URL of the current website.",
+    ),
+  uri: z.string().optional(),
+  version: z.string().default("1"),
+  chain_id: z.string().optional(),
+  nonce: z.string().default(() => uuidv4()),
+  issued_at: z
+    .date()
+    .default(new Date())
+    .transform((d) => d.toISOString()),
+  expiration_time: z.date().transform((d) => d.toISOString()),
+  invalid_before: z
+    .date()
+    .default(new Date())
+    .transform((d) => d.toISOString()),
+  resources: z.array(z.string()).optional(),
+});
+
+export const LoginPayloadSchema = z.object({
+  payload: LoginPayloadDataSchema,
+  signature: z.string(),
+});
+
+export const LoginPayloadOutputSchema = LoginPayloadSchema.extend({
+  payload: LoginPayloadDataSchema.extend({
+    issued_at: z.string(),
+    expiration_time: z.string(),
+    invalid_before: z.string(),
+  }),
+});
+
+export type LoginOptions = z.input<typeof LoginOptionsSchema>;
+
+export type LoginPayloadData = z.output<typeof LoginPayloadDataSchema>;
+
+export type LoginPayload = z.output<typeof LoginPayloadSchema>;
+
+export type LoginOptionsWithOptionalDomain = Omit<LoginOptions, "domain"> & {
+  domain?: string;
+};
@@ -0,0 +1,4 @@
+export type ThirdwebAuthOptions = {
+  clientId?: string;
+  secretKey?: string;
+};
--- a/Show More
+++ b/Show More