TypeScript/JavaScript implementation of Seed XOR: A simple way of securing seeds.
This project is in an early development phase and has not been audited or reviewed. Use it at your own risk.
Seed XOR allows you to split up your seed into multiple parts. The parts can then be used to reconstruct the original seed.
Read more about the concepts behind SeedXOR on the official website: Seed XOR
npm install seed-xor
import { combine, split } from 'seed-xor';
const original =
'abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon art';
(async () => {
console.log('Original:', original);
const [share1, share2, share3] = await split(original, 3, true);
console.log('Share 1:', share1);
console.log('Share 2:', share2);
console.log('Share 3:', share3);
const recovered = await combine([share1, share2, share3]);
console.log('Recovered:', recovered);
})();For more examples, check the examples folder or the tests.
This library exports two methods, split and combine.
split is used to split an existing seed into multiple shares. It takes 3 parameters:
split(mnemonic: string, numberOfShares: 2 | 3 | 4 = 2, useRandom = false): Promise<string[]>
mnemonic: The seed that should be split.
numberOfShares: The number of shares that you want to split your mnemonic into. You need ALLx shares to recover your seed phrase.
useRandom: If set to true, the shares will be generated randomly. This means that if you use SeedXOR with the same seed multiple times, you will get different shares. If set to false, you will always get the same shares.
combine is used to combine SeedXOR shares and reconstruct the original seed phrase. Remember: You need ALL shares to recover your seed phrase.
split(shares: string[]): Promise<string>
shares: An array of shares that will be used to recover the original seed phrase.
npm install
npm test
-------------|---------|----------|---------|---------|-------------------
File | % Stmts | % Branch | % Funcs | % Lines | Uncovered Line #s
-------------|---------|----------|---------|---------|-------------------
All files | 100 | 100 | 100 | 100 |
index.ts | 100 | 100 | 100 | 100 |
seed-xor.ts | 100 | 100 | 100 | 100 |
utils.ts | 100 | 100 | 100 | 100 |
-------------|---------|----------|---------|---------|-------------------- Fix sonarsource coverage not working
- Audit/review of library by 3rd party
We try to use only a minimal set of dependencies to reduce the attack surface of malicious code being added by one of those dependencies.
There are only 2 (non-dev) dependencies:
One of those repositories is owned by the bitcoinjs organization, one of them is managed by crypto-browserify.
Currently, the following wallets support or are working on integrating SeedXOR:
The project setup has been inspired by multiple bitcoinjs libraries, such as bip39 and bip85.
MIT