CIP-1852 | Adjust preamble and structure w.r.t CIP-0001 (#723)

* first draft remediation of CIP-1852

* incidental use of word "acceptance" in Implementation Plan is confusing

* broken link for CIP3

* also broken link for CIP-1854

* spelled NA instead of standard N/A

* correcting KtorZ email address again

Author: rphair

CIP-1852/README.md

@@ -1,10 +1,15 @@
 ---
 CIP: 1852
 Title: HD (Hierarchy for Deterministic) Wallets for Cardano
-Authors: Sebastien Guillemot <[email protected]>, Matthias Benkort <[email protected]>
-Comments-URI: https://forum.cardano.org/t/cip1852-hd-wallets-for-cardano/41740
 Status: Active
-Type: Standards
+Category: Wallets
+Authors:
+  - Sebastien Guillemot <[email protected]>
+  - Matthias Benkort <[email protected]>
+Implementors: N/A
+Discussions:
+  - https://github.com/cardano-foundation/CIPs/pull/33
+  - https://forum.cardano.org/t/cip1852-hd-wallets-for-cardano/41740
 Created: 2019-10-28
 License: CC-BY-4.0
 ---
@@ -13,22 +18,7 @@ License: CC-BY-4.0
 
 Cardano extends the [BIP44](https://github.com/bitcoin/bips/blob/master/bip-0044.mediawiki) by adding new chains used for different purposes. This document outlines how key derivation is done and acts as a registry for different chains used by Cardano wallets.
 
-## Terminology
-
-### Derivation style
-
-Cardano does not use [BIP32](https://github.com/bitcoin/bips/blob/master/bip-0032.mediawiki) but actually uses [BIP32-Ed25519](https://input-output-hk.github.io/adrestia/static/Ed25519_BIP.pdf). The `-Ed25519` suffix is often dropped in practice (ex: we say the Byron release of Cardano supports [BIP44](https://github.com/bitcoin/bips/blob/master/bip-0044.mediawiki) but in reality this is BIP44-Ed25519).
-
-The Byron implementation of Cardano uses `purpose = 44'` (note: this was already a slight abuse of notation because Cardano implements BIP44-Ed25519 and not standard BIP44).
-
-There are two (incompatible) implementations of BIP32-Ed25519 in Cardano:
-
-1) HD Random (notably used initially in Daedalus)
-2) HD Sequential (notably used initially in Icarus)
-
-The difference is explained in more detail in [CIP3](https://cips.cardano.org/cips/cip3)
-
-## Motivation
+## Motivation: why is this CIP necessary?
 
 For Cardano, we use a new purpose field `1852'` instead of `44'` like in BIP44. There are three main reasons for this:
 
@@ -40,7 +30,7 @@ For Cardano, we use a new purpose field `1852'` instead of `44'` like in BIP44.
 
 ## Specification
 
-Using `1852'` as the purpose field, we defined the following derivation path
+Using `1852'` as the purpose field, we defined the following derivation path:
 
 ```
 m / purpose' / coin_type' / account' / role / index
@@ -61,12 +51,37 @@ Here, `role` can be the following
 
 Wallets **MUST** implement this new scheme using the master node derivation algorithm from Icarus with sequential addressing (see [CIP3](https://cips.cardano.org/cips/cip3) for more information)
 
+## Rationale: how does this CIP achieve its goals?
+
+### Derivation style
+
+Cardano does not use [BIP32](https://github.com/bitcoin/bips/blob/master/bip-0032.mediawiki) but actually uses [BIP32-Ed25519](https://input-output-hk.github.io/adrestia/static/Ed25519_BIP.pdf). The `-Ed25519` suffix is often dropped in practice (ex: we say the Byron release of Cardano supports [BIP44](https://github.com/bitcoin/bips/blob/master/bip-0044.mediawiki) but in reality this is BIP44-Ed25519).
+
+The Byron implementation of Cardano uses `purpose = 44'` (note: this was already a slight abuse of notation because Cardano implements BIP44-Ed25519 and not standard BIP44).
+
+There are two (incompatible) implementations of BIP32-Ed25519 in Cardano:
+
+1) HD Random (notably used initially in Daedalus)
+2) HD Sequential (notably used initially in Icarus)
+
+The difference is explained in more detail in [CIP-0003](../CIP-0003).
+
 ### Future extensions
 
-As a general pattern, new wallet schemes should use a different purpose if they intend to piggy-back on the same structure but for a different use-case (see for instance [CIP-1854](https://cips.cardano.org/cips/cip1854)).
+As a general pattern, new wallet schemes should use a different purpose if they intend to piggy-back on the same structure but for a different use-case (see for instance [CIP-1854](../CIP-1854)).
 
 The `role` can however be extending with new roles so long as they have no overlapping semantic with existing roles. If they do, then they likely fall into the first category of extension and would better be done via a new purpose.
 
+## Path to Active
+
+### Acceptance Criteria
+
+- [x] Standardisation of this derivation path among all wallets as of the Shelley ledger era.
+
+### Implementation Plan
+
+- [x] Common agreement on the above Motivation, Rationale and Specification during the planning of Cardano's Shelley release.
+
 ## Copyright
 
-This CIP is licensed under [CC-BY-4.0](https://creativecommons.org/licenses/by/4.0/legalcode)
+This CIP is licensed under [CC-BY-4.0](https://creativecommons.org/licenses/by/4.0/legalcode).