Struct daml_lf::DamlLfArchive

source · [−]

pub struct DamlLfArchive {
    pub name: String,
    pub payload: DamlLfArchivePayload,
    pub hash_function: DamlLfHashFunction,
    pub hash: String,
}

Expand description

A Daml LF archive (aka a dalf file).

A DamlLfArchive contains a name, a payload (aka “package”), a hash (aka “package id”) of that payload for a given hash_function.

Fields

name: Stringpayload: DamlLfArchivePayloadhash_function: DamlLfHashFunctionhash: String

Implementations

source

impl DamlLfArchive

source

pub fn new(
 name: impl Into<String>,
 payload: impl Into<DamlLfArchivePayload>,
 hash_function: impl Into<DamlLfHashFunction>,
 hash: impl Into<String>
) -> Self

Create an archive from an existing payload, hash_function and hash.

Note that this method does not validate that the supplied hash is valid for the supplied payload and hash_function and thus could create an invalid archive.

source

pub fn from_bytes(bytes: impl Into<Bytes>) -> DamlLfResult<Self>

Deserialize an archive from the protobuf binary representation with a default name.

Deserialize the supplied protobuf bytes into a DamlLfArchive. The embedded payload (bytes) will also be deserialized into a DamlLfArchivePayload.

Errors

If the provided bytes cannot be deserialized into an archive (or the embedded payload cannot be deserialized into a DamlLfArchivePayload) then DamlLfParseError will be returned.

If the embedded payload is not of a known version then UnknownVersion will be returned.

Archives of Daml LF v0 are not supported and will result in a UnsupportedVersion being returned.

Examples

let buffer = Vec::<u8>::new();
let archive = DamlLfArchive::from_bytes(buffer)?;
assert_eq!(&DamlLfHashFunction::Sha256, archive.hash_function());

source

pub fn from_bytes_named(
name: impl Into<String>,
bytes: impl Into<Bytes>
) -> DamlLfResult<Self>

Deserialize a named archive from the protobuf binary representation.

Deserialize the supplied protobuf bytes into a DamlLfArchive. The embedded payload (bytes) will also be deserialized into a DamlLfArchivePayload.

Errors

If the provided bytes cannot be deserialized into an archive (or the embedded payload cannot be deserialized into a DamlLfArchivePayload) then DamlLfParseError will be returned.

If the embedded payload is not of a known version then UnknownVersion will be returned.

Archives of Daml LF v0 are not supported and will result in a UnsupportedVersion being returned.

Examples

let buffer = Vec::<u8>::new();
let archive = DamlLfArchive::from_bytes_named("foo", buffer)?;
assert_eq!(&DamlLfHashFunction::Sha256, archive.hash_function());
assert_eq!("foo", archive.name());

source

pub fn from_file(dalf_path: impl AsRef<Path>) -> DamlLfResult<Self>

Read and parse an archive from a dalf file.

Errors

If the provided file cannot be read an IOError will be returned which contains the underlying IO error.

If the contents of the file cannot be deserialized into an archive (or the embedded payload cannot be deserialized into a DamlLfArchivePayload) then DamlLfParseError will be returned.

If the embedded payload is not of a known version then UnknownVersion will be returned.

Archives of Daml LF v0 are not supported and will result in a UnsupportedVersion being returned.

Examples

let archive = DamlLfArchive::from_file("Example.dalf")?;
assert_eq!(&DamlLfHashFunction::Sha256, archive.hash_function());
assert_eq!("Example", archive.name());