Getting started with Turnkey
Welcome to Turnkey! To make the most out of Turnkey’s wallet infrastructure, we’ve compiled a list of helpful resources for you below.
About
Turnkey is highly flexible key management infrastructure, purpose-built for security and scale. Our API and open-source SDKs make it easy for you to take your product from 0 to 1, and enable developers to create millions of embedded wallets and automate complex onchain transactions.
Whether you’re building a DeFi platform, a payments app, an AI agent, or anything requiring a private key, Turnkey offers the building blocks to bring your ideas to life.
Our solution covers two main use cases:
Concepts Overview
Before getting started, we highly recommend familiarizing yourself with Turnkey’s core concepts below to ensure a smooth implementation.
At the core of Turnkey is an important concept: instead of directly managing private keys, wallets are accessed through authenticators like passkeys, social logins, or API keys:
Here’s how that works:
- Organizations (parent orgs) in Turnkey are top-level entities that contain users, wallets, and policies for a business, with the initial “parent organization” typically representing an entire Turnkey-powered application.
- Parent organizations can create sub-organizations (sub-orgs), which are fully segregated organizations nested under the parent organization. Parent orgs cannot modify the contents of a sub-org, and sub-orgs and typically represent an end user.
- Both parent organizations and sub-organizations contain a set of resources and authenticators that you can configure, including their own users, wallets, API keys, private keys, and policies.
- Activities (like signing transactions or creating users) are governed by policies created via Turnkey’s policy engine, though root users can bypass the policy engine when meeting root quorum requirements.
- Wallets in Turnkey are HD seed phrases that can generate multiple wallet accounts (addresses) for signing operations.
There is no set relationship between organizations, sub-organizations, activities, wallets, and resources. This makes Turnkey highly flexible and configurable to any use case.
For a more in-depth overview, access our documentation here.
Demos And Examples
Embedded wallet demo app (web)
Flutter (mobile) demo app
Telegram mini-app demo
Pop-up wallet demo
React native demo wallet (mobile, web)
Wallet Kit (pre-generated UI components for user authentication)
Building a trading bot on Solana: Guide
Feature spotlight: Send crypto via a URL
Moonshot users can now send crypto to their friends via a URL. Under the hood, Turnkey pre-generates a wallet for the new user and loads it with the specified amount of crypto — all authenticated via a biometric passkey (e.g. Face ID).
To see Turnkey in action, check out some of our favorite customer integrations:
- Moonshot: An app that makes trading crypto as easy as buying stocks.
- Infinex: A crypto app to access everything onchain in one place. Founded by Kain from Synthetix.
- Azura: A next-generation DeFi platform to make onchain trading easier.
- PVP Trade: A SocialFi experience to trade tokens with friends on Telegram.
- Spectral: A platform for creating onchain AI agents.
SDKs
Turnkey provides a variety of client libraries for interacting with Turnkey’s API and performing common workflows, as well as several wrappers for popular web3 libraries for easy integration into existing dApps.
Integration | Package |
---|---|
JavaScript Browser | @turnkey/sdk-browser |
JavaScript Server | @turnkey/sdk-server |
React | @turnkey/sdk-react |
React Native | See React Native passkey stamper for more details |
Golang | go-sdk |
Rust | rust-sdk |
Ruby | ruby-sdk |
Command Line | Using the CLI |
Flutter/Dart | All packages published here |
Swift | swift-sdk |
Ethers | @turnkey/ethers |
Viem | @turnkey/viem |
CosmJS | @turnkey/cosmjs |
EIP-1193 | @turnkey/eip-1193-provider |
Solana | @turnkey/solana |
Advanced | See docs for more details |
Security
We take security seriously at Turnkey and have built our architecture to ensure that you and your end users’ private keys are safe. Our whitepaper covers our holistic security model in-depth and our vision for building verifiable key management infrastructure.
Support
For support, product feedback, and input, join our community Slack channel here.