Struct holochain_types::app::DnaGamut

pub struct DnaGamut(_);

Representation of all DNAs and Cells available in a given context. When given a DnaVersionSpec, a particular DNA can be selected from this gamut.

Moreover, each DNA hash has associated with it a list of Agents. Each agent represents a Cell which exists on the conductor, using that DNA and agent pair. A DNA with no agents listed is simply registered but does not exist in any Cell.

NB: since our DnaVersionSpec is currently very simplistic, so is the gamut. As our versioning becomes more expressive, so will this type. For instance, if we introduce semver, the gamut will include versions of DNAs as well.

This type basically exists as an abstract adapter between the conductor’s DNA store and the app installation process. Without needing to know exactly what we will need from the DNA store, we can define what questions we will need to ask of it through this type.

Implementations

impl DnaGamut

pub fn new<I: IntoIterator<Item = CellId>>(cells: I) -> Self

Constructor. Restructure a list of CellIds into the proper format.

pub fn placeholder() -> Self

👎 Deprecated:

Stop using the placeholder

pub fn resolve_dna(&self, spec: DnaVersionSpec) -> DnaResolution

Given a version spec, return the best-matching DNA in the gamut

pub fn resolve_cell(
    &self,
    spec: DnaVersionSpec,
    _agent: &AgentPubKey
) -> CellResolution

Given a version spec, return the best-matching CellId