# Changelog

Stay up to date with the latest improvements, new features, and bug fixes across all WDK modules.

***

### April 3, 2026

**Changes**

* **wallet-spark** ([v1.0.0-beta.12](https://github.com/tetherto/wdk-wallet-spark/releases/tag/v1.0.0-beta.12)): [`WalletAccountReadOnlySpark`](https://docs.wdk.tether.io/sdk/wallet-modules/wallet-spark/api-reference#walletaccountreadonlyspark) gained [`getTransfers()`](https://docs.wdk.tether.io/sdk/wallet-modules/wallet-spark/api-reference#gettransfers-options), [`getUnusedDepositAddresses()`](https://docs.wdk.tether.io/sdk/wallet-modules/wallet-spark/api-reference#getunuseddepositaddresses-options) (paginated return type), [`getStaticDepositAddresses()`](https://docs.wdk.tether.io/sdk/wallet-modules/wallet-spark/api-reference#getstaticdepositaddresses), [`getUtxosForDepositAddress()`](https://docs.wdk.tether.io/sdk/wallet-modules/wallet-spark/api-reference#getutxosfordepositaddress-options), and [`getSparkInvoices()`](https://docs.wdk.tether.io/sdk/wallet-modules/wallet-spark/api-reference#getsparkinvoices-params) (new parameter type). Removed `sparkScanApiKey` config option and `SparkTransactionReceipt` type after dropping the `@sparkscan/api-node-sdk-client` dependency. [`getTransactionReceipt()`](https://docs.wdk.tether.io/sdk/wallet-modules/wallet-spark/api-reference#gettransactionreceipt-hash) now returns `SparkTransfer` instead. Added [`getAccountByPath()`](https://docs.wdk.tether.io/sdk/wallet-modules/wallet-spark/api-reference#getaccountbypath-path) to [`WalletManagerSpark`](https://docs.wdk.tether.io/sdk/wallet-modules/wallet-spark/api-reference#walletmanagerspark). SIGNET network support documented. Dependency upgrades: `@buildonspark/spark-sdk` 0.7.3, `@buildonspark/bare` 0.0.53.

***

### April 2, 2026

**Changes**

* **react-native-core** ([v1.0.0-beta.7](https://www.npmjs.com/package/@tetherto/wdk-react-native-core/v/1.0.0-beta.7)): Added missing type exports: `WdkAppState`, `TransactionParams`, `TransactionResult`, `UseAccountResponse`, `AddressInfo`, `AddressInfoResult`, `BalanceQueryOptions`, `UseWdkAppResult`. Removed `indexer` as a top-level config prop.

***

### March 24, 2026

**What's New**

* [**React Native Core**](https://docs.wdk.tether.io/tools/react-native-core): Added documentation for `@tetherto/wdk-react-native-core` ([v1.0.0-beta.6](https://github.com/tetherto/wdk-core-react-native/releases/tag/v1.0.0-beta.6)), the hooks-based React Native integration layer for WDK. Includes [API Reference](https://docs.wdk.tether.io/tools/react-native-core/api-reference) covering `WdkAppProvider`, `useWdkApp`, `useWalletManager`, `useAccount`, `useBalance`, and more. Updated [React Native Quickstart](https://docs.wdk.tether.io/start-building/react-native-quickstart) with step-by-step integration guide.

***

### March 12, 2026

**Changes**

* **wallet-btc** ([v1.0.0-beta.6](https://github.com/tetherto/wdk-wallet-btc/releases/tag/v1.0.0-beta.6)): Added `dispose()` method to [`WalletAccountReadOnlyBtc`](https://docs.wdk.tether.io/sdk/wallet-modules/wallet-btc/api-reference#walletaccountreadonlybtc) for closing internal Electrum connections. Security dependency updates.

***

### March 6, 2026

**Changes**

* **wallet-tron**: Fixed case-sensitive address check in `verify`, upgraded TonWeb to v6.2.0 ([v1.0.0-beta.5](https://github.com/tetherto/wdk-wallet-tron/releases/tag/v1.0.0-beta.5))
* **lending-aave-evm**: Security dependency updates ([v1.0.0-beta.4](https://github.com/tetherto/wdk-protocol-lending-aave-evm/releases/tag/v1.0.0-beta.4))
* **wdk**: Security dependency updates ([v1.0.0-beta.6](https://github.com/tetherto/wdk/releases/tag/v1.0.0-beta.6))

***

### March 5, 2026

**What's New**

* **create-wdk-module**: Added documentation for the [`create-wdk-module`](https://docs.wdk.tether.io/tools/create-wdk-module) CLI scaffolding tool. Updated [Community Modules](https://docs.wdk.tether.io/sdk/community-modules) and [SDK Get Started](https://docs.wdk.tether.io/sdk/get-started) pages with references to the new tool.

***

### February 26, 2026

**Changes**

* **wdk-protocol-bridge-usdt0-evm** ([v1.0.0-beta.3](https://github.com/tetherto/wdk-protocol-bridge-usdt0-evm/releases/tag/v1.0.0-beta.3)): Added per-call `BridgeOptions` overrides (`oftContractAddress`, `dstEid`) and expanded routing from EVM source chains to EVM plus non-EVM destinations (Solana, TON, TRON).

***

### February 25, 2026

**Changes**

* **wallet-evm** ([v1.0.0-beta.8](https://github.com/tetherto/wdk-wallet-evm/releases/tag/v1.0.0-beta.8)): Added [`getTokenBalances(tokenAddresses)`](https://docs.wdk.tether.io/sdk/wallet-modules/wallet-evm/api-reference#gettokenbalancestokenaddresses) to [`WalletAccountReadOnlyEvm`](https://docs.wdk.tether.io/sdk/wallet-modules/wallet-evm/api-reference#walletaccountreadonlyevm), also available on [`WalletAccountEvm`](https://docs.wdk.tether.io/sdk/wallet-modules/wallet-evm/api-reference#walletaccountevm) through inheritance.
* **wallet-evm-erc-4337** ([v1.0.0-beta.5](https://github.com/tetherto/wdk-wallet-evm-erc-4337/releases/tag/v1.0.0-beta.5)): Added EIP-712 typed data methods [`signTypedData(typedData)`](https://docs.wdk.tether.io/sdk/wallet-modules/wallet-evm-erc-4337/api-reference#signtypeddatatypeddata) and [`verifyTypedData(typedData, signature)`](https://docs.wdk.tether.io/sdk/wallet-modules/wallet-evm-erc-4337/api-reference#verifytypeddatatypeddata-signature), plus multicall token balance method [`getTokenBalances(tokenAddresses)`](https://docs.wdk.tether.io/sdk/wallet-modules/wallet-evm-erc-4337/api-reference#gettokenbalancestokenaddresses).

***

### February 24, 2026

**Changes**

* **wallet-spark** ([v1.0.0-beta.11](https://github.com/tetherto/wdk-wallet-spark/releases/tag/v1.0.0-beta.11)): Added Pear runtime entrypoint support (`pear.js`), removed static import causing runtime issues, and bumped spark bare SDK (`@buildonspark/bare`) to `0.0.47`.

***

### February 20, 2026

**What's New**

* [**Showcase**](https://docs.wdk.tether.io/overview/showcase): More visibility for our showcase page, we value contributions! Added 4 featured community projects: [wdk-mcp](https://github.com/dieselftw/wdk-mcp), [wdk-starter-browser-extension](https://github.com/base58-io/wdk-starter-browser-extension), [wdk-wallet-evm-x402-facilitator](https://github.com/SemanticPay/wdk-wallet-evm-x402-facilitator), and [x402-usdt0](https://github.com/baghdadgherras/x402-usdt0).
* [**Community Modules**](https://docs.wdk.tether.io/sdk/community-modules): Added [`@base58-io/wdk-wallet-cosmos`](https://github.com/base58-io/wdk-wallet-cosmos) — wallet module for Cosmos-compatible blockchains by [Base58](https://base58.io/).

***

### February 18, 2026

**What's New**

* [**x402 Payments**](https://docs.wdk.tether.io/ai/x402): New guide for accepting and making instant USD₮ payments over HTTP using WDK self-custodial wallets. Covers the x402 protocol, buyer integration with `@tetherto/wdk-wallet-evm`, seller setup with hosted and self-hosted facilitators, and bridging USD₮ to Plasma and Stable chains.

***

### February 15, 2026

**Changes**

* **wallet-spark**: Added [`getIdentityKey()`](https://docs.wdk.tether.io/sdk/wallet-modules/wallet-spark/api-reference#getidentitykey) method to [`WalletAccountReadOnlySpark`](https://docs.wdk.tether.io/sdk/wallet-modules/wallet-spark/api-reference#walletaccountreadonlyspark) for retrieving the account's identity public key ([v1.0.0-beta.10](https://github.com/tetherto/wdk-wallet-spark/releases/tag/v1.0.0-beta.10))

***

### February 14, 2026

**Changes**

* **wallet-spark**: Upgrade spark-sdk from `0.6.1` to `0.6.4` and spark bare SDK to `0.0.43` ([v1.0.0-beta.9](https://github.com/tetherto/wdk-wallet-spark/releases/tag/v1.0.0-beta.9))

***

### February 12, 2026

**What's New**

* [**Agent Skills**](https://docs.wdk.tether.io/ai/agent-skills): New page covering WDK's agent skill capabilities, self-custodial vs hosted comparison, and platform compatibility with OpenClaw, Claude, Cursor, and other agent platforms.
* [**OpenClaw Integration**](https://docs.wdk.tether.io/ai/openclaw): New page for installing and configuring the WDK skill in OpenClaw via ClawHub, including security precautions for running agents locally.

**Changes**

* **wallet-evm** ([v1.0.0-beta.7](https://github.com/tetherto/wdk-wallet-evm/releases/tag/v1.0.0-beta.7)): Added [EIP-712](https://eips.ethereum.org/EIPS/eip-712) typed data support:
  * Added [`signTypedData(typedData)`](https://docs.wdk.tether.io/sdk/wallet-modules/wallet-evm/api-reference#signtypeddatatypeddata) method to [`WalletAccountEvm`](https://docs.wdk.tether.io/sdk/wallet-modules/wallet-evm/api-reference#walletaccountevm) for signing structured data
  * Added [`verifyTypedData(typedData, signature)`](https://docs.wdk.tether.io/sdk/wallet-modules/wallet-evm/api-reference#verifytypeddatatypeddata-signature) method to [`WalletAccountEvm`](https://docs.wdk.tether.io/sdk/wallet-modules/wallet-evm/api-reference#walletaccountevm) and [`WalletAccountReadOnlyEvm`](https://docs.wdk.tether.io/sdk/wallet-modules/wallet-evm/api-reference#walletaccountreadonlyevm) for verifying typed data signatures
* **wallet-evm-erc-4337** ([v1.0.0-beta.4](https://github.com/tetherto/wdk-wallet-evm-erc-4337/releases/tag/v1.0.0-beta.4)):
  * Added 2 new gas payment modes: [Sponsorship Policy](https://docs.wdk.tether.io/sdk/wallet-modules/wallet-evm-erc-4337/configuration#gas-payment-mode-flags) and [Native Coins](https://docs.wdk.tether.io/sdk/wallet-modules/wallet-evm-erc-4337/configuration#gas-payment-mode-flags), alongside the existing Paymaster Token mode
  * Added per-call [config override](https://docs.wdk.tether.io/sdk/wallet-modules/wallet-evm-erc-4337/api-reference#config-override) parameter to `sendTransaction`, `transfer`, `quoteSendTransaction`, and `quoteTransfer`
  * Added [`getUserOperationReceipt(hash)`](https://docs.wdk.tether.io/sdk/wallet-modules/wallet-evm-erc-4337/api-reference#getuseroperationreceipthash) method for retrieving ERC-4337 UserOperation receipts
  * Added [`ConfigurationError`](https://docs.wdk.tether.io/sdk/wallet-modules/wallet-evm-erc-4337/api-reference#configurationerror) error type for invalid configuration validation

***

### February 10, 2026

**What's New**

* [**Build with AI**](https://docs.wdk.tether.io/start-building/build-with-ai): New guide for using AI coding assistants with WDK. Includes MCP server setup, Markdown context endpoints, project rules, and example prompts. Supports Cursor, Claude Code, GitHub Copilot, Windsurf, Cline, and Continue.
* [**MCP Toolkit**](https://docs.wdk.tether.io/ai/mcp-toolkit): New documentation for `@tetherto/wdk-mcp-toolkit` (`v1.0.0-beta.1`). Covers the `WdkMcpServer` class, 35 built-in MCP tools across 7 categories (wallet, pricing, indexer, swap, bridge, lending, fiat), setup wizard, multi-tool configuration, and full API reference.

***

### February 08, 2026

**Changes**

* **wallet-spark**: Fixed import causing wallet init failure. Upgrade spark-sdk from `0.5.7` to `0.6.1` ([v1.0.0-beta.8](https://github.com/tetherto/wdk-wallet-spark/releases/tag/v1.0.0-beta.8))

***

### February 02, 2026

**Changes**

* **wallet-ton-gasless**: Added `verify` method to [`WalletAccountReadOnlyTonGasless`](https://docs.wdk.tether.io/sdk/wallet-modules/wallet-ton-gasless/api-reference#walletaccountreadonlytongasless) ([v1.0.0-beta.4](https://github.com/tetherto/wdk-wallet-ton-gasless/releases/tag/v1.0.0-beta.4))
* **wallet-tron-gasfree**: Added `verify` method to [`WalletAccountReadOnlyTronGasfree`](https://docs.wdk.tether.io/sdk/wallet-modules/wallet-tron-gasfree/api-reference#walletaccountreadonlytrongasfree) ([v1.0.0-beta.4](https://github.com/tetherto/wdk-wallet-tron-gasfree/releases/tag/v1.0.0-beta.4))

***

### January 29, 2026

**What's New**

* **wdk-indexer**
  * Updated Ethereum indexer supported tokens list to add USA₮.

**Changes**

* **wdk-indexer docs**
  * Fixed the USD₮, XAU₮ token names.

***

### January 26, 2026

**Changes**

* **wallet-btc** ([v1.0.0-beta.5](https://github.com/tetherto/wdk-wallet-btc/releases/tag/v1.0.0-beta.5)):
  * Added `verify` method to [`WalletAccountReadOnlyBtc`](https://docs.wdk.tether.io/sdk/wallet-modules/wallet-btc/api-reference#walletaccountreadonlybtc)
  * Added Pluggable Transport classes: [`ElectrumTcp`](https://docs.wdk.tether.io/sdk/wallet-modules/wallet-btc/api-reference#electrumtcp), [`ElectrumTls`](https://docs.wdk.tether.io/sdk/wallet-modules/wallet-btc/api-reference#electrumtls), [`ElectrumSsl`](https://docs.wdk.tether.io/sdk/wallet-modules/wallet-btc/api-reference#electrumssl), [`ElectrumWs`](https://docs.wdk.tether.io/sdk/wallet-modules/wallet-btc/api-reference#electrumws)
* **wallet-evm**: Added `verify` method to [`WalletAccountReadOnlyEvm`](https://docs.wdk.tether.io/sdk/wallet-modules/wallet-evm/api-reference#walletaccountreadonlyevm) ([v1.0.0-beta.5](https://github.com/tetherto/wdk-wallet-evm/releases/tag/v1.0.0-beta.5))
* **wallet-solana**: Added `verify` method to [`WalletAccountReadOnlySolana`](https://docs.wdk.tether.io/sdk/wallet-modules/wallet-solana/api-reference#walletaccountreadonlysolana) ([v1.0.0-beta.5](https://github.com/tetherto/wdk-wallet-solana/releases/tag/v1.0.0-beta.5))
* **wallet-ton**: Added `verify` method to [`WalletAccountReadOnlyTon`](https://docs.wdk.tether.io/sdk/wallet-modules/wallet-ton/api-reference#walletaccountreadonlyton) ([v1.0.0-beta.7](https://github.com/tetherto/wdk-wallet-ton/releases/tag/v1.0.0-beta.7))
* **wallet-tron**: Added `verify` method to [`WalletAccountReadOnlyTron`](https://docs.wdk.tether.io/sdk/wallet-modules/wallet-tron/api-reference#walletaccountreadonlytron) ([v1.0.0-beta.4](https://github.com/tetherto/wdk-wallet-tron/releases/tag/v1.0.0-beta.4))
* **wallet-spark**: Added `verify` method to [`WalletAccountReadOnlySpark`](https://docs.wdk.tether.io/sdk/wallet-modules/wallet-spark/api-reference#walletaccountreadonlyspark) ([v1.0.0-beta.7](https://github.com/tetherto/wdk-wallet-spark/releases/tag/v1.0.0-beta.7))

***

### January 23, 2026

**What's New**

* **wdk-core docs**: Added comprehensive [Core Module Guides](https://docs.wdk.tether.io/sdk/core-module/usage/getting-started) covering:
  * [Getting Started](https://docs.wdk.tether.io/sdk/core-module/usage/getting-started) - Installation and instantiation
  * [Wallet Registration](https://docs.wdk.tether.io/sdk/core-module/usage/wallet-registration) - Registering wallet modules for different blockchains
  * [Account Management](https://docs.wdk.tether.io/sdk/core-module/usage/account-management) - Working with accounts and addresses
  * [Transactions](https://docs.wdk.tether.io/sdk/core-module/usage/transactions) - Sending native tokens
  * [Protocol Integration](https://docs.wdk.tether.io/sdk/core-module/usage/protocol-integration) - Using swaps, bridges, and lending protocols
  * [Middleware](https://docs.wdk.tether.io/sdk/core-module/usage/middleware) - Configuring logging and failover protection
  * [Error Handling](https://docs.wdk.tether.io/sdk/core-module/usage/error-handling) - Best practices and memory management
* **wdk-core**: Added support for 24-word seed phrases via `WDK.getRandomSeedPhrase(24)`
* **indexer-api**:
  * Added new `/api/v1/chains` endpoint to list supported blockchains and tokens
  * Added XAU₮ support for Plasma network

**Changes**

* **wallet-btc docs**:
  * Updated documentation with BIP-84 (Native SegWit) and BIP-44 (Legacy) support
  * Improved API reference and configuration documentation
* **wallet-spark docs**:
  * Removed testnet support (now only mainnet and regtest)
  * Added [Lightspark Regtest Faucet](https://app.lightspark.com/regtest-faucet) link for test funds
* **wallet-tron-gasfree docs**:
  * Updated testnet from Shasta to Nile
  * Updated GasFree service URLs and configuration examples
* **wallet-evm-erc-4337 docs**: Added paymaster token configuration documentation
* **docs**:
  * Updated token symbols to USD₮ and XAU₮ throughout documentation
  * Various documentation improvements with better cross-linking and examples

**Fixes**

* **wallet-tron-gasfree docs**: Fixed typo "Gras-Free" to "Gas-Free"
* Fixed GitBook callout syntax and formatting issues across documentation

***

### December 23, 2025

**What's New**

* Added [MoonPay Fiat Module](https://docs.wdk.tether.io/sdk/fiat-modules/fiat-moonpay) for on-ramp and off-ramp functionality
* Added [Community Modules](https://docs.wdk.tether.io/sdk/community-modules) section to highlight community-built modules

**Changes**

* Added this changelog page in the docs!
* **wallet-spark**: Updated Spark SDK to latest version ([v1.0.0-beta.6](https://github.com/tetherto/wdk-wallet-spark/releases/tag/v1.0.0-beta.6))
* Introduced [All Modules](https://docs.wdk.tether.io/sdk/all-modules) page in docs for comprehensive module listings
* Reorganized documentation structure for better navigation

***

### December 17, 2025

**What's New**

* **wdk-core**: Added fiat protocol support for on-ramp integrations ([v1.0.0-beta.5](https://github.com/tetherto/wdk-core/releases/tag/v1.0.0-beta.5))
* **wdk-wallet**: Added fiat protocol integration ([v1.0.0-beta.6](https://github.com/tetherto/wdk-wallet/releases/tag/v1.0.0-beta.6))

***

### December 3, 2025

**What's New**

* **wallet-ton**: Added integration tests ([v1.0.0-beta.6](https://github.com/tetherto/wdk-wallet-ton/releases/tag/v1.0.0-beta.6))
* **wallet-btc**: Added support for custom `feeRate` and `confirmationTarget` parameters ([v1.0.0-beta.4](https://github.com/tetherto/wdk-wallet-btc/releases/tag/v1.0.0-beta.4))

**Changes**

* **wallet-ton**: Updated default derivation path, fixed transaction receipt LT and from address
* **wallet-solana**: Updated default derivation path for better compatibility ([v1.0.0-beta.4](https://github.com/tetherto/wdk-wallet-solana/releases/tag/v1.0.0-beta.4))
* **wallet-btc**: Multiple improvements:
  * Automatic dust limit inference based on wallet type
  * Performance improvements with bounded concurrency and caching for `getTransfers`
  * Switched to `bitcoinjs-message` for standard message signing
  * Updated default BIP to 84 (Native SegWit)
  * Fixed testnet derivation path (now uses `1'`)

***

### November 14, 2025

**Changes**

* **wdk-wallet**: Runtime updates and dependency synchronization ([v1.0.0-beta.5](https://github.com/tetherto/wdk-wallet/releases/tag/v1.0.0-beta.5))

***

### November 12, 2025

**What's New**

* **wallet-solana**: Added `sendTransaction` support with unit tests ([v1.0.0-beta.3](https://github.com/tetherto/wdk-wallet-solana/releases/tag/v1.0.0-beta.3))

**Changes**

* **wallet-solana**: Fixed `punycode` module resolution issue
* **lending-aave-evm**: Runtime compatibility updates ([v1.0.0-beta.3](https://github.com/tetherto/wdk-protocol-lending-aave-evm/releases/tag/v1.0.0-beta.3))

***

### November 11, 2025

**Changes**

* **swap-velora-evm**: Runtime compatibility updates ([v1.0.0-beta.4](https://github.com/tetherto/wdk-protocol-swap-velora-evm/releases/tag/v1.0.0-beta.4))

***

### November 9-10, 2025

**What's New**

* **wallet-ton-gasless**: Added unit tests ([v1.0.0-beta.3](https://github.com/tetherto/wdk-wallet-ton-gasless/releases/tag/v1.0.0-beta.3))
* **pear-wrk-wdk**: Added seed buffer support in `workletStart` ([v1.0.0-beta.5](https://github.com/tetherto/pear-wrk-wdk/releases/tag/v1.0.0-beta.5))

**Changes**

* **wallet-tron-gasfree**: Fixed bug interacting with Gasfree API ([v1.0.0-beta.3](https://github.com/tetherto/wdk-wallet-tron-gasfree/releases/tag/v1.0.0-beta.3))
* **wallet-ton-gasless**: Updated TON query-id and transaction hash handling
* **wallet-evm**: Runtime updates ([v1.0.0-beta.4](https://github.com/tetherto/wdk-wallet-evm/releases/tag/v1.0.0-beta.4))
* **wallet-tron**: Dependency and runtime updates ([v1.0.0-beta.3](https://github.com/tetherto/wdk-wallet-tron/releases/tag/v1.0.0-beta.3))

***

### November 8, 2025

**Changes**

* **wdk-core**: Updated `bare-node-runtime` for improved compatibility ([v1.0.0-beta.4](https://github.com/tetherto/wdk-core/releases/tag/v1.0.0-beta.4))
* **wallet-spark**: Updated Spark dependencies and improved `dispose` method ([v1.0.0-beta.5](https://github.com/tetherto/wdk-wallet-spark/releases/tag/v1.0.0-beta.5))

***

### November 7, 2025

**Changes**

* **wallet-evm-erc-4337**: Fixed destructuring of user operation in `getTransactionReceipt()` ([v1.0.0-beta.3](https://github.com/tetherto/wdk-wallet-evm-erc-4337/releases/tag/v1.0.0-beta.3))
* **wallet-ton**: Replaced UUID-based message body with seqno/queryId for TON transfers, downgraded `@ton/ton` to 15.1.0 for stability ([v1.0.0-beta.5](https://github.com/tetherto/wdk-wallet-ton/releases/tag/v1.0.0-beta.5))

***

## How to Stay Updated

* Check this page for the latest updates
* Join our [Discord community](https://discord.gg/arYXDhHB2w) for real-time announcements
* Star and follow the [GitHub repositories](https://github.com/orgs/tetherto/repositories?q=wdk) for detailed release notes