https://github.com/veriblock/stratum-veriblock

https://github.com/veriblock/stratum-veriblock

Last synced: 20 days ago
JSON representation

• Host: GitHub
• URL: https://github.com/veriblock/stratum-veriblock
• Owner: VeriBlock
• Created: 2019-06-26T20:26:49.000Z (over 5 years ago)
• Default Branch: master
• Last Pushed: 2022-11-04T19:35:54.000Z (over 2 years ago)
• Last Synced: 2025-01-02T21:36:40.702Z (about 1 month ago)
• Language: Python
• Size: 140 KB
• Stars: 1
• Watchers: 3
• Forks: 1
• Open Issues: 5
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# VeriBlock Stratum Reference Implementation

This reference implementation is derived from slush0's original Stratum work. The original project can be found here:

* https://github.com/slush0/stratum

* https://github.com/slush0/stratum-mining

Modification was made to the stratum project to use Python 3.7, and the stratum-mining project customized to proxy VeriBlock NodeCore's UCP protocol and support the VeriBlock header format and hashing algorithm.

Included in this repository are the Stratum framework, custom VeriBlock Stratum implementation and a reference CPU miner.

## Build - Stratum Server

The Stratum server components are written in Python.

By convention, all references to `{ROOT}` below represent the root folder of the repository.

### Prerequisites

* Python 3.7

* pip

* virtualenv (Recommended)

### Build Steps

1. (Optional) Create and activate a virtual environment

```

$ cd {ROOT}\stratum-server

$ virtualenv -p "C:\Python37\python.exe" venv

$ venv\Scripts\activate

```

2. Install required packages

```

$ pip install -r requirements.txt

```

3. Install Stratum framework package (from source)

```

$ cd {ROOT}\stratum-server\stratum

$ python setup.py install

```

	

4. Install vBlake package (from source)

```

$ cd {ROOT}\stratum-server\vblake

$ python setup.py install

```

## Build - Reference PoW Miner

The reference PoW miner is written in Java.

1. Build with gradlew

```

$ cd {ROOT}\reference-miner

$ gradlew clean installDist

```

The executable script will be found at `{ROOT}\reference-miner\build\install\nodecore-pow\bin`

## Run

1. Start NodeCore. NodeCore should be built and run from the source code feature branch `feature/stratum`

2. Start a **SOLO** mining pool on NodeCore, by issuing the RPC command `startsolopool` via CLI or HTTP API.

3. Run the Stratum server instance

```

	$ cd {ROOT}\stratum-server

	$ twistd -ny launcher.tac

```

4. Run the reference PoW miner. The Stratum server will be running at `127.0.0.1:3333` and should be the value used to connect to in the miner.