Skip to main content

Signing Transactions

This is a guide to signing transactions in the browser context. While these snippets leverage Ethers, it can be swapped out for other signers in the Viem or Solana contexts. See here for an example with both Ethers and Viem in the passkey + browser context, and here for a similar example with Solana.

Steps using @turnkey/sdk-react​

This process is made the most seamless by leveraging our React package. Read on for a non-React implementation.

1. Initialize the React Provider​

import { TurnkeyProvider } from "@turnkey/sdk-react";
const turnkeyConfig = {
  apiBaseUrl: "https://api.turnkey.com",
  defaultOrganizationId: process.env.TURNKEY_ORGANIZATION_ID, // prefix with NEXT_PUBLIC for NextJS
  rpId: process.env.RPID, // your application's domain
  iframeUrl: "https://auth.turnkey.com"
}

...

<div className="App">
  <TurnkeyProvider config={turnkeyConfig}>
  // Rest of app ...
  </TurnkeyProvider>
</div>

2. Initialize an Ethers Provider and Turnkey Signer using the Passkey Client​

import { ethers } from "ethers";
import { TurnkeySigner } from "@turnkey/ethers";

import { useTurnkey } from "@turnkey/sdk-react";
const { turnkey, passkeyClient } = useTurnkey();

const provider = new ethers.JsonRpcProvider(<provider api url>);
const currentUser = await turnkey.getCurrentUser();
const turnkeySigner = new TurnkeySigner({
  client: passkeyClient,
  organizationId: currentUser.organization.organizationId,
  signWith: "<wallet address to sign with>"
})
const connectedSigner = turnkeySigner.connect(provider);

3. Call sendTransaction with the Turnkey Signer​

const transactionRequest = {
  to: "<destination address>",
  value: ethers.parseEther("<amount to send>"),
  type: 2,
};
const sendTransaction =
  await connectedSigner.sendTransaction(transactionRequest);

Alternative Steps (non-React)​

1. Initialize the Passkey Client​

import { Turnkey } from "@turnkey/sdk-browser";

const turnkey = new Turnkey({
  apiBaseUrl: "https://api.turnkey.com",
  defaultOrganizationId: process.env.TURNKEY_ORGANIZATION_ID,
});
const passkeyClient = turnkey.passkeyClient();

2. Initialize an Ethers Provider and Turnkey Signer​

import { ethers } from "ethers";
import { TurnkeySigner } from "@turnkey/ethers";

const provider = new ethers.JsonRpcProvider(<provider api url>);
const currentUser = await turnkey.getCurrentUser(); // assumes user details have been stored in LocalStorage via `login()`
const turnkeySigner = new TurnkeySigner({
  client: passkeyClient,
  organizationId: currentUser.organization.organizationId,
  signWith: "<wallet address to sign with>"
})
const connectedSigner = turnkeySigner.connect(provider);

3. Call sendTransaction with the Turnkey Signer​

const transactionRequest = {
  to: "<destination address>",
  value: ethers.parseEther("<amount to send>"),
  type: 2,
};
const sendTransaction =
  await connectedSigner.sendTransaction(transactionRequest);