TON DocsTON Docs
AppKitHow to

AppKit how-to guides

How-to guides explain how AppKit features work, then show the code path for using them in an app.

Follow these guides when you need both the model behind a feature and the practical code that drives it. For installation and the minimum setup, use Get started guides.

Every how-to guide assumes an AppKit instance and the React provider are already mounted unless it is showing setup. Code samples use public package imports and keep product-state decisions separate from wallet approval.

Core setup

GuideWhat it covers
Set up AppKitRuntime state, configuration, lifecycle, and React provider setup.
Connect to a walletWallet and connector model, connect UI, selected wallet, and errors.
Use providersI clients, streaming providers, swap providers, and staking setup.
Configure networksMainnet, testnet, default network, API clients, and mismatch checks.

Wallet data and assets

GuideWhat it covers
Read balancesGram and jetton reads for the selected wallet or any address.
Send GramGram transfer flow, amount handling, and settlement checks.
Send jettonsJetton metadata, decimals, transfer requests, and settlement checks.
Manage NFTsNFT reads, rendering, transfer requests, and ownership verification.
Sign dataText, binary, and cell signatures with verifier-side checks.
Use streamingLive balance, jetton, and transaction updates.

Product flows

GuideWhat it covers
Perform swapsQuote freshness, provider routing, build flow, and settlement.
Stake and unstakeStake and unstake quotes, provider metadata, balances, and sends.
Use on-rampsFiat redirects, crypto deposits, provider status, and completion.
Send gasless transactionsJetton-paid fees, relayer estimates, wallet signing, and sends.
Use UI widgetsDefault UI, render props, hooks, and vertical flow components.

On this page