# AppKit changelog (https://docs-rbcpr9qys-ton-core-docs.vercel.app/llms/applications/appkit/changelog/content.md)



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 [#tonappkit-004--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 [#tonappkit-003--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 [#tonappkit-002--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 [#tonappkit-001]

Paired with `@ton/appkit-react` 0.0.1.

* Initial alpha release.

## Upgrade notes [#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.