sponsor: true on a send to sponsor it, or sponsor: false to have the wallet pay. Either way, Turnkey constructs, signs, broadcasts, and tracks the transaction; the flag only controls who pays the fee.
You can also integrate your own gas service where your transaction flow supports it. See AA wallets for examples of third-party sponsorship integrations.
Enable sponsorship
Enable Gas Sponsorship for your organization in the Turnkey dashboard, then send withsponsor: true and the caip2 of a supported chain.
Gas Sponsorship is available on Pay-as-you-go, Pro, and Enterprise plans.
- Pay-as-you-go: Up to $10 per month
- Pro: Up to $25 per month
- Enterprise: Unlimited spend, with configurable time windows
Sponsor Solana Rent is disabled by default and must be enabled in the dashboard before Turnkey pre-funds rent for account creation. See Solana Rent Sponsorship.
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.
Check gas usage
Query current usage against the active limit withget_gas_usage. We recommend checking a sub-organization’s usage on the client side, so your application can handle a user approaching or exceeding the limit, and monitoring your organization-wide usage regularly.
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.Sponsorship contracts and security
On EVM chains, sponsorship runs through Turnkey’s own gas station contracts, which are open source on GitHub and optimized to reduce the gas overhead of each sponsored transaction. Some gas sponsorship setups are subject to replay attacks: if the provider’s infrastructure is compromised, one sponsorship request can be replayed with different nonces to create several transactions. Turnkey constructs transactions in enclaves, and as long as the request includes the relevant nonce or blockhash, only one transaction can be created from it. The user’s authenticator signs the request and the enclave verifies the signature, so a malicious actor cannot modify or replay it. If you omitgasStationNonce, Turnkey fetches it when the transaction is built, so it is not part of the signed request. For this guarantee on EVM, fetch it with get_nonces and pass it as gasStationNonce.
Policies apply the same way to sponsored and non-sponsored transactions. Some eth.tx fields differ when a transaction is sponsored:
gasandgas_priceare 0, andmax_fee_per_gasandmax_priority_fee_per_gasare not set.typeis a gas station type, such asTK_GAS_STATION_V1, instead ofTYPE_2.nonceis the gas station nonce.