v14.1.1

14.1.1 (2026-03-26)

Bug Fixes

• compiler: disallow writing files outside of the temp directory (2a3988e)
• set default TTL to 0 (no TTL) (921f0c1)

v14.1.0

Features

• account: add sync versions of AccountMnemonicFactory methods (1d60eac)
• account: detect MetaMask over EIP-6963 (9e74b53)
• account: experimental support of Ledger app v1.0.0 (0116d74)
• account: init AccountMnemonicFactory by seed (fe74643)
• account: add unsafeSign, deprecate sign (b0288cc)
• add ensureEncoded, isEncoded; deprecate isAddressValid (5a11dc3)
• add hashMessage, deprecate messageToHash (5306e6b)
• add verifyMessageSignature, deprecate verifyMessage (f862b67)
• add verifySignature, deprecate verify (a4a0232)
• aens: add getAuctionState to Name (4150890)
• aens: add id getter to Name (8700534)
• aens: add isName, deprecate isNameValid (88c242a)
• aens: allow to pass salt between Name while claiming (c8dc8cc)
• node: add Hyperchain endpoints (05fcdfd)
• node: ignore consensus protocol version if ignoreVersion set (e2f83d6)
• node: warn if incompatible version when ignoreVersion set (2d6c59d)
• oracle: add getQueries to OracleBase (0af61da)
• contract: show function name along its hash if missed in bytecode (2727713)

Bug Fixes

• account: implicitly connect to Aeternity snap, clean up flow (e347d25)
• aens: computeAuctionEndBlock returns value according to Ceres (3b2f20c)
• aens: handle highestBid as BigInt in auction details (847bfa6)
• aens: make getState's options override instance options (2e0d672)
• aens: mark started_at as required in auction details (fba1012)
• chain: set correct poll interval on hyperchain (0454c62)
• contract: type checking of contract call return value (4c8926b)
• middleware: generate api based on 1.97.1 (359c17a)
• node,middleware: more strict enum handling (d3c5f0f)
• tx-builder: replace OracleResponseTx with OracleRespondTx (19ec9b3)
• wallet: don't require debug flag in BrowserRuntimeConnection (997db99)

v14.0.0

⚠ BREAKING CHANGES

Please check out the migration guide and the tool to convert to convert secret keys.

• CommonJS bundles have cjs extension instead js
• aepp: AeSdkWallet requires onAskToSelectNetwork constructor option
• tx-builder: ChannelClientReconnectTx removed
• node: Node returns time in KeyBlock and MicroBlockHeader as Date
• middleware: require 1.81.0
• sdk requires nodejs@18.19 or newer
• sdk types requires TypeScript@4.8 or newer
• account: Save HD wallets methods removed
• account: sign, signMessage removed
• account: isValidKeypair removed
• account: getAddressFromPriv removed
• account: generateKeyPair removed
• account: generateKeyPairFromSecret removed
• recover, dump removed (AEX-3 keystore implementation)
• node,compiler,middleware: $host is readonly in generated APIs
• account: MemoryAccount accepts secret key as sk_-prefixed string
• account: generateKeyPair returns secretKey encoded as sk_-prefixed string
• aepp: RpcBroadcastError not exported anymore
• NAME_BID_MAX_LENGTH not exported anymore
• contract: encodeFateValue, decodeFateValue not exported anymore
• Iris is not supported
• middleware: sdk requires middleware@1.77.5 and above
• node: sdk requires aeternity node 7.1.0 and above
• account: AccountBase inheritors required to implement signTypedData, signDelegation
• signDelegationToContract removed
• signNameDelegationToContract removed
• signAllNamesDelegationToContract removed
• signOracleQueryDelegationToContract removed
• wallet,aepp: delegations used in Iris removed from aepp-wallet connection
• createDelegationSignature removed
• compiler: CompilerCli uses aesophia@8 by default
• compiler: CompilerCli8 removed
• compiler: CompilerCli and CompilerHttp requires aesophia@8
• aens: aens* methods removed
• tx-builder: NAME_*TTL, CLIENT_TTL not exported anymore
• oracle: pollQueries don't return responded queries by default
• oracle: pollForQueries method removed
• oracle: extendOracleTtl method removed
• oracle: respondToQuery method removed
• oracle: getOracleObject method removed
• oracle: registerOracle method removed
• oracle: getQueryObject removed
• oracle: postQueryToOracle, pollForQueryResponse methods removed
• tx-builder: ORACLE_TTL, QUERY_TTL, RESPONSE_TTL not exported anymore
• tx-builder: buildTx/unpackTx works only with transactions
• tx-builder: Tag include only transactions
• tx-builder: buildTx doesn't accept prefix anymore
• contract: AeSdk:initializeContract removed

Features

• account: add ensureReady method to AccountLedgerFactory (5047e43)
• account: add AccountMetamaskFactory (e9f9694)
• account: add AccountMnemonicFactory (c785521)
• account: encode secret key as sk_-prefixed string (b94e198)
• account: expose secretKey in MemoryAccount (d4320e6)
• aepp: add api to ask wallet to select network (9871c91)
• aepp: extract class to connect to wallet from AeSdkAepp (c3570ac)
• middleware: add requestByPath method (ee5ac0c)
• middleware: allow navigate to next/prev pages (b89cf5b)
• middleware: mark as stable api (e25b06d)
• middleware: prefixed types provided by OpenApi instead of strings (0b16a32)
• middleware: return time as Date instance (e48ffd1)
• middleware: switch to v3 api (b0015c0)
• node: return time as Date instance (e0e33ea)
• oracle: add includeResponded option to Oracle:pollQueries (78a07ab)
• oracle: add Oracle:handleQueries method (03c77c0)

Bug Fixes

• account: improve Account:publicKey type (1652a4b)
• aens: validate minus chars in name as node does (329de9e)
• aepp: don't require subscription to request addresses (2b247ff)
• channel: channelId type, more accurate types (e572fae)
• channel: accept host only if initiator (a7d4dde)
• channel: reestablish flow (1f4a0c1)
• channel: remove statePassword unsupported on node side (5cec07b)
• channel: remove unsupported ways to reopen channel by a transaction (f3746a1)
• middleware: accurate coin amounts (00a4f3e)
• middleware: word casing in activity types (f1fbb29)
• node,compiler,middleware: mark $host as readonly (9e47d5c)
• node: avoid complex types by code replacements instead generics (4f531b1)
• oracle: emit unhandled rejection instead printing error (3a57665)
• tx-builder: count amount in execution cost when spend to yourself (5153649)
• tx-builder: remove unused ChannelClientReconnectTx (e6e954a)
• wallet: generate random string instead using external uuid dep (f8640d4)
• wallet: origin if opened over file:// (cordova) (d529f30)

Commits with breaking changes

• account: make signTypedData, signDelegation abstract (f2c6d1d)
• account: remove generateKeyPair (18c6789)
• account: remove generateKeyPairFromSecret (2cbaa7c)
• account: remove getAddressFromPriv (9446639)
• account: remove isValidKeypair (512385a)
• account: remove sign, signMessage (30077bc)
• account: remove save HD wallet functions (10e7c89)
• aens: replace aens methods with Name class (956daac)
• aepp: remove RpcBroadcastError (1f0b3bb)
• compiler: drop aesophia@7 support (df0e050)
• contract: don't depend on Contract in AeSdk (00b4f86)
• contract: remove encodeFateValue, decodeFateValue (c521597)
• drop Iris support ([61554b3](61554b3...

v13.3.3

Bug Fixes

• account: improve Account:publicKey type (0524553)
• aens: validate minus chars in name as node does (15063c6)
• aepp: don't require subscription to request addresses (8ce976e)
• channel: channelId type, more accurate types (2b064d8)
• channel: accept host only if initiator (cfdfd72)
• channel: remove statePassword unsupported on node side (74db9bb)
• don't allow upgrades @azure/core-rest-pipeline (03058d4)
• don't allow upgrades @ledgerhq/hw-transport to 6.31.0 (1ef43e6)
• wallet: origin if opened over file:// (cordova) (4ee44be)

v13.3.2

Bug Fixes

• contract: detect if ACI doesn't match called contract (8c4287f)
• ttl validation error in dev mode by reducing polling intervals (6f8cdc9)

v13.3.1

This release is needed to work with aeternity@v7.0.0-rc1. If you cannot update SDK to the latest version then as a workaround you can provide ignoreVersion flag, but ensure that the app works with Ceres.

Bug Fixes

• node: mark as compatible with 7.0.0 (562eda9)

v13.3.0

⚠ Ceres and aehopsia@8 compatibility not stable, since they are not officially released yet

Features

• accept multiple encodings in isAddressValid, add TS asserts (2c21139)
• add getContext method to AeSdk (04508d0)
• aens: support update with raw pointers (db2659a)
• aepp,wallet: allow raw data sign (7d0136d)
• chain: add cache option to getHeight (c7d0955)
• compiler: add CompilerCli8 class (29f1cd3)
• compiler: provide compilation warnings (d0ec012)
• compiler: update cli and http compilers to 7.4.0 (2041d8b)
• contract: resolve names on node side in Ceres (474f0fd)
• contract: support all names delegation to contract (92dae86)
• jwt utilities (c747ce6)
• node: add param indicating retry (6f0dbd8)
• node: show error code if available (2cce91d)
• spend to payable contract (7621716)
• support new delegation format in Ceres (786e954)
• tx-builder: get actual gas price from node (09d19bf)
• tx-builder: pick queryFee from the node if not provided (ca495c8)
• tx-builder: reject used accounts in GaAttachTx in Ceres (88b1d5d)
• tx-builder: validate nameTtl in NameUpdateTx (bca877e)

Bug Fixes

• aens: make extendTtl argument optional (028876f)
• aens: reduce default client ttl to one hour (daf7fa0)
• chain: poll till ttl if defined to ensure tx can't be mined (0751244)
• contract: build address by signed tx (60a283b)
• contract: don't duplicate NoSuchContractFunctionError message (2f3bba5)
• improve error message when no wrapped value (054bc89)
• node,middleware,compiler: version check if deployed at path (450296e)
• node,middleware: remove duplicate retry policy (f6470a2)
• node: add missed conversion of difficulty and hashrate to number (271ff5e)
• node: don't remember failed version request (fba0e79)
• node: show correct error message if body is missed (ed10482)
• node: show correct error message if ECONNREFUSED (ef347a1)
• tx-builder: don't accept ttl equal to block height (d9cde12)
• tx-builder: don't estimate gas for non-transactions (f72167a)
• tx-builder: limit ttl to 3 in case tx built internally (08d14c2)
• tx-builder: remove invalid oracle tx type in validator (78e7c48)

v13.2.2

Bug Fixes

• use proper vm version in Ceres (bcaa5cf)
• aepp,wallet: connect to web-extension if opened over file:/// (da6a025)
• aepp: use complete type of WalletInfo object (eeba565)
• contract: don't mark contract as deployed if tx failed (cc4222d)
• contract: use current nonce in static calls (758bdfc)
• node: don't retry 500 code responses (696e7db)
• node: throw clear error message if unsupported protocol (21dfe34)
• node: uncatchable exception if request failed in queue (dec62a4)
• typos in error messages and docs (5c84671)

v13.2.1

Bug Fixes

• use Number instead of unary plus for BigInt (33fcfb4)

v13.2.0

Features

• account: add methods to generate delegation signatures (18bdf5a)
• aepp,wallet: support delegation signatures (fd0dc43)

Bug Fixes

• account: add implementation of signTypedData in AccountBase (fc6e42f)
• wallet: don't ask to confirm unsubscription (e2ffc25)
• wallet: don't require to be subscribed to request addresses (36920b4)
• wallet: return accounts according to subscription (fa900c0)