Gasless TON wallet

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

The current published release is v1.0.0-beta.11. Beta.10 validates relay estimates before quoting, signing, or submitting a gasless transfer. Beta.11 adds normalized transaction lookup and waiting for the signed message-body hash returned by transfer().

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?