selfcustody · tadeubas · Nov 27, 2024 · Nov 29, 2024 · Nov 30, 2024 · Nov 30, 2024
diff --git a/.gitignore b/.gitignore
@@ -82,7 +82,8 @@ simulator/flash
 !tests/files/*
 
 # ignore build-release files
-krux-*/ktool*
+ktool-*
+*mpy.sig
 
 # IDE files
 .vscode
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -3,6 +3,11 @@
 ### New Device Support: Embed Fire
 This device shares similarities with the WonderMV but stands out with its larger 2.4" touchscreen.
 
+### Krux apps (Kapps)
+New tool for executing developer-signed utility apps that extend Krux functionality. Includes two initial Kapps: 
+- Nostr: Create or load your key using NIP-06 or NIP-19, and airgap-sign events
+- Steganography: Concel data within BMP image files
+
 ### New Device Support: WonderK PRO
 From the wonderful land of Korea, a new creation arrives: the WonderK PRO. Created by an entrepreneur who loves the Krux project, the WonderK follows in the footsteps of the WonderMV, but boasts a larger 2.8" display! Computer simulator for the WonderK device is also included.
 

diff --git a/docs/getting-started/features/tools.en.md b/docs/getting-started/features/tools.en.md
@@ -3,6 +3,16 @@ Here are some useful tools that are available as soon as Krux starts! These are
 <img src="../../../img/maixpy_amigo/tools-options-300.png" class="amigo">
 <img src="../../../img/maixpy_m5stickv/tools-options-250.png" class="m5stickv">
 
+### Load Krux app
+<img src="../../../img/maixpy_m5stickv/krux-apps-250.png" align="right" class="m5stickv">
+<img src="../../../img/maixpy_amigo/krux-apps-300.png" align="right" class="amigo">
+
+Run developer-signed Krux applications (Kapps) that are not suited to be part of the main firmware. Copy its `.mpy` file and corresponding signature to an SD card to load it onto the device. When executed, the Kapp is stored in the user's flash memory (just like custom settings) and this process modifies the last two words of the [Tamper Detection](tamper-detection.md#tamper-check-flash-hash-tc-flash-hash-a-tamper-detection-tool) (User's Region).
+
+For example, the **Nostr Kapp** allows converting a mnemonic into a Nostr `nsec` key and air-gapped event signing.
+
+<div style="clear: both"></div>
+
 ### Datum Tool
 <img src="../../../img/maixpy_m5stickv/tools-datum-tool-load-250.png" align="right" class="m5stickv">
 <img src="../../../img/maixpy_amigo/tools-datum-tool-load-300.png" align="right" class="amigo">

diff --git a/docs/img/maixpy_amigo/krux-apps-300.en.png b/docs/img/maixpy_amigo/krux-apps-300.en.png
diff --git a/docs/img/maixpy_amigo/tools-options-300.en.png b/docs/img/maixpy_amigo/tools-options-300.en.png
diff --git a/docs/img/maixpy_m5stickv/krux-apps-250.en.png b/docs/img/maixpy_m5stickv/krux-apps-250.en.png
diff --git a/docs/img/maixpy_m5stickv/tools-options-250.en.png b/docs/img/maixpy_m5stickv/tools-options-250.en.png
diff --git a/i18n/i18n.py b/i18n/i18n.py
@@ -19,6 +19,7 @@
 # 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.
+# pylint: disable=invalid-name
 
 import binascii
 import sys

diff --git a/i18n/translations/de-DE.json b/i18n/translations/de-DE.json
@@ -20,7 +20,10 @@
     "Additional entropy from camera required for %s": "Zusätzliche Entropie von der Kamera erforderlich für %s",
     "Address": "Adresse",
     "Align camera and backup plate properly.": "Richte Kamera und Sicherungsplatte richtig aus.",
+    "Allow Krux apps": "Krux-Apps zulassen",
+    "Allow in settings first!": "Erlaube zuerst Einstellungen!",
     "Anti-glare mode": "Blendschutzmodus",
+    "App will be stored internally on flash.": "Die App wird intern auf Flash gespeichert.",
     "Appearance": "Aussehen",
     "Are you sure?": "Bist Du sicher?",
     "BGR Colors": "BGR-Farben",
@@ -93,6 +96,7 @@
     "Erasing user's data…": "Benutzerdaten werden gelöscht…",
     "Error:": "Fehler:",
     "Esc": "Esc",
+    "Execute %s Krux app?": "%s Krux-App ausführen?",
     "Explore files?": "Dateien durchsuchen?",
     "Export Addresses": "Adressen exportieren",
     "Exporting %s to SD card…": "%s wird auf SD-Karte exportiert…",
@@ -151,6 +155,7 @@
     "Line Delay": "Leitungsverzögerung",
     "Line:": "Linie:",
     "List Addresses": "Adressen auflisten",
+    "Load Krux app": "Krux-App laden",
     "Load Mnemonic": "Mnemonic laden",
     "Load Wallet": "Wallet laden",
     "Load a trusted wallet descriptor to view addresses?": "Einen vertrauenswürdigen Wallet-Deskriptor laden, um Adressen anzuzeigen?",
@@ -284,6 +289,7 @@
     "Spend (%d):": "Ausgabe (%d):",
     "Spend:": "Ausgaben:",
     "Standard mode": "Standardmodus",
+    "Startup Kapp": "Startup Kapp",
     "Static": "Statisch",
     "Stats for Nerds": "Statistiken für Nerds",
     "Store on Flash": "Auf Flash speichern",
@@ -316,6 +322,7 @@
     "Type Key": "Schlüssel eingeben",
     "Undo": "Widerrufen",
     "Unit": "Einheit",
+    "Unsigned apps found in flash will be deleted.": "Nicht signierte Apps, die in Flash gefunden wurden, werden gelöscht.",
     "Update KEF ID?": "KEF-ID aktualisieren?",
     "Update QR Label?": "QR-Etikett aktualisieren?",
     "Upgrade complete.": "Upgrade abgeschlossen.",

diff --git a/i18n/translations/es-MX.json b/i18n/translations/es-MX.json
@@ -20,7 +20,10 @@
     "Additional entropy from camera required for %s": "Se requiere entropía adicional de la cámara para %s",
     "Address": "Dirección",
     "Align camera and backup plate properly.": "Alinea la cámara y la placa de respaldo correctamente.",
+    "Allow Krux apps": "Permitir aplicaciones Krux",
+    "Allow in settings first!": "¡Permitir en la configuración primero!",
     "Anti-glare mode": "Modo antirreflejo",
+    "App will be stored internally on flash.": "La aplicación se almacenará internamente en flash.",
     "Appearance": "Apariencia",
     "Are you sure?": "¿Estás seguro?",
     "BGR Colors": "Colores BGR",
@@ -93,6 +96,7 @@
     "Erasing user's data…": "Borrando los datos del usuario…",
     "Error:": "Error:",
     "Esc": "Esc",
+    "Execute %s Krux app?": "¿Ejecutar %s aplicación Krux?",
     "Explore files?": "¿Explorar archivos?",
     "Export Addresses": "Exportar direcciones",
     "Exporting %s to SD card…": "Exportando %s a la tarjeta SD…",
@@ -151,6 +155,7 @@
     "Line Delay": "Retraso de Línea",
     "Line:": "Línea:",
     "List Addresses": "Listar direcciones",
+    "Load Krux app": "Cargar aplicación Krux",
     "Load Mnemonic": "Importar Mnemónico",
     "Load Wallet": "Cargar Cartera",
     "Load a trusted wallet descriptor to view addresses?": "¿Cargar un descriptor de monedero de confianza para ver las direcciones?",
@@ -284,6 +289,7 @@
     "Spend (%d):": "Gastos (%d):",
     "Spend:": "Gasto:",
     "Standard mode": "Modo estándar",
+    "Startup Kapp": "Startup Kapp",
     "Static": "Estático",
     "Stats for Nerds": "Estadísticas para Entendidos",
     "Store on Flash": "Almacenar en Flash",
@@ -316,6 +322,7 @@
     "Type Key": "Introduce la clave",
     "Undo": "Deshacer",
     "Unit": "Unidad",
+    "Unsigned apps found in flash will be deleted.": "Se eliminarán las aplicaciones sin firmar que se encuentren en Flash.",
     "Update KEF ID?": "¿Actualizar ID de Kef?",
     "Update QR Label?": "¿Actualizar etiqueta QR?",
     "Upgrade complete.": "Actualización completa.",

diff --git a/i18n/translations/fr-FR.json b/i18n/translations/fr-FR.json
@@ -20,7 +20,10 @@
     "Additional entropy from camera required for %s": "Entropie supplémentaire de la caméra requise pour %s",
     "Address": "Adresse",
     "Align camera and backup plate properly.": "Alignez correctement la caméra et plaque de sauvegarde.",
+    "Allow Krux apps": "Autoriser les applications Krux",
+    "Allow in settings first!": "Autoriser d'abord dans les paramètres !",
     "Anti-glare mode": "Mode anti-reflets",
+    "App will be stored internally on flash.": "L'application sera stockée en interne sur flash.",
     "Appearance": "Apparence",
     "Are you sure?": "Es-tu sûr ?",
     "BGR Colors": "Couleurs BGR",
@@ -93,6 +96,7 @@
     "Erasing user's data…": "Effacement des données de l'utilisateur…",
     "Error:": "Erreur :",
     "Esc": "Esc",
+    "Execute %s Krux app?": "Exécuter l'application %s Krux ?",
     "Explore files?": "Explorer des fichiers ?",
     "Export Addresses": "Adresses d'exportation",
     "Exporting %s to SD card…": "Exportation de %s vers la carte SD…",
@@ -151,6 +155,7 @@
     "Line Delay": "Délai de Ligne",
     "Line:": "Ligne :",
     "List Addresses": "Listage d'Addresses",
+    "Load Krux app": "Charger l'application Krux",
     "Load Mnemonic": "Charger Mnémonique",
     "Load Wallet": "Charger le portefeuille",
     "Load a trusted wallet descriptor to view addresses?": "Charger un descripteur de portefeuille de confiance pour afficher les adresses ?",
@@ -284,6 +289,7 @@
     "Spend (%d):": "Dépense (%d) :",
     "Spend:": "Dépense :",
     "Standard mode": "Mode standard",
+    "Startup Kapp": "Startup Kapp",
     "Static": "Statique",
     "Stats for Nerds": "Statistiques pour les geeks",
     "Store on Flash": "Stocker sur flash",
@@ -316,6 +322,7 @@
     "Type Key": "Taper clé",
     "Undo": "Annuler",
     "Unit": "Unité",
+    "Unsigned apps found in flash will be deleted.": "Les applications non signées trouvées dans Flash seront supprimées.",
     "Update KEF ID?": "Mettre à jour l'ID KEF ?",
     "Update QR Label?": "Mettre à jour l'étiquette QR ?",
     "Upgrade complete.": "Mise à jour complète.",

diff --git a/i18n/translations/ja-JP.json b/i18n/translations/ja-JP.json
@@ -20,7 +20,10 @@
     "Additional entropy from camera required for %s": "%sにはカメラからの追加エントロピーが必要です",
     "Address": "アドレス",
     "Align camera and backup plate properly.": "カメラとバックプレートを正しく整列させてください.",
+    "Allow Krux apps": "Kruxアプリを許可する",
+    "Allow in settings first!": "最初に設定で許可してください！",
     "Anti-glare mode": "アンチグレアモード",
+    "App will be stored internally on flash.": "アプリはフラッシュに内部保存されます。",
     "Appearance": "外観",
     "Are you sure?": "よろしいですか?",
     "BGR Colors": "BGRカラー",
@@ -93,6 +96,7 @@
     "Erasing user's data…": "ユーザーのデータを消去しています…",
     "Error:": "エラー:",
     "Esc": "エスク",
+    "Execute %s Krux app?": "%s Kruxアプリを実行しますか？",
     "Explore files?": "アーカイブ探索?",
     "Export Addresses": "住所をエクスポート",
     "Exporting %s to SD card…": "%sをSDカードにエクスポートしています…",
@@ -151,6 +155,7 @@
     "Line Delay": "ライン遅延",
     "Line:": "ライン:",
     "List Addresses": "アドレスリスト",
+    "Load Krux app": "Kruxアプリを読み込む",
     "Load Mnemonic": "ニーモニックをロード",
     "Load Wallet": "ウォレットをロード",
     "Load a trusted wallet descriptor to view addresses?": "信頼できるウォレット記述子をロードしてアドレスを表示しますか?",
@@ -284,6 +289,7 @@
     "Spend (%d):": "支出（%d）:",
     "Spend:": "支出:",
     "Standard mode": "標準モード",
+    "Startup Kapp": "スタートアップKapp",
     "Static": "静止画",
     "Stats for Nerds": "オタクのための統計",
     "Store on Flash": "フラッシュに保存する",
@@ -316,6 +322,7 @@
     "Type Key": "キーを入力する",
     "Undo": "取り消し",
     "Unit": "ユニット",
+    "Unsigned apps found in flash will be deleted.": "Flashで見つかった署名されていないアプリは削除されます。",
     "Update KEF ID?": "KEF IDを更新しますか?",
     "Update QR Label?": "QRラベルを更新しますか?",
     "Upgrade complete.": "アップグレードが完了しました.",

diff --git a/i18n/translations/ko-KR.json b/i18n/translations/ko-KR.json
@@ -20,7 +20,10 @@
     "Additional entropy from camera required for %s": "%s 에 필요한 카메라의 추가 엔트로피",
     "Address": "주소",
     "Align camera and backup plate properly.": "카메라와 보조 플레이트를 올바르게 정렬하십시오.",
+    "Allow Krux apps": "Krux 앱 허용",
+    "Allow in settings first!": "먼저 설정에서 허용하세요!",
     "Anti-glare mode": "눈부심 방지 모드",
+    "App will be stored internally on flash.": "앱은 내부적으로 플래시로 저장됩니다.",
     "Appearance": "디스플레이",
     "Are you sure?": "계속하시겠습니까?",
     "BGR Colors": "BGR 색상",
@@ -93,6 +96,7 @@
     "Erasing user's data…": "사용자 데이터 삭제 중…",
     "Error:": "오류:",
     "Esc": "Esc",
+    "Execute %s Krux app?": "%s KRUX 앱을 실행하시겠습니까?",
     "Explore files?": "파일을 탐색하시겠습니까?",
     "Export Addresses": "주소 내보내기",
     "Exporting %s to SD card…": "%s 을 (를) SD 카드로 내보내는 중…",
@@ -151,6 +155,7 @@
     "Line Delay": "줄 지연",
     "Line:": "줄:",
     "List Addresses": "주소 목록",
+    "Load Krux app": "Krux 앱 로드",
     "Load Mnemonic": "니모닉 불러오기",
     "Load Wallet": "이대로 불러오기",
     "Load a trusted wallet descriptor to view addresses?": "주소를 보기위해 신뢰할 수 있는 월렛 디스크립터를 불러오시겠습니까?",
@@ -284,6 +289,7 @@
     "Spend (%d):": "Spend (%d):",
     "Spend:": "지출:",
     "Standard mode": "표준 모드",
+    "Startup Kapp": "스타트업 Kapp",
     "Static": "Static",
     "Stats for Nerds": "전문가를 위한 통계",
     "Store on Flash": "플래시 메모리에 저장",
@@ -316,9 +322,10 @@
     "Type Key": "비밀번호 입력",
     "Undo": "실행 취소",
     "Unit": "단위",
+    "Unsigned apps found in flash will be deleted.": "플래시에서 찾은 서명되지 않은 앱은 삭제됩니다.",
     "Update KEF ID?": "KEF ID를 업데이트하시겠습니까?",
     "Update QR Label?": "QR 레이블을 업데이트하시겠습니까?",
-    "Upgrade complete.": "업그레이드가 완료되었습니다.",
+    "Upgrade complete.": "업그레이드가 완료되었습니다",
     "Use a black background surface.": "검은색 배경 화면을 사용하십시오.",
     "Use camera's entropy to create a new mnemonic": "카메라의 엔트로피를 사용하여 새로운 니모닉을 생성하십시오",
     "Use current value?": "현재 수치",

diff --git a/i18n/translations/nl-NL.json b/i18n/translations/nl-NL.json
@@ -20,7 +20,10 @@
     "Additional entropy from camera required for %s": "Extra entropie van camera vereist voor %s",
     "Address": "Adres",
     "Align camera and backup plate properly.": "Richt de camera en back-upplaat op de juiste manier.",
+    "Allow Krux apps": "Krux-apps toestaan",
+    "Allow in settings first!": "Sta eerst instellingen toe!",
     "Anti-glare mode": "Anti-verblindingsmodus",
+    "App will be stored internally on flash.": "De app wordt intern opgeslagen op de flitser.",
     "Appearance": "Uiterlijk",
     "Are you sure?": "Weet je het zeker?",
     "BGR Colors": "BGR-kleuren",
@@ -93,6 +96,7 @@
     "Erasing user's data…": "Gebruikersgegevens worden gewist…",
     "Error:": "Fout:",
     "Esc": "Esc",
+    "Execute %s Krux app?": "%s Krux-app uitvoeren?",
     "Explore files?": "Bestanden verkennen?",
     "Export Addresses": "Adressen exporteren",
     "Exporting %s to SD card…": "Exporteren van %s naar SD-kaart…",
@@ -151,6 +155,7 @@
     "Line Delay": "Lijn vertraging",
     "Line:": "Lijn:",
     "List Addresses": "Adressenlijst",
+    "Load Krux app": "Krux-app laden",
     "Load Mnemonic": "Geheugensteun laden",
     "Load Wallet": "Portemonnee laden",
     "Load a trusted wallet descriptor to view addresses?": "Een vertrouwde portemonnee descriptor laden om adressen te bekijken?",
@@ -284,6 +289,7 @@
     "Spend (%d):": "Uitgaven (%d):",
     "Spend:": "Uitgaven:",
     "Standard mode": "Standaardmodus",
+    "Startup Kapp": "Kapp opstarten",
     "Static": "Statisch",
     "Stats for Nerds": "Statistieken voor nerds",
     "Store on Flash": "Opslaan op apparaat",
@@ -316,6 +322,7 @@
     "Type Key": "Voer sleutel in",
     "Undo": "Ongedaan maken",
     "Unit": "Eenheid",
+    "Unsigned apps found in flash will be deleted.": "Niet-ondertekende apps die in Flash worden gevonden, worden verwijderd.",
     "Update KEF ID?": "KEF-ID bijwerken?",
     "Update QR Label?": "QR-label bijwerken?",
     "Upgrade complete.": "Upgrade afgerond.",

diff --git a/i18n/translations/pt-BR.json b/i18n/translations/pt-BR.json
@@ -20,7 +20,10 @@
     "Additional entropy from camera required for %s": "Entropia adicional da câmera é necessária para %s",
     "Address": "Endereço",
     "Align camera and backup plate properly.": "Alinhe a câmera e a placa de backup corretamente.",
+    "Allow Krux apps": "Permitir aplicativos Krux",
+    "Allow in settings first!": "Permita nas configurações primeiro!",
     "Anti-glare mode": "Modo antirreflexo",
+    "App will be stored internally on flash.": "O aplicativo será armazenado internamente em flash.",
     "Appearance": "Aparência",
     "Are you sure?": "Tem certeza?",
     "BGR Colors": "Cores BGR",
@@ -93,6 +96,7 @@
     "Erasing user's data…": "Apagando dados do usuário…",
     "Error:": "Erro:",
     "Esc": "Esc",
+    "Execute %s Krux app?": "Executar %s aplicativo Krux?",
     "Explore files?": "Explorar arquivos?",
     "Export Addresses": "Exportar endereços",
     "Exporting %s to SD card…": "Exportando %s para o cartão SD…",
@@ -151,6 +155,7 @@
     "Line Delay": "Atraso de Linha",
     "Line:": "Linha:",
     "List Addresses": "Listar Endereços",
+    "Load Krux app": "Carregar Krux app",
     "Load Mnemonic": "Carregar Mnemônico",
     "Load Wallet": "Carregar Carteira",
     "Load a trusted wallet descriptor to view addresses?": "Carregar um descritor de carteira para visualizar endereços?",
@@ -284,6 +289,7 @@
     "Spend (%d):": "Gastos (%d):",
     "Spend:": "Gasto:",
     "Standard mode": "Modo padrão",
+    "Startup Kapp": "Kapp de inicialização",
     "Static": "Estático",
     "Stats for Nerds": "Estatísticas para nerds",
     "Store on Flash": "Armazenar na memória flash",
@@ -316,6 +322,7 @@
     "Type Key": "Digite a Chave",
     "Undo": "Desfazer",
     "Unit": "Unidade",
+    "Unsigned apps found in flash will be deleted.": "Aplicativos não assinados encontrados em flash serão excluídos.",
     "Update KEF ID?": "Atualizar KEF ID?",
     "Update QR Label?": "Atualizar etiqueta QR?",
     "Upgrade complete.": "Atualização concluída.",

diff --git a/i18n/translations/ru-RU.json b/i18n/translations/ru-RU.json
@@ -20,7 +20,10 @@
     "Additional entropy from camera required for %s": "Требуется дополнительная энтропия от камеры для %s",
     "Address": "Адрес",
     "Align camera and backup plate properly.": "Правильно совместите камеру и резервную пластину.",
+    "Allow Krux apps": "Разрешить приложения Krux",
+    "Allow in settings first!": "Сначала разрешите в настройках!",
     "Anti-glare mode": "Антибликовый режим",
+    "App will be stored internally on flash.": "Приложение будет храниться во флэш-памяти.",
     "Appearance": "Внешний Вид",
     "Are you sure?": "Вы уверены?",
     "BGR Colors": "Цвета BGR",
@@ -93,6 +96,7 @@
     "Erasing user's data…": "Удаление данных пользователя…",
     "Error:": "Ошибка:",
     "Esc": "Выйти",
+    "Execute %s Krux app?": "Запустить приложение %s Krux?",
     "Explore files?": "Исследовать файлы?",
     "Export Addresses": "Экспорт адресов",
     "Exporting %s to SD card…": "Экспорт %s на SD-карту…",
@@ -151,6 +155,7 @@
     "Line Delay": "Задержка Линии",
     "Line:": "Линия:",
     "List Addresses": "Список адресов",
+    "Load Krux app": "Загрузить приложение Krux",
     "Load Mnemonic": "Загрузить Мнемонику",
     "Load Wallet": "Загрузить кошелек",
     "Load a trusted wallet descriptor to view addresses?": "Загрузить дескриптор доверенного кошелька для просмотра адресов?",
@@ -284,6 +289,7 @@
     "Spend (%d):": "Расход (%d):",
     "Spend:": "Расход:",
     "Standard mode": "Стандартный режим",
+    "Startup Kapp": "Запуск Kapp",
     "Static": "Static / Статическое оборудование",
     "Stats for Nerds": "Статистика для Гиков",
     "Store on Flash": "Сохранить на Флэш Память",
@@ -316,6 +322,7 @@
     "Type Key": "Ввести Ключ",
     "Undo": "Отменить",
     "Unit": "Единица Измерения",
+    "Unsigned apps found in flash will be deleted.": "Неподписанные приложения, найденные во флэш-памяти, будут удалены.",
     "Update KEF ID?": "Обновить идентификатор KEF?",
     "Update QR Label?": "Обновить QR-метку?",
     "Upgrade complete.": "Обновление завершено.",