@eth-optimism/actions-sdk 0.0.2 → 0.0.4

package/dist/wallet/node/wallets/hosted/privy/utils/createSigner.d.ts

@@ -8,8 +8,12 @@ import type { NodeOptionsMap, PrivyHostedWalletToActionsWalletOptions } from '..
  * @param params.walletId - Privy wallet identifier
  * @param params.address - Ethereum address of the wallet
  * @param params.privyClient - Privy client instance
- * @returns Promise resolving to a LocalAccount configured for signing operations
+ * @param params.authorizationContext - Optional authorization context for the Privy client.
+ * Used when Privy needs to sign requests.
+ * See https://docs.privy.io/controls/authorization-keys/using-owners/sign/automatic#using-the-authorization-context
+ * for more information on building and using the authorization context.
+ * @returns LocalAccount configured for signing operations
  * @throws Error if wallet retrieval fails or signing operations are not supported
  */
-export declare function createSigner(params: PrivyHostedWalletToActionsWalletOptions & NodeOptionsMap['privy']): Promise<LocalAccount>;
+export declare function createSigner(params: PrivyHostedWalletToActionsWalletOptions & NodeOptionsMap['privy']): LocalAccount;
 //# sourceMappingURL=createSigner.d.ts.map

package/dist/wallet/node/wallets/hosted/privy/utils/createSigner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"createSigner.d.ts","sourceRoot":"","sources":["../../../../../../../src/wallet/node/wallets/hosted/privy/utils/createSigner.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,MAAM,CAAA;AAExC,OAAO,KAAK,EACV,cAAc,EACd,uCAAuC,EACxC,MAAM,+CAA+C,CAAA;AAEtD;;;;;;;;;;GAUG;AACH,wBAAsB,YAAY,CAChC,MAAM,EAAE,uCAAuC,GAAG,cAAc,CAAC,OAAO,CAAC,GACxE,OAAO,CAAC,YAAY,CAAC,CASvB"}
+{"version":3,"file":"createSigner.d.ts","sourceRoot":"","sources":["../../../../../../../src/wallet/node/wallets/hosted/privy/utils/createSigner.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,MAAM,CAAA;AAExC,OAAO,KAAK,EACV,cAAc,EACd,uCAAuC,EACxC,MAAM,+CAA+C,CAAA;AAEtD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,uCAAuC,GAAG,cAAc,CAAC,OAAO,CAAC,GACxE,YAAY,CAQd"}

package/dist/wallet/node/wallets/hosted/privy/utils/createSigner.js

@@ -1,4 +1,4 @@
-import { createViemAccount } from '@privy-io/server-auth/viem';
+import { createViemAccount } from '@privy-io/node/viem';
 /**
  * Create a LocalAccount from a Privy wallet
  * @description Converts the Privy wallet into a viem-compatible LocalAccount that can sign
@@ -7,16 +7,19 @@ import { createViemAccount } from '@privy-io/server-auth/viem';
  * @param params.walletId - Privy wallet identifier
  * @param params.address - Ethereum address of the wallet
  * @param params.privyClient - Privy client instance
- * @returns Promise resolving to a LocalAccount configured for signing operations
+ * @param params.authorizationContext - Optional authorization context for the Privy client.
+ * Used when Privy needs to sign requests.
+ * See https://docs.privy.io/controls/authorization-keys/using-owners/sign/automatic#using-the-authorization-context
+ * for more information on building and using the authorization context.
+ * @returns LocalAccount configured for signing operations
  * @throws Error if wallet retrieval fails or signing operations are not supported
  */
-export async function createSigner(params) {
-    const { walletId, address, privyClient } = params;
-    const account = await createViemAccount({
+export function createSigner(params) {
+    const { walletId, address, privyClient, authorizationContext } = params;
+    const account = createViemAccount(privyClient, {
         walletId,
         address,
-        // TODO: Fix this type error
-        privy: privyClient,
+        authorizationContext,
     });
     return account;
 }

package/dist/wallet/node/wallets/hosted/privy/utils/createSigner.js.map

@@ -1 +1 @@
-{"version":3,"file":"createSigner.js","sourceRoot":"","sources":["../../../../../../../src/wallet/node/wallets/hosted/privy/utils/createSigner.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAA;AAQ9D;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,MAAyE;IAEzE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,WAAW,EAAE,GAAG,MAAM,CAAA;IACjD,MAAM,OAAO,GAAG,MAAM,iBAAiB,CAAC;QACtC,QAAQ;QACR,OAAO;QACP,4BAA4B;QAC5B,KAAK,EAAE,WAA0D;KAClE,CAAC,CAAA;IACF,OAAO,OAAO,CAAA;AAChB,CAAC"}
+{"version":3,"file":"createSigner.js","sourceRoot":"","sources":["../../../../../../../src/wallet/node/wallets/hosted/privy/utils/createSigner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AAQvD;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,YAAY,CAC1B,MAAyE;IAEzE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,WAAW,EAAE,oBAAoB,EAAE,GAAG,MAAM,CAAA;IACvE,MAAM,OAAO,GAAG,iBAAiB,CAAC,WAAW,EAAE;QAC7C,QAAQ;QACR,OAAO;QACP,oBAAoB;KACrB,CAAC,CAAA;IACF,OAAO,OAAO,CAAA;AAChB,CAAC"}

package/package.json

@@ -10,7 +10,7 @@
     "url": "https://github.com/ethereum-optimism/actions/issues"
   },
   "type": "module",
-  "version": "0.0.2",
+  "version": "0.0.4",
   "description": "TypeScript SDK for Actions",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -57,7 +57,7 @@
     "@dynamic-labs/waas-evm": ">=4.31.4",
     "@dynamic-labs/wallet-connector-core": ">=4.31.4",
     "@privy-io/react-auth": ">=2.24.0",
-    "@privy-io/server-auth": ">=1.31.1",
+    "@privy-io/node": ">=0.3.0",
     "@turnkey/core": ">=1.1.1",
     "@turnkey/http": ">=3.12.1",
     "@turnkey/sdk-server": ">=4.9.1",

package/src/actions.test.ts

@@ -3,7 +3,10 @@ import { unichain } from 'viem/chains'
 import { describe, expect, it } from 'vitest'
 
 import { Actions } from '@/actions.js'
-import { createMockPrivyClient } from '@/test/MockPrivyClient.js'
+import {
+  createMockPrivyClient,
+  getMockAuthorizationContext,
+} from '@/test/MockPrivyClient.js'
 import type { LendMarketConfig, MorphoLendConfig } from '@/types/lend/index.js'
 import { externalTest } from '@/utils/test.js'
 import { HostedWalletProviderRegistry } from '@/wallet/core/providers/hosted/registry/HostedWalletProviderRegistry.js'
@@ -36,10 +39,11 @@ describe('Actions SDK', () => {
           return Boolean((options as NodeOptionsMap['privy'])?.privyClient)
         },
         create({ chainManager }, options) {
-          return new PrivyHostedWalletProvider(
-            options.privyClient,
+          return new PrivyHostedWalletProvider({
+            privyClient: options.privyClient,
             chainManager,
-          )
+            authorizationContext: options.authorizationContext,
+          })
         },
       })
     }
@@ -67,6 +71,7 @@ describe('Actions SDK', () => {
                       'test-id',
                       'test-secret',
                     ),
+                    authorizationContext: getMockAuthorizationContext(),
                   },
                 },
               },
@@ -107,6 +112,7 @@ describe('Actions SDK', () => {
                       'test-id',
                       'test-secret',
                     ),
+                    authorizationContext: getMockAuthorizationContext(),
                   },
                 },
               },
@@ -166,6 +172,7 @@ describe('Actions SDK', () => {
                       'test-id',
                       'test-secret',
                     ),
+                    authorizationContext: getMockAuthorizationContext(),
                   },
                 },
               },
@@ -248,6 +255,7 @@ describe('Actions SDK', () => {
                       'test-id',
                       'test-secret',
                     ),
+                    authorizationContext: getMockAuthorizationContext(),
                   },
                 },
               },
@@ -291,6 +299,7 @@ describe('Actions SDK', () => {
                         'test-id',
                         'test-secret',
                       ),
+                      authorizationContext: getMockAuthorizationContext(),
                     },
                   },
                 },
@@ -324,6 +333,7 @@ describe('Actions SDK', () => {
                       'test-id',
                       'test-secret',
                     ),
+                    authorizationContext: getMockAuthorizationContext(),
                   },
                 },
               },
@@ -369,6 +379,7 @@ describe('Actions SDK', () => {
                         'test-id',
                         'test-secret',
                       ),
+                      authorizationContext: getMockAuthorizationContext(),
                     },
                   },
                 },
@@ -408,6 +419,7 @@ describe('Actions SDK', () => {
                         'test-id',
                         'test-secret',
                       ),
+                      authorizationContext: getMockAuthorizationContext(),
                     },
                   },
                 },
@@ -449,6 +461,7 @@ describe('Actions SDK', () => {
                       'test-id',
                       'test-secret',
                     ),
+                    authorizationContext: getMockAuthorizationContext(),
                   },
                 },
               },
@@ -492,6 +505,7 @@ describe('Actions SDK', () => {
                       'test-app-id',
                       'test-app-secret',
                     ),
+                    authorizationContext: getMockAuthorizationContext(),
                   },
                 },
               },
@@ -545,6 +559,7 @@ describe('Actions SDK', () => {
                         'test-app-id',
                         'test-app-secret',
                       ),
+                      authorizationContext: getMockAuthorizationContext(),
                     },
                   },
                 },
@@ -599,6 +614,7 @@ describe('Actions SDK', () => {
                         'test-app-id',
                         'test-app-secret',
                       ),
+                      authorizationContext: getMockAuthorizationContext(),
                     },
                   },
                 },
@@ -686,6 +702,7 @@ describe('Actions SDK', () => {
                         'test-app-id',
                         'test-app-secret',
                       ),
+                      authorizationContext: getMockAuthorizationContext(),
                     },
                   },
                 },
@@ -748,6 +765,7 @@ describe('Actions SDK', () => {
                         'test-app-id',
                         'test-app-secret',
                       ),
+                      authorizationContext: getMockAuthorizationContext(),
                     },
                   },
                 },
@@ -801,6 +819,7 @@ describe('Actions SDK', () => {
                       'test-app-id',
                       'test-app-secret',
                     ),
+                    authorizationContext: getMockAuthorizationContext(),
                   },
                 },
               },
@@ -852,6 +871,7 @@ describe('Actions SDK', () => {
                       'test-app-id',
                       'test-app-secret',
                     ),
+                    authorizationContext: getMockAuthorizationContext(),
                   },
                 },
               },

package/src/constants/assets.ts

@@ -1,5 +1,11 @@
 import type { Address } from 'viem'
-import { base, baseSepolia, mainnet, unichain } from 'viem/chains'
+import {
+  base,
+  baseSepolia,
+  mainnet,
+  optimismSepolia,
+  unichain,
+} from 'viem/chains'
 
 import type { SupportedChainId } from '@/constants/supportedChains.js'
 import type { Asset } from '@/types/asset.js'
@@ -10,6 +16,7 @@ export const ETH: Asset = {
     [unichain.id]: '0x0000000000000000000000000000000000000000',
     [base.id]: '0x0000000000000000000000000000000000000000',
     [baseSepolia.id]: '0x0000000000000000000000000000000000000000',
+    [optimismSepolia.id]: '0x0000000000000000000000000000000000000000',
   } satisfies Record<SupportedChainId, Address>,
   metadata: {
     decimals: 18,

package/src/constants/supportedChains.ts

@@ -1,10 +1,17 @@
-import { base, baseSepolia, mainnet, unichain } from 'viem/chains'
+import {
+  base,
+  baseSepolia,
+  mainnet,
+  optimismSepolia,
+  unichain,
+} from 'viem/chains'
 
 export const SUPPORTED_CHAIN_IDS = [
   mainnet.id,
   unichain.id,
   base.id,
   baseSepolia.id,
+  optimismSepolia.id,
 ] as const
 
 export type SupportedChainId = (typeof SUPPORTED_CHAIN_IDS)[number]

package/src/lend/namespaces/WalletLendNamespace.ts

@@ -39,6 +39,10 @@ export class WalletLendNamespace<
   /**
    * Open a lending position
    * @description Signs and sends a lend transaction from the wallet for the given amount and asset
+   * @param params - Lending position parameters
+   * @param params.marketId - Market identifier to open position in
+   * @param params.amount - Amount to lend
+   * @returns Promise resolving to transaction receipt
    */
   async openPosition(
     params: LendOpenPositionParams,
@@ -86,8 +90,10 @@ export class WalletLendNamespace<
 
   /**
    * Close a lending position (withdraw from market)
-   * @param closePositionParams - Position closing parameters
-   * @returns Promise resolving to transaction hash
+   * @param params - Position closing parameters
+   * @param params.marketId - Market identifier to close position in
+   * @param params.amount - Amount to withdraw
+   * @returns Promise resolving to transaction receipt
    */
   async closePosition(
     params: ClosePositionParams,

package/src/lend/providers/morpho/sdk.ts

@@ -178,7 +178,6 @@ export async function getVault(params: GetVaultParams): Promise<LendMarket> {
 
   // Morpho sdk doesn't support base sepolia, so we need to use the mock vault
   if (params.marketId.chainId === 84532) {
-    console.log('Using mock vault for base sepolia')
     return createMockVaultData(params.marketId, marketConfig)
   }
 

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/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)