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.

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

  • 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: 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

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

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