This package provides a RESTful HTTP wrapper around the cgminer API. Cgminer has a somewhat esoteric API, which isn't easy to use with standard HTTP-based tooling. Using this tool, it's easy to interact with cgminer programmatically or using a UI, such as through a web browser.
The package can be installed from crates.io using the cargo tool:
$ cargo install cgminer-rest
...
$ cgminer-restSee Rocket.toml for configuration details. Instructions on using Rocket.toml can be found here.
Note: currently you must be running nightly rust. It is recommended that you use rustup to manage your rust installation.
🛰 Mounting /:
=> GET /version (version)
=> GET /config (config)
=> GET /summary (summary)
=> GET /devs (devs)
=> GET /devdetails (devdetails)
=> GET /stats (stats)
=> GET /coin (coin)
=> GET /usbstats (usbstats)
=> GET /lcd (lcd)
=> GET /notify (notify)
=> GET /privileged (privileged)
=> PUT /restart (restart)
=> PUT /check/<command> (check)
=> PUT /debug (debug)
=> PUT /hotplug (hotplug)
=> GET /lockstats (lockstats)
=> PUT /zero (zero)
🛰 Mounting /pools:
=> GET /pools (pools)
=> PUT /pools/<id>/switchto (switchpool)
=> PUT /pools/<id>/enable (enablepool)
=> PUT /pools/<id>/disable (disablepool)
=> POST /pools (addpool)
=> DELETE /pools/<id> (removepool)
=> PUT /pools/<id>/quota (poolquota)
🛰 Mounting /pga:
=> GET /pga/<id> (pga)
=> GET /pga/count (pgacount)
=> PUT /pga/<id>/enable (pgaenable)
=> PUT /pga/<id>/disable (pgadisable)
=> GET /pga/<id>/identify (pgaidentify)
=> PUT /pga/<id> (pgaset)
🛰 Mounting /asc:
=> GET /asc/<id> (asc)
=> GET /asc/count (asccount)
=> PUT /asc/<id>/enable (ascenable)
=> PUT /asc/<id>/disable (ascdisable)
=> GET /asc/<id>/identify (ascidentify)
=> PUT /asc/<id> (ascset)
The goal of this project is to create a high quality API for working with cgminer-based ASICs, in order to enable development of better tooling for Bitcoin mining (such as dragon-rest and mother-of-dragons).
If ASIC vendors adopt one canonical API for mining hardware, it will become much easier to build tooling that works well with many different types of mining hardware. Nearly all ASIC vendors already use cgminer underneath, however the cgminer API is esoteric and somewhat difficult to work with compared to HTTP.
![dependabot-preview[bot] avatar](https://avatars.githubusercontent.com/in/2141?v=4 "dependabot-preview[bot]")
![dependabot[bot] avatar](https://avatars.githubusercontent.com/in/29110?v=4 "dependabot[bot]")
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent