https://github.com/sergeantserk/getworkstratumproxy
A proxy for stratum miners to mine cryptocurrencies on getWork-based servers.
https://github.com/sergeantserk/getworkstratumproxy
bridge cryptocurrency getwork mining proxy stratum tcp
Last synced: over 1 year ago
JSON representation
A proxy for stratum miners to mine cryptocurrencies on getWork-based servers.
- Host: GitHub
- URL: https://github.com/sergeantserk/getworkstratumproxy
- Owner: SergeantSerk
- License: mit
- Created: 2021-11-19T02:45:18.000Z (over 4 years ago)
- Default Branch: main
- Last Pushed: 2025-03-06T12:54:43.000Z (over 1 year ago)
- Last Synced: 2025-03-29T06:11:15.563Z (over 1 year ago)
- Topics: bridge, cryptocurrency, getwork, mining, proxy, stratum, tcp
- Language: C#
- Homepage:
- Size: 120 KB
- Stars: 5
- Watchers: 1
- Forks: 5
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# GetworkStratumProxy
[](https://ci.appveyor.com/project/SergeantSerk/getworkstratumproxy)
[](https://github.com/SergeantSerk/GetworkStratumProxy/actions/workflows/dotnet.yml)
[](https://github.com/SergeantSerk/GetworkStratumProxy/actions/workflows/docker-build-publish.yml)
GetworkStratumProxy (**GSP**) is a "reverse" proxy for stratum miners to mine on getWork-based servers.
**GSP** is specifically for Stratum clients (such as TeamRedMiner, PhoenixMiner or any stratum-capable miner) to getWork-only servers. The motive behind developing this was to use third-party miners to solo mine cryptocurrencies (instead of using ethminer which supported getWork connections).
Currently, **GSP** is tested to work with a private Ethereum network, setup with `puppeth` and mined up to a canonical chain (chain with consensus achieved). Nothing is changed with the jobs sent and received by **GSP**, only that whatever is sent and received to it is relayed to the opposite side. **GSP** has also been used to mine directly on the Callisto mainnet blockchain and successfully proxied the submitted solutions of 14 block validations, using the `ethproxy` proxy mode.
*TeamRedMiner pointed to `stratum+tcp://127.0.0.1:3131` which is **GSP**, **GSP** then relays getWork and submitted jobs to stratum clients and node respectively and then the node verifies submitted works by **GSP**, thus sealing the block.*
# Install
## Requirements
**GSP** is made using C#/.NET 5.0 and .NET SDK is needed to build the solution.
## Source (release)
```
git clone https://github.com/SergeantSerk/GetworkStratumProxy.git
cd GetworkStratumProxy
dotnet build -c Release
cd GetworkStratumProxy.ConsoleApp/bin/Release/net5.0/
dotnet GetworkStratumProxy.ConsoleApp.dll --help
```
## Binaries
Currently, no binaries are built and added to [releases](https://github.com/SergeantSerk/GetworkStratumProxy/releases) yet. As such, you have to clone this repository and build it yourself. See **Source**.
# Usage
Running **GSP** should be fairly straightforward, only ever needing to passing few arguments.
**GSP** currently expects you to pass `--rpc URL` argument, where the URL is a properly constructed URL pointing to a blockchain node that supports `eth_getWork` API, such as `http://127.0.0.1:8545`.
## Example
`dotnet GetworkStratumProxy.ConsoleApp.dll --rpc http://127.0.0.1:8545/ -v`
- It is advised that you use `-v` argument for verbose output for the first run, to see if polling for the server is successful.
`dotnet GetworkStratumProxy.ConsoleApp.dll --rpc http://127.0.0.1:8545/ -v --poll-interval 200`
- You can specify the `--poll-interval` in milliseconds at which **GSP** polls the server for new jobs. The default value should be fine but can be changed to something lower.
# Contribute
Pleae submit any issues when using **GSP** in order to improve it (such as uncaught exceptions, communication issues).
You can contribute to this repository as need be under [licence](LICENSE).
# Donations
Thank you for considering donations, they are always welcome and definitely not necessary.
- `ETH`: `0x6Ce7022F469646F2C5B8eD8c659338CB53F42863`
- `CLO`: `0x6Ce7022F469646F2C5B8eD8c659338CB53F42863`
- `XLM`: `GD3ZLSKYOP3TKUSHBJEFZAJK53GIZQFZUXQYQENAY62QAILHOM75RH7C`
- `ZIL`: `zil12tdr86qjhzj002kmthgwssjndru9cunm75ane5`