This miner is for people who want to mine DUCO and want to use docker. Credit for the miner goes to revox, I only moved things around a little bit, to make it work with my flask app setup.
I used flask here to be able to trigger it from only a URL.
Please note this uses the minimal miner which is single thread only
If this has enough support I will move on to a full multi thread miner. This lays the groundwork for that.
-
Make sure you have Docker and Docker Compose installed on your system.
-
Clone this repository with
git clone https://github.com/Alicia426/Dockerized_DUCO_Miner_minimal.git -
Go into the repository's directory.
-
Run
docker-compose up.Ctrl + CCancels it. -
To test, first go to
http://localhost:6969/on your browser, you should see this://\(oo)/\\ Congrats, the server is working! //\(oo)/\\. This server will be exposed on your local network, so you can also access it from other computers,http://<server_ip_here>:6969/. -
To mine, call the URL
http://localhost:6969/<username>/<LowDifficulty>, username is your DUCO account user, LowDifficulty is eitherTrueorFalse, set to True it will mine on a lower difficulty. Examples:http://localhost:6969/mine/Alicia426/True http://localhost:6969/mine/Alicia426/FalsePlease note a minimal message will appear, informing you the mining has started.
-
To stop mining call
http://localhost:6969/stop, this will terminate the Miner process. You will see a simple success message. -
If needed, you can check the logs either through
http://localhost:6969/logsor in the localminer.log file -
To mine with your container in the background use
docker-compose up -d, this will start the container on detached mode.
Note: you may have to run docker-compose with sudo
If you have an error from the Alpine Linux image, you can update to the newest version:
-
Clone this repository with
git clone https://github.com/Alicia426/Dockerized_DUCO_Miner_minimal.git -
Go into the repository's directory.
-
Run
docker-compose up --no-deps --build. This will recreate the image from scratch, building from the official python 3.9 docker image. You can then add the-dflag to run it detached.
If this gets enough traction, I will make a docker friendly version of the multithreaded miner.
Update: I have now added a Miner class which uses multiprocessing to start and stop system processes.
Feature requests are welcome, justping me on the discord or send me a message here.
Basically, I use flask to process http requests, which can then trigger in this case the miner function. I made a tiny module called babylog just to not clutter the code.
This module creates the logfile which can then be read with another URL.
Normally one would deploy Flask ina WSGI server, however, flask has its own WSGI testing server, and since we are not running a large web app and the userbase will be of 1 per container, I see no issue with doing it the quick way.
Flask normally is exposed on port 5000, however to avoid conflicts with other flask apps i am working on, it was assigned to the doubly nice 6969 port. This setting is on the docker-compose.yml file and can be changed to any non reserved port.
This is hacky, not super stylish, I did it in my spare time today and I will update as needed. I know it's janky.
The multiprocessing thing is the first step in dockerizing the big miner.
If y'all want a fancy looking single page application with form fields and starts top buttons, let me know.
This is now release 1.0
- Fixed alpine image error.
- Changed over to Arch Linux Docker image in Dockerfile.
- Migrated the miner to a Class, with start and stop methods.
- Added mining as a process, with the possibility of multithreading.
- Improved error handling.
- Added user friendly messages.
- Elimitated recursion for better stability.
- Finally got some sleep.
- Fixed socket duplication/open connection bug.
- Added error handling/logging for socket.
- Marking this as Release 1.0
MIT License, same as most of DuinoCoin.
If you made it this far, thank you.