Changelog

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

May 08, 2026

What's New

wdk-utils (v1.0.0-beta.3): Add validateTronAddress(), decodeLightningInvoice(), and decodeLnurl() so wallet UIs can validate Tron addresses and inspect BOLT11 invoices or LNURL strings before starting payment flows.

Changes

react-native-core (v1.0.0-beta.10): Use individual token balance reads when a wallet module does not expose batch token balance fetching, improving multi-chain balance support without changing the hook API.

May 05, 2026

Changes

react-native-secure-storage (v1.0.0-beta.3): Refresh expo-crypto and expo-local-authentication dependencies to the current Expo SDK release line and keep dependency overrides limited to development tooling, with no public secure storage API changes.

May 01, 2026

What's New

wallet-solana (v1.0.0-beta.8): Add signTransaction(tx) for offline Solana transaction signing and getTokenBalances(tokenAddresses) for batch SPL balance reads; prefer provider over the deprecated rpcUrl config alias, optimize getTokenBalance() to use one RPC call, reuse the cached read-only account helper, and bump @tetherto/wdk-failover-provider to 1.0.0-beta.2.

April 30, 2026

What's New

React Native Secure Storage: Docs added for @tetherto/wdk-react-native-secure-storage, covering keychain-backed wallet credential storage, biometric options, and typed errors.
wallet-spark (v1.0.0-beta.18): Add signTransaction(tx) to WalletAccountSpark for IWalletAccount compatibility, document that standalone signed payloads are unsupported on Spark, reuse the cached read-only account helper, and refresh @buildonspark/spark-sdk to 0.7.16 and spark bare SDK to 0.0.66.

April 29, 2026

What's New

wallet-btc (v1.0.0-beta.9): Add offline Bitcoin transaction signing with signTransaction() and ordered client failover with retries; reuse the read-only account helper and clarify that returned key-pair byte arrays should be treated as read-only.
wallet-evm (v1.0.0-beta.12): Add ordered provider failover with automatic fallback on connection errors, offline EVM transaction signing with signTransaction(), optional chainId config for provider setup, optional chainId on EvmTransaction, and read-only helper reuse.

April 28, 2026

What's New

wdk-wallet (v1.0.0-beta.8): Add signTransaction(tx) to the base IWalletAccount interface so wallet modules can expose offline transaction signing without broadcasting.

Fixes

react-native-core (v1.0.0-beta.9): Clean up balance fetch timeouts and prevent timed-out balance requests from updating state after they resolve.

April 22, 2026

Fixes

wdk-core (v1.0.0-beta.8): Fix WDK.getRandomSeedPhrase(wordCount?) so client code can generate 24-word BIP-39 seed phrases instead of always receiving the default 12-word mnemonic.

April 19, 2026

Changes

lending-aave-evm (v1.0.0-beta.4): Expand per-operation ERC‑4337 config overrides from paymasterToken-only to the wallet module's paymaster-token, sponsorship-policy, and native-coin gas modes.

Fixes

failover-provider (v1.0.0-beta.2): Remove unnecessary published type definitions without changing the runtime failover behavior.
wallet-solana (v1.0.0-beta.7): Fix SolanaWalletConfig.rpcUrl typings to accept ordered string[] failover endpoints and align the published TypeScript definitions with the beta.6 runtime behavior.

April 15, 2026

Changes

wallet-solana (v1.0.0-beta.6): Add runtime RPC failover support for ordered rpcUrl lists plus retries, and tighten custom TransactionMessage and derivation-path validation for durable nonce lifetimes, fee payer matching, and hardened SLIP-0010 child paths.

April 14, 2026

What's New

failover-provider (v1.0.0-beta.1): Initial release of a generic FailoverProvider<T> that chains provider candidates and retries sync or async failures with configurable retries and shouldRetryOn(error) logic.

Changes

fiat-moonpay (v1.0.0-beta.2): [Breaking] Replace secretKey signing with optional backend signUrl, add environment selection for production or sandbox widget URLs, and return unsigned widget URLs when no signer is configured.

April 13, 2026

What's New

wdk-utils (v1.0.0-beta.2): Add EIP-681 request parsing utilities for transfer deeplinks, including request detection and structured parse results.
wdk-core (v1.0.0-beta.7): Added dispose(blockchains?), so you can dispose one or more registered wallets without tearing down every wallet in the WDK instance.
pear-wrk-wdk (v1.0.0-beta.8): Adds resetWdkWallets({ config }) so custom Bare hosts can selectively dispose and re-register wallet modules from a new networks config.

Changes

wallet-spark (v1.0.0-beta.13): Refresh @buildonspark/bare and @buildonspark/spark-sdk dependencies.
wallet-spark (v1.0.0-beta.14): Add SparkScan-backed balance polling for getBalance().
wallet-spark (v1.0.0-beta.15): Refresh @buildonspark/bare, @buildonspark/spark-sdk, and bare-node-runtime dependencies.
wallet-spark (v1.0.0-beta.16): Add syncAndRetry and syncWalletBalance() for retrying failed sendTransaction() and payLightningInvoice() calls once after syncing wallet state.

Fixes

worklet-bundler (v1.0.0-beta.3): Generated worklet entrypoints now suspend and resume both HTTP and HTTPS global agents with Bare thread lifecycle events.
wallet-btc (v1.0.0-beta.8): getBalance() now includes unconfirmed funds when present, and sendTransaction() accepts an optional timeoutMs to keep polling after broadcast until spent inputs disappear from unspent outputs.
wallet-evm (v1.0.0-beta.11): Pin string-backed RPC providers to a static network during EVM account setup.
wallet-evm-erc-4337 (v1.0.0-beta.6): Reuse the internal EVM read-only helper during ERC-4337 method calls instead of recreating it on each call.

April 3, 2026

Changes

wallet-spark (v1.0.0-beta.12): WalletAccountReadOnlySpark gained getTransfers(), getUnusedDepositAddresses() (paginated return type), getStaticDepositAddresses(), getUtxosForDepositAddress(), and getSparkInvoices() (new parameter type). Removed sparkScanApiKey config option and SparkTransactionReceipt type after dropping the @sparkscan/api-node-sdk-client dependency. getTransactionReceipt() now returns SparkTransfer instead. Added getAccountByPath() to 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): 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: Added documentation for @tetherto/wdk-react-native-core (v1.0.0-beta.6), the hooks-based React Native integration layer for WDK. Includes API Reference covering WdkAppProvider, useWdkApp, useWalletManager, useAccount, useBalance, and more. Updated React Native Quickstart with step-by-step integration guide.

March 12, 2026

Changes

wallet-btc (v1.0.0-beta.6): Added dispose() method to 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)
lending-aave-evm: Security dependency updates (v1.0.0-beta.4)
wdk: Security dependency updates (v1.0.0-beta.6)

March 5, 2026

What's New

create-wdk-module: Added documentation for the create-wdk-module CLI scaffolding tool. Updated Community Modules and SDK Get Started pages with references to the new tool.

February 26, 2026

Changes

wdk-protocol-bridge-usdt0-evm (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): Added getTokenBalances(tokenAddresses) to WalletAccountReadOnlyEvm, also available on WalletAccountEvm through inheritance.
wallet-evm-erc-4337 (v1.0.0-beta.5): Added EIP-712 typed data methods signTypedData(typedData) and verifyTypedData(typedData, signature), plus multicall token balance method getTokenBalances(tokenAddresses).

February 24, 2026

Changes

wallet-spark (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: More visibility for our showcase page, we value contributions! Added 4 featured community projects: wdk-mcp, wdk-starter-browser-extension, wdk-wallet-evm-x402-facilitator, and x402-usdt0.
Community Modules: Added @base58-io/wdk-wallet-cosmos — wallet module for Cosmos-compatible blockchains by Base58.

February 18, 2026

What's New

x402 Payments: 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() method to WalletAccountReadOnlySpark for retrieving the account's identity public key (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)

February 12, 2026

What's New

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: 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): Added EIP-712 typed data support:
- Added signTypedData(typedData) method to WalletAccountEvm for signing structured data
- Added verifyTypedData(typedData, signature) method to WalletAccountEvm and WalletAccountReadOnlyEvm for verifying typed data signatures
wallet-evm-erc-4337 (v1.0.0-beta.4):
- Added 2 new gas payment modes: Sponsorship Policy and Native Coins, alongside the existing Paymaster Token mode
- Added per-call config override parameter to sendTransaction, transfer, quoteSendTransaction, and quoteTransfer
- Added getUserOperationReceipt(hash) method for retrieving ERC-4337 UserOperation receipts
- Added ConfigurationError error type for invalid configuration validation

February 10, 2026

What's New

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)

February 02, 2026

Changes

wallet-ton-gasless: Added verify method to WalletAccountReadOnlyTonGasless (v1.0.0-beta.4)
wallet-tron-gasfree: Added verify method to WalletAccountReadOnlyTronGasfree (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):
- Added verify method to WalletAccountReadOnlyBtc
- Added Pluggable Transport classes: ElectrumTcp, ElectrumTls, ElectrumSsl, ElectrumWs
wallet-evm: Added verify method to WalletAccountReadOnlyEvm (v1.0.0-beta.5)
wallet-solana: Added verify method to WalletAccountReadOnlySolana (v1.0.0-beta.5)
wallet-ton: Added verify method to WalletAccountReadOnlyTon (v1.0.0-beta.7)
wallet-tron: Added verify method to WalletAccountReadOnlyTron (v1.0.0-beta.4)
wallet-spark: Added verify method to WalletAccountReadOnlySpark (v1.0.0-beta.7)

January 23, 2026

What's New

wdk-core docs: Added comprehensive Core Module Guides covering:
- Getting Started - Installation and instantiation
- Wallet Registration - Registering wallet modules for different blockchains
- Account Management - Working with accounts and addresses
- Transactions - Sending native tokens
- Protocol Integration - Using swaps, bridges, and lending protocols
- Middleware - Configuring logging and failover protection
- 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 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 for on-ramp and off-ramp functionality
Added 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)
Introduced 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)
wdk-wallet: Added fiat protocol integration (v1.0.0-beta.6)

December 3, 2025

What's New

wallet-ton: Added integration tests (v1.0.0-beta.6)
wallet-btc: Added support for custom feeRate and confirmationTarget parameters (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)
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)

November 12, 2025

What's New

wallet-solana: Added sendTransaction support with unit tests (v1.0.0-beta.3)

Changes

wallet-solana: Fixed punycode module resolution issue
lending-aave-evm: Runtime compatibility updates (v1.0.0-beta.3)

November 11, 2025

Changes

swap-velora-evm: Runtime compatibility updates (v1.0.0-beta.4)

November 9-10, 2025

What's New

wallet-ton-gasless: Added unit tests (v1.0.0-beta.3)
pear-wrk-wdk: Added seed buffer support in workletStart (v1.0.0-beta.5)

Changes

wallet-tron-gasfree: Fixed bug interacting with Gasfree API (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)
wallet-tron: Dependency and runtime updates (v1.0.0-beta.3)

November 8, 2025

Changes

wdk-core: Updated bare-node-runtime for improved compatibility (v1.0.0-beta.4)
wallet-spark: Updated Spark dependencies and improved dispose method (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)
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)

How to Stay Updated

Check this page for the latest updates
Join our Discord community for real-time announcements
Star and follow the GitHub repositories for detailed release notes

Changelog

On this page