Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
7 changes: 0 additions & 7 deletions _compress_images_cache.yml
Original file line number Diff line number Diff line change
Expand Up @@ -421,13 +421,10 @@ assets/images/guide/private-key-management/schemes/multi-key.jpg: multi-key.jpg
assets/images/guide/private-key-management/schemes/multi-key@2x.jpg: multi-key@2x.jpg
assets/images/guide/private-key-management/schemes/page-personal-schemes.jpg: page-personal-schemes.jpg
assets/images/guide/private-key-management/schemes/page-private-key-schemes.jpg: page-private-key-schemes.jpg
assets/images/guide/private-key-management/schemes/page-shared-schemes.png: page-shared-schemes.png
assets/images/guide/private-key-management/schemes/personal-schemes.jpg: personal-schemes.jpg
assets/images/guide/private-key-management/schemes/personal-schemes@2x.jpg: personal-schemes@2x.jpg
assets/images/guide/private-key-management/schemes/recovery-phrase.jpg: recovery-phrase.jpg
assets/images/guide/private-key-management/schemes/recovery-phrase@2x.jpg: recovery-phrase@2x.jpg
assets/images/guide/private-key-management/schemes/shared-multi-key.jpg: shared-multi-key.jpg
assets/images/guide/private-key-management/schemes/shared-multi-key@2x.jpg: shared-multi-key@2x.jpg
assets/images/guide/private-key-management/schemes/signing-devices.jpg: signing-devices.jpg
assets/images/guide/private-key-management/schemes/signing-devices@2x.jpg: signing-devices@2x.jpg
assets/images/guide/private-key-management/schemes/spectrum-mobile.png: spectrum-mobile.png
Expand All @@ -439,10 +436,6 @@ assets/images/guide/private-key-management/schemes/spectrum@2x.png: spectrum@2x.
assets/images/guide/private-key-management/schemes/threshold-signatures.jpg: threshold-signatures.jpg
assets/images/guide/private-key-management/schemes/threshold-signatures@2x.jpg: threshold-signatures@2x.jpg
assets/images/guide/private-key-management/schemes@2x.jpg: schemes@2x.jpg
assets/images/guide/private-key-management/shared-mobile.jpg: shared-mobile.jpg
assets/images/guide/private-key-management/shared-mobile@2x.jpg: shared-mobile@2x.jpg
assets/images/guide/private-key-management/shared.jpg: shared.jpg
assets/images/guide/private-key-management/shared@2x.jpg: shared@2x.jpg
assets/images/guide/resources/content-guidelines-preview.jpg: content-guidelines-preview.jpg
assets/images/guide/resources/formatting-preview.jpg: formatting-preview.jpg
assets/images/guide/resources/resources-preview.jpg: resources-preview.jpg
Expand Down
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
8 changes: 1 addition & 7 deletions guide/private-key-management/introduction.md
Original file line number Diff line number Diff line change
Expand Up @@ -69,13 +69,7 @@ A single key is split up, with each part stored in separate locations.

### [Multi-key]({{ '/guide/private-key-management/multi-key/' | relative_url }})

A wallet that is managed by multiple independent keys of which at least one is stored on a separated device from the wallet application.

---

### [Shared multi-key]({{ '/guide/private-key-management/shared-multi-key/' | relative_url }})

Same as the multi-key scheme, but with keys managed by different people, requiring additional coordination.
A wallet that is managed by multiple independent keys of which at least one is stored on a separate device from the wallet application. The keys can be owned by one person, or several people in a shared setup.

---

Expand Down
23 changes: 16 additions & 7 deletions guide/private-key-management/multi-key.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,16 +12,20 @@ image: https://bitcoin.design/assets/images/guide/private-key-management/schemes

Editor's notes

Descriptions of schemes suitable for a single user.
Descriptions of multi-key schemes.

-->

# Multi-key

All of the above schemes have relied on a single private key to control the wallet. This presents an all-or-nothing risk for loss of funds from both theft and negligence. To counter this a wallet can have several private keys attached of which all or a subset need to sign any transactions. In the personal use case, one person will control all the keys but hold them on different devices, or in different places.
All of the previous schemes have relied on a single private key to control the wallet. This presents an all-or-nothing risk for loss of funds from both theft and negligence. To counter this a wallet can have several private keys attached of which all or a subset need to sign any transactions.

This is often called multi-signature, or multisig for short, but is also sometimes referred to as a *vault*. A multi-key setup is described as *n-of-n* to indicate how many keys are needed to sign a transaction out of the issued number. For example a *2-of-3* setup requires two of the three private keys to sign a transaction for it to be valid.

In the case of a personal wallet, one individual will control all the keys but hold them on different devices for increased security.

In the case of a shared wallet, different people will control the keys. The number of keys and required co-signers will depend on the use case. With spouses sharing a *joint account*, a simple 1-of-2 multi-key setup might suffice, meaning there are two keys but only one is required to sign for a transaction to be valid. At the other end of a spectrum a company might require a more complex 3-of-5 setup, requiring three of the five co-signers to approve any transaction.

Multi-key schemes can raise the security, since anyone needs access to more than one key to move any funds. But clearly it also increases complexity and the requirements on the user to keep even more keys securely stored and/or backed up.

{% include image.html
Expand All @@ -34,25 +38,29 @@ Multi-key schemes can raise the security, since anyone needs access to more than
%}

### How it works
A software wallet application or coordination software initiates a multi-sig wallet, choosing the number of total keys, and the number required to sign transactions. The user then adds private keys from other wallets generated elsewhere to the multisig after which the software wallet can complete the creation process. For any future transaction from the multi-sig wallet the required amount of co-signers need to sign (using Partially Signed Bitcoin Transactions - PSBT from [BIP174](https://github.com/bitcoin/bips/blob/master/bip-0174.mediawiki)) before any transaction is valid.
A software wallet application or coordination software initiates a multi-sig wallet, choosing the number of total keys, and the number required to sign transactions. You then add private keys from other wallets generated elsewhere to the multisig after which the software wallet can complete the creation process. For any future transaction from the multi-sig wallet the required amount of co-signers need to sign (using Partially Signed Bitcoin Transactions - PSBT from [BIP174](https://github.com/bitcoin/bips/blob/master/bip-0174.mediawiki)) before any transaction is valid.

{% include fact/pros.html %}

- Significantly increases security against theft
- Can allow several people to access and control a shared wallet
- Can tailor requirements for multiple co-signing and access situations

{% include fact/close.html %}

{% include fact/cons.html %}

- Adds complexity and op-sec burden for multiple private keys
- Has significant complexity and op-sec burden for multiple private keys, each of which need a good backup scheme

{% include fact/close.html %}

### Best practice

**When to use**
- When storing large amounts
- When funds need to be accessed by several people or an organization
- When target audience is likely to own hardware wallets
- When users are likely to be very knowledgeable or be guided through setup and use
- When most users are likely to implement good backup schemes for multiple keys

**When not to use**
Expand All @@ -61,8 +69,8 @@ A software wallet application or coordination software initiates a multi-sig wal

**Variations**
- Number of total and co-signing keys
- Key locations and distribution
- Managed or completely sovereign
- Key storage devices and distribution
- Managed or completely self-managed

**Do's**
- Make sure the multi-key setup itself is backed up properly, including [extended public keys]({{ '/guide/glossary/#extended-public-key-xpub-ypub-zpub' | relative_url }}) for all the participating keys, fingerprint and derivation.
Expand All @@ -75,7 +83,8 @@ A software wallet application or coordination software initiates a multi-sig wal
- [Specter](https://specter.solutions)
- [Armory](https://btcarmory.com)
- [Guarda](https://guarda.com)
- [Revault](https://revault.dev){:target="_blank"} - in development

---

Next, let's look at [shared multi key]({{ '/guide/private-key-management/shared-multi-key/' | relative_url }}).
OK, to end this chapter let's have a look at how to do safe [Bitcoin backups]({{ '/guide/private-key-management/backups/' | relative_url }}).
4 changes: 1 addition & 3 deletions guide/private-key-management/overview.md
Original file line number Diff line number Diff line change
Expand Up @@ -88,8 +88,6 @@ Or you can follow this flow chart to find a suitable scheme for your use case.
layout = "full-width"
%}

We can divide the options up into personal and shared wallet schemes. The following pages explain each one in more detail:

### Personal schemes

Now let's dive in and look at the various schemes that might be suitable for a personal wallet application with a single user to understand the differences at a high level.
Expand All @@ -115,7 +113,7 @@ While multi-key setups can be used for personal use, if several people need to s

The use cases for shared schemes include spouses managing a joint account, groups, organizations or companies managing their funds, as well as inheritance planning. It can also be used for governance of an organization, with transactions used not to transfer funds but to record, or vote, for decisions.

- [Shared multi-key](/guide/private-key-management/shared-multi-key) - several keys and several people control the wallet
- [Multi-key](/guide/private-key-management/multi-key/) - several keys and several people control the wallet

---

Expand Down
84 changes: 0 additions & 84 deletions guide/private-key-management/shared-multi-key.md

This file was deleted.