spike: add dynamic fe wallet support

Author: tremarkley

packages/demo/backend/src/config/verbs.ts

@@ -1,4 +1,8 @@
-import { Verbs, type VerbsConfig } from '@eth-optimism/verbs-sdk'
+import {
+  createVerbs,
+  type Verbs,
+  type VerbsConfig,
+} from '@eth-optimism/verbs-sdk/node'
 import { PrivyClient } from '@privy-io/server-auth'
 import { baseSepolia, unichain } from 'viem/chains'
 
@@ -57,7 +61,7 @@ export function createVerbsConfig(): VerbsConfig<'privy'> {
 
 export function initializeVerbs(config?: VerbsConfig<'privy'>): void {
   const verbsConfig = config || createVerbsConfig()
-  verbsInstance = new Verbs(verbsConfig)
+  verbsInstance = createVerbs(verbsConfig)
 }
 
 export function getVerbs() {

packages/sdk/package.json

@@ -19,7 +19,23 @@
     "src/*"
   ],
   "exports": {
-    ".": "./dist/index.js"
+    ".": {
+      "react": "./dist/index.react.js",
+      "import": "./dist/index.node.js",
+      "default": "./dist/index.node.js"
+    },
+    "./react": "./dist/index.react.js",
+    "./node": "./dist/index.node.js"
+  },
+  "typesVersions": {
+    "*": {
+      "react": [
+        "dist/index.react.d.ts"
+      ],
+      "node": [
+        "dist/index.node.d.ts"
+      ]
+    }
   },
   "scripts": {
     "build": "tsc && resolve-tspaths",
@@ -47,6 +63,9 @@
     "viem": "^2.24.1"
   },
   "peerDependencies": {
+    "@dynamic-labs/ethereum": ">=4.31.4",
+    "@dynamic-labs/wallet-connector-core": ">=4.31.4",
+    "@dynamic-labs/waas-evm": ">=4.31.4",
     "@privy-io/server-auth": ">=1.28.0"
   },
   "devDependencies": {

packages/sdk/src/index.node.ts

@@ -0,0 +1,4 @@
+export * from '@/index.js'
+export { createVerbs } from '@/nodeVerbsFactory.js'
+export { PrivyWallet } from '@/wallet/PrivyWallet.js'
+export { PrivyHostedWalletProvider } from '@/wallet/providers/PrivyHostedWalletProvider.js'

packages/sdk/src/index.react.ts

@@ -0,0 +1,2 @@
+export * from '@/index.js'
+export { createVerbs } from '@/reactVerbsFactory.js'

packages/sdk/src/index.ts

@@ -24,9 +24,6 @@ export type {
   WalletConfig,
 } from '@/types/index.js'
 export { isAssetSupportedOnChain } from '@/utils/assets.js'
-export { Verbs } from '@/verbs.js'
+export type { Verbs } from '@/verbs.js'
 export { SmartWallet } from '@/wallet/base/SmartWallet.js'
 export { Wallet } from '@/wallet/base/Wallet.js'
-export { PrivyWallet } from '@/wallet/PrivyWallet.js'
-export { SmartWalletProvider } from '@/wallet/providers/base/SmartWalletProvider.js'
-export { PrivyHostedWalletProvider } from '@/wallet/providers/PrivyHostedWalletProvider.js'

packages/sdk/src/nodeVerbsFactory.ts

@@ -0,0 +1,16 @@
+import type { VerbsConfig } from '@/types/verbs.js'
+import { Verbs } from '@/verbs.js'
+import { NodeHostedWalletProviderRegistry } from '@/wallet/providers/NodeHostedWalletProviderRegistry.js'
+
+/**
+ * Creates a Node environment Verbs factory
+ *
+ * Creates a Verbs instance wired with the Node-specific HostedWalletProviderRegistry.
+ * This ensures browser-only providers  are never imported in Node,
+ * avoiding runtime/module-resolution issues on the backend.
+ * @param config Verbs configuration
+ * @returns Verbs instance using the NodeHostedWalletProviderRegistry
+ */
+export function createVerbs(config: VerbsConfig<'privy'>) {
+  return new Verbs(config, { registry: new NodeHostedWalletProviderRegistry() })
+}

packages/sdk/src/reactVerbsFactory.ts

@@ -0,0 +1,18 @@
+import type { VerbsConfig } from '@/types/verbs.js'
+import { Verbs } from '@/verbs.js'
+import { ReactHostedWalletProviderRegistry } from '@/wallet/providers/ReactHostedWalletProviderRegistry.js'
+
+/**
+ * Creates a React/browser environment Verbs factory
+ *
+ * Creates a Verbs instance wired with the React-specific HostedWalletProviderRegistry.
+ * This registry enables browser-only hosted providers and defers
+ * their imports to the client environment to keep server builds clean.
+ * @param config Verbs configuration
+ * @returns Verbs instance using the ReactHostedWalletProviderRegistry
+ */
+export function createVerbs(config: VerbsConfig<'dynamic'>) {
+  return new Verbs(config, {
+    registry: new ReactHostedWalletProviderRegistry(),
+  })
+}

packages/sdk/src/test/DynamicHostedWalletProviderMock.ts

@@ -0,0 +1,36 @@
+import { unichain } from 'viem/op-stack'
+import { vi } from 'vitest'
+
+import type { ChainManager } from '@/services/ChainManager.js'
+import { MockChainManager } from '@/test/MockChainManager.js'
+import type { DynamicHostedWalletToVerbsWalletOptions } from '@/types/wallet.js'
+import type { Wallet } from '@/wallet/base/Wallet.js'
+import { HostedWalletProvider } from '@/wallet/providers/base/HostedWalletProvider.js'
+
+/**
+ * Minimal mock implementation matching the shape of HostedWalletProvider<'dynamic'>
+ * for use in unit tests without importing browser-only dependencies.
+ */
+export class DynamicHostedWalletProviderMock extends HostedWalletProvider<'dynamic'> {
+  // Exposed mock for assertions if needed
+  public readonly toVerbsWalletMock = vi.fn(
+    async (
+      _params: DynamicHostedWalletToVerbsWalletOptions,
+    ): Promise<Wallet> => {
+      return {} as unknown as Wallet
+    },
+  )
+
+  constructor() {
+    const mockChainManager = new MockChainManager({
+      supportedChains: [unichain.id],
+    }) as unknown as ChainManager
+    super(mockChainManager)
+  }
+
+  async toVerbsWallet(
+    params: DynamicHostedWalletToVerbsWalletOptions,
+  ): Promise<Wallet> {
+    return this.toVerbsWalletMock(params)
+  }
+}

packages/sdk/src/types/wallet.ts

@@ -1,3 +1,4 @@
+import type { Wallet as DynamicWallet } from '@dynamic-labs/wallet-connector-core'
 import type { Address, LocalAccount } from 'viem'
 import type { WebAuthnAccount } from 'viem/account-abstraction'
 
@@ -24,10 +25,18 @@ export type GetSmartWalletOptions = {
 }
 
 /**
- * Options for converting a hosted wallet to a Verbs wallet
+ * Options for converting a Privy hosted wallet to a Verbs wallet
  * @description Parameters for converting a hosted wallet to a Verbs wallet
  */
-export type HostedWalletToVerbsWalletOptions = {
+export type PrivyHostedWalletToVerbsWalletOptions = {
   walletId: string
   address: string
 }
+
+/**
+ * Options for converting a Dynamic hosted wallet to a Verbs wallet
+ * @description Parameters for converting a hosted wallet to a Verbs wallet
+ */
+export type DynamicHostedWalletToVerbsWalletOptions = {
+  wallet: DynamicWallet
+}