> ## Documentation Index
> Fetch the complete documentation index at: https://zksync-sdk.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Changelog

> New releases and improvements for the ZKsyncOS SDK.

<Update label="2025-10-04" description="v0.0.7-alpha" tags={['Features']}>
  ### Features - Add **custom base token** support

  ([#39](https://github.com/dutterbutter/zksync-sdk/issues/39))
  ([a1bab03](https://github.com/dutterbutter/zksync-sdk/commit/a1bab034e6d133c74c43422533d5780165608e3f))

  <small>
    <a href="https://github.com/dutterbutter/zksync-sdk/compare/v0.0.6-alpha...v0.0.7-alpha">
      Compare diff
    </a>
  </small>
</Update>

<Update label="2025-10-01" description="v0.0.6-alpha" tags={["Features", "Bug Fixes", "Adapters: viem", "Adapters: ethers", "Testing/CI", "Docs", "Build"]}>
  ### Features

  * E2E tests for **ERC-20** across **ethers** and **viem** adapters ([#38](https://github.com/dutterbutter/zksync-sdk/issues/38)) ([763587a](https://github.com/dutterbutter/zksync-sdk/commit/763587a3035da61d7764864efe1048e8f4144062))

  ### Bug Fixes

  * Reported **code coverage** ([#32](https://github.com/dutterbutter/zksync-sdk/issues/32)) ([98834dc](https://github.com/dutterbutter/zksync-sdk/commit/98834dc722559e38da270395591145f4d91ea2e4))
  * Docs tweak ([#28](https://github.com/dutterbutter/zksync-sdk/issues/28)) ([533eb70](https://github.com/dutterbutter/zksync-sdk/commit/533eb70a61c33718a3f56850ba8db65a7f3204af))
  * CI env for E2E tests ([#31](https://github.com/dutterbutter/zksync-sdk/issues/31)) ([5d4df64](https://github.com/dutterbutter/zksync-sdk/commit/5d4df64c7a3307ec02ff9d6158f6b535af4f98b5))
  * Published build/types fixes ([#35](https://github.com/dutterbutter/zksync-sdk/issues/35)) ([901a0ea](https://github.com/dutterbutter/zksync-sdk/commit/901a0ea717e16076323f5c37b6e98ca5b2540578))
  * Ethers ERC-20 withdrawal overload fix ([#37](https://github.com/dutterbutter/zksync-sdk/issues/37)) ([2403a9c](https://github.com/dutterbutter/zksync-sdk/commit/2403a9c122e7a6e8c1f24cd407eef57abf3b076a))

    <small><a href="https://github.com/dutterbutter/zksync-sdk/compare/v0.0.5-alpha...v0.0.6-alpha">Compare diff</a></small>
</Update>

<Update label="2025-09-19 (5)" description="v0.0.5-alpha" tags={['Bug Fixes', 'Docs']}>
  ### Bug Fixes - Adjust READMEs ([#25](https://github.com/dutterbutter/zksync-sdk/issues/25))

  ([eacd5ae](https://github.com/dutterbutter/zksync-sdk/commit/eacd5ae6f27332ad8c756d67276e24fbdd3187df))

  <small>
    <a href="https://github.com/dutterbutter/zksync-sdk/compare/v0.0.4-alpha...v0.0.5-alpha">
      Compare diff
    </a>
  </small>
</Update>

<Update label="2025-09-19 (4)" description="v0.0.4-alpha" tags={['Bug Fixes', 'Build']}>
  ### Bug Fixes - Remove JSON in favor of TS

  ([#23](https://github.com/dutterbutter/zksync-sdk/issues/23))
  ([dca83b6](https://github.com/dutterbutter/zksync-sdk/commit/dca83b6e34c7dbf0d866e27dc9c7fa4f58bc5656))

  <small>
    <a href="https://github.com/dutterbutter/zksync-sdk/compare/v0.0.3-alpha...v0.0.4-alpha">
      Compare diff
    </a>
  </small>
</Update>

<Update label="2025-09-19 (3)" description="v0.0.3-alpha" tags={['Bug Fixes', 'Build']}>
  ### Bug Fixes - Additional build fixes

  ([#21](https://github.com/dutterbutter/zksync-sdk/issues/21))
  ([65475b2](https://github.com/dutterbutter/zksync-sdk/commit/65475b23b0acf8bbf8454e1ff39f59a09fd68aa9))

  <small>
    <a href="https://github.com/dutterbutter/zksync-sdk/compare/v0.0.2-alpha...v0.0.3-alpha">
      Compare diff
    </a>
  </small>
</Update>

<Update label="2025-09-19 (2)" description="v0.0.2-alpha" tags={["Features", "Bug Fixes", "Adapters: viem", "Adapters: ethers", "Testing/CI", "Docs", "Finalization", "Build"]}>
  ### Features

  * Release & publishing pipeline ([#4](https://github.com/dutterbutter/zksync-sdk/issues/4)) ([d253c8c](https://github.com/dutterbutter/zksync-sdk/commit/d253c8c19ac0184af6825764ade7b23a14bf6798))
  * **Status polling** for deposits ([5eefe8d](https://github.com/dutterbutter/zksync-sdk/commit/5eefe8d83a5d674cdf486cef2e4467507dcf6d20))
  * **Ethers** adapter unit tests ([fccb3a5](https://github.com/dutterbutter/zksync-sdk/commit/fccb3a56dd380626af93d16b36b8bd68441159a2))
  * **viem** support ([3a5c559](https://github.com/dutterbutter/zksync-sdk/commit/3a5c5598b49f909b334c597f06d18678155fdf5f))
  * Docs scaffolding ([ab152df](https://github.com/dutterbutter/zksync-sdk/commit/ab152df33d57f0e1567742f0f5bef256c2974f44))
  * Deposit flow + `wait()` improvements ([de6d6c0](https://github.com/dutterbutter/zksync-sdk/commit/de6d6c0ce391fe29f9c92603b9cbc2e088dbfe8a))
  * Deposits in **viem** ([e7267cb](https://github.com/dutterbutter/zksync-sdk/commit/e7267cb001f06ffbafadfea3dbe7a935375fcb2d))
  * E2E test cleanups + docs ([252b18a](https://github.com/dutterbutter/zksync-sdk/commit/252b18adce979dc337fc81a993c216d4592082af))
  * E2E tests for **ETH** ([8e7d453](https://github.com/dutterbutter/zksync-sdk/commit/8e7d453493202e605f0f8b95e9c0a3cf99fdfea4), [31b43c6](https://github.com/dutterbutter/zksync-sdk/commit/31b43c62f70731f2c762214cb63689c0c6e44094))
  * **Error envelope** groundwork + integration ([0c9ea07](https://github.com/dutterbutter/zksync-sdk/commit/0c9ea078d3130095896406c943b363d1ac476e43), [e496cc8](https://github.com/dutterbutter/zksync-sdk/commit/e496cc8a98cfe7e3512288ff861110c34ede04e0))
  * **Finalization** interfacing completed ([a026203](https://github.com/dutterbutter/zksync-sdk/commit/a0262033809cb8505a20511edc39083f820a439a))
  * Prep for alpha.1 ([c6c15e1](https://github.com/dutterbutter/zksync-sdk/commit/c6c15e12fba16a355171e30db42995600fad106b))
  * E2E green ✅ ([c65c5b1](https://github.com/dutterbutter/zksync-sdk/commit/c65c5b1976a940ac8f8ff4f82cb7b74cd8d37f5b))

  ### Bug Fixes

  * Export fixes in build ([#18](https://github.com/dutterbutter/zksync-sdk/issues/18)) ([5afbcbd](https://github.com/dutterbutter/zksync-sdk/commit/5afbcbdf13a3e15da94c8b66bc38e643097f917a))
  * Build stability improvements ([1a24cf7](https://github.com/dutterbutter/zksync-sdk/commit/1a24cf76d61ee9c172fb0428c5b2386f4553f736))

    <small><a href="https://github.com/dutterbutter/zksync-sdk/compare/v0.0.1-alpha.0...v0.0.2-alpha">Compare diff</a></small>
</Update>

<Update label="2025-09-19 (1)" description="v0.0.1-alpha.0" tags={["Features", "Adapters: viem", "Adapters: ethers"]}>
  ### Highlights

  * **Initial alpha** release: core flows, **viem** + **ethers** adapters, deposits/withdrawals, status/wait helpers.
  * CI/release scaffolding and early docs.

  <small><a href="https://github.com/dutterbutter/zksync-sdk/compare/v0.0.0-alpha.0...v0.0.1-alpha.0">Compare diff</a></small>
</Update>