How 256foundation/asic-rs works
asic-rs is an asynchronous ASIC-miner discovery, telemetry, and control library with Rust, Python, and Go APIs. Its principal workflow is to scan or query an address, identify a miner implementation, then gather a telemetry snapshot or perform supported controls using shared data and configuration concepts. Firmware-specific adapters cover vendor protocols and version differences; language bindings expose the shared API. The workflow and binding relationships are documented in the README; unsampled adapter internals and runtime wiring are represented only at subsystem level.
Main entry points: factory.rs Miner factory · miner.rs Miner interface · asic-rs-ffi/src C ABI · pyasic-rs/src Python API
Components 18
Discovery and API
- Miner factory
src/factory.rs - Miner listener
src/listener.rs
Shared Models
- Network discovery
asic-rs-core/src/discovery.rs - Miner interface
asic-rs-core/src/traits/miner.rs - Telemetry models
asic-rs-core/src/data - Control configs
asic-rs-core/src/config
Firmware Adapters
- Antminer adapters
asic-rs-firmwares/antminer/src/backends/v2023_07 - Auradine adapter
asic-rs-firmwares/auradine/src/backends/v1 - Braiins adapters
asic-rs-firmwares/braiins/src/backends/v26_04 - Epic adapters
asic-rs-firmwares/epic/src/backends - Elphapex adapter
asic-rs-firmwares/elphapex/src/firmware.rs - Vnish adapters
asic-rs-firmwares/vnish/src/backends/v1_3_0 - Whatsminer adapters
asic-rs-firmwares/whatsminer/src/backends/v2 - Other vendor adapters
asic-rs-firmwares
Language Bindings
- Python API
python/pyasic-rs/src - Go API
go/asic_go - C ABI
c/asic-rs-ffi/src
Other components
- Library caller
Connections 17
- Library caller → Miner factory: requests miner
- Miner factory → Network discovery: scans network
- Miner factory → Miner interface: constructs handle
- Miner factory → Antminer adapters: selects implementation
- Miner factory → Auradine adapter: selects implementation
- Miner factory → Braiins adapters: selects implementation
- Miner factory → Epic adapters: selects implementation
- Miner factory → Elphapex adapter: selects implementation
- Miner factory → Vnish adapters: selects implementation
- Miner factory → Whatsminer adapters: selects implementation
- Miner factory → Other vendor adapters: selects implementation
- Miner interface → Telemetry models: returns snapshot
- Miner interface → Control configs: accepts controls
- Library caller → Miner listener: streams results
- Python API → Miner factory: exposes API
- Go API → C ABI: wraps ABI
- C ABI → Miner factory: exposes Rust API