Skip to content

Add SLIP-10 mention to FLIP-200 #758

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 2 commits into from
Jan 12, 2022
Merged

Add SLIP-10 mention to FLIP-200 #758

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
96efb00
Update 20201125-bip-44-multi-account.md
tarakby Jan 3, 2022
5ace548
mention SLIP-10
Jan 12, 2022
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
33 changes: 17 additions & 16 deletions flips/20201125-bip-44-multi-account.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -40,6 +40,12 @@ BIP 44 defines an implementation of [Bitcoin Improvement Proposal
that standardizes a format for hierarchical deterministic (HD) key derivation
paths that support multiple coins and multiple accounts per coin.

Flow accounts support keys on two different elliptic curves (secp256k1 and NIST P-256).
While BIP 32 describes the key derivation process for the secp256k1 curve, [SLIP-0010]
(https://github.com/satoshilabs/slips/blob/master/slip-0010.md) generalizes the derivation
process to the NIST P-256 curve. In the rest of this document, BIP 44 is applicable for
both elliptic curves.

The BIP 44 path format is as follows:

```
Expand Down Expand Up @@ -123,10 +129,7 @@ m / 44' / 1' / 769 / 0 / 0
```

All keys generated with the legacy path as of today (Dec 2021) have been done so using the
ECDSA P256<sup>1</sup> curve.

<sup>1</sup>ECDSA P256 is Elliptic Curve Digital Signature Algorithm (ECDSA) on
the NIST P-256 curve.
NIST P-256 elliptic curve.

### Account Discovery

Expand All @@ -141,19 +144,19 @@ The account index gap limit should be `5`.

The prescribed account discovery procedure is as follows:

1. Derive the key pair using the legacy path and ECDSA P256<sup>1</sup>,
1. Derive the key pair using the legacy path and P-256 curve,
checking its use with the public key registry. If an address is found,
query the Flow network to fetch the account's details. If an account
is found, remember the relationship between the path used to generate
this key and the account's details.
2. Derive the key pair(s) (starting with account index = 0 and key index = 0)
using the path specified in this FLIP and each elliptic curve that
both you and Flow support (Flow currently supports keys generated on the
ECDSA P256<sup>1</sup> and ECDSA secp256k1<sup>2</sup> curves).
P-256 and secp256k1 curves).
Note: If you are unable to derive keys for a certain elliptic curve,
you may fail to discover an account / key that the user has generated
previously.
1. Scan for each keys usage by querying the public key registry with the key and
3. Scan for each keys usage by querying the public key registry with the key and
elliptic curve used to generate it.
If the gap limit has been reached for both key index and account index, stop
discovery.
Expand All @@ -165,20 +168,14 @@ The prescribed account discovery procedure is as follows:
increment the key index by one.
- 3.2. If one or more addresses are found, query the Flow network to fetch each
account's details.
- 3.2.1. If no accounts are found<sup>3</sup>, go to step 2, incrementing
- 3.2.1. If no accounts are found<sup>1</sup>, go to step 2, incrementing
the account index by one.
- 3.2.2. For each account found<sup>3</sup>, remember the relationship between the path
- 3.2.2. For each account found<sup>1</sup>, remember the relationship between the path
used to generate this key, the curve used to generate this key,
and the hash algorithm corresponding to this key and the account's details.
Then go to step 2, incrementing the key index by one.

<sup>1</sup>ECDSA P256 is Elliptic Curve Digital Signature Algorithm (ECDSA) on
the NIST P-256 curve.

<sup>2</sup>ECDSA secp256k1 is Elliptic Curve Digital Signature Algorithm (ECDSA) on
the secp256k1 curve.

<sup>3</sup>Flow supports account deletion, meaning that an address found in the
<sup>1</sup>Flow supports account deletion, meaning that an address found in the
registry may refer to a nonexistent account. In this case the address should be
skipped but discovery should continue.

Expand Down Expand Up @@ -313,6 +310,10 @@ This document outlines a specific application of the standard described by [BIP
standard has been widely adopted by Bitcoin, Ethereum and many other
cryptocurrency projects and communities.

[SLIP-0010](https://github.com/satoshilabs/slips/blob/master/slip-0010.md)
is a document that generalizes the BIP 32 key derivation process
to other curves, in particular the NIST P-256 curve supported by Flow accounts.

[SLIP 48](https://github.com/satoshilabs/slips/blob/master/slip-0048.md)
describes an alternative to BIP 44 for Graphene-based networks which, similar to
Flow, do not derive account addresses directly from cryptographic public keys.
Expand Down