Skip to content

Commit

Permalink
Merge pull request #446 from selfcustody/wonder_mv
Browse files Browse the repository at this point in the history
Mnemonic Editor, East Asian Translations and WonderMV
  • Loading branch information
odudex authored Sep 9, 2024
2 parents 6ceb7e8 + fa635d3 commit 4495164
Show file tree
Hide file tree
Showing 64 changed files with 2,834,843 additions and 367 deletions.
11 changes: 9 additions & 2 deletions docs/getting-started/usage/generating-a-mnemonic.en.md
Original file line number Diff line number Diff line change
Expand Up @@ -68,7 +68,14 @@ A low Shannon's entropy value could suggest that your dice are biased or that th
<img src="../../../img/maixpy_m5stickv/new-mnemonic-via-d6-roll-nerd-stats-125.png">
<img src="../../../img/maixpy_m5stickv/new-mnemonic-via-d20-roll-nerd-stats-125.png">

## How it works

## Editing a New Mnemonic - Optional
After entering dice rolls, random words, or captured entropy through the camera, you can manually add custom entropy by editing some of the words. Edited words will be highlighted, and the final word will automatically update to ensure a valid checksum. However, proceed with caution, modifying words can negatively impact the natural entropy previously captured.

<img src="../../../img/maixpy_amigo/new-mnemonic-edited-150.png">
<img src="../../../img/maixpy_m5stickv/new-mnemonic-edited-125.png">

## How Entropy Capture Works
For dice rolls, Krux keeps track of every roll you enter and displays the cumulative string of outcomes after each roll.

When you have entered your final roll, Krux will hash this string using [SHA256](https://en.bitcoin.it/wiki/SHA-256) and output the resulting hash to the screen so that you can verify it for yourself.
Expand All @@ -84,5 +91,5 @@ Krux then takes this hash, runs [`unhexlify`](https://docs.python.org/3/library/

Note: For 12-word mnemonics, only the first half of the SHA256 hash is used (128 bits), while 24-word mnemonics use the full hash (256 bits).

### How to verify
### How to Verify
Don't trust, verify. We encourage you not to trust any claim you cannot verify yourself. Therefore, there are wallets that use compatible algorithms to calculate the entropy derived from dice rolls. You can use the [SeedSigner](https://seedsigner.com/) or [Coldcard](https://coldcard.com/) hardware wallets, or even the [Bitcoiner Guide website](https://bitcoiner.guide/seed/), they share the same logic that Krux uses and will give the same mnemonic for the dice roll method.
18 changes: 17 additions & 1 deletion docs/getting-started/usage/loading-a-mnemonic.en.md
Original file line number Diff line number Diff line change
Expand Up @@ -88,9 +88,25 @@ You can retrieve mnemonics previously stored on device's internal flash or exter
## Wallet Loading
### Confirm Mnemonic Words
<img src="../../../img/maixpy_m5stickv/load-mnemonic-seq-mnemonic-125.png" align="right">
<img src="../../../img/maixpy_amigo/load-mnemonic-seq-mnemonic-150.png" align="right">


Once you have entered your mnemonic, you will be presented with the full list of words to confirm.

<div style="clear: both"></div>

<img src="../../../img/maixpy_m5stickv/load-mnemonic-seq-double-mnemonic-125.png" align="right">
<img src="../../../img/maixpy_amigo/load-mnemonic-seq-double-mnemonic-150.png" align="right">
If you see an asterisk (`*`) in the header, it means this is a [double mnemonic](generating-a-mnemonic.md/#double-mnemonic).

<div style="clear: both"></div>

### Edit Mnemonic - Optional

<img src="../../../img/maixpy_m5stickv/load-mnemonic-seq-mnemonic-edited-wrong-125.png" align="right">
<img src="../../../img/maixpy_amigo/load-mnemonic-seq-mnemonic-edited-wrong-150.png" align="right">

Once you have entered your mnemonic, you will be presented with the full list of words to confirm. If you see an asterisk (`*`) in the header, it means this is a [double mnemonic](generating-a-mnemonic.md/#double-mnemonic).
If you make a mistake while loading a mnemonic, you can easily edit it. Simply touch or navigate to the word you want to change and replace it. Edited words will be highlighted in a different color. If the final word contains an invalid checksum, it will appear in red. If your checksum word is red, please review your mnemonic carefully, as there may be an error.

<div style="clear: both"></div>

Expand Down
Binary file modified docs/img/maixpy_amigo/load-mnemonic-seq-double-mnemonic-150.en.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified docs/img/maixpy_amigo/load-mnemonic-seq-mnemonic-150.en.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified docs/img/maixpy_amigo/new-mnemonic-options-150.en.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified docs/img/maixpy_m5stickv/load-mnemonic-seq-mnemonic-125.en.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified docs/img/maixpy_m5stickv/new-mnemonic-options-125.en.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
2 changes: 1 addition & 1 deletion firmware/MaixPy
Submodule MaixPy updated 26 files
+7 −2 components/micropython/port/src/omv/img/include/font.h
+30 −19 components/micropython/port/src/omv/py/py_lcd.c
+2 −1 projects/maixpy_amigo/builtin_py/board.py
+2,845 −94 projects/maixpy_amigo/compile/overrides/components/micropython/port/src/omv/img/font.c
+2 −1 projects/maixpy_bit/builtin_py/board.py
+2,154 −85 projects/maixpy_bit/compile/overrides/components/micropython/port/src/omv/img/font.c
+2 −1 projects/maixpy_cube/builtin_py/board.py
+2,175 −107 projects/maixpy_cube/compile/overrides/components/micropython/port/src/omv/img/font.c
+2 −1 projects/maixpy_dock/builtin_py/board.py
+2,154 −85 projects/maixpy_dock/compile/overrides/components/micropython/port/src/omv/img/font.c
+2 −1 projects/maixpy_m5stickv/builtin_py/board.py
+2,156 −80 projects/maixpy_m5stickv/compile/overrides/components/micropython/port/src/omv/img/font.c
+32 −0 projects/maixpy_wonder_mv/CMakeLists.txt
+66 −0 projects/maixpy_wonder_mv/builtin_py/board.py
+36 −0 projects/maixpy_wonder_mv/builtin_py/fpioa_manager.py
+114 −0 projects/maixpy_wonder_mv/compile/compile_flags.cmake
+262 −0 projects/maixpy_wonder_mv/compile/kendryte.ld
+2,828 −0 projects/maixpy_wonder_mv/compile/overrides/components/micropython/port/src/omv/img/font.c
+1,772 −0 projects/maixpy_wonder_mv/compile/overrides/components/micropython/port/src/omv/sensor.c
+11 −0 projects/maixpy_wonder_mv/compile/priority.conf
+159 −0 projects/maixpy_wonder_mv/config_defaults.mk
+27 −0 projects/maixpy_wonder_mv/main/CMakeLists.txt
+12 −0 projects/maixpy_wonder_mv/main/src/main.cpp
+32 −0 projects/maixpy_wonder_mv/project.py
+2 −1 projects/maixpy_yahboom/builtin_py/board.py
+2,154 −85 projects/maixpy_yahboom/compile/overrides/components/micropython/port/src/omv/img/font.c
Loading

0 comments on commit 4495164

Please sign in to comment.