4 releases

0.0.1-sol5 May 1, 2020
0.0.1-sol4 Oct 25, 2019
0.0.0 Aug 6, 2019
0.0.0-sol15 Jul 27, 2019

#5 in #libra

Download history 6/week @ 2023-12-04 13/week @ 2023-12-11 19/week @ 2023-12-18 13/week @ 2023-12-25 12/week @ 2024-01-08 5/week @ 2024-01-15 6/week @ 2024-01-22 9/week @ 2024-02-05 18/week @ 2024-02-12 10/week @ 2024-02-19 44/week @ 2024-02-26 39/week @ 2024-03-04 29/week @ 2024-03-11 39/week @ 2024-03-18

151 downloads per month
Used in 15 crates (12 directly)

Apache-2.0

1MB
22K SLoC


id: vm title: Virtual Machine custom_edit_url: https://github.com/libra/libra/edit/master/language/vm/README.md

MoveVM Core

The MoveVM executes transactions expressed in the Move bytecode. There are two main crates: the core VM and the VM runtime. The VM core contains the low-level data type for the VM - mostly the file format and abstraction over it. A gas metering logical abstraction is also defined there.

Overview

The MoveVM is a stack machine with a static type system. The MoveVM honors the specification of the Move language through a mix of file format, verification (for reference bytcode verifier README) and runtime constraints. The structure of the file format allows the definition of modules, types (resources and unrestricted types), and functions. Code is expressed via bytecode instructions, which may have references to external functions and types. The file format also imposes certain invariants of the language such as opaque types and private fields. From the file format definition it should be clear that modules define a scope/namespace for functions and types. Types are opaque given all fields are private, and types carry no functions or methods.

Implementation Details

The MoveVM core crate provides the definition of the file format and all utilities related to the file format:

  • A simple Rust abstraction over the file format (libra/language/vm/src/file_format.rs) and the bytecodes. These Rust structures are widely used in the code base.
  • Serialization and deserialization of the file format. These define the on-chain binary representation of the code.
  • Some pretty printing functionalities.
  • A proptest infrastructure for the file format.
  • The gas cost/synthesis infrastructure.

The CompiledModule and CompiledScript definitions in libra/language/vm/src/file_format.rs are the top-level structs for a Move Module or Transaction Script, respectively. These structs provide a simple abstraction over the file format. Additionally, a set of Views are defined to easily navigate and inspect CompiledModules and CompiledScripts.

Folder Structure

.
├── cost-synthesis  # Infrastructure for gas cost synthesis
├── src             # VM core files
├── tests           # Proptests
├── vm_genesis      # Helpers to generate a genesis block, the initial state of the blockchain
└── vm_runtime      # Interpreter and runtime data types (see README in that folder)

Dependencies

~16–29MB
~412K SLoC