trustwallet-assets/history
2021-02-22 16:49:53 +00:00
..
versions History update 2021-02-22 16:49:53 +00:00
LATEST.json History update 2021-02-22 16:49:53 +00:00
README.md History update: add Readme, make build green when there is not change (#5660) 2021-02-22 17:48:47 +01:00

History -- Change management

Change information is made available explicitly, so clients can update only changed assets, without accessing version information from git.

Change information can be found in the folder history.

There is the history/LATEST.json file, which always contains the current version info:

  • versionNum: a simple numerical version designator (e.g. 42).
  • commit: the git commit SHA of the head of the master branch, info only.
  • date: the date time of the last commit, info only.

The folder history/versions contains 1 file per version, named <version>.json, e.g. 42.json. This file contains the list of changed files between the two versions, plus some meta info.

If there are many files changed, the files are not listed, but "fullChange": true is set.

An example of a change file is:

{
    "versionEnd": {
        "versionNum": 2,
        "commit": "159cec70437445948d3081a0b1564b436bccb646",
        "date": "2021-02-22T15:26:24.985Z"
    },
    "versionStart": {
        "versionNum": 1,
        "commit": "f5117527c2e1dd89d51b72c3634d94edb5a04780",
        "date": "2021-02-22T14:56:47.938Z"
    },
    "fullChange": false,
    "changeCount": 12,
    "changes": [
        "blockchains/ethereum/allowlist.json",
        "blockchains/ethereum/assets/0x67c597624B17b16fb77959217360B7cD18284253/info.json",
        "blockchains/ethereum/assets/0x67c597624B17b16fb77959217360B7cD18284253/logo.png",
        "blockchains/ethereum/assets/0x798D1bE841a82a273720CE31c822C61a67a601C3/info.json",
        "blockchains/ethereum/assets/0x798D1bE841a82a273720CE31c822C61a67a601C3/logo.png",
        "history/LATEST.json",
        "history/versions/PLACEHOLDER",
        "package.json",
        "script/config.ts",
        "script/entrypoint/history.ts",
        "script/generic/history.ts",
        "script/generic/update-all.ts"
    ]
}