13035292482

Committed 29 Jan 2025 03:59PM UTC coverage: 49.3% (-9.5%) from 58.777%

Build # 13035292482

Build Type

Pull #9456

github

Committed by

mohamedawnallah

Commit Message

docs: update release-notes-0.19.0.md

In this commit, we warn users about the removal
of RPCs `SendToRoute`, `SendToRouteSync`, `SendPayment`,
and `SendPaymentSync` in the next release 0.20.

Pull Request Pull Request #9456: lnrpc+docs: deprecate warning `SendToRoute`, `SendToRouteSync`, `SendPayment`, and `SendPaymentSync` in Release 0.19

Run Details

100634 of 204126 relevant lines covered (49.3%)

1.54 hits per line

Source File
Press 'n' to go to next uncovered line, 'b' for previous

6.8

/lnwire/channel_update_2.go

package lnwire

import (
        "bytes"
        "fmt"
        "io"

        "github.com/btcsuite/btcd/chaincfg"
        "github.com/btcsuite/btcd/chaincfg/chainhash"
        "github.com/lightningnetwork/lnd/tlv"
)

const (
        defaultCltvExpiryDelta           = uint16(80)
        defaultHtlcMinMsat               = MilliSatoshi(1)
        defaultFeeBaseMsat               = uint32(1000)
        defaultFeeProportionalMillionths = uint32(1)
)

// ChannelUpdate2 message is used after taproot channel has been initially
// announced. Each side independently announces its fees and minimum expiry for
// HTLCs and other parameters. This message is also used to redeclare initially
// set channel parameters.
type ChannelUpdate2 struct {
        // Signature is used to validate the announced data and prove the
        // ownership of node id.
        Signature Sig

        // ChainHash denotes the target chain that this channel was opened
        // within. This value should be the genesis hash of the target chain.
        // Along with the short channel ID, this uniquely identifies the
        // channel globally in a blockchain.
        ChainHash tlv.RecordT[tlv.TlvType0, chainhash.Hash]

        // ShortChannelID is the unique description of the funding transaction.
        ShortChannelID tlv.RecordT[tlv.TlvType2, ShortChannelID]

        // BlockHeight allows ordering in the case of multiple announcements. We
        // should ignore the message if block height is not greater than the
        // last-received. The block height must always be greater or equal to
        // the block height that the channel funding transaction was confirmed
        // in.
        BlockHeight tlv.RecordT[tlv.TlvType4, uint32]

        // DisabledFlags is an optional bitfield that describes various reasons
        // that the node is communicating that the channel should be considered
        // disabled.
        DisabledFlags tlv.RecordT[tlv.TlvType6, ChanUpdateDisableFlags]

        // SecondPeer is used to indicate which node the channel node has
        // created and signed this message. If this field is present, it was
        // node 2 otherwise it was node 1.
        SecondPeer tlv.OptionalRecordT[tlv.TlvType8, TrueBoolean]

        // CLTVExpiryDelta is the minimum number of blocks this node requires to
        // be added to the expiry of HTLCs. This is a security parameter
        // determined by the node operator. This value represents the required
        // gap between the time locks of the incoming and outgoing HTLC's set
        // to this node.
        CLTVExpiryDelta tlv.RecordT[tlv.TlvType10, uint16]

        // HTLCMinimumMsat is the minimum HTLC value which will be accepted.
        HTLCMinimumMsat tlv.RecordT[tlv.TlvType12, MilliSatoshi]

        // HtlcMaximumMsat is the maximum HTLC value which will be accepted.
        HTLCMaximumMsat tlv.RecordT[tlv.TlvType14, MilliSatoshi]

        // FeeBaseMsat is the base fee that must be used for incoming HTLC's to
        // this particular channel. This value will be tacked onto the required
        // for a payment independent of the size of the payment.
        FeeBaseMsat tlv.RecordT[tlv.TlvType16, uint32]

        // FeeProportionalMillionths is the fee rate that will be charged per
        // millionth of a satoshi.
        FeeProportionalMillionths tlv.RecordT[tlv.TlvType18, uint32]

        // ExtraOpaqueData is the set of data that was appended to this message
        // to fill out the full maximum transport message size. These fields can
        // be used to specify optional data such as custom TLV fields.
        ExtraOpaqueData ExtraOpaqueData
}

// Decode deserializes a serialized ChannelUpdate2 stored in the passed
// io.Reader observing the specified protocol version.
//
// This is part of the lnwire.Message interface.
func (c *ChannelUpdate2) Decode(r io.Reader, _ uint32) error {
        err := ReadElement(r, &c.Signature)
        if err != nil {
                return err
        }
        c.Signature.ForceSchnorr()

        return c.DecodeTLVRecords(r)
}

// DecodeTLVRecords decodes only the TLV section of the message.
func (c *ChannelUpdate2) DecodeTLVRecords(r io.Reader) error {
        // First extract into extra opaque data.
        var tlvRecords ExtraOpaqueData
        if err := ReadElements(r, &tlvRecords); err != nil {
                return err
        }

        var (
                chainHash  = tlv.ZeroRecordT[tlv.TlvType0, [32]byte]()
                secondPeer = tlv.ZeroRecordT[tlv.TlvType8, TrueBoolean]()
        )
        typeMap, err := tlvRecords.ExtractRecords(
                &chainHash, &c.ShortChannelID, &c.BlockHeight, &c.DisabledFlags,
                &secondPeer, &c.CLTVExpiryDelta, &c.HTLCMinimumMsat,
                &c.HTLCMaximumMsat, &c.FeeBaseMsat,
                &c.FeeProportionalMillionths,
        )
        if err != nil {
                return err
        }

        // By default, the chain-hash is the bitcoin mainnet genesis block hash.
        c.ChainHash.Val = *chaincfg.MainNetParams.GenesisHash
        if _, ok := typeMap[c.ChainHash.TlvType()]; ok {
                c.ChainHash.Val = chainHash.Val
        }

        // The presence of the second_peer tlv type indicates "true".
        if _, ok := typeMap[c.SecondPeer.TlvType()]; ok {
                c.SecondPeer = tlv.SomeRecordT(secondPeer)
        }

        // If the CLTV expiry delta was not encoded, then set it to the default
        // value.
        if _, ok := typeMap[c.CLTVExpiryDelta.TlvType()]; !ok {
                c.CLTVExpiryDelta.Val = defaultCltvExpiryDelta
        }

        // If the HTLC Minimum msat was not encoded, then set it to the default
        // value.
        if _, ok := typeMap[c.HTLCMinimumMsat.TlvType()]; !ok {
                c.HTLCMinimumMsat.Val = defaultHtlcMinMsat
        }

        // If the base fee was not encoded, then set it to the default value.
        if _, ok := typeMap[c.FeeBaseMsat.TlvType()]; !ok {
                c.FeeBaseMsat.Val = defaultFeeBaseMsat
        }

        // If the proportional fee was not encoded, then set it to the default
        // value.
        if _, ok := typeMap[c.FeeProportionalMillionths.TlvType()]; !ok {
                c.FeeProportionalMillionths.Val = defaultFeeProportionalMillionths //nolint:ll
        }

        if len(tlvRecords) != 0 {
                c.ExtraOpaqueData = tlvRecords
        }

        return nil
}

// Encode serializes the target ChannelUpdate2 into the passed io.Writer
// observing the protocol version specified.
//
// This is part of the lnwire.Message interface.
func (c *ChannelUpdate2) Encode(w *bytes.Buffer, _ uint32) error {
        _, err := w.Write(c.Signature.RawBytes())
        if err != nil {
                return err
        }

        _, err = c.DataToSign()
        if err != nil {
                return err
        }

        return WriteBytes(w, c.ExtraOpaqueData)
}

// DataToSign is used to retrieve part of the announcement message which should
// be signed. For the ChannelUpdate2 message, this includes the serialised TLV
// records.
func (c *ChannelUpdate2) DataToSign() ([]byte, error) {
        // The chain-hash record is only included if it is _not_ equal to the
        // bitcoin mainnet genisis block hash.
        var recordProducers []tlv.RecordProducer
        if !c.ChainHash.Val.IsEqual(chaincfg.MainNetParams.GenesisHash) {
                hash := tlv.ZeroRecordT[tlv.TlvType0, [32]byte]()
                hash.Val = c.ChainHash.Val

                recordProducers = append(recordProducers, &hash)
        }

        recordProducers = append(recordProducers,
                &c.ShortChannelID, &c.BlockHeight,
        )

        // Only include the disable flags if any bit is set.
        if !c.DisabledFlags.Val.IsEnabled() {
                recordProducers = append(recordProducers, &c.DisabledFlags)
        }

        // We only need to encode the second peer boolean if it is true
        c.SecondPeer.WhenSome(func(r tlv.RecordT[tlv.TlvType8, TrueBoolean]) {
                recordProducers = append(recordProducers, &r)
        })

        // We only encode the cltv expiry delta if it is not equal to the
        // default.
        if c.CLTVExpiryDelta.Val != defaultCltvExpiryDelta {
                recordProducers = append(recordProducers, &c.CLTVExpiryDelta)
        }

        if c.HTLCMinimumMsat.Val != defaultHtlcMinMsat {
                recordProducers = append(recordProducers, &c.HTLCMinimumMsat)
        }

        recordProducers = append(recordProducers, &c.HTLCMaximumMsat)

        if c.FeeBaseMsat.Val != defaultFeeBaseMsat {
                recordProducers = append(recordProducers, &c.FeeBaseMsat)
        }

        if c.FeeProportionalMillionths.Val != defaultFeeProportionalMillionths {
                recordProducers = append(
                        recordProducers, &c.FeeProportionalMillionths,
                )
        }

        err := EncodeMessageExtraData(&c.ExtraOpaqueData, recordProducers...)
        if err != nil {
                return nil, err
        }

        return c.ExtraOpaqueData, nil
}

// MsgType returns the integer uniquely identifying this message type on the
// wire.
//
// This is part of the lnwire.Message interface.
func (c *ChannelUpdate2) MsgType() MessageType {
        return MsgChannelUpdate2
}

func (c *ChannelUpdate2) ExtraData() ExtraOpaqueData {
        return c.ExtraOpaqueData
}

// A compile time check to ensure ChannelUpdate2 implements the
// lnwire.Message interface.
var _ Message = (*ChannelUpdate2)(nil)

// SCID returns the ShortChannelID of the channel that the update applies to.
//
// NOTE: this is part of the ChannelUpdate interface.
func (c *ChannelUpdate2) SCID() ShortChannelID {
        return c.ShortChannelID.Val
}

// IsNode1 is true if the update was produced by node 1 of the channel peers.
// Node 1 is the node with the lexicographically smaller public key.
//
// NOTE: this is part of the ChannelUpdate interface.
func (c *ChannelUpdate2) IsNode1() bool {
        return c.SecondPeer.IsNone()
}

// IsDisabled is true if the update is announcing that the channel should be
// considered disabled.
//
// NOTE: this is part of the ChannelUpdate interface.
func (c *ChannelUpdate2) IsDisabled() bool {
        return !c.DisabledFlags.Val.IsEnabled()
}

// GetChainHash returns the hash of the chain that the message is referring to.
//
// NOTE: this is part of the ChannelUpdate interface.
func (c *ChannelUpdate2) GetChainHash() chainhash.Hash {
        return c.ChainHash.Val
}

// ForwardingPolicy returns the set of forwarding constraints of the update.
//
// NOTE: this is part of the ChannelUpdate interface.
func (c *ChannelUpdate2) ForwardingPolicy() *ForwardingPolicy {
        return &ForwardingPolicy{
                TimeLockDelta: c.CLTVExpiryDelta.Val,
                BaseFee:       MilliSatoshi(c.FeeBaseMsat.Val),
                FeeRate:       MilliSatoshi(c.FeeProportionalMillionths.Val),
                MinHTLC:       c.HTLCMinimumMsat.Val,
                HasMaxHTLC:    true,
                MaxHTLC:       c.HTLCMaximumMsat.Val,
        }
}

// CmpAge can be used to determine if the update is older or newer than the
// passed update. It returns 1 if this update is newer, -1 if it is older, and
// 0 if they are the same age.
//
// NOTE: this is part of the ChannelUpdate interface.
func (c *ChannelUpdate2) CmpAge(update ChannelUpdate) (CompareResult, error) {
        other, ok := update.(*ChannelUpdate2)
        if !ok {
                return 0, fmt.Errorf("expected *ChannelUpdate2, got: %T",
                        update)
        }

        switch {
        case c.BlockHeight.Val > other.BlockHeight.Val:
                return GreaterThan, nil
        case c.BlockHeight.Val < other.BlockHeight.Val:
                return LessThan, nil
        default:
                return EqualTo, nil
        }
}

// SetDisabledFlag can be used to adjust the disabled flag of an update.
//
// NOTE: this is part of the ChannelUpdate interface.
func (c *ChannelUpdate2) SetDisabledFlag(disabled bool) {
        if disabled {
                c.DisabledFlags.Val |= ChanUpdateDisableIncoming
                c.DisabledFlags.Val |= ChanUpdateDisableOutgoing
        } else {
                c.DisabledFlags.Val &^= ChanUpdateDisableIncoming
                c.DisabledFlags.Val &^= ChanUpdateDisableOutgoing
        }
}

// SetSCID can be used to overwrite the SCID of the update.
//
// NOTE: this is part of the ChannelUpdate interface.
func (c *ChannelUpdate2) SetSCID(scid ShortChannelID) {
        c.ShortChannelID.Val = scid
}

// A compile time check to ensure ChannelUpdate2 implements the
// lnwire.ChannelUpdate interface.
var _ ChannelUpdate = (*ChannelUpdate2)(nil)

// ChanUpdateDisableFlags is a bit vector that can be used to indicate various
// reasons for the channel being marked as disabled.
type ChanUpdateDisableFlags uint8

const (
        // ChanUpdateDisableIncoming is a bit indicates that a channel is
        // disabled in the inbound direction meaning that the node broadcasting
        // the update is communicating that they cannot receive funds.
        ChanUpdateDisableIncoming ChanUpdateDisableFlags = 1 << iota

        // ChanUpdateDisableOutgoing is a bit indicates that a channel is
        // disabled in the outbound direction meaning that the node broadcasting
        // the update is communicating that they cannot send or route funds.
        ChanUpdateDisableOutgoing = 2
)

// IncomingDisabled returns true if the ChanUpdateDisableIncoming bit is set.
func (c ChanUpdateDisableFlags) IncomingDisabled() bool {
        return c&ChanUpdateDisableIncoming == ChanUpdateDisableIncoming
}

// OutgoingDisabled returns true if the ChanUpdateDisableOutgoing bit is set.
func (c ChanUpdateDisableFlags) OutgoingDisabled() bool {
        return c&ChanUpdateDisableOutgoing == ChanUpdateDisableOutgoing
}

// IsEnabled returns true if none of the disable bits are set.
func (c ChanUpdateDisableFlags) IsEnabled() bool {
        return c == 0
}

// String returns the bitfield flags as a string.
func (c ChanUpdateDisableFlags) String() string {
        return fmt.Sprintf("%08b", c)
}

// Record returns the tlv record for the disable flags.
func (c *ChanUpdateDisableFlags) Record() tlv.Record {
        return tlv.MakeStaticRecord(0, c, 1, encodeDisableFlags,
                decodeDisableFlags)
}

func encodeDisableFlags(w io.Writer, val interface{}, buf *[8]byte) error {
        if v, ok := val.(*ChanUpdateDisableFlags); ok {
                flagsInt := uint8(*v)

                return tlv.EUint8(w, &flagsInt, buf)
        }

        return tlv.NewTypeForEncodingErr(val, "lnwire.ChanUpdateDisableFlags")
}

func decodeDisableFlags(r io.Reader, val interface{}, buf *[8]byte,
        l uint64) error {

        if v, ok := val.(*ChanUpdateDisableFlags); ok {
                var flagsInt uint8
                err := tlv.DUint8(r, &flagsInt, buf, l)
                if err != nil {
                        return err
                }

                *v = ChanUpdateDisableFlags(flagsInt)

                return nil
        }

        return tlv.NewTypeForDecodingErr(val, "lnwire.ChanUpdateDisableFlags",
                l, l)
}

// TrueBoolean is a record that indicates true or false using the presence of
// the record. If the record is absent, it indicates false. If it is present,
// it indicates true.
type TrueBoolean struct{}

// Record returns the tlv record for the boolean entry.
func (b *TrueBoolean) Record() tlv.Record {
        return tlv.MakeStaticRecord(
                0, b, 0, booleanEncoder, booleanDecoder,
        )
}

func booleanEncoder(_ io.Writer, val interface{}, _ *[8]byte) error {
        if _, ok := val.(*TrueBoolean); ok {
                return nil
        }

        return tlv.NewTypeForEncodingErr(val, "TrueBoolean")
}

func booleanDecoder(_ io.Reader, val interface{}, _ *[8]byte,
        l uint64) error {

        if _, ok := val.(*TrueBoolean); ok && (l == 0 || l == 1) {
                return nil
        }

        return tlv.NewTypeForEncodingErr(val, "TrueBoolean")
}

1	package lnwire
2
3	import (
4	"bytes"
5	"fmt"
6	"io"
7
8	"github.com/btcsuite/btcd/chaincfg"
9	"github.com/btcsuite/btcd/chaincfg/chainhash"
10	"github.com/lightningnetwork/lnd/tlv"
11	)
12
13	const (
14	defaultCltvExpiryDelta = uint16(80)
15	defaultHtlcMinMsat = MilliSatoshi(1)
16	defaultFeeBaseMsat = uint32(1000)
17	defaultFeeProportionalMillionths = uint32(1)
18	)
19
20	// ChannelUpdate2 message is used after taproot channel has been initially
21	// announced. Each side independently announces its fees and minimum expiry for
22	// HTLCs and other parameters. This message is also used to redeclare initially
23	// set channel parameters.
24	type ChannelUpdate2 struct {
25	// Signature is used to validate the announced data and prove the
26	// ownership of node id.
27	Signature Sig
28
29	// ChainHash denotes the target chain that this channel was opened
30	// within. This value should be the genesis hash of the target chain.
31	// Along with the short channel ID, this uniquely identifies the
32	// channel globally in a blockchain.
33	ChainHash tlv.RecordT[tlv.TlvType0, chainhash.Hash]
34
35	// ShortChannelID is the unique description of the funding transaction.
36	ShortChannelID tlv.RecordT[tlv.TlvType2, ShortChannelID]
37
38	// BlockHeight allows ordering in the case of multiple announcements. We
39	// should ignore the message if block height is not greater than the
40	// last-received. The block height must always be greater or equal to
41	// the block height that the channel funding transaction was confirmed
42	// in.
43	BlockHeight tlv.RecordT[tlv.TlvType4, uint32]
44
45	// DisabledFlags is an optional bitfield that describes various reasons
46	// that the node is communicating that the channel should be considered
47	// disabled.
48	DisabledFlags tlv.RecordT[tlv.TlvType6, ChanUpdateDisableFlags]
49
50	// SecondPeer is used to indicate which node the channel node has
51	// created and signed this message. If this field is present, it was
52	// node 2 otherwise it was node 1.
53	SecondPeer tlv.OptionalRecordT[tlv.TlvType8, TrueBoolean]
54
55	// CLTVExpiryDelta is the minimum number of blocks this node requires to
56	// be added to the expiry of HTLCs. This is a security parameter
57	// determined by the node operator. This value represents the required
58	// gap between the time locks of the incoming and outgoing HTLC's set
59	// to this node.
60	CLTVExpiryDelta tlv.RecordT[tlv.TlvType10, uint16]
61
62	// HTLCMinimumMsat is the minimum HTLC value which will be accepted.
63	HTLCMinimumMsat tlv.RecordT[tlv.TlvType12, MilliSatoshi]
64
65	// HtlcMaximumMsat is the maximum HTLC value which will be accepted.
66	HTLCMaximumMsat tlv.RecordT[tlv.TlvType14, MilliSatoshi]
67
68	// FeeBaseMsat is the base fee that must be used for incoming HTLC's to
69	// this particular channel. This value will be tacked onto the required
70	// for a payment independent of the size of the payment.
71	FeeBaseMsat tlv.RecordT[tlv.TlvType16, uint32]
72
73	// FeeProportionalMillionths is the fee rate that will be charged per
74	// millionth of a satoshi.
75	FeeProportionalMillionths tlv.RecordT[tlv.TlvType18, uint32]
76
77	// ExtraOpaqueData is the set of data that was appended to this message
78	// to fill out the full maximum transport message size. These fields can
79	// be used to specify optional data such as custom TLV fields.
80	ExtraOpaqueData ExtraOpaqueData
81	}
82
83	// Decode deserializes a serialized ChannelUpdate2 stored in the passed
84	// io.Reader observing the specified protocol version.
85	//
86	// This is part of the lnwire.Message interface.
87	func (c *ChannelUpdate2) Decode(r io.Reader, _ uint32) error {	×
88	err := ReadElement(r, &c.Signature)	×
89	if err != nil {	×
90	return err	×
91	}	×
92	c.Signature.ForceSchnorr()	×
93		×
94	return c.DecodeTLVRecords(r)	×
95	}
96
97	// DecodeTLVRecords decodes only the TLV section of the message.
98	func (c *ChannelUpdate2) DecodeTLVRecords(r io.Reader) error {	×
99	// First extract into extra opaque data.	×
100	var tlvRecords ExtraOpaqueData	×
101	if err := ReadElements(r, &tlvRecords); err != nil {	×
102	return err	×
103	}	×
104
105	var (	×
106	chainHash = tlv.ZeroRecordT[tlv.TlvType0, [32]byte]()	×
107	secondPeer = tlv.ZeroRecordT[tlv.TlvType8, TrueBoolean]()	×
108	)	×
109	typeMap, err := tlvRecords.ExtractRecords(	×
110	&chainHash, &c.ShortChannelID, &c.BlockHeight, &c.DisabledFlags,	×
111	&secondPeer, &c.CLTVExpiryDelta, &c.HTLCMinimumMsat,	×
112	&c.HTLCMaximumMsat, &c.FeeBaseMsat,	×
113	&c.FeeProportionalMillionths,	×
114	)	×
115	if err != nil {	×
116	return err	×
117	}	×
118
119	// By default, the chain-hash is the bitcoin mainnet genesis block hash.
120	c.ChainHash.Val = *chaincfg.MainNetParams.GenesisHash	×
121	if _, ok := typeMap[c.ChainHash.TlvType()]; ok {	×
122	c.ChainHash.Val = chainHash.Val	×
123	}	×
124
125	// The presence of the second_peer tlv type indicates "true".
126	if _, ok := typeMap[c.SecondPeer.TlvType()]; ok {	×
127	c.SecondPeer = tlv.SomeRecordT(secondPeer)	×
128	}	×
129
130	// If the CLTV expiry delta was not encoded, then set it to the default
131	// value.
132	if _, ok := typeMap[c.CLTVExpiryDelta.TlvType()]; !ok {	×
133	c.CLTVExpiryDelta.Val = defaultCltvExpiryDelta	×
134	}	×
135
136	// If the HTLC Minimum msat was not encoded, then set it to the default
137	// value.
138	if _, ok := typeMap[c.HTLCMinimumMsat.TlvType()]; !ok {	×
139	c.HTLCMinimumMsat.Val = defaultHtlcMinMsat	×
140	}	×
141
142	// If the base fee was not encoded, then set it to the default value.
143	if _, ok := typeMap[c.FeeBaseMsat.TlvType()]; !ok {	×
144	c.FeeBaseMsat.Val = defaultFeeBaseMsat	×
145	}	×
146
147	// If the proportional fee was not encoded, then set it to the default
148	// value.
149	if _, ok := typeMap[c.FeeProportionalMillionths.TlvType()]; !ok {	×
150	c.FeeProportionalMillionths.Val = defaultFeeProportionalMillionths //nolint:ll	×
151	}	×
152
153	if len(tlvRecords) != 0 {	×
154	c.ExtraOpaqueData = tlvRecords	×
155	}	×
156
157	return nil	×
158	}
159
160	// Encode serializes the target ChannelUpdate2 into the passed io.Writer
161	// observing the protocol version specified.
162	//
163	// This is part of the lnwire.Message interface.
164	func (c ChannelUpdate2) Encode(w bytes.Buffer, _ uint32) error {	×
165	_, err := w.Write(c.Signature.RawBytes())	×
166	if err != nil {	×
167	return err	×
168	}	×
169
170	_, err = c.DataToSign()	×
171	if err != nil {	×
172	return err	×
173	}	×
174
175	return WriteBytes(w, c.ExtraOpaqueData)	×
176	}
177
178	// DataToSign is used to retrieve part of the announcement message which should
179	// be signed. For the ChannelUpdate2 message, this includes the serialised TLV
180	// records.
181	func (c *ChannelUpdate2) DataToSign() ([]byte, error) {	×
182	// The chain-hash record is only included if it is _not_ equal to the	×
183	// bitcoin mainnet genisis block hash.	×
184	var recordProducers []tlv.RecordProducer	×
185	if !c.ChainHash.Val.IsEqual(chaincfg.MainNetParams.GenesisHash) {	×
186	hash := tlv.ZeroRecordT[tlv.TlvType0, [32]byte]()	×
187	hash.Val = c.ChainHash.Val	×
188		×
189	recordProducers = append(recordProducers, &hash)	×
190	}	×
191
192	recordProducers = append(recordProducers,	×
193	&c.ShortChannelID, &c.BlockHeight,	×
194	)	×
195		×
196	// Only include the disable flags if any bit is set.	×
197	if !c.DisabledFlags.Val.IsEnabled() {	×
198	recordProducers = append(recordProducers, &c.DisabledFlags)	×
199	}	×
200
201	// We only need to encode the second peer boolean if it is true
202	c.SecondPeer.WhenSome(func(r tlv.RecordT[tlv.TlvType8, TrueBoolean]) {	×
203	recordProducers = append(recordProducers, &r)	×
204	})	×
205
206	// We only encode the cltv expiry delta if it is not equal to the
207	// default.
208	if c.CLTVExpiryDelta.Val != defaultCltvExpiryDelta {	×
209	recordProducers = append(recordProducers, &c.CLTVExpiryDelta)	×
210	}	×
211
212	if c.HTLCMinimumMsat.Val != defaultHtlcMinMsat {	×
213	recordProducers = append(recordProducers, &c.HTLCMinimumMsat)	×
214	}	×
215
216	recordProducers = append(recordProducers, &c.HTLCMaximumMsat)	×
217		×
218	if c.FeeBaseMsat.Val != defaultFeeBaseMsat {	×
219	recordProducers = append(recordProducers, &c.FeeBaseMsat)	×
220	}	×
221
222	if c.FeeProportionalMillionths.Val != defaultFeeProportionalMillionths {	×
223	recordProducers = append(	×
224	recordProducers, &c.FeeProportionalMillionths,	×
225	)	×
226	}	×
227
228	err := EncodeMessageExtraData(&c.ExtraOpaqueData, recordProducers...)	×
229	if err != nil {	×
230	return nil, err	×
231	}	×
232
233	return c.ExtraOpaqueData, nil	×
234	}
235
236	// MsgType returns the integer uniquely identifying this message type on the
237	// wire.
238	//
239	// This is part of the lnwire.Message interface.
240	func (c *ChannelUpdate2) MsgType() MessageType {	×
241	return MsgChannelUpdate2	×
242	}	×
243
244	func (c *ChannelUpdate2) ExtraData() ExtraOpaqueData {	×
245	return c.ExtraOpaqueData	×
246	}	×
247
248	// A compile time check to ensure ChannelUpdate2 implements the
249	// lnwire.Message interface.
250	var _ Message = (*ChannelUpdate2)(nil)
251
252	// SCID returns the ShortChannelID of the channel that the update applies to.
253	//
254	// NOTE: this is part of the ChannelUpdate interface.
255	func (c *ChannelUpdate2) SCID() ShortChannelID {	×
256	return c.ShortChannelID.Val	×
257	}	×
258
259	// IsNode1 is true if the update was produced by node 1 of the channel peers.
260	// Node 1 is the node with the lexicographically smaller public key.
261	//
262	// NOTE: this is part of the ChannelUpdate interface.
263	func (c *ChannelUpdate2) IsNode1() bool {	×
264	return c.SecondPeer.IsNone()	×
265	}	×
266
267	// IsDisabled is true if the update is announcing that the channel should be
268	// considered disabled.
269	//
270	// NOTE: this is part of the ChannelUpdate interface.
271	func (c *ChannelUpdate2) IsDisabled() bool {	×
272	return !c.DisabledFlags.Val.IsEnabled()	×
273	}	×
274
275	// GetChainHash returns the hash of the chain that the message is referring to.
276	//
277	// NOTE: this is part of the ChannelUpdate interface.
278	func (c *ChannelUpdate2) GetChainHash() chainhash.Hash {	×
279	return c.ChainHash.Val	×
280	}	×
281
282	// ForwardingPolicy returns the set of forwarding constraints of the update.
283	//
284	// NOTE: this is part of the ChannelUpdate interface.
285	func (c ChannelUpdate2) ForwardingPolicy() ForwardingPolicy {	×
286	return &ForwardingPolicy{	×
287	TimeLockDelta: c.CLTVExpiryDelta.Val,	×
288	BaseFee: MilliSatoshi(c.FeeBaseMsat.Val),	×
289	FeeRate: MilliSatoshi(c.FeeProportionalMillionths.Val),	×
290	MinHTLC: c.HTLCMinimumMsat.Val,	×
291	HasMaxHTLC: true,	×
292	MaxHTLC: c.HTLCMaximumMsat.Val,	×
293	}	×
294	}	×
295
296	// CmpAge can be used to determine if the update is older or newer than the
297	// passed update. It returns 1 if this update is newer, -1 if it is older, and
298	// 0 if they are the same age.
299	//
300	// NOTE: this is part of the ChannelUpdate interface.
301	func (c *ChannelUpdate2) CmpAge(update ChannelUpdate) (CompareResult, error) {	×
302	other, ok := update.(*ChannelUpdate2)	×
303	if !ok {	×
304	return 0, fmt.Errorf("expected *ChannelUpdate2, got: %T",	×
305	update)	×
306	}	×
307
308	switch {	×
309	case c.BlockHeight.Val > other.BlockHeight.Val:	×
310	return GreaterThan, nil	×
311	case c.BlockHeight.Val < other.BlockHeight.Val:	×
312	return LessThan, nil	×
313	default:	×
314	return EqualTo, nil	×
315	}
316	}
317
318	// SetDisabledFlag can be used to adjust the disabled flag of an update.
319	//
320	// NOTE: this is part of the ChannelUpdate interface.
321	func (c *ChannelUpdate2) SetDisabledFlag(disabled bool) {	×
322	if disabled {	×
323	c.DisabledFlags.Val \|= ChanUpdateDisableIncoming	×
324	c.DisabledFlags.Val \|= ChanUpdateDisableOutgoing	×
325	} else {	×
326	c.DisabledFlags.Val &^= ChanUpdateDisableIncoming	×
327	c.DisabledFlags.Val &^= ChanUpdateDisableOutgoing	×
328	}	×
329	}
330
331	// SetSCID can be used to overwrite the SCID of the update.
332	//
333	// NOTE: this is part of the ChannelUpdate interface.
334	func (c *ChannelUpdate2) SetSCID(scid ShortChannelID) {	×
335	c.ShortChannelID.Val = scid	×
336	}	×
337
338	// A compile time check to ensure ChannelUpdate2 implements the
339	// lnwire.ChannelUpdate interface.
340	var _ ChannelUpdate = (*ChannelUpdate2)(nil)
341
342	// ChanUpdateDisableFlags is a bit vector that can be used to indicate various
343	// reasons for the channel being marked as disabled.
344	type ChanUpdateDisableFlags uint8
345
346	const (
347	// ChanUpdateDisableIncoming is a bit indicates that a channel is
348	// disabled in the inbound direction meaning that the node broadcasting
349	// the update is communicating that they cannot receive funds.
350	ChanUpdateDisableIncoming ChanUpdateDisableFlags = 1 << iota
351
352	// ChanUpdateDisableOutgoing is a bit indicates that a channel is
353	// disabled in the outbound direction meaning that the node broadcasting
354	// the update is communicating that they cannot send or route funds.
355	ChanUpdateDisableOutgoing = 2
356	)
357
358	// IncomingDisabled returns true if the ChanUpdateDisableIncoming bit is set.
359	func (c ChanUpdateDisableFlags) IncomingDisabled() bool {	×
360	return c&ChanUpdateDisableIncoming == ChanUpdateDisableIncoming	×
361	}	×
362
363	// OutgoingDisabled returns true if the ChanUpdateDisableOutgoing bit is set.
364	func (c ChanUpdateDisableFlags) OutgoingDisabled() bool {	×
365	return c&ChanUpdateDisableOutgoing == ChanUpdateDisableOutgoing	×
366	}	×
367
368	// IsEnabled returns true if none of the disable bits are set.
369	func (c ChanUpdateDisableFlags) IsEnabled() bool {	×
370	return c == 0	×
371	}	×
372
373	// String returns the bitfield flags as a string.
374	func (c ChanUpdateDisableFlags) String() string {	×
375	return fmt.Sprintf("%08b", c)	×
376	}	×
377
378	// Record returns the tlv record for the disable flags.
379	func (c *ChanUpdateDisableFlags) Record() tlv.Record {	×
380	return tlv.MakeStaticRecord(0, c, 1, encodeDisableFlags,	×
381	decodeDisableFlags)	×
382	}	×
383
384	func encodeDisableFlags(w io.Writer, val interface{}, buf *[8]byte) error {	×
385	if v, ok := val.(*ChanUpdateDisableFlags); ok {	×
386	flagsInt := uint8(*v)	×
387		×
388	return tlv.EUint8(w, &flagsInt, buf)	×
389	}	×
390
391	return tlv.NewTypeForEncodingErr(val, "lnwire.ChanUpdateDisableFlags")	×
392	}
393
394	func decodeDisableFlags(r io.Reader, val interface{}, buf *[8]byte,
395	l uint64) error {	×
396		×
397	if v, ok := val.(*ChanUpdateDisableFlags); ok {	×
398	var flagsInt uint8	×
399	err := tlv.DUint8(r, &flagsInt, buf, l)	×
400	if err != nil {	×
401	return err	×
402	}	×
403
404	*v = ChanUpdateDisableFlags(flagsInt)	×
405		×
406	return nil	×
407	}
408
409	return tlv.NewTypeForDecodingErr(val, "lnwire.ChanUpdateDisableFlags",	×
410	l, l)	×
411	}
412
413	// TrueBoolean is a record that indicates true or false using the presence of
414	// the record. If the record is absent, it indicates false. If it is present,
415	// it indicates true.
416	type TrueBoolean struct{}
417
418	// Record returns the tlv record for the boolean entry.
419	func (b *TrueBoolean) Record() tlv.Record {	3✔
420	return tlv.MakeStaticRecord(	3✔
421	0, b, 0, booleanEncoder, booleanDecoder,	3✔
422	)	3✔
423	}	3✔
424
425	func booleanEncoder(_ io.Writer, val interface{}, _ *[8]byte) error {	3✔
426	if _, ok := val.(*TrueBoolean); ok {	6✔
427	return nil	3✔
428	}	3✔
429
430	return tlv.NewTypeForEncodingErr(val, "TrueBoolean")	×
431	}
432
433	func booleanDecoder(_ io.Reader, val interface{}, _ *[8]byte,
434	l uint64) error {	3✔
435		3✔
436	if _, ok := val.(*TrueBoolean); ok && (l == 0 \|\| l == 1) {	6✔
437	return nil	3✔
438	}	3✔
439
440	return tlv.NewTypeForEncodingErr(val, "TrueBoolean")	×
441	}

lightningnetwork / lnd / 13035292482

Source File Press 'n' to go to next uncovered line, 'b' for previous

Source File
Press 'n' to go to next uncovered line, 'b' for previous