Struct nostr_sdk::bitcoin::Weight

pub struct Weight(_);

Represents block weight - the weight of a transaction or block.

This is an integer newtype representing weigth in wu. It provides protection against mixing up the types as well as basic formatting features.

Implementations

impl Weight

pub const ZERO: Weight = Weight(0)

0 wu.

Equivalent to MIN, may better express intent in some contexts.

pub const MIN: Weight = Weight(u64::min_value())

Minimum possible value (0 wu).

Equivalent to ZERO, may better express intent in some contexts.

pub const MAX: Weight = Weight(u64::max_value())

Maximum possible value.

pub const fn from_wu(wu: u64) -> Weight

Directly constructs Weight from weight units.

pub fn from_vb(vb: u64) -> Option<Weight>

Constructs Weight from virtual bytes.

Errors

Returns None on overflow.

pub const fn from_vb_unchecked(vb: u64) -> Weight

Constructs Weight from virtual bytes without overflow check.

pub const fn from_witness_data_size(witness_size: u64) -> Weight

Constructs Weight from witness size.

pub const fn from_non_witness_data_size(non_witness_size: u64) -> Weight

Constructs Weight from non-witness size.

pub const fn to_wu(self) -> u64

Returns raw weight units.

Can be used instead of into() to avoid inference issues.

pub const fn to_vbytes_floor(self) -> u64

Converts to vB rounding down.

pub const fn to_vbytes_ceil(self) -> u64

Converts to vB rounding up.

pub fn checked_add(self, rhs: Weight) -> Option<Weight>

Checked addition.

Computes self + rhs returning None if overflow occurred.

pub fn checked_sub(self, rhs: Weight) -> Option<Weight>

Checked subtraction.

Computes self - rhs returning None if overflow occurred.

pub fn checked_mul(self, rhs: u64) -> Option<Weight>

Checked multiplication.

Computes self * rhs returning None if overflow occurred.

pub fn checked_div(self, rhs: u64) -> Option<Weight>

Checked division.

Computes self / rhs returning None if rhs == 0.

Trait Implementations

impl Add<Weight> for Weight

type Output = Weight

The resulting type after applying the + operator.

fn add(self, rhs: Weight) -> <Weight as Add<Weight>>::Output

Performs the + operation.

impl AddAssign<Weight> for Weight

fn add_assign(&mut self, rhs: Weight)

Performs the += operation.

impl Clone for Weight

fn clone(&self) -> Weight

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Weight

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

Formats the value using the given formatter.

impl Display for Weight

Alternative will display the unit.

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

Formats the value using the given formatter.

impl Div<Weight> for Amount

type Output = FeeRate

The resulting type after applying the / operator.

fn div(self, rhs: Weight) -> <Amount as Div<Weight>>::Output

Performs the / operation.

impl Div<u64> for Weight

type Output = Weight

The resulting type after applying the / operator.

fn div(self, rhs: u64) -> <Weight as Div<u64>>::Output

Performs the / operation.

impl DivAssign<u64> for Weight

fn div_assign(&mut self, rhs: u64)

Performs the /= operation.

impl From<Weight> for u64

fn from(value: Weight) -> u64

Converts to this type from the input type.

impl FromStr for Weight

type Err = ParseIntError

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<Weight, <Weight as FromStr>::Err>

Parses a string s to return a value of this type.

impl Hash for Weight

fn hash<__H>(&self, state: &mut __H)where __H: Hasher,

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl Mul<FeeRate> for Weight

Computes ceiling so that fee computation is conservative.

type Output = Amount

The resulting type after applying the * operator.

fn mul(self, rhs: FeeRate) -> <Weight as Mul<FeeRate>>::Output

Performs the * operation.

impl Mul<Weight> for FeeRate

type Output = Amount

The resulting type after applying the * operator.

fn mul(self, rhs: Weight) -> <FeeRate as Mul<Weight>>::Output

Performs the * operation.

impl Mul<Weight> for u64

type Output = Weight

The resulting type after applying the * operator.

fn mul(self, rhs: Weight) -> <u64 as Mul<Weight>>::Output

Performs the * operation.

impl Mul<u64> for Weight

type Output = Weight

The resulting type after applying the * operator.

fn mul(self, rhs: u64) -> <Weight as Mul<u64>>::Output

Performs the * operation.

impl MulAssign<u64> for Weight

fn mul_assign(&mut self, rhs: u64)

Performs the *= operation.

impl Ord for Weight

fn cmp(&self, other: &Weight) -> 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<Weight> for Weight

fn eq(&self, other: &Weight) -> 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<Weight> for Weight

fn partial_cmp(&self, other: &Weight) -> 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 Sub<Weight> for Weight

type Output = Weight

The resulting type after applying the - operator.

fn sub(self, rhs: Weight) -> <Weight as Sub<Weight>>::Output

Performs the - operation.

impl SubAssign<Weight> for Weight

fn sub_assign(&mut self, rhs: Weight)

Performs the -= operation.

impl<'a> Sum<&'a Weight> for Weight

fn sum<I>(iter: I) -> Weightwhere I: Iterator<Item = &'a Weight>,

Method which takes an iterator and generates Self from the elements by “summing up” the items.

impl Sum<Weight> for Weight

fn sum<I>(iter: I) -> Weightwhere I: Iterator<Item = Weight>,

Method which takes an iterator and generates Self from the elements by “summing up” the items.

impl TryFrom<&str> for Weight

type Error = ParseIntError

The type returned in the event of a conversion error.

fn try_from(s: &str) -> Result<Weight, <Weight as TryFrom<&str>>::Error>

Performs the conversion.

impl TryFrom<Box<str, Global>> for Weight

type Error = ParseIntError

The type returned in the event of a conversion error.

fn try_from( s: Box<str, Global> ) -> Result<Weight, <Weight as TryFrom<Box<str, Global>>>::Error>

Performs the conversion.

impl TryFrom<String> for Weight

type Error = ParseIntError

The type returned in the event of a conversion error.

fn try_from(s: String) -> Result<Weight, <Weight as TryFrom<String>>::Error>

Performs the conversion.

impl Copy for Weight

impl Eq for Weight

impl StructuralEq for Weight

impl StructuralPartialEq for Weight