# mwc - ビルド、設定、動作確認

*この文章を他の言語で読む: [English](../build.md), [Español](build_ES.md), [Korean](build_KR.md), [简体中文](build_ZH-CN.md).*

## 動作環境

mwcのプログラミング言語である`rust`はほぼ全ての環境に対応している。

現在の動作環境

* Linux x86\_64とmacOS [mwc、マイニング、開発]
* Windows 10は未対応 [一部のビルドはできるがマイニングがまだ。助けを募集中!]

## 要件

* rust 1.34+ ([rustup]((https://www.rustup.rs/))を使えば`curl https://sh.rustup.rs -sSf | sh; source $HOME/.cargo/env`でインストール可)
  * rustをインストール済みの場合は`rustup update`を実行
* clang
* ncursesとそのライブラリ (ncurses, ncursesw5)
* zlibとそのライブラリ (zlib1g-dev または zlib-devel)
* pkg-config
* libssl-dev
* linux-headers (Alpine linuxでは必要)
* llvm

Debianベースのディストリビューション(Debian、Ubuntu、Mintなど)ではrustを除き1コマンドでインストールできる:

```sh
apt install build-essential cmake git libgit2-dev clang libncurses5-dev libncursesw5-dev zlib1g-dev pkg-config libssl-dev llvm
```

Mac:

```sh
xcode-select --install
brew install --with-toolchain llvm
brew install pkg-config
brew install openssl
```

## ビルド手順

```sh
git clone https://github.com/mwcproject/mwc-node.git
cd mwc
cargo build --release
```

mwcはデバッグモードでもビルド可能(`--release`を付けない状態で、`--debug`か`--verbose`を付ける)。
しかし暗号の計算のオーバーヘッドが大きく、高速同期が著しく遅くなる。

## ビルドエラー

[Troubleshooting](https://github.com/mimblewimble/docs/wiki/Troubleshooting)

## 何がビルドされるか

ビルドの成果物

* `target/release/mwc` - mwcの実行ファイル

mwcのデータ、設定ファイル、ログファイルはデフォルトでは(ホームディレクトリ配下の)`~/.mwc`のディレクトリに格納されている。
全ての設定値は`~/.mwc/main/mwc-server.toml`を編集することで変更可能。

データファイルをカレントディレクトリに出力することも可能。
そのためには以下のコマンドを実行。

```sh
mwc server config
```

カレントディレクトリに`mwc-server.toml`がある場合、カレントディレクトリにデータが出力される。
mwcを`mwc-server.toml`を含むディレクトリで起動する場合、デフォルトである`~/.mwc/main/mwc-server.toml`よりも優先される。

テスト中はmwcのバイナリにpathを通す:

```sh
export PATH=`pwd`/target/release:$PATH
```

ただし、mwcをインストールしたルートディレクトリから実行することを想定している。

これにより`mwc`が直接実行可能になる(オプションは`mwc help`で調べられる)。

## 設定

mwcは気の利いたデフォルト設定で起動するようになっており、さらに`mwc-server.toml`のファイルを通じて設定可能。
このファイルはmwcの初回起動で作成され、利用可能なオプションに関するドキュメントを含んでいる。

`mwc-server.toml`を通じて設定することが推奨されるが、全ての設定はコマンドラインで上書きすることも可能。

コマンドライン関連のヘルプについてはこちらを実行:

```sh
mwc help
mwc server --help
mwc client --help
```

## Docker

```sh
docker build -t mwc -f etc/Dockerfile .
```
floonetを使用する場合、代わりに`etc/Dockerfile.floonet`を指定。

コンテナ内で実行する場合、mwcのキャッシュをバインドマウントすることも可能。

```sh
docker run -it -d -v $HOME/.mwc:/root/.mwc mwc
```
dockerの名前付きボリュームを使用する場合、代わりに`-v dotmwc:/root/.mwc`を指定。
ボリュームが作成される前に、名前付きボリュームがコピーされる。

## クロスプラットフォームビルド

rust(cargo)はあらゆるプラットフォームでビルド可能なので、`mwc`をバリデーションノードとして省電力なデバイスで実行することも可能である。
x86のLinux上で`mwc`をクロスコンパイルしARMバイナリを作成し、Raspberry Piで実行することも可能。

## mwcの使用

機能やトラブルシューティングなどに関するより多くの情報については[Wallet User Guide](https://github.com/mimblewimble/docs/wiki/Wallet-User-Guide)。


## mwcのマイニング

mwcのマイニングに関する全ての機能は[mwc-miner](https://github.com/mwcproject/mwc-node-miner)と呼ばれるスタンドアローンなパッケージに分離されていることに注意。

mwc-minerをmwcノードと通信させるためには、`mwc-server.toml`の設定ファイルで`enable_stratum_server = true`と設定し、ウォレットリスナーを起動(`mwc-wallet listen`)しておく必要がある。