zod 4 compatibility with clerk-js/clerk-expo

[gorbypark]

Preliminary Checks

• I have reviewed the documentation: https://clerk.com/docs

• I have searched for existing issues: https://github.com/clerk/javascript/issues

• I have not already reached out to Clerk support via email or Discord (if you have, no need to open an issue here)

• This issue is not a question, general help request, or anything other than a bug report directly related to Clerk. Please ask questions in our Discord community: https://clerk.com/discord.

Reproduction

.

Publishable key

.

Description

Steps to reproduce:

1. Install zod 4
2. See type errors

Expected behavior:

Clerk should not dictate which version of zod can be used in a project because of some deeply nested dependency on Etherium type checking packages.

Actual behavior:

Apparently Clerk has some crypto wallet features that depend on zod 3.x (abitype, viem). I would like to use zod 4 in my project and not resort to package.json resolutions for features not used / even know about by 99.9% of developers who just want the nice authentication features of Clerk.

error "abitype#zod@^3 >=3.22.0" doesn't satisfy found match of "zod@4.1.5"
error "viem#abitype#zod@^3 >=3.22.0" doesn't satisfy found match of "zod@4.1.5"
error "viem#ox#abitype#zod@^3 >=3.22.0" doesn't satisfy found match of "zod@4.1.5"
error Found 3 errors.

Notes:
This is using the clerk/clerk-expo package, which I assume is pulling in clerk/clerk-js, which in turn is pulling in the Etherium related packages.

Environment

System:
    OS: macOS 15.4.1
    CPU: (8) arm64 Apple M2
    Memory: 63.81 MB / 24.00 GB
    Shell: 5.9 - /bin/zsh
  Binaries:
    Node: 22.18.0 - /opt/homebrew/opt/node@22/bin/node
    Yarn: 1.22.22 - /opt/homebrew/bin/yarn
    npm: 10.9.3 - /opt/homebrew/opt/node@22/bin/npm
    pnpm: 10.14.0 - /opt/homebrew/bin/pnpm
    Watchman: 2025.08.04.00 - /opt/homebrew/bin/watchman
  Browsers:
    Chrome: 139.0.7258.155
    Edge: 139.0.3405.125
    Safari: 18.4

[wobsoriano]

Hi @gorbypark,

Thanks for reporting this issue! Even though we lazily import @base-org/account (which keeps it out of the main bundle), it still needs to be listed as a dependency because we need it at runtime to use Base wallet features.

I've opened PRs] to the abitype and viem repos to support both Zod 3 and 4 in their peer dependencies. It should not be breaking on their side and hopefully it gets reviewed 🤞🏼

I'll update this issue once the abitype PR gets merged and we can update our dependencies. Thanks for your patience!

[wobsoriano]

Hello! Both of the PRs above have been merged and published. The key fix is that abitype@1.1.0 (which viem@2.37.3 depends on) now supports both zod v3 and v4 in its peer dependencies (changed from ^3 >=3.22.0 to ^3.22.0 || ^4.0.0). Your package manager will now install viem@2.37.3 which is compatible with zod 4. 👍🏼

[gorbypark]

Thanks for such a quick turnaround in this!

…

On Thu, Sep 4, 2025 at 4:49 PM Robert Soriano ***@***.***> wrote: *wobsoriano* left a comment (clerk/javascript#6674) <#6674 (comment)> Hello! Both of the PRs above have been merged and published. The key fix is that ***@***.*** (which ***@***.*** depends on) now supports both zod v3 and v4 in its peer dependencies (changed from ^3 >=3.22.0 to ^3.22.0 || ^4.0.0). Your package manager will now install ***@***.*** which is compatible with zod 4. 👍🏼 — Reply to this email directly, view it on GitHub <#6674 (comment)>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/AEVJWPOYHUBN5ADGGQI5HND3RBGQPAVCNFSM6AAAAACFIBBOGSVHI2DSMVQWIX3LMV43OSLTON2WKQ3PNVWWK3TUHMZTENJUGA4TIOJXGE> . You are receiving this because you were mentioned.Message ID: ***@***.***>