mirror of https://github.com/lightninglabs/loop
Merge pull request #14 from wpaulino/looprpc-rest
looprpc+cmd/loopd: add client REST definitions and REST proxypull/15/head
Olaoluwa Osuntokun
5 years ago
committed by
GitHub
commit
7b769d57bb
@ -0,0 +1,214 @@
|
||||
// Code generated by protoc-gen-grpc-gateway. DO NOT EDIT.
|
||||
// source: client.proto
|
||||
|
||||
/*
|
||||
Package looprpc is a reverse proxy.
|
||||
|
||||
It translates gRPC into RESTful JSON APIs.
|
||||
*/
|
||||
package looprpc
|
||||
|
||||
import (
|
||||
"io"
|
||||
"net/http"
|
||||
|
||||
"github.com/golang/protobuf/proto"
|
||||
"github.com/grpc-ecosystem/grpc-gateway/runtime"
|
||||
"github.com/grpc-ecosystem/grpc-gateway/utilities"
|
||||
"golang.org/x/net/context"
|
||||
"google.golang.org/grpc"
|
||||
"google.golang.org/grpc/codes"
|
||||
"google.golang.org/grpc/grpclog"
|
||||
"google.golang.org/grpc/status"
|
||||
)
|
||||
|
||||
var _ codes.Code
|
||||
var _ io.Reader
|
||||
var _ status.Status
|
||||
var _ = runtime.String
|
||||
var _ = utilities.NewDoubleArray
|
||||
|
||||
func request_SwapClient_LoopOut_0(ctx context.Context, marshaler runtime.Marshaler, client SwapClientClient, req *http.Request, pathParams map[string]string) (proto.Message, runtime.ServerMetadata, error) {
|
||||
var protoReq LoopOutRequest
|
||||
var metadata runtime.ServerMetadata
|
||||
|
||||
if err := marshaler.NewDecoder(req.Body).Decode(&protoReq); err != nil {
|
||||
return nil, metadata, status.Errorf(codes.InvalidArgument, "%v", err)
|
||||
}
|
||||
|
||||
msg, err := client.LoopOut(ctx, &protoReq, grpc.Header(&metadata.HeaderMD), grpc.Trailer(&metadata.TrailerMD))
|
||||
return msg, metadata, err
|
||||
|
||||
}
|
||||
|
||||
func request_SwapClient_LoopOutTerms_0(ctx context.Context, marshaler runtime.Marshaler, client SwapClientClient, req *http.Request, pathParams map[string]string) (proto.Message, runtime.ServerMetadata, error) {
|
||||
var protoReq TermsRequest
|
||||
var metadata runtime.ServerMetadata
|
||||
|
||||
msg, err := client.LoopOutTerms(ctx, &protoReq, grpc.Header(&metadata.HeaderMD), grpc.Trailer(&metadata.TrailerMD))
|
||||
return msg, metadata, err
|
||||
|
||||
}
|
||||
|
||||
func request_SwapClient_LoopOutQuote_0(ctx context.Context, marshaler runtime.Marshaler, client SwapClientClient, req *http.Request, pathParams map[string]string) (proto.Message, runtime.ServerMetadata, error) {
|
||||
var protoReq QuoteRequest
|
||||
var metadata runtime.ServerMetadata
|
||||
|
||||
var (
|
||||
val string
|
||||
ok bool
|
||||
err error
|
||||
_ = err
|
||||
)
|
||||
|
||||
val, ok = pathParams["amt"]
|
||||
if !ok {
|
||||
return nil, metadata, status.Errorf(codes.InvalidArgument, "missing parameter %s", "amt")
|
||||
}
|
||||
|
||||
protoReq.Amt, err = runtime.Int64(val)
|
||||
|
||||
if err != nil {
|
||||
return nil, metadata, status.Errorf(codes.InvalidArgument, "type mismatch, parameter: %s, error: %v", "amt", err)
|
||||
}
|
||||
|
||||
msg, err := client.LoopOutQuote(ctx, &protoReq, grpc.Header(&metadata.HeaderMD), grpc.Trailer(&metadata.TrailerMD))
|
||||
return msg, metadata, err
|
||||
|
||||
}
|
||||
|
||||
// RegisterSwapClientHandlerFromEndpoint is same as RegisterSwapClientHandler but
|
||||
// automatically dials to "endpoint" and closes the connection when "ctx" gets done.
|
||||
func RegisterSwapClientHandlerFromEndpoint(ctx context.Context, mux *runtime.ServeMux, endpoint string, opts []grpc.DialOption) (err error) {
|
||||
conn, err := grpc.Dial(endpoint, opts...)
|
||||
if err != nil {
|
||||
return err
|
||||
}
|
||||
defer func() {
|
||||
if err != nil {
|
||||
if cerr := conn.Close(); cerr != nil {
|
||||
grpclog.Printf("Failed to close conn to %s: %v", endpoint, cerr)
|
||||
}
|
||||
return
|
||||
}
|
||||
go func() {
|
||||
<-ctx.Done()
|
||||
if cerr := conn.Close(); cerr != nil {
|
||||
grpclog.Printf("Failed to close conn to %s: %v", endpoint, cerr)
|
||||
}
|
||||
}()
|
||||
}()
|
||||
|
||||
return RegisterSwapClientHandler(ctx, mux, conn)
|
||||
}
|
||||
|
||||
// RegisterSwapClientHandler registers the http handlers for service SwapClient to "mux".
|
||||
// The handlers forward requests to the grpc endpoint over "conn".
|
||||
func RegisterSwapClientHandler(ctx context.Context, mux *runtime.ServeMux, conn *grpc.ClientConn) error {
|
||||
client := NewSwapClientClient(conn)
|
||||
|
||||
mux.Handle("POST", pattern_SwapClient_LoopOut_0, func(w http.ResponseWriter, req *http.Request, pathParams map[string]string) {
|
||||
ctx, cancel := context.WithCancel(ctx)
|
||||
defer cancel()
|
||||
if cn, ok := w.(http.CloseNotifier); ok {
|
||||
go func(done <-chan struct{}, closed <-chan bool) {
|
||||
select {
|
||||
case <-done:
|
||||
case <-closed:
|
||||
cancel()
|
||||
}
|
||||
}(ctx.Done(), cn.CloseNotify())
|
||||
}
|
||||
inboundMarshaler, outboundMarshaler := runtime.MarshalerForRequest(mux, req)
|
||||
rctx, err := runtime.AnnotateContext(ctx, mux, req)
|
||||
if err != nil {
|
||||
runtime.HTTPError(ctx, mux, outboundMarshaler, w, req, err)
|
||||
return
|
||||
}
|
||||
resp, md, err := request_SwapClient_LoopOut_0(rctx, inboundMarshaler, client, req, pathParams)
|
||||
ctx = runtime.NewServerMetadataContext(ctx, md)
|
||||
if err != nil {
|
||||
runtime.HTTPError(ctx, mux, outboundMarshaler, w, req, err)
|
||||
return
|
||||
}
|
||||
|
||||
forward_SwapClient_LoopOut_0(ctx, mux, outboundMarshaler, w, req, resp, mux.GetForwardResponseOptions()...)
|
||||
|
||||
})
|
||||
|
||||
mux.Handle("GET", pattern_SwapClient_LoopOutTerms_0, func(w http.ResponseWriter, req *http.Request, pathParams map[string]string) {
|
||||
ctx, cancel := context.WithCancel(ctx)
|
||||
defer cancel()
|
||||
if cn, ok := w.(http.CloseNotifier); ok {
|
||||
go func(done <-chan struct{}, closed <-chan bool) {
|
||||
select {
|
||||
case <-done:
|
||||
case <-closed:
|
||||
cancel()
|
||||
}
|
||||
}(ctx.Done(), cn.CloseNotify())
|
||||
}
|
||||
inboundMarshaler, outboundMarshaler := runtime.MarshalerForRequest(mux, req)
|
||||
rctx, err := runtime.AnnotateContext(ctx, mux, req)
|
||||
if err != nil {
|
||||
runtime.HTTPError(ctx, mux, outboundMarshaler, w, req, err)
|
||||
return
|
||||
}
|
||||
resp, md, err := request_SwapClient_LoopOutTerms_0(rctx, inboundMarshaler, client, req, pathParams)
|
||||
ctx = runtime.NewServerMetadataContext(ctx, md)
|
||||
if err != nil {
|
||||
runtime.HTTPError(ctx, mux, outboundMarshaler, w, req, err)
|
||||
return
|
||||
}
|
||||
|
||||
forward_SwapClient_LoopOutTerms_0(ctx, mux, outboundMarshaler, w, req, resp, mux.GetForwardResponseOptions()...)
|
||||
|
||||
})
|
||||
|
||||
mux.Handle("GET", pattern_SwapClient_LoopOutQuote_0, func(w http.ResponseWriter, req *http.Request, pathParams map[string]string) {
|
||||
ctx, cancel := context.WithCancel(ctx)
|
||||
defer cancel()
|
||||
if cn, ok := w.(http.CloseNotifier); ok {
|
||||
go func(done <-chan struct{}, closed <-chan bool) {
|
||||
select {
|
||||
case <-done:
|
||||
case <-closed:
|
||||
cancel()
|
||||
}
|
||||
}(ctx.Done(), cn.CloseNotify())
|
||||
}
|
||||
inboundMarshaler, outboundMarshaler := runtime.MarshalerForRequest(mux, req)
|
||||
rctx, err := runtime.AnnotateContext(ctx, mux, req)
|
||||
if err != nil {
|
||||
runtime.HTTPError(ctx, mux, outboundMarshaler, w, req, err)
|
||||
return
|
||||
}
|
||||
resp, md, err := request_SwapClient_LoopOutQuote_0(rctx, inboundMarshaler, client, req, pathParams)
|
||||
ctx = runtime.NewServerMetadataContext(ctx, md)
|
||||
if err != nil {
|
||||
runtime.HTTPError(ctx, mux, outboundMarshaler, w, req, err)
|
||||
return
|
||||
}
|
||||
|
||||
forward_SwapClient_LoopOutQuote_0(ctx, mux, outboundMarshaler, w, req, resp, mux.GetForwardResponseOptions()...)
|
||||
|
||||
})
|
||||
|
||||
return nil
|
||||
}
|
||||
|
||||
var (
|
||||
pattern_SwapClient_LoopOut_0 = runtime.MustPattern(runtime.NewPattern(1, []int{2, 0, 2, 1, 2, 2}, []string{"v1", "loop", "out"}, ""))
|
||||
|
||||
pattern_SwapClient_LoopOutTerms_0 = runtime.MustPattern(runtime.NewPattern(1, []int{2, 0, 2, 1, 2, 2, 2, 3}, []string{"v1", "loop", "out", "terms"}, ""))
|
||||
|
||||
pattern_SwapClient_LoopOutQuote_0 = runtime.MustPattern(runtime.NewPattern(1, []int{2, 0, 2, 1, 2, 2, 2, 3, 1, 0, 4, 1, 5, 4}, []string{"v1", "loop", "out", "quote", "amt"}, ""))
|
||||
)
|
||||
|
||||
var (
|
||||
forward_SwapClient_LoopOut_0 = runtime.ForwardResponseMessage
|
||||
|
||||
forward_SwapClient_LoopOutTerms_0 = runtime.ForwardResponseMessage
|
||||
|
||||
forward_SwapClient_LoopOutQuote_0 = runtime.ForwardResponseMessage
|
||||
)
|
||||
@ -0,0 +1,263 @@
|
||||
{
|
||||
"swagger": "2.0",
|
||||
"info": {
|
||||
"title": "client.proto",
|
||||
"version": "version not set"
|
||||
},
|
||||
"schemes": [
|
||||
"http",
|
||||
"https"
|
||||
],
|
||||
"consumes": [
|
||||
"application/json"
|
||||
],
|
||||
"produces": [
|
||||
"application/json"
|
||||
],
|
||||
"paths": {
|
||||
"/v1/loop/out": {
|
||||
"post": {
|
||||
"summary": "* loop: `out`\nLoopOut initiates an loop out swap with the given parameters. The call\nreturns after the swap has been set up with the swap server. From that\npoint onwards, progress can be tracked via the SwapStatus stream that is\nreturned from Monitor().",
|
||||
"operationId": "LoopOut",
|
||||
"responses": {
|
||||
"200": {
|
||||
"description": "",
|
||||
"schema": {
|
||||
"$ref": "#/definitions/looprpcSwapResponse"
|
||||
}
|
||||
}
|
||||
},
|
||||
"parameters": [
|
||||
{
|
||||
"name": "body",
|
||||
"in": "body",
|
||||
"required": true,
|
||||
"schema": {
|
||||
"$ref": "#/definitions/looprpcLoopOutRequest"
|
||||
}
|
||||
}
|
||||
],
|
||||
"tags": [
|
||||
"SwapClient"
|
||||
]
|
||||
}
|
||||
},
|
||||
"/v1/loop/out/quote/{amt}": {
|
||||
"get": {
|
||||
"summary": "* loop: `quote`\nLoopOutQuote returns a quote for a loop out swap with the provided\nparameters.",
|
||||
"operationId": "LoopOutQuote",
|
||||
"responses": {
|
||||
"200": {
|
||||
"description": "",
|
||||
"schema": {
|
||||
"$ref": "#/definitions/looprpcQuoteResponse"
|
||||
}
|
||||
}
|
||||
},
|
||||
"parameters": [
|
||||
{
|
||||
"name": "amt",
|
||||
"in": "path",
|
||||
"required": true,
|
||||
"type": "string",
|
||||
"format": "int64"
|
||||
}
|
||||
],
|
||||
"tags": [
|
||||
"SwapClient"
|
||||
]
|
||||
}
|
||||
},
|
||||
"/v1/loop/out/terms": {
|
||||
"get": {
|
||||
"summary": "* loop: `terms`\nLoopOutTerms returns the terms that the server enforces for a loop out swap.",
|
||||
"operationId": "LoopOutTerms",
|
||||
"responses": {
|
||||
"200": {
|
||||
"description": "",
|
||||
"schema": {
|
||||
"$ref": "#/definitions/looprpcTermsResponse"
|
||||
}
|
||||
}
|
||||
},
|
||||
"tags": [
|
||||
"SwapClient"
|
||||
]
|
||||
}
|
||||
}
|
||||
},
|
||||
"definitions": {
|
||||
"looprpcLoopOutRequest": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"amt": {
|
||||
"type": "string",
|
||||
"format": "int64",
|
||||
"description": "*\nRequested swap amount in sat. This does not include the swap and miner fee."
|
||||
},
|
||||
"dest": {
|
||||
"type": "string",
|
||||
"description": "*\nBase58 encoded destination address for the swap."
|
||||
},
|
||||
"max_swap_routing_fee": {
|
||||
"type": "string",
|
||||
"format": "int64",
|
||||
"description": "*\nMaximum off-chain fee in msat that may be paid for payment to the server.\nThis limit is applied during path finding. Typically this value is taken\nfrom the response of the GetQuote call."
|
||||
},
|
||||
"max_prepay_routing_fee": {
|
||||
"type": "string",
|
||||
"format": "int64",
|
||||
"description": "*\nMaximum off-chain fee in msat that may be paid for payment to the server.\nThis limit is applied during path finding. Typically this value is taken\nfrom the response of the GetQuote call."
|
||||
},
|
||||
"max_swap_fee": {
|
||||
"type": "string",
|
||||
"format": "int64",
|
||||
"description": "*\nMaximum we are willing to pay the server for the swap. This value is not\ndisclosed in the swap initiation call, but if the server asks for a\nhigher fee, we abort the swap. Typically this value is taken from the\nresponse of the GetQuote call. It includes the prepay amount."
|
||||
},
|
||||
"max_prepay_amt": {
|
||||
"type": "string",
|
||||
"format": "int64",
|
||||
"description": "*\nMaximum amount of the swap fee that may be charged as a prepayment."
|
||||
},
|
||||
"max_miner_fee": {
|
||||
"type": "string",
|
||||
"format": "int64",
|
||||
"description": "*\nMaximum in on-chain fees that we are willing to spent. If we want to\nsweep the on-chain htlc and the fee estimate turns out higher than this\nvalue, we cancel the swap. If the fee estimate is lower, we publish the\nsweep tx.\n\nIf the sweep tx is not confirmed, we are forced to ratchet up fees until it\nis swept. Possibly even exceeding max_miner_fee if we get close to the htlc\ntimeout. Because the initial publication revealed the preimage, we have no\nother choice. The server may already have pulled the off-chain htlc. Only\nwhen the fee becomes higher than the swap amount, we can only wait for fees\nto come down and hope - if we are past the timeout - that the server is not\npublishing the revocation.\n\nmax_miner_fee is typically taken from the response of the GetQuote call."
|
||||
},
|
||||
"loop_out_channel": {
|
||||
"type": "string",
|
||||
"format": "uint64",
|
||||
"description": "*\nThe channel to loop out, the channel to loop out is selected based on the\nlowest routing fee for the swap payment to the server."
|
||||
}
|
||||
}
|
||||
},
|
||||
"looprpcQuoteResponse": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"swap_fee": {
|
||||
"type": "string",
|
||||
"format": "int64",
|
||||
"description": "*\nThe fee that the swap server is charging for the swap."
|
||||
},
|
||||
"prepay_amt": {
|
||||
"type": "string",
|
||||
"format": "int64",
|
||||
"description": "*\nThe part of the swap fee that is requested as a prepayment."
|
||||
},
|
||||
"miner_fee": {
|
||||
"type": "string",
|
||||
"format": "int64",
|
||||
"description": "*\nAn estimate of the on-chain fee that needs to be paid to sweep the HTLC."
|
||||
}
|
||||
}
|
||||
},
|
||||
"looprpcSwapResponse": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"id": {
|
||||
"type": "string",
|
||||
"description": "*\nSwap identifier to track status in the update stream that is returned from\nthe Start() call. Currently this is the hash that locks the htlcs."
|
||||
}
|
||||
}
|
||||
},
|
||||
"looprpcSwapState": {
|
||||
"type": "string",
|
||||
"enum": [
|
||||
"INITIATED",
|
||||
"PREIMAGE_REVEALED",
|
||||
"SUCCESS",
|
||||
"FAILED"
|
||||
],
|
||||
"default": "INITIATED",
|
||||
"description": " - INITIATED: *\nINITIATED is the initial state of a swap. At that point, the initiation\ncall to the server has been made and the payment process has been started\nfor the swap and prepayment invoices.\n - PREIMAGE_REVEALED: *\nPREIMAGE_REVEALED is reached when the sweep tx publication is first\nattempted. From that point on, we should consider the preimage to no\nlonger be secret and we need to do all we can to get the sweep confirmed.\nThis state will mostly coalesce with StateHtlcConfirmed, except in the\ncase where we wait for fees to come down before we sweep.\n - SUCCESS: *\nSUCCESS is the final swap state that is reached when the sweep tx has\nthe required confirmation depth.\n - FAILED: *\nFAILED is the final swap state for a failed swap with or without loss of\nthe swap amount."
|
||||
},
|
||||
"looprpcSwapStatus": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"amt": {
|
||||
"type": "string",
|
||||
"format": "int64",
|
||||
"description": "*\nRequested swap amount in sat. This does not include the swap and miner\nfee."
|
||||
},
|
||||
"id": {
|
||||
"type": "string",
|
||||
"description": "*\nSwap identifier to track status in the update stream that is returned from\nthe Start() call. Currently this is the hash that locks the htlcs."
|
||||
},
|
||||
"type": {
|
||||
"$ref": "#/definitions/looprpcSwapType",
|
||||
"title": "*\nSwap type"
|
||||
},
|
||||
"state": {
|
||||
"$ref": "#/definitions/looprpcSwapState",
|
||||
"description": "*\nState the swap is currently in, see State enum."
|
||||
},
|
||||
"initiation_time": {
|
||||
"type": "string",
|
||||
"format": "int64",
|
||||
"description": "*\nInitiation time of the swap."
|
||||
},
|
||||
"last_update_time": {
|
||||
"type": "string",
|
||||
"format": "int64",
|
||||
"description": "*\nInitiation time of the swap."
|
||||
},
|
||||
"htlc_address": {
|
||||
"type": "string",
|
||||
"description": "*\nHtlc address."
|
||||
}
|
||||
}
|
||||
},
|
||||
"looprpcSwapType": {
|
||||
"type": "string",
|
||||
"enum": [
|
||||
"LOOP_OUT"
|
||||
],
|
||||
"default": "LOOP_OUT",
|
||||
"title": "- LOOP_OUT: LOOP_OUT indicates an loop out swap (off-chain to on-chain)"
|
||||
},
|
||||
"looprpcTermsResponse": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"swap_payment_dest": {
|
||||
"type": "string",
|
||||
"description": "*\nThe node pubkey where the swap payment needs to be paid\nto. This can be used to test connectivity before initiating the swap."
|
||||
},
|
||||
"swap_fee_base": {
|
||||
"type": "string",
|
||||
"format": "int64",
|
||||
"title": "*\nThe base fee for a swap (sat)"
|
||||
},
|
||||
"swap_fee_rate": {
|
||||
"type": "string",
|
||||
"format": "int64",
|
||||
"title": "*\nThe fee rate for a swap (parts per million)"
|
||||
},
|
||||
"prepay_amt": {
|
||||
"type": "string",
|
||||
"format": "int64",
|
||||
"title": "*\nRequired prepay amount"
|
||||
},
|
||||
"min_swap_amount": {
|
||||
"type": "string",
|
||||
"format": "int64",
|
||||
"title": "*\nMinimum swap amount (sat)"
|
||||
},
|
||||
"max_swap_amount": {
|
||||
"type": "string",
|
||||
"format": "int64",
|
||||
"title": "*\nMaximum swap amount (sat)"
|
||||
},
|
||||
"cltv_delta": {
|
||||
"type": "integer",
|
||||
"format": "int32",
|
||||
"title": "*\nOn-chain cltv expiry delta"
|
||||
},
|
||||
"max_cltv": {
|
||||
"type": "integer",
|
||||
"format": "int32",
|
||||
"title": "*\nMaximum cltv expiry delta"
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
@ -1,13 +1,24 @@
|
||||
#!/bin/sh
|
||||
|
||||
# Generate the server protos.
|
||||
protoc -I/usr/local/include -I.\
|
||||
-I$GOPATH/src/github.com/grpc-ecosystem/grpc-gateway/third_party/googleapis \
|
||||
--go_out=plugins=grpc,paths=source_relative:. \
|
||||
server.proto
|
||||
set -e
|
||||
|
||||
# Generate the gRPC bindings for all proto files.
|
||||
for file in ./*.proto
|
||||
do
|
||||
protoc -I/usr/local/include -I. \
|
||||
-I$GOPATH/src/github.com/grpc-ecosystem/grpc-gateway/third_party/googleapis \
|
||||
--go_out=plugins=grpc,paths=source_relative:. \
|
||||
${file}
|
||||
|
||||
done
|
||||
|
||||
# Only generate the REST proxy and definitions for the client component.
|
||||
protoc -I/usr/local/include -I. \
|
||||
-I$GOPATH/src/github.com/grpc-ecosystem/grpc-gateway/third_party/googleapis \
|
||||
--grpc-gateway_out=logtostderr=true:. \
|
||||
client.proto
|
||||
|
||||
# Generate the client protos.
|
||||
protoc -I/usr/local/include -I. \
|
||||
-I$GOPATH/src \
|
||||
--go_out=plugins=grpc:. \
|
||||
-I$GOPATH/src/github.com/grpc-ecosystem/grpc-gateway/third_party/googleapis \
|
||||
--swagger_out=logtostderr=true:. \
|
||||
client.proto
|
||||
|
||||
Loading…
Reference in New Issue