0.2.2 Jul 22, 2022
0.2.1 Jul 22, 2022
0.1.7 Jul 10, 2022
0.1.1 Jun 6, 2022

#88 in #blockchain-network

40 downloads per month
Used in state-sync-multiplexer


54K SLoC

id: state_sync_v1 title: State Sync v1 custom_edit_url: https://github.com/aptos-labs/aptos-core/edit/main/state-sync/state-sync-v1/README.md

*** Note: there are plans to build and deploy a new version of state sync. As such, this version (v1) will be deprecated in the near future. See this issue for more information. ***

State synchronizer (State sync)

State sync is a component that helps Aptos nodes advance local blockchain ledger state by requesting and sharing transactions between peers. This helps nodes to synchronize with the most up-to-date state of the blockchain (e.g., if they fall behind or are freshly deployed).


Refer to the State Sync Specification for a high-level overview and description of State Sync.

Implementation details

This crate contains a state sync implementation as described in the specification mentioned above. The files of note in this crate are:

  • bootstrapper.rs: the wrapper struct for creating state sync instances and local clients (client.rs) to those instances.
  • chunk_request.rs & chunk_response.rs: the definitions of the messages sent between Aptos nodes when making state sync requests and responses.
  • coordinator.rs: the primary state sync runtime that processes messages (e.g., from other Aptos nodes) and reacts appropriately.
  • executor_proxy.rs: the interface between the state sync coordinator and both storage and execution.
  • request_manager.rs: the actor that manages the network requests and responses between peers.

How is this module organized?

|- src                         # Source code and unit tests
|- tests/                      # Integration tests


~2M SLoC