Skip to main content

Duino-Coin Mining library for Python.

Project description

DUCOlib: A friendly Duino-Coin Python Library.

DUCOlib strives to be the most accesible miner and mining library for Duino-Coin within the Python ecosystem.

Written in pure Python, ducolib lets us implement Duino-Coin mining in an easy and straightforward way.

Installation:

Simply run pip install ducolib.

If you would like to install manually, please clone this repository, then run python setup.py install.

This module has no install dependencies and is made to run with the Python standard library.

Usage:

DUCOlib is friendly for users and developer, it can be imported as any other python module, or used to mine through a simple CLI.

As a library:

Let's start with an example:

import ducolib
import time

# Parameters for constructor:   Username   Diff, Threads, rig name.
workers=ducolib.MinerCrewChief('Alicia426' ,True ,'auto' ,'myrig')

workers.start_mining() # Starts all mining threads.
time.sleep(30) # Mining for 30 seconds
workers.stop_mining() # Stops all threads.

As we can see, the MinerCrewChief class orchestrates all mining, this is done through the Miner class.

As a CLI Miner:

As a miner ducolib takes 1 mandatory argument, the username like so: ducolib Alicia426, any other arguments are optional.

The full list of arguments, in order:

  1. Username - DUCO username, required.
  2. Mining Difficulty - easy for lower difficulty, net for network difficulty. Optional, defaults to Network.
  3. Threads - Number of desired threads, either a number or auto which mines on all threads. Optional, defaults to auto.
  4. Rig name - Mining rig name, Optional, defaults to Ducolib.
  5. Session duration - Mining session length in hours, Optional, defaults to 8 hours.

Some command exammples:

  • ducolib Alicia426 easy auto MyRig 24
  • ducolib Alicia426 net 1

You will not see any console output, that is by design, however the log file ducolib.log should be present in your working directory.

It might look a bit like this:

2021-03-31 00:25:44,839 -> INFO :: Mining DUCO for Alicia426 with Glukhov Miner :)
2021-03-31 00:25:44,839 -> INFO :: Using Lower Mining Difficulty: True. On rig: Yagentci
2021-03-31 00:25:44,839 -> INFO :: No previously running threads, OK!
2021-03-31 00:25:44,845 -> INFO :: Mining Started on Thread 0!
2021-03-31 00:25:44,845 -> INFO :: No previously running threads, OK!
2021-03-31 00:25:44,848 -> INFO :: Mining Started on Thread 1!
2021-03-31 00:25:45,652 -> INFO :: Server is on version: 2.3
2021-03-31 00:25:45,661 -> INFO :: Server is on version: 2.3
2021-03-31 00:26:02,964 -> INFO :: Accepted share: 2948235 Difficulty: 30000
2021-03-31 00:26:02,972 -> INFO :: Accepted share: 2914617 Difficulty: 30000
2021-03-31 00:26:05,652 -> INFO :: Accepted share: 508330 Difficulty: 9583
2021-03-31 00:26:05,702 -> INFO :: Accepted share: 439376 Difficulty: 9585
2021-03-31 00:26:07,553 -> INFO :: Accepted share: 376336 Difficulty: 14300
2021-03-31 00:26:09,142 -> INFO :: Accepted share: 852332 Difficulty: 14430
2021-03-31 00:26:09,602 -> INFO :: Accepted share: 5410 Difficulty: 19445

Changelog:

  • Started project.
  • Tested PyPI packaging.
  • Added way to check in on miners.
  • Built CLI.
  • Filled in documentation.
  • Fixed major disconnect bug.
  • Updated documentation.
  • Added github link for PyPI.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

ducolib-0.0.4.tar.gz (7.2 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

ducolib-0.0.4-py3-none-any.whl (5.9 kB view details)

Uploaded Python 3

File details

Details for the file ducolib-0.0.4.tar.gz.

File metadata

  • Download URL: ducolib-0.0.4.tar.gz
  • Upload date:
  • Size: 7.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.4.1 importlib_metadata/3.8.0 pkginfo/1.7.0 requests/2.22.0 requests-toolbelt/0.8.0 tqdm/4.54.1 CPython/3.8.5

File hashes

Hashes for ducolib-0.0.4.tar.gz
Algorithm Hash digest
SHA256 3ce6986d7a996b16f377aa85a74995f53877a249a0984e262aaf5ce0e34fb913
MD5 d72173fb4b922561f6bba01a2ef9752a
BLAKE2b-256 50a65a17df4448a4db29741e6cbf1e367099f3c47cb3be856954a136290192af

See more details on using hashes here.

File details

Details for the file ducolib-0.0.4-py3-none-any.whl.

File metadata

  • Download URL: ducolib-0.0.4-py3-none-any.whl
  • Upload date:
  • Size: 5.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.4.1 importlib_metadata/3.8.0 pkginfo/1.7.0 requests/2.22.0 requests-toolbelt/0.8.0 tqdm/4.54.1 CPython/3.8.5

File hashes

Hashes for ducolib-0.0.4-py3-none-any.whl
Algorithm Hash digest
SHA256 328499ad671d972bb46fef933d60963dd695762c21c47708a1dc221e8cf94949
MD5 97018711e7ba111c9bee567f482eb5dc
BLAKE2b-256 532e73a8978ebb5f44434462ca7e118f82caa85f37897e9b7bb93df39cbea821

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page