`ox` as an optional peer dependency

[carlosrsabreu]

When installing v0.2.43, I ran into a problem when building my project using pnpm:

Import trace for requested module:
../../node_modules/.pnpm/permissionless@0.2.43_viem@2.21.22_bufferutil@4.0.8_typescript@5.7.3_utf-8-validate@5.0.10_/node_modules/permissionless/_esm/accounts/index.js
../../node_modules/.pnpm/@fourt+sdk@1.1.3_@babel+core@7.23.3_@babel+preset-env@7.26.0_@babel+core@7.23.3__@types_424d5a67b0e25619433d3b7545479202/node_modules/@fourt/sdk/dist/index.js
./providers/UserProvider/index.tsx
./app/layout.tsx

../../node_modules/.pnpm/permissionless@0.2.43_viem@2.21.22_bufferutil@4.0.8_typescript@5.7.3_utf-8-validate@5.0.10_/node_modules/permissionless/_esm/accounts/kernel/utils/signMessage.js
Module not found: Can't resolve 'ox'

Then, I suspect the problem lies in considering the ox as an optional peer dependency, which is why it is not being installed. Can anyone explain to me why ox is an optional peer dependency?

permissionless.js/packages/permissionless/package.json

Lines 97 to 101 in 4287124

	"peerDependenciesMeta": {
	"ox": {
	"optional": true
	}
	}

I resolved this issue by installing the ox package in version 0.6.7 in my application, and the build started working again.

[plusminushalf]

ox is an optional peer dependency because not all smart accounts depends on it. You have to use ox only when using kernel smart account. Now that I think about it, maybe it is better to remove optional for now.

[plusminushalf]

Will release a new version - #400

[carlosrsabreu]

Got it, thank you!

[chaitanyapotti]

@plusminushalf Can you look at #401 as well. It solves a common peer dep issue when using latest viem with permissionless

[dawsbot]

We're getting npm install failures thanks to ox. Is there a way to remove this dep entirely? I don't see why we need a terminal package like this for a frontend library that comes bundled in with @privy-io/react-auth

---

Full error:

npm install @privy-io/react-auth@latest
npm error code ERESOLVE
npm error ERESOLVE could not resolve
npm error
npm error While resolving: credit-line@0.1.0
npm error Found: ox@0.8.1
npm error node_modules/ox
npm error   ox@"0.8.1" from viem@2.31.7
npm error   node_modules/viem
npm error     viem@">=2.29.0" from @reown/appkit@1.7.8
npm error     node_modules/@reown/appkit
npm error       @reown/appkit@"1.7.8" from @walletconnect/ethereum-provider@2.21.1
npm error       node_modules/@walletconnect/ethereum-provider
npm error         @walletconnect/ethereum-provider@"2.21.1" from @wagmi/connectors@5.8.5
npm error         node_modules/@wagmi/connectors
npm error     viem@">=2.29.0" from @reown/appkit-common@1.7.8
npm error     node_modules/@reown/appkit-common
npm error       @reown/appkit-common@"1.7.8" from @reown/appkit@1.7.8
npm error       node_modules/@reown/appkit
npm error         @reown/appkit@"1.7.8" from @walletconnect/ethereum-provider@2.21.1
npm error         node_modules/@walletconnect/ethereum-provider
npm error       6 more (@reown/appkit-controllers, @reown/appkit-pay, ...)
npm error     7 more (@reown/appkit-controllers, @reown/appkit-utils, ...)
npm error
npm error Could not resolve dependency:
npm error @privy-io/react-auth@"2.17.3" from the root project
npm error
npm error Conflicting peer dependency: ox@0.6.12
npm error node_modules/ox
npm error   peerOptional ox@"^0.6.7" from permissionless@0.2.49
npm error   node_modules/permissionless
npm error     peerOptional permissionless@"^0.2.47" from @privy-io/react-auth@2.17.3
npm error     node_modules/@privy-io/react-auth
npm error       @privy-io/react-auth@"2.17.3" from the root project
npm error
npm error Fix the upstream dependency conflict, or retry
npm error this command with --force or --legacy-peer-deps
npm error to accept an incorrect (and potentially broken) dependency resolution.
npm error
npm error
npm error For a full report see:
npm error /Users/db/.npm/_logs/2025-07-08T20_35_21_485Z-eresolve-report.txt
npm error A complete log of this run can be found in: /Users/db/.npm/_logs/2025-07-08T20_35_21_485Z-debug-0.log

node

npm -v: 10.9.2
node --version: v23.11.0

[itos-brian]

I am also having issues building with permissionless with ox. Have tried several different package setups. Any preferred way to get these builds passing?

Type error: Argument of type 'readonly string[] | AbiParameters' is not assignable to parameter of type 'readonly string[]'.
  Type 'AbiParameters' is not assignable to type 'readonly string[]'.
    Type 'AbiParameter' is not assignable to type 'string'.
      Type '{ type: string; name?: string | undefined; internalType?: string | undefined; }' is not assignable to type 'string'.

  465 | ): from.ReturnType<parameters> {
  466 |   if (Array.isArray(parameters) && typeof parameters[0] === 'string')
> 467 |     return abitype.parseAbiParameters(parameters) as never
      |                                       ^
  468 |   if (typeof parameters === 'string')
  469 |     return abitype.parseAbiParameters(parameters) as never
  470 |   return parameters as never
Next.js build worker exited with code: 1 and signal: null
 ELIFECYCLE  Command failed with exit code 1.

[dawsbot]

@itos-brian a solution that worked for us is to change the version in our package.json via the "overrides" property. Here is the exact code:

...rest of package.json
  "overrides": {
    "ox": "0.8.1"
  }

[plusminushalf]

Updated ox to ^0.8.0 in permissionless@0.2.57, Refer: #456