package lndclient import ( "context" "encoding/hex" "fmt" "time" "github.com/btcsuite/btcutil" "github.com/lightningnetwork/lnd/channeldb" "github.com/lightningnetwork/lnd/lnrpc" "github.com/lightningnetwork/lnd/lnrpc/routerrpc" "github.com/lightningnetwork/lnd/lntypes" "github.com/lightningnetwork/lnd/lnwire" "github.com/lightningnetwork/lnd/routing/route" "github.com/lightningnetwork/lnd/zpay32" "google.golang.org/grpc" "google.golang.org/grpc/codes" "google.golang.org/grpc/status" ) // RouterClient exposes payment functionality. type RouterClient interface { // SendPayment attempts to route a payment to the final destination. The // call returns a payment update stream and an error stream. SendPayment(ctx context.Context, request SendPaymentRequest) ( chan PaymentStatus, chan error, error) // TrackPayment picks up a previously started payment and returns a // payment update stream and an error stream. TrackPayment(ctx context.Context, hash lntypes.Hash) ( chan PaymentStatus, chan error, error) } // PaymentStatus describe the state of a payment. type PaymentStatus struct { State routerrpc.PaymentState Preimage lntypes.Preimage Fee lnwire.MilliSatoshi Route *route.Route } // SendPaymentRequest defines the payment parameters for a new payment. type SendPaymentRequest struct { // Invoice is an encoded payment request. The individual payment // parameters Target, Amount, PaymentHash, FinalCLTVDelta and RouteHints // are only processed when the Invoice field is empty. Invoice string MaxFee btcutil.Amount MaxCltv *int32 OutgoingChannel *uint64 Timeout time.Duration // Target is the node in which the payment should be routed towards. Target route.Vertex // Amount is the value of the payment to send through the network in // satoshis. Amount btcutil.Amount // PaymentHash is the r-hash value to use within the HTLC extended to // the first hop. PaymentHash [32]byte // FinalCLTVDelta is the CTLV expiry delta to use for the _final_ hop // in the route. This means that the final hop will have a CLTV delta // of at least: currentHeight + FinalCLTVDelta. FinalCLTVDelta uint16 // RouteHints represents the different routing hints that can be used to // assist a payment in reaching its destination successfully. These // hints will act as intermediate hops along the route. // // NOTE: This is optional unless required by the payment. When providing // multiple routes, ensure the hop hints within each route are chained // together and sorted in forward order in order to reach the // destination successfully. RouteHints [][]zpay32.HopHint // LastHopPubkey is the pubkey of the last hop of the route taken // for this payment. If empty, any hop may be used. LastHopPubkey *route.Vertex } // routerClient is a wrapper around the generated routerrpc proxy. type routerClient struct { client routerrpc.RouterClient routerKitMac serializedMacaroon } func newRouterClient(conn *grpc.ClientConn, routerKitMac serializedMacaroon) *routerClient { return &routerClient{ client: routerrpc.NewRouterClient(conn), routerKitMac: routerKitMac, } } // SendPayment attempts to route a payment to the final destination. The call // returns a payment update stream and an error stream. func (r *routerClient) SendPayment(ctx context.Context, request SendPaymentRequest) (chan PaymentStatus, chan error, error) { rpcCtx := r.routerKitMac.WithMacaroonAuth(ctx) rpcReq := &routerrpc.SendPaymentRequest{ FeeLimitSat: int64(request.MaxFee), PaymentRequest: request.Invoice, TimeoutSeconds: int32(request.Timeout.Seconds()), } if request.MaxCltv != nil { rpcReq.CltvLimit = *request.MaxCltv } if request.OutgoingChannel != nil { rpcReq.OutgoingChanId = *request.OutgoingChannel } if request.LastHopPubkey != nil { rpcReq.LastHopPubkey = request.LastHopPubkey[:] } // Only if there is no payment request set, we will parse the individual // payment parameters. if request.Invoice == "" { rpcReq.Dest = request.Target[:] rpcReq.Amt = int64(request.Amount) rpcReq.PaymentHash = request.PaymentHash[:] rpcReq.FinalCltvDelta = int32(request.FinalCLTVDelta) routeHints, err := marshallRouteHints(request.RouteHints) if err != nil { return nil, nil, err } rpcReq.RouteHints = routeHints } stream, err := r.client.SendPayment(rpcCtx, rpcReq) if err != nil { return nil, nil, err } return r.trackPayment(ctx, stream) } // TrackPayment picks up a previously started payment and returns a payment // update stream and an error stream. func (r *routerClient) TrackPayment(ctx context.Context, hash lntypes.Hash) (chan PaymentStatus, chan error, error) { ctx = r.routerKitMac.WithMacaroonAuth(ctx) stream, err := r.client.TrackPayment( ctx, &routerrpc.TrackPaymentRequest{ PaymentHash: hash[:], }, ) if err != nil { return nil, nil, err } return r.trackPayment(ctx, stream) } // trackPayment takes an update stream from either a SendPayment or a // TrackPayment rpc call and converts it into distinct update and error streams. func (r *routerClient) trackPayment(ctx context.Context, stream routerrpc.Router_TrackPaymentClient) (chan PaymentStatus, chan error, error) { statusChan := make(chan PaymentStatus) errorChan := make(chan error, 1) go func() { for { rpcStatus, err := stream.Recv() if err != nil { switch status.Convert(err).Code() { // NotFound is only expected as a response to // TrackPayment. case codes.NotFound: err = channeldb.ErrPaymentNotInitiated // NotFound is only expected as a response to // SendPayment. case codes.AlreadyExists: err = channeldb.ErrAlreadyPaid } errorChan <- err return } status, err := unmarshallPaymentStatus(rpcStatus) if err != nil { errorChan <- err return } select { case statusChan <- *status: case <-ctx.Done(): return } } }() return statusChan, errorChan, nil } // unmarshallPaymentStatus converts an rpc status update to the PaymentStatus // type that is used throughout the application. func unmarshallPaymentStatus(rpcStatus *routerrpc.PaymentStatus) ( *PaymentStatus, error) { status := PaymentStatus{ State: rpcStatus.State, } if status.State == routerrpc.PaymentState_SUCCEEDED { preimage, err := lntypes.MakePreimage( rpcStatus.Preimage, ) if err != nil { return nil, err } status.Preimage = preimage status.Fee = lnwire.MilliSatoshi( rpcStatus.Route.TotalFeesMsat, ) if rpcStatus.Route != nil { route, err := unmarshallRoute(rpcStatus.Route) if err != nil { return nil, err } status.Route = route } } return &status, nil } // unmarshallRoute unmarshalls an rpc route. func unmarshallRoute(rpcroute *lnrpc.Route) ( *route.Route, error) { hops := make([]*route.Hop, len(rpcroute.Hops)) for i, hop := range rpcroute.Hops { routeHop, err := unmarshallHop(hop) if err != nil { return nil, err } hops[i] = routeHop } // TODO(joostjager): Fetch self node from lnd. selfNode := route.Vertex{} route, err := route.NewRouteFromHops( lnwire.MilliSatoshi(rpcroute.TotalAmtMsat), rpcroute.TotalTimeLock, selfNode, hops, ) if err != nil { return nil, err } return route, nil } // unmarshallKnownPubkeyHop unmarshalls an rpc hop. func unmarshallHop(hop *lnrpc.Hop) (*route.Hop, error) { pubKey, err := hex.DecodeString(hop.PubKey) if err != nil { return nil, fmt.Errorf("cannot decode pubkey %s", hop.PubKey) } var pubKeyBytes [33]byte copy(pubKeyBytes[:], pubKey) return &route.Hop{ OutgoingTimeLock: hop.Expiry, AmtToForward: lnwire.MilliSatoshi(hop.AmtToForwardMsat), PubKeyBytes: pubKeyBytes, ChannelID: hop.ChanId, }, nil } // marshallRouteHints marshalls a list of route hints. func marshallRouteHints(routeHints [][]zpay32.HopHint) ( []*lnrpc.RouteHint, error) { rpcRouteHints := make([]*lnrpc.RouteHint, 0, len(routeHints)) for _, routeHint := range routeHints { rpcRouteHint := make( []*lnrpc.HopHint, 0, len(routeHint), ) for _, hint := range routeHint { rpcHint, err := marshallHopHint(hint) if err != nil { return nil, err } rpcRouteHint = append(rpcRouteHint, rpcHint) } rpcRouteHints = append(rpcRouteHints, &lnrpc.RouteHint{ HopHints: rpcRouteHint, }) } return rpcRouteHints, nil } // marshallHopHint marshalls a single hop hint. func marshallHopHint(hint zpay32.HopHint) (*lnrpc.HopHint, error) { nodeID, err := route.NewVertexFromBytes( hint.NodeID.SerializeCompressed(), ) if err != nil { return nil, err } return &lnrpc.HopHint{ ChanId: hint.ChannelID, CltvExpiryDelta: uint32(hint.CLTVExpiryDelta), FeeBaseMsat: hint.FeeBaseMSat, FeeProportionalMillionths: hint.FeeProportionalMillionths, NodeId: nodeID.String(), }, nil }