@eth-optimism/actions-sdk 0.0.3 → 0.1.0

package/src/test/MockPrivyClient.ts

@@ -1,5 +1,6 @@
-import type { PrivyClient } from '@privy-io/server-auth'
+import type { AuthorizationContext, PrivyClient } from '@privy-io/node'
 import type { Address } from 'viem'
+import { generatePrivateKey } from 'viem/accounts'
 
 import { getRandomAddress } from '@/test/utils.js'
 
@@ -8,102 +9,12 @@ import { getRandomAddress } from '@/test/utils.js'
  * @description Provides a mock implementation of PrivyClient for testing purposes
  */
 export class MockPrivyClient {
-  public walletApi = {
-    createWallet: async (params: { chainType: string }) => {
-      const walletId = `mock-wallet-${++this.walletCounter}`
-      const address = getRandomAddress()
-
-      const wallet = new MockWallet(walletId, address)
-      this.mockWallets.set(walletId, wallet)
-
-      return {
-        id: walletId,
-        address: address,
-        chainType: params.chainType,
-      }
-    },
-
-    getWallet: async (params: { id: string }) => {
-      const wallet = this.mockWallets.get(params.id)
-      if (!wallet) {
-        throw new Error(`Wallet ${params.id} not found`)
-      }
-
-      return {
-        id: wallet.id,
-        address: wallet.address,
-        chainType: 'ethereum',
-      }
-    },
-
-    getWallets: async (params?: { limit?: number; cursor?: string }) => {
-      const wallets = Array.from(this.mockWallets.values())
-      const limit = params?.limit || wallets.length
-
-      return {
-        data: wallets.slice(0, limit).map((wallet) => ({
-          id: wallet.id,
-          address: wallet.address,
-          chainType: 'ethereum',
-        })),
-      }
-    },
-
-    ethereum: {
-      signMessage: async (params: { walletId: string; message: string }) => {
-        const wallet = this.mockWallets.get(params.walletId)
-        if (!wallet) {
-          throw new Error(`Wallet ${params.walletId} not found`)
-        }
-
-        // Mock signature - deterministic based on message
-        const mockSig = `0x${'a'.repeat(128)}${params.message.length.toString(16).padStart(2, '0')}`
-        return { signature: mockSig }
-      },
-
-      secp256k1Sign: async (params: { walletId: string; hash: string }) => {
-        const wallet = this.mockWallets.get(params.walletId)
-        if (!wallet) {
-          throw new Error(`Wallet ${params.walletId} not found`)
-        }
-
-        // Mock signature - deterministic based on hash
-        const mockSig = `0x${'b'.repeat(128)}${params.hash.slice(-2)}`
-        return { signature: mockSig }
-      },
-
-      signTransaction: async (params: {
-        walletId: string
-        transaction: unknown
-      }) => {
-        const wallet = this.mockWallets.get(params.walletId)
-        if (!wallet) {
-          throw new Error(`Wallet ${params.walletId} not found`)
-        }
-
-        // Mock signed transaction
-        const mockSignedTx = `0x${'c'.repeat(200)}`
-        return { signedTransaction: mockSignedTx }
-      },
-    },
-  }
-
-  private mockWallets = new Map<string, MockWallet>()
-  private walletCounter = 0
-
   constructor(
     public appId: string,
     public appSecret: string,
   ) {}
 }
 
-class MockWallet {
-  constructor(
-    public id: string,
-    public address: Address,
-  ) {}
-}
-
 /**
  * Create a mock Privy client cast as PrivyClient type
  * @param appId - Mock app ID
@@ -116,3 +27,25 @@ export function createMockPrivyClient(
 ): PrivyClient {
   return new MockPrivyClient(appId, appSecret) as unknown as PrivyClient
 }
+
+export function createMockPrivyWallet(params?: {
+  id?: string
+  address?: Address
+}): {
+  id: string
+  address: Address
+} {
+  const { id, address } = params ?? {}
+  return {
+    id: id ?? 'mock-wallet-1',
+    address: address ?? getRandomAddress(),
+  }
+}
+
+export function getMockAuthorizationContext(
+  privateKey?: string,
+): AuthorizationContext {
+  return {
+    authorization_private_keys: [privateKey ?? generatePrivateKey()],
+  }
+}

package/src/types/actions.ts

@@ -1,7 +1,22 @@
+import type { Asset } from '@/types/asset.js'
 import type { ChainConfig } from '@/types/chain.js'
-import type { LendConfig } from '@/types/lend/index.js'
+import type { LendProviderConfig } from '@/types/lend/index.js'
 import type { ProviderSpec } from '@/wallet/core/providers/hosted/types/index.js'
 
+// Re-export LendProviderConfig for convenience
+export type { LendProviderConfig }
+
+/**
+ * Lending configuration
+ * @description Configuration for all lending providers
+ */
+export interface LendConfig {
+  /** Morpho lending provider configuration */
+  morpho?: LendProviderConfig
+  /** Aave lending provider configuration */
+  aave?: LendProviderConfig
+}
+
 /**
  * Network configuration for lending providers
  * @description Basic network information that lending providers need
@@ -11,6 +26,17 @@ export interface LendNetworkConfig {
   name: string
 }
 
+/**
+ * Assets configuration
+ * @description Configuration for supported assets
+ */
+export interface AssetsConfig {
+  /** Allowlist of assets to support (optional - defaults to all SUPPORTED_TOKENS) */
+  allow?: Asset[]
+  /** Blocklist of assets to exclude (optional) */
+  block?: Asset[]
+}
+
 /**
  * Actions SDK configuration
  * @description Configuration object for initializing the Actions SDK
@@ -21,8 +47,10 @@ export interface ActionsConfig<
 > {
   /** Wallet configuration */
   wallet: WalletConfig<THostedWalletProviderType, TConfigMap>
-  /** Lending provider configuration (optional) */
+  /** Lending providers configuration (optional) */
   lend?: LendConfig
+  /** Assets configuration (optional) */
+  assets?: AssetsConfig
   /** Chains to use for the SDK */
   chains: ChainConfig[]
 }

package/src/types/lend/base.ts

@@ -30,7 +30,7 @@ export type LendMarketConfigMetadata = {
   /** Asset information for this market */
   asset: Asset
   /** Lending provider type */
-  lendProvider: 'morpho'
+  lendProvider: 'morpho' | 'aave'
 }
 
 /**
@@ -215,32 +215,16 @@ export interface LendOptions {
 }
 
 /**
- * Base lending provider configuration
- * @description Base configuration shared by all lending providers
+ * Individual lending provider configuration
+ * @description Configuration for a single lending provider
  */
-export interface BaseLendConfig {
-  /** Default slippage tolerance (basis points) */
-  defaultSlippage?: number
+export interface LendProviderConfig {
   /** Allowlist of markets available for lending */
   marketAllowlist?: LendMarketConfig[]
+  /** Blocklist of markets to exclude from lending */
+  marketBlocklist?: LendMarketConfig[]
 }
 
-/**
- * Morpho lending provider configuration
- * @description Configuration specific to Morpho lending provider
- */
-export interface MorphoLendConfig extends BaseLendConfig {
-  /** Lending provider name */
-  provider: 'morpho'
-  // Morpho-specific fields can be added here in the future
-}
-
-/**
- * Lending provider configuration
- * @description Union of all possible lending provider configurations
- */
-export type LendConfig = MorphoLendConfig
-
 /**
  * Market position information
  * @description Position details for a user in a lending market

package/src/wallet/core/namespace/WalletNamespace.ts

@@ -55,19 +55,19 @@ export class WalletNamespace<
   /**
    * Create a new smart wallet
    * @description Creates a smart wallet and attempts to deploy it across all supported chains.
-   * The wallet address is deterministically calculated from owners and nonce. The signer must
-   * be included in the owners array. Deployment failures on individual chains do not prevent
+   * The wallet address is deterministically calculated from signers and nonce. The signer must
+   * be included in the signers array. Deployment failures on individual chains do not prevent
    * wallet creation - they are reported in the result.
    * @param params - Smart wallet creation parameters
-   * @param params.owners - Array of owners for the smart wallet (addresses or WebAuthn public keys)
-   * @param params.signer - Local account used for signing transactions (must be in owners array)
+   * @param params.signer - Primary local account used for signing transactions
+   * @param params.signers - Optional array of additional signers for the smart wallet
    * @param params.nonce - Optional nonce for smart wallet address generation (defaults to 0)
    * @param params.deploymentChainIds - Optional chain IDs to deploy the wallet to.
    * If not provided, the wallet will be deployed to all supported chains.
    * @returns Promise resolving to deployment result containing:
    * - `wallet`: The created SmartWallet instance
    * - `deployments`: Array of deployment results with chainId, receipt, success flag, and error
-   * @throws Error if signer is not included in the owners array
+   * @throws Error if signer is not included in the signers array
    */
   async createSmartWallet(
     params: CreateSmartWalletOptions,
@@ -98,7 +98,7 @@ export class WalletNamespace<
    * @param params.address - Ethereum address of the hosted wallet
    * @returns Promise resolving to the Actions wallet instance
    */
-  async hostedWalletToActionsWallet(
+  async toActionsWallet(
     params: TToActionsMap[THostedProviderType],
   ): Promise<Wallet> {
     return this.provider.hostedWalletToActionsWallet(params)
@@ -110,14 +110,14 @@ export class WalletNamespace<
    * you already have a LocalAccount signer and want to access an existing smart wallet without
    * going through the hosted wallet provider. Use this instead of getSmartWalletWithHostedSigner
    * when you have direct control over the signer.
-   * @param signer - Local account to use for signing transactions on the smart wallet
-   * @param getWalletParams - Wallet retrieval parameters
-   * @param getWalletParams.deploymentOwners - Array of original deployment owners for smart wallet address calculation. Required if walletAddress not provided. Must match the exact owners array used during wallet deployment.
-   * @param getWalletParams.signerOwnerIndex - Current index of the signer in the smart wallet's current owners array (used for transaction signing). Defaults to 0 if not specified. This may differ from the original deployment index if owners have been modified.
-   * @param getWalletParams.walletAddress - Optional explicit smart wallet address (skips address calculation)
-   * @param getWalletParams.nonce - Optional nonce used during smart wallet creation
+   * @param params - Wallet retrieval parameters
+   * @param params.signer - Local account to use for signing transactions on the smart wallet
+   * @param params.signers - Optional array of additional signers for the smart wallet
+   * @param params.deploymentSigners - Optional array of signers used during wallet deployment
+   * @param params.walletAddress - Optional explicit smart wallet address (skips address calculation)
+   * @param params.nonce - Optional nonce used during smart wallet creation
    * @returns Promise resolving to the smart wallet instance with the provided signer
-   * @throws Error if neither walletAddress nor deploymentOwners provided
+   * @throws Error if neither walletAddress nor deploymentSigners provided
    */
   async getSmartWallet(params: GetSmartWalletOptions) {
     return this.provider.getSmartWallet(params)

package/src/wallet/core/namespace/__tests__/WalletNamespace.spec.ts

@@ -1,4 +1,4 @@
-import type { PrivyClient } from '@privy-io/server-auth'
+import type { PrivyClient } from '@privy-io/node'
 import { getAddress } from 'viem'
 import { unichain } from 'viem/chains'
 import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest'
@@ -7,7 +7,11 @@ import type { SupportedChainId } from '@/constants/supportedChains.js'
 import type { ChainManager } from '@/services/ChainManager.js'
 import { MockChainManager } from '@/test/MockChainManager.js'
 import { createMockLendProvider } from '@/test/MockLendProvider.js'
-import { createMockPrivyClient } from '@/test/MockPrivyClient.js'
+import {
+  createMockPrivyClient,
+  createMockPrivyWallet,
+  getMockAuthorizationContext,
+} from '@/test/MockPrivyClient.js'
 import { getRandomAddress } from '@/test/utils.js'
 import { WalletNamespace } from '@/wallet/core/namespace/WalletNamespace.js'
 import { DefaultSmartWalletProvider } from '@/wallet/core/providers/smart/default/DefaultSmartWalletProvider.js'
@@ -35,13 +39,14 @@ describe('WalletNamespace', () => {
 
   describe('hostedWalletProvider', () => {
     it('should provide access to hosted wallet provider', () => {
-      const hostedWalletProvider = new PrivyHostedWalletProvider(
-        mockPrivyClient,
-        mockChainManager,
-      )
+      const hostedWalletProvider = new PrivyHostedWalletProvider({
+        privyClient: mockPrivyClient,
+        chainManager: mockChainManager,
+        authorizationContext: getMockAuthorizationContext(),
+      })
       const smartWalletProvider = new DefaultSmartWalletProvider(
         mockChainManager,
-        mockLendProvider,
+        { morpho: mockLendProvider },
       )
       const walletProvider = new WalletProvider(
         hostedWalletProvider,
@@ -59,13 +64,14 @@ describe('WalletNamespace', () => {
         'test-app-id',
         'test-app-secret',
       )
-      const hostedWalletProvider = new PrivyHostedWalletProvider(
-        mockPrivyClient,
-        mockChainManager,
-      )
+      const hostedWalletProvider = new PrivyHostedWalletProvider({
+        privyClient: mockPrivyClient,
+        authorizationContext: getMockAuthorizationContext(),
+        chainManager: mockChainManager,
+      })
       const smartWalletProvider = new DefaultSmartWalletProvider(
         mockChainManager,
-        mockLendProvider,
+        { morpho: mockLendProvider },
       )
       const walletProvider = new WalletProvider(
         hostedWalletProvider,
@@ -79,13 +85,14 @@ describe('WalletNamespace', () => {
 
   describe('createSmartWallet', () => {
     it('should create a smart wallet and return deployment result', async () => {
-      const hostedWalletProvider = new PrivyHostedWalletProvider(
-        mockPrivyClient,
-        mockChainManager,
-      )
+      const hostedWalletProvider = new PrivyHostedWalletProvider({
+        privyClient: mockPrivyClient,
+        authorizationContext: getMockAuthorizationContext(),
+        chainManager: mockChainManager,
+      })
       const smartWalletProvider = new DefaultSmartWalletProvider(
         mockChainManager,
-        mockLendProvider,
+        { morpho: mockLendProvider },
       )
       const walletProvider = new WalletProvider(
         hostedWalletProvider,
@@ -95,9 +102,7 @@ describe('WalletNamespace', () => {
       const walletNamespace = new WalletNamespace(walletProvider)
 
       // Create a hosted wallet to use as signer
-      const privyWallet = await mockPrivyClient.walletApi.createWallet({
-        chainType: 'ethereum',
-      })
+      const privyWallet = createMockPrivyWallet()
       const hostedWallet =
         await walletProvider.hostedWalletProvider.toActionsWallet({
           walletId: privyWallet.id,
@@ -121,13 +126,14 @@ describe('WalletNamespace', () => {
     })
 
     it('should report deployment successes and failures', async () => {
-      const hostedWalletProvider = new PrivyHostedWalletProvider(
-        mockPrivyClient,
-        mockChainManager,
-      )
+      const hostedWalletProvider = new PrivyHostedWalletProvider({
+        privyClient: mockPrivyClient,
+        authorizationContext: getMockAuthorizationContext(),
+        chainManager: mockChainManager,
+      })
       const smartWalletProvider = new DefaultSmartWalletProvider(
         mockChainManager,
-        mockLendProvider,
+        { morpho: mockLendProvider },
       )
       const walletProvider = new WalletProvider(
         hostedWalletProvider,
@@ -136,9 +142,7 @@ describe('WalletNamespace', () => {
       const walletNamespace = new WalletNamespace(walletProvider)
 
       // Create a hosted wallet to use as signer
-      const privyWallet = await mockPrivyClient.walletApi.createWallet({
-        chainType: 'ethereum',
-      })
+      const privyWallet = createMockPrivyWallet()
       const hostedWallet =
         await walletProvider.hostedWalletProvider.toActionsWallet({
           walletId: privyWallet.id,
@@ -206,13 +210,14 @@ describe('WalletNamespace', () => {
         'test-app-id',
         'test-app-secret',
       )
-      const hostedWalletProvider = new PrivyHostedWalletProvider(
-        mockPrivyClient,
-        mockChainManager,
-      )
+      const hostedWalletProvider = new PrivyHostedWalletProvider({
+        privyClient: mockPrivyClient,
+        authorizationContext: getMockAuthorizationContext(),
+        chainManager: mockChainManager,
+      })
       const smartWalletProvider = new DefaultSmartWalletProvider(
         mockChainManager,
-        mockLendProvider,
+        { morpho: mockLendProvider },
       )
       const walletProvider = new WalletProvider(
         hostedWalletProvider,
@@ -221,9 +226,7 @@ describe('WalletNamespace', () => {
       const getSmartWalletSpy = vi.spyOn(walletProvider, 'getSmartWallet')
       const walletNamespace = new WalletNamespace(walletProvider)
 
-      const privyWallet = await mockPrivyClient.walletApi.createWallet({
-        chainType: 'ethereum',
-      })
+      const privyWallet = createMockPrivyWallet()
       const hostedWallet =
         await walletProvider.hostedWalletProvider.toActionsWallet({
           walletId: privyWallet.id,
@@ -249,13 +252,14 @@ describe('WalletNamespace', () => {
         'test-app-id',
         'test-app-secret',
       )
-      const hostedWalletProvider = new PrivyHostedWalletProvider(
-        mockPrivyClient,
-        mockChainManager,
-      )
+      const hostedWalletProvider = new PrivyHostedWalletProvider({
+        privyClient: mockPrivyClient,
+        authorizationContext: getMockAuthorizationContext(),
+        chainManager: mockChainManager,
+      })
       const smartWalletProvider = new DefaultSmartWalletProvider(
         mockChainManager,
-        mockLendProvider,
+        { morpho: mockLendProvider },
       )
       const walletProvider = new WalletProvider(
         hostedWalletProvider,
@@ -263,9 +267,7 @@ describe('WalletNamespace', () => {
       )
       const walletNamespace = new WalletNamespace(walletProvider)
 
-      const privyWallet = await mockPrivyClient.walletApi.createWallet({
-        chainType: 'ethereum',
-      })
+      const privyWallet = createMockPrivyWallet()
       const hostedWallet =
         await walletProvider.hostedWalletProvider.toActionsWallet({
           walletId: privyWallet.id,
@@ -284,15 +286,16 @@ describe('WalletNamespace', () => {
     })
   })
 
-  describe('hostedWalletToActionsWallet', () => {
+  describe('toActionsWallet', () => {
     it('should convert a hosted wallet to an Actions wallet', async () => {
-      const hostedWalletProvider = new PrivyHostedWalletProvider(
-        mockPrivyClient,
-        mockChainManager,
-      )
+      const hostedWalletProvider = new PrivyHostedWalletProvider({
+        privyClient: mockPrivyClient,
+        authorizationContext: getMockAuthorizationContext(),
+        chainManager: mockChainManager,
+      })
       const smartWalletProvider = new DefaultSmartWalletProvider(
         mockChainManager,
-        mockLendProvider,
+        { morpho: mockLendProvider },
       )
       const walletProvider = new WalletProvider(
         hostedWalletProvider,
@@ -300,9 +303,7 @@ describe('WalletNamespace', () => {
       )
       const walletNamespace = new WalletNamespace(walletProvider)
 
-      const privyWallet = await mockPrivyClient.walletApi.createWallet({
-        chainType: 'ethereum',
-      })
+      const privyWallet = createMockPrivyWallet()
       const hostedWallet =
         await walletProvider.hostedWalletProvider.toActionsWallet({
           walletId: privyWallet.id,
@@ -313,7 +314,7 @@ describe('WalletNamespace', () => {
         'toActionsWallet',
       )
 
-      const actionsWallet = await walletNamespace.hostedWalletToActionsWallet({
+      const actionsWallet = await walletNamespace.toActionsWallet({
         walletId: privyWallet.id,
         address: privyWallet.address,
       })
@@ -330,13 +331,14 @@ describe('WalletNamespace', () => {
 
   describe('createSigner', () => {
     it('should delegate to hosted wallet provider createSigner', async () => {
-      const hostedWalletProvider = new PrivyHostedWalletProvider(
-        mockPrivyClient,
-        mockChainManager,
-      )
+      const hostedWalletProvider = new PrivyHostedWalletProvider({
+        privyClient: mockPrivyClient,
+        authorizationContext: getMockAuthorizationContext(),
+        chainManager: mockChainManager,
+      })
       const smartWalletProvider = new DefaultSmartWalletProvider(
         mockChainManager,
-        mockLendProvider,
+        { morpho: mockLendProvider },
       )
       const walletProvider = new WalletProvider(
         hostedWalletProvider,
@@ -345,9 +347,7 @@ describe('WalletNamespace', () => {
       const createSignerSpy = vi.spyOn(walletProvider, 'createSigner')
       const walletNamespace = new WalletNamespace(walletProvider)
 
-      const privyWallet = await mockPrivyClient.walletApi.createWallet({
-        chainType: 'ethereum',
-      })
+      const privyWallet = createMockPrivyWallet()
       const params = {
         walletId: privyWallet.id,
         address: getAddress(privyWallet.address),
@@ -361,13 +361,14 @@ describe('WalletNamespace', () => {
     })
 
     it('should return a LocalAccount that can be used as a smart wallet signer', async () => {
-      const hostedWalletProvider = new PrivyHostedWalletProvider(
-        mockPrivyClient,
-        mockChainManager,
-      )
+      const hostedWalletProvider = new PrivyHostedWalletProvider({
+        privyClient: mockPrivyClient,
+        authorizationContext: getMockAuthorizationContext(),
+        chainManager: mockChainManager,
+      })
       const smartWalletProvider = new DefaultSmartWalletProvider(
         mockChainManager,
-        mockLendProvider,
+        { morpho: mockLendProvider },
       )
       const walletProvider = new WalletProvider(
         hostedWalletProvider,
@@ -375,9 +376,7 @@ describe('WalletNamespace', () => {
       )
       const walletNamespace = new WalletNamespace(walletProvider)
 
-      const privyWallet = await mockPrivyClient.walletApi.createWallet({
-        chainType: 'ethereum',
-      })
+      const privyWallet = createMockPrivyWallet()
       const signer = await walletNamespace.createSigner({
         walletId: privyWallet.id,
         address: getAddress(privyWallet.address),