Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ishitatsuyuki/acominer
An experimental ETH miner powered by Vulkan
https://github.com/ishitatsuyuki/acominer
amd eth ethereum ethminer linux miner mining nsfminer vulkan
Last synced: 21 days ago
JSON representation
An experimental ETH miner powered by Vulkan
- Host: GitHub
- URL: https://github.com/ishitatsuyuki/acominer
- Owner: ishitatsuyuki
- License: apache-2.0
- Created: 2021-07-07T08:25:23.000Z (over 3 years ago)
- Default Branch: master
- Last Pushed: 2022-01-22T15:31:37.000Z (almost 3 years ago)
- Last Synced: 2024-10-17T04:11:41.892Z (about 1 month ago)
- Topics: amd, eth, ethereum, ethminer, linux, miner, mining, nsfminer, vulkan
- Language: Rust
- Homepage:
- Size: 271 KB
- Stars: 18
- Watchers: 5
- Forks: 6
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- License: LICENSE-APACHE
Awesome Lists containing this project
README
# 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](https://github.com/ishitatsuyuki/acominer/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](#Usage).
```
./run.sh stratum://0x1234567890123456789012345678901234567890.Worker:[email protected]:4444
```
## Usage
```
acominer stratum://0x1234567890123456789012345678901234567890.Worker:[email protected]: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](https://docs.mesa3d.org/install.html) for a list of dependencies.
```shell
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.
```shell
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](https://github.com/vulkano-rs/vulkano#linux-specific-setup) 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
```