# NEM - Harlock Hardfork Details

---
**NOTE**

The Harlock hardfork will be executed at block height 3,464,800. ETA: around 18 Nov 2021, 6:00pm UTC

---

### Purpose

The ["Harlock"](https://en.wikipedia.org/wiki/Captain_Harlock) hardfork for NEM is intended for users to explicitly signal support for the integration of NEM as a dedicated subChain of Symbol, as proposed [here](https://docs.symbolplatform.com/handbook/en/vision.html). It does so by burning all of the current NEM 'core funds', and minting new funds into a new 5-of-7 multisig account, with four cosigners from [Valkyrie](https://valkyrieinvest.com/) and three core developers.

_At and after the Harlock hardfork, all outflows from the following fee sink accounts will be prohibited:_
* Namespace Rental Fee Sink [NAMESPACEWH4MKFMBCVFERDPOOP4FK7MTBXDPZZA](https://explorer.nemtool.com/#/s_account?account=NAMESPACEWH4MKFMBCVFERDPOOP4FK7MTBXDPZZA)
* Mosaic Rental Fee Sink [NBMOSAICOD4F54EE5CDMR23CCBGOAM2XSIUX6TRS](https://explorer.nemtool.com/#/s_account?account=NBMOSAICOD4F54EE5CDMR23CCBGOAM2XSIUX6TRS)

### Overview

                                             ┌────────────────┐
                                             │   Does 51% of  │
      ┌──────────Retry─Fork─────────────────►│  harvesting    │
      │                                      │ power upgrade? │
      │                                      └──┬────────┬────┘
      │                                         │        │
      │                  ┌──────────────┐       │        │        ┌───────────────┐
      │                  │ Do any       │      Yes      No        │ Fork Fails    │
      │                  │ burned funds │◄──────┘        └───────►│               │
      │                  │ move before  │                         │ Trust retains │
      │                  │ fork?        │                         │   control!    │
      │                  └──┬───────┬───┘                         └───────────────┘
┌─────┴──────────┐          │       │
│ Fallback  txes │         Yes      No       ┌────────────────┐
│  are included  │◄─────────┘       └───────►│ Preferred txes │
│  in fork block │                           │  are included  │
│                │                           │  in fork block │
│ Trust retains  │                           │                │
│   control      │                           │ Core devs and  │
└────────────────┘                           │ Valkyrie are   │
                                             │ in control!    │
                                             └────────────────┘

### Step Zero: Definitions/Preparation

**New Protocol Fund:** Prior to the fork, one new (empty) multisig accounts will need to be created. All newly minted protocol funds will be transfered into this.

**NemesisII** Treasury reissuance fork block.

### NemesisII Fork Block

At the fork block, a set of predefined TransferTransactions will be sent to the network and harvested by upgraded nodes (v0.6.98). They will be predefined in configuration [1] and will revoke XYM tokens from Trust and NxL owned accounts. In addition, TransferTransactions will be issued from the Nemesis block to the new accounts.

[1] The hashes of these special transactions will be listed in the `nis.treasuryReissuanceForkTransactionHashes` property.

### Harvesting Changes (TEMPORARY)

**DefaultNewBlockTransactionsProvider:getBlockTransactions**

At NemesisII height, retrieve all transactions from UTCache that have a hash in `nis.treasuryReissuanceForkHeight` and order them by TimeStamp. Since there is no state hash, we don't have to worry about corrupting it.

**DefaultUnconfirmedState.verifyAndValidate**

When a transaction is added to the UTCache, its signature is checked. Bypass this check for any transactions with a hash in `nis.treasuryReissuanceForkTransactionHashes`

### Block Processing Changes

#### NemesisSinkValidator

Currently, this validator ensures that signatures from the Nemesis Account are only allowed in the Nemesis block.

This validator will need to be weakened to allow Nemesis Account signatures in both Nemesis and NemesisII block.

#### MinimumFeeValidator

NIS does not currently perform full validation on the Nemesis block, so this validator does not properly handle nemesis originating transactions. It needs to be modified to change minimum allowable fee for nemesis originating transactions to zero.

#### ReclaimFundsForkTransactionBlockValidator (TEMPORARY)

Validates that the block at height `nis.treasuryReissuanceForkHeight` contains exactly all transactions in `nis.treasuryReissuanceForkTransactionHashes`. This will cause a stall until the special transactions are included.

#### BlockChainValidator::verifyTransactions

Update verification to skip transactions with hashes in `nis.treasuryReissuanceForkTransactionHashes`. This will have some negative performance impact because it will result in an extra hash per transaction.

### Fee Sink Handling

**FeeSinkNonOperationalValidator**

Since both the namespace and mosaic rental fees sinks are multisig transactions, a new `MultsigTransaction` validator can inspect the transaction's other transaction signer address. If this address matches one of the fee sink accounts, the transaction will be rejected.

### Safety Valve

If any of the funds being burned are moved between the release and the NemesisII block, the fork will fail. In order to prevent a catastrophic failure in this case, a set of special fallback transactions [2] can be sent to the network to prevent a catastrophic failure. In the case of failure, the fork could be reattempted at a later date.

[2] The hashes of these transactions are specified in the `nis.treasuryReissuanceForkFallbackTransactionHashes` configuration property.

### Appendix: Account Mappings

**New Protocol Treasury Account:** [NCHESTYVD2P6P646AMY7WSNG73PCPZDUQNSD6JAK](https://explorer.nemtool.com/#/s_account?account=NCHESTYVD2P6P646AMY7WSNG73PCPZDUQNSD6JAK)

       NEM Group Trust Addresses
      ┌──────────────────────────────────────────────────────────────────┐
      │  1. NBLOCKYZLCBVO2XF2DB3D74AE2RC5WSHX5JEZOID   1167024434.306550 │
      │  2. NANODESTSN7GU76QPLGMJ7BCGCAA2PHVBZZUUI62     10583640.541000 │
      │  3. NCPAYOUTH2BGEGT3Q7K75PV27QKMVNN2IZRVZWMD      3213957.350100 │
      │  4. NBKXLNQ2GKTLQBTXNFOHULNJDA7T2Q57CZGQ2TFP    208998360.823780 ├──────────────────┐
      │  5. NATRUSTUAB5LAWDSOWDUPQUFYRTGZTJZDGML2JKP   1399339585.654040 │                  │
      └──────────────────────────────────────────────────────────────────┘                  │
                                                                                            │
       NEM Group Limited Addresses                                                          │
      ┌──────────────────────────────────────────────────────────────────┐                  │
      │  6. NB2MQ7EA2YG2RRXHIHO4HA2WCYUYCX5BDQG5CQNW     10472248.595466 │                  │
      │  7. NDBRF5NM466LB6CINFIXLGRIGDL36L7B667WMVQ5       844475.303954 ├──────────────────┤
      │  8. NBRXCR7QJ56CTX5HMIP7VHDMYZTYCEN3DZAIK6O4            3.350000 │                  │
      └──────────────────────────────────────────────────────────────────┘                  │
                                                                                            │
       NEM Ventures Limited Addresses                                                       │
      ┌──────────────────────────────────────────────────────────────────┐                  │
      │  9. NDYNZWZ66ZKBSROL63Y5A27QQEACACT46P5QEUIU     99874634.541950 │                  │
      │ 10. NBVEMLRQUWTFKOIBU5FBBNTA437S27EUC2H7CIL3      7934610.785334 │                  │
      │ 11. NC2M77ZXJ5FEWJUD4VQRGNJPIGFGCMXYL4FNMNUN            1.428776 ├──────────────────┤
      │ 12. NDEBESTILI7WL4PJOY5QXIUXHVOYWW3TL6KCSFI4          109.782000 │                  │
      └──────────────────────────────────────────────────────────────────┘                  │
                                                                                            │
       NEM Holdings Limited Addresses                                                       │
      ┌──────────────────────────────────────────────────────────────────┐                  │
      │ 13. NDSQUAFDFXI4CCNZXQNH3MNMOISYGSAVEODUTJBA      4896576.095100 ├──────────────────┤
      └──────────────────────────────────────────────────────────────────┘                  │
                                                                                            │
       Continuity Fund Addresses                                                            │             NEM Protocol Treasury Funds
      ┌──────────────────────────────────────────────────────────────────┐                  │            ┌─────────────────────────────────────────────────────────────┐
      │ 14. NCONTINUYJDHQ676U7OOASO42I4IJXHZD4O3BTAR     34968242.347680 ├──────────────────┼────────────► NCHESTYVD2P6P646AMY7WSNG73PCPZDUQNSD6JAK  2971608400.5534204 │
      └──────────────────────────────────────────────────────────────────┘                  │            └─────────────────────────────────────────────────────────────┘
                                                                                            │
       Miscellaneous Addresses + Dust                                                       │
      ┌──────────────────────────────────────────────────────────────────┐                  │
      │ 15. NC2EYJ2R4SRG6QC5H4B65IFKLXGBFBS2MBUDGFF6     11656924.347752 │                  │
      │                                                                  │                  │
      │ 16. NCMARKECQXP3SQZSJPCBKOQWIXRRI7LIS4FTU4VZ           11.700000 │                  │
      │ 17. NCONTRLFKPO6YVXO5WUIJ4SWSCSKBJIPV456RSCL            5.850000 │                  │
      │ 18. NCOPERAWEWCD4A34NP5UQCCKEX44MW4SL3QYJYS5            1.050000 │                  │
      │ 19. NDEVPRE5ZWVG2PXSM54BGZBFF525G24UKVOGOZNT            5.850000 │                  │
      │ 20. NDEVPOSK4OMR4PRTLYFHX4W5QTOND7TZDT2DTU4Q           11.700000 │                  │
      │ 21. NAFUNDBUKIOSTMD4BNXL7ZFE735QHN7A3FBS6CMY           14.700000 │                  │
      │ 22. NAFUNDCJBFWXJWQZITUJOIW4O3E6YHQYQYSISPVA           17.550000 │                  │
      │ 23. NAFUNDDWQUHMIKPV2JUH2VNCYEAQX3O7QKHECZUV           35.100000 │                  │
      │ 24. NAFUNDAFO2MHWRR446YHADKR43XQBDJGWFRTMICH           11.700000 │                  │
      │ 25. NAFUNDEULL67VO7WCJBGBHCLCMD5KEH5EI7G5SGR           38.150000 │                  │
      │ 26. NAFUNDFE4HIZWV36FKGFXFFHG5SMUH2XVEEKE4ZD           23.400000 │                  │
      │ 27. NAFUNDHZWSIV4ARXSGGSFONCGFGYTLCB7VOT53SR            3.750000 │                  │
      │ 28. NALMPEMFS3HDXGFHO6AFGLUPMZOPDQMUWZWXBJS5           17.550000 │                  │
      │ 29. NB6T2NT4WVMS2THDZRLPCKVU636BUJ2V7E5DZX7X        91009.200000 │                  │
      │ 30. NALOG6DAIJ7LYWLGY73AT3OWS5ORYJ27WNBI6MHP            0.500000 │                  │
      │ 31. NAFOUND54A2777TVS2IJ733WO6SYQWMXC3AIHOBO            5.300000 │                  │
      │ 32. NAUSCHA55DLLJRBJPFU3V3ZHK3NY6KSI3P46WXCL            5.300000 ├──────────────────┘
      │ 33. NANACHZH3EDZFJOEFL7UGK4VD3IKGAL6DGFI6TKL            1.700000 │
      │ 34. NAMECHPLF5YGZZSWCVMSZ6ZU5U3EGIKI3CBRBTKD            0.400000 │
      │ 35. NALAMCHMVVHN427NG4GGEYFQ7S7EZX7DPV4VPOL3            0.500000 │
      │ 36. NACNCH4ZUTJRTCBBLFCNCEUOCEQ2JLEZYG6HKZ3N            0.350000 │
      │ 37. NASEACHB4GDLNLC2EGU7KQB3T2WY23UWTNVUSLKH            5.050000 │
      │ 38. NAANZCHVAM5RXTKFNG7U6BFBUIOHDZHPF4IRRPNM            0.250000 │
      │ 39. NAEUCH6QSQIU7MX2UR2UGJY2LJJSITCLXLKTAINX            5.150000 │
      │ 40. NAFDNIFYIO6SKZT52XMXWUAMBTIINCBM7H5OUHWN            0.200000 │
      │ 41. NAFDNCFASSZLM26NNTFNEPGUY2DPZIQYSGGP2MDY            0.650200 │
      │ 42. NBFOUNDXB54PVVPG6AN4WJ7BAOYFBC2XLLHDU5YM            4.150000 │
      │ 43. NBTECH3HN7HL7YO2RRQNTSQ3AQOFYHOZOCA4L7XQ           20.950000 │
      │ 44. NBIZDEVY6NGHCNQBONH7YQUYB6BIKZOGS4OWAD3B            0.500000 │
      │ 45. NBMKTGGGQ2OKGAVIKMFXDFRPDBR4LD563SCVPHWW            0.500000 │
      │ 46. NBREVFFWL2NKFK3QCPMOFH6YLSOMLJGDVFY7ORGH            0.500000 │
      │ 47. NBOPERXIPVSUFFV7X646XKF2PROTNN7QUZF7MFJF            0.500000 │
      │ 48. NBFINANG3FC4WADS2IUMHJRZN5LXIVPFKKS4UCUS            0.500000 │
      │ 49. NBNBCYGQ3ZASNQGXMJXXDNUZ52HSVOTGWIN2F52U           20.000000 │
      └──────────────────────────────────────────────────────────────────┘

       Namespace & Mosaic Sink Addresses
      ┌──────────────────────────────────────────────────────────────────┐                   │
      │ 50. NAMESPACEWH4MKFMBCVFERDPOOP4FK7MTBXDPZZA     11308561.781776 ├───────────────────X Frozen Outflows
      │ 51. NBMOSAICOD4F54EE5CDMR23CCBGOAM2XSIUX6TRS       400664.901143 │                   │
      └──────────────────────────────────────────────────────────────────┘

###### tags: `HardFork`, `NEM`