Error Codes

his documentation helps miners understand the different types of errors they may encounter when running the Useless Brick miner firmware. Each error is explained with its meaning and potential steps to resolve the issue.

1. Failed to Seed RNG

• Message: "Failed to seed RNG: [Error Description]"

• Cause: The random number generator (RNG) initialization failed, likely due to an issue with entropy collection.

• Solution: Restart the miner. If the issue persists, ensure that the hardware is functioning correctly and retry.

2. WiFi Credentials Not Found

• Message: "No WiFi credentials found in NVS"

• Cause: The miner was unable to retrieve saved WiFi credentials from non-volatile storage (NVS).

• Solution: Enter AP mode by resetting the miner. Connect to the miner's WiFi hotspot and provide valid credentials via the web interface.

3. WiFi Connection Failed

• Message: "Failed to connect to WiFi after 3 attempts."

• Cause: The miner failed to connect to the provided WiFi network after multiple attempts.

• Solution: Verify that the WiFi credentials are correct, check for network availability, and try again. The miner will restart and attempt to reconnect automatically.

4. Key Pair Generation Failed

• Message: "Failed to generate EC key pair: [Error Description]"

• Cause: There was an issue with generating the key pair needed for secure communication.

• Solution: Restart the miner. If the problem persists, it may be a hardware issue or a software bug that requires updating the firmware.

5. Private Key Parsing Failed

• Message: "Failed to parse private key: [Error Description]"

• Cause: The miner was unable to load the saved private key from memory, possibly due to data corruption.

• Solution: The miner will attempt to generate a new key pair. If errors continue, try to reset the miner's memory and reconfigure.

6. Failed to Obtain Time

• Message: "Failed to obtain time after multiple attempts."

• Cause: The miner failed to synchronize with the network time protocol (NTP) server.

• Solution: Ensure that the WiFi network is operational and that the NTP servers are reachable. The miner will attempt to resynchronize periodically.

7. Signing Message Failed

• Message: "Failed to sign message: [Error Description]"

• Cause: An error occurred while attempting to sign a message, potentially due to an issue with the private key or insufficient entropy.

• Solution: Restart the miner. If the issue persists, verify that the key pair is correctly loaded.

8. Failed to Reach Server

• Message: "Failed to reach the server. Error code: [HTTP Error Code]"

• Cause: The miner could not communicate with the server, possibly due to network issues or server downtime.

• Solution: Check the internet connection. If the server is down, the miner will retry periodically.

9. Failed to Parse Server Response

• Message: "Failed to parse server response: [Error Description]"

• Cause: The response from the server was not in the expected format, potentially due to a server-side issue.

• Solution: No immediate action is required from the miner. The server might be experiencing issues and should be checked by the administrator.

10. AP Mode Timeout

• Message: "AP mode disabled after 10 minutes."

• Cause: The miner was in Access Point mode for configuration, but no action was taken within the allowed time frame.

• Solution: Restart the miner to re-enable AP mode if configuration is still required.