@artblocks/contracts 1.2.0 → 1.2.1

package/README.md

@@ -23,10 +23,6 @@ Create a `.env` file by duplicating `.env.example` and populating all variables.
 
 `yarn compile`
 
-### generate typescript contract bindings
-
-`yarn generate:typechain`
-
 ### run the tests
 
 `yarn test`
@@ -164,42 +160,21 @@ Core contracts use the versioning schema below:
 | :-----------------------: | :-----------------------: | :-----------: | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 |        AB Core V0         |            V0             |      0-2      | `0x059EDD72Cd353dF5106D2B9cC5ab83a52287aC3a`                                                                                                                                                                     |
 |        AB Core V1         |            V1             |     3-373     | `0xa7d8d9ef8D8Ce8992Df33D8b8CF4Aebabd5bD270`                                                                                                                                                                     |
+|        AB Core V3         |            V3             |    374-493    | `0x99a9B7c1116f9ceEB1652de04d5969CcE509B069`                                                                                                                                                                     |
+|  AB Core V3.2 (current)   |           V3.2            |     494+      | `0xAB0000000000aa06f89B268D604a9c1C41524Ac6`                                                                                                                                                                     |
 |     Engine Cores (V2)     |          V2_PBAB          | All V2 Engine | Various - see `deployments/engine/` directory [DEPLOYMENTS.md files](https://github.com/search?q=repo%3Aartblocks%2Fartblocks-contracts+path%3A*.md+path%3A**%2FDEPLOYMENTS.md&type=Code&ref=advsearch&l=&l=)    |
 | Engine Partner Cores (V2) |         V2_PRTNR          | All V2 PRTNR  | Various - see `deployments/engine/` directory [DEPLOYMENTS.md files](https://github.com/search?q=repo%3Aartblocks%2Fartblocks-contracts+path%3A*.md+path%3A**%2FDEPLOYMENTS.md&type=Code&ref=advsearch&l=&l=)    |
-|   AB Core V3 (current)    |            V3             |     374+      | `0x99a9B7c1116f9ceEB1652de04d5969CcE509B069`                                                                                                                                                                     |
 | Engine_V3, Engine_V3_Flex | Engine_V3, Engine_V3_Flex | All V3 Engine | Various - see `deployments/engine/V3/` directory [DEPLOYMENTS.md](https://github.com/search?q=repo%3Aartblocks%2Fartblocks-contracts+path%3A*.md+path%3A**%2FDEPLOYMENTS.md&type=Code&ref=advsearch&l=&l=) files |
 
-> AB Core V3 [changelog here](./contracts/V3_CHANGELOG.md), and [performance metrics here](./contracts/V3_PERFORMANCE.md).
-
-### Testnet Contracts
-
-The following represents the current set of flagship core contracts deployed on the Goerli testnet, and their active Minter Filters:
-
-- Art Blocks Artist Staging (Goerli):
-
-  - V1 Core (deprecated): https://goerli.etherscan.io/address/0xDa62f67BE7194775A75BE91CBF9FEeDcC5776D4b
-  - V3 Core: https://goerli.etherscan.io/address/0xB614C578062a62714c927CD8193F0b8Bfb90055C
-
-- Art Blocks Dev (Goerli):
-  - V1 Core (deprecated): https://goerli.etherscan.io/address/0x1Bf03F29c4FEFFFe4eE26704aaA31d85c026aCE6
-  - V3 Core: https://goerli.etherscan.io/address/0xF396C180bb2f92EE28535D23F5224A5b9425ceca
-
 ## Art Blocks Engine Core Contracts
 
 For deployed core contracts, see the deployment details in the `/deployments/engine/[V2|V3]/<engine-partner>/` directories. For V2 core contracts, archived source code is available in the `/posterity/engine/` directory.
 
 ## BytecodeStorageReader
 
-BytecodeStorageReader (currently on V1 version) is public library for reading from storage contracts. This library is intended to be deployed as a standalone contract, and provides all _read_ functionality by being used as an externally linked library within the Art Blocks ecosystem contracts that use contract storage for writes.
+BytecodeStorageReader is public library for reading from storage contracts. This library is intended to be deployed as a standalone contract, and provides all _read_ functionality by being used as an externally linked library within the Art Blocks ecosystem contracts that use contract bytecode for writes.
 
-Given that it is an externally linked library with a shared public deployment, the deployment addresses for these shared deployments are referenced in our shared deployments `constants.ts` util (in the `BYTECODE_STORAGE_READER_LIBRARY_ADDRESSES` constant) so that they may be linked at time of deployment and are also linked here below for shared reference:
-
-- V1 `BytecodeStorageReader` (goerli): https://goerli.etherscan.io/address/0xB8B806A10d16cc80dB788552B54B3ECb4A2A3C3D#code
-- V1 `BytecodeStorageReader` (sepolia): https://sepolia.etherscan.io/address/0x7497909537cE00fDda93c12d5083D8647C593c67#code
-- V1 `BytecodeStorageReader` (mainnet): https://etherscan.io/address/0xf0585dF582A0ad119F1616FB82f3b449a98EeCd5#code
-- V1 `BytecodeStorageReader` (arbitrum-goerli): https://goerli.arbiscan.io/address/0x681861cD4fC92d70aE57745385065ef862954662#code
-- V1 `BytecodeStorageReader` (arbitrum): https://arbiscan.io/address/0xa07f47c30C262adcC263A4D44595972c50e04db7#code
-- V1 `BytecodeStorageReader` (arbitrum-sepolia): https://sepolia.arbiscan.io/address/0xb219C04128c9749b597c35D416b9988bEa9E1114#code
+Versioned deployments of the BytecodeStorageReader library, as well as a UniversalBytecodeStorageReader contract maintained by Art Blocks, are summarized on the [Infrastructure Documentation](./INFRASTRUCTURE.md) page.
 
 ## Shared Randomizers
 
@@ -222,16 +197,25 @@ Each dependency is identified by a unique name and version (in the format "name@
 
 The contract allows for the overriding of project dependencies. This means that specific projects can use different versions of dependencies than what's stored on the core contract. The override is defined by the address of the core contract, the project ID, and the bytes32 representation of the dependency name and version.
 
-- `DependencyRegistry` (sepolia dev):
-  - TransparentUpgradeableProxy https://sepolia.etherscan.io/address/0x5Fcc415BCFb164C5F826B5305274749BeB684e9b#code
-  - V0 Implementation https://sepolia.etherscan.io/address/0x2B0EaC9FBdD487e09f3326BB616EeAD72ade9876#code
-- `DependencyRegistry` (sepolia staging):
-  - TransparentUpgradeableProxy https://sepolia.etherscan.io/address/0xEFA7Ef074A6E90a99fba8bAd4dCf337ef298387f#code
-  - V0 Implementation https://sepolia.etherscan.io/address/0x2B0EaC9FBdD487e09f3326BB616EeAD72ade9876#code
 - `DependencyRegistry` (mainnet)
-  - TransparentUpgradeableProxy https://etherscan.io/address/0x37861f95882ACDba2cCD84F5bFc4598e2ECDDdAF#code
-  - V0 Implementation https://etherscan.io/address/0x2d3f8D5c5294B7934aFBe4B901EEb5E7B48a4e97#code
-  - AdminACLV0 https://etherscan.io/address/0x569cDfECFD848a02Ad3e74175a1A4a74484Ef944#code
+  - https://etherscan.io/address/0x37861f95882ACDba2cCD84F5bFc4598e2ECDDdAF#code
+- `DependencyRegistry` (sepolia staging)
+  - https://sepolia.etherscan.io/address/0x5Fcc415BCFb164C5F826B5305274749BeB684e9b#code
+
+## GenArt721Generator
+
+The GenArt721GeneratorV0 is an upgradeable contract that generates the HTML required to display Art Blocks artworks. It combines dependency scripts, project scripts, and token data to create the complete HTML for each token. The contract works in conjunction with the DependencyRegistry to retrieve project dependencies and ScriptyBuilder to generate the final HTML output.
+
+Each token's HTML includes the necessary JavaScript dependencies (either loaded from a CDN or stored on-chain), a canvas element if required by the dependency, the project's core script, and token-specific data like the token ID and hash. The contract supports both base64-encoded data URIs and plain HTML output formats.
+
+The contract handles backwards compatibility with different core contract versions and provides flexibility in how dependencies are loaded. It can retrieve scripts stored directly in contract bytecode using the UniversalBytecodeStorageReader, or load them from preferred CDN sources when available.
+
+The contract currently supports most Art Blocks Flagship projects on mainnet.
+
+- `OnChainGenerator` (mainnet)
+  - https://etherscan.io/address/0x953D288708bB771F969FCfD9BA0819eF506Ac718
+- `OnChainGenerator` (sepolia staging)
+  - https://sepolia.etherscan.io/address/0xdC862938cA0a2D8dcabe5733C23e54ac7aAFFF27
 
 ## Splitter Factories
 

package/artifacts/contracts/AdminACLV1.sol/AdminACLV1.json

@@ -241,8 +241,8 @@
       "type": "function"
     }
   ],
-  "bytecode": "0x60c0604052600a60809081526941646d696e41434c563160b01b60a0526000906200002b9082620000f9565b503480156200003957600080fd5b50600180546001600160a01b03191633179055620001c5565b634e487b7160e01b600052604160045260246000fd5b600181811c908216806200007d57607f821691505b6020821081036200009e57634e487b7160e01b600052602260045260246000fd5b50919050565b601f821115620000f4576000816000526020600020601f850160051c81016020861015620000cf5750805b601f850160051c820191505b81811015620000f057828155600101620000db565b5050505b505050565b81516001600160401b0381111562000115576200011562000052565b6200012d8162000126845462000068565b84620000a4565b602080601f8311600181146200016557600084156200014c5750858301515b600019600386901b1c1916600185901b178555620000f0565b600085815260208120601f198616915b82811015620001965788860151825594840194600190910190840162000175565b5085821015620001b55787850151600019600388901b60f8161c191681555b5050505050600190811b01905550565b610bc580620001d56000396000f3fe608060405234801561001057600080fd5b50600436106100995760003560e01c806301ffc9a71461009e57806305de62c0146100c657806329575f6a146100d9578063377a7d1a146100f9578063625e1b7d1461010e578063940ef80014610121578063985d196814610137578063ad35d2de1461014a578063bcc91a101461015d578063c81a396e14610170578063c94dca9a14610185575b600080fd5b6100b16100ac3660046108ad565b610198565b60405190151581526020015b60405180910390f35b6100b16100d43660046108df565b6101cf565b6001546100ec906001600160a01b031681565b6040516100bd9190610922565b61010c610107366004610936565b610225565b005b6100ec61011c3660046109bb565b6102bd565b6101296102ca565b6040519081526020016100bd565b61010c6101453660046109d4565b6102db565b61010c6101583660046109d4565b61035b565b61010c61016b3660046109ef565b610413565b610178610579565b6040516100bd9190610a22565b61010c6101933660046109d4565b610607565b60006001600160e01b03198216633001c1ef60e21b14806101c957506301ffc9a760e01b6001600160e01b03198316145b92915050565b6001546000906001600160a01b03908116908516036101f05750600161021e565b638911905560e01b6001600160e01b031983160161021a576102136002856106bc565b905061021e565b5060005b9392505050565b6001546001600160a01b031633146102585760405162461bcd60e51b815260040161024f90610a71565b60405180910390fd5b600180546001600160a01b038581166001600160a01b0319831681179093556040519116919082907f3f6845104f9728af7979eed8814320daba008953c8db93b9fe32602d1f34b475906102af9087908790610a9a565b60405180910390a350505050565b60006101c96002836106d1565b60006102d660026106dd565b905090565b6001546001600160a01b031633146103055760405162461bcd60e51b815260040161024f90610a71565b806001600160a01b031663715018a66040518163ffffffff1660e01b8152600401600060405180830381600087803b15801561034057600080fd5b505af1158015610354573d6000803e3d6000fd5b5050505050565b6001546001600160a01b031633146103855760405162461bcd60e51b815260040161024f90610a71565b6103906002826106e7565b6103dc5760405162461bcd60e51b815260206004820152601e60248201527f41646d696e41434c56313a20416c726561647920726567697374657265640000604482015260640161024f565b6040516001600160a01b038216907fcfa45e813a030b8a5edb7a194db400758a7838280a892097169e8bc310a6bc9390600090a250565b6001546001600160a01b0316331461043d5760405162461bcd60e51b815260040161024f90610a71565b6040516301ffc9a760e01b8152633001c1ef60e21b60048201526001600160a01b038216906301ffc9a790602401602060405180830381865afa158015610488573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906104ac9190610ae6565b6105175760405162461bcd60e51b815260206004820152603660248201527f41646d696e41434c56313a206e65772061646d696e2041434c20646f6573206e60448201527506f7420737570706f7274204941646d696e41434c56360541b606482015260840161024f565b60405163f2fde38b60e01b81526001600160a01b0383169063f2fde38b90610543908490600401610922565b600060405180830381600087803b15801561055d57600080fd5b505af1158015610571573d6000803e3d6000fd5b505050505050565b6000805461058690610b08565b80601f01602080910402602001604051908101604052809291908181526020018280546105b290610b08565b80156105ff5780601f106105d4576101008083540402835291602001916105ff565b820191906000526020600020905b8154815290600101906020018083116105e257829003601f168201915b505050505081565b6001546001600160a01b031633146106315760405162461bcd60e51b815260040161024f90610a71565b61063c6002826106fc565b6106855760405162461bcd60e51b815260206004820152601a60248201527910591b5a5b9050d3158c4e88139bdd081c9959da5cdd195c995960321b604482015260640161024f565b6040516001600160a01b038216907ff1de73f684ba2cffe486a26456673d031647e0c7964095865ed8e159873edde290600090a250565b600061021e836001600160a01b038416610711565b600061021e8383610729565b60006101c9825490565b600061021e836001600160a01b038416610753565b600061021e836001600160a01b03841661079d565b60009081526001919091016020526040902054151590565b600082600001828154811061074057610740610b42565b9060005260206000200154905092915050565b600061075f8383610711565b610795575081546001818101845560008481526020808220909301849055845484825282860190935260409020919091556101c9565b5060006101c9565b600081815260018301602052604081205480156108865760006107c1600183610b58565b85549091506000906107d590600190610b58565b905081811461083a5760008660000182815481106107f5576107f5610b42565b906000526020600020015490508087600001848154811061081857610818610b42565b6000918252602080832090910192909255918252600188019052604090208390555b855486908061084b5761084b610b79565b6001900381819060005260206000200160009055905585600101600086815260200190815260200160002060009055600193505050506101c9565b60009150506101c9565b80356001600160e01b0319811681146108a857600080fd5b919050565b6000602082840312156108bf57600080fd5b61021e82610890565b80356001600160a01b03811681146108a857600080fd5b6000806000606084860312156108f457600080fd5b6108fd846108c8565b925061090b602085016108c8565b915061091960408501610890565b90509250925092565b6001600160a01b0391909116815260200190565b60008060006040848603121561094b57600080fd5b610954846108c8565b925060208401356001600160401b038082111561097057600080fd5b818601915086601f83011261098457600080fd5b81358181111561099357600080fd5b8760208260051b85010111156109a857600080fd5b6020830194508093505050509250925092565b6000602082840312156109cd57600080fd5b5035919050565b6000602082840312156109e657600080fd5b61021e826108c8565b60008060408385031215610a0257600080fd5b610a0b836108c8565b9150610a19602084016108c8565b90509250929050565b60006020808352835180602085015260005b81811015610a5057858101830151858201604001528201610a34565b506000604082860101526040601f19601f8301168501019250505092915050565b6020808252600f908201526e27b7363c9039bab832b920b236b4b760891b604082015260600190565b60208082528181018390526000908460408401835b86811015610adb576001600160a01b03610ac8846108c8565b1682529183019190830190600101610aaf565b509695505050505050565b600060208284031215610af857600080fd5b8151801515811461021e57600080fd5b600181811c90821680610b1c57607f821691505b602082108103610b3c57634e487b7160e01b600052602260045260246000fd5b50919050565b634e487b7160e01b600052603260045260246000fd5b818103818111156101c957634e487b7160e01b600052601160045260246000fd5b634e487b7160e01b600052603160045260246000fdfea264697066735822122021c9dc9012b0dafb2ceec8d1e707fbfa80197a40ab68ad58df060f078acad5c264736f6c63430008160033",
-  "deployedBytecode": "0x608060405234801561001057600080fd5b50600436106100995760003560e01c806301ffc9a71461009e57806305de62c0146100c657806329575f6a146100d9578063377a7d1a146100f9578063625e1b7d1461010e578063940ef80014610121578063985d196814610137578063ad35d2de1461014a578063bcc91a101461015d578063c81a396e14610170578063c94dca9a14610185575b600080fd5b6100b16100ac3660046108ad565b610198565b60405190151581526020015b60405180910390f35b6100b16100d43660046108df565b6101cf565b6001546100ec906001600160a01b031681565b6040516100bd9190610922565b61010c610107366004610936565b610225565b005b6100ec61011c3660046109bb565b6102bd565b6101296102ca565b6040519081526020016100bd565b61010c6101453660046109d4565b6102db565b61010c6101583660046109d4565b61035b565b61010c61016b3660046109ef565b610413565b610178610579565b6040516100bd9190610a22565b61010c6101933660046109d4565b610607565b60006001600160e01b03198216633001c1ef60e21b14806101c957506301ffc9a760e01b6001600160e01b03198316145b92915050565b6001546000906001600160a01b03908116908516036101f05750600161021e565b638911905560e01b6001600160e01b031983160161021a576102136002856106bc565b905061021e565b5060005b9392505050565b6001546001600160a01b031633146102585760405162461bcd60e51b815260040161024f90610a71565b60405180910390fd5b600180546001600160a01b038581166001600160a01b0319831681179093556040519116919082907f3f6845104f9728af7979eed8814320daba008953c8db93b9fe32602d1f34b475906102af9087908790610a9a565b60405180910390a350505050565b60006101c96002836106d1565b60006102d660026106dd565b905090565b6001546001600160a01b031633146103055760405162461bcd60e51b815260040161024f90610a71565b806001600160a01b031663715018a66040518163ffffffff1660e01b8152600401600060405180830381600087803b15801561034057600080fd5b505af1158015610354573d6000803e3d6000fd5b5050505050565b6001546001600160a01b031633146103855760405162461bcd60e51b815260040161024f90610a71565b6103906002826106e7565b6103dc5760405162461bcd60e51b815260206004820152601e60248201527f41646d696e41434c56313a20416c726561647920726567697374657265640000604482015260640161024f565b6040516001600160a01b038216907fcfa45e813a030b8a5edb7a194db400758a7838280a892097169e8bc310a6bc9390600090a250565b6001546001600160a01b0316331461043d5760405162461bcd60e51b815260040161024f90610a71565b6040516301ffc9a760e01b8152633001c1ef60e21b60048201526001600160a01b038216906301ffc9a790602401602060405180830381865afa158015610488573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906104ac9190610ae6565b6105175760405162461bcd60e51b815260206004820152603660248201527f41646d696e41434c56313a206e65772061646d696e2041434c20646f6573206e60448201527506f7420737570706f7274204941646d696e41434c56360541b606482015260840161024f565b60405163f2fde38b60e01b81526001600160a01b0383169063f2fde38b90610543908490600401610922565b600060405180830381600087803b15801561055d57600080fd5b505af1158015610571573d6000803e3d6000fd5b505050505050565b6000805461058690610b08565b80601f01602080910402602001604051908101604052809291908181526020018280546105b290610b08565b80156105ff5780601f106105d4576101008083540402835291602001916105ff565b820191906000526020600020905b8154815290600101906020018083116105e257829003601f168201915b505050505081565b6001546001600160a01b031633146106315760405162461bcd60e51b815260040161024f90610a71565b61063c6002826106fc565b6106855760405162461bcd60e51b815260206004820152601a60248201527910591b5a5b9050d3158c4e88139bdd081c9959da5cdd195c995960321b604482015260640161024f565b6040516001600160a01b038216907ff1de73f684ba2cffe486a26456673d031647e0c7964095865ed8e159873edde290600090a250565b600061021e836001600160a01b038416610711565b600061021e8383610729565b60006101c9825490565b600061021e836001600160a01b038416610753565b600061021e836001600160a01b03841661079d565b60009081526001919091016020526040902054151590565b600082600001828154811061074057610740610b42565b9060005260206000200154905092915050565b600061075f8383610711565b610795575081546001818101845560008481526020808220909301849055845484825282860190935260409020919091556101c9565b5060006101c9565b600081815260018301602052604081205480156108865760006107c1600183610b58565b85549091506000906107d590600190610b58565b905081811461083a5760008660000182815481106107f5576107f5610b42565b906000526020600020015490508087600001848154811061081857610818610b42565b6000918252602080832090910192909255918252600188019052604090208390555b855486908061084b5761084b610b79565b6001900381819060005260206000200160009055905585600101600086815260200190815260200160002060009055600193505050506101c9565b60009150506101c9565b80356001600160e01b0319811681146108a857600080fd5b919050565b6000602082840312156108bf57600080fd5b61021e82610890565b80356001600160a01b03811681146108a857600080fd5b6000806000606084860312156108f457600080fd5b6108fd846108c8565b925061090b602085016108c8565b915061091960408501610890565b90509250925092565b6001600160a01b0391909116815260200190565b60008060006040848603121561094b57600080fd5b610954846108c8565b925060208401356001600160401b038082111561097057600080fd5b818601915086601f83011261098457600080fd5b81358181111561099357600080fd5b8760208260051b85010111156109a857600080fd5b6020830194508093505050509250925092565b6000602082840312156109cd57600080fd5b5035919050565b6000602082840312156109e657600080fd5b61021e826108c8565b60008060408385031215610a0257600080fd5b610a0b836108c8565b9150610a19602084016108c8565b90509250929050565b60006020808352835180602085015260005b81811015610a5057858101830151858201604001528201610a34565b506000604082860101526040601f19601f8301168501019250505092915050565b6020808252600f908201526e27b7363c9039bab832b920b236b4b760891b604082015260600190565b60208082528181018390526000908460408401835b86811015610adb576001600160a01b03610ac8846108c8565b1682529183019190830190600101610aaf565b509695505050505050565b600060208284031215610af857600080fd5b8151801515811461021e57600080fd5b600181811c90821680610b1c57607f821691505b602082108103610b3c57634e487b7160e01b600052602260045260246000fd5b50919050565b634e487b7160e01b600052603260045260246000fd5b818103818111156101c957634e487b7160e01b600052601160045260246000fd5b634e487b7160e01b600052603160045260246000fdfea264697066735822122021c9dc9012b0dafb2ceec8d1e707fbfa80197a40ab68ad58df060f078acad5c264736f6c63430008160033",
+  "bytecode": "0x60c0604052600a60809081526941646d696e41434c563160b01b60a0526000906200002b9082620000f9565b503480156200003957600080fd5b50600180546001600160a01b03191633179055620001c5565b634e487b7160e01b600052604160045260246000fd5b600181811c908216806200007d57607f821691505b6020821081036200009e57634e487b7160e01b600052602260045260246000fd5b50919050565b601f821115620000f4576000816000526020600020601f850160051c81016020861015620000cf5750805b601f850160051c820191505b81811015620000f057828155600101620000db565b5050505b505050565b81516001600160401b0381111562000115576200011562000052565b6200012d8162000126845462000068565b84620000a4565b602080601f8311600181146200016557600084156200014c5750858301515b600019600386901b1c1916600185901b178555620000f0565b600085815260208120601f198616915b82811015620001965788860151825594840194600190910190840162000175565b5085821015620001b55787850151600019600388901b60f8161c191681555b5050505050600190811b01905550565b610bc580620001d56000396000f3fe608060405234801561001057600080fd5b50600436106100995760003560e01c806301ffc9a71461009e57806305de62c0146100c657806329575f6a146100d9578063377a7d1a146100f9578063625e1b7d1461010e578063940ef80014610121578063985d196814610137578063ad35d2de1461014a578063bcc91a101461015d578063c81a396e14610170578063c94dca9a14610185575b600080fd5b6100b16100ac3660046108ad565b610198565b60405190151581526020015b60405180910390f35b6100b16100d43660046108df565b6101cf565b6001546100ec906001600160a01b031681565b6040516100bd9190610922565b61010c610107366004610936565b610225565b005b6100ec61011c3660046109bb565b6102bd565b6101296102ca565b6040519081526020016100bd565b61010c6101453660046109d4565b6102db565b61010c6101583660046109d4565b61035b565b61010c61016b3660046109ef565b610413565b610178610579565b6040516100bd9190610a22565b61010c6101933660046109d4565b610607565b60006001600160e01b03198216633001c1ef60e21b14806101c957506301ffc9a760e01b6001600160e01b03198316145b92915050565b6001546000906001600160a01b03908116908516036101f05750600161021e565b638911905560e01b6001600160e01b031983160161021a576102136002856106bc565b905061021e565b5060005b9392505050565b6001546001600160a01b031633146102585760405162461bcd60e51b815260040161024f90610a71565b60405180910390fd5b600180546001600160a01b038581166001600160a01b0319831681179093556040519116919082907f3f6845104f9728af7979eed8814320daba008953c8db93b9fe32602d1f34b475906102af9087908790610a9a565b60405180910390a350505050565b60006101c96002836106d1565b60006102d660026106dd565b905090565b6001546001600160a01b031633146103055760405162461bcd60e51b815260040161024f90610a71565b806001600160a01b031663715018a66040518163ffffffff1660e01b8152600401600060405180830381600087803b15801561034057600080fd5b505af1158015610354573d6000803e3d6000fd5b5050505050565b6001546001600160a01b031633146103855760405162461bcd60e51b815260040161024f90610a71565b6103906002826106e7565b6103dc5760405162461bcd60e51b815260206004820152601e60248201527f41646d696e41434c56313a20416c726561647920726567697374657265640000604482015260640161024f565b6040516001600160a01b038216907fcfa45e813a030b8a5edb7a194db400758a7838280a892097169e8bc310a6bc9390600090a250565b6001546001600160a01b0316331461043d5760405162461bcd60e51b815260040161024f90610a71565b6040516301ffc9a760e01b8152633001c1ef60e21b60048201526001600160a01b038216906301ffc9a790602401602060405180830381865afa158015610488573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906104ac9190610ae6565b6105175760405162461bcd60e51b815260206004820152603660248201527f41646d696e41434c56313a206e65772061646d696e2041434c20646f6573206e60448201527506f7420737570706f7274204941646d696e41434c56360541b606482015260840161024f565b60405163f2fde38b60e01b81526001600160a01b0383169063f2fde38b90610543908490600401610922565b600060405180830381600087803b15801561055d57600080fd5b505af1158015610571573d6000803e3d6000fd5b505050505050565b6000805461058690610b08565b80601f01602080910402602001604051908101604052809291908181526020018280546105b290610b08565b80156105ff5780601f106105d4576101008083540402835291602001916105ff565b820191906000526020600020905b8154815290600101906020018083116105e257829003601f168201915b505050505081565b6001546001600160a01b031633146106315760405162461bcd60e51b815260040161024f90610a71565b61063c6002826106fc565b6106855760405162461bcd60e51b815260206004820152601a60248201527910591b5a5b9050d3158c4e88139bdd081c9959da5cdd195c995960321b604482015260640161024f565b6040516001600160a01b038216907ff1de73f684ba2cffe486a26456673d031647e0c7964095865ed8e159873edde290600090a250565b600061021e836001600160a01b038416610711565b600061021e8383610729565b60006101c9825490565b600061021e836001600160a01b038416610753565b600061021e836001600160a01b03841661079d565b60009081526001919091016020526040902054151590565b600082600001828154811061074057610740610b42565b9060005260206000200154905092915050565b600061075f8383610711565b610795575081546001818101845560008481526020808220909301849055845484825282860190935260409020919091556101c9565b5060006101c9565b600081815260018301602052604081205480156108865760006107c1600183610b58565b85549091506000906107d590600190610b58565b905081811461083a5760008660000182815481106107f5576107f5610b42565b906000526020600020015490508087600001848154811061081857610818610b42565b6000918252602080832090910192909255918252600188019052604090208390555b855486908061084b5761084b610b79565b6001900381819060005260206000200160009055905585600101600086815260200190815260200160002060009055600193505050506101c9565b60009150506101c9565b80356001600160e01b0319811681146108a857600080fd5b919050565b6000602082840312156108bf57600080fd5b61021e82610890565b80356001600160a01b03811681146108a857600080fd5b6000806000606084860312156108f457600080fd5b6108fd846108c8565b925061090b602085016108c8565b915061091960408501610890565b90509250925092565b6001600160a01b0391909116815260200190565b60008060006040848603121561094b57600080fd5b610954846108c8565b925060208401356001600160401b038082111561097057600080fd5b818601915086601f83011261098457600080fd5b81358181111561099357600080fd5b8760208260051b85010111156109a857600080fd5b6020830194508093505050509250925092565b6000602082840312156109cd57600080fd5b5035919050565b6000602082840312156109e657600080fd5b61021e826108c8565b60008060408385031215610a0257600080fd5b610a0b836108c8565b9150610a19602084016108c8565b90509250929050565b60006020808352835180602085015260005b81811015610a5057858101830151858201604001528201610a34565b506000604082860101526040601f19601f8301168501019250505092915050565b6020808252600f908201526e27b7363c9039bab832b920b236b4b760891b604082015260600190565b60208082528181018390526000908460408401835b86811015610adb576001600160a01b03610ac8846108c8565b1682529183019190830190600101610aaf565b509695505050505050565b600060208284031215610af857600080fd5b8151801515811461021e57600080fd5b600181811c90821680610b1c57607f821691505b602082108103610b3c57634e487b7160e01b600052602260045260246000fd5b50919050565b634e487b7160e01b600052603260045260246000fd5b818103818111156101c957634e487b7160e01b600052601160045260246000fd5b634e487b7160e01b600052603160045260246000fdfea26469706673582212207f235aa7318fe8fe82ea53d1b91b5a2728967962b62574a24ca96c00f94fe98464736f6c63430008160033",
+  "deployedBytecode": "0x608060405234801561001057600080fd5b50600436106100995760003560e01c806301ffc9a71461009e57806305de62c0146100c657806329575f6a146100d9578063377a7d1a146100f9578063625e1b7d1461010e578063940ef80014610121578063985d196814610137578063ad35d2de1461014a578063bcc91a101461015d578063c81a396e14610170578063c94dca9a14610185575b600080fd5b6100b16100ac3660046108ad565b610198565b60405190151581526020015b60405180910390f35b6100b16100d43660046108df565b6101cf565b6001546100ec906001600160a01b031681565b6040516100bd9190610922565b61010c610107366004610936565b610225565b005b6100ec61011c3660046109bb565b6102bd565b6101296102ca565b6040519081526020016100bd565b61010c6101453660046109d4565b6102db565b61010c6101583660046109d4565b61035b565b61010c61016b3660046109ef565b610413565b610178610579565b6040516100bd9190610a22565b61010c6101933660046109d4565b610607565b60006001600160e01b03198216633001c1ef60e21b14806101c957506301ffc9a760e01b6001600160e01b03198316145b92915050565b6001546000906001600160a01b03908116908516036101f05750600161021e565b638911905560e01b6001600160e01b031983160161021a576102136002856106bc565b905061021e565b5060005b9392505050565b6001546001600160a01b031633146102585760405162461bcd60e51b815260040161024f90610a71565b60405180910390fd5b600180546001600160a01b038581166001600160a01b0319831681179093556040519116919082907f3f6845104f9728af7979eed8814320daba008953c8db93b9fe32602d1f34b475906102af9087908790610a9a565b60405180910390a350505050565b60006101c96002836106d1565b60006102d660026106dd565b905090565b6001546001600160a01b031633146103055760405162461bcd60e51b815260040161024f90610a71565b806001600160a01b031663715018a66040518163ffffffff1660e01b8152600401600060405180830381600087803b15801561034057600080fd5b505af1158015610354573d6000803e3d6000fd5b5050505050565b6001546001600160a01b031633146103855760405162461bcd60e51b815260040161024f90610a71565b6103906002826106e7565b6103dc5760405162461bcd60e51b815260206004820152601e60248201527f41646d696e41434c56313a20416c726561647920726567697374657265640000604482015260640161024f565b6040516001600160a01b038216907fcfa45e813a030b8a5edb7a194db400758a7838280a892097169e8bc310a6bc9390600090a250565b6001546001600160a01b0316331461043d5760405162461bcd60e51b815260040161024f90610a71565b6040516301ffc9a760e01b8152633001c1ef60e21b60048201526001600160a01b038216906301ffc9a790602401602060405180830381865afa158015610488573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906104ac9190610ae6565b6105175760405162461bcd60e51b815260206004820152603660248201527f41646d696e41434c56313a206e65772061646d696e2041434c20646f6573206e60448201527506f7420737570706f7274204941646d696e41434c56360541b606482015260840161024f565b60405163f2fde38b60e01b81526001600160a01b0383169063f2fde38b90610543908490600401610922565b600060405180830381600087803b15801561055d57600080fd5b505af1158015610571573d6000803e3d6000fd5b505050505050565b6000805461058690610b08565b80601f01602080910402602001604051908101604052809291908181526020018280546105b290610b08565b80156105ff5780601f106105d4576101008083540402835291602001916105ff565b820191906000526020600020905b8154815290600101906020018083116105e257829003601f168201915b505050505081565b6001546001600160a01b031633146106315760405162461bcd60e51b815260040161024f90610a71565b61063c6002826106fc565b6106855760405162461bcd60e51b815260206004820152601a60248201527910591b5a5b9050d3158c4e88139bdd081c9959da5cdd195c995960321b604482015260640161024f565b6040516001600160a01b038216907ff1de73f684ba2cffe486a26456673d031647e0c7964095865ed8e159873edde290600090a250565b600061021e836001600160a01b038416610711565b600061021e8383610729565b60006101c9825490565b600061021e836001600160a01b038416610753565b600061021e836001600160a01b03841661079d565b60009081526001919091016020526040902054151590565b600082600001828154811061074057610740610b42565b9060005260206000200154905092915050565b600061075f8383610711565b610795575081546001818101845560008481526020808220909301849055845484825282860190935260409020919091556101c9565b5060006101c9565b600081815260018301602052604081205480156108865760006107c1600183610b58565b85549091506000906107d590600190610b58565b905081811461083a5760008660000182815481106107f5576107f5610b42565b906000526020600020015490508087600001848154811061081857610818610b42565b6000918252602080832090910192909255918252600188019052604090208390555b855486908061084b5761084b610b79565b6001900381819060005260206000200160009055905585600101600086815260200190815260200160002060009055600193505050506101c9565b60009150506101c9565b80356001600160e01b0319811681146108a857600080fd5b919050565b6000602082840312156108bf57600080fd5b61021e82610890565b80356001600160a01b03811681146108a857600080fd5b6000806000606084860312156108f457600080fd5b6108fd846108c8565b925061090b602085016108c8565b915061091960408501610890565b90509250925092565b6001600160a01b0391909116815260200190565b60008060006040848603121561094b57600080fd5b610954846108c8565b925060208401356001600160401b038082111561097057600080fd5b818601915086601f83011261098457600080fd5b81358181111561099357600080fd5b8760208260051b85010111156109a857600080fd5b6020830194508093505050509250925092565b6000602082840312156109cd57600080fd5b5035919050565b6000602082840312156109e657600080fd5b61021e826108c8565b60008060408385031215610a0257600080fd5b610a0b836108c8565b9150610a19602084016108c8565b90509250929050565b60006020808352835180602085015260005b81811015610a5057858101830151858201604001528201610a34565b506000604082860101526040601f19601f8301168501019250505092915050565b6020808252600f908201526e27b7363c9039bab832b920b236b4b760891b604082015260600190565b60208082528181018390526000908460408401835b86811015610adb576001600160a01b03610ac8846108c8565b1682529183019190830190600101610aaf565b509695505050505050565b600060208284031215610af857600080fd5b8151801515811461021e57600080fd5b600181811c90821680610b1c57607f821691505b602082108103610b3c57634e487b7160e01b600052602260045260246000fd5b50919050565b634e487b7160e01b600052603260045260246000fd5b818103818111156101c957634e487b7160e01b600052601160045260246000fd5b634e487b7160e01b600052603160045260246000fdfea26469706673582212207f235aa7318fe8fe82ea53d1b91b5a2728967962b62574a24ca96c00f94fe98464736f6c63430008160033",
   "linkReferences": {},
   "deployedLinkReferences": {}
 }

package/artifacts/contracts/BytecodeStorageReaders/BytecodeStorageReaderContractV2.sol/BytecodeStorageReaderContractV2.json

@@ -0,0 +1,201 @@
+{
+  "_format": "hh-sol-artifact-1",
+  "contractName": "BytecodeStorageReaderContractV2",
+  "sourceName": "contracts/BytecodeStorageReaders/BytecodeStorageReaderContractV2.sol",
+  "abi": [
+    {
+      "inputs": [],
+      "name": "VERSION",
+      "outputs": [
+        {
+          "internalType": "string",
+          "name": "",
+          "type": "string"
+        }
+      ],
+      "stateMutability": "view",
+      "type": "function"
+    },
+    {
+      "inputs": [
+        {
+          "internalType": "address",
+          "name": "_address",
+          "type": "address"
+        }
+      ],
+      "name": "getIsCompressedForBytecode",
+      "outputs": [
+        {
+          "internalType": "bool",
+          "name": "",
+          "type": "bool"
+        }
+      ],
+      "stateMutability": "view",
+      "type": "function"
+    },
+    {
+      "inputs": [
+        {
+          "internalType": "address",
+          "name": "address_",
+          "type": "address"
+        }
+      ],
+      "name": "getLibraryVersionForBytecode",
+      "outputs": [
+        {
+          "internalType": "bytes32",
+          "name": "",
+          "type": "bytes32"
+        }
+      ],
+      "stateMutability": "view",
+      "type": "function"
+    },
+    {
+      "inputs": [
+        {
+          "internalType": "address",
+          "name": "address_",
+          "type": "address"
+        }
+      ],
+      "name": "getWriterAddressForBytecode",
+      "outputs": [
+        {
+          "internalType": "address",
+          "name": "",
+          "type": "address"
+        }
+      ],
+      "stateMutability": "view",
+      "type": "function"
+    },
+    {
+      "inputs": [
+        {
+          "internalType": "address",
+          "name": "address_",
+          "type": "address"
+        },
+        {
+          "internalType": "uint256",
+          "name": "offset",
+          "type": "uint256"
+        }
+      ],
+      "name": "readBytesFromBytecode",
+      "outputs": [
+        {
+          "internalType": "bytes",
+          "name": "",
+          "type": "bytes"
+        }
+      ],
+      "stateMutability": "view",
+      "type": "function"
+    },
+    {
+      "inputs": [
+        {
+          "internalType": "address",
+          "name": "address_",
+          "type": "address"
+        }
+      ],
+      "name": "readBytesFromSSTORE2Bytecode",
+      "outputs": [
+        {
+          "internalType": "bytes",
+          "name": "",
+          "type": "bytes"
+        }
+      ],
+      "stateMutability": "view",
+      "type": "function"
+    },
+    {
+      "inputs": [
+        {
+          "internalType": "address",
+          "name": "address_",
+          "type": "address"
+        }
+      ],
+      "name": "readFromBytecode",
+      "outputs": [
+        {
+          "internalType": "string",
+          "name": "",
+          "type": "string"
+        }
+      ],
+      "stateMutability": "view",
+      "type": "function"
+    }
+  ],
+  "bytecode": "0x608060405234801561001057600080fd5b5061068e806100206000396000f3fe608060405234801561001057600080fd5b506004361061006d5760003560e01c80632475d7091461007257806342e832e01461009b57806375662f38146100bb57806387630c15146100ce578063cc31a331146100e1578063f667001414610102578063ffa1ad7414610125575b600080fd5b610085610080366004610467565b610161565b60405161009291906104d4565b60405180910390f35b6100ae6100a9366004610467565b6101ef565b60405161009291906104e7565b6100856100c9366004610467565b610273565b6100856100dc3660046104fb565b6102b6565b6100f46100ef366004610467565b610347565b604051908152602001610092565b610115610110366004610467565b6103cb565b6040519015158152602001610092565b6100856040518060400160405280601f81526020017f42797465636f646553746f72616765526561646572436f6e747261637456320081525081565b604051632475d70960e01b815260609073__$a84cab3dc26412b6358fa38e3bc69cb812$__90632475d709906101a4906001600160a01b038616906004016104e7565b600060405180830381865af41580156101c1573d6000803e3d6000fd5b505050506040513d6000823e601f3d908101601f191682016040526101e991908101906105b0565b92915050565b604051630217419760e51b815260009073__$a84cab3dc26412b6358fa38e3bc69cb812$__906342e832e090610232906001600160a01b038616906004016104e7565b602060405180830381865af415801561024f573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906101e99190610600565b604051630eacc5e760e31b815260609073__$a84cab3dc26412b6358fa38e3bc69cb812$__906375662f38906101a4906001600160a01b038616906004016104e7565b6040516387630c1560e01b81526001600160a01b03831660048201526024810182905260609073__$a84cab3dc26412b6358fa38e3bc69cb812$__906387630c1590604401600060405180830381865af4158015610318573d6000803e3d6000fd5b505050506040513d6000823e601f3d908101601f1916820160405261034091908101906105b0565b9392505050565b60405163cc31a33160e01b815260009073__$a84cab3dc26412b6358fa38e3bc69cb812$__9063cc31a3319061038a906001600160a01b038616906004016104e7565b602060405180830381865af41580156103a7573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906101e9919061061d565b604051633d99c00560e21b815260009073__$a84cab3dc26412b6358fa38e3bc69cb812$__9063f66700149061040e906001600160a01b038616906004016104e7565b602060405180830381865af415801561042b573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906101e99190610636565b6001600160a01b038116811461046457600080fd5b50565b60006020828403121561047957600080fd5b81356103408161044f565b60005b8381101561049f578181015183820152602001610487565b50506000910152565b600081518084526104c0816020860160208601610484565b601f01601f19169290920160200192915050565b60208152600061034060208301846104a8565b6001600160a01b0391909116815260200190565b6000806040838503121561050e57600080fd5b82356105198161044f565b946020939093013593505050565b634e487b7160e01b600052604160045260246000fd5b60006001600160401b038084111561055757610557610527565b604051601f8501601f19908116603f0116810190828211818310171561057f5761057f610527565b8160405280935085815286868601111561059857600080fd5b6105a6866020830187610484565b5050509392505050565b6000602082840312156105c257600080fd5b81516001600160401b038111156105d857600080fd5b8201601f810184136105e957600080fd5b6105f88482516020840161053d565b949350505050565b60006020828403121561061257600080fd5b81516103408161044f565b60006020828403121561062f57600080fd5b5051919050565b60006020828403121561064857600080fd5b8151801515811461034057600080fdfea2646970667358221220ef0253bebe4c2f2d6891dd12a1a41ccb8f1ba55bea1074e97b068ddd256eebf064736f6c63430008160033",
+  "deployedBytecode": "0x608060405234801561001057600080fd5b506004361061006d5760003560e01c80632475d7091461007257806342e832e01461009b57806375662f38146100bb57806387630c15146100ce578063cc31a331146100e1578063f667001414610102578063ffa1ad7414610125575b600080fd5b610085610080366004610467565b610161565b60405161009291906104d4565b60405180910390f35b6100ae6100a9366004610467565b6101ef565b60405161009291906104e7565b6100856100c9366004610467565b610273565b6100856100dc3660046104fb565b6102b6565b6100f46100ef366004610467565b610347565b604051908152602001610092565b610115610110366004610467565b6103cb565b6040519015158152602001610092565b6100856040518060400160405280601f81526020017f42797465636f646553746f72616765526561646572436f6e747261637456320081525081565b604051632475d70960e01b815260609073__$a84cab3dc26412b6358fa38e3bc69cb812$__90632475d709906101a4906001600160a01b038616906004016104e7565b600060405180830381865af41580156101c1573d6000803e3d6000fd5b505050506040513d6000823e601f3d908101601f191682016040526101e991908101906105b0565b92915050565b604051630217419760e51b815260009073__$a84cab3dc26412b6358fa38e3bc69cb812$__906342e832e090610232906001600160a01b038616906004016104e7565b602060405180830381865af415801561024f573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906101e99190610600565b604051630eacc5e760e31b815260609073__$a84cab3dc26412b6358fa38e3bc69cb812$__906375662f38906101a4906001600160a01b038616906004016104e7565b6040516387630c1560e01b81526001600160a01b03831660048201526024810182905260609073__$a84cab3dc26412b6358fa38e3bc69cb812$__906387630c1590604401600060405180830381865af4158015610318573d6000803e3d6000fd5b505050506040513d6000823e601f3d908101601f1916820160405261034091908101906105b0565b9392505050565b60405163cc31a33160e01b815260009073__$a84cab3dc26412b6358fa38e3bc69cb812$__9063cc31a3319061038a906001600160a01b038616906004016104e7565b602060405180830381865af41580156103a7573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906101e9919061061d565b604051633d99c00560e21b815260009073__$a84cab3dc26412b6358fa38e3bc69cb812$__9063f66700149061040e906001600160a01b038616906004016104e7565b602060405180830381865af415801561042b573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906101e99190610636565b6001600160a01b038116811461046457600080fd5b50565b60006020828403121561047957600080fd5b81356103408161044f565b60005b8381101561049f578181015183820152602001610487565b50506000910152565b600081518084526104c0816020860160208601610484565b601f01601f19169290920160200192915050565b60208152600061034060208301846104a8565b6001600160a01b0391909116815260200190565b6000806040838503121561050e57600080fd5b82356105198161044f565b946020939093013593505050565b634e487b7160e01b600052604160045260246000fd5b60006001600160401b038084111561055757610557610527565b604051601f8501601f19908116603f0116810190828211818310171561057f5761057f610527565b8160405280935085815286868601111561059857600080fd5b6105a6866020830187610484565b5050509392505050565b6000602082840312156105c257600080fd5b81516001600160401b038111156105d857600080fd5b8201601f810184136105e957600080fd5b6105f88482516020840161053d565b949350505050565b60006020828403121561061257600080fd5b81516103408161044f565b60006020828403121561062f57600080fd5b5051919050565b60006020828403121561064857600080fd5b8151801515811461034057600080fdfea2646970667358221220ef0253bebe4c2f2d6891dd12a1a41ccb8f1ba55bea1074e97b068ddd256eebf064736f6c63430008160033",
+  "linkReferences": {
+    "contracts/libs/v0.8.x/BytecodeStorageV2.sol": {
+      "BytecodeStorageReader": [
+        {
+          "length": 20,
+          "start": 403
+        },
+        {
+          "length": 20,
+          "start": 545
+        },
+        {
+          "length": 20,
+          "start": 677
+        },
+        {
+          "length": 20,
+          "start": 766
+        },
+        {
+          "length": 20,
+          "start": 889
+        },
+        {
+          "length": 20,
+          "start": 1021
+        }
+      ]
+    }
+  },
+  "deployedLinkReferences": {
+    "contracts/libs/v0.8.x/BytecodeStorageV2.sol": {
+      "BytecodeStorageReader": [
+        {
+          "length": 20,
+          "start": 371
+        },
+        {
+          "length": 20,
+          "start": 513
+        },
+        {
+          "length": 20,
+          "start": 645
+        },
+        {
+          "length": 20,
+          "start": 734
+        },
+        {
+          "length": 20,
+          "start": 857
+        },
+        {
+          "length": 20,
+          "start": 989
+        }
+      ]
+    }
+  }
+}

package/artifacts/contracts/BytecodeStorageReaders/UniversalBytecodeStorageReader.sol/UniversalBytecodeStorageReader.json

@@ -0,0 +1,154 @@
+{
+  "_format": "hh-sol-artifact-1",
+  "contractName": "UniversalBytecodeStorageReader",
+  "sourceName": "contracts/BytecodeStorageReaders/UniversalBytecodeStorageReader.sol",
+  "abi": [
+    {
+      "inputs": [
+        {
+          "internalType": "address",
+          "name": "owner_",
+          "type": "address"
+        }
+      ],
+      "stateMutability": "nonpayable",
+      "type": "constructor"
+    },
+    {
+      "inputs": [
+        {
+          "internalType": "address",
+          "name": "owner",
+          "type": "address"
+        }
+      ],
+      "name": "OwnableInvalidOwner",
+      "type": "error"
+    },
+    {
+      "inputs": [
+        {
+          "internalType": "address",
+          "name": "account",
+          "type": "address"
+        }
+      ],
+      "name": "OwnableUnauthorizedAccount",
+      "type": "error"
+    },
+    {
+      "anonymous": false,
+      "inputs": [
+        {
+          "indexed": true,
+          "internalType": "address",
+          "name": "previousOwner",
+          "type": "address"
+        },
+        {
+          "indexed": true,
+          "internalType": "address",
+          "name": "newOwner",
+          "type": "address"
+        }
+      ],
+      "name": "OwnershipTransferred",
+      "type": "event"
+    },
+    {
+      "anonymous": false,
+      "inputs": [
+        {
+          "indexed": true,
+          "internalType": "address",
+          "name": "activeReader",
+          "type": "address"
+        }
+      ],
+      "name": "ReaderUpdated",
+      "type": "event"
+    },
+    {
+      "inputs": [],
+      "name": "activeBytecodeStorageReaderContract",
+      "outputs": [
+        {
+          "internalType": "contract IBytecodeStorageReader_Base",
+          "name": "",
+          "type": "address"
+        }
+      ],
+      "stateMutability": "view",
+      "type": "function"
+    },
+    {
+      "inputs": [],
+      "name": "owner",
+      "outputs": [
+        {
+          "internalType": "address",
+          "name": "",
+          "type": "address"
+        }
+      ],
+      "stateMutability": "view",
+      "type": "function"
+    },
+    {
+      "inputs": [
+        {
+          "internalType": "address",
+          "name": "address_",
+          "type": "address"
+        }
+      ],
+      "name": "readFromBytecode",
+      "outputs": [
+        {
+          "internalType": "string",
+          "name": "",
+          "type": "string"
+        }
+      ],
+      "stateMutability": "view",
+      "type": "function"
+    },
+    {
+      "inputs": [],
+      "name": "renounceOwnership",
+      "outputs": [],
+      "stateMutability": "nonpayable",
+      "type": "function"
+    },
+    {
+      "inputs": [
+        {
+          "internalType": "address",
+          "name": "newOwner",
+          "type": "address"
+        }
+      ],
+      "name": "transferOwnership",
+      "outputs": [],
+      "stateMutability": "nonpayable",
+      "type": "function"
+    },
+    {
+      "inputs": [
+        {
+          "internalType": "contract IBytecodeStorageReader_Base",
+          "name": "newBytecodeStorageReaderContract",
+          "type": "address"
+        }
+      ],
+      "name": "updateBytecodeStorageReaderContract",
+      "outputs": [],
+      "stateMutability": "nonpayable",
+      "type": "function"
+    }
+  ],
+  "bytecode": "0x608060405234801561001057600080fd5b5060405161053b38038061053b83398101604081905261002f916100be565b806001600160a01b03811661005e57604051631e4fbdf760e01b81526000600482015260240160405180910390fd5b6100678161006e565b50506100ee565b600080546001600160a01b038381166001600160a01b0319831681178455604051919092169283917f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e09190a35050565b6000602082840312156100d057600080fd5b81516001600160a01b03811681146100e757600080fd5b9392505050565b61043e806100fd6000396000f3fe608060405234801561001057600080fd5b50600436106100625760003560e01c806310ba84aa14610067578063715018a61461009057806375662f381461009a5780638da5cb5b146100ba578063993c0cbf146100c2578063f2fde38b146100d5575b600080fd5b60015461007a906001600160a01b031681565b60405161008791906102a2565b60405180910390f35b6100986100e8565b005b6100ad6100a83660046102cb565b6100fc565b6040516100879190610313565b61007a610178565b6100986100d03660046102cb565b610187565b6100986100e33660046102cb565b6101d9565b6100f0610220565b6100fa6000610252565b565b600154604051630eacc5e760e31b81526060916001600160a01b0316906375662f389061012d9085906004016102a2565b600060405180830381865afa15801561014a573d6000803e3d6000fd5b505050506040513d6000823e601f3d908101601f19168201604052610172919081019061035c565b92915050565b6000546001600160a01b031690565b61018f610220565b600180546001600160a01b0319166001600160a01b0383169081179091556040517f9b5e1beb1e6649002b63d33952d5d892fecf9ccc12defdf8800f910b5ddca5a490600090a250565b6101e1610220565b6001600160a01b038116610214576000604051631e4fbdf760e01b815260040161020b91906102a2565b60405180910390fd5b61021d81610252565b50565b33610229610178565b6001600160a01b0316146100fa573360405163118cdaa760e01b815260040161020b91906102a2565b600080546001600160a01b038381166001600160a01b0319831681178455604051919092169283917f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e09190a35050565b6001600160a01b0391909116815260200190565b6001600160a01b038116811461021d57600080fd5b6000602082840312156102dd57600080fd5b81356102e8816102b6565b9392505050565b60005b8381101561030a5781810151838201526020016102f2565b50506000910152565b60208152600082518060208401526103328160408501602087016102ef565b601f01601f19169190910160400192915050565b634e487b7160e01b600052604160045260246000fd5b60006020828403121561036e57600080fd5b81516001600160401b038082111561038557600080fd5b818401915084601f83011261039957600080fd5b8151818111156103ab576103ab610346565b604051601f8201601f19908116603f011681019083821181831017156103d3576103d3610346565b816040528281528760208487010111156103ec57600080fd5b6103fd8360208301602088016102ef565b97965050505050505056fea264697066735822122051090e4b7baca46766af2c37e8123f0c053ae5b9724933aeccb1a7c3aa1e27ba64736f6c63430008160033",
+  "deployedBytecode": "0x608060405234801561001057600080fd5b50600436106100625760003560e01c806310ba84aa14610067578063715018a61461009057806375662f381461009a5780638da5cb5b146100ba578063993c0cbf146100c2578063f2fde38b146100d5575b600080fd5b60015461007a906001600160a01b031681565b60405161008791906102a2565b60405180910390f35b6100986100e8565b005b6100ad6100a83660046102cb565b6100fc565b6040516100879190610313565b61007a610178565b6100986100d03660046102cb565b610187565b6100986100e33660046102cb565b6101d9565b6100f0610220565b6100fa6000610252565b565b600154604051630eacc5e760e31b81526060916001600160a01b0316906375662f389061012d9085906004016102a2565b600060405180830381865afa15801561014a573d6000803e3d6000fd5b505050506040513d6000823e601f3d908101601f19168201604052610172919081019061035c565b92915050565b6000546001600160a01b031690565b61018f610220565b600180546001600160a01b0319166001600160a01b0383169081179091556040517f9b5e1beb1e6649002b63d33952d5d892fecf9ccc12defdf8800f910b5ddca5a490600090a250565b6101e1610220565b6001600160a01b038116610214576000604051631e4fbdf760e01b815260040161020b91906102a2565b60405180910390fd5b61021d81610252565b50565b33610229610178565b6001600160a01b0316146100fa573360405163118cdaa760e01b815260040161020b91906102a2565b600080546001600160a01b038381166001600160a01b0319831681178455604051919092169283917f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e09190a35050565b6001600160a01b0391909116815260200190565b6001600160a01b038116811461021d57600080fd5b6000602082840312156102dd57600080fd5b81356102e8816102b6565b9392505050565b60005b8381101561030a5781810151838201526020016102f2565b50506000910152565b60208152600082518060208401526103328160408501602087016102ef565b601f01601f19169190910160400192915050565b634e487b7160e01b600052604160045260246000fd5b60006020828403121561036e57600080fd5b81516001600160401b038082111561038557600080fd5b818401915084601f83011261039957600080fd5b8151818111156103ab576103ab610346565b604051601f8201601f19908116603f011681019083821181831017156103d3576103d3610346565b816040528281528760208487010111156103ec57600080fd5b6103fd8360208301602088016102ef565b97965050505050505056fea264697066735822122051090e4b7baca46766af2c37e8123f0c053ae5b9724933aeccb1a7c3aa1e27ba64736f6c63430008160033",
+  "linkReferences": {},
+  "deployedLinkReferences": {}
+}

package/artifacts/contracts/BytecodeStorageV2Writer.sol/BytecodeStorageV2Writer.json

@@ -0,0 +1,87 @@
+{
+  "_format": "hh-sol-artifact-1",
+  "contractName": "BytecodeStorageV2Writer",
+  "sourceName": "contracts/BytecodeStorageV2Writer.sol",
+  "abi": [
+    {
+      "anonymous": false,
+      "inputs": [
+        {
+          "indexed": true,
+          "internalType": "address",
+          "name": "storageContract",
+          "type": "address"
+        }
+      ],
+      "name": "StorageContractCreated",
+      "type": "event"
+    },
+    {
+      "inputs": [
+        {
+          "internalType": "string",
+          "name": "_string",
+          "type": "string"
+        }
+      ],
+      "name": "getCompressed",
+      "outputs": [
+        {
+          "internalType": "bytes",
+          "name": "",
+          "type": "bytes"
+        }
+      ],
+      "stateMutability": "pure",
+      "type": "function"
+    },
+    {
+      "inputs": [
+        {
+          "internalType": "bytes",
+          "name": "_compressedString",
+          "type": "bytes"
+        }
+      ],
+      "name": "writeCompressedStringToBytecodeStorage",
+      "outputs": [],
+      "stateMutability": "nonpayable",
+      "type": "function"
+    },
+    {
+      "inputs": [
+        {
+          "internalType": "string",
+          "name": "_string",
+          "type": "string"
+        }
+      ],
+      "name": "writeStringToBytecodeStorage",
+      "outputs": [],
+      "stateMutability": "nonpayable",
+      "type": "function"
+    }
+  ],
+  "bytecode": "0x608060405234801561001057600080fd5b50610582806100206000396000f3fe608060405234801561001057600080fd5b50600436106100415760003560e01c80630e80102f14610046578063489631251461005b578063e32551e71461006e575b600080fd5b610059610054366004610338565b610097565b005b610059610069366004610338565b6100dd565b61008161007c366004610338565b6100e8565b60405161008e91906103d8565b60405180910390f35b60006100a282610175565b6040519091506001600160a01b038216907f9d62591b01a10ac24446b07594d7ca4f37bfb6fa9fe7fbc3281f9022e8bea86690600090a25050565b60006100a282610218565b60606100f38261023e565b60405163e32551e760e01b815273__$a84cab3dc26412b6358fa38e3bc69cb812$__9063e32551e79061012a9085906004016103d8565b600060405180830381865af4158015610147573d6000803e3d6000fd5b505050506040513d6000823e601f3d908101601f1916820160405261016f91908101906103f2565b92915050565b60008060008051602061052d833981519152308460405160200161019b93929190610468565b60405160208183030381529060405290508051602082016000f091506001600160a01b0382166102125760405162461bcd60e51b815260206004820152601e60248201527f436f6e7472616374417353746f726167653a205772697465204572726f72000060448201526064015b60405180910390fd5b50919050565b60008060008051602061052d833981519152308460405160200161019b939291906104d3565b805160000361028a5760405162461bcd60e51b8152602060048201526018602482015277537472696e67206d757374206265206e6f6e2d656d70747960401b6044820152606401610209565b50565b634e487b7160e01b600052604160045260246000fd5b604051601f8201601f191681016001600160401b03811182821017156102cb576102cb61028d565b604052919050565b60006001600160401b038211156102ec576102ec61028d565b50601f01601f191660200190565b600061030d610308846102d3565b6102a3565b905082815283838301111561032157600080fd5b828260208301376000602084830101529392505050565b60006020828403121561034a57600080fd5b81356001600160401b0381111561036057600080fd5b8201601f8101841361037157600080fd5b610380848235602084016102fa565b949350505050565b60005b838110156103a357818101518382015260200161038b565b50506000910152565b600081518084526103c4816020860160208601610388565b601f01601f19169290920160200192915050565b6020815260006103eb60208301846103ac565b9392505050565b60006020828403121561040457600080fd5b81516001600160401b0381111561041a57600080fd5b8201601f8101841361042b57600080fd5b8051610439610308826102d3565b81815285602083850101111561044e57600080fd5b61045f826020830160208601610388565b95945050505050565b6a600b5981380380925939f360a81b8152607f60f91b600b820152600c81018490526000602c8201819052606084901b6001600160601b0319166038830152600160f81b604c83015282516104c481604d850160208701610388565b91909101604d01949350505050565b6a600b5981380380925939f360a81b8152607f60f91b600b820152600c81018490526000602c8201819052606084901b6001600160601b0319166038830152604c820181905282516104c481604d85016020870161038856fe42797465636f646553746f726167655f56322e302e305f5f5f5f5f5f5f5f5f20a26469706673582212204f03b8c3dadc4824ff4246bc6367643248ec07b75c4a2064639a820730a2197464736f6c63430008160033",
+  "deployedBytecode": "0x608060405234801561001057600080fd5b50600436106100415760003560e01c80630e80102f14610046578063489631251461005b578063e32551e71461006e575b600080fd5b610059610054366004610338565b610097565b005b610059610069366004610338565b6100dd565b61008161007c366004610338565b6100e8565b60405161008e91906103d8565b60405180910390f35b60006100a282610175565b6040519091506001600160a01b038216907f9d62591b01a10ac24446b07594d7ca4f37bfb6fa9fe7fbc3281f9022e8bea86690600090a25050565b60006100a282610218565b60606100f38261023e565b60405163e32551e760e01b815273__$a84cab3dc26412b6358fa38e3bc69cb812$__9063e32551e79061012a9085906004016103d8565b600060405180830381865af4158015610147573d6000803e3d6000fd5b505050506040513d6000823e601f3d908101601f1916820160405261016f91908101906103f2565b92915050565b60008060008051602061052d833981519152308460405160200161019b93929190610468565b60405160208183030381529060405290508051602082016000f091506001600160a01b0382166102125760405162461bcd60e51b815260206004820152601e60248201527f436f6e7472616374417353746f726167653a205772697465204572726f72000060448201526064015b60405180910390fd5b50919050565b60008060008051602061052d833981519152308460405160200161019b939291906104d3565b805160000361028a5760405162461bcd60e51b8152602060048201526018602482015277537472696e67206d757374206265206e6f6e2d656d70747960401b6044820152606401610209565b50565b634e487b7160e01b600052604160045260246000fd5b604051601f8201601f191681016001600160401b03811182821017156102cb576102cb61028d565b604052919050565b60006001600160401b038211156102ec576102ec61028d565b50601f01601f191660200190565b600061030d610308846102d3565b6102a3565b905082815283838301111561032157600080fd5b828260208301376000602084830101529392505050565b60006020828403121561034a57600080fd5b81356001600160401b0381111561036057600080fd5b8201601f8101841361037157600080fd5b610380848235602084016102fa565b949350505050565b60005b838110156103a357818101518382015260200161038b565b50506000910152565b600081518084526103c4816020860160208601610388565b601f01601f19169290920160200192915050565b6020815260006103eb60208301846103ac565b9392505050565b60006020828403121561040457600080fd5b81516001600160401b0381111561041a57600080fd5b8201601f8101841361042b57600080fd5b8051610439610308826102d3565b81815285602083850101111561044e57600080fd5b61045f826020830160208601610388565b95945050505050565b6a600b5981380380925939f360a81b8152607f60f91b600b820152600c81018490526000602c8201819052606084901b6001600160601b0319166038830152600160f81b604c83015282516104c481604d850160208701610388565b91909101604d01949350505050565b6a600b5981380380925939f360a81b8152607f60f91b600b820152600c81018490526000602c8201819052606084901b6001600160601b0319166038830152604c820181905282516104c481604d85016020870161038856fe42797465636f646553746f726167655f56322e302e305f5f5f5f5f5f5f5f5f20a26469706673582212204f03b8c3dadc4824ff4246bc6367643248ec07b75c4a2064639a820730a2197464736f6c63430008160033",
+  "linkReferences": {
+    "contracts/libs/v0.8.x/BytecodeStorageV2.sol": {
+      "BytecodeStorageReader": [
+        {
+          "length": 20,
+          "start": 290
+        }
+      ]
+    }
+  },
+  "deployedLinkReferences": {
+    "contracts/libs/v0.8.x/BytecodeStorageV2.sol": {
+      "BytecodeStorageReader": [
+        {
+          "length": 20,
+          "start": 258
+        }
+      ]
+    }
+  }
+}