acominer

An open source, fast and reliable Ethereum miner.

IMPORTANT

acominer requires an AMD graphics card running Linux to run.
acominer does not support other setups.
TLS is not supported for now. Make sure you connect to an unencrypted port.

Running

Binaries are available from releases. Ubuntu 20.04 or later is supported.

If you are running a headless Ubuntu-based setup, make sure vulkan-utils libvulkan1 libxcb-shm0 is installed.

Download, extract and execute ./run.sh. See also Usage.

./run.sh stratum://0x1234567890123456789012345678901234567890.Worker:password@pool.example.com:4444

Usage

acominer stratum://0x1234567890123456789012345678901234567890.Worker:password@pool.example.com:4444

Supported protocol: Stratum v1, unencrypted only

See acominer --help for more information such as choosing a specific GPU or changing tuning parameters.

If acominers fails with "device out of memory", then you need to override the Vulkan driver used with VK_ICD_FILENAMES. (See above.) You might also need to specify the device index explicitly with -d .

Features

Zero miner fee
Powered by Vulkan
Small work dispatch size, gives lower latency
Desktop-friendly, mining affects GUI performance minimally

Building

Building the Mesa fork

You need the Meson build system and ninja installed along with C/C++ compilers. See Mesa Documentation for a list of dependencies.

git clone -b acominer https://gitlab.freedesktop.org/ishitatsuyuki/mesa.git # Clone the Mesa fork
cd mesa
meson build -Ddri-drivers= -Dgallium-drivers= -Dvulkan-drivers=amd -Dprefix=$PWD/build/install # Generate build files
cd build
ninja # Run the build
ninja install # Copy built drivers to prefix

Override the Vulkan driver as follows (every time) when you run acominer.

export VK_ICD_FILENAMES=/path/to/mesa/build/install/share/vulkan/icd.d/radeon_icd.x86_64.json

Building the project

In addition to the Rust compiler, acominer needs Vulkan SDK to build. See here for distro specific instructions.

Afterwards, just run cargo build --release and you should get a working binary as target/release/acominer.

License

Original acominer code: Apache V2 or MIT License, at your option

Keccak hash code: GPLv3 (derived from ethminer)

Tipping

You can do some mining on my behalf to show your appreciation:

stratum://0x76cB31Fdb28Ddf887AF3cA4A0f7786D02C86032a.[YOUR WORKER NAME]@asia1.ethermine.org:4444

ishitatsuyuki / acominer

readme