Skip to content

Connector Options

Configure the zeroDevWallet connector

The zeroDevWallet connector is configured through the options below. Only projectId and chains are required — on the web, everything else falls back to a sensible default.

import { zeroDevWallet } from '@zerodev/wallet-react'
import { sepolia } from 'wagmi/chains'
 
zeroDevWallet({
  projectId: 'YOUR_ZERODEV_PROJECT_ID',
  chains: [sepolia],
})

Options

projectId

string

Required. Your ZeroDev project ID, from the ZeroDev Dashboard.

chains

readonly Chain[]

Required. The viem/wagmi chains the wallet supports. Usually the same array you pass to Wagmi's createConfig.

mode

'4337' | '7702'

The account mode exposed to Wagmi. Defaults to '7702'.

  • '7702' — An EOA delegated to a Kernel smart account via EIP-7702. The address equals the EOA address; transactions are bundled as UserOperations and can be sponsored.
  • '4337' — A counterfactual ERC-4337 Kernel smart account. The address differs from the EOA and the account is deployed on the first UserOperation; transactions are bundled as UserOperations.

rpId

string | undefined

The relying party ID — the domain used for passkeys, as defined by the WebAuthn standard. On the web it defaults to window.location.hostname, so you only need to set it to share passkeys across subdomains.

autoRefreshSession

boolean | undefined

Whether the SDK refreshes the session before it expires. Defaults to true. See Session Management.

sessionWarningThreshold

number | undefined

How long before expiry (in milliseconds) the session is refreshed when autoRefreshSession is enabled. Defaults to 60000 (60 seconds).

autoInitialize

boolean | (() => boolean) | undefined

Whether the connector initializes automatically on mount. When false, the connector still initializes lazily on connect. Accepts a function for conditional initialization.

sessionStorage

StorageAdapter | undefined

Storage adapter for the wallet SDK's session backend. This is where the auth/session layer stores its session records. On the web it defaults to the browser's localStorage. Provide a custom StorageAdapter for alternative storage.

persistStorage

CreateStoreOptions['storage'] | undefined

Storage used to persist the connector store across page reloads. This is a separate layer from sessionStorage. If omitted, the connector store uses its own default web persistence behavior rather than automatically reusing sessionStorage.

Storage model on web

There are two storage layers on the web:

  • sessionStorage stores the wallet SDK's auth/session data.
  • persistStorage stores the ZeroDev connector's persisted state for rehydration.

Most apps can leave both unset and use the built-in web defaults:

zeroDevWallet({
  projectId: 'YOUR_ZERODEV_PROJECT_ID',
  chains: [sepolia],
})

If you want both layers to use the same browser storage implementation, set them both explicitly:

const browserStorage = {
  getItem: (key: string) => window.localStorage.getItem(key),
  setItem: (key: string, value: string) =>
    window.localStorage.setItem(key, value),
  removeItem: (key: string) => window.localStorage.removeItem(key),
}
 
zeroDevWallet({
  projectId: 'YOUR_ZERODEV_PROJECT_ID',
  chains: [sepolia],
  sessionStorage: browserStorage,
  persistStorage: browserStorage,
})

apiKeyStamper

ApiKeyStamper | Promise<ApiKeyStamper> | undefined

Advanced. Signs the SDK's requests with an API key. On the web it defaults to an IndexedDB-backed stamper.

passkeyStamper

PasskeyStamper | Promise<PasskeyStamper> | undefined

Advanced. Signs passkey operations. On the web it defaults to a WebAuthn stamper.

organizationId

string | undefined

Advanced. Overrides the sub-organization the SDK operates against.

proxyBaseUrl

string | undefined

Advanced. Base URL for a custom backend proxy in front of the ZeroDev wallet API.

aaHost

string | undefined

Advanced. Overrides the account-abstraction bundler and paymaster host. Pass only the host origin, such as https://rpc.zerodev.app; the SDK derives the per-chain URL from your project ID, active chain, and host.

React Native

On React Native there are no platform defaults, so rpId, apiKeyStamper, and sessionStorage are required and configured through the adapters the SDK ships for Expo. See React Native Configuration.