Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.turnkey.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Overview

Traditionally, sending blockchain transactions onchain has been painful:
  • You need to fund wallets with native gas tokens, creating onboarding friction
  • Network congestion and fee spikes can cause transactions to stall or get dropped altogether
Turnkey reduces this to a couple of API calls. We handle fees and our battle-tested broadcast logic ensures inclusion even under adverse network conditions. You and your users never touch gas tokens or deal with stuck transactions.

​
Supported chains

EVM (sponsored):
  • Base - eip155:8453
  • Polygon - eip155:137
  • Ethereum - eip155:1
  • Arbitrum - eip155:42161
EVM testnets (sponsored):
  • Base (Sepolia) - eip155:84532
  • Polygon (Amoy) - eip155:80002
  • Ethereum (Sepolia) - eip155:11155111
  • Arbitrum (Sepolia) - eip155:421614
Solana (sponsored):
  • Solana mainnet - solana:mainnet
  • Solana devnet - solana:devnet
Interested in another chain? Reach out to us!
To access sponsored transactions, ensure that Gas Sponsorship is first enabled within your Turnkey dashboard. Then set sponsor: true and update the caip2 parameter with the corresponding chain identifier.

​
Concepts

​
Gas sponsorship (aka gas abstraction, gasless transactions, fee abstraction)

A single endpoint lets you toggle between standard and sponsored transactions. With sponsorship enabled, your users never need to hold native tokens to pay transaction fees — Turnkey covers them. Set sponsor: true to enable sponsorship, or sponsor: false to have fees paid by the sender’s wallet. Either way, Turnkey handles construction, signing, broadcast, and status monitoring. The sponsor flag only controls who pays the fee.
Gas Sponsorship is available on Pro and Enterprise plans.
  • Pro: Up to $50/day across your organization. Sub-organization spending limits can be configured freely up to the $50/day ceiling.
  • Enterprise: Unlimited spend, with configurable time windows
Pay-as-you-go customers can still access transaction construction, signing, and broadcast. If you’d like to leverage gas sponsorship, please reach out!

​
Spend limits

Turnkey gives you USD-denominated controls over gas sponsorship spend at two levels:
  • Organization-wide limit — the cap on total sponsored spend across your parent organization and all of its sub-organizations.
  • Sub-organization limit — the cap that applies to each of your sub-organizations
What you can configure depends on your plan:
ProEnterprise
Organization-wide limitUp to $50/dayFully configurable, no limits
IntervalDaily onlyMinutes, hours, daily, weekly, or monthly
Sub-organization limitsConfigurable up to the $50/day org limitFully configurable, no limits
You can set limit values and time intervals through the dashboard. You can also query current usage against the active limit via the get_gas_usage endpoint.
Turnkey provides fee sponsorship and transaction broadcasting services only. In high-fee or congested network conditions, delays or non-inclusion may occur. It is the developer’s responsibility to ensure appropriate spend limits are in place.

​
Policy engine

You can write policies against both sponsored and non-sponsored transactions using Turnkey’s policy DSL:
  • EVM: use the eth.tx namespace
  • Solana: use the solana.tx namespace
This means you can seamlessly switch between sponsored and non-sponsored transactions and still use the same policies. Note: Turnkey sets all fee-related fields to 0 for sponsored transactions.

​
Billing

Turnkey passes transaction fee costs through to you as a line item at the end of the month. You pay based on the USD value of fees at time of broadcast; Turnkey internalizes the inventory risk of token price changes. Our battle-tested fee estimation aims to be cost-efficient while ensuring quick transaction inclusion.

​
Advanced

​
Gas sponsorship smart contracts (EVM)

We could not find a satisfactory setup for gas sponsorship contracts that were both fast and safe, so we made our own. The contracts are open source and you can check them out on GitHub. Based on our benchmarks, these are the most efficient gas sponsorship contracts on the market. They achieve this through optimized logic, calldata encoding, and extensive use of assembly, which reduces gas overhead per sponsored transaction. The result: lower costs for you and faster execution for your users.

​
Security

Some gas sponsorship setups by other providers are subject to replay attacks. If a malicious actor compromises the provider infrastructure, they can replay the gas sponsorship request multiple times with different nonces to create multiple transactions from a single request. At Turnkey, we never cut corners on security: we perform transaction construction in enclaves, and as long as the request includes the relevant nonce or blockhash, only one transaction can be created from it. Since the user’s authenticator signs requests and the enclave verifies signatures, a malicious actor cannot modify or replay the request. This is in line with Turnkey’s core system design principle: everything can be compromised outside of the enclaves and funds will still be safe. By default, our SDKs include a special gas station nonce for sponsored transaction requests.

​
RPCs

Turnkey’s send transaction and transaction status endpoints eliminate the need for third-party RPC providers. You save costs and reduce latency because we holistically incorporate internal data and minimize external calls.

​
Next steps

For implementation guides, see: