chore: add upgrade guide for v.1.5

[marcelstanley]

Relates to #432. Requirement for v1.5

---

Evidence that the steps were executed on devnet and that inputs/outputs from v1.4.0 match the ones in v1.5.0 after the upgrade is complete:

• Commands executed: console_log.txt
• anvil/node logs: node_upgrade_log.txt

[guidanoli]

It might be worth noting that the new History will contain no claims, and that they will need to be submitted by the Authority again, one by one.

Might be interesting also to run these cast commands locally, on a local fork or local devnet, and show an example of the expected output, so that users can know if they're following the migration guide correctly.

Also, would be interesting to show how these read and write functions can be called on Etherscan. Might be a more friendly UI for less seasoned web3 developers. We have contracts verified for the main networks, and one can easily call read-only functions (such as calculateHistoryAddress, and, after connecting their browser wallets, submit state-changing txs (such as newHistory and setHistory). In this case, screenshots might be useful.

[marcelstanley]

It might be worth noting that the new History will contain no claims, and that they will need to be submitted by the Authority again, one by one.

Added note

Might be interesting also to run these cast commands locally, on a local fork or local devnet, and show an example of the expected output, so that users can know if they're following the migration guide correctly.

Sure, that was always the plan! I've just added that to the PR description above.

Also, would be interesting to show how these read and write functions can be called on Etherscan. Might be a more friendly UI for less seasoned web3 developers. We have contracts verified for the main networks, and one can easily call read-only functions (such as calculateHistoryAddress, and, after connecting their browser wallets, submit state-changing txs (such as newHistory and setHistory). In this case, screenshots might be useful.

That would be a nice addition. Perhaps we should move this whole guide to the wiki, then. 🤔

Thanks a lot for your help, @guidanoli!

[guidanoli]

LGTM