Skip to main content

Documentation Index

Fetch the complete documentation index at: https://companyname-a7d5b98e-feature-fumodocs.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

AppKit ships as two paired packages — @ton/appkit and @ton/appkit-react — that version together. Each release below lists the matching pair, and pulls in notable changes from the underlying @ton/walletkit when they affect AppKit consumers. AppKit is early-stage. Pin a known-good version in package.json and review this page before upgrading.

​
@ton/appkit 0.0.4 — 2026-03-25

Paired with @ton/appkit-react 0.0.5 · @ton/walletkit 0.0.11. Added
  • getMasterchainInfo on ApiClient (implemented in ApiClientToncenter and ApiClientTonApi).
  • getBlockNumber core action in @ton/appkit.
  • useBlockNumber React hook in @ton/appkit-react.
  • ApiClientTonApi gained or improved: jettonsByOwnerAddress, nftItemsByAddress, nftItemsByOwner, runGetMethod, getAccountTransactions, getTransactionsByHash, getTrace, getPendingTrace, getEvents, getMasterchainInfo.
  • connectionEventFromUrl for handling a TON Connect connect event in the same place the URL is received (via @ton/walletkit).
  • Log levels configurable from environment (via @ton/walletkit).
Changed (breaking)
  • SwapQuote and SwapQuoteParams: amount, fromAmount, toAmount, and minReceived changed type from TokenAmount to string. These fields now carry already-formatted, human-readable values; TokenAmount remains the raw nano representation.
Changed
  • Switched to the public @tonconnect/bridge-sdk package (via @ton/walletkit).

​
@ton/appkit 0.0.3 — 2026-03-06

Paired with @ton/appkit-react 0.0.4 · @ton/walletkit 0.0.10. Added
  • Support for the Tetra network and ApiClientTonApi implementation.
  • getDefaultNetwork, setDefaultNetwork, watchDefaultNetwork core actions.
  • useDefaultNetwork and useNetworks React hooks.
  • Internal event-bus subscription for defaultNetwork updates.
  • TonConnectConnector now subscribes to NETWORKS_EVENTS.DEFAULT_CHANGED for automatic network switching when the wallet reports a network change.
Changed (breaking)
  • React hook rename: useNFTsByAddress → useNftsByAddress.
  • ApiClient.sendBoc return value now uses a 0x-prefixed hex string.
Fixed
  • Infinite re-render in useNetworks.
Internal
  • API clients refactored over a shared abstract BaseApiClient.

​
@ton/appkit 0.0.2 — 2026-02-26

Paired with @ton/appkit-react 0.0.3 · @ton/walletkit 0.0.9. Added
  • getTransactionStatus accepts either a BOC or a hash.
Changed (breaking)
  • ApiClient.sendBoc adds the 0x prefix to the returned hash.

​
@ton/appkit 0.0.1

Paired with @ton/appkit-react 0.0.1.
  • Initial alpha release.

​
Upgrade notes

The breaking changes worth a code-level review:
  • SwapQuote amounts as strings (0.0.4). Anything that treated SwapQuote.amount, fromAmount, toAmount, or minReceived as nano TokenAmount values needs to handle them as already-formatted decimal strings. Raw nano values now live only in TokenAmount-typed fields.
  • useNFTsByAddress → useNftsByAddress (0.0.3). Casing-only rename; behavior is unchanged.
  • ApiClient.sendBoc returns 0x-prefixed hex (0.0.2 and 0.0.3). Callers that compared the return value as a bare hash string need to strip or expect the prefix.