Struct cardano_serialization_lib::plutus::ExUnits

pub struct ExUnits { /* private fields */ }

Implementations

impl ExUnits

pub fn to_bytes(&self) -> Vec<u8>

impl ExUnits

pub fn from_bytes(bytes: Vec<u8>) -> Result<ExUnits, DeserializeError>

impl ExUnits

pub fn to_hex(&self) -> String

impl ExUnits

pub fn from_hex(hex_str: &str) -> Result<ExUnits, DeserializeError>

impl ExUnits

pub fn to_json(&self) -> Result<String, JsError>

pub fn from_json(json: &str) -> Result<ExUnits, JsError>

impl ExUnits

pub fn mem(&self) -> BigNum

Examples found in repository

src/plutus.rs (line 944)

    pub fn total_ex_units(&self) -> Result<ExUnits, JsError> {
        let mut tot_mem = BigNum::zero();
        let mut tot_steps = BigNum::zero();
        for i in 0..self.0.len() {
            let r: &Redeemer = &self.0[i];
            tot_mem = tot_mem.checked_add(&r.ex_units().mem())?;
            tot_steps = tot_steps.checked_add(&r.ex_units().steps())?;
        }
        Ok(ExUnits::new(&tot_mem, &tot_steps))
    }

src/fees.rs (line 68)

pub fn calculate_ex_units_ceil_cost(
    ex_units: &ExUnits,
    ex_unit_prices: &ExUnitPrices,
) -> Result<Coin, JsError> {
    type Ratio = (BigInt, BigInt);
    fn mult(sc: &SubCoin, x: &BigNum) -> Result<Ratio, JsError> {
        let n: BigInt = BigInt::from_str(&sc.numerator.to_str())?;
        let d: BigInt = BigInt::from_str(&sc.denominator.to_str())?;
        let m: BigInt = BigInt::from_str(&x.to_str())?;
        Ok((n.mul(&m), d))
    }
    fn sum(a: &Ratio, b: &Ratio) -> Ratio {
        // Ratio Addition: a/x + b/y = ((a*y) + (b*x))/(x*y)
        let (a_num, a_denum) = &a;
        let (b_num, b_denum) = &b;
        if a_num.is_zero() {
            return b.clone();
        }
        if b_num.is_zero() {
            return a.clone();
        }
        let a_num_fixed = &a_num.mul(b_denum);
        let b_num_fixed = &b_num.mul(a_denum);
        let a_b_num_sum = a_num_fixed.add(b_num_fixed);
        let common_denum = a_denum.mul(b_denum);
        (a_b_num_sum, common_denum)
    }
    let mem_ratio: Ratio = mult(&ex_unit_prices.mem_price(), &ex_units.mem())?;
    let steps_ratio: Ratio = mult(&ex_unit_prices.step_price(), &ex_units.steps())?;
    let (total_num, total_denum) = sum(&mem_ratio, &steps_ratio);
    match total_num.div_ceil(&total_denum).as_u64() {
        Some(coin) => Ok(coin),
        _ => Err(JsError::from_str(&format!(
            "Failed to calculate ceil from ratio {}/{}",
            total_num.to_str(),
            total_denum.to_str(),
        ))),
    }
}

pub fn steps(&self) -> BigNum

Examples found in repository

src/plutus.rs (line 945)

    pub fn total_ex_units(&self) -> Result<ExUnits, JsError> {
        let mut tot_mem = BigNum::zero();
        let mut tot_steps = BigNum::zero();
        for i in 0..self.0.len() {
            let r: &Redeemer = &self.0[i];
            tot_mem = tot_mem.checked_add(&r.ex_units().mem())?;
            tot_steps = tot_steps.checked_add(&r.ex_units().steps())?;
        }
        Ok(ExUnits::new(&tot_mem, &tot_steps))
    }

src/fees.rs (line 69)

pub fn calculate_ex_units_ceil_cost(
    ex_units: &ExUnits,
    ex_unit_prices: &ExUnitPrices,
) -> Result<Coin, JsError> {
    type Ratio = (BigInt, BigInt);
    fn mult(sc: &SubCoin, x: &BigNum) -> Result<Ratio, JsError> {
        let n: BigInt = BigInt::from_str(&sc.numerator.to_str())?;
        let d: BigInt = BigInt::from_str(&sc.denominator.to_str())?;
        let m: BigInt = BigInt::from_str(&x.to_str())?;
        Ok((n.mul(&m), d))
    }
    fn sum(a: &Ratio, b: &Ratio) -> Ratio {
        // Ratio Addition: a/x + b/y = ((a*y) + (b*x))/(x*y)
        let (a_num, a_denum) = &a;
        let (b_num, b_denum) = &b;
        if a_num.is_zero() {
            return b.clone();
        }
        if b_num.is_zero() {
            return a.clone();
        }
        let a_num_fixed = &a_num.mul(b_denum);
        let b_num_fixed = &b_num.mul(a_denum);
        let a_b_num_sum = a_num_fixed.add(b_num_fixed);
        let common_denum = a_denum.mul(b_denum);
        (a_b_num_sum, common_denum)
    }
    let mem_ratio: Ratio = mult(&ex_unit_prices.mem_price(), &ex_units.mem())?;
    let steps_ratio: Ratio = mult(&ex_unit_prices.step_price(), &ex_units.steps())?;
    let (total_num, total_denum) = sum(&mem_ratio, &steps_ratio);
    match total_num.div_ceil(&total_denum).as_u64() {
        Some(coin) => Ok(coin),
        _ => Err(JsError::from_str(&format!(
            "Failed to calculate ceil from ratio {}/{}",
            total_num.to_str(),
            total_denum.to_str(),
        ))),
    }
}

pub fn new(mem: &BigNum, steps: &BigNum) -> Self

Examples found in repository

src/plutus.rs (line 947)

    pub fn total_ex_units(&self) -> Result<ExUnits, JsError> {
        let mut tot_mem = BigNum::zero();
        let mut tot_steps = BigNum::zero();
        for i in 0..self.0.len() {
            let r: &Redeemer = &self.0[i];
            tot_mem = tot_mem.checked_add(&r.ex_units().mem())?;
            tot_steps = tot_steps.checked_add(&r.ex_units().steps())?;
        }
        Ok(ExUnits::new(&tot_mem, &tot_steps))
    }

Trait Implementations

impl Clone for ExUnits

fn clone(&self) -> ExUnits

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ExUnits

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ExUnits

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

Deserialize this value from the given Serde deserializer.

impl Deserialize for ExUnits

fn deserialize<R: BufRead + Seek>(
    raw: &mut Deserializer<R>
) -> Result<Self, DeserializeError>

impl JsonSchema for ExUnits

fn schema_name() -> String

The name of the generated JSON Schema.

fn json_schema(gen: &mut SchemaGenerator) -> Schema

Generates a JSON Schema for this type.

fn is_referenceable() -> bool

Whether JSON Schemas generated for this type should be re-used where possible using the $ref keyword.

impl Ord for ExUnits

fn cmp(&self, other: &ExUnits) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Selfwhere
    Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Selfwhere
    Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Selfwhere
    Self: Sized + PartialOrd<Self>,

Restrict a value to a certain interval.

impl PartialEq<ExUnits> for ExUnits

fn eq(&self, other: &ExUnits) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialOrd<ExUnits> for ExUnits

fn partial_cmp(&self, other: &ExUnits) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

fn lt(&self, other: &Rhs) -> bool

This method tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Rhs) -> bool

This method tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Rhs) -> bool

This method tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Rhs) -> bool

This method tests greater than or equal to (for self and other) and is used by the >= operator.

impl Serialize for ExUnits

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

Serialize this value into the given Serde serializer.

impl Serialize for ExUnits

fn serialize<'se, W: Write>(
    &self,
    serializer: &'se mut Serializer<W>
) -> Result<&'se mut Serializer<W>>

impl Eq for ExUnits

impl StructuralEq for ExUnits

impl StructuralPartialEq for ExUnits