Release 1.2.0

Version 1.2.0

Added

• Python: Add Python 3.12 wheels to the binary releases/PyPI.
• tx: expose wally_tx_input_clone/wally_tx_input_clone_alloc for input cloning.
• Build: Add new static analysis CI runs.

Changed

• Javascript: The npm build now uses nodejs 20, as nodejs 16 is end-of-life.
• Android: Update android NDK to version 26b.
• libsecp256k1-zkp: The library has been updated to include the latest
  changes to its cmake infrastructure.
• cmake: Now takes advantage of the new libsecp256k1-zkp cmake files to build
  experimental modules and export the project in cmake style. cmake now also
  builds test and collects coverage data.

Fixed

• Build: Don't use which on Debian as it is now deprecated.
• Various bug fixes from static analysis.
• Various build and documentation fixes.

Release 1.1.0

Added

• PSBT: Allow extracting partially finalized transactions in wally_psbt_extract by passing a new WALLY_PSBT_EXTRACT_OPT_FINAL flag.
• tx: Allow getting the number of items in a transactions input witness via wally_tx_input_get_witness_num_items / wally_tx_get_input_witness_num_items.

Fixed

• tx: tx_input_get_witness now correctly returns 0 bytes written if passed a NULL input.

Release 1.0.0

This release contains ABI changes; it is not ABI compatible with prior versions.

Added

• The library version number is now available as compile time constants (WALLY_MAJOR_VER, WALLY_MINOR_VER, WALLY_PATCH_VER, WALLY_BUILD_VER), and at runtime via wally_get_build_version.
• Added support for wallet policies (bitcoin/bips#1389).
• Added support for iterating and querying keys in descriptor/policy expressions, including support for key origin information such as fingerprint and path.
• The library allocation functions (which may be overridden by the caller at runtime) are now exposed as wally_[malloc|calloc|free|strdup|strdump_n]. Libraries using wally that wish to respect the callers allocation strategy can use these to avoid having to expose their own customizable allocator.
• Added support for encrypted request/response protocols using ephemeral keys via wally_aes_cbc_with_ecdh_key.
• The PyPI wheel uploads now include an sdist source distribution, allowing install on otherwise-unsupported architectures.

Changed

• The library now follows semantic versioning as per https://semver.org/.
• Elements support is now enabled by default, reflecting the common library usage. Please see the configure --help entries for --disable-elements and --disable-elements-abi for details.
• The ABI of the library is now consistent by default regardless of whether it is built with or without Elements support.
• The constant EC_SIGNATURE_DER_MAX_LOW_R_LEN has been changed from 71 to 70, to reflect that wally always produced low-R, low-S signatures when grinding.
• When configured to build as a static library, linking to libwallycore.a requires additionally linking to libsecp256k1.a.
• Wally can now be configured to build against a system-wide libsecp256k1 by passing --with-system-secp256k1 to configure.
• The Python wheel can now be built with standard Python tooling such as build, and can be built from an uploaded source distribution.
• The Python wheel can now be built with dynamic linking to libwallycore and libsecp256k1-zkp/libsecp256k1.
• libsecp256k1-zkp has been updated to the latest master version as at the time of release.
• Some functions in the c++ header wally.hpp have changed interface slightly. Note that this header is deprecated and will be replaced in an upcoming release with higher level wrappers in the same manner as Python and JS.
• The docker-based builds have been streamlined and simplified. NPM builds in particular are now much faster.

Fixed

• Fixed a bug affecting signing PSBT taproot inputs.
• Fixed extern libsecp256k1-zkp linkage for windows static builds.
• Several build fixes/improvements and CI updates have been made.

Release 0.9.2

This is the last planned release before wally moves to semantic versioning and a consistent ABI for elements/non-elements builds with release 1.0.0. Upgrading is recommended for all users.

• Fixes for huge transactions and PSBT/PSET files
• Fix external linkage for BIP85 functions
• Add missing psbt_is_input_finalized function
• Build and packaging fixes

Release 0.9.1

Note: This release contains minor ABI changes, please see CHANGES.md for details.

• Fix a bug with incorrect nonce commitments when mapping Elements transaction outputs to PSET
• Avoid potential resource exhaustion for platforms with odd malloc semantics when provided with malicious input
• Add support for descriptors containing built-in wrappers with constant arguments and empty descriptors via raw()
• Add various PSBT/transaction/witness stack helper functions
• Improve the reliability of clearing memory on all platforms
• Remove end of life Python 3.6/3.7 support, add support for 3.11
• Add musl/x64 Python wheels to the release (e.g. Alpine Linux)
• Documentation updates, various minor build and bug fixes

Release 0.9.0

Note: This release contains a security fix for users of gcc v13 and later in the underlying libsecp256k1-zkp library. Affected users are strongly advised to update. There are also minor ABI changes detailed in the same link.

• PSBT: Add support for taproot key-spending finalization and signing
• Descriptor: Optimizations and new functions for better embedded/small platform support
• BIP85: Add support for deriving BIP39 entropy from a BIP85 root extended key
• Elements: Add support for Elements asset coin selection
• Update to the latest secp-zkp master for gcc v13+ fixes
• Fix detection of mbed-tls hardware sha256 support
• Fix alignment issues under Rasbian, improve hashing performance for other targets without unaligned access
• Allow --no-asm builds to work on all platforms
• Various build, CI and bug fixes, minor cleanups from static analysis

Release 0.8.9

Note: This release contains an important security fix in the underlying library libsecp256k1-zkp, please see https://github.com/ElementsProject/libwally-core/blob/master/CHANGES.md for details. There are also minor ABI changes detailed in the same link.

• Taproot: Support for Schnorr signatures and BIP-341 key tweaking, support user-supplied auxiliary data for ECDSA
• BIP32/Descriptors: Support multi-path descriptors, add descriptor introspection functions
• PSBT: Finalization improvements, finer serialization control, minor bug fixes/stricter validation
• Elements: Support for deterministic blinding factor generation matching Jade and Ledger
• Elements: Support short master blinding keys, add rangeproof size estimation
• Build: Support mbed-tls native SHA functions including HW acceleration for embedded builds
• Misc: Bug fixes, build system and documentation improvements

Release 0.8.8

Note: This release contains an important security fix, please see https://github.com/ElementsProject/libwally-core/blob/master/CHANGES.md for details.

• Add BIP340 tagged hash functionality
• Add BIP341/342/118 sighash support for BTC
• Add miniscript and output descriptor support functions
• Add a more granular PSBT signing API, plus new accessors
• Complete the functionality for converting between PSBT v0 and v2
• Javascript: Remove the old JS/cordova wrappers, various minor fixes
• Various build system improvements, wrapper, documentation and bug fixes

Release 0.8.7

Note: This release contains ABI changes affecting all languages, please see https://github.com/ElementsProject/libwally-core/blob/master/CHANGES.md for details.

• Javascript: Add a new WASM-based JS + typescript wrapper for Node and browsers, supporting the entire wally API (thanks to @shesek)
• Javascript: Publish an npm package wallycore for JS users.
• Python: Remove support for Python 2.x, auto-generate all wrapper code
• Add new support functions for PSBT/PSET, maps, and keypaths
• Build: Build, test and warning fixes
• Various bug fixes and updates

Release 0.8.6

Note this release contains ABI changes, please see CHANGES.md for details.

• Add initial support for PSBT v2 and Elements PSET v2.
• Update PSBT v0 support to the latest changes. Note that Taproot fields are serialized but general Taproot support is not yet implemented.
• Remove Elements PSET v0 support.
• Extend the wally_map API into a generic int/blob associative container.
• Add secp256k1 group scalar arithmetic operations.
• Add support for explicit value rangeproof and explicit asset surjectionproof generation and validation.
• Add incremental/partial blinding primitives.
• Update the built-in libsecp256k1 library.
• Documentation updates, build/test improvements and misc bug fixes.