Skip to content

traderpedroso/btco-work-server

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

91 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

btco work server

./root/btco-work-server/target/release/btco-work-server --gpu 0:0:1024 --gpu-local-work-size 16 --listen-address 192.168.1.140:7070 Build

This project is a dedicated work server for the btco cryptocurrency. See the documentation for details on work generation and the current network difficulty.

btco-work-server supports the work_generate, work_cancel, and work_validate commands from the btco RPC. For details on these commands, see the btco RPC documentation.

To see available command line options, run btco-work-server --help.

If using more than one work peer, give the flag --shuffle. This makes it so that the next request is picked randomly instead of sequentially, which leads to more efficient work generation with multiple peers, especially when they are not in the same network.

Current base difficulty

0xfffffff800000000 since a75d984. See the btco work generation guide for more information.

Installation

OpenCL

Ubuntu:

sudo apt install ocl-icd-opencl-dev

Fedora:

sudo dnf install ocl-icd-devel

Windows:

Rust

Linux:

curl https://sh.rustup.rs -sSf | sh

Windows: follow instructions in https://www.rust-lang.org/tools/install

GCC

Ubuntu:

sudo apt install gcc

Fedora:

sudo dnf install gcc

Build

git clone https://github.com/bitcoinnanolabs/btco-work-server.git
cd btco-work-server
cargo build --release

Depending on your system configuration and if the OpenCL library cannot be found in the PATH, it may be necessary to link against explicitly:

cargo rustc --release -- -l OpenCL -L "/path/to/opencl.lib"

Using

btco-work-server --help

Note difficulty values may be outdated in these examples.

  • work_generate example:

    {
        "action": "work_generate",
        "hash": "718CC2121C3E641059BC1C2CFC45666C99E8AE922F7A807B7D07B62C995D79E2",
        "difficulty": "ffffffc000000000",
        "multiplier": "1.0" // overrides difficulty
    }

    Response:

    {
        "work": "2bf29ef00786a6bc",
        "difficulty": "ffffffd21c3933f4",
        "multiplier": "1.3946469"        
    }
  • work_validate example:

    {
        "action": "work_validate",
        "hash": "718CC2121C3E641059BC1C2CFC45666C99E8AE922F7A807B7D07B62C995D79E2",
        "work": "2bf29ef00786a6bc",
        "difficulty": "ffffffc000000000",
        "multiplier": "1.0" // overrides difficulty
    }

    Response:

    {
        "valid_all": "1",
        "valid_receive": "1",
        "difficulty": "ffffffd21c3933f4",
        "multiplier": "1.3946469"
    }
  • work_cancel example:

    {
        "action": "work_cancel",
        "hash": "718CC2121C3E641059BC1C2CFC45666C99E8AE922F7A807B7D07B62C995D79E2"
    }

    Response:

    {
    }

Benchmarking

Example request:

{
    "action": "benchmark",
    "count": "10"
}

Note use a sufficiently high count as work generation is a random process.

Example response:

{
    "average": "481",
    "count": "10",
    "difficulty": "fffffff800000000",
    "duration": "4813",
    "hint": "Times in milliseconds",
    "multiplier": "1"
}

Status

Example request:

{
    "action": "status"
}

Example response:

{
    "generating": "1",
    "queue_size": "3"
}

Troubleshooting

  • Linux OpenCL AMD GPU series error: thread 'main' panicked at 'Failed to create GPU from string "00:00" - see solution here

About

A dedicated work server for the Nano cryptocurrency

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Rust 88.1%
  • C 11.9%