{"id":43218928,"url":"https://github.com/matteocrippa/leafminer","last_synced_at":"2026-02-01T08:31:29.656Z","repository":{"id":215357030,"uuid":"728843825","full_name":"matteocrippa/leafminer","owner":"matteocrippa","description":"A FOSS bitcoin miner for ESP8266 and ESP32","archived":false,"fork":false,"pushed_at":"2025-03-15T21:11:41.000Z","size":2206,"stargazers_count":109,"open_issues_count":22,"forks_count":19,"subscribers_count":8,"default_branch":"main","last_synced_at":"2025-03-15T22:20:57.677Z","etag":null,"topics":["bitcoin","btc","esp32","esp8266","miner"],"latest_commit_sha":null,"homepage":"","language":"C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/matteocrippa.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.md","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-12-07T20:21:05.000Z","updated_at":"2025-03-15T21:11:45.000Z","dependencies_parsed_at":"2024-05-02T21:37:08.442Z","dependency_job_id":null,"html_url":"https://github.com/matteocrippa/leafminer","commit_stats":null,"previous_names":["matteocrippa/leafminer"],"tags_count":14,"template":false,"template_full_name":null,"purl":"pkg:github/matteocrippa/leafminer","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/matteocrippa%2Fleafminer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/matteocrippa%2Fleafminer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/matteocrippa%2Fleafminer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/matteocrippa%2Fleafminer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/matteocrippa","download_url":"https://codeload.github.com/matteocrippa/leafminer/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/matteocrippa%2Fleafminer/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28974133,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-01T08:16:14.655Z","status":"ssl_error","status_checked_at":"2026-02-01T08:06:51.373Z","response_time":56,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bitcoin","btc","esp32","esp8266","miner"],"created_at":"2026-02-01T08:31:29.258Z","updated_at":"2026-02-01T08:31:29.615Z","avatar_url":"https://github.com/matteocrippa.png","language":"C","funding_links":[],"categories":[],"sub_categories":[],"readme":"# LeafMiner ☘️⛏️\n\nLeafMiner is a Free and Open Source Software (FOSS) ESP(\\*) device Bitcoin miner.\n\n![LeafMiner Logo](.github/images/leafminer.png)\n\n**Disclaimer:** While the chances of successfully mining a block with LeafMiner are highly unlikely due to the current complexity, the primary goal of this project is to serve as a learning platform for gaining a deeper understanding of how Bitcoin and SHA256 operate.\n\n| ![LeafMiner on Lilygo-T-S3](.github/images/leafminer-lilygots3.png) | ![LeafMiner on GeekMagic Clock Small TV](.github/images/leafminer-geekmagicclock-smalltv.png) |\n| :------------------------------------------------------------------ | :-------------------------------------------------------------------------------------------- |\n| _Lilygo-T-S3_                                                       | _GeekMagic Clock - SmallTV_                                                                   |\n\n## Features\n\n- [x] SHA256 Optimization for 64 + 16 structure (aka Midstate)\n- [x] Double Hash Early Exit\n- [x] Support for ESP32 and ESP8266\n- [x] Mass deploy\n\nThe SHA256 code is based on a tweaked version of [NerdSHA256plus](https://github.com/BitMaker-hub/NerdMiner_v2) by NerdMiner.\n\n## Supported Boards:\n\n| Board             | Status | Expected Hashrate |\n| :---------------- | :----: | :---------------- |\n| ESP8266           |   🟧  | ±16 kH/s          |\n| ESP32             |   🟩   | ±48 kH/s          |\n| ESP32-S2          |   🟩   | ±19 kH/s          |\n| ESP32-S3          |   🟩   | ±80 kH/s          |\n| LILYGO-T-S3       |   🟩   | ±80 kH/s          |\n| SMALLTV (ESP8266) |   🟩   | ±16 kH/s          |\n\n_Legend_\n| Icon | Description |\n| :--- | :-------------- |\n| 🟩 | Fully functional |\n| 🟧 | Partially functional |\n| 🟥 | Not working |\n\n## Mining Method:\n\n- [x] [Solo](docs/solo-mining.md)\n- [ ] [Cascade](docs/cascade-mining.md) (aka 1 Main and N nodes)\n\n# How to Use\n\n## Requirements\n\n- A supported board\n- (optional) VSCode + Platformio.io\n\n## Build \u0026 Install\n\n### Flash Binary\n\n- Download the binary file for your board\n\n| Board                                                    | Link                                                         |\n| :------------------------------------------------------- | :----------------------------------------------------------- |\n| [ESP8266](https://s.click.aliexpress.com/e/_EuwffHJ)     | [0.0.17](https://github.com/matteocrippa/leafminer/releases) |\n| [GeekMagic SmartTV]()                                    | [0.0.17](https://github.com/matteocrippa/leafminer/releases) |\n| [ESP32](https://s.click.aliexpress.com/e/_Ey6AJnT)       | [0.0.17](https://github.com/matteocrippa/leafminer/releases) |\n| [ESP32-S2](https://s.click.aliexpress.com/e/_EGJcibR)    | [0.0.17](https://github.com/matteocrippa/leafminer/releases) |\n| [ESP32-S3](https://s.click.aliexpress.com/e/_EJbAXyl)    | [0.0.17](https://github.com/matteocrippa/leafminer/releases) |\n| [LILYGO-T-S3](https://s.click.aliexpress.com/e/_ExRWk6H) | [0.0.17](https://github.com/matteocrippa/leafminer/releases) |\n\n- Browse to [ESPWebtool](https://esp.huhn.me/) using a Chrome based browser and upload the file according to the address in the file name.\n\nFor example this is how ESP32-S3 will look like:\n\n\u003cimg width=\"687\" alt=\"LeafMiner Web flash\" src=\"https://github.com/matteocrippa/leafminer/assets/475463/f483b8fe-a563-4249-98f8-092a45a9b4f8\"\u003e\n\n### Build from Scratch\n\n- Clone the project\n- Open in Platformio\n- Upload the project to your board\n\n### Quick Start Guide\n\nFollow these steps to set up your ESP32/ESP8266 with LEAFMINER:\n\n1. **Power Up:**\n   Power up your ESP32/ESP8266 device.\n\n2. **Connect to LEAFMINER WiFi:**\n   Connect to the WiFi network named \"LEAFMINER.\"\n\n3. **Access Configuration Page:**\n   Open your web browser and navigate to [http://192.168.4.1](http://192.168.4.1) if the captive portal doesn't appear automatically.\n\n4. **Provide Information and Save:**\n   Fill out the form, click the save button, and then reboot your device.\n\n   We've set _pool.vkbit.com_ as the default solo pool, but feel free to change it to your preference.\n\n**Verification:**\nIf the setup is successful, you'll see your miner in the stats.\n\n### Resetting Setup\n\nIf you need to reset the setup flow:\n\n- **For ESP32:**\n  Unplug the USB cable, press and hold the BOOT button, and then plug in the USB cable.\n\n- **For ESP8266:**\n  Unfortunately, you need to erase the flash and reflash, as there's only a physical button for this.\n\nAfter resetting, rediscover the _LEAFMINER_ WiFi and go through the setup process again.\n\n## Mass Deploy\n\nStarting from version **0.0.6**, we now offer the capability for mass deployment through Platformio. If you need to apply the same configuration to multiple devices, simply modify the `massdeploy.h` file, uncomment the relevant lines, and customize the parameters according to your requirements. This allows you to effortlessly deploy a pre-configured firmware to multiple devices.\n\n## Donate\n\nIf you want to support this project, consider donating:\n\n|                     |                                                  |\n| :------------------ | :----------------------------------------------- |\n| AliExpress Referral | Use referral links in the list of hardware above |\n| ⚡️ Lightning       | `leafminer@lifpay.me`                            |\n| Bitcoin             | `bc1quqr7agnx6e0k9kn8h24zfj5dueeurhzflt3qjg`     |\n\n## Credits\n\nInspired by:\n\n- [HAN](https://github.com/valerio-vaccaro/HAN)\n- [NerdMinerv2](https://github.com/BitMaker-hub/NerdMiner_v2)\n- [Jade](https://github.com/Blockstream/Jade/tree/miner_all_0.1.47/components/miner)\n\nUseful documentation:\n\n- [Solominer](https://github.com/iceland2k14/solominer/blob/main/solo_miner.py)\n- [pyminer.py](https://github.com/jgarzik/pyminer/blob/master/pyminer.py)\n- [Stratum Protocol](https://reference.cash/mining/stratum-protocol)\n- [Stratum Protocol Diagram](https://github.com/aeternity/protocol/blob/master/STRATUM.md)\n- [NBits](https://learnmeabitcoin.com/technical/bits)\n- [Bitcoin Mining](https://www.righto.com/2014/02/bitcoin-mining-hard-way-algorithms.html)\n- [How To Mine](https://gist.github.com/Ending2015a/70373b2f6f665a765b4d0b0c427f052b)\n- [Image Converter 565](http://www.rinkydinkelectronics.com/t_imageconverter565.php)\n- [Lilygo-T-Display-S3](https://github.com/Xinyuan-LilyGO/T-Display-S3/tree/main)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmatteocrippa%2Fleafminer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmatteocrippa%2Fleafminer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmatteocrippa%2Fleafminer/lists"}