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

lightningnetwork / lnd / 14193549836

01 Apr 2025 10:40AM UTC coverage: 69.046% (+0.007%) from 69.039%
14193549836

Pull #9665

github

web-flow
Merge e8825f209 into b01f4e514
Pull Request #9665: kvdb: bump etcd libs to v3.5.12

133439 of 193262 relevant lines covered (69.05%)

22119.45 hits per line

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

94.74
/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 {
73,912✔
32
        return MilliSatoshi(uint64(sat) * mSatScale)
73,912✔
33
}
73,912✔
34

35
// ToBTC converts the target MilliSatoshi amount to its corresponding value
36
// when expressed in BTC.
37
func (m MilliSatoshi) ToBTC() float64 {
9✔
38
        sat := m.ToSatoshis()
9✔
39
        return sat.ToBTC()
9✔
40
}
9✔
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 {
243,583✔
45
        return btcutil.Amount(uint64(m) / mSatScale)
243,583✔
46
}
243,583✔
47

48
// String returns the string representation of the mSAT amount.
49
func (m MilliSatoshi) String() string {
21,076✔
50
        return fmt.Sprintf("%v mSAT", uint64(m))
21,076✔
51
}
21,076✔
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 {
830✔
58
        return tlv.MakeDynamicRecord(
830✔
59
                0, m, tlv.SizeBigSize(m), encodeMilliSatoshis,
830✔
60
                decodeMilliSatoshis,
830✔
61
        )
830✔
62
}
830✔
63

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

338✔
68
                return tlv.EBigSize(w, &bigSize, buf)
338✔
69
        }
338✔
70

71
        return tlv.NewTypeForEncodingErr(val, "lnwire.MilliSatoshi")
×
72
}
73

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

315✔
77
        if v, ok := val.(*MilliSatoshi); ok {
630✔
78
                var bigSize uint64
315✔
79
                err := tlv.DBigSize(r, &bigSize, buf, l)
315✔
80
                if err != nil {
316✔
81
                        return err
1✔
82
                }
1✔
83

84
                *v = MilliSatoshi(bigSize)
314✔
85

314✔
86
                return nil
314✔
87
        }
88

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