multiversx-chain-vm 0.22.1

MultiversX VM implementation and tooling
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94

use multiversx_chain_core::types::ReturnCode;

use crate::{
    chain_core::builtin_func_names::ESDT_METADATA_UPDATE_FUNC_NAME,
    host::context::{BlockchainUpdate, TxCache, TxInput, TxLog, TxResult},
    host::runtime::{RuntimeInstanceCallLambda, RuntimeRef},
    types::{top_decode_u64, top_encode_u64},
};

use super::super::builtin_func_trait::BuiltinFunction;

pub struct ESDTMetadataUpdate;

impl BuiltinFunction for ESDTMetadataUpdate {
    fn name(&self) -> &str {
        ESDT_METADATA_UPDATE_FUNC_NAME
    }

    fn execute<F>(
        &self,
        tx_input: TxInput,
        tx_cache: TxCache,
        _runtime: &RuntimeRef,
        _f: F,
    ) -> (TxResult, BlockchainUpdate)
    where
        F: RuntimeInstanceCallLambda,
    {
        if tx_input.args.len() < 6 {
            let err_result = TxResult::from_vm_error("ESDTMetaDataUpdate too few arguments");
            return (err_result, BlockchainUpdate::empty());
        }
        assert!(
            tx_input.to == tx_input.from,
            "ESDTMetaDataUpdate expects that to == from"
        );

        let token_identifier = tx_input.args[0].as_slice();
        let nonce = top_decode_u64(tx_input.args[1].as_slice());
        let name = tx_input.args[2].clone();
        let royalties = top_decode_u64(tx_input.args[3].as_slice());
        let hash = tx_input.args[4].clone();
        let attributes = tx_input.args[5].clone();
        let uris = tx_input.args[6..].to_vec();

        tx_cache.with_account_mut(&tx_input.from, |account| {
            let esdt_data = account
                .esdt
                .get_mut_by_identifier(token_identifier)
                .unwrap_or_else(|| panic!("ESDTMetaDataUpdate: token not found"));

            let instance = esdt_data
                .instances
                .get_mut_by_nonce(nonce)
                .unwrap_or_else(|| panic!("ESDTMetaDataUpdate: nonce not found"));

            // Update only overwrites non-empty fields (merge semantics).
            if !name.is_empty() {
                instance.metadata.name = name;
            }
            if royalties > 0 {
                instance.metadata.royalties = royalties;
            }
            if !hash.is_empty() {
                instance.metadata.hash = Some(hash);
            }
            if !attributes.is_empty() {
                instance.metadata.attributes = attributes;
            }
            if !uris.is_empty() {
                instance.metadata.uri = uris;
            }
        });

        let esdt_metadata_update_log = TxLog {
            address: tx_input.from,
            endpoint: ESDT_METADATA_UPDATE_FUNC_NAME.into(),
            topics: vec![
                token_identifier.to_vec(),
                top_encode_u64(nonce),
                Vec::new(), // value = 0
            ],
            data: vec![],
        };

        let tx_result = TxResult {
            result_status: ReturnCode::Success,
            result_logs: vec![esdt_metadata_update_log],
            ..Default::default()
        };

        (tx_result, tx_cache.into_blockchain_updates())
    }
}