Struct MovePackage 

pub struct MovePackage { /* private fields */ }

Implementations

impl MovePackage

pub fn new( id: ObjectID, version: SequenceNumber, module_map: BTreeMap<String, Vec<u8>>, max_move_package_size: u64, type_origin_table: Vec<TypeOrigin>, linkage_table: BTreeMap<ObjectID, UpgradeInfo>, ) -> Result<Self, ExecutionError>

Create a package with all required data (including serialized modules, type origin and linkage tables) already supplied.

It does not perform any type of validation. Ensure that the supplied parts are semantically valid.

pub fn digest(&self) -> [u8; 32]

Calculate the digest of the MovePackage.

pub fn compute_digest_for_modules_and_deps<'a>( modules: impl IntoIterator<Item = &'a Vec<u8>>, object_ids: impl IntoIterator<Item = &'a ObjectID>, ) -> [u8; 32]

It is important that this function is shared across both the calculation of the digest for the package, and the calculation of the digest on-chain.

pub fn new_initial<'p>( modules: &[CompiledModule], protocol_config: &ProtocolConfig, transitive_dependencies: impl IntoIterator<Item = &'p MovePackage>, ) -> Result<Self, ExecutionError>

Create an initial version of the package along with this version’s type origin and linkage tables.

Undefined behavior

All passed modules must have the same Runtime ID or the behavior is undefined.

pub fn new_upgraded<'p>( &self, storage_id: ObjectID, modules: &[CompiledModule], protocol_config: &ProtocolConfig, transitive_dependencies: impl IntoIterator<Item = &'p MovePackage>, ) -> Result<Self, ExecutionError>

Create an upgraded version of the package along with this version’s type origin and linkage tables.

Undefined behavior

All passed modules must have the same Runtime ID or the behavior is undefined.

pub fn new_system( version: SequenceNumber, modules: &[CompiledModule], dependencies: impl IntoIterator<Item = ObjectID>, ) -> Self

pub fn get_module(&self, storage_id: &ModuleId) -> Option<&Vec<u8>>

Retrieve the module from this package with the given [ModuleId].

[ModuleId] is expected to contain the Storage ID of this package. In case the Storage ID doesn’t match or the module name is not present in this package the function returns None.

pub fn size(&self) -> usize

Return the size of the package in bytes

pub fn id(&self) -> ObjectID

Package ID/Storage ID of this package.

pub fn version(&self) -> SequenceNumber

pub fn decrement_version(&mut self)

pub fn increment_version(&mut self)

pub fn object_size_for_gas_metering(&self) -> usize

Approximate size of the package in bytes. This is used for gas metering.

pub fn serialized_module_map(&self) -> &BTreeMap<String, Vec<u8>>

pub fn type_origin_table(&self) -> &Vec<TypeOrigin>

pub fn type_origin_map(&self) -> BTreeMap<(String, String), ObjectID>

pub fn linkage_table(&self) -> &BTreeMap<ObjectID, UpgradeInfo>

pub fn original_package_id(&self) -> ObjectID

The Package ID of the first version of this package.

Also referred to as Runtime ID.

Regardless of which version of the package we are working with, this function will always return the Package ID/Storage ID of the first package version in the version chain.

pub fn deserialize_module( &self, module: &Identifier, binary_config: &BinaryConfig, ) -> IotaResult<CompiledModule>

pub fn normalize<S: Hash + Eq + Clone + ToString, Pool: StringPool<String = S>>( &self, pool: &mut Pool, binary_config: &BinaryConfig, include_code: bool, ) -> IotaResult<BTreeMap<String, Module<S>>>

If include_code is set to false, the normalized module will skip function bodies but still include the signatures.

Trait Implementations

impl Clone for MovePackage

fn clone(&self) -> MovePackage

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for MovePackage

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for MovePackage

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Hash for MovePackage

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for MovePackage

fn eq(&self, other: &MovePackage) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for MovePackage

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for MovePackage

impl StructuralPartialEq for MovePackage