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

lightningnetwork / lnd / 15561477203

10 Jun 2025 01:54PM UTC coverage: 58.351% (-10.1%) from 68.487%
15561477203

Pull #9356

github

web-flow
Merge 6440b25db into c6d6d4c0b
Pull Request #9356: lnrpc: add incoming/outgoing channel ids filter to forwarding history request

33 of 36 new or added lines in 2 files covered. (91.67%)

28366 existing lines in 455 files now uncovered.

97715 of 167461 relevant lines covered (58.35%)

1.81 hits per line

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

80.0
/lnwire/msat.go
1
package lnwire
2

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

7
        "github.com/btcsuite/btcd/btcutil"
8
        "github.com/lightningnetwork/lnd/tlv"
9
)
10

11
const (
12
        // mSatScale is a value that's used to scale satoshis to milli-satoshis, and
13
        // the other way around.
14
        mSatScale uint64 = 1000
15

16
        // MaxMilliSatoshi is the maximum number of msats that can be expressed
17
        // in this data type.
18
        MaxMilliSatoshi = ^MilliSatoshi(0)
19
)
20

21
// MilliSatoshi are the native unit of the Lightning Network. A milli-satoshi
22
// is simply 1/1000th of a satoshi. There are 1000 milli-satoshis in a single
23
// satoshi. Within the network, all HTLC payments are denominated in
24
// milli-satoshis. As milli-satoshis aren't deliverable on the native
25
// blockchain, before settling to broadcasting, the values are rounded down to
26
// the nearest satoshi.
27
type MilliSatoshi uint64
28

29
// NewMSatFromSatoshis creates a new MilliSatoshi instance from a target amount
30
// of satoshis.
31
func NewMSatFromSatoshis(sat btcutil.Amount) MilliSatoshi {
3✔
32
        return MilliSatoshi(uint64(sat) * mSatScale)
3✔
33
}
3✔
34

35
// ToBTC converts the target MilliSatoshi amount to its corresponding value
36
// when expressed in BTC.
UNCOV
37
func (m MilliSatoshi) ToBTC() float64 {
×
UNCOV
38
        sat := m.ToSatoshis()
×
UNCOV
39
        return sat.ToBTC()
×
UNCOV
40
}
×
41

42
// ToSatoshis converts the target MilliSatoshi amount to satoshis. Simply, this
43
// sheds a factor of 1000 from the mSAT amount in order to convert it to SAT.
44
func (m MilliSatoshi) ToSatoshis() btcutil.Amount {
3✔
45
        return btcutil.Amount(uint64(m) / mSatScale)
3✔
46
}
3✔
47

48
// String returns the string representation of the mSAT amount.
49
func (m MilliSatoshi) String() string {
3✔
50
        return fmt.Sprintf("%v mSAT", uint64(m))
3✔
51
}
3✔
52

53
// TODO(roasbeef): extend with arithmetic operations?
54

55
// Record returns a TLV record that can be used to encode/decode a MilliSatoshi
56
// to/from a TLV stream.
57
func (m *MilliSatoshi) Record() tlv.Record {
3✔
58
        msat := uint64(*m)
3✔
59

3✔
60
        return tlv.MakeDynamicRecord(
3✔
61
                0, m, tlv.SizeBigSize(&msat), encodeMilliSatoshis,
3✔
62
                decodeMilliSatoshis,
3✔
63
        )
3✔
64
}
3✔
65

66
func encodeMilliSatoshis(w io.Writer, val interface{}, buf *[8]byte) error {
3✔
67
        if v, ok := val.(*MilliSatoshi); ok {
6✔
68
                bigSize := uint64(*v)
3✔
69

3✔
70
                return tlv.EBigSize(w, &bigSize, buf)
3✔
71
        }
3✔
72

73
        return tlv.NewTypeForEncodingErr(val, "lnwire.MilliSatoshi")
×
74
}
75

76
func decodeMilliSatoshis(r io.Reader, val interface{}, buf *[8]byte,
77
        l uint64) error {
3✔
78

3✔
79
        if v, ok := val.(*MilliSatoshi); ok {
6✔
80
                var bigSize uint64
3✔
81
                err := tlv.DBigSize(r, &bigSize, buf, l)
3✔
82
                if err != nil {
3✔
UNCOV
83
                        return err
×
UNCOV
84
                }
×
85

86
                *v = MilliSatoshi(bigSize)
3✔
87

3✔
88
                return nil
3✔
89
        }
90

91
        return tlv.NewTypeForDecodingErr(val, "lnwire.MilliSatoshi", l, l)
×
92
}
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