Turnkey

1
import { WalletClientSigner } from "@aa-sdk/core";
2
import { alchemy, baseSepolia } from "@account-kit/infra";
3
import { createSmartWalletClient } from "@account-kit/wallet-client";
4
import { Turnkey } from "@turnkey/sdk-server";
5
import { createAccount } from "@turnkey/viem";
6
import { createWalletClient } from "viem";
7
8
const ALCHEMY_API_KEY = "your-alchemy-api-key";
9
const ALCHEMY_GAS_POLICY_ID = "your-gas-policy-id";
10
const TURNKEY_ORGANIZATION_ID = "your-turnkey-org-id";
11
const TURNKEY_API_PRIVATE_KEY = "your-turnkey-api-private-key";
12
const TURNKEY_API_PUBLIC_KEY = "your-turnkey-api-public-key";
13
14
async function createTurnkeySmartWalletClient({
15
  privateKeyId,
16
  walletAddress,
17
}) {
18
  // Initialize Turnkey SDK
19
  const turnkey = new Turnkey({
20
    defaultOrganizationId: TURNKEY_ORGANIZATION_ID,
21
    apiBaseUrl: "https://api.turnkey.com",
22
    apiPrivateKey: TURNKEY_API_PRIVATE_KEY,
23
    apiPublicKey: TURNKEY_API_PUBLIC_KEY,
24
  });
25
26
  // Create a viem account using Turnkey's signing capabilities
27
  const baseTurnkeyAccount = await createAccount({
28
    client: turnkey.apiClient(),
29
    organizationId: TURNKEY_ORGANIZATION_ID,
30
    signWith: privateKeyId,
31
    ethereumAddress: walletAddress,
32
  });
33
34
  // Wrap the account to fix the double 0x prefix bug in @turnkey/viem 0.14.8
35
  const turnkeyAccount = {
36
    ...baseTurnkeyAccount,
37
    signAuthorization: async (authorization) => {
38
      if (!baseTurnkeyAccount.signAuthorization) {
39
        throw new Error("signAuthorization not available on Turnkey account");
40
      }
41
      const result = await baseTurnkeyAccount.signAuthorization(authorization);
42
43
      // Strip the extra 0x prefix if present
44
      return {
45
        ...result,
46
        r: result.r.replace(/^0x0x/, "0x"),
47
        s: result.s.replace(/^0x0x/, "0x"),
48
      };
49
    },
50
  };
51
52
  // Create wallet client with Turnkey account
53
  const walletClient = createWalletClient({
54
    account: turnkeyAccount,
55
    chain: baseSepolia,
56
    transport: alchemy({ apiKey: ALCHEMY_API_KEY }),
57
  });
58
59
  // Create signer from wallet client
60
  const signer = new WalletClientSigner(walletClient, "turnkey-custom");
61
62
  // Create and return the Smart Wallet client
63
  return createSmartWalletClient({
64
    chain: baseSepolia,
65
    transport: alchemy({ apiKey: ALCHEMY_API_KEY }),
66
    signer,
67
    policyId: ALCHEMY_GAS_POLICY_ID,
68
  });
69
}

1
const TURNKEY_PRIVATE_KEY_ID = "your-private-key-uuid";
2
const TURNKEY_WALLET_ADDRESS = "0x...";
3
4
async function sendTransaction() {
5
  console.log("Wallet address:", TURNKEY_WALLET_ADDRESS);
6
7
  // Create Smart Wallet client from Turnkey wallet
8
  const client = await createTurnkeySmartWalletClient({
9
    privateKeyId: TURNKEY_PRIVATE_KEY_ID,
10
    walletAddress: TURNKEY_WALLET_ADDRESS,
11
  });
12
13
  // Send a gasless transaction with EIP-7702
14
  const result = await client.sendCalls({
15
    from: TURNKEY_WALLET_ADDRESS,
16
    calls: [
17
      {
18
        to: "0x0000000000000000000000000000000000000000",
19
        value: "0x0",
20
        data: "0x",
21
      },
22
    ],
23
    capabilities: {
24
      eip7702Auth: true,
25
      paymasterService: {
26
        policyId: ALCHEMY_GAS_POLICY_ID,
27
      },
28
    },
29
  });
30
31
  console.log("Transaction sent:", result.preparedCallIds[0]);
32
}

1
async function sendAndWaitForTransaction() {
2
  const client = await createTurnkeySmartWalletClient({
3
    privateKeyId: TURNKEY_PRIVATE_KEY_ID,
4
    walletAddress: TURNKEY_WALLET_ADDRESS,
5
  });
6
7
  const result = await client.sendCalls({
8
    from: TURNKEY_WALLET_ADDRESS,
9
    calls: [
10
      {
11
        to: "0x0000000000000000000000000000000000000000",
12
        value: "0x0",
13
        data: "0x",
14
      },
15
    ],
16
    capabilities: {
17
      eip7702Auth: true,
18
      paymasterService: {
19
        policyId: ALCHEMY_GAS_POLICY_ID,
20
      },
21
    },
22
  });
23
24
  console.log("Waiting for confirmation...");
25
26
  // Wait for the transaction to be confirmed
27
  const txStatus = await client.waitForCallsStatus({
28
    id: result.preparedCallIds[0],
29
    timeout: 60_000, // 60 seconds
30
  });
31
32
  const txnHash = txStatus.receipts?.[0]?.transactionHash;
33
34
  console.log("Transaction confirmed!");
35
  console.log("Transaction hash:", txnHash);
36
}

1
const result = await client.sendCalls({
2
  from: TURNKEY_WALLET_ADDRESS,
3
  calls: [
4
    { to: "0x...", data: "0x...", value: "0x0" },
5
    { to: "0x...", data: "0x...", value: "0x0" },
6
    { to: "0x...", data: "0x...", value: "0x0" },
7
  ],
8
  capabilities: {
9
    eip7702Auth: true,
10
    paymasterService: {
11
      policyId: ALCHEMY_GAS_POLICY_ID,
12
    },
13
  },
14
});