From e70a13abe6b6080a15a236178e895e00bd5bb7f9 Mon Sep 17 00:00:00 2001
From: jamaal <jamaal@sustainhash.com>
Date: Thu, 19 Feb 2026 12:33:38 -0800
Subject: [PATCH] feat: add error mapping functionality for BTMinerV3

---
 pyasic/miners/backends/btminer.py             | 38 +++++++++++++++
 .../btminer_tests/test_v3_error_mapping.py    | 48 +++++++++++++++++++
 2 files changed, 86 insertions(+)
 create mode 100644 tests/miners_tests/backends_tests/btminer_tests/test_v3_error_mapping.py

diff --git a/pyasic/miners/backends/btminer.py b/pyasic/miners/backends/btminer.py
index b78fd195..9e955ae4 100644
--- a/pyasic/miners/backends/btminer.py
+++ b/pyasic/miners/backends/btminer.py
@@ -858,6 +858,10 @@ async def upgrade_firmware(
         str(DataOptions.FAN_PSU): DataFunction(
             "_get_psu_fans", [RPCAPICommand("rpc_get_device_info", "get.device.info")]
         ),
+        str(DataOptions.ERRORS): DataFunction(
+            "_get_errors",
+            [RPCAPICommand("rpc_get_device_info", "get.device.info")],
+        ),
         str(DataOptions.HASHBOARDS): DataFunction(
             "_get_hashboards",
             [
@@ -1133,6 +1137,40 @@ async def _get_psu_fans(self, rpc_get_device_info: dict | None = None) -> list[F
         rpm = rpc_get_device_info.get("msg", {}).get("power", {}).get("fanspeed")
         return [Fan(speed=rpm)] if rpm is not None else []
 
+    async def _get_errors(
+        self, rpc_get_device_info: dict | None = None
+    ) -> list[MinerErrorData]:
+        if rpc_get_device_info is None:
+            try:
+                rpc_get_device_info = await self.rpc.get_device_info()
+            except APIError:
+                return []
+
+        if rpc_get_device_info is None:
+            return []
+
+        raw_errors = rpc_get_device_info.get("msg", {}).get("error-code", [])
+        if not isinstance(raw_errors, list):
+            return []
+
+        parsed_codes: list[int] = []
+        for item in raw_errors:
+            if isinstance(item, dict):
+                for key in item.keys():
+                    if str(key).lower() == "reason":
+                        continue
+                    try:
+                        parsed_codes.append(int(key))
+                    except (TypeError, ValueError):
+                        continue
+            else:
+                try:
+                    parsed_codes.append(int(item))
+                except (TypeError, ValueError):
+                    continue
+
+        return [WhatsminerError(error_code=code) for code in sorted(set(parsed_codes))]
+
     async def _get_serial_number(
         self, rpc_get_device_info: dict | None = None
     ) -> str | None:
diff --git a/tests/miners_tests/backends_tests/btminer_tests/test_v3_error_mapping.py b/tests/miners_tests/backends_tests/btminer_tests/test_v3_error_mapping.py
new file mode 100644
index 00000000..0636251e
--- /dev/null
+++ b/tests/miners_tests/backends_tests/btminer_tests/test_v3_error_mapping.py
@@ -0,0 +1,48 @@
+import unittest
+from unittest.mock import AsyncMock
+
+from pyasic.errors import APIError
+from pyasic.miners.backends.btminer import BTMinerV3
+
+
+class TestBTMinerV3ErrorMapping(unittest.IsolatedAsyncioTestCase):
+    def setUp(self):
+        self.miner = BTMinerV3(ip="10.1.10.24")
+
+    async def test_get_errors_maps_device_info_codes(self):
+        rpc_get_device_info = {
+            "msg": {
+                "error-code": [
+                    "2010",
+                    541,
+                    {"541": "Slot 1 error reading chip id.", "reason": "hashboard"},
+                    {"5032": "Slot 2 voltage abnormal"},
+                    "not-a-code",
+                    None,
+                ]
+            }
+        }
+
+        errors = await self.miner._get_errors(rpc_get_device_info=rpc_get_device_info)
+        codes = [error.error_code for error in errors]
+
+        self.assertEqual(codes, [541, 2010, 5032])
+
+    async def test_get_errors_ignores_non_list_error_code_payload(self):
+        rpc_get_device_info = {"msg": {"error-code": "btminer process is down err"}}
+
+        errors = await self.miner._get_errors(rpc_get_device_info=rpc_get_device_info)
+
+        self.assertEqual(errors, [])
+
+    async def test_get_errors_returns_empty_on_rpc_api_error(self):
+        self.miner.rpc = AsyncMock()
+        self.miner.rpc.get_device_info = AsyncMock(side_effect=APIError("rpc failed"))
+
+        errors = await self.miner._get_errors()
+
+        self.assertEqual(errors, [])
+
+
+if __name__ == "__main__":
+    unittest.main()