{"id":18953155,"url":"https://github.com/0xpolygon/storage-delta","last_synced_at":"2025-08-26T08:08:37.930Z","repository":{"id":210074106,"uuid":"717062455","full_name":"0xPolygon/storage-delta","owner":"0xPolygon","description":"Real-time smart contract storage auditor.","archived":false,"fork":false,"pushed_at":"2024-02-01T13:41:11.000Z","size":1259,"stargazers_count":33,"open_issues_count":4,"forks_count":5,"subscribers_count":4,"default_branch":"main","last_synced_at":"2025-08-17T04:33:11.156Z","etag":null,"topics":["foundry","security"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/0xPolygon.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE-APACHE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2023-11-10T13:24:34.000Z","updated_at":"2025-03-26T07:03:44.000Z","dependencies_parsed_at":"2025-04-16T02:44:39.556Z","dependency_job_id":"8c70f251-b29c-47cc-8d15-983decca3dac","html_url":"https://github.com/0xPolygon/storage-delta","commit_stats":null,"previous_names":["0xpolygon/storage-layout-checker","0xpolygon/storage-delta"],"tags_count":4,"template":false,"template_full_name":null,"purl":"pkg:github/0xPolygon/storage-delta","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/0xPolygon%2Fstorage-delta","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/0xPolygon%2Fstorage-delta/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/0xPolygon%2Fstorage-delta/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/0xPolygon%2Fstorage-delta/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/0xPolygon","download_url":"https://codeload.github.com/0xPolygon/storage-delta/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/0xPolygon%2Fstorage-delta/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":272192669,"owners_count":24889452,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-26T02:00:07.904Z","response_time":60,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["foundry","security"],"created_at":"2024-11-08T13:36:52.016Z","updated_at":"2025-08-26T08:08:37.907Z","avatar_url":"https://github.com/0xPolygon.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ⟁ Storage Delta\n\nStorage Delta is a tool for auditing storage layout changes during contract upgrades.\n\n![Demo](./demo.gif)\n\n## Install\n\nPowered by [Foundry](https://github.com/foundry-rs/foundry).\n\n```bash\nforge install 0xPolygon/storage-delta\n```\n\n## Run\n\nStorage Delta analyzes the entire contract suite against any previous version.\n\n```bash\nbash lib/storage-delta/run.sh \u003cCOMMIT_OR_TAG\u003e\n```\n\n`./storage_delta` will be generated if there are findings. Open `OLD` and `NEW` files side by side for the best experience.\n\n## Detectors\n\n|     | Description                                |\n| --- | ------------------------------------------ |\n| 🌱  | [New](#new)                                |\n| 🏴  | [Problematic](#problematic)                |\n| 🏳️  | [Moved](#moved)                            |\n| 🏁  | [Moved \u0026 problematic](#moved--problematic) |\n| 🪦  | [Removed](#removed)                        |\n|     | [Dirty bytes](#dirty-bytes)                |\n\n### New\n\nWhen a variable with a unique name and type is added.\n\n```solidity\n    uint256 a\n```\n\n```solidity\n    uint256 a\n🌱  bool b\n```\n\n### Problematic\n\nWhen a new variable is added, but conflicts with the existing storage.\n\n```solidity\n    uint256 a\n```\n\n```solidity\n🏴  bool b\n```\n\n### Moved\n\nWhen an existing variable is moved.\n\n```solidity\n    uint256 a\n    ...\n```\n\n```solidity\n    ...\n🏳️  uint256 a\n```\n\n### Moved \u0026 problematic\n\nWhen an existing variable is moved and conflicts with the existing storage.\n\n```solidity\n    uint256 a\n    bool b\n```\n\n```solidity\n🏁  bool b\n🏁  uint256 a\n```\n\n### Removed\n\nWhen a variable no longer exists.\n\n```solidity\n    uint256 a\n    bool b\n```\n\n```solidity\n    uint256 a\n🪦\n```\n\n### Dirty bytes\n\nWhen the storage is not clean.\n\n```solidity\n    uint256 a\n```\n\n```solidity\n🏴  uint128 a\n    16 dirty bytes\n```\n\n## Configuration\n\n| Option   | Values | Description                                        |\n| -------- | ------ | -------------------------------------------------- |\n| `--omit` | `new`  | Do not generate a report with only those findings. |\n\n## Requirements\n\nFiles should be named after the contract they hold. `Example` → `Example.sol`\n\nThe script utilizes Node.js to run. We recommend the node version defined in the `.nvmrc` file.\n\n## License\n\n​\nLicensed under either of\n​\n\n- Apache License, Version 2.0, ([LICENSE-APACHE](LICENSE-APACHE) or http://www.apache.org/licenses/LICENSE-2.0)\n- MIT license ([LICENSE-MIT](LICENSE-MIT) or http://opensource.org/licenses/MIT)\n  ​\n\nat your option.\n\nUnless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.\n\n---\n\n© 2023 PT Services DMCC\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F0xpolygon%2Fstorage-delta","html_url":"https://awesome.ecosyste.ms/projects/github.com%2F0xpolygon%2Fstorage-delta","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F0xpolygon%2Fstorage-delta/lists"}