SDK changelog

This page lists what changed in each @uzolabs/sdk release, so you can see what’s safe to upgrade to and what to change in your code.

Early release. This is published in @uzolabs/sdk 0.2.0 on npm and you can use it today. The API may change before 1.0, so pin the version.

The SDK follows semantic versioning. Before 1.0, a minor release (0.x.0) can include breaking changes, so pin an exact version and read this page before you upgrade. The source of truth is CHANGELOG.md on GitHub. Releases are published to npm.

2026-09-30

Added

@uzolabs/sdk/contracts: the addresses object, getAddresses(chainId), USDT_RESOURCE_ID, TOKENS and EXTERNAL_BRIDGE (experimental), and typed ABIs generated from BOTScan, plus viem’s erc20Abi.
@uzolabs/sdk/explorer: createExplorerClient({ chainId }) with getAddressInfo and getContract. No API key needed.
Errors: UzoError and its subclasses, each with a stable code.

Removed

The mainnet bdexV3SwapRouter02 address entry. BOTScan verifies that address as a UniversalRouter, not a SwapRouter02, and the mainnet Universal Router isn’t confirmed yet.

2026-09-30

Added

First release. @uzolabs/sdk/chains with viem chain definitions for BOT Chain (botChain, chain ID 677) and BOT Chain Testnet (botChainTestnet, chain ID 968), including the RPC, BOTScan explorer and Multicall3 settings.

Upcoming

These modules are planned. Version numbers come from the SDK’s README. There are no release dates.

Version	Module
0.3.0	`@uzolabs/sdk/bdex`
0.4.0	`@uzolabs/sdk/bridge`
0.5.0	`@uzolabs/sdk/paymaster`

To hear about new releases, watch the repository on GitHub and choose Releases only.

Getting started

Modules

Guides

Reference

Upcoming

​Upcoming

Upcoming