Skip to content

Commit 70b6152

Browse files
committed
docs: add Stackbit 1248 vertical layout screenshots, documentation and CHANGELOG
1 parent ff661a9 commit 70b6152

7 files changed

Lines changed: 67 additions & 24 deletions

CHANGELOG.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
# Changelog 26.05.0 - May 2025
22

33
### Stackbit 1248 Vertical Layout
4-
Added vertical layout option for Stackbit 1248 backup display, allowing users to choose between Standard (horizontal) and Vertical (transposed) grid orientations.
4+
- Added vertical layout option for Stackbit 1248 backup display/mnemonic input, allowing users to choose between Standard (horizontal) and Vertical (transposed) grid orientations.
55

66
### Migrate UR encoding to uUR MicroPython C module
77
Switch from the pure-Python urtypes and foundation-ur-py packages to the new uUR C module, allowing faster UR QR codes decoding with a smaller RAM footprint.

docs/getting-started/usage/loading-a-mnemonic.en.md

Lines changed: 42 additions & 23 deletions
Original file line numberDiff line numberDiff line change
@@ -80,9 +80,16 @@ Enter the BIP39 mnemonic word's numbers (1-2048) in binary format, toggling nece
8080

8181
Enter the BIP39 mnemonic word's numbers (1-2048) using the Stackbit 1248 metal plate backup method, where each of the four digits of the word's number is a sum of the numbers marked (punched) 1, 2, 4, or 8. For example, to enter the word "oyster", number 1268, you must punch (1)(2)(2,4)(8).
8282

83+
<div style="clear: both"></div>
84+
<img src="../../../img/maixpy_m5stickv/load-mnemonic-via-stackbit-vertical-filled-250.png" align="right" class="m5stickv">
85+
<img src="../../../img/maixpy_amigo/load-mnemonic-via-stackbit-vertical-filled-300.png" align="right" class="amigo">
86+
87+
Vertical layout transposes the grid, with rows = weights (1,2,4,8) and columns = digits.
88+
8389
<div style="clear: both"></div>
8490

8591
### From Storage
92+
8693
<img src="../../../img/maixpy_m5stickv/load-mnemonic-storage-options-250.png" align="right" class="m5stickv">
8794
<img src="../../../img/maixpy_amigo/load-mnemonic-storage-options-300.png" align="right" class="amigo">
8895

@@ -91,7 +98,9 @@ You can also retrieve [encrypted mnemonics previously stored](./navigating-the-m
9198
<div style="clear: both"></div>
9299

93100
## Confirm Wallet Setup
101+
94102
### Confirm Mnemonic Words
103+
95104
<img src="../../../img/maixpy_m5stickv/load-mnemonic-seq-mnemonic-250.png" align="right" class="m5stickv">
96105
<img src="../../../img/maixpy_amigo/load-mnemonic-seq-mnemonic-300.png" align="right" class="amigo">
97106

@@ -106,6 +115,7 @@ If you see an asterisk (`*`) in the header, it means this is a [double mnemonic]
106115
<div style="clear: both"></div>
107116

108117
### (Optional) Edit Mnemonic
118+
109119
<img src="../../../img/maixpy_m5stickv/load-mnemonic-seq-mnemonic-edited-wrong-250.png" align="right" class="m5stickv">
110120
<img src="../../../img/maixpy_amigo/load-mnemonic-seq-mnemonic-edited-wrong-300.png" align="right" class="amigo">
111121

@@ -114,6 +124,7 @@ If you make a mistake while loading a mnemonic, you can easily edit it. Simply t
114124
<div style="clear: both"></div>
115125

116126
### Confirm Wallet Attributes
127+
117128
<img src="../../../img/maixpy_m5stickv/load-mnemonic-seq-overview-250.png" align="right" class="m5stickv">
118129
<img src="../../../img/maixpy_amigo/load-mnemonic-seq-overview-300.png" align="right" class="amigo">
119130

@@ -123,41 +134,48 @@ After confirming your mnemonic, a screen with an **information box at the top**
123134

124135
#### The Attributes:
125136

126-
##### Fingerprint
127-
* :material-fingerprint: ` 73c5da0a `:
128-
The [BIP32](https://github.com/bitcoin/bips/blob/master/bip-0032.mediawiki) master wallet's fingerprint helps you make sure you entered the correct mnemonic and passphrase (optional) and will load the expected wallet. The fingerprint is the best checksum you can have, it's good to note it down.
137+
##### Fingerprint
129138

130-
##### Network
131-
* ` Mainnet `:
132-
Check if you are loading a `Testnet` or `Mainnet` wallet.
139+
- :material-fingerprint: `73c5da0a`:
140+
The [BIP32](https://github.com/bitcoin/bips/blob/master/bip-0032.mediawiki) master wallet's fingerprint helps you make sure you entered the correct mnemonic and passphrase (optional) and will load the expected wallet. The fingerprint is the best checksum you can have, it's good to note it down.
141+
142+
##### Network
143+
144+
- `Mainnet`:
145+
Check if you are loading a `Testnet` or `Mainnet` wallet.
133146

134147
##### Policy Type
135-
* Check the wallet's policy type: `Single-sig`, `Multisig`, `Miniscript`, or `TR Miniscript` (Taproot).
148+
149+
- Check the wallet's policy type: `Single-sig`, `Multisig`, `Miniscript`, or `TR Miniscript` (Taproot).
136150

137151
##### Derivation Path
138-
* :material-arrow-right-bottom: ` m/84h/0h/0h `:
139-
The derivation path is a sequence of numbers, or "nodes", that define the script type, network, and account index of your wallet.
140-
* **Script Type** `84h`: The first number defines the script type. The default is `84h`, corresponding to a Native Segwit wallet. Other values include:
141-
* `44h` for Legacy
142-
* `49h` for Nested Segwit
143-
* `86h` for Taproot
144-
* `48h` for Multisig
145-
* **Network** `0h`: The second number defines the network:
146-
* `0h` for Mainnet
147-
* `1h` for Testnet
148-
* **Account Index** `0h`: The third number is the account index, with `0h` being the default.
149-
* **Additional**: For multisig wallets, a fourth node with the value `2h` is added to the derivation path.
150-
151-
Default Miniscript derivation path is the same as for multisig: ` m/48'/0h/0h/2h `, but they can be fully customized
152+
153+
- :material-arrow-right-bottom: `m/84h/0h/0h`:
154+
The derivation path is a sequence of numbers, or "nodes", that define the script type, network, and account index of your wallet.
155+
_ **Script Type** `84h`: The first number defines the script type. The default is `84h`, corresponding to a Native Segwit wallet. Other values include:
156+
_ `44h` for Legacy
157+
_ `49h` for Nested Segwit
158+
_ `86h` for Taproot
159+
_ `48h` for Multisig
160+
_ **Network** `0h`: The second number defines the network:
161+
_ `0h` for Mainnet
162+
_ `1h` for Testnet
163+
_ **Account Index** `0h`: The third number is the account index, with `0h` being the default.
164+
_ **Additional**: For multisig wallets, a fourth node with the value `2h` is added to the derivation path.
165+
166+
Default Miniscript derivation path is the same as for multisig: ` m/48'/0h/0h/2h `, but they can be fully customized
152167

153168
##### Passphrase
154-
* ` No Passphrase `:
155-
Informs if the wallet has a passphrase. Adding or changing the passphrase results in a completely different wallet and fingerprint.
169+
170+
- `No Passphrase`:
171+
Informs if the wallet has a passphrase. Adding or changing the passphrase results in a completely different wallet and fingerprint.
156172

157173
### Customize Wallet
174+
158175
It is possible to change any of the **wallet's attributes** (it will be possible to change them later too, after loading). To load it faster next time, some default wallet attributes can be set in [settings](../settings.md), they are: `Network`, `Policy Type` and `Script Type`.
159176

160177
#### Passphrase
178+
161179
<img src="../../../img/maixpy_m5stickv/passphrase-load-options-250.png" align="right" class="m5stickv">
162180
<img src="../../../img/maixpy_amigo/passphrase-load-options-300.png" align="right" class="amigo">
163181

@@ -170,6 +188,7 @@ For scanning, you can generate an offline passphrase QR code using the [Datum to
170188
<div style="clear: both"></div>
171189

172190
#### Customize
191+
173192
<img src="../../../img/maixpy_m5stickv/wallet-customization-options-250.png" align="right" class="m5stickv">
174193
<img src="../../../img/maixpy_amigo/wallet-customization-options-300.png" align="right" class="amigo">
175194

61.9 KB
Loading
56 KB
Loading
98.5 KB
Loading
93.2 KB
Loading

simulator/sequences/load-mnemonic-via-stackbit.txt

Lines changed: 24 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -24,3 +24,27 @@ x5 press BUTTON_B
2424
press BUTTON_A
2525

2626
#screenshot load-mnemonic-via-stackbit-filled.png
27+
28+
# Go back to menu
29+
press BUTTON_B
30+
x2 press BUTTON_A
31+
32+
# Navigate to Vertical
33+
press BUTTON_B
34+
press BUTTON_A
35+
36+
screenshot load-mnemonic-via-stackbit-vertical-initial.png
37+
38+
# Fill word 1
39+
press BUTTON_B
40+
press BUTTON_A
41+
x2 press BUTTON_B
42+
press BUTTON_A
43+
x3 press BUTTON_B
44+
press BUTTON_A
45+
x5 press BUTTON_B
46+
press BUTTON_A
47+
x2 press BUTTON_B
48+
press BUTTON_A
49+
50+
screenshot load-mnemonic-via-stackbit-vertical-filled.png

0 commit comments

Comments
 (0)