WDK logoWDK documentation

Changelog

Updates and improvements to the Wallet Development Kit (WDK) modules and tools.

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

June 02, 2026

What's New

  • pricing-provider (v1.0.0-beta.4): Add failover provider support — client now accepts an array of PricingClient instances with automatic connection-error failover, and a new optional retries field (default: 3) controls the number of retry attempts.
  • wallet-ton-gasless (v1.0.0-beta.6): Added client failover: tonClient and tonApiClient now accept arrays of configs or instances with a new retries option (default 3). Migrated to @ton/ton v16.

June 01, 2026

What's New

  • wallet-evm-erc-4337 (v1.0.0-beta.8): Allow per-call UserOperation gas overrides — sendTransaction, quoteSendTransaction, and signTransaction now accept callGasLimit, verificationGasLimit, preVerificationGas, maxFeePerGas, and maxPriorityFeePerGas on the transaction object.

Fixes

  • wallet-spark (v1.0.0-beta.19): Fix keyPair getter to return null for privateKey after dispose() is called; document that the returned byte arrays are a read-only view of internal keys.

May 29, 2026

Fixes

  • wallet-ton (v1.0.0-beta.9): Fix keyPair.privateKey to return null (not undefined) after dispose() and document that key-pair arrays are a read-only view; migrate to @ton/ton v16.
  • wallet-evm (v1.0.0-beta.13): Fix keyPair getter so privateKey reliably returns null after dispose(), and document that the returned byte arrays must be treated as read-only.
  • wallet-tron-gasfree (v1.0.0-beta.6): Remove cached GasFree account state so nonce-sensitive transfers fetch fresh account data, and clarify that returned key-pair byte arrays are a read-only view of internal keys.

May 27, 2026

What's New

  • wallet-evm-erc-4337 (v1.0.0-beta.7): Migrate the smart-account engine to Candide AbstractionKit, add ordered provider failover (pass an array of providers plus an optional retries count), and add an optional onChainIdentifier for tagging UserOperations. The entryPointAddress config option is no longer required.

May 25, 2026

What's New

  • wallet-solana (v1.0.0-beta.9): The WalletAccountSolana constructor is now public (the WalletAccountSolana.at() factory is deprecated — construct accounts directly), and dispose() now securely zeroes the private key so keyPair.privateKey returns null afterwards.
  • wdk-wallet (v1.0.0-beta.9): Add the SwidgeProtocol abstract base class and ISwidgeProtocol interface, a unified swap/bridge/route surface (quoteSwidge(), swidge(), getSwidgeStatus(), getSupportedChains(), getSupportedTokens()) exported from the @tetherto/wdk-wallet/protocols entrypoint for provider modules to implement.
  • create-wdk-module (v1.0.0-beta.2): Add swidge as a new scaffoldable module type for cross-chain swap (swap + bridge combined) protocols, selectable via the interactive prompt or [type] CLI argument.

May 19, 2026

What's New

  • Swidge Protocol Interface: New page covering WDK's preferred route interface for new swap, bridge, and combined route providers, including discovery, quote, execution, status, fee, and migration guidance for the existing standalone swap and bridge interfaces.

May 18, 2026

Changes

  • wdk-utils (v1.0.0-beta.4): [Breaking] Remove decodeLightningInvoice() and its associated BOLT11 types. Callers that depended on this function must remove it; validateLightningInvoice() and all other Lightning validators remain available.

May 15, 2026

Changes

  • bridge-usdt0-evm (v1.0.0-beta.4): Clarify that bridge() and quoteBridge() require an ERC-20 approval of the source-chain bridge spender before they are called.
  • wallet-ton-gasless (v1.0.0-beta.5): [Breaking] Aligned the default derivation path with @tetherto/wdk-wallet-ton: getAccount(index) now derives m/44'/607'/{index}' instead of m/44'/607'/0'/0/{index}, so the same seed produces different addresses after upgrading. Added signTransaction(tx) (unsupported on gasless; throws) and cached the read-only account instance returned by toReadOnlyAccount().

May 12, 2026

What's New

  • wallet-ton (v1.0.0-beta.8): Add RPC endpoint failover (tonClient now accepts an array of configs/clients with a retries option) and offline transaction signing with signTransaction().

Fixes

  • react-native-secure-storage (v1.0.0-beta.4): Fix secure storage on PIN-only Android devices by using DEVICE_PASSCODE access control when no biometrics are enrolled, preventing silent keychain failures.

May 10, 2026

What's New

  • wallet-tron-gasfree (v1.0.0-beta.5): Make gasFreeApiKey and gasFreeApiSecret optional when the GasFree provider does not require signed API requests, expose TronGasfreeAssetInfo and TronGasfreeAccountInfo, include activation fees in transfer quotes, and add unsupported signTransaction(tx) for wallet-interface compatibility.

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.

Fixes

  • wdk-core (v1.0.0-beta.9): Harden internal protocol and middleware registries to use null-prototype maps, reducing prototype-pollution false positives without changing the public WDK API, and refresh the package README.

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

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

March 12, 2026

Changes

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

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

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

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

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

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

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

January 23, 2026

What's New

  • wdk-core docs: Added comprehensive Core Module Guides covering:
  • 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:
  • 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

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

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

Get Support

Previous Page

Showcase

Next Page

On this page

June 02, 2026
June 01, 2026
May 29, 2026
May 27, 2026
May 25, 2026
May 19, 2026
May 18, 2026
May 15, 2026
May 12, 2026
May 10, 2026
May 08, 2026
May 05, 2026
May 01, 2026
April 30, 2026
April 29, 2026
April 28, 2026
April 22, 2026
April 19, 2026
April 15, 2026
April 14, 2026
April 13, 2026
April 3, 2026
April 2, 2026
March 24, 2026
March 12, 2026
March 6, 2026
March 5, 2026
February 26, 2026
February 25, 2026
February 24, 2026
February 20, 2026
February 18, 2026
February 15, 2026
February 14, 2026
February 12, 2026
February 10, 2026
February 08, 2026
February 02, 2026
January 29, 2026
January 26, 2026
January 23, 2026
December 23, 2025
December 17, 2025
December 3, 2025
November 14, 2025
November 12, 2025
November 11, 2025
November 9-10, 2025
November 8, 2025
November 7, 2025
How to Stay Updated