Struct lightning::chain::keysinterface::KeysManager

pub struct KeysManager { /* fields omitted */ }

Simple KeysInterface implementor that takes a 32-byte seed for use as a BIP 32 extended key and derives keys from that.

Your node_id is seed/0' ChannelMonitor closes may use seed/1' Cooperative closes may use seed/2' The two close keys may be needed to claim on-chain funds!

Methods

impl KeysManager

pub fn new(
    seed: &[u8; 32],
    network: Network,
    logger: Arc<dyn Logger>,
    starting_time_secs: u64,
    starting_time_nanos: u32
) -> KeysManager

Constructs a KeysManager from a 32-byte seed. If the seed is in some way biased (eg your RNG is busted) this may panic (but more importantly, you will possibly lose funds). starting_time isn't strictly required to actually be a time, but it must absolutely, without a doubt, be unique to this instance. ie if you start multiple times with the same seed, starting_time must be unique to each run. Thus, the easiest way to achieve this is to simply use the current time (with very high precision).

The seed MUST be backed up safely prior to use so that the keys can be re-created, however, obviously, starting_time should be unique every time you reload the library - it is only used to generate new ephemeral key data (which will be stored by the individual channel if necessary).

Note that the seed is required to recover certain on-chain funds independent of ChannelMonitor data, though a current copy of ChannelMonitor data is also required for any channel, and some on-chain during-closing funds.

Note that until the 0.1 release there is no guarantee of backward compatibility between versions. Once the library is more fully supported, the docs will be updated to include a detailed description of the guarantee.

Trait Implementations

impl KeysInterface for KeysManager

type ChanKeySigner = InMemoryChannelKeys

A type which implements ChannelKeys which will be returned by get_channel_keys.

fn get_node_secret(&self) -> SecretKey

Get node secret key (aka node_id or network_key)

fn get_destination_script(&self) -> Script

Get destination redeemScript to encumber static protocol exit points.

fn get_shutdown_pubkey(&self) -> PublicKey

Get shutdown_pubkey to use as PublicKey at channel closure

fn get_channel_keys(
    &self,
    _inbound: bool,
    channel_value_satoshis: u64
) -> InMemoryChannelKeys

Get a new set of ChannelKeys for per-channel secrets. These MUST be unique even if you restarted with some stale data!

fn get_onion_rand(&self) -> (SecretKey, [u8; 32])

Get a secret and PRNG seed for construting an onion packet

fn get_channel_id(&self) -> [u8; 32]

Get a unique temporary channel id. Channels will be referred to by this until the funding transaction is created, at which point they will use the outpoint in the funding transaction.