Struct lightning::ln::chan_utils::TxCreationKeys

pub struct TxCreationKeys {
    pub per_commitment_point: PublicKey,
    pub revocation_key: PublicKey,
    pub broadcaster_htlc_key: PublicKey,
    pub countersignatory_htlc_key: PublicKey,
    pub broadcaster_delayed_payment_key: PublicKey,
}

The set of public keys which are used in the creation of one commitment transaction. These are derived from the channel base keys and per-commitment data.

A broadcaster key is provided from potential broadcaster of the computed transaction. A countersignatory key is coming from a protocol participant unable to broadcast the transaction.

These keys are assumed to be good, either because the code derived them from channel basepoints via the new function, or they were obtained via CommitmentTransaction.trust().keys() because we trusted the source of the pre-calculated keys.

Fields

per_commitment_point: PublicKey

The broadcaster’s per-commitment public key which was used to derive the other keys.

revocation_key: PublicKey

The revocation key which is used to allow the broadcaster of the commitment transaction to provide their counterparty the ability to punish them if they broadcast an old state.

broadcaster_htlc_key: PublicKey

Broadcaster’s HTLC Key

countersignatory_htlc_key: PublicKey

Countersignatory’s HTLC Key

broadcaster_delayed_payment_key: PublicKey

Broadcaster’s Payment Key (which isn’t allowed to be spent from for some delay)

Implementations

impl TxCreationKeys

pub fn derive_new<T: Signing + Verification>(
    secp_ctx: &Secp256k1<T>,
    per_commitment_point: &PublicKey,
    broadcaster_delayed_payment_base: &PublicKey,
    broadcaster_htlc_base: &PublicKey,
    countersignatory_revocation_base: &PublicKey,
    countersignatory_htlc_base: &PublicKey
) -> Result<TxCreationKeys, SecpError>

Create per-state keys from channel base points and the per-commitment point. Key set is asymmetric and can’t be used as part of counter-signatory set of transactions.

pub fn from_channel_static_keys<T: Signing + Verification>(
    per_commitment_point: &PublicKey,
    broadcaster_keys: &ChannelPublicKeys,
    countersignatory_keys: &ChannelPublicKeys,
    secp_ctx: &Secp256k1<T>
) -> Result<TxCreationKeys, SecpError>

Generate per-state keys from channel static keys. Key set is asymmetric and can’t be used as part of counter-signatory set of transactions.

Trait Implementations

impl Clone for TxCreationKeys

fn clone(&self) -> TxCreationKeys

Returns a copy of the value.

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

Performs copy-assignment from source.

impl PartialEq<TxCreationKeys> for TxCreationKeys

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

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

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

This method tests for !=.

impl Readable for TxCreationKeys

fn read<R: Read>(reader: &mut R) -> Result<Self, DecodeError>

Reads a Self in from the given Read

impl Writeable for TxCreationKeys

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

Writes self out to the given Writer

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.

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

Writes self out to a Vec

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

Writes self out to a Vec

impl StructuralPartialEq for TxCreationKeys