Struct UnsignedBalanceUpdate 

pub struct UnsignedBalanceUpdate {
    pub channel_id: String,
    pub balance: u64,
    pub message_hex: String,
    pub tweak_scalar_hex: String,
}

An unsigned balance update, ready for signing.

Contains the precomputed message hash and tweak scalar needed for signing. Once signed, use sign() to produce a BalanceUpdateMessage.

Example

let unsigned = UnsignedBalanceUpdate::new(channel_id, balance, &funding)?;
let signature = host.sign_with_tweaked_key(
    &funding.sender_pubkey_hex,
    &unsigned.message_hex,
    &unsigned.tweak_scalar_hex,
)?;
let balance_update = unsigned.sign(&signature)?;

Fields

channel_id: String

Channel ID

balance: u64

Balance (cumulative amount receiver can claim)

message_hex: String

SHA-256 hash of the SIG_ALL message (32 bytes, hex-encoded)

tweak_scalar_hex: String

P2BK blinding scalar for the sender (32 bytes, hex-encoded)

Implementations

impl UnsignedBalanceUpdate

pub fn new( channel_id: &str, balance: u64, funding: &ClientChannelFunding, ) -> Result<Self, String>

Create an unsigned balance update from channel funding data.

Computes the message hash and tweak scalar needed for signing.

pub fn sign(self, signature_hex: &str) -> Result<BalanceUpdateMessage, String>

Attach a signature and produce a BalanceUpdateMessage.

The signature should be a BIP-340 Schnorr signature (64 bytes, hex-encoded) produced by signing message_hex with the tweaked key.

Trait Implementations

impl Clone for UnsignedBalanceUpdate

fn clone(&self) -> UnsignedBalanceUpdate

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for UnsignedBalanceUpdate

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

Formats the value using the given formatter.