Mugle Miner

A standalone mining implementation intended for mining Mugle against a running Mugle node.

Supported Platforms

At present, only mining plugins for linux-x86_64 and MacOS exist. This will likely change over time as the community creates more solvers for different platforms.

Requirements

• rust 1.30+ (use rustup- i.e. curl https://sh.rustup.rs -sSf | sh; source $HOME/.cargo/env)
• cmake 3.2+ (for Cuckoo mining plugins)
• ncurses and libs (ncurses, ncursesw5)
• zlib libs (zlib1g-dev or zlib-devel)
• linux-headers (reported needed on Alpine linux)

And a running Mugle node to mine into!

Build steps

git clone https://github.com/mugleproject/mugle-miner.git
cd mugle-miner
git submodule update --init
cargo build

Building the Cuckoo-Miner plugins

Mugle-miner automatically builds x86_64 CPU plugins. Cuda plugins are also provided, but are not enabled by default. To enable them, modify Cargo.toml as follows:

change:
cuckoo_miner = { path = "./cuckoo-miner" }
to:
cuckoo_miner = { path = "./cuckoo-miner", features = ["build-cuda-plugins"]}

The Cuda toolkit 9+ must be installed on your system (check with nvcc --version)

Building the OpenCL plugins

OpenCL plugins are not enabled by default. Run install_ocl_plugins.sh script to build and install them.

./install_ocl_plugins.sh

You must install OpenCL libraries for your operating system before. If you just need to compile them (for development or testing purposes) build mugle-miner the following way:

cargo build --features opencl

Build errors

See Troubleshooting

What was built?

A successful build gets you:

• target/debug/mugle-miner - the main mugle-miner binary
• target/debug/plugins/* - mining plugins

Make sure you always run mugle-miner within a directory that contains a mugle-miner.toml configuration file.

While testing, put the mugle-miner binary on your path like this:

export PATH=/path/to/mugle-miner/dir/target/debug:$PATH

You can then run mugle-miner directly.

Configuration

Mugle-miner can be further configured via the mugle-miner.toml file. This file contains contains inline documentation on all configuration options, and should be the first point of reference.

You should always ensure that this file exists in the directory from which you're running mugle-miner.

Using mugle-miner

There is a Mugle forum post with further detail on how to configure mugle-miner and mine mugle's testnet.

lib.rs:

Crate wrapping up the Mugle miner plugins