package routing import ( "github.com/lightningnetwork/lnd/channeldb" "github.com/lightningnetwork/lnd/kvdb" "github.com/lightningnetwork/lnd/lnwire" "github.com/lightningnetwork/lnd/routing/route" ) // routingGraph is an abstract interface that provides information about nodes // and edges to pathfinding. type routingGraph interface { // forEachNodeChannel calls the callback for every channel of the given // node. forEachNodeChannel(nodePub route.Vertex, cb func(channel *channeldb.DirectedChannel) error) error // sourceNode returns the source node of the graph. sourceNode() route.Vertex // fetchNodeFeatures returns the features of the given node. fetchNodeFeatures(nodePub route.Vertex) (*lnwire.FeatureVector, error) } // CachedGraph is a routingGraph implementation that retrieves from the // database. type CachedGraph struct { graph *channeldb.ChannelGraph tx kvdb.RTx source route.Vertex } // A compile time assertion to make sure CachedGraph implements the routingGraph // interface. var _ routingGraph = (*CachedGraph)(nil) // NewCachedGraph instantiates a new db-connected routing graph. It implicitly // instantiates a new read transaction. func NewCachedGraph(sourceNode *channeldb.LightningNode, graph *channeldb.ChannelGraph) (*CachedGraph, error) { tx, err := graph.NewPathFindTx() if err != nil { return nil, err } return &CachedGraph{ graph: graph, tx: tx, source: sourceNode.PubKeyBytes, }, nil } // close attempts to close the underlying db transaction. This is a no-op in // case the underlying graph uses an in-memory cache. func (g *CachedGraph) close() error { if g.tx == nil { return nil } return g.tx.Rollback() } // forEachNodeChannel calls the callback for every channel of the given node. // // NOTE: Part of the routingGraph interface. func (g *CachedGraph) forEachNodeChannel(nodePub route.Vertex, cb func(channel *channeldb.DirectedChannel) error) error { return g.graph.ForEachNodeChannel(g.tx, nodePub, cb) } // sourceNode returns the source node of the graph. // // NOTE: Part of the routingGraph interface. func (g *CachedGraph) sourceNode() route.Vertex { return g.source } // fetchNodeFeatures returns the features of the given node. If the node is // unknown, assume no additional features are supported. // // NOTE: Part of the routingGraph interface. func (g *CachedGraph) fetchNodeFeatures(nodePub route.Vertex) ( *lnwire.FeatureVector, error) { return g.graph.FetchNodeFeatures(nodePub) }