Changelog

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.