@artblocks/contracts 1.0.1 → 1.0.3

package/README.md

@@ -2,6 +2,7 @@
 
 [![CircleCI](https://circleci.com/gh/ArtBlocks/artblocks-contracts/tree/main.svg?style=svg&circle-token=757a2689792bc9c126834396d6fa47e8f023bc2d)](https://circleci.com/gh/ArtBlocks/artblocks-contracts/tree/main)
 
+[![GitPOAPs](https://public-api.gitpoap.io/v1/repo/ArtBlocks/artblocks-contracts/badge)](https://www.gitpoap.io/gh/ArtBlocks/artblocks-contracts)
 [![Coverage Status](https://coveralls.io/repos/github/ArtBlocks/artblocks-contracts/badge.svg?branch=main)](https://coveralls.io/github/ArtBlocks/artblocks-contracts?branch=main)
 
 A collection of smart contracts used by [Art Blocks](https://artblocks.io) for our flagship product, as well as Artblocks Engine products.
@@ -54,23 +55,56 @@ In addition to meeting our style guidelines, all code must pass all tests and be
 
 # Documentation
 
-Documentation for contracts us deployed via GitHub pages at: https://artblocks.github.io/artblocks-contracts/
+## auto-generated contract docs (via NatSpec)
+
+Documentation for contracts is deployed via GitHub pages at: https://artblocks.github.io/artblocks-contracts/
 
 Documentation for contracts may also be generated via `yarn docgen`. Most Art Blocks contracts use [NatSpec](https://docs.soliditylang.org/en/v0.8.9/natspec-format.html#documentation-example) comments to automatically enrich generated documentation. Some contracts use [dynamic expressions](https://docs.soliditylang.org/en/v0.8.9/natspec-format.html#dynamic-expressions) to improve user experience.
 
+## Art Blocks V3 Contract Architecture
+
+For a high-level overview of the Art Blocks V3 contract architecture, refer to the simplified entity relationship diagram below.
+
+```mermaid
+erDiagram
+    ADMIN_ACL ||--o{ CORE_V3_V3_FLEX : manages
+    ADMIN_ACL ||--o{ MINTERFILTER : manages
+    CORE_V3_V3_FLEX ||--|| MINTERFILTER : uses
+    CORE_V3_V3_FLEX }o--|| BYTECODESTORAGEREADER : uses
+    MINTERFILTER ||--o{ MINTER_1 : uses
+    MINTERFILTER ||--o{ MINTER_2 : uses
+    MINTERFILTER ||--o{ MINTER_N : uses
+    MINTER_1 ||--|| I_FILTERED_MINTER : implements
+    MINTER_2 ||--|| I_FILTERED_MINTER : implements
+    MINTER_N ||--|| I_FILTERED_MINTER : implements
+    RANDOMIZER ||--|| CORE_V3_V3_FLEX : provides_random
+    ENGINE_REGISTRY ||--o{ CORE_V3_V3_FLEX : notifies
+```
+
+For a more detailed overview of this architecture, please see the [V3 Contract Architecture page](./V3_ARCHITECTURE.md).
+
 # Deployments
 
 ## Deploying New Contracts
 
-Deployment script templates are located in the `./scripts` directory. To run a deployment script `deploy.ts`:
-
 > IMPORTANT - many scripts rely on typechain-generated factories, so ensure you have run `yarn generate:typechain` before running any deployment scripts.
 
+We have two types of deployment scripts: Generic and Specific.
+
+Generic deployment scripts are located in the `./scripts` directory. These scripts are used to deploy contracts that are not specific to a particular deployment. Generic deployment scripts are used to deploy contracts that are used by multiple partners or core contracts, such as the `Art Blocks Engine` contracts, or minters. Generic scripts take an input json file, located in the `/deployents/` directory, and execute the deployment as defined in the input file. In general, there are scripts prepared to run generic deployments for all networks and environments. For example, the following can be used to deploy the `Art Blocks Engine` contracts to the `goerli` test network (note that an input configuration is also required for all generic deployments.):
+
+```bash
+yarn deploy:dev:v3-engine
 ```
+
+Specific deployments are used less frequently, and are located in the `/scripts` directory as well. These scripts are used to deploy contracts that are specific to a particular deployment. They are not easily reusable, and are generally only used once. An example to run a specific deployment is:
+
+```bash
 yarn hardhat run --network <your-network> scripts/deploy.ts
 ```
 
 where `<your network>` is any network configured in `hardhat.config.js`.
+
 For additional deployment details, see hardhat docs: [https://hardhat.org/guides/deploying.html](https://hardhat.org/guides/deploying.html)
 
 ## Deployed Contract Details
@@ -81,104 +115,15 @@ This is the Smart contract that controls the artwork created by the artist. No f
 
 Core contracts use the versioning schema below:
 
-|     Description      | Version  | Project Range | Mainnet Address                                                                                                                                                                                     |
-| :------------------: | :------: | :-----------: | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-|      AB Core V0      |    V0    |      0-2      | `0x059EDD72Cd353dF5106D2B9cC5ab83a52287aC3a`                                                                                                                                                        |
-|      AB Core V1      |    V1    |     3-373     | `0xa7d8d9ef8D8Ce8992Df33D8b8CF4Aebabd5bD270`                                                                                                                                                        |
-|      PBAB Cores      | V2_PBAB  |   All PBAB    | Various - see PBAB+Collabs directory [DEPLOYMENTS.md files](https://github.com/search?q=repo%3AArtBlocks%2Fartblocks-contracts+extension%3Amd+filename%3ADEPLOYMENTS&type=Code&ref=advsearch&l=&l=) |
-|     PRTNR Cores      | V2_PRTNR |   All PRTNR   | Various - see PBAB+Collabs directory [DEPLOYMENTS.md files](https://github.com/search?q=repo%3AArtBlocks%2Fartblocks-contracts+extension%3Amd+filename%3ADEPLOYMENTS&type=Code&ref=advsearch&l=&l=) |
-| AB Core V3 (current) |    V3    |     374+      | `0x99a9B7c1116f9ceEB1652de04d5969CcE509B069`                                                                                                                                                        |
-
-> AB Core V3 [changelog here](./contracts/V3_CHANGELOG.md), and [performance metrics here](./contracts/V3_Performance.md).
-
-### MinterFilter Suite Compatibility Chart
-
-The following table shows which Minters and MinterFilters are compatible with which Core contracts.
-
-- **Note:** while the whole end-to-end MinterFilter+FilteredMinter architecture is likely not the ideal fit for PBAB partners due to the infrastructure complexity required for partners integrating with it, any of the individual minters from within the minter suite can readily be adapted to work with PBAB core contracts–if you are a PBAB partner and there is a minter in the suite that this would be appealing for, please contact your account manager!
-
-| Core Contract Version(s) | Minter Filter  | Recommended Minters                                                                                                                                 | Deprecated Minters                                                          |
-| ------------------------ | -------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------- |
-| V0                       | -              | (legacy minter)                                                                                                                                     | -                                                                           |
-| V1, V1_PRTNR             | MinterFilterV0 | MinterSetPriceV1<br>MinterSetPriceERC20V1<br>MinterDAExpV1<br>MinterDALinV1<br>MinterMerkleV0<br>MinterHolderV0                                     | MinterSetPriceV0<br>MinterSetPriceERC20V0<br>MinterDAExpV0<br>MinterDALinV0 |
-| V2 (PBAB)                | -              | (various PBAB minters)                                                                                                                              | -                                                                           |
-| V3, V3_Explorations      | MinterFilterV1 | MinterSetPriceV2<br>MinterSetPriceERC20V2<br>MinterDAExpV2<br>MinterDALinV2<br>MinterMerkleV2<br>MinterMerkleV3<br>MinterHolderV1<br>MinterHolderV2 | -                                                                           |
-
-### Active Minting Contract(s)
-
-These are the smart contracts that receive funds, and split them between the artist(s) and the platform. Artists receive funds directly from these contracts.
-
-#### MinterSetPrice (Set Price)
-
-- V0 (deprecated): [0x1DEC9E52f1320F7Deb29cBCd7B7d67f3dF785142](https://etherscan.io/address/0x1DEC9E52f1320F7Deb29cBCd7B7d67f3dF785142#code)
-- V1: [0x934cdc04C434b8dBf3E1265F4f198D70566f7355](https://etherscan.io/address/0x934cdc04C434b8dBf3E1265F4f198D70566f7355#code)
-- V2: [0x7B7917e083CeA6d9f6a3060a7330c1072fcb4e40](https://etherscan.io/address/0x7B7917e083CeA6d9f6a3060a7330c1072fcb4e40#code)
-- V3: N/A, never used in prod.
-- V4: [0x234B25288011081817B5cC199C3754269cCb76D2](https://etherscan.io/address/0x234B25288011081817B5cC199C3754269cCb76D2#code)
-
-#### MinterSetPriceERC20 (Set Price with ERC20)
-
-- V0 (deprecated): [0x48742D38a0809135EFd643c1150BfC13768C3907](https://etherscan.io/address/0x48742D38a0809135EFd643c1150BfC13768C3907#code)
-- V1: [0x0BbB93c5d118D1dee49e96BCAdc161403f4F8612](https://etherscan.io/address/0x0BbB93c5d118D1dee49e96BCAdc161403f4F8612#code)
-- V2: [0xe4c6EeF13649e9C4Ad8ae8A9C7fA9A7F26B4287a](https://etherscan.io/address/0xe4c6EeF13649e9C4Ad8ae8A9C7fA9A7F26B4287a#code)
-- V3: N/A, never used in prod.
-- V4: [0x9fEcd2FbC6D890fB93632DcE9b1a01c4090A7E2d](https://etherscan.io/address/0x9fEcd2FbC6D890fB93632DcE9b1a01c4090A7E2d#code)
-
-#### MinterDALin (Linear Dutch Auction)
-
-- V0 (deprecated): [0xd219f61Bb5A3ffDeCB4362610977F1dAB3930eE2](https://etherscan.io/address/0xd219f61Bb5A3ffDeCB4362610977F1dAB3930eE2#code)
-- V1: [0x32710950B014c2D29EA24f480Dd02c7e4610663b](https://etherscan.io/address/0x32710950B014c2D29EA24f480Dd02c7e4610663b#code)
-- V2: [0xdaa6D1e224f4B9f7c4f1368C362C4333A8e385A6](https://etherscan.io/address/0xdaa6D1e224f4B9f7c4f1368C362C4333A8e385A6#code)
-- V3: N/A, never used in prod.
-- V4: [0x419501DD208BFf237e3E32C40D074065e12DfF4d](https://etherscan.io/address/0x419501DD208BFf237e3E32C40D074065e12DfF4d#code)
-
-#### MinterDAExp (Exponential Decay Dutch Auction)
-
-- V0 (deprecated): [0xFc74fD0f2c7EaD04f1E5E9fd82Aef55620710D7C](https://etherscan.io/address/0xFc74fD0f2c7EaD04f1E5E9fd82Aef55620710D7C#code)
-- V1: [0xD94C7060808f3c876824E57e685702f3834D2e13](https://etherscan.io/address/0xD94C7060808f3c876824E57e685702f3834D2e13#code)
-- V2: [0x706d6C6ef700a3c1C3a727f0c46492492E0A72b5](https://etherscan.io/address/0x706d6C6ef700a3c1C3a727f0c46492492E0A72b5#code)
-- V3: N/A, never used in prod.
-- V4: [0x47e2df2723238f913741Cc6b1963e76fdfD19B94](https://etherscan.io/address/0x47e2df2723238f913741Cc6b1963e76fdfD19B94#code)
-
-#### MinterDAExpSettlement (Expotential Decay Last Price Dutch Auction)
-
-- V0: N/A, never used in prod.
-- V1: [0xfdE58c821D1c226b4a45c22904de20b114EDe7E7](https://etherscan.io/address/0xfdE58c821D1c226b4a45c22904de20b114EDe7E7#code)
-
-#### MinterMerkle (Address Allowlist)
-
-- V0: N/A, never used in prod.
-- V1: [0xae5A48D22Cd069c4d72dDe204A7fB4B302e614af](https://etherscan.io/address/0xae5A48D22Cd069c4d72dDe204A7fB4B302e614af)
-- V2: [0x6Ff3c104Ca9b4860D27079aFfF18701c4A532A4d](https://etherscan.io/address/0x6Ff3c104Ca9b4860D27079aFfF18701c4A532A4d)
-- V3: N/A, never used in prod.
-- V4: N/A, never used in prod.
-- V5: [0xB8Bd1D2836C466DB149f665F777928bEE267304d](https://etherscan.io/address/0xB8Bd1D2836C466DB149f665F777928bEE267304d#code)
-
-#### Minter Holder (Token Holder)
+|        Description        | Version  | Project Range | Mainnet Address                                                                                                                                                                                              |
+| :-----------------------: | :------: | :-----------: | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+|        AB Core V0         |    V0    |      0-2      | `0x059EDD72Cd353dF5106D2B9cC5ab83a52287aC3a`                                                                                                                                                                 |
+|        AB Core V1         |    V1    |     3-373     | `0xa7d8d9ef8D8Ce8992Df33D8b8CF4Aebabd5bD270`                                                                                                                                                                 |
+|     Engine Cores (V2)     | V2_PBAB  |   All PBAB    | Various - see `deployments/engine/` directory [DEPLOYMENTS.md files](https://github.com/search?q=repo%3AArtBlocks%2Fartblocks-contracts+extension%3Amd+filename%3ADEPLOYMENTS&type=Code&ref=advsearch&l=&l=) |
+| Engine Partner Cores (V2) | V2_PRTNR |   All PRTNR   | Various - see `deployments/engine/` directory [DEPLOYMENTS.md files](https://github.com/search?q=repo%3AArtBlocks%2Fartblocks-contracts+extension%3Amd+filename%3ADEPLOYMENTS&type=Code&ref=advsearch&l=&l=) |
+|   AB Core V3 (current)    |    V3    |     374+      | `0x99a9B7c1116f9ceEB1652de04d5969CcE509B069`                                                                                                                                                                 |
 
-- V0: N/A, never used in prod.
-- V1: [0xa198E22C32879f4214a37eB3051525bD9aff9145](https://etherscan.io/address/0xa198E22C32879f4214a37eB3051525bD9aff9145)
-- V2: N/A, never used in prod.
-- V3: N/A, never used in prod.
-- V4: [0xCCFF562017bdAAa064184b3Eb9bd892d8Acce7d6](https://etherscan.io/address/0xCCFF562017bdAAa064184b3Eb9bd892d8Acce7d6#code)
-
-### Other Minter Contracts
-
-MinterFilterV0 for flagship V1 core: [0x4aafCE293b9B0faD169c78049A81e400f518E199](https://etherscan.io/address/0x4aafCE293b9B0faD169c78049A81e400f518E199#code).
-
-MinterFilterV1 for flagship V3 core: [0x092B8F64e713d66b38522978BCf4649db14b931E](https://etherscan.io/address/0x092B8F64e713d66b38522978BCf4649db14b931E).
-
-Legacy minting contract for flagship V0 core: [0x47e312d99c09ce61a866c83cbbbbed5a4b9d33e7](https://etherscan.io/address/0x47e312d99c09ce61a866c83cbbbbed5a4b9d33e7).
-
-For deployed Engine/Partner/Explorations minting contracts that integrate with V2 core contracts, see the archived source code in the `/posterity/engine/<engine-partner>/` directory and the deployment logs in `/deployments/engine/[V2|V3]/<engine-partner>/` directories. For V3 deployments, deployment script inputs are also available in the `/deployments/engine/[V2|V3]/<engine-partner>/` directories.
-
-### Shared Randomizers
-
-- Goerli: https://goerli.etherscan.io/address/0xec5dae4b11213290b2dbe5295093f75920bd2982#code
-- Ropsten: https://ropsten.etherscan.io/address/0x7ba972189ED3C527847170453fC108707F62755a#code
-- Rinkeby: https://rinkeby.etherscan.io/address/0x3b30d421a6dA95694EaaE09971424F15Eb375269#code
-- Kovan: https://kovan.etherscan.io/address/0x3b30d421a6dA95694EaaE09971424F15Eb375269#code
-- Mainnet: https://etherscan.io/address/0x088098f7438773182b703625c4128aff85fcffc4#code
+> AB Core V3 [changelog here](./contracts/V3_CHANGELOG.md), and [performance metrics here](./contracts/V3_PERFORMANCE.md).
 
 ### Testnet Contracts
 
@@ -193,73 +138,41 @@ The following represents the current set of flagship core contracts deployed on
   - V1 Core (deprecated): https://goerli.etherscan.io/address/0x1Bf03F29c4FEFFFe4eE26704aaA31d85c026aCE6
   - V3 Core: https://goerli.etherscan.io/address/0xF396C180bb2f92EE28535D23F5224A5b9425ceca
 
-## Art Blocks Engine core contracts
+## Art Blocks Engine Core Contracts
 
-> Formerly known as PBAB or PRTNR 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.
 
-For deployed core contracts, see the archived source code in the `/posterity/engine/` directory and the deployment logs in `/deployments/engine/[V2|V3]/<engine-partner>/` directories.
+## BytecodeStorageReader
 
-## Contract Source Code Verification
-
-In an effort to ensure source code verification is easily completed by anyone, After 10, January 2023, all mainnet deployments should also have a corresponding tag+release in this GitHub repository. For deployments prior to this date, PR history may be used to determine the commit hash used for a given deployment. Currently, all mainnet deployments of contracts developed in this repositiory are verified on Etherscan.
+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.
 
-# Royalty Registry
+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:
 
-Art Blocks supports lookups of all mainnet flagship, partnership, and PBAB tokens on Manifold's [Royalty Registry](https://royaltyregistry.xyz/lookup). This enables on-chain royalty lookups for all Art Blocks NFTs, and allows for the creation of royalty streams for artists and other creators.
+- V1 `BytecodeStorageReader` (goerli): https://goerli.etherscan.io/address/0xB8B806A10d16cc80dB788552B54B3ECb4A2A3C3D#code
+- V1 `BytecodeStorageReader` (mainnet): https://etherscan.io/address/0xf0585dF582A0ad119F1616FB82f3b449a98EeCd5#code
+- V1 `BytecodeStorageReader` (arbitrum-goerli): https://goerli.arbiscan.io/address/0x681861cD4fC92d70aE57745385065ef862954662
 
-For core contracts V3+, Art Blocks core contracts are designed to integrate directly with Manifold's [Royalty Registry](https://royaltyregistry.xyz/lookup). Aside from an artist and the platform defining royalty percentages/basis-points and addresses on the V3+ core contracts, no additional steps are required to register a token with the Royalty Registry.
+## Minter Suite
 
-Prior to the V3 core contract, royalty registry override contracts are needed to properly integrate with the Royalty Registry. These contracts delegate all permissions to the core contracts. The following Royalty Registry override contracts are deployed at:
+For details on the Flagship and Engine Minter Suite, see the [minter suite documenation](./MINTER_SUITE.md).
 
-- **mainnet (AB deployed):**
+## Shared Randomizers
 
-  - AB Flagship + Partner (PRTNR) royalty override: https://etherscan.io/address/0x7b5369c24a47a72ecf932bf6974f506dde4d5eb1#code
-  - PBAB royalty override: https://etherscan.io/address/0x31e1cc72e6f9e27c2ecbb500d978de1691173f5f#code
-
-- **mainnet (RR deployed):**
-  - RoyaltyRegistry: https://etherscan.io/address/0xad2184fb5dbcfc05d8f056542fb25b04fa32a95d#code
-  - RoyaltyEngineV1: https://etherscan.io/address/0x0385603ab55642cb4dd5de3ae9e306809991804f#code
-
-### Configuring PBAB Royalty Override (REQUIRED)
-
-Upon deploying a PBAB contract, the following steps must be taken:
-
-> Tasks denoted by (scripted) are included in `scripts/1_reference_pbab_suite_deployer.ts`, and scripted for newly deployed PBAB projects as of 03/2022.
-
-- **(scripted), REQUIRED** Set the royalty lookup address on the royalty registry for the newly deployed contract
-  - Go to the [Royalty Registry](https://royaltyregistry.xyz/lookup) and call the following function on the Royalty Registry smart contract:
-    - `setRoyaltyLookupAddress(<new_PBAB_coreAddr>, <PBAB_royaltyOverrideContract>)`
-- **(scripted), REQUIRED** Set Platform royalty payment address for the new core contract in PBAB royalty override contract
-  > note: This step is optional in the PBAB deployer script in case platform royalty payment address is not known at time of deployment, but must be completed before royalty lookups will work
-  - `admin` of the PBAB core contract must call the following function on the PBAB royalty override contract:
-    - `updatePlatformRoyaltyAddressForContract(<new_PBAB_coreAddr>, <platformRoyaltyPaymentAddress>)`
-
-Additionally, the following settings may be configured/changed by a PBAB core contract's `admin` at any time:
-
-- **Change Royalty Percentages**
-  - `renderProvider` or `platform` Royalty [BPS](https://www.investopedia.com/terms/b/basispoint.asp) may be changed from default values of 2.5% to any value. This can be configured by a PBAB core contract's `admin` via the PBAB override contract's functions `updateRenderProviderBpsForContract` and `updatePlatformBpsForContract`.
-- **Change Platform Royalty Payment Address**
-  - The address to receive platform royalty payments may be updated by a PBAB core contract's admin via the PBAB override contract's function `updatePlatformRoyaltyAddressForContract`.
-- **Change Render Provider Royalty Payment Address**
-  - The address to receive render provider royalty payments is delegated to the token core contract, and defined as the public variable `renderProviderAddress`.
+- Goerli: https://goerli.etherscan.io/address/0xec5dae4b11213290b2dbe5295093f75920bd2982#code
+- Ropsten: https://ropsten.etherscan.io/address/0x7ba972189ED3C527847170453fC108707F62755a#code
+- Rinkeby: https://rinkeby.etherscan.io/address/0x3b30d421a6dA95694EaaE09971424F15Eb375269#code
+- Kovan: https://kovan.etherscan.io/address/0x3b30d421a6dA95694EaaE09971424F15Eb375269#code
+- Mainnet: https://etherscan.io/address/0x088098f7438773182b703625c4128aff85fcffc4#code
 
-### Configuring Art Blocks Flagship **OR** Partner (PRTNR) Royalty Override (REQUIRED)
+## Contract Source Code Verification
 
-Upon deploying a new Art Blocks flagship core contract or Partner (PRTNR) core contract, the following steps must be taken (NOT scripted):
+In an effort to ensure source code verification is easily completed by anyone, After 10, January 2023, all mainnet deployments should also have a corresponding tag+release in this GitHub repository. For deployments prior to this date, PR history may be used to determine the commit hash used for a given deployment. Currently, all mainnet deployments of contracts developed in this repositiory are verified on Etherscan.
 
-- **REQUIRED** Set the royalty lookup address on the royalty registry for the newly deployed contract
-  - Go to the [Royalty Registry](https://royaltyregistry.xyz/lookup) to call the following function on the Royalty Registry smart contract:
-    - `setRoyaltyLookupAddress(<new_coreAddr>, <ArtBlocks_royaltyOverrideContract>)`
-- **REQUIRED** Set Art Blocks royalty payment address for the new core contract in the royalty override contract
-  - `admin` of core contract must call:
-    - `updateArtblocksRoyaltyAddressForContract(<new_coreAddr>, <ArtBlocksRoyaltyPaymentAddress>)`
+# Royalties
 
-Additionally, the following settings may be configured/changed by a core contract's `admin` at any time:
+Art Blocks supports on-chain royalty lookups for all Flagship and Engine tokens on Manifold's [Royalty Registry](https://royaltyregistry.xyz/lookup). This enables royalty revenue streams for artists and other creators.
 
-- **Change Art Blocks Royalty Percentage**
-  - Royalty [BPS](https://www.investopedia.com/terms/b/basispoint.asp) may be changed from default values of 2.5% to any value less than or equal to the default (cannot be increased above default). This can be configured by a core contract's `admin` via the override contract's function `updateArtblocksBpsForContract`.
-- **Change Art Blocks Royalty Payment Address**
-  - The address to receive Art Blocks royalty payments may be updated by a core contract's admin via the royalty override contract's function `updateArtblocksRoyaltyAddressForContract`.
+For information about on-chain royalties, please see the [royalties documentation](./ROYALTIES.md).
 
 # Source Code Archival
 
@@ -302,4 +215,4 @@ After this config is finished, you'll notice a `usd (avg)` column in the auto-ge
 
 # License
 
-The Art Blocks `artblocks-contracts` repo is open source software licensed under the GNU Lesser General Public License v3.0. For full license text, please see our [LICENSE](https://github.com/ArtBlocks/artblocks-contracts/blob/main/LICENSE) declaration file.
+The Art Blocks `artblocks-contracts` repo is open source software licensed under the GNU Lesser General Public License v3.0. For full license text, please see our [LICENSE](https://github.com/ArtBlocks/artblocks-contracts/blob/main/packages/contracts/LICENSE) declaration file.

package/artifacts/contracts/AdminACLV0.sol/AdminACLV0.json

@@ -157,8 +157,8 @@
       "type": "function"
     }
   ],
-  "bytecode": "0x60c0604052600a608090815269041646d696e41434c56360b41b60a05260009061002990826100ed565b5034801561003657600080fd5b50600180546001600160a01b031916331790556101ac565b634e487b7160e01b600052604160045260246000fd5b600181811c9082168061007857607f821691505b60208210810361009857634e487b7160e01b600052602260045260246000fd5b50919050565b601f8211156100e857600081815260208120601f850160051c810160208610156100c55750805b601f850160051c820191505b818110156100e4578281556001016100d1565b5050505b505050565b81516001600160401b038111156101065761010661004e565b61011a816101148454610064565b8461009e565b602080601f83116001811461014f57600084156101375750858301515b600019600386901b1c1916600185901b1785556100e4565b600085815260208120601f198616915b8281101561017e5788860151825594840194600190910190840161015f565b508582101561019c5787850151600019600388901b60f8161c191681555b5050505050600190811b01905550565b610747806101bb6000396000f3fe608060405234801561001057600080fd5b506004361061006d5760003560e01c806301ffc9a71461007257806305de62c01461009a57806329575f6a146100be578063377a7d1a146100de578063985d1968146100f3578063bcc91a1014610106578063c81a396e14610119575b600080fd5b61008561008036600461048e565b61012e565b60405190151581526020015b60405180910390f35b6100856100a83660046104c7565b50506001546001600160a01b0391821691161490565b6001546100d1906001600160a01b031681565b604051610091919061050a565b6100f16100ec36600461051e565b610165565b005b6100f16101013660046105a4565b6101fd565b6100f16101143660046105bf565b61027d565b6101216103e3565b60405161009191906105f2565b60006001600160e01b03198216633001c1ef60e21b148061015f57506301ffc9a760e01b6001600160e01b03198316145b92915050565b6001546001600160a01b031633146101985760405162461bcd60e51b815260040161018f90610640565b60405180910390fd5b600180546001600160a01b038581166001600160a01b0319831681179093556040519116919082907f3f6845104f9728af7979eed8814320daba008953c8db93b9fe32602d1f34b475906101ef9087908790610669565b60405180910390a350505050565b6001546001600160a01b031633146102275760405162461bcd60e51b815260040161018f90610640565b806001600160a01b031663715018a66040518163ffffffff1660e01b8152600401600060405180830381600087803b15801561026257600080fd5b505af1158015610276573d6000803e3d6000fd5b5050505050565b6001546001600160a01b031633146102a75760405162461bcd60e51b815260040161018f90610640565b6040516301ffc9a760e01b8152633001c1ef60e21b60048201526001600160a01b038216906301ffc9a790602401602060405180830381865afa1580156102f2573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061031691906106b5565b6103815760405162461bcd60e51b815260206004820152603660248201527f41646d696e41434c56303a206e65772061646d696e2041434c20646f6573206e60448201527506f7420737570706f7274204941646d696e41434c56360541b606482015260840161018f565b60405163f2fde38b60e01b81526001600160a01b0383169063f2fde38b906103ad90849060040161050a565b600060405180830381600087803b1580156103c757600080fd5b505af11580156103db573d6000803e3d6000fd5b505050505050565b600080546103f0906106d7565b80601f016020809104026020016040519081016040528092919081815260200182805461041c906106d7565b80156104695780601f1061043e57610100808354040283529160200191610469565b820191906000526020600020905b81548152906001019060200180831161044c57829003601f168201915b505050505081565b80356001600160e01b03198116811461048957600080fd5b919050565b6000602082840312156104a057600080fd5b6104a982610471565b9392505050565b80356001600160a01b038116811461048957600080fd5b6000806000606084860312156104dc57600080fd5b6104e5846104b0565b92506104f3602085016104b0565b915061050160408501610471565b90509250925092565b6001600160a01b0391909116815260200190565b60008060006040848603121561053357600080fd5b61053c846104b0565b9250602084013567ffffffffffffffff8082111561055957600080fd5b818601915086601f83011261056d57600080fd5b81358181111561057c57600080fd5b8760208260051b850101111561059157600080fd5b6020830194508093505050509250925092565b6000602082840312156105b657600080fd5b6104a9826104b0565b600080604083850312156105d257600080fd5b6105db836104b0565b91506105e9602084016104b0565b90509250929050565b600060208083528351808285015260005b8181101561061f57858101830151858201604001528201610603565b506000604082860101526040601f19601f8301168501019250505092915050565b6020808252600f908201526e27b7363c9039bab832b920b236b4b760891b604082015260600190565b60208082528181018390526000908460408401835b868110156106aa576001600160a01b03610697846104b0565b168252918301919083019060010161067e565b509695505050505050565b6000602082840312156106c757600080fd5b815180151581146104a957600080fd5b600181811c908216806106eb57607f821691505b60208210810361070b57634e487b7160e01b600052602260045260246000fd5b5091905056fea2646970667358221220eb60dafe19251564df41a812729a78538c16b536734e69e73af5740cb85ff5b364736f6c63430008110033",
-  "deployedBytecode": "0x608060405234801561001057600080fd5b506004361061006d5760003560e01c806301ffc9a71461007257806305de62c01461009a57806329575f6a146100be578063377a7d1a146100de578063985d1968146100f3578063bcc91a1014610106578063c81a396e14610119575b600080fd5b61008561008036600461048e565b61012e565b60405190151581526020015b60405180910390f35b6100856100a83660046104c7565b50506001546001600160a01b0391821691161490565b6001546100d1906001600160a01b031681565b604051610091919061050a565b6100f16100ec36600461051e565b610165565b005b6100f16101013660046105a4565b6101fd565b6100f16101143660046105bf565b61027d565b6101216103e3565b60405161009191906105f2565b60006001600160e01b03198216633001c1ef60e21b148061015f57506301ffc9a760e01b6001600160e01b03198316145b92915050565b6001546001600160a01b031633146101985760405162461bcd60e51b815260040161018f90610640565b60405180910390fd5b600180546001600160a01b038581166001600160a01b0319831681179093556040519116919082907f3f6845104f9728af7979eed8814320daba008953c8db93b9fe32602d1f34b475906101ef9087908790610669565b60405180910390a350505050565b6001546001600160a01b031633146102275760405162461bcd60e51b815260040161018f90610640565b806001600160a01b031663715018a66040518163ffffffff1660e01b8152600401600060405180830381600087803b15801561026257600080fd5b505af1158015610276573d6000803e3d6000fd5b5050505050565b6001546001600160a01b031633146102a75760405162461bcd60e51b815260040161018f90610640565b6040516301ffc9a760e01b8152633001c1ef60e21b60048201526001600160a01b038216906301ffc9a790602401602060405180830381865afa1580156102f2573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061031691906106b5565b6103815760405162461bcd60e51b815260206004820152603660248201527f41646d696e41434c56303a206e65772061646d696e2041434c20646f6573206e60448201527506f7420737570706f7274204941646d696e41434c56360541b606482015260840161018f565b60405163f2fde38b60e01b81526001600160a01b0383169063f2fde38b906103ad90849060040161050a565b600060405180830381600087803b1580156103c757600080fd5b505af11580156103db573d6000803e3d6000fd5b505050505050565b600080546103f0906106d7565b80601f016020809104026020016040519081016040528092919081815260200182805461041c906106d7565b80156104695780601f1061043e57610100808354040283529160200191610469565b820191906000526020600020905b81548152906001019060200180831161044c57829003601f168201915b505050505081565b80356001600160e01b03198116811461048957600080fd5b919050565b6000602082840312156104a057600080fd5b6104a982610471565b9392505050565b80356001600160a01b038116811461048957600080fd5b6000806000606084860312156104dc57600080fd5b6104e5846104b0565b92506104f3602085016104b0565b915061050160408501610471565b90509250925092565b6001600160a01b0391909116815260200190565b60008060006040848603121561053357600080fd5b61053c846104b0565b9250602084013567ffffffffffffffff8082111561055957600080fd5b818601915086601f83011261056d57600080fd5b81358181111561057c57600080fd5b8760208260051b850101111561059157600080fd5b6020830194508093505050509250925092565b6000602082840312156105b657600080fd5b6104a9826104b0565b600080604083850312156105d257600080fd5b6105db836104b0565b91506105e9602084016104b0565b90509250929050565b600060208083528351808285015260005b8181101561061f57858101830151858201604001528201610603565b506000604082860101526040601f19601f8301168501019250505092915050565b6020808252600f908201526e27b7363c9039bab832b920b236b4b760891b604082015260600190565b60208082528181018390526000908460408401835b868110156106aa576001600160a01b03610697846104b0565b168252918301919083019060010161067e565b509695505050505050565b6000602082840312156106c757600080fd5b815180151581146104a957600080fd5b600181811c908216806106eb57607f821691505b60208210810361070b57634e487b7160e01b600052602260045260246000fd5b5091905056fea2646970667358221220eb60dafe19251564df41a812729a78538c16b536734e69e73af5740cb85ff5b364736f6c63430008110033",
+  "bytecode": "0x60c0604052600a608090815269041646d696e41434c56360b41b60a05260009061002990826100ed565b5034801561003657600080fd5b50600180546001600160a01b031916331790556101ac565b634e487b7160e01b600052604160045260246000fd5b600181811c9082168061007857607f821691505b60208210810361009857634e487b7160e01b600052602260045260246000fd5b50919050565b601f8211156100e857600081815260208120601f850160051c810160208610156100c55750805b601f850160051c820191505b818110156100e4578281556001016100d1565b5050505b505050565b81516001600160401b038111156101065761010661004e565b61011a816101148454610064565b8461009e565b602080601f83116001811461014f57600084156101375750858301515b600019600386901b1c1916600185901b1785556100e4565b600085815260208120601f198616915b8281101561017e5788860151825594840194600190910190840161015f565b508582101561019c5787850151600019600388901b60f8161c191681555b5050505050600190811b01905550565b610747806101bb6000396000f3fe608060405234801561001057600080fd5b506004361061006d5760003560e01c806301ffc9a71461007257806305de62c01461009a57806329575f6a146100be578063377a7d1a146100de578063985d1968146100f3578063bcc91a1014610106578063c81a396e14610119575b600080fd5b61008561008036600461048e565b61012e565b60405190151581526020015b60405180910390f35b6100856100a83660046104c7565b50506001546001600160a01b0391821691161490565b6001546100d1906001600160a01b031681565b604051610091919061050a565b6100f16100ec36600461051e565b610165565b005b6100f16101013660046105a4565b6101fd565b6100f16101143660046105bf565b61027d565b6101216103e3565b60405161009191906105f2565b60006001600160e01b03198216633001c1ef60e21b148061015f57506301ffc9a760e01b6001600160e01b03198316145b92915050565b6001546001600160a01b031633146101985760405162461bcd60e51b815260040161018f90610640565b60405180910390fd5b600180546001600160a01b038581166001600160a01b0319831681179093556040519116919082907f3f6845104f9728af7979eed8814320daba008953c8db93b9fe32602d1f34b475906101ef9087908790610669565b60405180910390a350505050565b6001546001600160a01b031633146102275760405162461bcd60e51b815260040161018f90610640565b806001600160a01b031663715018a66040518163ffffffff1660e01b8152600401600060405180830381600087803b15801561026257600080fd5b505af1158015610276573d6000803e3d6000fd5b5050505050565b6001546001600160a01b031633146102a75760405162461bcd60e51b815260040161018f90610640565b6040516301ffc9a760e01b8152633001c1ef60e21b60048201526001600160a01b038216906301ffc9a790602401602060405180830381865afa1580156102f2573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061031691906106b5565b6103815760405162461bcd60e51b815260206004820152603660248201527f41646d696e41434c56303a206e65772061646d696e2041434c20646f6573206e60448201527506f7420737570706f7274204941646d696e41434c56360541b606482015260840161018f565b60405163f2fde38b60e01b81526001600160a01b0383169063f2fde38b906103ad90849060040161050a565b600060405180830381600087803b1580156103c757600080fd5b505af11580156103db573d6000803e3d6000fd5b505050505050565b600080546103f0906106d7565b80601f016020809104026020016040519081016040528092919081815260200182805461041c906106d7565b80156104695780601f1061043e57610100808354040283529160200191610469565b820191906000526020600020905b81548152906001019060200180831161044c57829003601f168201915b505050505081565b80356001600160e01b03198116811461048957600080fd5b919050565b6000602082840312156104a057600080fd5b6104a982610471565b9392505050565b80356001600160a01b038116811461048957600080fd5b6000806000606084860312156104dc57600080fd5b6104e5846104b0565b92506104f3602085016104b0565b915061050160408501610471565b90509250925092565b6001600160a01b0391909116815260200190565b60008060006040848603121561053357600080fd5b61053c846104b0565b9250602084013567ffffffffffffffff8082111561055957600080fd5b818601915086601f83011261056d57600080fd5b81358181111561057c57600080fd5b8760208260051b850101111561059157600080fd5b6020830194508093505050509250925092565b6000602082840312156105b657600080fd5b6104a9826104b0565b600080604083850312156105d257600080fd5b6105db836104b0565b91506105e9602084016104b0565b90509250929050565b600060208083528351808285015260005b8181101561061f57858101830151858201604001528201610603565b506000604082860101526040601f19601f8301168501019250505092915050565b6020808252600f908201526e27b7363c9039bab832b920b236b4b760891b604082015260600190565b60208082528181018390526000908460408401835b868110156106aa576001600160a01b03610697846104b0565b168252918301919083019060010161067e565b509695505050505050565b6000602082840312156106c757600080fd5b815180151581146104a957600080fd5b600181811c908216806106eb57607f821691505b60208210810361070b57634e487b7160e01b600052602260045260246000fd5b5091905056fea2646970667358221220d96c75f41d986d1b121cc15d73d3989c424fa829640d2f5d0b26c30e0f5cba2f64736f6c63430008130033",
+  "deployedBytecode": "0x608060405234801561001057600080fd5b506004361061006d5760003560e01c806301ffc9a71461007257806305de62c01461009a57806329575f6a146100be578063377a7d1a146100de578063985d1968146100f3578063bcc91a1014610106578063c81a396e14610119575b600080fd5b61008561008036600461048e565b61012e565b60405190151581526020015b60405180910390f35b6100856100a83660046104c7565b50506001546001600160a01b0391821691161490565b6001546100d1906001600160a01b031681565b604051610091919061050a565b6100f16100ec36600461051e565b610165565b005b6100f16101013660046105a4565b6101fd565b6100f16101143660046105bf565b61027d565b6101216103e3565b60405161009191906105f2565b60006001600160e01b03198216633001c1ef60e21b148061015f57506301ffc9a760e01b6001600160e01b03198316145b92915050565b6001546001600160a01b031633146101985760405162461bcd60e51b815260040161018f90610640565b60405180910390fd5b600180546001600160a01b038581166001600160a01b0319831681179093556040519116919082907f3f6845104f9728af7979eed8814320daba008953c8db93b9fe32602d1f34b475906101ef9087908790610669565b60405180910390a350505050565b6001546001600160a01b031633146102275760405162461bcd60e51b815260040161018f90610640565b806001600160a01b031663715018a66040518163ffffffff1660e01b8152600401600060405180830381600087803b15801561026257600080fd5b505af1158015610276573d6000803e3d6000fd5b5050505050565b6001546001600160a01b031633146102a75760405162461bcd60e51b815260040161018f90610640565b6040516301ffc9a760e01b8152633001c1ef60e21b60048201526001600160a01b038216906301ffc9a790602401602060405180830381865afa1580156102f2573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061031691906106b5565b6103815760405162461bcd60e51b815260206004820152603660248201527f41646d696e41434c56303a206e65772061646d696e2041434c20646f6573206e60448201527506f7420737570706f7274204941646d696e41434c56360541b606482015260840161018f565b60405163f2fde38b60e01b81526001600160a01b0383169063f2fde38b906103ad90849060040161050a565b600060405180830381600087803b1580156103c757600080fd5b505af11580156103db573d6000803e3d6000fd5b505050505050565b600080546103f0906106d7565b80601f016020809104026020016040519081016040528092919081815260200182805461041c906106d7565b80156104695780601f1061043e57610100808354040283529160200191610469565b820191906000526020600020905b81548152906001019060200180831161044c57829003601f168201915b505050505081565b80356001600160e01b03198116811461048957600080fd5b919050565b6000602082840312156104a057600080fd5b6104a982610471565b9392505050565b80356001600160a01b038116811461048957600080fd5b6000806000606084860312156104dc57600080fd5b6104e5846104b0565b92506104f3602085016104b0565b915061050160408501610471565b90509250925092565b6001600160a01b0391909116815260200190565b60008060006040848603121561053357600080fd5b61053c846104b0565b9250602084013567ffffffffffffffff8082111561055957600080fd5b818601915086601f83011261056d57600080fd5b81358181111561057c57600080fd5b8760208260051b850101111561059157600080fd5b6020830194508093505050509250925092565b6000602082840312156105b657600080fd5b6104a9826104b0565b600080604083850312156105d257600080fd5b6105db836104b0565b91506105e9602084016104b0565b90509250929050565b600060208083528351808285015260005b8181101561061f57858101830151858201604001528201610603565b506000604082860101526040601f19601f8301168501019250505092915050565b6020808252600f908201526e27b7363c9039bab832b920b236b4b760891b604082015260600190565b60208082528181018390526000908460408401835b868110156106aa576001600160a01b03610697846104b0565b168252918301919083019060010161067e565b509695505050505050565b6000602082840312156106c757600080fd5b815180151581146104a957600080fd5b600181811c908216806106eb57607f821691505b60208210810361070b57634e487b7160e01b600052602260045260246000fd5b5091905056fea2646970667358221220d96c75f41d986d1b121cc15d73d3989c424fa829640d2f5d0b26c30e0f5cba2f64736f6c63430008130033",
   "linkReferences": {},
   "deployedLinkReferences": {}
 }

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

@@ -241,8 +241,8 @@
       "type": "function"
     }
   ],
-  "bytecode": "0x60c0604052600a60809081526941646d696e41434c563160b01b60a0526000906200002b9082620000f7565b503480156200003957600080fd5b50600180546001600160a01b03191633179055620001c3565b634e487b7160e01b600052604160045260246000fd5b600181811c908216806200007d57607f821691505b6020821081036200009e57634e487b7160e01b600052602260045260246000fd5b50919050565b601f821115620000f257600081815260208120601f850160051c81016020861015620000cd5750805b601f850160051c820191505b81811015620000ee57828155600101620000d9565b5050505b505050565b81516001600160401b0381111562000113576200011362000052565b6200012b8162000124845462000068565b84620000a4565b602080601f8311600181146200016357600084156200014a5750858301515b600019600386901b1c1916600185901b178555620000ee565b600085815260208120601f198616915b82811015620001945788860151825594840194600190910190840162000173565b5085821015620001b35787850151600019600388901b60f8161c191681555b5050505050600190811b01905550565b610bac80620001d36000396000f3fe608060405234801561001057600080fd5b50600436106100995760003560e01c806301ffc9a71461009e57806305de62c0146100c657806329575f6a146100d9578063377a7d1a146100f9578063625e1b7d1461010e578063940ef80014610121578063985d196814610137578063ad35d2de1461014a578063bcc91a101461015d578063c81a396e14610170578063c94dca9a14610185575b600080fd5b6100b16100ac366004610894565b610198565b60405190151581526020015b60405180910390f35b6100b16100d43660046108c6565b6101cf565b6001546100ec906001600160a01b031681565b6040516100bd9190610909565b61010c61010736600461091d565b610234565b005b6100ec61011c3660046109a3565b6102cc565b6101296102d9565b6040519081526020016100bd565b61010c6101453660046109bc565b6102ea565b61010c6101583660046109bc565b61036a565b61010c61016b3660046109d7565b610422565b610178610588565b6040516100bd9190610a0a565b61010c6101933660046109bc565b610616565b60006001600160e01b03198216633001c1ef60e21b14806101c957506301ffc9a760e01b6001600160e01b03198316145b92915050565b6001546000906001600160a01b03908116908516036101f05750600161022d565b638911905560e01b6001600160e01b031983160161022957506001600160a01b038316600090815260036020526040902054151561022d565b5060005b9392505050565b6001546001600160a01b031633146102675760405162461bcd60e51b815260040161025e90610a58565b60405180910390fd5b600180546001600160a01b038581166001600160a01b0319831681179093556040519116919082907f3f6845104f9728af7979eed8814320daba008953c8db93b9fe32602d1f34b475906102be9087908790610a81565b60405180910390a350505050565b60006101c96002836106cb565b60006102e560026106d7565b905090565b6001546001600160a01b031633146103145760405162461bcd60e51b815260040161025e90610a58565b806001600160a01b031663715018a66040518163ffffffff1660e01b8152600401600060405180830381600087803b15801561034f57600080fd5b505af1158015610363573d6000803e3d6000fd5b5050505050565b6001546001600160a01b031633146103945760405162461bcd60e51b815260040161025e90610a58565b61039f6002826106e1565b6103eb5760405162461bcd60e51b815260206004820152601e60248201527f41646d696e41434c56313a20416c726561647920726567697374657265640000604482015260640161025e565b6040516001600160a01b038216907fcfa45e813a030b8a5edb7a194db400758a7838280a892097169e8bc310a6bc9390600090a250565b6001546001600160a01b0316331461044c5760405162461bcd60e51b815260040161025e90610a58565b6040516301ffc9a760e01b8152633001c1ef60e21b60048201526001600160a01b038216906301ffc9a790602401602060405180830381865afa158015610497573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906104bb9190610acd565b6105265760405162461bcd60e51b815260206004820152603660248201527f41646d696e41434c56313a206e65772061646d696e2041434c20646f6573206e60448201527506f7420737570706f7274204941646d696e41434c56360541b606482015260840161025e565b60405163f2fde38b60e01b81526001600160a01b0383169063f2fde38b90610552908490600401610909565b600060405180830381600087803b15801561056c57600080fd5b505af1158015610580573d6000803e3d6000fd5b505050505050565b6000805461059590610aef565b80601f01602080910402602001604051908101604052809291908181526020018280546105c190610aef565b801561060e5780601f106105e35761010080835404028352916020019161060e565b820191906000526020600020905b8154815290600101906020018083116105f157829003601f168201915b505050505081565b6001546001600160a01b031633146106405760405162461bcd60e51b815260040161025e90610a58565b61064b6002826106f6565b6106945760405162461bcd60e51b815260206004820152601a60248201527910591b5a5b9050d3158c4e88139bdd081c9959da5cdd195c995960321b604482015260640161025e565b6040516001600160a01b038216907ff1de73f684ba2cffe486a26456673d031647e0c7964095865ed8e159873edde290600090a250565b600061022d838361070b565b60006101c9825490565b600061022d836001600160a01b038416610735565b600061022d836001600160a01b038416610784565b600082600001828154811061072257610722610b29565b9060005260206000200154905092915050565b600081815260018301602052604081205461077c575081546001818101845560008481526020808220909301849055845484825282860190935260409020919091556101c9565b5060006101c9565b6000818152600183016020526040812054801561086d5760006107a8600183610b3f565b85549091506000906107bc90600190610b3f565b90508181146108215760008660000182815481106107dc576107dc610b29565b90600052602060002001549050808760000184815481106107ff576107ff610b29565b6000918252602080832090910192909255918252600188019052604090208390555b855486908061083257610832610b60565b6001900381819060005260206000200160009055905585600101600086815260200190815260200160002060009055600193505050506101c9565b60009150506101c9565b80356001600160e01b03198116811461088f57600080fd5b919050565b6000602082840312156108a657600080fd5b61022d82610877565b80356001600160a01b038116811461088f57600080fd5b6000806000606084860312156108db57600080fd5b6108e4846108af565b92506108f2602085016108af565b915061090060408501610877565b90509250925092565b6001600160a01b0391909116815260200190565b60008060006040848603121561093257600080fd5b61093b846108af565b9250602084013567ffffffffffffffff8082111561095857600080fd5b818601915086601f83011261096c57600080fd5b81358181111561097b57600080fd5b8760208260051b850101111561099057600080fd5b6020830194508093505050509250925092565b6000602082840312156109b557600080fd5b5035919050565b6000602082840312156109ce57600080fd5b61022d826108af565b600080604083850312156109ea57600080fd5b6109f3836108af565b9150610a01602084016108af565b90509250929050565b600060208083528351808285015260005b81811015610a3757858101830151858201604001528201610a1b565b506000604082860101526040601f19601f8301168501019250505092915050565b6020808252600f908201526e27b7363c9039bab832b920b236b4b760891b604082015260600190565b60208082528181018390526000908460408401835b86811015610ac2576001600160a01b03610aaf846108af565b1682529183019190830190600101610a96565b509695505050505050565b600060208284031215610adf57600080fd5b8151801515811461022d57600080fd5b600181811c90821680610b0357607f821691505b602082108103610b2357634e487b7160e01b600052602260045260246000fd5b50919050565b634e487b7160e01b600052603260045260246000fd5b818103818111156101c957634e487b7160e01b600052601160045260246000fd5b634e487b7160e01b600052603160045260246000fdfea26469706673582212203fb62a5817293aff376dcb3c493eeb88761b57a13426455593b068f7346c7daf64736f6c63430008110033",
-  "deployedBytecode": "0x608060405234801561001057600080fd5b50600436106100995760003560e01c806301ffc9a71461009e57806305de62c0146100c657806329575f6a146100d9578063377a7d1a146100f9578063625e1b7d1461010e578063940ef80014610121578063985d196814610137578063ad35d2de1461014a578063bcc91a101461015d578063c81a396e14610170578063c94dca9a14610185575b600080fd5b6100b16100ac366004610894565b610198565b60405190151581526020015b60405180910390f35b6100b16100d43660046108c6565b6101cf565b6001546100ec906001600160a01b031681565b6040516100bd9190610909565b61010c61010736600461091d565b610234565b005b6100ec61011c3660046109a3565b6102cc565b6101296102d9565b6040519081526020016100bd565b61010c6101453660046109bc565b6102ea565b61010c6101583660046109bc565b61036a565b61010c61016b3660046109d7565b610422565b610178610588565b6040516100bd9190610a0a565b61010c6101933660046109bc565b610616565b60006001600160e01b03198216633001c1ef60e21b14806101c957506301ffc9a760e01b6001600160e01b03198316145b92915050565b6001546000906001600160a01b03908116908516036101f05750600161022d565b638911905560e01b6001600160e01b031983160161022957506001600160a01b038316600090815260036020526040902054151561022d565b5060005b9392505050565b6001546001600160a01b031633146102675760405162461bcd60e51b815260040161025e90610a58565b60405180910390fd5b600180546001600160a01b038581166001600160a01b0319831681179093556040519116919082907f3f6845104f9728af7979eed8814320daba008953c8db93b9fe32602d1f34b475906102be9087908790610a81565b60405180910390a350505050565b60006101c96002836106cb565b60006102e560026106d7565b905090565b6001546001600160a01b031633146103145760405162461bcd60e51b815260040161025e90610a58565b806001600160a01b031663715018a66040518163ffffffff1660e01b8152600401600060405180830381600087803b15801561034f57600080fd5b505af1158015610363573d6000803e3d6000fd5b5050505050565b6001546001600160a01b031633146103945760405162461bcd60e51b815260040161025e90610a58565b61039f6002826106e1565b6103eb5760405162461bcd60e51b815260206004820152601e60248201527f41646d696e41434c56313a20416c726561647920726567697374657265640000604482015260640161025e565b6040516001600160a01b038216907fcfa45e813a030b8a5edb7a194db400758a7838280a892097169e8bc310a6bc9390600090a250565b6001546001600160a01b0316331461044c5760405162461bcd60e51b815260040161025e90610a58565b6040516301ffc9a760e01b8152633001c1ef60e21b60048201526001600160a01b038216906301ffc9a790602401602060405180830381865afa158015610497573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906104bb9190610acd565b6105265760405162461bcd60e51b815260206004820152603660248201527f41646d696e41434c56313a206e65772061646d696e2041434c20646f6573206e60448201527506f7420737570706f7274204941646d696e41434c56360541b606482015260840161025e565b60405163f2fde38b60e01b81526001600160a01b0383169063f2fde38b90610552908490600401610909565b600060405180830381600087803b15801561056c57600080fd5b505af1158015610580573d6000803e3d6000fd5b505050505050565b6000805461059590610aef565b80601f01602080910402602001604051908101604052809291908181526020018280546105c190610aef565b801561060e5780601f106105e35761010080835404028352916020019161060e565b820191906000526020600020905b8154815290600101906020018083116105f157829003601f168201915b505050505081565b6001546001600160a01b031633146106405760405162461bcd60e51b815260040161025e90610a58565b61064b6002826106f6565b6106945760405162461bcd60e51b815260206004820152601a60248201527910591b5a5b9050d3158c4e88139bdd081c9959da5cdd195c995960321b604482015260640161025e565b6040516001600160a01b038216907ff1de73f684ba2cffe486a26456673d031647e0c7964095865ed8e159873edde290600090a250565b600061022d838361070b565b60006101c9825490565b600061022d836001600160a01b038416610735565b600061022d836001600160a01b038416610784565b600082600001828154811061072257610722610b29565b9060005260206000200154905092915050565b600081815260018301602052604081205461077c575081546001818101845560008481526020808220909301849055845484825282860190935260409020919091556101c9565b5060006101c9565b6000818152600183016020526040812054801561086d5760006107a8600183610b3f565b85549091506000906107bc90600190610b3f565b90508181146108215760008660000182815481106107dc576107dc610b29565b90600052602060002001549050808760000184815481106107ff576107ff610b29565b6000918252602080832090910192909255918252600188019052604090208390555b855486908061083257610832610b60565b6001900381819060005260206000200160009055905585600101600086815260200190815260200160002060009055600193505050506101c9565b60009150506101c9565b80356001600160e01b03198116811461088f57600080fd5b919050565b6000602082840312156108a657600080fd5b61022d82610877565b80356001600160a01b038116811461088f57600080fd5b6000806000606084860312156108db57600080fd5b6108e4846108af565b92506108f2602085016108af565b915061090060408501610877565b90509250925092565b6001600160a01b0391909116815260200190565b60008060006040848603121561093257600080fd5b61093b846108af565b9250602084013567ffffffffffffffff8082111561095857600080fd5b818601915086601f83011261096c57600080fd5b81358181111561097b57600080fd5b8760208260051b850101111561099057600080fd5b6020830194508093505050509250925092565b6000602082840312156109b557600080fd5b5035919050565b6000602082840312156109ce57600080fd5b61022d826108af565b600080604083850312156109ea57600080fd5b6109f3836108af565b9150610a01602084016108af565b90509250929050565b600060208083528351808285015260005b81811015610a3757858101830151858201604001528201610a1b565b506000604082860101526040601f19601f8301168501019250505092915050565b6020808252600f908201526e27b7363c9039bab832b920b236b4b760891b604082015260600190565b60208082528181018390526000908460408401835b86811015610ac2576001600160a01b03610aaf846108af565b1682529183019190830190600101610a96565b509695505050505050565b600060208284031215610adf57600080fd5b8151801515811461022d57600080fd5b600181811c90821680610b0357607f821691505b602082108103610b2357634e487b7160e01b600052602260045260246000fd5b50919050565b634e487b7160e01b600052603260045260246000fd5b818103818111156101c957634e487b7160e01b600052601160045260246000fd5b634e487b7160e01b600052603160045260246000fdfea26469706673582212203fb62a5817293aff376dcb3c493eeb88761b57a13426455593b068f7346c7daf64736f6c63430008110033",
+  "bytecode": "0x60c0604052600a60809081526941646d696e41434c563160b01b60a0526000906200002b9082620000f7565b503480156200003957600080fd5b50600180546001600160a01b03191633179055620001c3565b634e487b7160e01b600052604160045260246000fd5b600181811c908216806200007d57607f821691505b6020821081036200009e57634e487b7160e01b600052602260045260246000fd5b50919050565b601f821115620000f257600081815260208120601f850160051c81016020861015620000cd5750805b601f850160051c820191505b81811015620000ee57828155600101620000d9565b5050505b505050565b81516001600160401b0381111562000113576200011362000052565b6200012b8162000124845462000068565b84620000a4565b602080601f8311600181146200016357600084156200014a5750858301515b600019600386901b1c1916600185901b178555620000ee565b600085815260208120601f198616915b82811015620001945788860151825594840194600190910190840162000173565b5085821015620001b35787850151600019600388901b60f8161c191681555b5050505050600190811b01905550565b610bac80620001d36000396000f3fe608060405234801561001057600080fd5b50600436106100995760003560e01c806301ffc9a71461009e57806305de62c0146100c657806329575f6a146100d9578063377a7d1a146100f9578063625e1b7d1461010e578063940ef80014610121578063985d196814610137578063ad35d2de1461014a578063bcc91a101461015d578063c81a396e14610170578063c94dca9a14610185575b600080fd5b6100b16100ac366004610894565b610198565b60405190151581526020015b60405180910390f35b6100b16100d43660046108c6565b6101cf565b6001546100ec906001600160a01b031681565b6040516100bd9190610909565b61010c61010736600461091d565b610234565b005b6100ec61011c3660046109a3565b6102cc565b6101296102d9565b6040519081526020016100bd565b61010c6101453660046109bc565b6102ea565b61010c6101583660046109bc565b61036a565b61010c61016b3660046109d7565b610422565b610178610588565b6040516100bd9190610a0a565b61010c6101933660046109bc565b610616565b60006001600160e01b03198216633001c1ef60e21b14806101c957506301ffc9a760e01b6001600160e01b03198316145b92915050565b6001546000906001600160a01b03908116908516036101f05750600161022d565b638911905560e01b6001600160e01b031983160161022957506001600160a01b038316600090815260036020526040902054151561022d565b5060005b9392505050565b6001546001600160a01b031633146102675760405162461bcd60e51b815260040161025e90610a58565b60405180910390fd5b600180546001600160a01b038581166001600160a01b0319831681179093556040519116919082907f3f6845104f9728af7979eed8814320daba008953c8db93b9fe32602d1f34b475906102be9087908790610a81565b60405180910390a350505050565b60006101c96002836106cb565b60006102e560026106d7565b905090565b6001546001600160a01b031633146103145760405162461bcd60e51b815260040161025e90610a58565b806001600160a01b031663715018a66040518163ffffffff1660e01b8152600401600060405180830381600087803b15801561034f57600080fd5b505af1158015610363573d6000803e3d6000fd5b5050505050565b6001546001600160a01b031633146103945760405162461bcd60e51b815260040161025e90610a58565b61039f6002826106e1565b6103eb5760405162461bcd60e51b815260206004820152601e60248201527f41646d696e41434c56313a20416c726561647920726567697374657265640000604482015260640161025e565b6040516001600160a01b038216907fcfa45e813a030b8a5edb7a194db400758a7838280a892097169e8bc310a6bc9390600090a250565b6001546001600160a01b0316331461044c5760405162461bcd60e51b815260040161025e90610a58565b6040516301ffc9a760e01b8152633001c1ef60e21b60048201526001600160a01b038216906301ffc9a790602401602060405180830381865afa158015610497573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906104bb9190610acd565b6105265760405162461bcd60e51b815260206004820152603660248201527f41646d696e41434c56313a206e65772061646d696e2041434c20646f6573206e60448201527506f7420737570706f7274204941646d696e41434c56360541b606482015260840161025e565b60405163f2fde38b60e01b81526001600160a01b0383169063f2fde38b90610552908490600401610909565b600060405180830381600087803b15801561056c57600080fd5b505af1158015610580573d6000803e3d6000fd5b505050505050565b6000805461059590610aef565b80601f01602080910402602001604051908101604052809291908181526020018280546105c190610aef565b801561060e5780601f106105e35761010080835404028352916020019161060e565b820191906000526020600020905b8154815290600101906020018083116105f157829003601f168201915b505050505081565b6001546001600160a01b031633146106405760405162461bcd60e51b815260040161025e90610a58565b61064b6002826106f6565b6106945760405162461bcd60e51b815260206004820152601a60248201527910591b5a5b9050d3158c4e88139bdd081c9959da5cdd195c995960321b604482015260640161025e565b6040516001600160a01b038216907ff1de73f684ba2cffe486a26456673d031647e0c7964095865ed8e159873edde290600090a250565b600061022d838361070b565b60006101c9825490565b600061022d836001600160a01b038416610735565b600061022d836001600160a01b038416610784565b600082600001828154811061072257610722610b29565b9060005260206000200154905092915050565b600081815260018301602052604081205461077c575081546001818101845560008481526020808220909301849055845484825282860190935260409020919091556101c9565b5060006101c9565b6000818152600183016020526040812054801561086d5760006107a8600183610b3f565b85549091506000906107bc90600190610b3f565b90508181146108215760008660000182815481106107dc576107dc610b29565b90600052602060002001549050808760000184815481106107ff576107ff610b29565b6000918252602080832090910192909255918252600188019052604090208390555b855486908061083257610832610b60565b6001900381819060005260206000200160009055905585600101600086815260200190815260200160002060009055600193505050506101c9565b60009150506101c9565b80356001600160e01b03198116811461088f57600080fd5b919050565b6000602082840312156108a657600080fd5b61022d82610877565b80356001600160a01b038116811461088f57600080fd5b6000806000606084860312156108db57600080fd5b6108e4846108af565b92506108f2602085016108af565b915061090060408501610877565b90509250925092565b6001600160a01b0391909116815260200190565b60008060006040848603121561093257600080fd5b61093b846108af565b9250602084013567ffffffffffffffff8082111561095857600080fd5b818601915086601f83011261096c57600080fd5b81358181111561097b57600080fd5b8760208260051b850101111561099057600080fd5b6020830194508093505050509250925092565b6000602082840312156109b557600080fd5b5035919050565b6000602082840312156109ce57600080fd5b61022d826108af565b600080604083850312156109ea57600080fd5b6109f3836108af565b9150610a01602084016108af565b90509250929050565b600060208083528351808285015260005b81811015610a3757858101830151858201604001528201610a1b565b506000604082860101526040601f19601f8301168501019250505092915050565b6020808252600f908201526e27b7363c9039bab832b920b236b4b760891b604082015260600190565b60208082528181018390526000908460408401835b86811015610ac2576001600160a01b03610aaf846108af565b1682529183019190830190600101610a96565b509695505050505050565b600060208284031215610adf57600080fd5b8151801515811461022d57600080fd5b600181811c90821680610b0357607f821691505b602082108103610b2357634e487b7160e01b600052602260045260246000fd5b50919050565b634e487b7160e01b600052603260045260246000fd5b818103818111156101c957634e487b7160e01b600052601160045260246000fd5b634e487b7160e01b600052603160045260246000fdfea2646970667358221220be0b58373e938571eb6b22e8bed646f7d2c193f57f017f71b0c5ee38cd0d09a664736f6c63430008130033",
+  "deployedBytecode": "0x608060405234801561001057600080fd5b50600436106100995760003560e01c806301ffc9a71461009e57806305de62c0146100c657806329575f6a146100d9578063377a7d1a146100f9578063625e1b7d1461010e578063940ef80014610121578063985d196814610137578063ad35d2de1461014a578063bcc91a101461015d578063c81a396e14610170578063c94dca9a14610185575b600080fd5b6100b16100ac366004610894565b610198565b60405190151581526020015b60405180910390f35b6100b16100d43660046108c6565b6101cf565b6001546100ec906001600160a01b031681565b6040516100bd9190610909565b61010c61010736600461091d565b610234565b005b6100ec61011c3660046109a3565b6102cc565b6101296102d9565b6040519081526020016100bd565b61010c6101453660046109bc565b6102ea565b61010c6101583660046109bc565b61036a565b61010c61016b3660046109d7565b610422565b610178610588565b6040516100bd9190610a0a565b61010c6101933660046109bc565b610616565b60006001600160e01b03198216633001c1ef60e21b14806101c957506301ffc9a760e01b6001600160e01b03198316145b92915050565b6001546000906001600160a01b03908116908516036101f05750600161022d565b638911905560e01b6001600160e01b031983160161022957506001600160a01b038316600090815260036020526040902054151561022d565b5060005b9392505050565b6001546001600160a01b031633146102675760405162461bcd60e51b815260040161025e90610a58565b60405180910390fd5b600180546001600160a01b038581166001600160a01b0319831681179093556040519116919082907f3f6845104f9728af7979eed8814320daba008953c8db93b9fe32602d1f34b475906102be9087908790610a81565b60405180910390a350505050565b60006101c96002836106cb565b60006102e560026106d7565b905090565b6001546001600160a01b031633146103145760405162461bcd60e51b815260040161025e90610a58565b806001600160a01b031663715018a66040518163ffffffff1660e01b8152600401600060405180830381600087803b15801561034f57600080fd5b505af1158015610363573d6000803e3d6000fd5b5050505050565b6001546001600160a01b031633146103945760405162461bcd60e51b815260040161025e90610a58565b61039f6002826106e1565b6103eb5760405162461bcd60e51b815260206004820152601e60248201527f41646d696e41434c56313a20416c726561647920726567697374657265640000604482015260640161025e565b6040516001600160a01b038216907fcfa45e813a030b8a5edb7a194db400758a7838280a892097169e8bc310a6bc9390600090a250565b6001546001600160a01b0316331461044c5760405162461bcd60e51b815260040161025e90610a58565b6040516301ffc9a760e01b8152633001c1ef60e21b60048201526001600160a01b038216906301ffc9a790602401602060405180830381865afa158015610497573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906104bb9190610acd565b6105265760405162461bcd60e51b815260206004820152603660248201527f41646d696e41434c56313a206e65772061646d696e2041434c20646f6573206e60448201527506f7420737570706f7274204941646d696e41434c56360541b606482015260840161025e565b60405163f2fde38b60e01b81526001600160a01b0383169063f2fde38b90610552908490600401610909565b600060405180830381600087803b15801561056c57600080fd5b505af1158015610580573d6000803e3d6000fd5b505050505050565b6000805461059590610aef565b80601f01602080910402602001604051908101604052809291908181526020018280546105c190610aef565b801561060e5780601f106105e35761010080835404028352916020019161060e565b820191906000526020600020905b8154815290600101906020018083116105f157829003601f168201915b505050505081565b6001546001600160a01b031633146106405760405162461bcd60e51b815260040161025e90610a58565b61064b6002826106f6565b6106945760405162461bcd60e51b815260206004820152601a60248201527910591b5a5b9050d3158c4e88139bdd081c9959da5cdd195c995960321b604482015260640161025e565b6040516001600160a01b038216907ff1de73f684ba2cffe486a26456673d031647e0c7964095865ed8e159873edde290600090a250565b600061022d838361070b565b60006101c9825490565b600061022d836001600160a01b038416610735565b600061022d836001600160a01b038416610784565b600082600001828154811061072257610722610b29565b9060005260206000200154905092915050565b600081815260018301602052604081205461077c575081546001818101845560008481526020808220909301849055845484825282860190935260409020919091556101c9565b5060006101c9565b6000818152600183016020526040812054801561086d5760006107a8600183610b3f565b85549091506000906107bc90600190610b3f565b90508181146108215760008660000182815481106107dc576107dc610b29565b90600052602060002001549050808760000184815481106107ff576107ff610b29565b6000918252602080832090910192909255918252600188019052604090208390555b855486908061083257610832610b60565b6001900381819060005260206000200160009055905585600101600086815260200190815260200160002060009055600193505050506101c9565b60009150506101c9565b80356001600160e01b03198116811461088f57600080fd5b919050565b6000602082840312156108a657600080fd5b61022d82610877565b80356001600160a01b038116811461088f57600080fd5b6000806000606084860312156108db57600080fd5b6108e4846108af565b92506108f2602085016108af565b915061090060408501610877565b90509250925092565b6001600160a01b0391909116815260200190565b60008060006040848603121561093257600080fd5b61093b846108af565b9250602084013567ffffffffffffffff8082111561095857600080fd5b818601915086601f83011261096c57600080fd5b81358181111561097b57600080fd5b8760208260051b850101111561099057600080fd5b6020830194508093505050509250925092565b6000602082840312156109b557600080fd5b5035919050565b6000602082840312156109ce57600080fd5b61022d826108af565b600080604083850312156109ea57600080fd5b6109f3836108af565b9150610a01602084016108af565b90509250929050565b600060208083528351808285015260005b81811015610a3757858101830151858201604001528201610a1b565b506000604082860101526040601f19601f8301168501019250505092915050565b6020808252600f908201526e27b7363c9039bab832b920b236b4b760891b604082015260600190565b60208082528181018390526000908460408401835b86811015610ac2576001600160a01b03610aaf846108af565b1682529183019190830190600101610a96565b509695505050505050565b600060208284031215610adf57600080fd5b8151801515811461022d57600080fd5b600181811c90821680610b0357607f821691505b602082108103610b2357634e487b7160e01b600052602260045260246000fd5b50919050565b634e487b7160e01b600052603260045260246000fd5b818103818111156101c957634e487b7160e01b600052601160045260246000fd5b634e487b7160e01b600052603160045260246000fdfea2646970667358221220be0b58373e938571eb6b22e8bed646f7d2c193f57f017f71b0c5ee38cd0d09a664736f6c63430008130033",
   "linkReferences": {},
   "deployedLinkReferences": {}
 }