In this guide, we’ll explore how to leverage the WalletClient
in the Turnkey SDK to authenticate requests to Turnkey’s API using either Solana or Ethereum wallets.
apiBaseUrl
: The base URL of the Turnkey API: https://api.turnkey.com
.defaultOrganizationId
: Your parent organization ID, which you can find in the Turnkey dashboard.wallet
: The wallet interface used to sign requests. In this example, we’ll use the EthereumWallet
interface.TurnkeyProvider
in your app/layout.tsx
file.
As this file is required by Next.js to be a server component, we need to define a TurnkeyClientProvider
client component.
app/page.tsx
where we’ll implement the wallet authentication functionality:
@turnkey/sdk-server
package. This setup enables you to authenticate requests to Turnkey’s API using the parent organization’s public/private API key pair. This is required to create new sub-organizations on behalf of a user.
"use server"
directive at the top of the file where you’re initializing the Turnkey server client. This will ensure that the function is executed on the server-side and will have access to the server-side environment variables e.g. your parent organization’s public/private API key pair. For more information on Next.js server actions, see the Next.js documentation on Server Actions and Mutations.getPublicKey
method on the WalletClient
instance which will retrieve the public key from the user’s wallet.
app/page.tsx
file we created earlier importing the getSubOrg
function we defined in our server action. We’ll use the getSubOrg
function in the login method to check if a user already has a sub-organization.
createSubOrg
to create a sub-organization for new user sign-ups.createSubOrg
function within the login method. The curve type is set to API_KEY_CURVE_SECP256K1
since we’re using an Ethereum wallet in this example.loginWithWallet
method on the WalletClient
instance which will use a newly generated indexedDb
API key. This will save a read-write session token to the localStorage
to authenticate future read-write requests.
personal_sign
for Ethereum, we’ll need to build a couple of things:
SolanaWalletInterface
to build our own SolanaWallet()
function that would get the public key and sign a message. Create this new SolanaWalletFactory.ts
component: