v14.0.0-rc.2: Protocol 23, Release Candidate 2

Please refer to v14.0.0-rc.1 for more release notes in this major version update.

Fixed

• Correctly encode claimable balances and muxed accounts by @Shaptic in #808

Full Changelog: v13.1.0...v14.0.0-rc.2

v14.0.0-rc.1: Protocol 23, Release Candidate 1

Breaking Changes

• This package now requires >= Node 20.
• XDR definitions have been updated to align with Protocol 23 (#800).
• Removed the custom Buffer.subarray polyfill introduced in #733 in v11.0.1 as a workaround for React Native's Hermes engine. Please use @exodus/patch-broken-hermes-typed-arrays as an alternative, if needed (#795).

Added

• The sodium-native and tweetnacl dependencies have been replaced with @noble/curves (#802).
• Support for claimable balances and liquidity pools in StrKey (#799).
• Support for claimable balances, liquidity pools, and muxed accounts in Address (#801).
• Added the ability for nativeToScVal to convert arrays with differing types to smart contract values, e.g., nativeToScVal([1, "x", "y"], { type: [ "i128", "symbol" ]}) will give you a Vec<i128, symbol, string> (#803).

Fixed

• Fix browser compatibility with proper module resolution and UMD configuration (#798).
• Remove MuxedAccount.parseBaseAddress from TypeScript definitions (#797).

Full Changelog: v13.1.0...v14.0.0-rc.1

v13.1.0

Added

• nativeToScVal now supports encoding Keypairs as addresses (#794).
• Within authorizeEntry, the SigningCallback callback function should now return an object containing both the signature and the identity of the signer. In multi-signature situations, it isn't necessarily the case that the address within the authorization entry is the one that actually signs that entry. Thus, the callback now takes the following form, where the original Promise<BufferLike> option is preserved for backwards compatibility and should be considered deprecated (#783):

export type SigningCallback = (
  preimage: xdr.HashIdPreimage
) => Promise<
  BufferLike |
  { signature: BufferLike, publicKey: string }
>;

Fixed

• scValToNative will decode addresses more efficiently and reliably (#794).

v13.0.1

Fixed

• Add support for buildInvocationTree to parse V2 of creation calls by @Shaptic in #784
• Add TypeScript definitions for new invocation field by @Shaptic in #785

v13.0.0: Protocol 22.

This version is unchanged from beta.1, whose changelog is replicated below.

Breaking Changes

• XDR definitions have been upgraded to Protocol 22 (#777).

Added

• You can create contracts with constructors a new, optional parameter of Operation.createCustomContract, constructorArgs: xdr.ScVal[] (#770).

v13.0.0-beta.1: Protocol 22

This is the first release that supports Protocol 22. While the network has not upgraded yet, you can start integrating the new features into your codebase if you want a head start. Keep in mind that while the binary XDR is backwards-compatible, the naming and layout of structures is not. In other words, this build will continue to work on Protocol 21, but you may have to update code that references XDR directly.

Breaking Changes

• XDR definitions have been upgraded to Protocol 22 (#769, #774).

Added

• You can create contracts with constructors via a new, optional parameter of Operation.createCustomContract, constructorArgs: xdr.ScVal[] (#770).

Full Changelog: v12.1.1...v13.0.0-beta.1

v12.1.1

Fixed

• Add missing methods to TypeScript definitions (#766).
• Fix the TypeScript definition of walkInvocationTree to allow void returns on the callback function as intended rather than forcing a return null (#765).
• Fix authorizeEntry to use the correct public key when passing Keypairs (#772).
• Upgrade misc. dependencies (#771, #773, #775).

Contributors

@Shaptic @kalepail

Full Changelog: v12.1.0...v12.1.1

Added

• TransactionBuilder now has addOperationAt and clearOperationAt methods to allow manipulation of individual operations (#757).

Fixed

• Improve the efficiency and portability of asset type retrieval (#758).
• nativeToScVal now correctly sorts maps lexicographically based on the keys to match what the Soroban environment expects (#759).
• humanizeEvents now handles events without a contractId set more reliably (#764).
• nativeToScVal now allows all integer types to come from strings (#763).

New Contributors

• @JuanRdBO made their first contribution in #757

Full Changelog: v12.0.1...v12.1.0

v12.0.1

Fixed

• Export TypeScript definition for StrKey.isValidContract (#751).
• scValToNative would fail when the values contained error codes because the parsing routine hadn't been updated to the new error schemas. Errors are now converted to the following format (#753):

interface Error {
  type: "contract" | "system";
  code: number;
  value?: string; // only present for type === 'system'
}

You can refer to the XDR documentation for additional explanations for each error code.

New Contributors

• @dmkozh made their first contribution in #752

Full Changelog: v12.0.0...v12.0.1

Protocol 21: Stable Release

This is exactly the same as v12.0.0-rc.1 with only dependency upgrades, but the full changelog from the previous stable version is replicated below.

Breaking Changes

• The generated XDR has been upgraded to match the upcoming Protocol 21, namely stellar/stellar-xdr@1a04392 (#738).

Added

• To facilitate serialization and deserialization for downstream systems, this package now exports cereal.XdrWriter and cereal.XdrReader which come directly from @stellar/js-xdr (#744).

Fixed

• Updated various dependencies (#737, #739).
• Buffer and Uint8Array compatibility has improved in StrKey (#746).

New Contributors

• @kanwalpreetd made their first contribution in #745
• @jiqiang90 made their first contribution in #746

Full Changelog: v11.0.1...v12.0.0