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

lightningnetwork / lnd / 12430538171

20 Dec 2024 11:21AM UTC coverage: 58.716% (+0.1%) from 58.576%
12430538171

push

github

web-flow
Merge pull request #9381 from yyforyongyu/fix-no-space-left

workflows: fix no space left error

135265 of 230373 relevant lines covered (58.72%)

19174.52 hits per line

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

91.52
/contractcourt/htlc_success_resolver.go
1
package contractcourt
2

3
import (
4
        "encoding/binary"
5
        "fmt"
6
        "io"
7
        "sync"
8

9
        "github.com/btcsuite/btcd/btcutil"
10
        "github.com/btcsuite/btcd/chaincfg/chainhash"
11
        "github.com/btcsuite/btcd/txscript"
12
        "github.com/btcsuite/btcd/wire"
13
        "github.com/lightningnetwork/lnd/channeldb"
14
        "github.com/lightningnetwork/lnd/fn/v2"
15
        "github.com/lightningnetwork/lnd/graph/db/models"
16
        "github.com/lightningnetwork/lnd/input"
17
        "github.com/lightningnetwork/lnd/labels"
18
        "github.com/lightningnetwork/lnd/lnutils"
19
        "github.com/lightningnetwork/lnd/lnwallet"
20
        "github.com/lightningnetwork/lnd/sweep"
21
)
22

23
// htlcSuccessResolver is a resolver that's capable of sweeping an incoming
24
// HTLC output on-chain. If this is the remote party's commitment, we'll sweep
25
// it directly from the commitment output *immediately*. If this is our
26
// commitment, we'll first broadcast the success transaction, then send it to
27
// the incubator for sweeping. That's it, no need to send any clean up
28
// messages.
29
//
30
// TODO(roasbeef): don't need to broadcast?
31
type htlcSuccessResolver struct {
32
        // htlcResolution is the incoming HTLC resolution for this HTLC. It
33
        // contains everything we need to properly resolve this HTLC.
34
        htlcResolution lnwallet.IncomingHtlcResolution
35

36
        // outputIncubating returns true if we've sent the output to the output
37
        // incubator (utxo nursery). In case the htlcResolution has non-nil
38
        // SignDetails, it means we will let the Sweeper handle broadcasting
39
        // the secondd-level transaction, and sweeping its output. In this case
40
        // we let this field indicate whether we need to broadcast the
41
        // second-level tx (false) or if it has confirmed and we must sweep the
42
        // second-level output (true).
43
        outputIncubating bool
44

45
        // broadcastHeight is the height that the original contract was
46
        // broadcast to the main-chain at. We'll use this value to bound any
47
        // historical queries to the chain for spends/confirmations.
48
        broadcastHeight uint32
49

50
        // htlc contains information on the htlc that we are resolving on-chain.
51
        htlc channeldb.HTLC
52

53
        // currentReport stores the current state of the resolver for reporting
54
        // over the rpc interface. This should only be reported in case we have
55
        // a non-nil SignDetails on the htlcResolution, otherwise the nursery
56
        // will produce reports.
57
        currentReport ContractReport
58

59
        // reportLock prevents concurrent access to the resolver report.
60
        reportLock sync.Mutex
61

62
        contractResolverKit
63

64
        htlcLeaseResolver
65
}
66

67
// newSuccessResolver instanties a new htlc success resolver.
68
func newSuccessResolver(res lnwallet.IncomingHtlcResolution,
69
        broadcastHeight uint32, htlc channeldb.HTLC,
70
        resCfg ResolverConfig) *htlcSuccessResolver {
3✔
71

3✔
72
        h := &htlcSuccessResolver{
3✔
73
                contractResolverKit: *newContractResolverKit(resCfg),
3✔
74
                htlcResolution:      res,
3✔
75
                broadcastHeight:     broadcastHeight,
3✔
76
                htlc:                htlc,
3✔
77
        }
3✔
78

3✔
79
        h.initReport()
3✔
80
        h.initLogger(fmt.Sprintf("%T(%v)", h, h.outpoint()))
3✔
81

3✔
82
        return h
3✔
83
}
3✔
84

85
// outpoint returns the outpoint of the HTLC output we're attempting to sweep.
86
func (h *htlcSuccessResolver) outpoint() wire.OutPoint {
16✔
87
        // The primary key for this resolver will be the outpoint of the HTLC
16✔
88
        // on the commitment transaction itself. If this is our commitment,
16✔
89
        // then the output can be found within the signed success tx,
16✔
90
        // otherwise, it's just the ClaimOutpoint.
16✔
91
        if h.htlcResolution.SignedSuccessTx != nil {
23✔
92
                return h.htlcResolution.SignedSuccessTx.TxIn[0].PreviousOutPoint
7✔
93
        }
7✔
94

95
        return h.htlcResolution.ClaimOutpoint
12✔
96
}
97

98
// ResolverKey returns an identifier which should be globally unique for this
99
// particular resolver within the chain the original contract resides within.
100
//
101
// NOTE: Part of the ContractResolver interface.
102
func (h *htlcSuccessResolver) ResolverKey() []byte {
9✔
103
        key := newResolverID(h.outpoint())
9✔
104
        return key[:]
9✔
105
}
9✔
106

107
// Resolve attempts to resolve an unresolved incoming HTLC that we know the
108
// preimage to. If the HTLC is on the commitment of the remote party, then we'll
109
// simply sweep it directly. Otherwise, we'll hand this off to the utxo nursery
110
// to do its duty. There is no need to make a call to the invoice registry
111
// anymore. Every HTLC has already passed through the incoming contest resolver
112
// and in there the invoice was already marked as settled.
113
//
114
// NOTE: Part of the ContractResolver interface.
115
//
116
// TODO(yy): refactor the interface method to return an error only.
117
func (h *htlcSuccessResolver) Resolve() (ContractResolver, error) {
11✔
118
        var err error
11✔
119

11✔
120
        switch {
11✔
121
        // If we're already resolved, then we can exit early.
122
        case h.IsResolved():
3✔
123
                h.log.Errorf("already resolved")
3✔
124

125
        // If this is an output on the remote party's commitment transaction,
126
        // use the direct-spend path to sweep the htlc.
127
        case h.isRemoteCommitOutput():
4✔
128
                err = h.resolveRemoteCommitOutput()
4✔
129

130
        // If this is an output on our commitment transaction using post-anchor
131
        // channel type, it will be handled by the sweeper.
132
        case h.isZeroFeeOutput():
5✔
133
                err = h.resolveSuccessTx()
5✔
134

135
        // If this is an output on our own commitment using pre-anchor channel
136
        // type, we will publish the success tx and offer the output to the
137
        // nursery.
138
        default:
2✔
139
                err = h.resolveLegacySuccessTx()
2✔
140
        }
141

142
        return nil, err
11✔
143
}
144

145
// resolveRemoteCommitOutput handles sweeping an HTLC output on the remote
146
// commitment with the preimage. In this case we can sweep the output directly,
147
// and don't have to broadcast a second-level transaction.
148
func (h *htlcSuccessResolver) resolveRemoteCommitOutput() error {
4✔
149
        h.log.Info("waiting for direct-preimage spend of the htlc to confirm")
4✔
150

4✔
151
        // Wait for the direct-preimage HTLC sweep tx to confirm.
4✔
152
        //
4✔
153
        // TODO(yy): use the result chan returned from `SweepInput`.
4✔
154
        sweepTxDetails, err := waitForSpend(
4✔
155
                &h.htlcResolution.ClaimOutpoint,
4✔
156
                h.htlcResolution.SweepSignDesc.Output.PkScript,
4✔
157
                h.broadcastHeight, h.Notifier, h.quit,
4✔
158
        )
4✔
159
        if err != nil {
6✔
160
                return err
2✔
161
        }
2✔
162

163
        // TODO(yy): should also update the `RecoveredBalance` and
164
        // `LimboBalance` like other paths?
165

166
        // Checkpoint the resolver, and write the outcome to disk.
167
        return h.checkpointClaim(sweepTxDetails.SpenderTxHash)
4✔
168
}
169

170
// checkpointClaim checkpoints the success resolver with the reports it needs.
171
// If this htlc was claimed two stages, it will write reports for both stages,
172
// otherwise it will just write for the single htlc claim.
173
func (h *htlcSuccessResolver) checkpointClaim(spendTx *chainhash.Hash) error {
8✔
174
        // Mark the htlc as final settled.
8✔
175
        err := h.ChainArbitratorConfig.PutFinalHtlcOutcome(
8✔
176
                h.ChannelArbitratorConfig.ShortChanID, h.htlc.HtlcIndex, true,
8✔
177
        )
8✔
178
        if err != nil {
8✔
179
                return err
×
180
        }
×
181

182
        // Send notification.
183
        h.ChainArbitratorConfig.HtlcNotifier.NotifyFinalHtlcEvent(
8✔
184
                models.CircuitKey{
8✔
185
                        ChanID: h.ShortChanID,
8✔
186
                        HtlcID: h.htlc.HtlcIndex,
8✔
187
                },
8✔
188
                channeldb.FinalHtlcInfo{
8✔
189
                        Settled:  true,
8✔
190
                        Offchain: false,
8✔
191
                },
8✔
192
        )
8✔
193

8✔
194
        // Create a resolver report for claiming of the htlc itself.
8✔
195
        amt := btcutil.Amount(h.htlcResolution.SweepSignDesc.Output.Value)
8✔
196
        reports := []*channeldb.ResolverReport{
8✔
197
                {
8✔
198
                        OutPoint:        h.htlcResolution.ClaimOutpoint,
8✔
199
                        Amount:          amt,
8✔
200
                        ResolverType:    channeldb.ResolverTypeIncomingHtlc,
8✔
201
                        ResolverOutcome: channeldb.ResolverOutcomeClaimed,
8✔
202
                        SpendTxID:       spendTx,
8✔
203
                },
8✔
204
        }
8✔
205

8✔
206
        // If we have a success tx, we append a report to represent our first
8✔
207
        // stage claim.
8✔
208
        if h.htlcResolution.SignedSuccessTx != nil {
15✔
209
                // If the SignedSuccessTx is not nil, we are claiming the htlc
7✔
210
                // in two stages, so we need to create a report for the first
7✔
211
                // stage transaction as well.
7✔
212
                spendTx := h.htlcResolution.SignedSuccessTx
7✔
213
                spendTxID := spendTx.TxHash()
7✔
214

7✔
215
                report := &channeldb.ResolverReport{
7✔
216
                        OutPoint:        spendTx.TxIn[0].PreviousOutPoint,
7✔
217
                        Amount:          h.htlc.Amt.ToSatoshis(),
7✔
218
                        ResolverType:    channeldb.ResolverTypeIncomingHtlc,
7✔
219
                        ResolverOutcome: channeldb.ResolverOutcomeFirstStage,
7✔
220
                        SpendTxID:       &spendTxID,
7✔
221
                }
7✔
222
                reports = append(reports, report)
7✔
223
        }
7✔
224

225
        // Finally, we checkpoint the resolver with our report(s).
226
        h.markResolved()
8✔
227
        return h.Checkpoint(h, reports...)
8✔
228
}
229

230
// Stop signals the resolver to cancel any current resolution processes, and
231
// suspend.
232
//
233
// NOTE: Part of the ContractResolver interface.
234
func (h *htlcSuccessResolver) Stop() {
3✔
235
        h.log.Debugf("stopping...")
3✔
236
        defer h.log.Debugf("stopped")
3✔
237

3✔
238
        close(h.quit)
3✔
239
}
3✔
240

241
// report returns a report on the resolution state of the contract.
242
func (h *htlcSuccessResolver) report() *ContractReport {
3✔
243
        // If the sign details are nil, the report will be created by handled
3✔
244
        // by the nursery.
3✔
245
        if h.htlcResolution.SignDetails == nil {
6✔
246
                return nil
3✔
247
        }
3✔
248

249
        h.reportLock.Lock()
3✔
250
        defer h.reportLock.Unlock()
3✔
251
        cpy := h.currentReport
3✔
252
        return &cpy
3✔
253
}
254

255
func (h *htlcSuccessResolver) initReport() {
10✔
256
        // We create the initial report. This will only be reported for
10✔
257
        // resolvers not handled by the nursery.
10✔
258
        finalAmt := h.htlc.Amt.ToSatoshis()
10✔
259
        if h.htlcResolution.SignedSuccessTx != nil {
17✔
260
                finalAmt = btcutil.Amount(
7✔
261
                        h.htlcResolution.SignedSuccessTx.TxOut[0].Value,
7✔
262
                )
7✔
263
        }
7✔
264

265
        h.currentReport = ContractReport{
10✔
266
                Outpoint:       h.htlcResolution.ClaimOutpoint,
10✔
267
                Type:           ReportOutputIncomingHtlc,
10✔
268
                Amount:         finalAmt,
10✔
269
                MaturityHeight: h.htlcResolution.CsvDelay,
10✔
270
                LimboBalance:   finalAmt,
10✔
271
                Stage:          1,
10✔
272
        }
10✔
273
}
274

275
// Encode writes an encoded version of the ContractResolver into the passed
276
// Writer.
277
//
278
// NOTE: Part of the ContractResolver interface.
279
func (h *htlcSuccessResolver) Encode(w io.Writer) error {
12✔
280
        // First we'll encode our inner HTLC resolution.
12✔
281
        if err := encodeIncomingResolution(w, &h.htlcResolution); err != nil {
12✔
282
                return err
×
283
        }
×
284

285
        // Next, we'll write out the fields that are specified to the contract
286
        // resolver.
287
        if err := binary.Write(w, endian, h.outputIncubating); err != nil {
12✔
288
                return err
×
289
        }
×
290
        if err := binary.Write(w, endian, h.IsResolved()); err != nil {
12✔
291
                return err
×
292
        }
×
293
        if err := binary.Write(w, endian, h.broadcastHeight); err != nil {
12✔
294
                return err
×
295
        }
×
296
        if _, err := w.Write(h.htlc.RHash[:]); err != nil {
12✔
297
                return err
×
298
        }
×
299

300
        // We encode the sign details last for backwards compatibility.
301
        err := encodeSignDetails(w, h.htlcResolution.SignDetails)
12✔
302
        if err != nil {
12✔
303
                return err
×
304
        }
×
305

306
        return nil
12✔
307
}
308

309
// newSuccessResolverFromReader attempts to decode an encoded ContractResolver
310
// from the passed Reader instance, returning an active ContractResolver
311
// instance.
312
func newSuccessResolverFromReader(r io.Reader, resCfg ResolverConfig) (
313
        *htlcSuccessResolver, error) {
10✔
314

10✔
315
        h := &htlcSuccessResolver{
10✔
316
                contractResolverKit: *newContractResolverKit(resCfg),
10✔
317
        }
10✔
318

10✔
319
        // First we'll decode our inner HTLC resolution.
10✔
320
        if err := decodeIncomingResolution(r, &h.htlcResolution); err != nil {
10✔
321
                return nil, err
×
322
        }
×
323

324
        // Next, we'll read all the fields that are specified to the contract
325
        // resolver.
326
        if err := binary.Read(r, endian, &h.outputIncubating); err != nil {
10✔
327
                return nil, err
×
328
        }
×
329

330
        var resolved bool
10✔
331
        if err := binary.Read(r, endian, &resolved); err != nil {
10✔
332
                return nil, err
×
333
        }
×
334
        if resolved {
17✔
335
                h.markResolved()
7✔
336
        }
7✔
337

338
        if err := binary.Read(r, endian, &h.broadcastHeight); err != nil {
10✔
339
                return nil, err
×
340
        }
×
341
        if _, err := io.ReadFull(r, h.htlc.RHash[:]); err != nil {
10✔
342
                return nil, err
×
343
        }
×
344

345
        // Sign details is a new field that was added to the htlc resolution,
346
        // so it is serialized last for backwards compatibility. We try to read
347
        // it, but don't error out if there are not bytes left.
348
        signDetails, err := decodeSignDetails(r)
10✔
349
        if err == nil {
20✔
350
                h.htlcResolution.SignDetails = signDetails
10✔
351
        } else if err != io.EOF && err != io.ErrUnexpectedEOF {
10✔
352
                return nil, err
×
353
        }
×
354

355
        h.initReport()
10✔
356
        h.initLogger(fmt.Sprintf("%T(%v)", h, h.outpoint()))
10✔
357

10✔
358
        return h, nil
10✔
359
}
360

361
// Supplement adds additional information to the resolver that is required
362
// before Resolve() is called.
363
//
364
// NOTE: Part of the htlcContractResolver interface.
365
func (h *htlcSuccessResolver) Supplement(htlc channeldb.HTLC) {
5✔
366
        h.htlc = htlc
5✔
367
}
5✔
368

369
// HtlcPoint returns the htlc's outpoint on the commitment tx.
370
//
371
// NOTE: Part of the htlcContractResolver interface.
372
func (h *htlcSuccessResolver) HtlcPoint() wire.OutPoint {
3✔
373
        return h.htlcResolution.HtlcPoint()
3✔
374
}
3✔
375

376
// SupplementDeadline does nothing for an incoming htlc resolver.
377
//
378
// NOTE: Part of the htlcContractResolver interface.
379
func (h *htlcSuccessResolver) SupplementDeadline(_ fn.Option[int32]) {
×
380
}
×
381

382
// A compile time assertion to ensure htlcSuccessResolver meets the
383
// ContractResolver interface.
384
var _ htlcContractResolver = (*htlcSuccessResolver)(nil)
385

386
// isRemoteCommitOutput returns a bool to indicate whether the htlc output is
387
// on the remote commitment.
388
func (h *htlcSuccessResolver) isRemoteCommitOutput() bool {
16✔
389
        // If we don't have a success transaction, then this means that this is
16✔
390
        // an output on the remote party's commitment transaction.
16✔
391
        return h.htlcResolution.SignedSuccessTx == nil
16✔
392
}
16✔
393

394
// isZeroFeeOutput returns a boolean indicating whether the htlc output is from
395
// a anchor-enabled channel, which uses the sighash SINGLE|ANYONECANPAY.
396
func (h *htlcSuccessResolver) isZeroFeeOutput() bool {
11✔
397
        // If we have non-nil SignDetails, this means it has a 2nd level HTLC
11✔
398
        // transaction that is signed using sighash SINGLE|ANYONECANPAY (the
11✔
399
        // case for anchor type channels). In this case we can re-sign it and
11✔
400
        // attach fees at will.
11✔
401
        return h.htlcResolution.SignedSuccessTx != nil &&
11✔
402
                h.htlcResolution.SignDetails != nil
11✔
403
}
11✔
404

405
// isTaproot returns true if the resolver is for a taproot output.
406
func (h *htlcSuccessResolver) isTaproot() bool {
10✔
407
        return txscript.IsPayToTaproot(
10✔
408
                h.htlcResolution.SweepSignDesc.Output.PkScript,
10✔
409
        )
10✔
410
}
10✔
411

412
// sweepRemoteCommitOutput creates a sweep request to sweep the HTLC output on
413
// the remote commitment via the direct preimage-spend.
414
func (h *htlcSuccessResolver) sweepRemoteCommitOutput() error {
7✔
415
        // Before we can craft out sweeping transaction, we need to create an
7✔
416
        // input which contains all the items required to add this input to a
7✔
417
        // sweeping transaction, and generate a witness.
7✔
418
        var inp input.Input
7✔
419

7✔
420
        if h.isTaproot() {
10✔
421
                inp = lnutils.Ptr(input.MakeTaprootHtlcSucceedInput(
3✔
422
                        &h.htlcResolution.ClaimOutpoint,
3✔
423
                        &h.htlcResolution.SweepSignDesc,
3✔
424
                        h.htlcResolution.Preimage[:],
3✔
425
                        h.broadcastHeight,
3✔
426
                        h.htlcResolution.CsvDelay,
3✔
427
                        input.WithResolutionBlob(
3✔
428
                                h.htlcResolution.ResolutionBlob,
3✔
429
                        ),
3✔
430
                ))
3✔
431
        } else {
10✔
432
                inp = lnutils.Ptr(input.MakeHtlcSucceedInput(
7✔
433
                        &h.htlcResolution.ClaimOutpoint,
7✔
434
                        &h.htlcResolution.SweepSignDesc,
7✔
435
                        h.htlcResolution.Preimage[:],
7✔
436
                        h.broadcastHeight,
7✔
437
                        h.htlcResolution.CsvDelay,
7✔
438
                ))
7✔
439
        }
7✔
440

441
        // Calculate the budget for this sweep.
442
        budget := calculateBudget(
7✔
443
                btcutil.Amount(inp.SignDesc().Output.Value),
7✔
444
                h.Budget.DeadlineHTLCRatio,
7✔
445
                h.Budget.DeadlineHTLC,
7✔
446
        )
7✔
447

7✔
448
        deadline := fn.Some(int32(h.htlc.RefundTimeout))
7✔
449

7✔
450
        log.Infof("%T(%x): offering direct-preimage HTLC output to sweeper "+
7✔
451
                "with deadline=%v, budget=%v", h, h.htlc.RHash[:],
7✔
452
                h.htlc.RefundTimeout, budget)
7✔
453

7✔
454
        // We'll now offer the direct preimage HTLC to the sweeper.
7✔
455
        _, err := h.Sweeper.SweepInput(
7✔
456
                inp,
7✔
457
                sweep.Params{
7✔
458
                        Budget:         budget,
7✔
459
                        DeadlineHeight: deadline,
7✔
460
                },
7✔
461
        )
7✔
462

7✔
463
        return err
7✔
464
}
465

466
// sweepSuccessTx attempts to sweep the second level success tx.
467
func (h *htlcSuccessResolver) sweepSuccessTx() error {
4✔
468
        var secondLevelInput input.HtlcSecondLevelAnchorInput
4✔
469
        if h.isTaproot() {
7✔
470
                secondLevelInput = input.MakeHtlcSecondLevelSuccessTaprootInput(
3✔
471
                        h.htlcResolution.SignedSuccessTx,
3✔
472
                        h.htlcResolution.SignDetails, h.htlcResolution.Preimage,
3✔
473
                        h.broadcastHeight, input.WithResolutionBlob(
3✔
474
                                h.htlcResolution.ResolutionBlob,
3✔
475
                        ),
3✔
476
                )
3✔
477
        } else {
7✔
478
                secondLevelInput = input.MakeHtlcSecondLevelSuccessAnchorInput(
4✔
479
                        h.htlcResolution.SignedSuccessTx,
4✔
480
                        h.htlcResolution.SignDetails, h.htlcResolution.Preimage,
4✔
481
                        h.broadcastHeight,
4✔
482
                )
4✔
483
        }
4✔
484

485
        // Calculate the budget for this sweep.
486
        value := btcutil.Amount(secondLevelInput.SignDesc().Output.Value)
4✔
487
        budget := calculateBudget(
4✔
488
                value, h.Budget.DeadlineHTLCRatio, h.Budget.DeadlineHTLC,
4✔
489
        )
4✔
490

4✔
491
        // The deadline would be the CLTV in this HTLC output. If we are the
4✔
492
        // initiator of this force close, with the default
4✔
493
        // `IncomingBroadcastDelta`, it means we have 10 blocks left when going
4✔
494
        // onchain.
4✔
495
        deadline := fn.Some(int32(h.htlc.RefundTimeout))
4✔
496

4✔
497
        h.log.Infof("offering second-level HTLC success tx to sweeper with "+
4✔
498
                "deadline=%v, budget=%v", h.htlc.RefundTimeout, budget)
4✔
499

4✔
500
        // We'll now offer the second-level transaction to the sweeper.
4✔
501
        _, err := h.Sweeper.SweepInput(
4✔
502
                &secondLevelInput,
4✔
503
                sweep.Params{
4✔
504
                        Budget:         budget,
4✔
505
                        DeadlineHeight: deadline,
4✔
506
                },
4✔
507
        )
4✔
508

4✔
509
        return err
4✔
510
}
511

512
// sweepSuccessTxOutput attempts to sweep the output of the second level
513
// success tx.
514
func (h *htlcSuccessResolver) sweepSuccessTxOutput() error {
5✔
515
        h.log.Debugf("sweeping output %v from 2nd-level HTLC success tx",
5✔
516
                h.htlcResolution.ClaimOutpoint)
5✔
517

5✔
518
        // This should be non-blocking as we will only attempt to sweep the
5✔
519
        // output when the second level tx has already been confirmed. In other
5✔
520
        // words, waitForSpend will return immediately.
5✔
521
        commitSpend, err := waitForSpend(
5✔
522
                &h.htlcResolution.SignedSuccessTx.TxIn[0].PreviousOutPoint,
5✔
523
                h.htlcResolution.SignDetails.SignDesc.Output.PkScript,
5✔
524
                h.broadcastHeight, h.Notifier, h.quit,
5✔
525
        )
5✔
526
        if err != nil {
5✔
527
                return err
×
528
        }
×
529

530
        // The HTLC success tx has a CSV lock that we must wait for, and if
531
        // this is a lease enforced channel and we're the imitator, we may need
532
        // to wait for longer.
533
        waitHeight := h.deriveWaitHeight(h.htlcResolution.CsvDelay, commitSpend)
5✔
534

5✔
535
        // Now that the sweeper has broadcasted the second-level transaction,
5✔
536
        // it has confirmed, and we have checkpointed our state, we'll sweep
5✔
537
        // the second level output. We report the resolver has moved the next
5✔
538
        // stage.
5✔
539
        h.reportLock.Lock()
5✔
540
        h.currentReport.Stage = 2
5✔
541
        h.currentReport.MaturityHeight = waitHeight
5✔
542
        h.reportLock.Unlock()
5✔
543

5✔
544
        if h.hasCLTV() {
8✔
545
                log.Infof("%T(%x): waiting for CSV and CLTV lock to expire at "+
3✔
546
                        "height %v", h, h.htlc.RHash[:], waitHeight)
3✔
547
        } else {
8✔
548
                log.Infof("%T(%x): waiting for CSV lock to expire at height %v",
5✔
549
                        h, h.htlc.RHash[:], waitHeight)
5✔
550
        }
5✔
551

552
        // We'll use this input index to determine the second-level output
553
        // index on the transaction, as the signatures requires the indexes to
554
        // be the same. We don't look for the second-level output script
555
        // directly, as there might be more than one HTLC output to the same
556
        // pkScript.
557
        op := &wire.OutPoint{
5✔
558
                Hash:  *commitSpend.SpenderTxHash,
5✔
559
                Index: commitSpend.SpenderInputIndex,
5✔
560
        }
5✔
561

5✔
562
        // Let the sweeper sweep the second-level output now that the
5✔
563
        // CSV/CLTV locks have expired.
5✔
564
        var witType input.StandardWitnessType
5✔
565
        if h.isTaproot() {
8✔
566
                witType = input.TaprootHtlcAcceptedSuccessSecondLevel
3✔
567
        } else {
8✔
568
                witType = input.HtlcAcceptedSuccessSecondLevel
5✔
569
        }
5✔
570
        inp := h.makeSweepInput(
5✔
571
                op, witType,
5✔
572
                input.LeaseHtlcAcceptedSuccessSecondLevel,
5✔
573
                &h.htlcResolution.SweepSignDesc,
5✔
574
                h.htlcResolution.CsvDelay, uint32(commitSpend.SpendingHeight),
5✔
575
                h.htlc.RHash, h.htlcResolution.ResolutionBlob,
5✔
576
        )
5✔
577

5✔
578
        // Calculate the budget for this sweep.
5✔
579
        budget := calculateBudget(
5✔
580
                btcutil.Amount(inp.SignDesc().Output.Value),
5✔
581
                h.Budget.NoDeadlineHTLCRatio,
5✔
582
                h.Budget.NoDeadlineHTLC,
5✔
583
        )
5✔
584

5✔
585
        log.Infof("%T(%x): offering second-level success tx output to sweeper "+
5✔
586
                "with no deadline and budget=%v at height=%v", h,
5✔
587
                h.htlc.RHash[:], budget, waitHeight)
5✔
588

5✔
589
        // TODO(yy): use the result chan returned from SweepInput.
5✔
590
        _, err = h.Sweeper.SweepInput(
5✔
591
                inp,
5✔
592
                sweep.Params{
5✔
593
                        Budget: budget,
5✔
594

5✔
595
                        // For second level success tx, there's no rush to get
5✔
596
                        // it confirmed, so we use a nil deadline.
5✔
597
                        DeadlineHeight: fn.None[int32](),
5✔
598
                },
5✔
599
        )
5✔
600

5✔
601
        return err
5✔
602
}
603

604
// resolveLegacySuccessTx handles an HTLC output from a pre-anchor type channel
605
// by broadcasting the second-level success transaction.
606
func (h *htlcSuccessResolver) resolveLegacySuccessTx() error {
2✔
607
        // Otherwise we'll publish the second-level transaction directly and
2✔
608
        // offer the resolution to the nursery to handle.
2✔
609
        h.log.Infof("broadcasting legacy second-level success tx: %v",
2✔
610
                h.htlcResolution.SignedSuccessTx.TxHash())
2✔
611

2✔
612
        // We'll now broadcast the second layer transaction so we can kick off
2✔
613
        // the claiming process.
2✔
614
        //
2✔
615
        // TODO(yy): offer it to the sweeper instead.
2✔
616
        label := labels.MakeLabel(
2✔
617
                labels.LabelTypeChannelClose, &h.ShortChanID,
2✔
618
        )
2✔
619
        err := h.PublishTx(h.htlcResolution.SignedSuccessTx, label)
2✔
620
        if err != nil {
2✔
621
                return err
×
622
        }
×
623

624
        // Fast-forward to resolve the output from the success tx if the it has
625
        // already been sent to the UtxoNursery.
626
        if h.outputIncubating {
3✔
627
                return h.resolveSuccessTxOutput(h.htlcResolution.ClaimOutpoint)
1✔
628
        }
1✔
629

630
        h.log.Infof("incubating incoming htlc output")
1✔
631

1✔
632
        // Send the output to the incubator.
1✔
633
        err = h.IncubateOutputs(
1✔
634
                h.ChanPoint, fn.None[lnwallet.OutgoingHtlcResolution](),
1✔
635
                fn.Some(h.htlcResolution),
1✔
636
                h.broadcastHeight, fn.Some(int32(h.htlc.RefundTimeout)),
1✔
637
        )
1✔
638
        if err != nil {
1✔
639
                return err
×
640
        }
×
641

642
        // Mark the output as incubating and checkpoint it.
643
        h.outputIncubating = true
1✔
644
        if err := h.Checkpoint(h); err != nil {
1✔
645
                return err
×
646
        }
×
647

648
        // Move to resolve the output.
649
        return h.resolveSuccessTxOutput(h.htlcResolution.ClaimOutpoint)
1✔
650
}
651

652
// resolveSuccessTx waits for the sweeping tx of the second-level success tx to
653
// confirm and offers the output from the success tx to the sweeper.
654
func (h *htlcSuccessResolver) resolveSuccessTx() error {
5✔
655
        h.log.Infof("waiting for 2nd-level HTLC success transaction to confirm")
5✔
656

5✔
657
        // Create aliases to make the code more readable.
5✔
658
        outpoint := h.htlcResolution.SignedSuccessTx.TxIn[0].PreviousOutPoint
5✔
659
        pkScript := h.htlcResolution.SignDetails.SignDesc.Output.PkScript
5✔
660

5✔
661
        // Wait for the second level transaction to confirm.
5✔
662
        commitSpend, err := waitForSpend(
5✔
663
                &outpoint, pkScript, h.broadcastHeight, h.Notifier, h.quit,
5✔
664
        )
5✔
665
        if err != nil {
5✔
666
                return err
×
667
        }
×
668

669
        // We'll use this input index to determine the second-level output
670
        // index on the transaction, as the signatures requires the indexes to
671
        // be the same. We don't look for the second-level output script
672
        // directly, as there might be more than one HTLC output to the same
673
        // pkScript.
674
        op := wire.OutPoint{
5✔
675
                Hash:  *commitSpend.SpenderTxHash,
5✔
676
                Index: commitSpend.SpenderInputIndex,
5✔
677
        }
5✔
678

5✔
679
        // If the 2nd-stage sweeping has already been started, we can
5✔
680
        // fast-forward to start the resolving process for the stage two
5✔
681
        // output.
5✔
682
        if h.outputIncubating {
6✔
683
                return h.resolveSuccessTxOutput(op)
1✔
684
        }
1✔
685

686
        // Now that the second-level transaction has confirmed, we checkpoint
687
        // the state so we'll go to the next stage in case of restarts.
688
        h.outputIncubating = true
4✔
689
        if err := h.Checkpoint(h); err != nil {
4✔
690
                log.Errorf("unable to Checkpoint: %v", err)
×
691
                return err
×
692
        }
×
693

694
        h.log.Infof("2nd-level HTLC success tx=%v confirmed",
4✔
695
                commitSpend.SpenderTxHash)
4✔
696

4✔
697
        // Send the sweep request for the output from the success tx.
4✔
698
        if err := h.sweepSuccessTxOutput(); err != nil {
4✔
699
                return err
×
700
        }
×
701

702
        return h.resolveSuccessTxOutput(op)
4✔
703
}
704

705
// resolveSuccessTxOutput waits for the spend of the output from the 2nd-level
706
// success tx.
707
func (h *htlcSuccessResolver) resolveSuccessTxOutput(op wire.OutPoint) error {
7✔
708
        // To wrap this up, we'll wait until the second-level transaction has
7✔
709
        // been spent, then fully resolve the contract.
7✔
710
        log.Infof("%T(%x): waiting for second-level HTLC output to be spent "+
7✔
711
                "after csv_delay=%v", h, h.htlc.RHash[:],
7✔
712
                h.htlcResolution.CsvDelay)
7✔
713

7✔
714
        spend, err := waitForSpend(
7✔
715
                &op, h.htlcResolution.SweepSignDesc.Output.PkScript,
7✔
716
                h.broadcastHeight, h.Notifier, h.quit,
7✔
717
        )
7✔
718
        if err != nil {
10✔
719
                return err
3✔
720
        }
3✔
721

722
        h.reportLock.Lock()
7✔
723
        h.currentReport.RecoveredBalance = h.currentReport.LimboBalance
7✔
724
        h.currentReport.LimboBalance = 0
7✔
725
        h.reportLock.Unlock()
7✔
726

7✔
727
        return h.checkpointClaim(spend.SpenderTxHash)
7✔
728
}
729

730
// Launch creates an input based on the details of the incoming htlc resolution
731
// and offers it to the sweeper.
732
func (h *htlcSuccessResolver) Launch() error {
14✔
733
        if h.isLaunched() {
17✔
734
                h.log.Tracef("already launched")
3✔
735
                return nil
3✔
736
        }
3✔
737

738
        h.log.Debugf("launching resolver...")
14✔
739
        h.markLaunched()
14✔
740

14✔
741
        switch {
14✔
742
        // If we're already resolved, then we can exit early.
743
        case h.IsResolved():
3✔
744
                h.log.Errorf("already resolved")
3✔
745
                return nil
3✔
746

747
        // If this is an output on the remote party's commitment transaction,
748
        // use the direct-spend path.
749
        case h.isRemoteCommitOutput():
7✔
750
                return h.sweepRemoteCommitOutput()
7✔
751

752
        // If this is an anchor type channel, we now sweep either the
753
        // second-level success tx or the output from the second-level success
754
        // tx.
755
        case h.isZeroFeeOutput():
5✔
756
                // If the second-level success tx has already been swept, we
5✔
757
                // can go ahead and sweep its output.
5✔
758
                if h.outputIncubating {
6✔
759
                        return h.sweepSuccessTxOutput()
1✔
760
                }
1✔
761

762
                // Otherwise, sweep the second level tx.
763
                return h.sweepSuccessTx()
4✔
764

765
        // If this is a legacy channel type, the output is handled by the
766
        // nursery via the Resolve so we do nothing here.
767
        //
768
        // TODO(yy): handle the legacy output by offering it to the sweeper.
769
        default:
2✔
770
                return nil
2✔
771
        }
772
}
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