Function hdk::entry::update

pub fn update(input: UpdateInput) -> ExternResult<ActionHash>

General function that can update any entry type.

This is used under the hood by update_entry, update_cap_grant and update_cap_claim.

@todo implement update_cap_claim

The host builds an Update action for the passed entry value and commits a new update to the chain.

Usually you don’t need to use this function directly; it is the most general way to update an entry and standardizes the internals of higher level update functions.

Examples found in repository

src/capability.rs (lines 195-199)

pub fn update_cap_grant(
    old_grant_action_hash: ActionHash,
    new_grant_value: CapGrantEntry,
) -> ExternResult<ActionHash> {
    update(UpdateInput {
        original_action_address: old_grant_action_hash,
        entry: Entry::CapGrant(new_grant_value),
        chain_top_ordering: ChainTopOrdering::default(),
    })
}

src/entry.rs (line 170)

pub fn update_entry<I, E>(hash: ActionHash, input: I) -> ExternResult<ActionHash>
where
    Entry: TryFrom<I, Error = E>,
    WasmError: From<E>,
{
    let input = UpdateInput {
        original_action_address: hash,
        entry: input.try_into()?,
        chain_top_ordering: ChainTopOrdering::default(),
    };
    update(input)
}