From ac6915443c1725fafe853f91bec00e0a7013f46b Mon Sep 17 00:00:00 2001
From: SCHAUAUS GmbH <2+schauausgmbh@noreply.aaskablackwolf.servehttp.com>
Date: Wed, 9 Sep 2026 09:55:30 +0000
Subject: [PATCH] Initial version of the firmware and tables

- Initial version of the firmware
- table for creating hexadecimal values with a 20 sided die
- table to note down encryption key and encrypted data to print on an A4 sheet in landscape format (including a cutting line to separate the data from the key)
---
 AES256_Seed_Phrase_encryptor.ino | 208 +++++++++++++++++++++++++++++++
 D20_table.ods                    | Bin 0 -> 12242 bytes
 2 files changed, 208 insertions(+)
 create mode 100644 AES256_Seed_Phrase_encryptor.ino
 create mode 100644 D20_table.ods

diff --git a/AES256_Seed_Phrase_encryptor.ino b/AES256_Seed_Phrase_encryptor.ino
new file mode 100644
index 0000000..9bc8d97
--- /dev/null
+++ b/AES256_Seed_Phrase_encryptor.ino
@@ -0,0 +1,208 @@
+/*
+ * Copyright (C) 2026 SCHAUAUS GmbH
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a
+ * copy of this software and associated documentation files (the "Software"),
+ * to deal in the Software without restriction, including without limitation
+ * the rights to use, copy, modify, merge, publish, distribute, sublicense,
+ * and/or sell copies of the Software, and to permit persons to whom the
+ * Software is furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included
+ * in all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
+ * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+ * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
+ * DEALINGS IN THE SOFTWARE.
+ */
+
+#include <Crypto.h>
+#include <AES.h>
+#include <string.h>
+
+#define MAX_INPUT_LENGHT 256
+
+//creating an object of AES256 class
+AES256_ESP aes256;
+
+void printHelp () {
+  Serial.println();
+  Serial.println("┌-----------------------------------------------------┐");
+  Serial.println("| Encrypt / Decrypt seed phrase with AES256 algorithm |");
+  Serial.println("└-----------------------------------------------------┘");
+  Serial.println();
+  Serial.println("WARNING: DO NOT USE THIS ON ANY NETWORK CONNECTED DEVICE AND ENSURE THE DECRYPTION IS WORKING PROPERLY!");
+  Serial.println("USE IN SECURE ENVIRONMENTS ONLY!");
+  Serial.println("This program is offered as it is and no warranties will be granted in any case!");
+  Serial.println("Review the source code thoroughly before using it for real application!");
+  Serial.println("Available commands:");
+  Serial.println("help                                      - print this help to serial console");
+  Serial.println("key                                       - generate random HEX key and print it to the serial console");
+  Serial.println("key <your 32byte key>                     - set key (hexadecimal or ascii) for encryption / decryption");
+  Serial.println("encrypt <12 or 24 word seed phrase>       - encrypts your 12 ord 24 word plain text seed phrase to HEX string");
+  Serial.println("decrypt <encrypted HEX string>            - decrypts your encrypted HEX string back to clear text seed phrase");
+  Serial.println("clear                                     - clear all cryptographic information from memory");
+  Serial.println("restart                                   - reboot the device for a fresh restart; any working data will be removed from memory");
+}
+
+void setCryptKey (String argKey) {
+  Serial.println();
+  Serial.println("Operation: setting encryption key");
+  argKey.trim();
+  String tempKey = argKey;
+  byte cryptKey[32];
+
+  tempKey.replace(" ", ""); // remove any spaces in between characters to check for hexadecimal values
+
+  if(argKey.length() != 32 && tempKey.length() / 2 != 32) { // there was no valid key given; keys need to consist of 32 characters (256bit)
+    Serial.println("No valid key handed over; generating new key:");
+    for(int i=0; i < 32; i++) {
+      cryptKey[i] = random(256);
+    }
+    for(size_t i=0; i<32; i++) {
+      if(cryptKey[i] < 16) Serial.print("0");
+      Serial.print(cryptKey[i], HEX);
+      Serial.print(" ");
+    }
+    Serial.println();
+  }
+  else { // process valid key provided
+    Serial.println("Valid key detected");
+
+    bool keyIsHex = true;
+    for(size_t i = 0; i < tempKey.length(); i++)
+      if ( !(tempKey[i] >= '0' && tempKey[i] <= '9') &&
+           !(tempKey[i] >= 'a' && tempKey[i] <= 'f') &&
+           !(tempKey[i] >= 'A' && tempKey[i] <= 'F') )
+             keyIsHex = false;
+
+    if (keyIsHex) { // input key is hexadecimal representation
+      String byteString = "";
+      for(size_t idx = 0; idx < tempKey.length(); idx += 2) {
+        byteString = tempKey.substring(idx, idx+2);
+        long byteValue = strtol(byteString.c_str(), NULL, 16);
+        cryptKey[idx / 2] = (byte)byteValue;
+      }
+    }
+    else { // input key is ASCII-representation
+      for(size_t i=0; i<32; i++) {
+        cryptKey[i] = argKey[i];
+      }
+    }
+  }
+  // set the final key for encryption / decryption
+  aes256.setKey(cryptKey, 32);
+  Serial.println("Key set for encryption / decryption");
+}
+
+void decryptData (String data) {
+  Serial.println();
+  Serial.println("Operation: decrypting data");
+
+  data.replace(" ", "");
+  byte dataBlock[aes256.blockSize()];
+  byte plainText[aes256.blockSize()];
+  String byteString = "";
+
+  // check whether the input data is a hexadecimal string
+  bool dataIsHex = true;
+  for(size_t i = 0; i < data.length(); i++)
+    if ( !(data[i] >= '0' && data[i] <= '9') &&
+          !(data[i] >= 'a' && data[i] <= 'f') &&
+          !(data[i] >= 'A' && data[i] <= 'F') )
+            dataIsHex = false;
+
+  if(!dataIsHex) {
+    Serial.println("Abort decryption! No valid input data!");
+    return;
+  }
+
+  Serial.println("decrypted data block: ");
+  for(int i=0; i < data.length(); i += aes256.blockSize() * 2) {
+    for(int j=0; j<aes256.blockSize() * 2; j+=2) {
+          byteString = data.substring(i + j, i + j + 2);
+          long byteValue = strtol(byteString.c_str(), NULL, 16);
+          dataBlock[j / 2] = (byte)byteValue;
+    }
+    aes256.decryptBlock(plainText, dataBlock);
+    for(int i=0; i<sizeof(plainText); i++){
+      if(plainText[i] == '\0') break;
+      Serial.write(plainText[i]);
+    }
+  }
+  Serial.println();
+}
+
+void encryptData (String data) {
+  Serial.println();
+  Serial.println("Operation: encrypting data");
+
+  byte dataBlock[aes256.blockSize()];
+  byte cypher[aes256.blockSize()];
+
+  Serial.println("encrypted data block: ");
+  for(int i=0; i<data.length(); i+=aes256.blockSize()) {
+    for(int j=0; j<aes256.blockSize(); j++) {
+      dataBlock[j] = data[i + j];
+      if((i + j) > data.length()) dataBlock[j] = '\0';
+    }
+    aes256.encryptBlock(cypher, dataBlock);
+    for(int j=0; j<sizeof(cypher); j++) {
+      if(cypher[j] < 16) Serial.print("0");
+      Serial.print(cypher[j], HEX);
+      Serial.print(" ");
+    }
+  }
+  Serial.println();
+}
+
+void clearCryptograficInformation () {
+  Serial.println();
+  Serial.println("Operation: clear all cryptographic information from memory");
+  aes256.clear();
+  Serial.println("Memory cleared");
+}
+
+void restartDevice () {
+    Serial.println("\r\nInitiating reboot of this device!\r\n");
+    ESP.restart();
+}
+
+void readCmd () {
+  Serial.println();
+  Serial.println("Waiting for command (send \"help\" for available commands)");
+  while (Serial.available() == 0) {} // wait until input on the serial console is available
+  String inp = Serial.readString();
+  inp.trim();
+  String cmd = "";
+  String arg = "";
+
+  if(inp.indexOf(' ') > 0) {
+    cmd = inp.substring(0, inp.indexOf(' '));
+    arg = inp.substring(inp.indexOf(' ') + 1);
+    arg.trim();
+  }
+  else
+    cmd = inp;
+
+  if (cmd == "help") printHelp();
+  else if(cmd == "key") setCryptKey(arg);
+  else if (cmd == "encrypt") encryptData(arg);
+  else if (cmd == "decrypt") decryptData(arg);
+  else if (cmd == "clear") clearCryptograficInformation();
+  else if (cmd == "restart") restartDevice();
+  else Serial.println("\r\nUnknown command! Try again!");
+}
+
+void setup() {
+  Serial.begin(115200);
+  printHelp();
+}
+
+void loop() {
+  readCmd();
+}
diff --git a/D20_table.ods b/D20_table.ods
new file mode 100644
index 0000000000000000000000000000000000000000..8ca087ace2c22c7e23f4670dd242aee000cf317c
GIT binary patch
literal 12242
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
ZA9PDa0SWofYiO_^2|NIh&-Ulv{{a7sVAB8q

literal 0
HcmV?d00001