@artblocks/contracts 1.2.0 → 1.3.0

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/BytecodeStorageReaderContractV2_Web3Call.sol/BytecodeStorageReaderContractV2_Web3Call.json

@@ -0,0 +1,201 @@
+{
+  "_format": "hh-sol-artifact-1",
+  "contractName": "BytecodeStorageReaderContractV2_Web3Call",
+  "sourceName": "contracts/BytecodeStorageReaders/BytecodeStorageReaderContractV2_Web3Call.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": "0x608060405234801561001057600080fd5b5061087f806100206000396000f3fe608060405234801561001057600080fd5b506004361061006d5760003560e01c80632475d7091461007257806342e832e01461009b57806375662f38146100bb57806387630c15146100ce578063cc31a331146100e1578063f667001414610102578063ffa1ad7414610125575b600080fd5b610085610080366004610630565b61012d565b604051610092919061069d565b60405180910390f35b6100ae6100a9366004610630565b6101bb565b60405161009291906106b0565b6100856100c9366004610630565b61023f565b6100856100dc3660046106c4565b61038a565b6100f46100ef366004610630565b61041b565b604051908152602001610092565b610115610110366004610630565b61049f565b6040519015158152602001610092565b610085610523565b604051632475d70960e01b815260609073__$a84cab3dc26412b6358fa38e3bc69cb812$__90632475d70990610170906001600160a01b038616906004016106b0565b600060405180830381865af415801561018d573d6000803e3d6000fd5b505050506040513d6000823e601f3d908101601f191682016040526101b59190810190610779565b92915050565b604051630217419760e51b815260009073__$a84cab3dc26412b6358fa38e3bc69cb812$__906342e832e0906101fe906001600160a01b038616906004016106b0565b602060405180830381865af415801561021b573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906101b591906107c9565b604051630eacc5e760e31b815260609073__$a84cab3dc26412b6358fa38e3bc69cb812$__906375662f3890610282906001600160a01b038616906004016106b0565b600060405180830381865af49250505080156102c057506040513d6000823e601f3d908101601f191682016040526102bd9190810190610779565b60015b6101b5576102d58263c2b4f41160e01b61053f565b15610309575050604080518082019091526013815272237765623363616c6c5f636f6e74726163742360681b602082015290565b60405162461bcd60e51b815260206004820152604660248201527f42797465636f646553746f72616765526561646572436f6e747261637456325f60448201527f5765623343616c6c3a204661696c656420746f20726561642066726f6d2062796064820152657465636f646560d01b608482015260a40160405180910390fd5b6040516387630c1560e01b81526001600160a01b03831660048201526024810182905260609073__$a84cab3dc26412b6358fa38e3bc69cb812$__906387630c1590604401600060405180830381865af41580156103ec573d6000803e3d6000fd5b505050506040513d6000823e601f3d908101601f191682016040526104149190810190610779565b9392505050565b60405163cc31a33160e01b815260009073__$a84cab3dc26412b6358fa38e3bc69cb812$__9063cc31a3319061045e906001600160a01b038616906004016106b0565b602060405180830381865af415801561047b573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906101b591906107e6565b604051633d99c00560e21b815260009073__$a84cab3dc26412b6358fa38e3bc69cb812$__9063f6670014906104e2906001600160a01b038616906004016106b0565b602060405180830381865af41580156104ff573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906101b591906107ff565b6040518060600160405280602881526020016108226028913981565b600061054a8361055b565b80156104145750610414838361058e565b600061056e826301ffc9a760e01b61058e565b80156101b55750610587826001600160e01b031961058e565b1592915050565b6040516001600160e01b031982166024820152600090819060440160408051601f19818403018152919052602080820180516001600160e01b03166301ffc9a760e01b178152825192935060009283928392909183918a617530fa92503d91506000519050828015610601575060208210155b801561060d5750600081115b979650505050505050565b6001600160a01b038116811461062d57600080fd5b50565b60006020828403121561064257600080fd5b813561041481610618565b60005b83811015610668578181015183820152602001610650565b50506000910152565b6000815180845261068981602086016020860161064d565b601f01601f19169290920160200192915050565b6020815260006104146020830184610671565b6001600160a01b0391909116815260200190565b600080604083850312156106d757600080fd5b82356106e281610618565b946020939093013593505050565b634e487b7160e01b600052604160045260246000fd5b60006001600160401b0380841115610720576107206106f0565b604051601f8501601f19908116603f01168101908282118183101715610748576107486106f0565b8160405280935085815286868601111561076157600080fd5b61076f86602083018761064d565b5050509392505050565b60006020828403121561078b57600080fd5b81516001600160401b038111156107a157600080fd5b8201601f810184136107b257600080fd5b6107c184825160208401610706565b949350505050565b6000602082840312156107db57600080fd5b815161041481610618565b6000602082840312156107f857600080fd5b5051919050565b60006020828403121561081157600080fd5b8151801515811461041457600080fdfe42797465636f646553746f72616765526561646572436f6e747261637456325f5765623343616c6ca264697066735822122039a5c52bfda6cefa2c8b077cae02c86b40915a5078b3e55370d25e7f35511a1164736f6c63430008160033",
+  "deployedBytecode": "0x608060405234801561001057600080fd5b506004361061006d5760003560e01c80632475d7091461007257806342e832e01461009b57806375662f38146100bb57806387630c15146100ce578063cc31a331146100e1578063f667001414610102578063ffa1ad7414610125575b600080fd5b610085610080366004610630565b61012d565b604051610092919061069d565b60405180910390f35b6100ae6100a9366004610630565b6101bb565b60405161009291906106b0565b6100856100c9366004610630565b61023f565b6100856100dc3660046106c4565b61038a565b6100f46100ef366004610630565b61041b565b604051908152602001610092565b610115610110366004610630565b61049f565b6040519015158152602001610092565b610085610523565b604051632475d70960e01b815260609073__$a84cab3dc26412b6358fa38e3bc69cb812$__90632475d70990610170906001600160a01b038616906004016106b0565b600060405180830381865af415801561018d573d6000803e3d6000fd5b505050506040513d6000823e601f3d908101601f191682016040526101b59190810190610779565b92915050565b604051630217419760e51b815260009073__$a84cab3dc26412b6358fa38e3bc69cb812$__906342e832e0906101fe906001600160a01b038616906004016106b0565b602060405180830381865af415801561021b573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906101b591906107c9565b604051630eacc5e760e31b815260609073__$a84cab3dc26412b6358fa38e3bc69cb812$__906375662f3890610282906001600160a01b038616906004016106b0565b600060405180830381865af49250505080156102c057506040513d6000823e601f3d908101601f191682016040526102bd9190810190610779565b60015b6101b5576102d58263c2b4f41160e01b61053f565b15610309575050604080518082019091526013815272237765623363616c6c5f636f6e74726163742360681b602082015290565b60405162461bcd60e51b815260206004820152604660248201527f42797465636f646553746f72616765526561646572436f6e747261637456325f60448201527f5765623343616c6c3a204661696c656420746f20726561642066726f6d2062796064820152657465636f646560d01b608482015260a40160405180910390fd5b6040516387630c1560e01b81526001600160a01b03831660048201526024810182905260609073__$a84cab3dc26412b6358fa38e3bc69cb812$__906387630c1590604401600060405180830381865af41580156103ec573d6000803e3d6000fd5b505050506040513d6000823e601f3d908101601f191682016040526104149190810190610779565b9392505050565b60405163cc31a33160e01b815260009073__$a84cab3dc26412b6358fa38e3bc69cb812$__9063cc31a3319061045e906001600160a01b038616906004016106b0565b602060405180830381865af415801561047b573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906101b591906107e6565b604051633d99c00560e21b815260009073__$a84cab3dc26412b6358fa38e3bc69cb812$__9063f6670014906104e2906001600160a01b038616906004016106b0565b602060405180830381865af41580156104ff573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906101b591906107ff565b6040518060600160405280602881526020016108226028913981565b600061054a8361055b565b80156104145750610414838361058e565b600061056e826301ffc9a760e01b61058e565b80156101b55750610587826001600160e01b031961058e565b1592915050565b6040516001600160e01b031982166024820152600090819060440160408051601f19818403018152919052602080820180516001600160e01b03166301ffc9a760e01b178152825192935060009283928392909183918a617530fa92503d91506000519050828015610601575060208210155b801561060d5750600081115b979650505050505050565b6001600160a01b038116811461062d57600080fd5b50565b60006020828403121561064257600080fd5b813561041481610618565b60005b83811015610668578181015183820152602001610650565b50506000910152565b6000815180845261068981602086016020860161064d565b601f01601f19169290920160200192915050565b6020815260006104146020830184610671565b6001600160a01b0391909116815260200190565b600080604083850312156106d757600080fd5b82356106e281610618565b946020939093013593505050565b634e487b7160e01b600052604160045260246000fd5b60006001600160401b0380841115610720576107206106f0565b604051601f8501601f19908116603f01168101908282118183101715610748576107486106f0565b8160405280935085815286868601111561076157600080fd5b61076f86602083018761064d565b5050509392505050565b60006020828403121561078b57600080fd5b81516001600160401b038111156107a157600080fd5b8201601f810184136107b257600080fd5b6107c184825160208401610706565b949350505050565b6000602082840312156107db57600080fd5b815161041481610618565b6000602082840312156107f857600080fd5b5051919050565b60006020828403121561081157600080fd5b8151801515811461041457600080fdfe42797465636f646553746f72616765526561646572436f6e747261637456325f5765623343616c6ca264697066735822122039a5c52bfda6cefa2c8b077cae02c86b40915a5078b3e55370d25e7f35511a1164736f6c63430008160033",
+  "linkReferences": {
+    "contracts/libs/v0.8.x/BytecodeStorageV2.sol": {
+      "BytecodeStorageReader": [
+        {
+          "length": 20,
+          "start": 351
+        },
+        {
+          "length": 20,
+          "start": 493
+        },
+        {
+          "length": 20,
+          "start": 625
+        },
+        {
+          "length": 20,
+          "start": 978
+        },
+        {
+          "length": 20,
+          "start": 1101
+        },
+        {
+          "length": 20,
+          "start": 1233
+        }
+      ]
+    }
+  },
+  "deployedLinkReferences": {
+    "contracts/libs/v0.8.x/BytecodeStorageV2.sol": {
+      "BytecodeStorageReader": [
+        {
+          "length": 20,
+          "start": 319
+        },
+        {
+          "length": 20,
+          "start": 461
+        },
+        {
+          "length": 20,
+          "start": 593
+        },
+        {
+          "length": 20,
+          "start": 946
+        },
+        {
+          "length": 20,
+          "start": 1069
+        },
+        {
+          "length": 20,
+          "start": 1201
+        }
+      ]
+    }
+  }
+}