cardano-tx-lite 0.1.0

Simplified Cardano (Conway-era) transaction types with web-friendly JSON serde.
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

//! Multi-asset value (ADA + native tokens).

use crate::primitives::{AssetName, Lovelace, PolicyId, Quantity};
use serde::{Deserialize, Serialize};
use std::collections::BTreeMap;

/// A multi-asset value: lovelace plus optional native-token bundle.
///
/// JSON shape:
/// ```json
/// {
///   "coin": "2000000",
///   "assets": {
///     "<policyId hex>": { "<assetName hex>": "1" }
///   }
/// }
/// ```
#[derive(Clone, Debug, Default, PartialEq, Eq, Serialize, Deserialize)]
#[serde(rename_all = "camelCase")]
pub struct Value {
    /// Lovelace amount.
    pub coin: Lovelace,
    /// Native tokens, keyed by policy id then asset name. Omitted in JSON when empty.
    #[serde(default, skip_serializing_if = "BTreeMap::is_empty")]
    pub assets: BTreeMap<PolicyId, BTreeMap<AssetName, Quantity>>,
}

impl Value {
    /// Pure-ADA value.
    pub fn ada(lovelace: u64) -> Self {
        Self { coin: Lovelace(lovelace), assets: BTreeMap::new() }
    }

    /// Add a single native-token entry. Existing entries are replaced.
    pub fn with_asset(mut self, policy: PolicyId, asset: AssetName, qty: u64) -> Self {
        self.assets.entry(policy).or_default().insert(asset, Quantity(qty));
        self
    }

    /// `true` if no native tokens are present.
    pub fn is_pure_ada(&self) -> bool {
        self.assets.is_empty()
    }
}