Wallet TON Overview
Overview of the @tetherto/wdk-wallet-ton module
A simple and secure package to manage BIP-44 wallets for the TON blockchain. This package provides a clean API for creating, managing, and interacting with TON wallets using BIP-39 seed phrases and TON-specific derivation paths.
Default Derivation Path Change in v1.0.0-beta.6+
The default derivation path was updated in v1.0.0-beta.6 to match ecosystem conventions:
- Previous path (<= v1.0.0-beta.5):
m/44'/607'/0'/0/{index} - Current path (v1.0.0-beta.6+):
m/44'/607'/{index}'
If you're upgrading from an earlier version, existing wallets created with the old path will generate different addresses. Make sure to migrate any existing wallets or use the old path explicitly if needed for compatibility.
Use getAccountByPath to supply an explicit derivation path when importing or recreating legacy wallets.
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
- Transaction Management: Send transactions and get fee estimates
- Jetton Support: Query native TON and Jetton token balances
- TypeScript Support: Full TypeScript definitions included
- Memory Safety: Secure private key management with automatic memory cleanup using sodium-universal
- Provider Flexibility: Support for custom TON RPC endpoints and TON Center API
Supported Networks
This package works with the TON blockchain (The Open Network), including:
- TON Mainnet
- TON Testnet
Next Steps
Node.js Quickstart
Get started with WDK in a Node.js environment
WDK TON Wallet Configuration
Get started with WDK's TON Wallet configuration
WDK TON Wallet API
Get started with WDK's TON Wallet API
WDK TON Wallet Usage
Get started with WDK's TON Wallet usage