A Metamask fork with Infura removed and default networks editable
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
ciphermask/docs/QA_MIGRATIONS_GUIDE.md

20 lines
1.5 KiB

### QA Migrations Guide
Migrations are needed to change top-level state data, this can be found in the browser's storage. This can look like removing specific keys/value pairs from state, changing objects to an array of objects, changing the name of a controller, etc.
Steps
1. Create a new MetaMask directory\* folder locally with the source files before the migration, and load it as an unpacked extension in Chrome\*. If the migration is in a pull request, then build the `develop` branch to load. If the migration is already in `develop`, get a commit before the migration was added to build.
![Load unpacked extension to chrome](./assets/load-build-chrome.gif)
##### \* For migrations targeting specific features behind a feature flag add them appropriately to the `.metamaskrc` file before building.
##### \* In order for the "Load unpacked" button to be shown developer mode needs to be enabled.
2. Once the build has been loaded and state data has been initialized, ensure that the data in question that the migration targets is present in the local storage data.
![Chrome storage state](./assets/chrome-storage-local.png)
3. To trigger the migration a build with the migration will need to replace the files in the directory where the extension is loaded from, and refresh the extension.
![gif of replacing files and reloading the extension](./assets/folder-file-replacement-build.gif)
4. Ensure that the data has been changed/deleted/etc.