143 lines
4.2 KiB
Go
143 lines
4.2 KiB
Go
package lnwire
|
|
|
|
import (
|
|
"fmt"
|
|
"io"
|
|
|
|
"github.com/roasbeef/btcd/wire"
|
|
"google.golang.org/grpc/codes"
|
|
)
|
|
|
|
// ErrorCode represents the short error code for each of the defined errors
|
|
// within the Lightning Network protocol spec.
|
|
type ErrorCode uint16
|
|
|
|
// ToGrpcCode is used to generate gRPC specific code which will be propagated
|
|
// to the ln rpc client. This code is used to have more detailed view of what
|
|
// goes wrong and also in order to have the ability pragmatically determine
|
|
// the error and take specific actions on the client side.
|
|
func (e ErrorCode) ToGrpcCode() codes.Code {
|
|
return (codes.Code)(e) + 100
|
|
}
|
|
|
|
const (
|
|
// ErrorMaxPendingChannels is returned by remote peer when the number
|
|
// of active pending channels exceeds their maximum policy limit.
|
|
ErrorMaxPendingChannels ErrorCode = 1
|
|
)
|
|
|
|
// ErrorGeneric represents a generic error bound to an exact channel. The
|
|
// message format is purposefully general in order to allow expression of a wide
|
|
// array of possible errors. Each ErrorGeneric message is directed at a particular
|
|
// open channel referenced by ChannelPoint.
|
|
type ErrorGeneric struct {
|
|
// ChannelPoint references the active channel in which the error
|
|
// occurred within. A ChannelPoint of zeroHash:0 denotes this error
|
|
// applies to the entire established connection.
|
|
ChannelPoint *wire.OutPoint
|
|
|
|
// PendingChannelID allows peers communicate errors in the context of a
|
|
// particular pending channel. With this field, once a peer reads an
|
|
// ErrorGeneric message with the PendingChannelID field set, then they
|
|
// can forward the error to the fundingManager who can handle it
|
|
// properly.
|
|
PendingChannelID uint64
|
|
|
|
// Code is the short error ID which describes the nature of the error.
|
|
Code ErrorCode
|
|
|
|
// Problem is a human-readable string further elaborating upon the
|
|
// nature of the exact error. The maximum allowed length of this
|
|
// message is 8192 bytes.
|
|
Problem string
|
|
}
|
|
|
|
// NewErrorGeneric creates a new ErrorGeneric message.
|
|
func NewErrorGeneric() *ErrorGeneric {
|
|
return &ErrorGeneric{}
|
|
}
|
|
|
|
// A compile time check to ensure ErrorGeneric implements the lnwire.Message
|
|
// interface.
|
|
var _ Message = (*ErrorGeneric)(nil)
|
|
|
|
// Decode deserializes a serialized ErrorGeneric message stored in the
|
|
// passed io.Reader observing the specified protocol version.
|
|
//
|
|
// This is part of the lnwire.Message interface.
|
|
func (c *ErrorGeneric) Decode(r io.Reader, pver uint32) error {
|
|
// ChannelPoint(8)
|
|
// Problem
|
|
err := readElements(r,
|
|
&c.ChannelPoint,
|
|
&c.Code,
|
|
&c.Problem,
|
|
&c.PendingChannelID,
|
|
)
|
|
if err != nil {
|
|
return err
|
|
}
|
|
|
|
return nil
|
|
}
|
|
|
|
// Encode serializes the target ErrorGeneric into the passed io.Writer
|
|
// observing the protocol version specified.
|
|
//
|
|
// This is part of the lnwire.Message interface.
|
|
func (c *ErrorGeneric) Encode(w io.Writer, pver uint32) error {
|
|
err := writeElements(w,
|
|
c.ChannelPoint,
|
|
c.Code,
|
|
c.Problem,
|
|
c.PendingChannelID,
|
|
)
|
|
if err != nil {
|
|
return err
|
|
}
|
|
|
|
return nil
|
|
}
|
|
|
|
// Command returns the integer uniquely identifying an ErrorGeneric message on
|
|
// the wire.
|
|
//
|
|
// This is part of the lnwire.Message interface.
|
|
func (c *ErrorGeneric) Command() uint32 {
|
|
return CmdErrorGeneric
|
|
}
|
|
|
|
// MaxPayloadLength returns the maximum allowed payload size for a
|
|
// ErrorGeneric complete message observing the specified protocol version.
|
|
//
|
|
// This is part of the lnwire.Message interface.
|
|
func (c *ErrorGeneric) MaxPayloadLength(uint32) uint32 {
|
|
// 8+8192
|
|
return 8208
|
|
}
|
|
|
|
// Validate performs any necessary sanity checks to ensure all fields present
|
|
// on the ErrorGeneric are valid.
|
|
//
|
|
// This is part of the lnwire.Message interface.
|
|
func (c *ErrorGeneric) Validate() error {
|
|
if len(c.Problem) > 8192 {
|
|
return fmt.Errorf("problem string length too long")
|
|
}
|
|
|
|
// We're good!
|
|
return nil
|
|
}
|
|
|
|
// String returns the string representation of the target ErrorGeneric.
|
|
//
|
|
// This is part of the lnwire.Message interface.
|
|
func (c *ErrorGeneric) String() string {
|
|
return fmt.Sprintf("\n--- Begin ErrorGeneric ---\n") +
|
|
fmt.Sprintf("ChannelPoint:\t%d\n", c.ChannelPoint) +
|
|
fmt.Sprintf("Code:\t%d\n", c.Code) +
|
|
fmt.Sprintf("Problem:\t%s\n", c.Problem) +
|
|
fmt.Sprintf("PendingChannelID:\t%s\n", c.PendingChannelID) +
|
|
fmt.Sprintf("--- End ErrorGeneric ---\n")
|
|
}
|