WalletKit overview
Section overview
| Goal | Read |
|---|---|
| Use WalletKit to integrate a wallet on the Web | Web |
| Use WalletKit to integrate a wallet on iOS | iOS |
| Use WalletKit to integrate a wallet on Android | Android |
| Dive into the QA flow and manual TON Connect integration | Deep dive |
What WalletKit is
WalletKit is an open-source SDK for custodial and non-custodial wallet services that need to integrate with the TON ecosystem. Supported platforms include Web, mobile (Android and iOS), and browser extensions.
With WalletKit, custodial and non-custodial wallet providers gain full control over key management, signing, and access. It's designed for both small wallet services and large cross-chain systems.
Features
WalletKit provides the following features:
- TON Connect: Built-in support for TON Connect — a standard GRAM wallet connection protocol
- Wallet management: Support for multiple GRAM wallets at once, with persistent storage and optional use of custom signers
- Asset support: Gram, jettons (including USDT), NFTs with metadata
- Action previews: Transaction emulation with money flow analysis
- Advanced flows: Gasless and one-click interactions through TON Connect features such as Sign Message and Embedded Requests
WalletKit is the wallet-side counterpart to AppKit — an SDK for integrating TON into dApps.
Packages
| Package | Use |
|---|---|
@ton/walletkit | Core wallet primitives: key management, accounts, TON Connect |
@ton/walletkit/bridge | JS Bridge injector for in-app browsers |
@ton/walletkit/swap/omniston | Omniston swap integration |
@ton/walletkit/swap/dedust | DeDust swap integration |
@ton/walletkit/staking/tonstakers | Tonstakers staking integration |
Examples
Explore the complete demo wallets on GitHub:
Get started
You can integrate your custodial wallet with TON or partially build a basic wallet from scratch.
To get started, select your framework or environment and install WalletKit:
Then, follow usage recipes in the respective sections.
See also
To implement custom wallet logic, you may need to explore in-depth topics:
- Deep dive: QA and manual integration
- TON Connect
- Standard contracts
- Messages & transactions and other primitives