Struct holochain_client::InstallAppPayload

pub struct InstallAppPayload {
    pub source: AppBundleSource,
    pub agent_key: Option<HoloHash<Agent>>,
    pub installed_app_id: Option<String>,
    pub membrane_proofs: Option<HashMap<String, Arc<SerializedBytes>>>,
    pub existing_cells: HashMap<String, CellId>,
    pub network_seed: Option<String>,
    pub ignore_genesis_failure: bool,
}

An AppBundle along with an AgentPubKey and optional InstalledAppId

Fields

source: AppBundleSource

The unique identifier for an installed app in this conductor.

agent_key: Option<HoloHash<Agent>>

The agent to use when creating Cells for this App. If None, a new agent key will be generated.

If a DPKI service is initialized at installation time, this field will be ignored and a properly derived key will be used instead.

installed_app_id: Option<String>

The unique identifier for an installed app in this conductor. If not specified, it will be derived from the app name in the bundle manifest.

membrane_proofs: Option<HashMap<String, Arc<SerializedBytes>>>

Include proof-of-membrane-membership data for cells that require it, keyed by the RoleName specified in the app bundle manifest.

When the app being installed has the allow_deferred_memproofs manifest flag set, passing None for this field will allow the app to enter the “deferred membrane proofs” state, so that memproofs can be provided later via [AppRequest::ProvideMemproofs]. If Some is used here, whatever memproofs are provided will be used, and the app will be installed as normal.

existing_cells: HashMap<String, CellId>

For each role in the app manifest which has UseExisting cell provisioning, a CellId of a currently installed cell must be specified in this map.

network_seed: Option<String>

Optional: overwrites all network seeds for all DNAs of Cells created by this app. The app can still use existing Cells, i.e. this does not require that all Cells have DNAs with the same overridden DNA.

ignore_genesis_failure: bool

Optional: If app installation fails due to genesis failure, normally the app will be immediately uninstalled. When this flag is set, the app is left installed with empty cells intact. This can be useful for using graft_records_onto_source_chain, or for diagnostics.

Trait Implementations

impl Debug for InstallAppPayload

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for InstallAppPayload

fn deserialize<__D>( __deserializer: __D, ) -> Result<InstallAppPayload, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for InstallAppPayload

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

where __S: Serializer,

Serialize this value into the given Serde serializer.