Release Notes v1.5.0

Validator: Required
Fullnode: Required
Minimum CLI Version: v2.0.1+
Docker:
Docker image tag aptos-node-v1.5.0
DIGEST: sha256:3d9af9aadd4c1f2f866b3a6f79a3acaa2de372ef1fc3827757a6f4dc1803e557

New features and enhancements

Aptos Blockchain

Storage

• The Aptos CLI now supports restoring a database with a user-specified span of the ledger history from a public database backup stored in the cloud. Read more about it here!

Networking

• AIP-29 Peer Monitoring Service: The peer monitoring service is now enabled by default on all Aptos nodes. This service tracks basic metadata across peers in the network, e.g., ping latencies between peers, network topology information and synced versions.

Dev Infra

• The performance docker build now uses ThinLTO, reducing the build time by 50% while maintaining the same performance number during testing.

Execution

• AIP-37 Filter duplicate transactions within a block: Implements a filtering mechanism that removes duplicate transactions before blocks are executed in the VM to prevent Block-STM performance degradation.

Aptos Frameworks

• AIP-20 Generic Operations of Algebraic Structures: Adds a cryptography algebra module and BLS12381 implementation that enable Move developers to build BLS signature verifiers, ZK-SNARK proofs and many cryptographic applications on top of them!
• AIP-21 Fungible Assets: Introduces a new Aptos standard that utilizes Move objects to allow any on-chain asset to be expressed as a fungible asset that consists of fungible units. This upgrade serves as a powerful superset and enhanced version of the existing Aptos coin standard, enabling the development of more feature-rich web3 applications with advanced tokenization capabilities.
• AIP-30 Implement decrease in staking rewards: Implements a 1.5% yearly decrease to the maximum staking reward rate based on the Aptos tokenomics requirement. The period and percentage are configurable via on-chain governance.

Move Language and VM

• AIP-35 Charging Invariant Violation Errors: Transactions that trigger invariant violation errors will now be charged instead of discarded to prevent a potential DDoS vector.

Resolved Issues

• Fixed the latency regression from v1.4 by reducing the aggressively configured execution pipeline backpressure. Mainnet latency should return to the same level as v1.3.
• Fixed a security issue in the docker-build-test.yaml workflow that could have allowed a malicious GitHub user to run arbitrary commands in GitHub Actions. Thanks to Nikita Stupin for reporting this issue via our Aptos Bounty program.
• Fixed a minor issue related to log handling for speculative execution attempted to be used in different (e.g. simulation) contexts.

What's Changed

• [VM] Fix the order of signer and non-signer tx arg validation to maintain backward compatibility by @movekevin in https://github.com/aptos-labs/aptos-core/pull/8658
• [Storage] Return the correct version for state snapshot when the root is not committed. by @grao1991 in https://github.com/aptos-labs/aptos-core/pull/8671

Full Changelog: https://github.com/aptos-labs/aptos-core/compare/aptos-node-v1.4.4...aptos-node-v1.4.5

Who should upgrade

• Validator: required
• Fullnode: optional

• Validator: required upgrade
• Fullnode: optional

What's changed

This change updated the VM verifier to fail properly if an unallowed struct is passed as an argument.

Changelog

[2.0.1] - 2023/06/05

Fixed

• Updated txn expiration configuration for the faucet built into the CLI to make local testnet startup more reliable.

Instructions

Update instructions

If you have already installed the CLI:

• With brew: brew upgrade aptos
• With the prepackaged CLI: aptos upgrade

Installation instructions

• Installation instructions page
• Managed install
  • macOS: Install with brew
  • Linux / Windows: install with a python script for other platforms

Changelog

[2.0.0] - 2023/06/01

Added

• Multisig v2 governance support
• JSON input file support
• Builder Pattern support for RestClient
  • NOTE: Methods new_with_timeout and new_with_timeout_and_user_agent are no longer available.
• Added custom header x-aptos-client for analytic purpose

Instructions

Update instructions

If you have already installed the CLI:

• With brew: brew upgrade aptos
• With the prepackaged CLI: aptos upgrade

Installation instructions

• Installation instructions page
• Managed install
  • macOS: Install with brew
  • Linux / Windows: install with a python script for other platforms

What's Changed

This hotfix implements a stricter depth check on VM values so that they do not cause issues for recursive algorithms.

Docker image https://hub.docker.com/layers/aptoslabs/validator/aptos-node-v1.4.3/images/sha256-8eefbd2fbf9819cc6984ce2f091670271dabd4ae482f3ae09fd300a279985399?context=explore

Changelog

[1.0.14] - 2023/05/26

Added

• Add nested vector arg support
• Updated DB bootstrap command with new DB restore features

Instructions

Update instructions

If you have already installed the CLI:

• With brew: brew upgrade aptos
• With the prepackaged CLI: aptos upgrade

Installation instructions

• Installation instructions page
• Managed install
  • macOS: Install with brew
  • Linux / Windows: install with a python script for other platforms

What's Changed

• Limit number of Ristretto255 points in ristretto255.move by @zjma in https://github.com/aptos-labs/aptos-core/pull/8153
  • Prevents an user from consuming too much memory on validators by creating many RistrettoPoint structs.
  • The current limit is set to 10,000 points. When the limit is exceeded, the current transaction will abort.

Check out the full release note for v1.4.0 here!

Commit hash: 6568c5ee6a58b4f96c0780d4f66d7e573e61c418

What's Changed

Check out the full release note for v1.4.0 here!

• [docker] release images without crane by @rustielin in https://github.com/aptos-labs/aptos-core/pull/7974
• Turn off crypto algebra and quorum store for v1.4 for now by @perryjrandall in https://github.com/aptos-labs/aptos-core/pull/7996
• [release-tooling] Support input key as string (#7882) by @runtian-zhou in https://github.com/aptos-labs/aptos-core/pull/7999
• [hotfix] token v2 burn event by @lightmark in https://github.com/aptos-labs/aptos-core/pull/8011
• [release] Fix tooling by @runtian-zhou in https://github.com/aptos-labs/aptos-core/pull/8004
• [aptos-vm] Add additional logging by @runtian-zhou in https://github.com/aptos-labs/aptos-core/pull/8030
• [mempool] cherry-pick reduce default failover: 3 -> 1 and related PRs by @bchocho in https://github.com/aptos-labs/aptos-core/pull/8027
• [Cherry pick] View function Object support by @gregnazario in https://github.com/aptos-labs/aptos-core/pull/8051

Docker Image: aptos-node-v1.4.1

Full Changelog: https://github.com/aptos-labs/aptos-core/compare/aptos-node-v1.4.0...aptos-node-v1.4.1

Changelog

[1.0.13] - 2023/04/27

Fixed

• Previously --skip-fetch-latest-git-deps would not actually do anything when used with aptos move test. This has been fixed.
• Fixed the issue of the hello_blockchain example where feature enable was missing

Instructions

Update instructions

If you have already installed the CLI:

• With brew: brew upgrade aptos
• With the prepackaged CLI: aptos upgrade

Installation instructions

• Installation instructions page
• Managed install
  • macOS: Install with brew
  • Linux / Windows: install with a python script for other platforms

Release Notes

Minimum CLI Version: v1.0.11+

New features and enhancements

• The API endpoints for getting information about modules (ABIs) /accounts/<address>/modules and /accounts/<address>/module/<name> now return data with a new field called is_view in the information for each function exposed by the module. The value for this field will be true if the function is a view function, meaning it is annotated with #[view] in the module.

Aptos Blockchain

Consensus

• Quorum Store: A production-optimized implementation of Narwhal that improves consensus throughput. See AIP-26 for more details.
  • Quorum Store was tested in previewnet, a mainnet-like 100+ node network, where it increased TPS by 3x.
  • It will remove consensus as the primary bottleneck for throughput in the mainnet.
  • It has a wide surface area that changes details of how validators disseminate, order, and execute transactions.
• Predictable commit latencies during overloaded state: If the system is highly loaded, but not overloaded, all transactions should have bounded latencies. If the system is overloaded, high-fee transactions should have bounded latency (some of the low fee transactions will obviously have to expire or have high latencies). Current configuration bounds such latencies to ~5-7s in the worst case. This is achieved by revamped consensus backpressure, which now triggers based on the depth of the pipeline – the current delay between block creation and block commit (which happens after the quorum of node block commit certificate is gathered). Backpressure slows down block creation when the pipeline is full, and if that is not enough – it reduces the block size.

Execution

• AIP-27 Sender-aware transaction shuffling: Enables the shuffling of transactions within a single block so that transactions from the same sender are apart from each other as much as possible. This is done to reduce the number of conflicts and re-execution during parallel execution. Our end-to-end performance benchmark shows that sender-aware shuffling can improve the TPS by 25%. See https://github.com/aptos-labs/aptos-core/pull/6518 for more details.

Infra

• Kubernetes cluster upgrade
  • Upgraded Kubernetes to v1.24
    • Updated EBS CSI (persistent volume) driver to v1.14.1
  • Terraform:
    • Updated the Terraform libraries to the most recent versions
    • Applied the PSP-to-PSS security policy migration
• The performance build is ready for beta testing. With the activation of LTO and several other flags, the updated performance build profile has demonstrated a 15-20% performance improvement on validator nodes within the testing environment. To test it, use cargo build -p aptos-node --profile performance or apply the _performance suffix to the Docker tag.

Aptos Frameworks

• AIP-11 (Tokens as Objects): Introduces a new Aptos token standard that utilizes Move objects, allowing a token to represent a unique asset within a larger collection of assets. This standard supports the creation of rich applications such as NFTs, game assets, and no-code solutions while remaining fully interface-compatible, enabling applications to either specialize in the higher-level purpose of the token or generalize across all tokens.
• AIP-22 (No-Code Token Objects): The framework now supports a method to create token objects without writing any Move code, replicating much of the behavior of the original TokenV1 standard.
• AIP-23: Modifies ed25519 public key validation in native_public_key_validate to return false instead of aborting if the public key provided is of the wrong length, for the purpose of allowing more flexible error handling.

Move Language and VM

• AIP-24: Add FixedPoint64, various math functions (exp, log, mul_div, etc.), string formatting, and extra inline functions to the Aptos Move standard library.
• AIP-25 (Transaction Argument Support for Structs):
  • Transactions can call entry functions with the following non-primitive types as input parameters: Object<T>, FixedPoint32, FixedPoint64, or Option<T>.
  • View functions can use the above non-primitive types as input arguments.
• New signature checker implementation for the bytecode verifier to enhance its speed and strictness
• Improved the efficiency of the bounds checker

Resolved Issues

• Fixed two bugs that would allow one to partially bypass the bytecode verifier
  • Note: These fixes have been back-ported and deployed. They were not exploitable either, thanks to the paranoid mode in the Move VM.

Docker Image tag aptos-node-v1.4.0

Changelog

[1.0.12] - 2023/04/25

Added

• Support for creating and interacting with multisig accounts v2. More details can be found at AIP 12.
• Added disassemble option to the CLI - This can be invoked using aptos move disassemble to disassemble the bytecode and save it to a file
• Fixed handling of vector<string> as an entry function argument in aptos move run

Instructions

Update instructions

If you have already installed the CLI:

• With brew: brew upgrade aptos
• With the prepackaged CLI: aptos upgrade

Installation instructions

• Installation instructions page
• Managed install
  • macOS: Install with brew
  • Linux / Windows: install with a python script for other platforms

Changelog

[1.0.11] - 2023/04/14

Fixed

• Fixed creating a new test account with aptos init would fail if the account didn't already exist

Instructions

Update instructions

If you have already installed the CLI:

• With brew: brew upgrade aptos
• With the prepackaged CLI: aptos upgrade

Installation instructions

• Installation instructions page
• Managed install
  • macOS: Install with brew
  • Linux / Windows: install with a python script for other platforms

Security hotfix

Docker aptoslabs/validator:aptos-node-v1.3.5@sha256:2c575d25db0ef1003d313cddc0d15b213bc694c490b5911f35b72c7a135692d5

https://hub.docker.com/layers/aptoslabs/validator/aptos-node-v1.3.5/images/sha256-2c575d25db0ef1003d313cddc0d15b213bc694c490b5911f35b72c7a135692d5?context=explore

Changelog

[1.0.10]

Fixed

• If aptos init is run with a faucet URL specified (which happens by default when using the local, devnet, or testnet network options) and funding the account fails, the account creation is considered a failure and nothing is persisted. Previously it would report success despite the account not being created on chain.
• When specifying a profile where the AuthenticationKey has been rotated, now the AccountAddress is properly used from the config file
• Update aptos init to fix an incorrect account address issue, when trying to init with a rotated private key. Right now it does an actual account lookup instead of deriving from public key

Added

• Updates to prover and framework specs

Instructions

Update instructions

If you have already installed the CLI:

• With brew: brew upgrade aptos
• With the prepackaged CLI: aptos upgrade

Installation instructions

• Installation instructions page
• Managed install
  • macOS: Install with brew
  • Linux / Windows: install with a python script for other platforms

[1.0.9] - 2023/03/29

Added

• aptos move show abi allows for viewing the ABI of a compiled move package
• Experimental gas profiler with the --profile-gas flag on any transaction submitting CLI command
• Updates to the prover and framework specs

Update instructions

If you have already installed the CLI:

• With brew: brew upgrade aptos
• With the prepackaged CLI: aptos upgrade

Installation instructions

• Installation instructions page
• Managed install
  • macOS: Install with brew
  • Linux / Windows: install with a python script for other platforms

New features and enhancements

Aptos Blockchain

• Implemented “rolling commit” to track the prefix of committed transactions in parallel execution accurately, without introducing overhead compared to the current lazy commit approach that can only commit all the transactions together.

Aptos Frameworks

• AIP-10: Move objects for global access to heterogeneous set of resources stored at a single address on-chain. Objects offer a rich capability model that allows for fine-grained resource control and ownership management. By leveraging the aspects of the account model, objects can directly emit events that may lead to a richer understanding of on-chain actions.
• AIP-12: A new Multisig account standard that is primarily governed by transparent data structures and functions in a smart contract (multisig_account) with more ease of use and more powerful features than the current multied25519-auth-key-based accounts.
• AIP-16: New cryptography natives for hashing and MultiEd25519 PK validation to add support for computing the Blake2b-256 hash function in Move smart contracts, computing SHA2-512, SHA3-512 and RIPEMD-160 hash functions in Move smart contracts, and upgrade MultiEd25519 PK validation to V2 address a bug where a PK with 0 sub-PKs would've been considered valid.
• AIP-18: Introducing SmartVector and SmartTable into aptos move standard library. These two data structures are built for storing on-chain large datasets that either cannot fit intovector or are expensive to use Table. Our preliminary benchmark shows a remarkable saving in gas in terms of storage fee.
• Added math libraries. This includes sqrt, mulDiv, exp/log for FixedPoint32, floor_log2, log2, mulDiv and ceil_div for u64 and u128.
  Added ability to access chain ID inside aptos_stdlib.

Move Language and VM

• AIP-8: Higher-order Inline Functions for Collections
  Proposed functions merged into move-stdlib and aptos-stdlib (as can be seen in the simple_map and vector Move modules).
  No decision yet about the shape of those features for large collections like tables and upcoming smart collections.
• AIP-9: Resource groups to support storing multiple distinct Move resources together into a single storage slot.
• AIP-17: Reducing Execution Costs by Decoupling Transaction Storage and Execution Charges. This allows for a new gas schedule to lower execution and IO transaction costs by 100x.

Resolved Issues

• Our MultiEd25519 Move module allowed for some invalid MultiEd25519 PKs to be deserialized as ValidatedPublicKey structs. Such incorrectly-deserialized structs would have been caught later on during signature verification. We have fixed this bug to guarantee correct semantics of MultiEd25519 validated PKs. https://github.com/aptos-labs/aptos-core/pull/5822

Security Fixes

• The Move bytecode verifier has a new metering logic to prevent denial of service attacks. Overly complex programs are detected and rejected by the verifier. (released into Mainnet with v1.2.6)
• All Move native function implementations in Rust have been changed to preemptively charge gas before executing any potentially-expensive operation. This precludes DoS attacks. (released into Mainnet with v1.2.6)

Deployment

• Commit hash 88bb502c81fbdbb194a64be1e62a10703d6bfa36
• Docker image tag: aptos-node-v1.3.2
• Release branch: https://github.com/aptos-labs/aptos-core/tree/aptos-release-v1.3

[Testnet] v1.3.1 -> v1.3.2

• [gha] add credentials for gas calibration for 1.3 by @rahxephon89 in https://github.com/aptos-labs/aptos-core/pull/7036
• [cherry-pick] various improvement for consensus by @zekun000 in https://github.com/aptos-labs/aptos-core/pull/7343

Full Changelog: https://github.com/aptos-labs/aptos-core/compare/aptos-node-v1.3.1...aptos-node-v1.3.2

What's Changed

• [cherry-pick] consensus improvement for v1.2 by @zekun000 in https://github.com/aptos-labs/aptos-core/pull/7349

Full Changelog: https://github.com/aptos-labs/aptos-core/compare/aptos-node-v1.2.7...aptos-node-v1.2.8