lndclient: switch to using per-call macaroons instead of a conn level macaroon

In this commit, we modify all sub-servers as well as the main lnd gRPC
service to use a macaroon per call rather than a connection level
macaroon. The old approach would result in us using the same macaroon
for the entire connection, while this new approach allows us to use
multiple macaroons with a single connection.

We move to this new approach as it doesn't require users to delete their
admin macaroon before being able to use Loop. It also preps us for a
future where there is no admin macaroon, and we instead need to use a
set of macaroons to accomplish our tasks.
pull/45/head
Olaoluwa Osuntokun 5 years ago
parent 2c97258ce7
commit 5f6ad1161b
No known key found for this signature in database
GPG Key ID: CE58F7F8E20FD9A2

@ -28,13 +28,16 @@ type ChainNotifierClient interface {
} }
type chainNotifierClient struct { type chainNotifierClient struct {
client chainrpc.ChainNotifierClient client chainrpc.ChainNotifierClient
wg sync.WaitGroup chainMac serializedMacaroon
wg sync.WaitGroup
} }
func newChainNotifierClient(conn *grpc.ClientConn) *chainNotifierClient { func newChainNotifierClient(conn *grpc.ClientConn, chainMac serializedMacaroon) *chainNotifierClient {
return &chainNotifierClient{ return &chainNotifierClient{
client: chainrpc.NewChainNotifierClient(conn), client: chainrpc.NewChainNotifierClient(conn),
chainMac: chainMac,
} }
} }
@ -54,7 +57,8 @@ func (s *chainNotifierClient) RegisterSpendNtfn(ctx context.Context,
} }
} }
resp, err := s.client.RegisterSpendNtfn(ctx, &chainrpc.SpendRequest{ macaroonAuth := s.chainMac.WithMacaroonAuth(ctx)
resp, err := s.client.RegisterSpendNtfn(macaroonAuth, &chainrpc.SpendRequest{
HeightHint: uint32(heightHint), HeightHint: uint32(heightHint),
Outpoint: rpcOutpoint, Outpoint: rpcOutpoint,
Script: pkScript, Script: pkScript,
@ -125,16 +129,15 @@ func (s *chainNotifierClient) RegisterConfirmationsNtfn(ctx context.Context,
if txid != nil { if txid != nil {
txidSlice = txid[:] txidSlice = txid[:]
} }
confStream, err := s.client. confStream, err := s.client.RegisterConfirmationsNtfn(
RegisterConfirmationsNtfn( s.chainMac.WithMacaroonAuth(ctx),
ctx, &chainrpc.ConfRequest{
&chainrpc.ConfRequest{ Script: pkScript,
Script: pkScript, NumConfs: uint32(numConfs),
NumConfs: uint32(numConfs), HeightHint: uint32(heightHint),
HeightHint: uint32(heightHint), Txid: txidSlice,
Txid: txidSlice, },
}, )
)
if err != nil { if err != nil {
return nil, nil, err return nil, nil, err
} }
@ -203,8 +206,9 @@ func (s *chainNotifierClient) RegisterConfirmationsNtfn(ctx context.Context,
func (s *chainNotifierClient) RegisterBlockEpochNtfn(ctx context.Context) ( func (s *chainNotifierClient) RegisterBlockEpochNtfn(ctx context.Context) (
chan int32, chan error, error) { chan int32, chan error, error) {
blockEpochClient, err := s.client. blockEpochClient, err := s.client.RegisterBlockEpochNtfn(
RegisterBlockEpochNtfn(ctx, &chainrpc.BlockEpoch{}) s.chainMac.WithMacaroonAuth(ctx), &chainrpc.BlockEpoch{},
)
if err != nil { if err != nil {
return nil, nil, err return nil, nil, err
} }

@ -33,13 +33,15 @@ type InvoiceUpdate struct {
} }
type invoicesClient struct { type invoicesClient struct {
client invoicesrpc.InvoicesClient client invoicesrpc.InvoicesClient
wg sync.WaitGroup invoiceMac serializedMacaroon
wg sync.WaitGroup
} }
func newInvoicesClient(conn *grpc.ClientConn) *invoicesClient { func newInvoicesClient(conn *grpc.ClientConn, invoiceMac serializedMacaroon) *invoicesClient {
return &invoicesClient{ return &invoicesClient{
client: invoicesrpc.NewInvoicesClient(conn), client: invoicesrpc.NewInvoicesClient(conn),
invoiceMac: invoiceMac,
} }
} }
@ -53,6 +55,7 @@ func (s *invoicesClient) SettleInvoice(ctx context.Context,
rpcCtx, cancel := context.WithTimeout(ctx, rpcTimeout) rpcCtx, cancel := context.WithTimeout(ctx, rpcTimeout)
defer cancel() defer cancel()
rpcCtx = s.invoiceMac.WithMacaroonAuth(ctx)
_, err := s.client.SettleInvoice(rpcCtx, &invoicesrpc.SettleInvoiceMsg{ _, err := s.client.SettleInvoice(rpcCtx, &invoicesrpc.SettleInvoiceMsg{
Preimage: preimage[:], Preimage: preimage[:],
}) })
@ -66,6 +69,7 @@ func (s *invoicesClient) CancelInvoice(ctx context.Context,
rpcCtx, cancel := context.WithTimeout(ctx, rpcTimeout) rpcCtx, cancel := context.WithTimeout(ctx, rpcTimeout)
defer cancel() defer cancel()
rpcCtx = s.invoiceMac.WithMacaroonAuth(rpcCtx)
_, err := s.client.CancelInvoice(rpcCtx, &invoicesrpc.CancelInvoiceMsg{ _, err := s.client.CancelInvoice(rpcCtx, &invoicesrpc.CancelInvoiceMsg{
PaymentHash: hash[:], PaymentHash: hash[:],
}) })
@ -77,11 +81,12 @@ func (s *invoicesClient) SubscribeSingleInvoice(ctx context.Context,
hash lntypes.Hash) (<-chan InvoiceUpdate, hash lntypes.Hash) (<-chan InvoiceUpdate,
<-chan error, error) { <-chan error, error) {
invoiceStream, err := s.client. invoiceStream, err := s.client.SubscribeSingleInvoice(
SubscribeSingleInvoice(ctx, s.invoiceMac.WithMacaroonAuth(ctx),
&lnrpc.PaymentHash{ &lnrpc.PaymentHash{
RHash: hash[:], RHash: hash[:],
}) },
)
if err != nil { if err != nil {
return nil, nil, err return nil, nil, err
} }
@ -135,6 +140,7 @@ func (s *invoicesClient) AddHoldInvoice(ctx context.Context,
Private: true, Private: true,
} }
rpcCtx = s.invoiceMac.WithMacaroonAuth(rpcCtx)
resp, err := s.client.AddHoldInvoice(rpcCtx, rpcIn) resp, err := s.client.AddHoldInvoice(rpcCtx, rpcIn)
if err != nil { if err != nil {
return "", err return "", err

@ -78,17 +78,19 @@ var (
) )
type lightningClient struct { type lightningClient struct {
client lnrpc.LightningClient client lnrpc.LightningClient
wg sync.WaitGroup wg sync.WaitGroup
params *chaincfg.Params params *chaincfg.Params
adminMac serializedMacaroon
} }
func newLightningClient(conn *grpc.ClientConn, func newLightningClient(conn *grpc.ClientConn,
params *chaincfg.Params) *lightningClient { params *chaincfg.Params, adminMac serializedMacaroon) *lightningClient {
return &lightningClient{ return &lightningClient{
client: lnrpc.NewLightningClient(conn), client: lnrpc.NewLightningClient(conn),
params: params, params: params,
adminMac: adminMac,
} }
} }
@ -110,6 +112,7 @@ func (s *lightningClient) ConfirmedWalletBalance(ctx context.Context) (
rpcCtx, cancel := context.WithTimeout(ctx, rpcTimeout) rpcCtx, cancel := context.WithTimeout(ctx, rpcTimeout)
defer cancel() defer cancel()
rpcCtx = s.adminMac.WithMacaroonAuth(rpcCtx)
resp, err := s.client.WalletBalance(rpcCtx, &lnrpc.WalletBalanceRequest{}) resp, err := s.client.WalletBalance(rpcCtx, &lnrpc.WalletBalanceRequest{})
if err != nil { if err != nil {
return 0, err return 0, err
@ -122,6 +125,7 @@ func (s *lightningClient) GetInfo(ctx context.Context) (*Info, error) {
rpcCtx, cancel := context.WithTimeout(ctx, rpcTimeout) rpcCtx, cancel := context.WithTimeout(ctx, rpcTimeout)
defer cancel() defer cancel()
rpcCtx = s.adminMac.WithMacaroonAuth(rpcCtx)
resp, err := s.client.GetInfo(rpcCtx, &lnrpc.GetInfoRequest{}) resp, err := s.client.GetInfo(rpcCtx, &lnrpc.GetInfoRequest{})
if err != nil { if err != nil {
return nil, err return nil, err
@ -159,6 +163,7 @@ func (s *lightningClient) EstimateFeeToP2WSH(ctx context.Context,
return 0, err return 0, err
} }
rpcCtx = s.adminMac.WithMacaroonAuth(rpcCtx)
resp, err := s.client.EstimateFee( resp, err := s.client.EstimateFee(
rpcCtx, rpcCtx,
&lnrpc.EstimateFeeRequest{ &lnrpc.EstimateFeeRequest{
@ -216,6 +221,7 @@ func (s *lightningClient) payInvoice(ctx context.Context, invoice string,
hash := lntypes.Hash(*payReq.PaymentHash) hash := lntypes.Hash(*payReq.PaymentHash)
ctx = s.adminMac.WithMacaroonAuth(ctx)
for { for {
// Create no timeout context as this call can block for a long // Create no timeout context as this call can block for a long
// time. // time.
@ -329,6 +335,7 @@ func (s *lightningClient) AddInvoice(ctx context.Context,
rpcIn.RHash = in.Hash[:] rpcIn.RHash = in.Hash[:]
} }
rpcCtx = s.adminMac.WithMacaroonAuth(rpcCtx)
resp, err := s.client.AddInvoice(rpcCtx, rpcIn) resp, err := s.client.AddInvoice(rpcCtx, rpcIn)
if err != nil { if err != nil {
return lntypes.Hash{}, "", err return lntypes.Hash{}, "", err

@ -68,12 +68,17 @@ func NewLndServices(lndAddress, application, network, macaroonDir,
return nil, err return nil, err
} }
lightningClient := newLightningClient(conn, chainParams) lightningClient := newLightningClient(
conn, chainParams, macaroons.adminMac,
)
// With our macaroons obtained, we'll ensure that the network for lnd
// matches our expected network.
info, err := lightningClient.GetInfo(context.Background()) info, err := lightningClient.GetInfo(context.Background())
if err != nil { if err != nil {
conn.Close() conn.Close()
return nil, err return nil, fmt.Errorf("unable to get info for lnd "+
"node: %v", err)
} }
if network != info.Network { if network != info.Network {
conn.Close() conn.Close()
@ -82,10 +87,12 @@ func NewLndServices(lndAddress, application, network, macaroonDir,
) )
} }
notifierClient := newChainNotifierClient(conn) // With the network check passed, we'll now initialize the rest of the
signerClient := newSignerClient(conn) // sub-sever connections, giving each of them their specific macaroon.
walletKitClient := newWalletKitClient(conn) notifierClient := newChainNotifierClient(conn, macaroons.chainMac)
invoicesClient := newInvoicesClient(conn) signerClient := newSignerClient(conn, macaroons.signerMac)
walletKitClient := newWalletKitClient(conn, macaroons.walletKitMac)
invoicesClient := newInvoicesClient(conn, macaroons.invoiceMac)
cleanup := func() { cleanup := func() {
logger.Debugf("Closing lnd connection") logger.Debugf("Closing lnd connection")

@ -17,12 +17,16 @@ type SignerClient interface {
} }
type signerClient struct { type signerClient struct {
client signrpc.SignerClient client signrpc.SignerClient
signerMac serializedMacaroon
} }
func newSignerClient(conn *grpc.ClientConn) *signerClient { func newSignerClient(conn *grpc.ClientConn,
signerMac serializedMacaroon) *signerClient {
return &signerClient{ return &signerClient{
client: signrpc.NewSignerClient(conn), client: signrpc.NewSignerClient(conn),
signerMac: signerMac,
} }
} }
@ -76,6 +80,7 @@ func (s *signerClient) SignOutputRaw(ctx context.Context, tx *wire.MsgTx,
rpcCtx, cancel := context.WithTimeout(ctx, rpcTimeout) rpcCtx, cancel := context.WithTimeout(ctx, rpcTimeout)
defer cancel() defer cancel()
rpcCtx = s.signerMac.WithMacaroonAuth(rpcCtx)
resp, err := s.client.SignOutputRaw(rpcCtx, resp, err := s.client.SignOutputRaw(rpcCtx,
&signrpc.SignReq{ &signrpc.SignReq{
RawTxBytes: txRaw, RawTxBytes: txRaw,

@ -34,12 +34,16 @@ type WalletKitClient interface {
} }
type walletKitClient struct { type walletKitClient struct {
client walletrpc.WalletKitClient client walletrpc.WalletKitClient
walletKitMac serializedMacaroon
} }
func newWalletKitClient(conn *grpc.ClientConn) *walletKitClient { func newWalletKitClient(conn *grpc.ClientConn,
walletKitMac serializedMacaroon) *walletKitClient {
return &walletKitClient{ return &walletKitClient{
client: walletrpc.NewWalletKitClient(conn), client: walletrpc.NewWalletKitClient(conn),
walletKitMac: walletKitMac,
} }
} }
@ -49,6 +53,7 @@ func (m *walletKitClient) DeriveNextKey(ctx context.Context, family int32) (
rpcCtx, cancel := context.WithTimeout(ctx, rpcTimeout) rpcCtx, cancel := context.WithTimeout(ctx, rpcTimeout)
defer cancel() defer cancel()
rpcCtx = m.walletKitMac.WithMacaroonAuth(rpcCtx)
resp, err := m.client.DeriveNextKey(rpcCtx, &walletrpc.KeyReq{ resp, err := m.client.DeriveNextKey(rpcCtx, &walletrpc.KeyReq{
KeyFamily: family, KeyFamily: family,
}) })
@ -76,6 +81,7 @@ func (m *walletKitClient) DeriveKey(ctx context.Context, in *keychain.KeyLocator
rpcCtx, cancel := context.WithTimeout(ctx, rpcTimeout) rpcCtx, cancel := context.WithTimeout(ctx, rpcTimeout)
defer cancel() defer cancel()
rpcCtx = m.walletKitMac.WithMacaroonAuth(rpcCtx)
resp, err := m.client.DeriveKey(rpcCtx, &signrpc.KeyLocator{ resp, err := m.client.DeriveKey(rpcCtx, &signrpc.KeyLocator{
KeyFamily: int32(in.Family), KeyFamily: int32(in.Family),
KeyIndex: int32(in.Index), KeyIndex: int32(in.Index),
@ -101,6 +107,7 @@ func (m *walletKitClient) NextAddr(ctx context.Context) (
rpcCtx, cancel := context.WithTimeout(ctx, rpcTimeout) rpcCtx, cancel := context.WithTimeout(ctx, rpcTimeout)
defer cancel() defer cancel()
rpcCtx = m.walletKitMac.WithMacaroonAuth(rpcCtx)
resp, err := m.client.NextAddr(rpcCtx, &walletrpc.AddrRequest{}) resp, err := m.client.NextAddr(rpcCtx, &walletrpc.AddrRequest{})
if err != nil { if err != nil {
return nil, err return nil, err
@ -125,6 +132,7 @@ func (m *walletKitClient) PublishTransaction(ctx context.Context,
rpcCtx, cancel := context.WithTimeout(ctx, rpcTimeout) rpcCtx, cancel := context.WithTimeout(ctx, rpcTimeout)
defer cancel() defer cancel()
rpcCtx = m.walletKitMac.WithMacaroonAuth(rpcCtx)
_, err = m.client.PublishTransaction(rpcCtx, &walletrpc.Transaction{ _, err = m.client.PublishTransaction(rpcCtx, &walletrpc.Transaction{
TxHex: txHex, TxHex: txHex,
}) })
@ -147,6 +155,7 @@ func (m *walletKitClient) SendOutputs(ctx context.Context,
rpcCtx, cancel := context.WithTimeout(ctx, rpcTimeout) rpcCtx, cancel := context.WithTimeout(ctx, rpcTimeout)
defer cancel() defer cancel()
rpcCtx = m.walletKitMac.WithMacaroonAuth(rpcCtx)
resp, err := m.client.SendOutputs(rpcCtx, &walletrpc.SendOutputsRequest{ resp, err := m.client.SendOutputs(rpcCtx, &walletrpc.SendOutputsRequest{
Outputs: rpcOutputs, Outputs: rpcOutputs,
SatPerKw: int64(feeRate), SatPerKw: int64(feeRate),
@ -169,6 +178,7 @@ func (m *walletKitClient) EstimateFee(ctx context.Context, confTarget int32) (
rpcCtx, cancel := context.WithTimeout(ctx, rpcTimeout) rpcCtx, cancel := context.WithTimeout(ctx, rpcTimeout)
defer cancel() defer cancel()
rpcCtx = m.walletKitMac.WithMacaroonAuth(rpcCtx)
resp, err := m.client.EstimateFee(rpcCtx, &walletrpc.EstimateFeeRequest{ resp, err := m.client.EstimateFee(rpcCtx, &walletrpc.EstimateFeeRequest{
ConfTarget: int32(confTarget), ConfTarget: int32(confTarget),
}) })

Loading…
Cancel
Save