lndgrpc 0.2.0

# lndgrpc
一个针对LND（闪电网络守护进程）的python grpc客户端 ⚡⚡⚡

这是一个围绕默认grpc接口的包装器，用于设置凭证（包括macaroons）。还提供了一个异步客户端，用于执行一些有趣的异步操作，如后台监听发票。

## 依赖关系
Python 2.7, 3.4+
注意：异步客户端仅适用于Python 3.5+

## 安装
```bash
$ pip install lndgrpc
```

## 基本用法
API反映了底层lnd grpc api（http://api.lightning.community/），但方法将以pep8风格命名。例如：.GetInfo()变为.get_info()。

```python
from lndgrpc import LNDClient

# 传递IP地址、RPC端口和网络('mainnet', 'testnet', 'simnet')
# 客户端默认为127.0.0.1:10009和mainnet，如果没有提供参数
lnd = LNDClient("127.0.0.1:10009", network='simnet')

lnd.get_info()

print('正在监听发票...')
for invoice in lnd.subscribe_invoices()
print(invoice)
```

### 异步

```python
import asyncio
from lndgrpc import AsyncLNDClient

async_lnd = AsyncLNDClient()

async def subscribe_invoices()
print('正在监听发票...')
async for invoice in async_lnd.subscribe_invoices()
print(invoice)

async def get_info()
while True
info = await async_lnd.get_info()
print(info)
await asyncio.sleep(5)

async def run()
coros = [subscribe_invoices(), get_info()]
await asyncio.gather(*coros)

loop = asyncio.get_event_loop()
loop.run_until_complete(run())
```

### 指定 Macaroon/Cert 文件
默认情况下，客户端将在主网络目录中尝试查找 `readonly.macaron` 和 `tls.cert` 文件。
但是，如果您想指定不同的 macaroon 或不同的路径，您可以显式传递文件路径。

```python
lnd = LNDClient(macaroon_filepath='~/.lnd/invoice.macaroon', cert_filepath='path/to/tls.cert')
```

#### 管理员 Macaroon
使用管理员 Macaroon 执行写操作（例如创建发票、创建新地址）

```python
lnd = LNDClient(admin=True)
lnd.add_invoice(2000)
```