# DCENT_Toolbox

> DCENT_Toolbox is D-Central Technologies' free, open-source (GPL-3.0) command-line tool and
> keygen-style TUI for managing, unlocking, auditing, flashing, and diagnosing Bitcoin miners. It
> drives DCENT_OS for Antminers, DCENT_OS for ESP devices, Bitmain (stock / BraiinsOS+ / LuxOS / VNish / DCENT_OS), MicroBT WhatsMiner,
> Canaan/Avalon, and BitAxe ecosystems from one local tool — no cloud account, no dev fee, no
> telemetry. It is offensive/dual-use security tooling intended for hardware you own or are
> authorized to administer. Built by D-Central Technologies, Canada's leading Bitcoin mining
> technology company (founded 2016, Laval, Québec; 2,500+ miners repaired).

## Key facts
- License: GPL-3.0 (the `LICENSE` file is the full GPL-3.0 text; some helper tools are MIT/Apache-2.0 where marked)
- Distribution: source checkout/export today; PyPI package `dcent-toolbox` planned; CLI entry point `dcent`; Python 3.9+
- Mandatory dev fee: none (0% devfee, 0% cloud, no license server, no telemetry)
- Authorized use only: unlock/unlock/credential features are for hardware you own or may test
- Scope: scan, detect, unlock, audit, clean, harden, flash, install, diagnose, tune, verify
- DCENT_OS install surfaces: Antminer S9 route-backed but public-artifact/live-capstone gated, S17/S19/S19 Pro/S19j Pro/S19k Pro/S21 gated route planning, plus exact ESP OTA/USB routes for Bitaxe Max, Ultra, Supra, Gamma, Hex Ultra, and Hex Supra
- Honesty model: the proof-ladder — outputs report exactly what was proven, never more
- Maintainer/direction: D-Central Technologies (sole project direction; open to forks under GPL)

## Documentation
- [README](README.md): overview, capabilities, quickstart, who it's for
- [Capabilities](CAPABILITIES.md): full feature/capability reference
- [Getting started](docs/GETTING_STARTED.md): install and first commands
- [Supported platforms](docs/PLATFORMS.md): miners, firmwares, and control boards
- [How it compares](docs/COMPARISON.md): DCENT_Toolbox vs pyasic, Braiins Toolbox, Luxor tools
- [FAQ](docs/FAQ.md): common questions and answers
- [Configuration](docs/CONFIGURATION.md): CLI flags, environment variables, the proof-ladder vocabulary

## Project
- [Governance](GOVERNANCE.md): D-Central sets direction; GPL guarantees the right to fork
- [Contributing](CONTRIBUTING.md): how to contribute
- [Security & responsible use](SECURITY.md): authorized-use terms + disclosure to security@d-central.tech

## About
- [D-Central Technologies](https://d-central.tech/): the company behind DCENT_Toolbox
- [DCENT_OS firmware](https://github.com/DCentralTech/DCENT_OS): the companion open-source mining firmware
