whatsminer-api
Unofficial python api for MicroBT Whatsminer ASICs
Code adapted from a python file found in the Whatsminer Telegram group that is credited to @passby
Installation
Python 3.x is required.
pip install whatsminer
Basic Usage
Instantiate a WhatsminerAccessToken for each ASIC that you want to access. Then make read-only or writeable API calls through WhatsminerAPI
Read-only information can be retrieved with just the ASIC's ip address:
from whatsminer import WhatsminerAccessToken, WhatsminerAPI
token = WhatsminerAccessToken(ip_address="192.168.1.100")
summary_json = WhatsminerAPI.get_read_only_info(access_token=token,
cmd="summary")
The writeable API commands can be executed by providing the ASIC's admin password:
# The token from above can be enabled for writeable access:
token.enable_write_access(admin_password="the_admin_password")
# Or you can directly instantiate a writeable one:
token = WhatsminerAccessToken(ip_address="192.168.1.100",
admin_password="the_admin_passwd")
json_response = WhatsminerAPI.exec_command(access_token=token,
cmd="power_off",
additional_params={"respbefore": "true"})
Writeable WhatsminerAccessToken objs will renew themselves if they go past the API's 30min expiration.
Managing multiple ASICs
You could define a whole server farm's worth of Whatsminer ASICs and manage them all in one script:
asics = [
('192.168.1.100', 'some_admin_pass'),
('192.168.1.101', 'some_admin_pass'),
('192.168.1.102', 'some_admin_pass'),
('192.168.1.103', 'some_admin_pass'),
('192.168.1.104', 'some_admin_pass'),
('192.168.1.105', 'some_admin_pass'),
]
tokens = []
for asic_info in asics:
tokens.append(WhatsminerAccessToken(ip_address=asic_info[0], admin_password=asic_info[1]))
# Find machines running too hot
for token in tokens:
json_summary = WhatsminerAPI.get_read_only_info(access_token=token, cmd="summary")
if json_summary['SUMMARY'][0]['Temperature'] > 78.0:
# stop mining on this ASIC
WhatsminerAPI.exec_command(access_token=token, cmd="power_off", additional_params={"respbefore": "true"})
API Documentation
It's very difficult to find any information about the Whatsminer API. This PDF documentation is slightly out of date but is the best source found so far:
Package distribution notes
There are just notes to self for updating the pypi distribution
- Update the release number in
setup.pyand commit to repo. - Draft a new release in github using the same release number.
- Run
python setup.py sdist - Publish the distribution to pypi:
twine upload dist/*
233 Dec 30, 2022
1 Nov 19, 2021
2 Jan 5, 2022
71 Dec 26, 2022
7 Oct 28, 2022
49 Oct 24, 2022
9 Nov 6, 2022
6 Apr 1, 2022
130 Dec 27, 2022
4 Nov 17, 2021
31 Nov 19, 2022
21 Dec 07, 2022
3 Feb 21, 2022
32 Nov 12, 2022
8 Aug 04, 2022
130 May 28, 2022
8 Apr 08, 2022
4 Dec 08, 2021
1 Feb 08, 2022
1 Nov 18, 2021
13 Dec 20, 2021
3 Feb 04, 2022
1 Jan 07, 2022
1 Jan 10, 2022
4 Jul 26, 2022
1 Nov 20, 2021
3 Sep 28, 2022
1 Jan 01, 2022
5 Oct 16, 2022