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 v1.0.0-beta.13. Managers share TON RPC and TON API clients across derived accounts. The release also inherits TON beta.15's domain-separated message signatures, which are incompatible with earlier gasless-wallet signatures.

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
• 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?