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

lightningnetwork / lnd / 17132206455

21 Aug 2025 03:56PM UTC coverage: 54.685% (-2.6%) from 57.321%
17132206455

Pull #10167

github

web-flow
Merge 5dd2ed093 into 0c2f045f5
Pull Request #10167: multi: bump Go to 1.24.6

4 of 31 new or added lines in 10 files covered. (12.9%)

23854 existing lines in 284 files now uncovered.

108937 of 199210 relevant lines covered (54.68%)

22026.48 hits per line

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

6.15
/log.go
1
package lnd
2

3
import (
4
        "github.com/btcsuite/btcd/connmgr"
5
        "github.com/btcsuite/btcd/rpcclient"
6
        btclogv1 "github.com/btcsuite/btclog"
7
        "github.com/btcsuite/btclog/v2"
8
        "github.com/lightninglabs/neutrino"
9
        sphinx "github.com/lightningnetwork/lightning-onion"
10
        "github.com/lightningnetwork/lnd/autopilot"
11
        "github.com/lightningnetwork/lnd/build"
12
        "github.com/lightningnetwork/lnd/chainio"
13
        "github.com/lightningnetwork/lnd/chainntnfs"
14
        "github.com/lightningnetwork/lnd/chainreg"
15
        "github.com/lightningnetwork/lnd/chanacceptor"
16
        "github.com/lightningnetwork/lnd/chanbackup"
17
        "github.com/lightningnetwork/lnd/chanfitness"
18
        "github.com/lightningnetwork/lnd/channeldb"
19
        "github.com/lightningnetwork/lnd/channelnotifier"
20
        "github.com/lightningnetwork/lnd/cluster"
21
        "github.com/lightningnetwork/lnd/contractcourt"
22
        "github.com/lightningnetwork/lnd/discovery"
23
        "github.com/lightningnetwork/lnd/funding"
24
        "github.com/lightningnetwork/lnd/graph"
25
        graphdb "github.com/lightningnetwork/lnd/graph/db"
26
        "github.com/lightningnetwork/lnd/healthcheck"
27
        "github.com/lightningnetwork/lnd/htlcswitch"
28
        "github.com/lightningnetwork/lnd/invoices"
29
        "github.com/lightningnetwork/lnd/kvdb/sqlbase"
30
        "github.com/lightningnetwork/lnd/lncfg"
31
        "github.com/lightningnetwork/lnd/lnrpc/autopilotrpc"
32
        "github.com/lightningnetwork/lnd/lnrpc/chainrpc"
33
        "github.com/lightningnetwork/lnd/lnrpc/devrpc"
34
        "github.com/lightningnetwork/lnd/lnrpc/invoicesrpc"
35
        "github.com/lightningnetwork/lnd/lnrpc/neutrinorpc"
36
        "github.com/lightningnetwork/lnd/lnrpc/peersrpc"
37
        "github.com/lightningnetwork/lnd/lnrpc/routerrpc"
38
        "github.com/lightningnetwork/lnd/lnrpc/signrpc"
39
        "github.com/lightningnetwork/lnd/lnrpc/verrpc"
40
        "github.com/lightningnetwork/lnd/lnrpc/walletrpc"
41
        "github.com/lightningnetwork/lnd/lnwallet"
42
        "github.com/lightningnetwork/lnd/lnwallet/btcwallet"
43
        "github.com/lightningnetwork/lnd/lnwallet/chancloser"
44
        "github.com/lightningnetwork/lnd/lnwallet/chanfunding"
45
        "github.com/lightningnetwork/lnd/lnwallet/rpcwallet"
46
        "github.com/lightningnetwork/lnd/monitoring"
47
        "github.com/lightningnetwork/lnd/msgmux"
48
        "github.com/lightningnetwork/lnd/netann"
49
        paymentsdb "github.com/lightningnetwork/lnd/payments/db"
50
        "github.com/lightningnetwork/lnd/peer"
51
        "github.com/lightningnetwork/lnd/peernotifier"
52
        "github.com/lightningnetwork/lnd/protofsm"
53
        "github.com/lightningnetwork/lnd/routing"
54
        "github.com/lightningnetwork/lnd/routing/blindedpath"
55
        "github.com/lightningnetwork/lnd/routing/localchans"
56
        "github.com/lightningnetwork/lnd/rpcperms"
57
        "github.com/lightningnetwork/lnd/signal"
58
        "github.com/lightningnetwork/lnd/sqldb"
59
        "github.com/lightningnetwork/lnd/sweep"
60
        "github.com/lightningnetwork/lnd/tor"
61
        "github.com/lightningnetwork/lnd/watchtower"
62
        "github.com/lightningnetwork/lnd/watchtower/wtclient"
63
)
64

65
// replaceableLogger is a thin wrapper around a logger that is used so the
66
// logger can be replaced easily without some black pointer magic.
67
type replaceableLogger struct {
68
        btclog.Logger
69
        subsystem string
70
}
71

72
// Loggers can not be used before the log rotator has been initialized with a
73
// log file. This must be performed early during application startup by
74
// calling InitLogRotator() on the main log writer instance in the config.
75
var (
76
        // lndPkgLoggers is a list of all lnd package level loggers that are
77
        // registered. They are tracked here so they can be replaced once the
78
        // SetupLoggers function is called with the final root logger.
79
        lndPkgLoggers []*replaceableLogger
80

81
        // addLndPkgLogger is a helper function that creates a new replaceable
82
        // main lnd package level logger and adds it to the list of loggers that
83
        // are replaced again later, once the final root logger is ready.
84
        addLndPkgLogger = func(subsystem string) *replaceableLogger {
15✔
85
                l := &replaceableLogger{
15✔
86
                        Logger:    build.NewSubLogger(subsystem, nil),
15✔
87
                        subsystem: subsystem,
15✔
88
                }
15✔
89
                lndPkgLoggers = append(lndPkgLoggers, l)
15✔
90
                return l
15✔
91
        }
15✔
92

93
        // Loggers that need to be accessible from the lnd package can be placed
94
        // here. Loggers that are only used in sub modules can be added directly
95
        // by using the addSubLogger method. We declare all loggers so we never
96
        // run into a nil reference if they are used early. But the SetupLoggers
97
        // function should always be called as soon as possible to finish
98
        // setting them up properly with a root logger.
99
        ltndLog = addLndPkgLogger("LTND")
100
        rpcsLog = addLndPkgLogger("RPCS")
101
        srvrLog = addLndPkgLogger("SRVR")
102
        atplLog = addLndPkgLogger("ATPL")
103
        acsmLog = addLndPkgLogger("ACSM")
104
)
105

106
// genSubLogger creates a logger for a subsystem. We provide an instance of
107
// a signal.Interceptor to be able to shutdown in the case of a critical error.
108
func genSubLogger(root *build.SubLoggerManager,
UNCOV
109
        interceptor signal.Interceptor) func(string) btclog.Logger {
×
UNCOV
110

×
UNCOV
111
        // Create a shutdown function which will request shutdown from our
×
UNCOV
112
        // interceptor if it is listening.
×
UNCOV
113
        shutdown := func() {
×
114
                if !interceptor.Listening() {
×
115
                        return
×
116
                }
×
117

118
                interceptor.RequestShutdown()
×
119
        }
120

121
        // Return a function which will create a sublogger from our root
122
        // logger without shutdown fn.
UNCOV
123
        return func(tag string) btclog.Logger {
×
UNCOV
124
                return root.GenSubLogger(tag, shutdown)
×
UNCOV
125
        }
×
126
}
127

128
// SetupLoggers initializes all package-global logger variables.
129
//
130
//nolint:ll
UNCOV
131
func SetupLoggers(root *build.SubLoggerManager, interceptor signal.Interceptor) {
×
UNCOV
132
        genLogger := genSubLogger(root, interceptor)
×
UNCOV
133

×
UNCOV
134
        // Now that we have the proper root logger, we can replace the
×
UNCOV
135
        // placeholder lnd package loggers.
×
UNCOV
136
        for _, l := range lndPkgLoggers {
×
UNCOV
137
                l.Logger = build.NewSubLogger(l.subsystem, genLogger)
×
UNCOV
138
                SetSubLogger(root, l.subsystem, l.Logger)
×
UNCOV
139
        }
×
140

141
        // Initialize loggers from packages outside of `lnd` first. The
142
        // packages below will overwrite the names of the loggers they import.
143
        // For instance, the logger in `neutrino.query` is overwritten by
144
        // `btcwallet.chain`, which is overwritten by `lnwallet`. To ensure the
145
        // overwriting works, we need to initialize the loggers here so they
146
        // can be overwritten later.
UNCOV
147
        AddV1SubLogger(root, "BTCN", interceptor, neutrino.UseLogger)
×
UNCOV
148
        AddV1SubLogger(root, "CMGR", interceptor, connmgr.UseLogger)
×
UNCOV
149
        AddV1SubLogger(root, "RPCC", interceptor, rpcclient.UseLogger)
×
UNCOV
150

×
UNCOV
151
        // Some of the loggers declared in the main lnd package are also used
×
UNCOV
152
        // in sub packages.
×
UNCOV
153
        signal.UseLogger(ltndLog)
×
UNCOV
154
        autopilot.UseLogger(atplLog)
×
UNCOV
155

×
UNCOV
156
        AddSubLogger(root, "LNWL", interceptor, lnwallet.UseLogger)
×
UNCOV
157
        AddSubLogger(root, "DISC", interceptor, discovery.UseLogger)
×
UNCOV
158
        AddSubLogger(root, "NTFN", interceptor, chainntnfs.UseLogger)
×
UNCOV
159
        AddSubLogger(root, "CHDB", interceptor, channeldb.UseLogger)
×
UNCOV
160
        AddSubLogger(root, "SQLB", interceptor, sqlbase.UseLogger)
×
UNCOV
161
        AddSubLogger(root, "HSWC", interceptor, htlcswitch.UseLogger)
×
UNCOV
162
        AddSubLogger(root, "CNCT", interceptor, contractcourt.UseLogger)
×
UNCOV
163
        AddSubLogger(root, "UTXN", interceptor, contractcourt.UseNurseryLogger)
×
UNCOV
164
        AddSubLogger(root, "BRAR", interceptor, contractcourt.UseBreachLogger)
×
UNCOV
165
        AddV1SubLogger(root, "SPHX", interceptor, sphinx.UseLogger)
×
UNCOV
166
        AddSubLogger(root, "SWPR", interceptor, sweep.UseLogger)
×
UNCOV
167
        AddSubLogger(root, "SGNR", interceptor, signrpc.UseLogger)
×
UNCOV
168
        AddSubLogger(root, "WLKT", interceptor, walletrpc.UseLogger)
×
UNCOV
169
        AddSubLogger(root, "ARPC", interceptor, autopilotrpc.UseLogger)
×
UNCOV
170
        AddSubLogger(root, "NRPC", interceptor, neutrinorpc.UseLogger)
×
UNCOV
171
        AddSubLogger(root, "DRPC", interceptor, devrpc.UseLogger)
×
UNCOV
172
        AddSubLogger(root, "INVC", interceptor, invoices.UseLogger)
×
UNCOV
173
        AddSubLogger(root, "NANN", interceptor, netann.UseLogger)
×
UNCOV
174
        AddSubLogger(root, "WTWR", interceptor, watchtower.UseLogger)
×
UNCOV
175
        AddSubLogger(root, "NTFR", interceptor, chainrpc.UseLogger)
×
UNCOV
176
        AddSubLogger(root, "IRPC", interceptor, invoicesrpc.UseLogger)
×
UNCOV
177
        AddSubLogger(root, "CHNF", interceptor, channelnotifier.UseLogger)
×
UNCOV
178
        AddSubLogger(root, "CHBU", interceptor, chanbackup.UseLogger)
×
UNCOV
179
        AddSubLogger(root, "PROM", interceptor, monitoring.UseLogger)
×
UNCOV
180
        AddSubLogger(root, "WTCL", interceptor, wtclient.UseLogger)
×
UNCOV
181
        AddSubLogger(root, "PRNF", interceptor, peernotifier.UseLogger)
×
UNCOV
182
        AddSubLogger(root, "CHFD", interceptor, chanfunding.UseLogger)
×
UNCOV
183
        AddSubLogger(root, "PEER", interceptor, peer.UseLogger)
×
UNCOV
184
        AddSubLogger(root, "CHCL", interceptor, chancloser.UseLogger)
×
UNCOV
185
        AddSubLogger(root, "LCHN", interceptor, localchans.UseLogger)
×
UNCOV
186
        AddSubLogger(root, "PFSM", interceptor, protofsm.UseLogger)
×
UNCOV
187

×
UNCOV
188
        AddSubLogger(root, routing.Subsystem, interceptor, routing.UseLogger)
×
UNCOV
189
        AddSubLogger(root, routerrpc.Subsystem, interceptor, routerrpc.UseLogger)
×
UNCOV
190
        AddSubLogger(root, chanfitness.Subsystem, interceptor, chanfitness.UseLogger)
×
UNCOV
191
        AddSubLogger(root, verrpc.Subsystem, interceptor, verrpc.UseLogger)
×
UNCOV
192
        AddSubLogger(root, healthcheck.Subsystem, interceptor, healthcheck.UseLogger)
×
UNCOV
193
        AddSubLogger(root, chainreg.Subsystem, interceptor, chainreg.UseLogger)
×
UNCOV
194
        AddSubLogger(root, chanacceptor.Subsystem, interceptor, chanacceptor.UseLogger)
×
UNCOV
195
        AddSubLogger(root, funding.Subsystem, interceptor, funding.UseLogger)
×
UNCOV
196
        AddSubLogger(root, cluster.Subsystem, interceptor, cluster.UseLogger)
×
UNCOV
197
        AddSubLogger(root, rpcperms.Subsystem, interceptor, rpcperms.UseLogger)
×
UNCOV
198
        AddSubLogger(root, tor.Subsystem, interceptor, tor.UseLogger)
×
UNCOV
199
        AddSubLogger(root, btcwallet.Subsystem, interceptor, btcwallet.UseLogger)
×
UNCOV
200
        AddSubLogger(root, rpcwallet.Subsystem, interceptor, rpcwallet.UseLogger)
×
UNCOV
201
        AddSubLogger(root, peersrpc.Subsystem, interceptor, peersrpc.UseLogger)
×
UNCOV
202
        AddSubLogger(root, graph.Subsystem, interceptor, graph.UseLogger)
×
UNCOV
203
        AddSubLogger(root, lncfg.Subsystem, interceptor, lncfg.UseLogger)
×
UNCOV
204
        AddSubLogger(
×
UNCOV
205
                root, blindedpath.Subsystem, interceptor, blindedpath.UseLogger,
×
UNCOV
206
        )
×
UNCOV
207
        AddSubLogger(root, graphdb.Subsystem, interceptor, graphdb.UseLogger)
×
UNCOV
208
        AddSubLogger(root, chainio.Subsystem, interceptor, chainio.UseLogger)
×
UNCOV
209
        AddSubLogger(root, msgmux.Subsystem, interceptor, msgmux.UseLogger)
×
UNCOV
210
        AddSubLogger(root, sqldb.Subsystem, interceptor, sqldb.UseLogger)
×
UNCOV
211
        AddSubLogger(
×
UNCOV
212
                root, paymentsdb.Subsystem, interceptor, paymentsdb.UseLogger,
×
UNCOV
213
        )
×
214

215
}
216

217
// AddSubLogger is a helper method to conveniently create and register the
218
// logger of one or more sub systems.
219
func AddSubLogger(root *build.SubLoggerManager, subsystem string,
UNCOV
220
        interceptor signal.Interceptor, useLoggers ...func(btclog.Logger)) {
×
UNCOV
221

×
UNCOV
222
        // genSubLogger will return a callback for creating a logger instance,
×
UNCOV
223
        // which we will give to the root logger.
×
UNCOV
224
        genLogger := genSubLogger(root, interceptor)
×
UNCOV
225

×
UNCOV
226
        // Create and register just a single logger to prevent them from
×
UNCOV
227
        // overwriting each other internally.
×
UNCOV
228
        logger := build.NewSubLogger(subsystem, genLogger)
×
UNCOV
229
        SetSubLogger(root, subsystem, logger, useLoggers...)
×
UNCOV
230
}
×
231

232
// SetSubLogger is a helper method to conveniently register the logger of a
233
// sub system.
234
func SetSubLogger(root *build.SubLoggerManager, subsystem string,
UNCOV
235
        logger btclog.Logger, useLoggers ...func(btclog.Logger)) {
×
UNCOV
236

×
UNCOV
237
        root.RegisterSubLogger(subsystem, logger)
×
UNCOV
238
        for _, useLogger := range useLoggers {
×
UNCOV
239
                useLogger(logger)
×
UNCOV
240
        }
×
241
}
242

243
// AddV1SubLogger is a helper method to conveniently create and register the
244
// logger of one or more sub systems.
245
func AddV1SubLogger(root *build.SubLoggerManager, subsystem string,
UNCOV
246
        interceptor signal.Interceptor, useLoggers ...func(btclogv1.Logger)) {
×
UNCOV
247

×
UNCOV
248
        // genSubLogger will return a callback for creating a logger instance,
×
UNCOV
249
        // which we will give to the root logger.
×
UNCOV
250
        genLogger := genSubLogger(root, interceptor)
×
UNCOV
251

×
UNCOV
252
        // Create and register just a single logger to prevent them from
×
UNCOV
253
        // overwriting each other internally.
×
UNCOV
254
        logger := build.NewSubLogger(subsystem, genLogger)
×
UNCOV
255
        SetV1SubLogger(root, subsystem, logger, useLoggers...)
×
UNCOV
256
}
×
257

258
// SetV1SubLogger is a helper method to conveniently register the logger of a
259
// sub system. Note that the btclog v2 logger implements the btclog v1 logger
260
// which is why we can pass the v2 logger to the UseLogger call-backs that
261
// expect the v1 logger.
262
func SetV1SubLogger(root *build.SubLoggerManager, subsystem string,
UNCOV
263
        logger btclog.Logger, useLoggers ...func(btclogv1.Logger)) {
×
UNCOV
264

×
UNCOV
265
        root.RegisterSubLogger(subsystem, logger)
×
UNCOV
266
        for _, useLogger := range useLoggers {
×
UNCOV
267
                useLogger(logger)
×
UNCOV
268
        }
×
269
}
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