Home Original page

GitHub - husin2021/duino-coin: α•² Duino-Coin is a coin that can be mined with Arduino and ESP boards.

Duino-Coin is a coin that can be mined with Computers, Raspberry Pis, Arduinos, ESP boards and many more.


Key features Technical specifications
Supported by a large number of platforms πŸ’»
A friendly & growing community πŸ‘₯
Easy to use & exchange πŸ’±
Available everywhere 🌎
Fully original project πŸ†•
Beginner-friendly 😊
Cost-effective πŸ’°
Easy to mine ⛏️
Open-source πŸ“š
 Coin supply: Infinite ♾️ (before December 2020: 350k coins)
Premine: <5k blocks (<500 coins) 😎
Transaction time: Instant ⚑
Decimals: 20 πŸ”’
Ticker: DUCO (α•²)
Algorithms: DUCO-S1, DUCO-S1A (+more planned)
Rewards: supported by Kolka system helping to reward miners fairly ♐

Get started


Official Wallet Official Miners

Official getting started guides for creating an account and setting up miners on variety of devices are available on the official website (or .onion version).

Installing Duino-Coin

The easiest way to get started with Duino-Coin is to download the latest release for your OS.
After downloading, unzip it and launch the desired program.
There are no dependencies required.

If you want to run the programs from source, you may need to install some dependencies. Here's how to do it on debian-based distros:

sudo apt install python3 python3-pip git
git clone https://github.com/revoxhere/duino-coin
cd duino-coin
python3 -m pip install -r requirements.txt

If you are on Windows, download Python 3, then our repository, extract it and open the folder in command prompt. In CMD, type:

py -m pip install -r requirements.txt

After doing this, you are good to go with launching the software (e.g. python3 PC_Miner.py OR py PC_Miner.py).

Community-made software

Other miners known to work with Duino-Coin:

Other tools:

This list will be actively updated. If you want to add software to this list, submit a PR or contact one of the developers.

Contributing

Contributions are what make the open source community such an amazing place to be learn, inspire, and create. Any contributions you make are greatly appreciated.

  • Fork the Project
  • Create your feature branch
  • Commit your changes
  • Make sure everything works as intended
  • Open a pull request

Master server API

To build your own Duino-Coin apps, here's a list of of commands the master server accepts. To start communication however, firstly you need to connect to the server. For now you have two options:

  • TCP connection (recommended) - server IP and port are static: tcp://51.15.127.80:2811
  • Websocket connection (through proxy - may not be available 100% of the time) - server IP and port are static: ws://51.15.127.80:15808

Make sure you don't create more than 24 connections per IP address and don't make more than 24 connections in time shorter than 30 seconds. If you do that, the server may ban your IP for creating too much traffic and being a potential DDoS attacker. If you happen to get banned, wait about 315 seconds to get unbanned automatically.

After connecting, the server will send its version number it's currently on (2.2). At this point you can send LOGI or REGI request to login or register an account or JOB,username to receive job for mining. To login, send LOGI,username,password - replace username and password with credentials. After sucessfull login server will send OK. If login fails, server will send NO,Reason of failed login.

To register, send REGI,username,password,email - again, by replacing the placeholders with the respective data. After sucessful registration, the server will send OK. If the registration fails, the server will send NO,Reason of failed registration.

After loging-in you have access to the following commands:

  • BALA - Server will return balance of current user
  • JOB - Server will return job for mining

    • You can also use JOB,username to mine without loging-in

    • You can ask for a specific mining difficulty: JOB,username,DIFF (if you don't ask for a specific difficulty, you'll get the network diff) where diff is one of the below:

      • AVR - diff 3 - used for official AVR boards mining
      • ESP - diff 75 - used for official ESP boards mining
      • ESP32 - diff 100 - used for official ESP boards mining
      • MEDIUM - diff 30k - used for lower-diff PC mining
      • EXTREME - diff 950k - used for custom high performance miners

    • When sending the mining result, you can pass the hashrate count and the name of the miner along with rig name to display in the API, e.g.6801,250000,My Cool Miner v4.20,House Miner indicates that result 6801 was found, the hashrate was 250000H/s (250kH/s) and the name of the software was "My Cool Miner v4.20" with a rig named "House Miner"

      • If hashrate is not received, server estimates it from time it took to receive share and sets "Is estimated": "True" in the API
      • If software name is not received, server uses "Software": "Unknown" in the API
      • If rig name is not received, server uses "Identifier": "None" in the API
  • SEND,-,recipientUsername,amount - Send funds to someone, the server will return a message about the state of the transaction
  • GTXL,username,num - Get last num of transactions involving username (both deposits and withdrawals)
  • CHGP,oldPassword,newPassword - Change password of current user
  • WRAP,amount,tronAddress - Wrap DUCO on Tron network (wDUCO)
  • wDUCO unwrapping protocol:
    1. Send a Tron transaction with method initiateWithdraw(ducoUsername,amount)
    2. Send a server call UNWRAP,amount,tronAddress

Master server HTML API

You can use one of the following links to get API info from Duino-Coin Server:

C DUCO library

If you want to easily access the Duino-Coin API with your C apps, you can use libduco which is made by @Sarah. @ygboucherk is also working on one wich you can access here duino-coin-C-lib

Python3 DUCO API module

If you want to easily access the Duino-Coin API with your Python3 apps, @connorhess made an official module for that here: duco_api.py and you can find the documentation for it here: README.md

Duino-coin for the AUR

You can get the whole duino-coin bundle now on the AUR - just install it with your favourite AUR Helper (for example using yay):

  1. Install git (if you haven't already)
  1. Clone the yay repo
sudo git clone https://aur.archlinux.org/yay-git.git
cd yay-git
  1. Build the package using the makepkg
  1. Use yay to install AUR package

Have fun mining!

License

Duino-Coin is mostly distributed under the MIT License. See LICENSE file for more information.

Major frameworks used by Duino-Coin:

Officially tested devices


  • Arduino Uno Rev3 (ATmega328p @ 16MHz 5V) - ~170 H/s - Arduino Code & Miner
  • Arduino Pro Mini (ATmega328p @ 16MHz 5V) - ~170 H/s - Arduino Code & Miner
  • NodeMCU (ESP8266 @ 80 MHz) - ~1,15 kH/s - ESP8266 Code
  • NodeMCU (ESP8266 @ 160 MHz) - ~2,15 kH/s - ESP8266 Code
  • ESP32 dual-threaded - ~13 kH/s (6 kH/s (core1) + 7 kH/s (core2)) - Multithreaded ESP32 code

Hashrate Calculators for AVR/ESP8266 platforms are available in the Useful tools branch.

Terms of usage


1. Duino-Coins are earned by miners with a process called mining.
2. Mining is described as using DUCO-S1 algorithm (explained in the Duino-Coin Whitepaper), in which finding a correct result to a mathematical problem gives the miner a reward.
3. Mining can be officially done using CPUs, AVR boards (e.g. Arduino boards), Single-board computers (e.g. Raspberry Pi boards), ESP32/8266 boards with the usage of official miners (other officially allowed miners are described in the upper part of README).
4. Even though Duino-Coin aims to fairly reward all the miners, mining with GPUs, ASICs, FPGAs is not allowed due to obvious reasons.
5. Any users spotted using inappropriate/overpowered hardware can be banned from the network.
6. Banning involves blocking the user from accessing his account and accessing his coins.
7. Only coins earned legally are eligible for the exchange.
8. These terms of usage can change at any time without prior notice and will be expanded in the future.
9. Users using Duino-Coin agree to comply with the above rules.

Developers


Special thanks


Project Link: https://github.com/revoxhere/duino-coin/