はじめに

今回はLND Developer SiteのInstallationを翻訳＆要約。
基本的に書いてある通りにコマンド打っていればできるので、こっちみたほうがいいかも。
一応、Oshikawaメモを散らばらせておいた。

**追記:**こっち↓では翻訳ではなく実際に試した様子を記している。
Ubuntuでlndとbtcdの環境を構築してみる

見出し

インストール
事前準備
lndのインストール
利用可能なオペレーティングモード
btcd オプション
Neutrino オプション
Bitcoind オプション
btcdを使う
Neutrinoを使う
bitcoindかlitecoindを使う
Macaroons
Network Reachability
Simnet vs. Testnet Development
lnd.confを作る(オプション)

インストール

事前準備

lndを動かすには以下の依存環境が必要

Go: lndはGo言語で書かれている。インストールするには以下のコマンドを実行。

　備考：Goの最低必須バージョンはGo 1.11。我々はGoの最新バージョン(制作時は1.11だった)を使うことを勧めている。

☆ Oshikawaメモ：これを忘れていて、lndのBuildエラーが出まくって時間が食われた記憶があるので要注意。☆

Linuxの場合：
sudo apt-get install golang-1.11-go

Mac OS Xの場合:
brew install go

FreeBSDの場合:
pkg install go

☆ Oshikawaメ：Linuxユーザーは自分の環境に合ったインストール方法をググってインストールした方がいいかも。☆

あるいは、プレコンパイル済みのバイナリをGo言語ダウンロードページでダウンロードもできる。
ソースからインストールしたいなら、もっと詳細なインストール方法はここに書いてるよ。

この時点で、ワークスペースのパスを意味する＄GOPATH環境変数を設定すべき。デフォルトでは、$GOPATHは~/goに設定されている。$GOPATH/binにあなたのPATHを設定する必要がある。

export GOPATH=~/gocode
export PATH=$PATH:$GOPATH/bin

我々のオススメはターミナルを開くたびいちいち上のスクリプト書かなくていいために.bashrcかsetupスクリプトに置いくこと。

☆
Oshikawaメモ：
要は、.bashrcに上のスクリプトをコピペしてsource /.bashrcすればいいってこと。
☆

go_modules：依存関係の管理と再現性のあるビルドをするために、このプロジェクトはgo moduleを使う。

go moduleを使えば、$GOPATHにlndを追加する必要がなくなる。代わりに、lndリポジトリーがどこでも使えるようになる。

lndのインストール

事前準備が終わったら、lndとlncli、そのとの依存環境を以下のコマンドで実行しよう。

go get -d github.com/lightningnetwork/lnd
cd $GOPATH/src/github.com/lightningnetwork/lnd
make && make install

備考：我々のこのインストール手順では,前のGoのバージョンのディレクトリから$GOPATHを使たが、しかしgo 1.11ではlndはあなたのファイルシステムのどこからでも実行できるようになりました。

Windows WSLユーザーは/usr/bin/make/経由でmakeをするか、makeの周りにクオテーションマークをつけて、以下みたいにする。

/usr/bin/make && /usr/bin/make install

"make" && "make" install

FreeBSDでは、makeの代わりにgameを使う。
makeコマンドを使いたくないなら、代わりにgoコマンドをGO111MODULE=on go install -v ./...のディレクトリでつかえる。

アップデート

lndのバージョンをアップデートしたいなら、

cd $GOPATH/src/github.com/lightningnetwork/lnd
git pull
make clean && make && make install

FreeBSD,

cd $GOPATH/src/github.com/lightningnetwork/lnd
git pull
GO111MODULE=on go install -v ./...

テスト

lndが正しくインストールされているか確かめるには

make check

利用可能なオペレーティングモード

lndを実行できるようにするには、チェーンバックエンドを検証する必要がある。このdocumentを書いている時に、利用可能なバックエンドは：btcd, neutrino, bitcoindがある。neutrino以外のそれらすべてはメインネットでlndインスタンスから実行できる。bitcoindとbtcdでは--txindexを必要としないがtxindexをつけるとlndはつけたほうが早く実行できる。

☆
Oshikawaメモ：
lndはbtcdを使うことをオススメしている。
でも最近btcdは数十ノードしか稼働してないらしい...
詳しくは、coin danceを参照。
☆

btcd オプション

btcd:
      --btcd.dir=                       ノードのデータ、設定、ログなどを格納する基本ディレクトリ. 
                                       (default: /Users/roasbeef/Library/Application Support/Btcd)
      --btcd.rpchost=                                         The daemon's rpc listening address. If a port is omitted, then the default port for the selected chain parameters will be used. (default: localhost)
      --btcd.rpcuser=                                         Username for RPC connections
      --btcd.rpcpass=                                         Password for RPC connections
      --btcd.rpccert=                                         File containing the daemon's certificate file (default: /Users/roasbeef/Library/Application Support/Btcd/rpc.cert)
      --btcd.rawrpccert=                                      The raw bytes of the daemon's PEM-encoded certificate chain which will be used to authenticate the RPC connection

Neutrino オプション

neutrino:
  -a, --neutrino.addpeer=                                     Add a peer to connect with at startup
      --neutrino.connect=                                     Connect only to the specified peers at startup
      --neutrino.maxpeers=                                    Max number of inbound and outbound peers
      --neutrino.banduration=                                 How long to ban misbehaving peers.  Valid time units are {s, m, h}.  Minimum 1 second
      --neutrino.banthreshold=                                Maximum allowed ban score before disconnecting and banning misbehaving peers

Bitcoind オプション

bitcoind:
      --bitcoind.dir=                                         The base directory that contains the node's data, logs, configuration file, etc. (default: /Users/roasbeef/Library/Application Support/Bitcoin)
      --bitcoind.rpchost=                                     The daemon's rpc listening address. If a port is omitted, then the default port for the selected chain parameters will be used. (default: localhost)
      --bitcoind.rpcuser=                                     Username for RPC connections
      --bitcoind.rpcpass=                                     Password for RPC connections
      --bitcoind.zmqpubrawblock=                              The address listening for ZMQ connections to deliver raw block notifications
      --bitcoind.zmqpubrawtx=                                 The address listening for ZMQ connections to deliver raw transaction notifications

btcdを使う場合

btcdのインストール手順

FreeBSD,
Install btcd:
make btcd

それか、btcdのリポジトリからインストールできる。

btcdの起動

　以下のコマンドを実行すればrpc.certとデフォルトのbtcd.confを作ってくれる。

btcd --testnet --rpcuser=REPLACEME --rpcpass=REPLACEME

もしテストネットでlndを実行したいのなら、btcdでテストネットのフルノードを同期させる必要がある。PCによりけりだが、数時間かかる。Note that adding --txindex is optional, as it will take longer to sync the node, but then lnd will generally operate faster as it can hit the index directly, rather than scanning blocks or BIP 158 filters for relevant items.

btcdの同期をしている間、btcdのnetinfo RPCコマンドで進行状況を確認できる。

btcctl --testnet --rpcuser=REPLACEME --rpcpass=REPLACEME getinfo
{
  "version": 120000,
  "protocolversion": 70002,
  "blocks": 1114996,
  "timeoffset": 0,
  "connections": 7,
  "proxy": "",
  "difficulty": 422570.58270815,
  "testnet": true,
  "relayfee": 0.00001,
  "errors": ""
}

さらに、リアルタイムで同期の進行状況を見たいならbtcdのログを見ることができる。

getpeerinfoコマンドであなたのbtcdノードの接続性をみれる。

btcctl --testnet --rpcuser=REPLACEME --rpcpass=REPLACEME getpeerinfo | more

btcdのバックエンドでlndを動かす

テストネットにいるなら、btcdの同期が終わった後、以下のコマンドを実行しよう。それか、e --bitcoin.testnet を --bitcoin.simnetに置きかえよう。

もしチュートリアルのためにlndを準備しているのなら、このステップはスキップしていい。

lnd --bitcoin.active --bitcoin.testnet --debuglevel=debug --btcd.rpcuser=kek --btcd.rpcpass=kek --externalip=X.X.X.X

Neutrinoを使う場合

軽量クライエントモードでlndを実行するためには、この新しい軽量クライエントモードを提供てきるフルノードに位置する必要がある。lndは軽量クライエントモードのためにBIP 157とBIP 158を使う。

neutrinoモードで、lndを使う場合、lndを以下の通り実行しよう。

lnd --bitcoin.active --bitcoin.testnet --debuglevel=debug --bitcoin.node=neutrino --neutrino.connect=faucet.lightning.community

bitcoindかlitecoindを使う場合

bitcoindとlitecoindの設定はかなり似ている。

以下がlndで使うbitcoin.confのサンプル。

testnet=1
server=1
daemon=1
zmqpubrawblock=tcp://127.0.0.1:28332
zmqpubrawtx=tcp://127.0.0.1:28333

Macaroons

lndの認証システムはmacaroonsと呼ばれており、非中央集権的な資格情報の権限の委任や減衰、その他色々できる。詳しいことはAlex AkselrodのGithubで読める。

lndを初めて実行した時、lndの認証に使うためのlndadmin.macaroon, read_only.macaroo, macaroons.dbがデフォルトで作成される。
それらはネットワークディレクトリに保存される。(default: lnddir/data/chain/bitcoin/mainnet) そのため、ainnet, testnet, simnet, その他で異なるパスワードを使える。もし他のディレクトリをしていいしたいなら(--datadir経由で)、--macaroonpathを使ってlncliのadmin.macaroonに新しいパスを通さないといけない。

macaroonsをテスト用に使えなくするためには、lndとlncliに--no-macaroonsフラグをつける。

Network Reachability

もし新しいチャンネルを受け入れるために(peersはチャンネル開設のワークフロー初期化のためにinboundを繋ぐ必要があるので)他のノードにシグナルをつけるには、あなたのパブリックなIPアドレスに--externalipフラグをつけるべきだ。

Simnet vs. Testnet Development

もしチュートリアルなどでローカルの開発環境を使うなら、simnetモードでbtcdやlndを使いたいはず。simnetはregtestとよく似ていてlndをローカルで試すためのBlockの採掘を即座に行える。--bitcoin.testnetの代わりに--bitcoin.simnetをつけると、デーモンを起動する時testnetの代わりにsimnetを使える。

lndの開発環境で使える他のローカルテスト用の関連コマンドラインフラグは--debughtlcがある。このコマンドと一緒にlndを起動すると、特別なHTLCが自動で設置できるようになる。これでマニュアルどうりの試験的な送金用のinvoiceを発行する必要がなくなる。この特別なHTLCタイプに送金するには、--debugsendコマンドをsendpaymentコマンドの最後につける必要がある。

現在、lndを起動するために、主要な２つの方法がある。まず、RPCサービスに晒されたローカルのbtcdインスタンスを使うこと。もう一つは、フルに統合されたneutrinoの軽量クライエントを使うことである。

lnd.confを作る(オプション)

lndの起動の間、永続的な設定を持ちたいなら、lnd --bitcoin.testnet --bitcoin.activeとコマンドラインで打てばいい。すると、lnd.confが作られる。

MacOS： /Users/[username]/Library/Application Support/Lnd/lnd.conf
Linux： ~/.lnd/lnd.conf

btcdを始めるためのlnd.confのサンプル。

[Application Options]
debuglevel=trace
maxpendingchannels=10

[Bitcoin]
bitcoin.active=1

[Bitcoin]の部分に注目してください。ここにBitcoinのパラメータを置きます。lndはLitecoinのtestnet4(BTCとLTCを同時にはできない)もサポートしている。Litecoinを使うときはLitecoinのパラメーターを設定してください。詳細なサンプルファイルはここで見れて他の[Btcd], [Bitcoind], [Neutrino], [Ltcd], [Litecoind]も探せます。