owned this note
owned this note
Published
Linked with GitHub
# 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`
