Discover and install building blocks to extend your WDK integration.
@tetherto/wdk-wallet-solana-gasless
WDK wallet module for gasless Solana transactions through a Kora-compatible paymaster.
Loading README…
Full Changelog: https://github.com/tetherto/wdk-wallet-solana-gasless/compare/v1.0.0-beta.1...v1.0.0-beta.2
Note: This package is currently in beta. Please test thoroughly in development environments before using in production.
A simple and secure package to manage gasless Solana wallet operations. This package provides a clean API for creating, managing, and interacting with Solana accounts using BIP-39 seed phrases and Solana-specific derivation paths, with paymaster support for sponsored transaction fees.
This module is part of the WDK (Wallet Development Kit) project, which empowers developers to build secure, non-custodial wallets with unified blockchain access, stateless architecture, and complete user control.
For detailed documentation about the complete WDK ecosystem, visit docs.wdk.tether.io.
m/44'/501')provider and paymasterUrl may also be arrays. When arrays are provided, the wallet uses failover behavior and retries requests against the configured providers.
For support, please open an issue on GitHub or reach out via email.
Contributions are welcome! Please feel free to submit a Pull Request.
This project is licensed under the Apache License 2.0 - see the LICENSE file for details.
npm install @tetherto/wdk-wallet-solana-gaslessimport { WalletAccountSolanaGasless } from '@tetherto/wdk-wallet-solana-gasless'
const seedPhrase = 'abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon about'
const account = new WalletAccountSolanaGasless(seedPhrase, "0'/0'", {
provider: 'https://api.devnet.solana.com',
commitment: 'confirmed',
paymasterUrl: 'https://your-kora-paymaster.example',
paymasterAddress: 'Paymaster111111111111111111111111111111111',
paymasterToken: {
address: 'TokenMint111111111111111111111111111111111'
},
transferMaxFee: 1000000n
})
const address = await account.getAddress()
console.log('Address:', address)
account.dispose()const config = {
provider: 'https://api.mainnet-beta.solana.com',
// rpcUrl is also supported as a deprecated alias for provider.
commitment: 'confirmed',
retries: 3,
paymasterUrl: 'https://your-kora-paymaster.example',
// Solana program address used as the transaction fee payer.
paymasterAddress: 'Paymaster111111111111111111111111111111111',
paymasterToken: {
address: 'TokenMint111111111111111111111111111111111'
},
transferMaxFee: 1000000n
}import { WalletAccountSolanaGasless } from '@tetherto/wdk-wallet-solana-gasless'
const account = new WalletAccountSolanaGasless(seedPhrase, "0'/0'", config)
console.log(await account.getAddress())import { WalletAccountReadOnlySolanaGasless } from '@tetherto/wdk-wallet-solana-gasless'
const readOnlyAccount = new WalletAccountReadOnlySolanaGasless('SolanaAddress...', {
provider: 'https://api.devnet.solana.com',
paymasterUrl: 'https://your-kora-paymaster.example',
paymasterAddress: 'Paymaster111111111111111111111111111111111',
paymasterToken: {
address: 'TokenMint111111111111111111111111111111111'
}
})
const balance = await readOnlyAccount.getBalance()
console.log('SOL balance:', balance)const tokenBalance = await account.getTokenBalance('TokenMint111111111111111111111111111111111')
console.log('Token balance:', tokenBalance)
const balances = await account.getTokenBalances([
'TokenMint111111111111111111111111111111111',
'OtherMint1111111111111111111111111111111111'
])
console.log('Token balances:', balances)
const paymasterTokenBalance = await account.getPaymasterTokenBalance()
console.log('Paymaster token balance:', paymasterTokenBalance)const quote = await account.quoteTransfer({
token: 'TokenMint111111111111111111111111111111111',
recipient: 'Recipient1111111111111111111111111111111',
amount: 1000000n
})
console.log('Paymaster fee:', quote.fee)const override = {
paymasterToken: {
address: 'AlternateFeeMint11111111111111111111111111'
},
transferMaxFee: 500000n
}
const quote = await account.quoteTransfer({
token: 'TokenMint111111111111111111111111111111111',
recipient: 'Recipient1111111111111111111111111111111',
amount: 1000000n
}, override)
const result = await account.transfer({
token: 'TokenMint111111111111111111111111111111111',
recipient: 'Recipient1111111111111111111111111111111',
amount: 1000000n
}, override)
console.log('Quoted fee:', quote.fee)
console.log('Transaction hash:', result.hash)const result = await account.transfer({
token: 'TokenMint111111111111111111111111111111111',
recipient: 'Recipient1111111111111111111111111111111',
amount: 1000000n
})
console.log('Transaction hash:', result.hash)
console.log('Paymaster fee:', result.fee)const result = await account.sendTransaction({
to: 'Recipient1111111111111111111111111111111',
value: 10000n
}, {
paymasterToken: {
address: 'AlternateFeeMint11111111111111111111111111'
}
})
console.log('Transaction hash:', result.hash)
console.log('Paymaster fee:', result.fee)const message = 'Hello, Solana!'
const signature = await account.sign(message)
const isValid = await account.verify(message, signature)
console.log('Signature valid:', isValid)account.dispose()