Gasless Solana wallet
Overview of the @tetherto/wdk-wallet-solana-gasless module.
The @tetherto/wdk-wallet-solana-gasless module manages Solana accounts that send transactions through a Kora-compatible paymaster. It wraps the standard Solana wallet module and adds paymaster-funded native SOL sends, SPL token transfers, fee quotes, message signing, and read-only account support.
These pages document the published @tetherto/wdk-wallet-solana-gasless@1.0.0-beta.4 package. Test your Solana RPC and Kora-compatible paymaster configuration on the target network before production use.
This module requires a Solana RPC endpoint and a Kora-compatible paymaster endpoint. The paymaster address becomes the transaction fee payer, and fees are quoted in the configured paymaster token's base units.
Features
- Gasless Solana Transactions: Quote, sign, and send native SOL transfers through a paymaster.
- Signed Transaction Handoff: Inspect the exact fully signed transaction returned by this account, then send it through the configured Solana RPC without contacting the paymaster again.
- SPL Token Transfers: Transfer SPL tokens and create the recipient associated token account when needed.
- Paymaster Fee Quotes: Estimate paymaster token fees before sending.
- Validated Paymaster Responses: For unsigned flows, derive the charged amount from a recognized SPL token transfer to the configured paymaster token account instead of trusting separate paymaster metadata.
- Normalized Transaction Status: Read processed, confirmed, and finalized signature states, or wait for a target finality level.
- Per-Operation Overrides: Override the paymaster token for unsigned quote, sign, send, or transfer calls; use
transactionMaxFeefor send/sign caps andtransferMaxFeefor transfer caps. - SLIP-0010 Derivation Paths: Use the same Solana derivation path behavior as
@tetherto/wdk-wallet-solana. - Read-Only Accounts: Check balances, quote fees, read transaction finality, and verify signatures for an address without a private key.
- Message Signing: Sign and verify messages with Ed25519 account keys.
- Provider Failover: Pass ordered RPC or paymaster endpoint lists with retry behavior.
- TypeScript Support: Use bundled type declarations for the module classes and config types.
Beta.4 does not treat an arbitrary signed transaction as fail-closed input. If no matching payment instruction is found, signed quote/send returns a fee of 0n, which can pass transactionMaxFee before direct RPC broadcast. Only pass the exact FullySignedTransaction produced by signTransaction() for the same account and configuration, or independently decode and verify the payment instruction, fee payer, lifetime, account and paymaster signatures, and intended instructions before broadcast.
Supported Networks
The module works with Solana RPC providers and Kora-compatible paymasters on networks where your paymaster is deployed and funded:
- Solana Mainnet Beta
- Solana Devnet
- Solana Testnet
Key Exports
| Export | Purpose |
|---|---|
WalletManagerSolanaGasless | Default export for deriving and caching gasless Solana accounts from a seed. |
WalletAccountSolanaGasless | Owned account with signing, transfer, quote, and paymaster send methods. |
WalletAccountReadOnlySolanaGasless | Read-only account for balances, quotes, receipts, and signature verification. |
Next Steps
Get Started
Install the package and create a gasless Solana account.
Configuration
Configure Solana RPC, paymaster endpoints, fee tokens, and failover.
Send Transactions
Quote, sign, and send paymaster-funded Solana transactions.
API Reference
Review exported classes, methods, and configuration types.