4002caec69
In this commit, we add the glue infrastructure to make the sub RPC server system work properly. Our high level goal is the following: using only the lnrpc package (with no visibility into the sub RPC servers), the RPC server is able to find, create, run, and manage the entire set of present and future sub RPC servers. In order to achieve this, we use the reflect package and build tags heavily to permit a loosely coupled configuration parsing system for the sub RPC servers. We start with a new `subRpcServerConfigs` struct which is _always_ present. This struct has its own group, and will house a series of sub-configs, one for each sub RPC server. Each sub-config is actually gated behind a build flag, and can be used to allow users on the command line or in the config to specify arguments related to the sub-server. If the config isn't present, then we don't attempt to parse it at all, if it is, then that means the RPC server has been registered, and we should parse the contents of its config. The `subRpcServerConfigs` struct has two main methods: `PopulateDependancies` and `FetchConfig`. The `PopulateDependancies` is used to dynamically locate and set the config fields for each new sub-server. As the config may not actually have any fields (if the build flag is off), we use the reflect pacakge to determine if things are compiled in or not, then if so, we dynamically set each of the config parameters. The `PopulateDependancies` method implements the `lnrpc.SubServerConfigDispatcher` interface. Our goal is to allow sub servers to look up their actual config in this main config struct. We achieve this by using reflect to look up the target field _as if it were a key in a map_. If the field is found, then we check if it has any actual attributes (it won't if the build flag is off), if it is, then we return it as we expect it to be populated already. |
||
|---|---|---|
| .. | ||
| signrpc | ||
| gen_protos.sh | ||
| README.md | ||
| rpc.pb.go | ||
| rpc.pb.gw.go | ||
| rpc.proto | ||
| rpc.swagger.json | ||
| sub_server.go | ||
lnrpc
This lnrpc package implements both a client and server for lnds RPC system
which is based off of the high-performance cross-platform
gRPC RPC framework. By default, only the Go
client+server libraries are compiled within the package. In order to compile
the client side libraries for other supported languages, the protoc tool will
need to be used to generate the compiled protos for a specific language.
The following languages are supported as clients to lnrpc: C++, Go, Node.js,
Java, Ruby, Android Java, PHP, Python, C#, Objective-C.
Service: Lightning
The list of defined RPCs on the service Lightning are the following (with a brief
description):
- WalletBalance
- Returns the wallet's current confirmed balance in BTC.
- ChannelBalance
- Returns the daemons' available aggregate channel balance in BTC.
- GetTransactions
- Returns a list of on-chain transactions that pay to or are spends from
lnd.
- Returns a list of on-chain transactions that pay to or are spends from
- SendCoins
- Sends an amount of satoshis to a specific address.
- SubscribeTransactions
- Returns a stream which sends async notifications each time a transaction is created or one is received that pays to us.
- SendMany
- Allows the caller to create a transaction with an arbitrary fan-out (many outputs).
- NewAddress
- Returns a new address, the following address types are supported: pay-to-witness-key-hash (p2wkh) and nested-pay-to-witness-key-hash (np2wkh).
- SignMessage
- Signs a message with the node's identity key and returns a zbase32 encoded signature.
- VerifyMessage
- Verifies a signature signed by another node on a message. The other node must be an active node in the channel database.
- ConnectPeer
- Connects to a peer identified by a public key and host.
- DisconnectPeer
- Disconnects a peer identified by a public key.
- ListPeers
- Lists all available connected peers.
- GetInfo
- Returns basic data concerning the daemon.
- PendingChannels
- List the number of pending (not fully confirmed) channels.
- ListChannels
- List all active channels the daemon manages.
- OpenChannelSync
- OpenChannelSync is a synchronous version of the OpenChannel RPC call.
- OpenChannel
- Attempts to open a channel to a target peer with a specific amount and push amount.
- CloseChannel
- Attempts to close a target channel. A channel can either be closed cooperatively if the channel peer is online, or using a "force" close to broadcast the latest channel state.
- SendPayment
- Send a payment over Lightning to a target peer.
- SendPaymentSync
- SendPaymentSync is the synchronous non-streaming version of SendPayment.
- SendToRoute
- Send a payment over Lightning to a target peer through a route explicitly defined by the user.
- SendToRouteSync
- SendToRouteSync is the synchronous non-streaming version of SendToRoute.
- AddInvoice
- Adds an invoice to the daemon. Invoices are automatically settled once seen as an incoming HTLC.
- ListInvoices
- Lists all stored invoices.
- LookupInvoice
- Attempts to look up an invoice by payment hash (r-hash).
- SubscribeInvoices
- Creates a uni-directional stream which receives async notifications as the daemon settles invoices
- DecodePayReq
- Decode a payment request, returning a full description of the conditions encoded within the payment request.
- ListPayments
- List all outgoing Lightning payments the daemon has made.
- DeleteAllPayments
- Deletes all outgoing payments from DB.
- DescribeGraph
- Returns a description of the known channel graph from the PoV of the node.
- GetChanInfo
- Returns information for a specific channel identified by channel ID.
- GetNodeInfo
- Returns information for a particular node identified by its identity public key.
- QueryRoutes
- Queries for a possible route to a target peer which can carry a certain amount of payment.
- GetNetworkInfo
- Returns some network level statistics.
- StopDaemon
- Sends a shutdown request to the interrupt handler, triggering a graceful shutdown of the daemon.
- SubscribeChannelGraph
- Creates a stream which receives async notifications upon any changes to the channel graph topology from the point of view of the responding node.
- DebugLevel
- Set logging verbosity of lnd programmatically
- FeeReport
- Allows the caller to obtain a report detailing the current fee schedule enforced by the node globally for each channel.
- UpdateChannelPolicy
- Allows the caller to update the fee schedule and channel policies for all channels globally, or a particular channel
Service: WalletUnlocker
The list of defined RPCs on the service WalletUnlocker are the following (with a brief
description):
- CreateWallet
- Set encryption password for the wallet database.
- UnlockWallet
- Provide a password to unlock the wallet database.
Installation and Updating
$ go get -u github.com/lightningnetwork/lnd/lnrpc
Generate protobuf definitions
- Download v.3.4.0 of
protocfor your operating system and add it to yourPATH. For example, if using macOS:
$ curl -LO https://github.com/google/protobuf/releases/download/v3.4.0/protoc-3.4.0-osx-x86_64.zip
$ unzip protoc-3.4.0-osx-x86_64.zip -d protoc
$ export PATH=$PWD/protoc/bin:$PATH
- Install
golang/protobufat commitab9f9a6dab164b7d1246e0e688b0ab7b94d8553e.
$ git clone https://github.com/golang/protobuf $GOPATH/src/github.com/golang/protobuf
$ cd $GOPATH/src/github.com/golang/protobuf
$ git reset --hard ab9f9a6dab164b7d1246e0e688b0ab7b94d8553e
$ make
- Install
grpc-ecosystem/grpc-gatewayat commitf2862b476edcef83412c7af8687c9cd8e4097c0f.
$ git clone https://github.com/grpc-ecosystem/grpc-gateway $GOPATH/src/github.com/grpc-ecosystem/grpc-gateway
$ cd $GOPATH/src/github.com/grpc-ecosystem/grpc-gateway
$ git reset --hard f2862b476edcef83412c7af8687c9cd8e4097c0f
$ go install ./protoc-gen-grpc-gateway ./protoc-gen-swagger
- Run
gen_protos.shto generate new protobuf definitions.