• Home
  • Features
  • Pricing
  • Docs
  • Announcements
  • Sign In

lightningnetwork / lnd / 15155511119

21 May 2025 06:52AM UTC coverage: 57.389% (-11.6%) from 68.996%
15155511119

Pull #9844

github

web-flow
Merge 8658c8597 into c52a6ddeb
Pull Request #9844: Refactor Payment PR 3

346 of 493 new or added lines in 4 files covered. (70.18%)

30172 existing lines in 456 files now uncovered.

95441 of 166305 relevant lines covered (57.39%)

0.61 hits per line

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

83.33
/lnwire/short_channel_id.go
1
package lnwire
2

3
import (
4
        "fmt"
5
        "io"
6

7
        "github.com/lightningnetwork/lnd/tlv"
8
)
9

10
const (
11
        // AliasScidRecordType is the type of the experimental record to denote
12
        // the alias being used in an option_scid_alias channel.
13
        AliasScidRecordType tlv.Type = 1
14
)
15

16
// ShortChannelID represents the set of data which is needed to retrieve all
17
// necessary data to validate the channel existence.
18
type ShortChannelID struct {
19
        // BlockHeight is the height of the block where funding transaction
20
        // located.
21
        //
22
        // NOTE: This field is limited to 3 bytes.
23
        BlockHeight uint32
24

25
        // TxIndex is a position of funding transaction within a block.
26
        //
27
        // NOTE: This field is limited to 3 bytes.
28
        TxIndex uint32
29

30
        // TxPosition indicating transaction output which pays to the channel.
31
        TxPosition uint16
32
}
33

34
// NewShortChanIDFromInt returns a new ShortChannelID which is the decoded
35
// version of the compact channel ID encoded within the uint64. The format of
36
// the compact channel ID is as follows: 3 bytes for the block height, 3 bytes
37
// for the transaction index, and 2 bytes for the output index.
38
func NewShortChanIDFromInt(chanID uint64) ShortChannelID {
1✔
39
        return ShortChannelID{
1✔
40
                BlockHeight: uint32(chanID >> 40),
1✔
41
                TxIndex:     uint32(chanID>>16) & 0xFFFFFF,
1✔
42
                TxPosition:  uint16(chanID),
1✔
43
        }
1✔
44
}
1✔
45

46
// ToUint64 converts the ShortChannelID into a compact format encoded within a
47
// uint64 (8 bytes).
48
func (c ShortChannelID) ToUint64() uint64 {
1✔
49
        // TODO(roasbeef): explicit error on overflow?
1✔
50
        return ((uint64(c.BlockHeight) << 40) | (uint64(c.TxIndex) << 16) |
1✔
51
                (uint64(c.TxPosition)))
1✔
52
}
1✔
53

54
// String generates a human-readable representation of the channel ID.
55
func (c ShortChannelID) String() string {
1✔
56
        return fmt.Sprintf("%d:%d:%d", c.BlockHeight, c.TxIndex, c.TxPosition)
1✔
57
}
1✔
58

59
// AltString generates a human-readable representation of the channel ID
60
// with 'x' as a separator.
UNCOV
61
func (c ShortChannelID) AltString() string {
×
UNCOV
62
        return fmt.Sprintf("%dx%dx%d", c.BlockHeight, c.TxIndex, c.TxPosition)
×
UNCOV
63
}
×
64

65
// Record returns a TLV record that can be used to encode/decode a
66
// ShortChannelID to/from a TLV stream.
67
func (c *ShortChannelID) Record() tlv.Record {
1✔
68
        return tlv.MakeStaticRecord(
1✔
69
                AliasScidRecordType, c, 8, EShortChannelID, DShortChannelID,
1✔
70
        )
1✔
71
}
1✔
72

73
// IsDefault returns true if the ShortChannelID represents the zero value for
74
// its type.
75
func (c ShortChannelID) IsDefault() bool {
1✔
76
        return c == ShortChannelID{}
1✔
77
}
1✔
78

79
// EShortChannelID is an encoder for ShortChannelID. It is exported so other
80
// packages can use the encoding scheme.
81
func EShortChannelID(w io.Writer, val interface{}, buf *[8]byte) error {
1✔
82
        if v, ok := val.(*ShortChannelID); ok {
2✔
83
                return tlv.EUint64T(w, v.ToUint64(), buf)
1✔
84
        }
1✔
85
        return tlv.NewTypeForEncodingErr(val, "lnwire.ShortChannelID")
×
86
}
87

88
// DShortChannelID is a decoder for ShortChannelID. It is exported so other
89
// packages can use the decoding scheme.
90
func DShortChannelID(r io.Reader, val interface{}, buf *[8]byte,
91
        l uint64) error {
1✔
92

1✔
93
        if v, ok := val.(*ShortChannelID); ok {
2✔
94
                var scid uint64
1✔
95
                err := tlv.DUint64(r, &scid, buf, 8)
1✔
96
                if err != nil {
1✔
UNCOV
97
                        return err
×
UNCOV
98
                }
×
99

100
                *v = NewShortChanIDFromInt(scid)
1✔
101
                return nil
1✔
102
        }
103
        return tlv.NewTypeForDecodingErr(val, "lnwire.ShortChannelID", l, 8)
×
104
}
STATUS · Troubleshooting · Open an Issue · Sales · Support · CAREERS · ENTERPRISE · START FREE · SCHEDULE DEMO
ANNOUNCEMENTS · TWITTER · TOS & SLA · Supported CI Services · What's a CI service? · Automated Testing

© 2025 Coveralls, Inc