Turnkey

Turnkey provides hardware-backed key custody using passkeys (WebAuthn), with support for email OTP, SMS, and social login. Users authenticate once and get a Solana wallet — Turnkey handles key creation, storage, and secure signing. Gas Station handles everything that happens after the user signs.

How the integration works

Turnkey and Gas Station operate on separate layers:

What Turnkey handles	What Gas Station handles
User authentication (passkeys, email OTP, SMS, social)	Fetching the sponsored fee payer address
Secure key custody	Validating the signed transaction
Prompting the user to sign a transaction	Relaying the transaction to Solana
Returning the signed transaction to your app	Sponsoring the Solana transaction fee

Your app builds a transaction using the fee payer returned by GET /api/transaction/config. Turnkey signs it. Gas Station relays it. The user never pays gas. Turnkey loads as an iframe inside your app and handles authentication and signing in that context. From the relay perspective, your app is the origin.

Demo

The Turnkey demo is a working React application that walks through the full gasless transaction flow:

altude-turnkey-gas-station-demo

Clone the demo to run a complete Turnkey + Gas Station integration on Solana devnet.

The demo covers:

Authentication — Turnkey’s built-in modal handles passkeys, email OTP, SMS, and social login
Wallet provisioning — Users get a Solana wallet automatically on first sign-in
Transaction building — SystemProgram.createAccount with Altude as fee payer
Gasless relay — Signed transactions submitted through POST /api/Account/create and POST /api/Transaction/send
Transaction history — Persistent history with Solscan explorer links
Mock fallback — Runs without an Altude API key, simulating the full flow

Quick setup

1. Get your credentials

You need two things before running the demo:

Turnkey Organization ID and Auth Proxy Config ID — from app.turnkey.com. Follow the Turnkey Getting Started guide to set up your organization and auth proxy.
Altude API key — from app.altude.so. Create an application and copy the devnet key.

2. Clone and configure

git clone https://github.com/AltudePlatform/altude-turnkey-gas-station-demo.git
cd altude-turnkey-gas-station-demo
npm install
cp .env.example .env

Open .env and set your credentials:

# Altude — https://app.altude.so
VITE_ALTUDE_API_KEY_DEVNET=your-devnet-key-here

# Turnkey — https://app.turnkey.com
VITE_TURNKEY_ORGANIZATION_ID=your-org-id-here
VITE_TURNKEY_AUTH_PROXY_CONFIG_ID=your-auth-proxy-config-id-here

3. Run

npm run dev

Open http://localhost:5000. Sign in with Turnkey’s auth modal, create a transaction, and watch Gas Station relay it without the user paying gas.

Adapter pattern

The demo isolates the Turnkey integration in src/wallet/turnkey.tsx. The rest of the app — including Gas Station relay — is provider-agnostic. To see how the adapter interface works, or to adapt this for a different provider, see the integration overview.

Integration overview

Architecture, custody model, and how Gas Station fits alongside any wallet provider.

Gas Station API reference

Full reference for /api/Account/create, /api/Transaction/send, and other endpoints.

Get Started

Wallet Integrations

Get Started by SDK

How the integration works

Demo

altude-turnkey-gas-station-demo

Quick setup

1. Get your credentials

2. Clone and configure

3. Run

Adapter pattern

Integration overview

Gas Station API reference

​How the integration works

​Demo

altude-turnkey-gas-station-demo

​Quick setup

​1. Get your credentials

​2. Clone and configure

​3. Run

​Adapter pattern

​Related

Integration overview

Gas Station API reference

How the integration works

Demo

Quick setup

1. Get your credentials

2. Clone and configure

3. Run

Adapter pattern

Related