Struct ChannelId

pub struct ChannelId(pub [u8; 32]);

A unique 32-byte identifier for a channel. Depending on how the ID is generated, several varieties are distinguished (but all are stored as 32 bytes): v1 and temporary. A v1 channel ID is generated based on funding tx outpoint (txid & index). A temporary ID is generated randomly. (Later revocation-point-based v2 is a possibility.) The variety (context) is not stored, it is relevant only at creation.

This is not exported to bindings users as we just use [u8; 32] directly.

Tuple Fields

0: [u8; 32]

Implementations

impl ChannelId

pub fn v1_from_funding_txid(txid: &[u8; 32], output_index: u16) -> ChannelId

Create v1 channel ID based on a funding TX ID and output index

pub fn temporary_from_entropy_source<ES>(entropy_source: &ES) -> ChannelId

where ES: Deref, <ES as Deref>::Target: EntropySource,

Create a temporary channel ID randomly, based on an entropy source.

pub fn from_bytes(data: [u8; 32]) -> ChannelId

Generic constructor; create a new channel ID from the provided data. Use a more specific *_from_* constructor when possible.

pub fn new_zero() -> ChannelId

Create a channel ID consisting of all-zeros data (e.g. when uninitialized or a placeholder).

pub fn is_zero(&self) -> bool

Check whether ID is consisting of all zeros (uninitialized)

Trait Implementations

impl Clone for ChannelId

fn clone(&self) -> ChannelId

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for ChannelId

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

Formats the value using the given formatter.

impl Display for ChannelId

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

Formats the value using the given formatter.

impl Hash for ChannelId

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 Ord for ChannelId

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

This method returns an Ordering between self and other.

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

where Self: Sized,

Compares and returns the maximum of two values.

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

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl PartialEq for ChannelId

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

Tests for self and other values to be equal, and is used by ==.

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

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

impl PartialOrd for ChannelId

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

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

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

Tests less than (for self and other) and is used by the < operator.

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

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

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

Tests greater than (for self and other) and is used by the > operator.

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

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

impl Readable for ChannelId

fn read<R>(r: &mut R) -> Result<ChannelId, DecodeError>

where R: Read,

Reads a Self in from the given Read.

impl ToHex for ChannelId

fn to_hex(&self) -> String

Converts to a hexadecimal representation of the object.

impl Writeable for ChannelId

fn write<W>(&self, w: &mut W) -> Result<(), Error>

where W: Writer,

Writes self out to the given Writer.

fn encode(&self) -> Vec<u8>

Writes self out to a Vec<u8>.

fn serialized_length(&self) -> usize

Gets the length of this object after it has been serialized. This can be overridden to optimize cases where we prepend an object with its length.

impl Copy for ChannelId

impl Eq for ChannelId

impl StructuralPartialEq for ChannelId