Gasless TON wallet

Use the gasless TON wallet module when your app needs Jetton transfers without requiring users to hold TON for fees.

These pages reflect @tetherto/wdk-wallet-ton-gasless@1.0.0-beta.17. Managers share TON RPC and TON API clients across derived accounts. Message signing uses a domain-separated digest.

Gasless transfer quotes and execution require globalThis.crypto.getRandomValues() to generate Jetton query IDs. Ensure Web Crypto is available before using these flows.

Features

• BIP-39 Seed Phrase Support: Generate and validate BIP-39 mnemonic seed phrases
• TON Derivation Paths: Support for BIP-44 standard derivation paths for TON (m/44'/607')
• Multi-Account Management: Create and manage multiple accounts from a single seed phrase
• TON Address Support: Generate and manage TON addresses using V5R1 wallet contracts
• Message Signing: Sign and verify messages using TON cryptography
• Gasless Jetton Transfers: Transfer Jettons with fees paid in a supported paymaster Jetton
• Verified Jetton Wallets: Check the sender's transfer and paymaster Jetton wallets before returning quotes or relaying transfers
• Paymaster Integration: Built-in support for paymaster-based fee delegation
• Relay Estimate Validation: Reject estimates that change the requested Jetton transfer, sender, relay, expiry, message set, or paymaster commission transfer
• Normalized Transaction Status: Read or wait for the returned message-body hash with TON confirmed and final states and the native transaction attached
• Jetton Support: Query native TON and Jetton token balances
• TypeScript Support: Full TypeScript definitions included
• Derived Key Cleanup: Account disposal zeroes derived private key bytes with sodium-universal
• Provider Flexibility: Support for both TON Center and TON API endpoints

Supported Networks

This package works with the TON blockchain (The Open Network), including:

• TON Mainnet
• TON Testnet

Next Steps

---

Need Help?