PyEthOS
|Build Status| |Licence| |Coverage Status| |PyPI version| |PyPI Lib
Format| |PyPI Python Version| |PyPI Status|
Python 2 and 3 interface to the EthOS custom Dashboard API
This library provides a pure Python interface to the EthOS Custom
Dashboard REST APIs.
Maintainer
Github Profile: Jonathan Dekhtiar <https://github.com/DEKHTIARJonathan>
__\ Email:
contact@jonathandekhtiar.eu
Documentation is available here:
https://dekhtiarjonathan.github.io/pyEthOS/
Installation
The library is available with PIP:
.. code:: shell
pip install pyEthOS
If prefered, the library can be compiled with following commands:
.. code:: shell
## First clone the repository
git clone https://github.com/DEKHTIARJonathan/pyEthOS.git
## Then install the library
python setup.py install
Docuementation
- EthOS API Documentation
.. code:: python
import pyEthOS.pyEthOS as ethos
if __name__ == '__main__':
PANEL_NAME = "ethos1"
DEBUG = False # Allow development debug infos to be printed on the console
api = ethos.EthOS_API(PANEL_NAME, debug=DEBUG)
print (api.get_summary())
'''
{
"success": "True",
"timestamp": "2017-06-12 12:51:15",
"payload": {
"rigs": {
"######": {
"condition": "######",
"version": "######",
"miner": "######",
"gpus": "######",
"miner_instance": "######",
"miner_hashes": "######",
"bioses": "######",
"meminfo": "######",
"vramsize": "######",
"drive_name": "######",
"mobo": "######",
"lan_chip": "R######",
"connected_displays": "",
"ram": "######",
"rack_loc": "######",
"ip": "######",
"driver": "######",
"server_time": 0,
"uptime": "######",
"miner_secs": 0,
"rx_kbps": "######",
"tx_kbps": "######",
"load": "######",
"cpu_temp": "######",
"freespace": 0,
"hash": 0,
"pool": "######",
"temp": "######",
"powertune": "######",
"fanrpm": "######",
"core": "######",
"mem": "######"
}
},
"total_hash": 0,
"alive_gpus": 0,
"total_gpus": 0,
"alive_rigs": 0,
"total_rigs": 0,
"current_version": "######",
"avg_temp": 0,
"capacity": "######",
"per_info": {
"claymore": {
"hash": 0,
"per_alive_gpus": 0,
"per_total_gpus": 0,
"per_alive_rigs": 0,
"per_total_rigs": 0,
"per_hash-gpu": "######",
"per_hash-rig": "######"
}
}
}
}
'''
print(api.get_rig_status())
'''
{
"success": "True",
"timestamp": "2017-06-12 12:51:15",
"payload": {
"######": "unreachable",
"######": "mining",
"######": "mining",
"######": "unreachable",
}
}
'''
print(api.get_rig_ids())
'''
{
"success": True,
"rig_ids": [
"######",
"######",
"######"
],
"timestamp": "2017-06-12 12:54:15"
}
'''
#####################
# Available routes:
######################
# ethos.ETHOS_API_GRAPH_DATA_ROUTES.RX_KBPS
# ethos.ETHOS_API_GRAPH_DATA_ROUTES.TX_KBPS
# ethos.ETHOS_API_GRAPH_DATA_ROUTES.SYSLOAD
# ethos.ETHOS_API_GRAPH_DATA_ROUTES.CPU_LOAD
# ethos.ETHOS_API_GRAPH_DATA_ROUTES.HASHRATE
# ethos.ETHOS_API_GRAPH_DATA_ROUTES.GPU_CORECLOCK
# ethos.ETHOS_API_GRAPH_DATA_ROUTES.GPU_MEMCLOCK
# ethos.ETHOS_API_GRAPH_DATA_ROUTES.GPU_FANRPM
# ethos.ETHOS_API_GRAPH_DATA_ROUTES.GPU_TEMP
# ethos.ETHOS_API_GRAPH_DATA_ROUTES.GPU_HASHRATE
print(api.get_graph_data(ethos.ETHOS_API_GRAPH_DATA_ROUTES.SYSLOAD, "e057d6"))
'''
{
"success": True,
"payload": {
"e057d6 sysload": [
"1494859237000 0.30",
"1494859529000 0.30",
"1494859835000 0.27",
"1494860134000 0.27",
"1494860439000 0.28"
]
},
"timestamp": "2017-06-12 13:37:22"
}
'''
2. Blockchain API Documentation
.. code:: python
import pyEthOS.pyEthOS as ethos
if __name__ == '__main__':
wallet_addr = "eb090e55b3d0cb2544d5b4fb6f485845068bd932" # The API is able to handle address with the prefix "0x" or no prefix.
DEBUG = False # Allow development debug infos to be printed on the console
api = ethos.Blockchain_ETH_API(wallet_addr, debug=DEBUG)
print(api.get_account_balance())
'''
{
"payload": {
"balance": 0,
"final_balance": 0,
"total_sent": 0,
"address": "260e285b113b8be32a5141c35d18257792c757db",
"total_received": 0,
"final_n_tx": 0,
"n_tx": 0,
"unconfirmed_balance": 0,
"unconfirmed_n_tx": 0
},
"timestamp": "2017-06-12 15:51:15",
"success": "True"
}
'''
3. Ethermine Pool API Documentation
.. code:: python
import pyEthOS.pyEthOS as ethos
if __name__ == '__main__':
wallet_addr = "eb090e55b3d0cb2544d5b4fb6f485845068bd932" # The API is able to handle address with the prefix "0x" or no prefix.
DEBUG = False # Allow development debug infos to be printed on the console
api = ethos.Ethermine_ETH_API(wallet_addr, debug=True)
print(api.get_account_stats())
'''
{
"payload": {
"btcPerMin": 0,
"reportedHashRate": "0H/s",
"avgHashrate": 0,
"hashRate": "0H/s",
"rounds": [],
"ethPerMin": 0,
"payouts": [],
"address": "260e285b113b8be32a5141c35d18257792c757db",
"usdPerMin": 0,
"workers": {},
"unpaid": 0,
"settings": {
"monitor": 0,
"vote": 0,
"voteip": "",
"name": "",
"minPayout": 1,
"email": "",
"ip": ""
}
},
"timestamp": "2017-06-12 15:44:56",
"success": "True"
}
'''
Disclaimer
----------
This Python Package is not affiliated with EthOS distribution available
on `ethosdistro.com <http://ethosdistro.com/>`__.
The Author expressly disclaims any warranty for this product, including
all descriptions, documentation, and on-line documentation. This
Software is provided 'AS IS' without warranty of any kind, including
without limitation, any implied warranties of fitness for a particular
purpose or result. You agree to assume the entire risk for any damage or
result arising from its download, installation and use, including the
license process. In no event will the Author (or his agents and/or
associates) be liable to you for any incidental or consequential damages
or losses whatsoever, including without limitation, damage to data,
property or profits, arising from any use, or from any inability to use
said Software.
.. |Build Status| image:: https://travis-ci.org/DEKHTIARJonathan/pyEthOS.svg?branch=master
:target: https://travis-ci.org/DEKHTIARJonathan/pyEthOS
.. |Licence| image:: https://img.shields.io/pypi/l/pyEthOS.svg
:target: https://github.com/DEKHTIARJonathan/pyEthOS/blob/master/LICENSE
.. |Coverage Status| image:: https://coveralls.io/repos/github/DEKHTIARJonathan/pyEthOS/badge.svg?branch=master
:target: https://coveralls.io/github/DEKHTIARJonathan/pyEthOS?branch=master
.. |PyPI version| image:: https://badge.fury.io/py/pyEthOS.svg
:target: https://pypi.python.org/pypi/pyEthOS/
.. |PyPI Lib Format| image:: https://img.shields.io/pypi/format/pyEthOS.svg
:target: https://pypi.python.org/pypi/pyEthOS/
.. |PyPI Python Version| image:: https://img.shields.io/pypi/pyversions/pyEthOS.svg
:target: https://pypi.python.org/pypi/pyEthOS/
.. |PyPI Status| image:: https://img.shields.io/pypi/status/pyEthOS.svg
:target: https://pypi.python.org/pypi/pyEthOS/