How zerodevapp/zerodev-wallet-sdk works
ZeroDev Wallet SDK provides non-custodial smart-wallet authentication and signing, exposed through a framework-agnostic core and Wagmi/React integrations. The main user path is authenticate (passkey, OAuth, or email), obtain a wallet session, then sign/send a transaction; optional UI packages supply ready-made authentication and signing screens, while a separate funding widget creates a cross-chain deposit address and presents routes and fees. The repository also includes Expo support and demo/QA applications. Some subsystem links are documented in the README; unsampled implementation details are not inferred.
Main entry points: auth Authentication actions · connector.ts Wagmi connector · SmartRoutingAddressContext.ts Routing context · createClient.ts API client
Components 27
Wallet core
- Authentication actions
packages/core/src/actions/auth - Wallet actions
packages/core/src/actions/wallet - API client
packages/core/src/client/createClient.ts - REST transport
packages/core/src/client/transports/rest.ts - Session manager
packages/core/src/storage/manager.ts - Storage adapter
packages/core/src/storage/adapters.ts
React integration
- Wagmi connector
packages/react/src/core/connector.ts - Auth hooks
packages/react/src/actions.ts - OAuth flow
packages/react/src/authenticateOAuth.ts - OAuth URL verification
packages/react/src/utils/verifyGoogleLoginUrl.ts
Wallet UI
- Authentication screens
packages/wallet-react-ui/src/auth - Signing screens
packages/wallet-react-ui/src/signing - Transaction history
packages/wallet-react-ui/src/history/pages/History.tsx - UI state store
packages/wallet-react-ui/src/store.ts
Smart routing
- Routing provider
packages/smart-routing-address-react-ui/src/context/SmartRoutingAddressProvider.tsx - Routing context
packages/smart-routing-address-react-ui/src/context/SmartRoutingAddressContext.ts - Deposit address
packages/smart-routing-address-react-ui/src/hooks/useCreateSmartRoutingAddress.ts - Address and route state
packages/smart-routing-address-react-ui/src/hooks/useSmartRoutingAddress.ts - Deposit and history UI
packages/smart-routing-address-react-ui/src/pages
Examples and QA
- Expo example
apps/expo-example/src/app - QA testing lab
apps/qa-lab-testing/src/app - Signer demo
apps/zerodev-signer-demo/src/app - Routing demo
apps/sra-demo/src/app
Other components
- Wallet user
- Chain RPC
- ZeroDev backend
- Across and Relay
Connections 29
- Wallet user → Wagmi connector: connects
README.md - Wagmi connector → Authentication actions: authenticates
README.md - Auth hooks → Authentication actions: invokes
README.md - Auth hooks → OAuth flow: starts OAuth
packages/react/src/authenticateOAuth.ts - OAuth flow → OAuth URL verification: validates redirect
packages/react/src/authenticateOAuth.ts - OAuth flow → Authentication actions: uses core
packages/react/src/authenticateOAuth.ts - Authentication actions → API client: requests
- API client → REST transport: dispatches
- Authentication actions → Session manager: persists session
- Session manager → Storage adapter: uses adapter
- Wagmi connector → Wallet actions: signs transactions
README.md - Wallet actions → Chain RPC: sends UserOperations
README.md - API client → ZeroDev backend: calls backend
README.md - Wallet user → Authentication screens: uses
README.md - Authentication screens → Wagmi connector: authenticates with
README.md - Wallet user → Signing screens: reviews request
README.md - Signing screens → Wagmi connector: signs with
README.md - Authentication screens → UI state store: reads state
packages/wallet-react-ui/src/auth/hooks/useAuth.ts - Signing screens → UI state store: reads requests
packages/wallet-react-ui/src/signing/hooks/usePendingRequest.ts - Wallet user → Transaction history: views history
README.md - Routing provider → Routing context: provides state
- Deposit address → Routing context: reads creation action
packages/smart-routing-address-react-ui/src/hooks/useCreateSmartRoutingAddress.ts - Address and route state → Routing context: reads route state
packages/smart-routing-address-react-ui/src/hooks/useSmartRoutingAddress.ts - Deposit and history UI → Routing context: uses state
- Deposit and history UI → Across and Relay: routes deposits
README.md - Wallet user → Expo example: tries SDK
README.md - Wallet user → QA testing lab: tests features
- Wallet user → Signer demo: tries wallet
- Wallet user → Routing demo: previews funding