Skip to content

Commit 13c1cf9

Browse files
authored
No substation changes, moving warning near to top.
1 parent c1c7150 commit 13c1cf9

File tree

1 file changed

+11
-14
lines changed

1 file changed

+11
-14
lines changed

README.md

Lines changed: 11 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -22,8 +22,17 @@ The following files contain everything you need to set up your *LetheKit* hardwa
2222

2323
*LetheKit* is currently under active development and in the late alpha testing phase. It should not be used for production tasks until it has had further testing and auditing.
2424

25-
**There is a known problem with BIP39/SLIP39 interoperability. The problem
26-
is being tracked as [Issue #38](https://github.com/BlockchainCommons/bc-lethekit/issues/38).**
25+
### Known Issues
26+
27+
#### ⚠️ Warning: Lack of Round-trip Compatibility between BIP-39 and SLIP-39
28+
29+
At first glance, BIP-39 and SLIP-39 both appear to be means of converting a binary seed to a set of backup words and back. You might assume you could simply convert a BIP-39 backup to a binary seed, from that binary seed to SLIP-39, and then use the SLIP-39 backup to recover the same wallet as the original BIP-39 backup, but this is **NOT** the case. This is because the SLIP-39 algorithm that SatoshiLabs uses in their Trezor wallet does not derive the master secret in the same way as their BIP-39 algorithm does.
30+
31+
Currently Blockchain Commons is investigating an alternative to SLIP-39 that allows round-trips with BIP-39. We want to ensure that the same seed will result in the same derived keys using either BIP-39 or our alternative approach.
32+
33+
As SLIP-39 is not round-trip compatible with BIP-39, and SLIP-39 is under the control of SatoshiLabs and does not appear to be a fully community-controlled standard, Blockchain Commons is no longer endorsing SLIP-39.
34+
35+
* This issue is being tracked [here](https://github.com/BlockchainCommons/bc-lethekit/issues/38).
2736

2837
## Origin, Authors, Copyright & Licenses
2938

@@ -63,18 +72,6 @@ These are other projects that work with or leverage *LetheKit*.
6372

6473
- (submit a PR to this repo list your project)
6574

66-
### Known Issues
67-
68-
#### ⚠️ Warning: Lack of Round-trip Compatibility between BIP-39 and SLIP-39
69-
70-
At first glance, BIP-39 and SLIP-39 both appear to be means of converting a binary seed to a set of backup words and back. You might assume you could simply convert a BIP-39 backup to a binary seed, from that binary seed to SLIP-39, and then use the SLIP-39 backup to recover the same wallet as the original BIP-39 backup, but this is **NOT** the case. This is because the SLIP-39 algorithm that SatoshiLabs uses in their Trezor wallet does not derive the master secret in the same way as their BIP-39 algorithm does.
71-
72-
Currently Blockchain Commons is investigating an alternative to SLIP-39 that allows round-trips with BIP-39. We want to ensure that the same seed will result in the same derived keys using either BIP-39 or our alternative approach.
73-
74-
As SLIP-39 is not round-trip compatible with BIP-39, and SLIP-39 is under the control of SatoshiLabs and does not appear to be a fully community-controlled standard, Blockchain Commons is no longer endorsing SLIP-39.
75-
76-
* This issue is being tracked [here](https://github.com/BlockchainCommons/bc-lethekit/issues/38).
77-
7875
## Financial Support
7976

8077
*LetheKit* (lee-thee kit) is a project of [Blockchain Commons](https://www.blockchaincommons.com/). We are proudly a "not-for-profit" social benefit corporation committed to open source & open development. Our work is funded entirely by donations and collaborative partnerships with people like you. Every contribution will be spent on building open tools, technologies, and techniques that sustain and advance blockchain and internet security infrastructure and promote an open web.

0 commit comments

Comments
 (0)