tari_template_lib 0.19.2

Tari template library provides abstrations that interface with the Tari validator engine
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

//    Copyright 2025 The Tari Project
//    SPDX-License-Identifier: BSD-3-Clause

use serde::{Deserialize, Serialize};
use tari_bor::from_value;
use tari_template_abi::rust::collections::BTreeMap;
use tari_template_lib_types::ResourceAddress;

use crate::models::Vault;

/// Represents an account containing multiple vaults, each identified by a resource address.
/// Accounts can be decoded in templates by using as follows:
/// ```ignore,rust
/// use tari_template_lib::types::Account;
/// let component_state = cbor!(); // .. get state e.g. by using caller.component_state() in a auth hook
/// let account = Account::from_value(&component_state)?;
/// ```
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct Account {
    vaults: BTreeMap<ResourceAddress, Vault>,
}

impl Account {
    /// Decodes state into an `Account`
    pub fn from_value(value: &tari_bor::Value) -> Result<Self, tari_bor::BorError> {
        from_value(value)
    }

    /// Returns the vault map
    pub fn vaults(&self) -> &BTreeMap<ResourceAddress, Vault> {
        &self.vaults
    }

    /// Finds a vault by its resource address.
    pub fn get_vault_by_resource(&self, resource_address: &ResourceAddress) -> Option<&Vault> {
        self.vaults.get(resource_address)
    }

    /// Returns an iterator over all resource addresses in the account.
    pub fn all_resources_iter(&self) -> impl Iterator<Item = &ResourceAddress> {
        self.vaults.keys()
    }
}