@artblocks/contracts 1.0.1 → 1.0.3

package/contracts/randomizer/primitive/PseudorandomAtomicBasic.sol

@@ -0,0 +1,30 @@
+// SPDX-License-Identifier: LGPL-3.0-only
+// Creatd By: Art Blocks Inc.
+
+pragma solidity 0.8.19;
+
+import "../../interfaces/0.8.x/IPseudorandomAtomic.sol";
+
+/**
+ * @title PseudorandomAtomic
+ * @author Art Blocks Inc.
+ * @notice This contract atomically returns a pseudorandom value.
+ */
+contract PseudorandomAtomic {
+    // base class that returns
+    function getPseudorandomAtomic(
+        bytes32 _entropy
+    ) external view returns (bytes32) {
+        uint256 time = block.timestamp;
+        return
+            keccak256(
+                abi.encodePacked(
+                    _entropy,
+                    block.number,
+                    blockhash(block.number - 1),
+                    time,
+                    (time % 200) + 1
+                )
+            );
+    }
+}

package/contracts/randomizer/shared/SharedRandomizerV0.sol

@@ -0,0 +1,245 @@
+// SPDX-License-Identifier: LGPL-3.0-only
+// Creatd By: Art Blocks Inc.
+
+pragma solidity 0.8.19;
+
+import "../../interfaces/0.8.x/IGenArt721CoreContractV3_Base.sol";
+import "../../interfaces/0.8.x/ISharedRandomizerV0.sol";
+import "../../interfaces/0.8.x/IPseudorandomAtomic.sol";
+
+/**
+ * @title A shared randomizer contract that enables support of many Art Blocks
+ * and Art Blocks Engine core contracts with a single randomizer.
+ * @notice This randomizer is designed to be used with many core contracts that
+ * implement the `IGenArt721CoreContractV3_Base` interface. It exclusively uses
+ * atomic callbacks, and will assign a token's hash before returning from the
+ * `assignTokenHash` function, as long as the call does not revert.
+ *
+ * The randomizer generates a token's hash seed in one of two ways:
+ * 1. If the project of the token is specified as a polyptych, the randomizer
+ * will assign the token the hash seed as previously set by the project's hash
+ * seed setter contract. If no hash seed has been set, the randomizer will
+ * revert.
+ * 2. If the project of the token is not specified as a polyptych, the
+ * randomizer will generate a new hash seed using the `IPseudorandomAtomic`
+ * contract, which is immutable and set during deployment.
+ *
+ * When using this randomizer for ployptych minting, several requirements may
+ * be required by the hash seed setter contract, including the possibility
+ * that a token's hash seed must be available in a public getter function on
+ * the core contract. Please inspect the hash seed setter contract to ensure
+ * that all requirements are met.
+ *
+ * @notice Privileged Roles and Ownership:
+ * Privileged roles and abilities are controlled by each core contract's admin
+ * ACL contract and artists. Both of these roles hold extensive power and can
+ * influence the behavior of this randomizer.
+ * Care must be taken to ensure that the admin ACL contract and artist
+ * addresses are secure behind a multi-sig or other access control mechanism.
+ * ----------------------------------------------------------------------------
+ * The following function is restricted to each core's Admin ACL contract:
+ * - setHashSeedSetterContract
+ * ----------------------------------------------------------------------------
+ * The following functions are restricted to only the Artist address:
+ * - toggleProjectIsPolyptych
+ * ----------------------------------------------------------------------------
+ * The following function is restricted to only the hash seed setter contract
+ * of a given core contract:
+ * - setPolyptychHashSeed
+ * ----------------------------------------------------------------------------
+ * Additional admin and artist privileged roles may be described on minters,
+ * registries, and other contracts that may interact with this randomizer.
+ */
+contract SharedRandomizerV0 is ISharedRandomizerV0 {
+    IPseudorandomAtomic public immutable pseudorandomAtomicContract;
+
+    // constant used to obtain the project ID from the token ID
+    uint256 internal constant ONE_MILLION = 1_000_000;
+
+    // mapping of core contract => token ID => hash seed
+    mapping(address => mapping(uint256 => bytes12)) private _polyptychHashSeed;
+
+    // mapping of core contract => project ID => is polyptych
+    mapping(address => mapping(uint256 => bool)) private _projectIsPolyptych;
+
+    // mapping of core contract => hash seed setter contract
+    mapping(address => address) private _hashSeedSetterContracts;
+
+    // modifier to restrict access to only AdminACL allowed calls
+    // @dev defers to ACL contract being used to the core contract
+    function _onlyCoreAdminACL(
+        address _coreContract,
+        bytes4 _selector
+    ) internal {
+        require(
+            IGenArt721CoreContractV3_Base(_coreContract).adminACLAllowed(
+                msg.sender,
+                address(this),
+                _selector
+            ),
+            "Only Core AdminACL allowed"
+        );
+    }
+
+    // modifier to restrict access to only Artist allowed calls
+    function _onlyArtist(
+        address _coreContract,
+        uint256 _projectId
+    ) internal view {
+        require(
+            msg.sender ==
+                IGenArt721CoreContractV3_Base(_coreContract)
+                    .projectIdToArtistAddress(_projectId),
+            "Only Artist"
+        );
+    }
+
+    // modifier to restrict access to only calls by the hash seed setter
+    // contract of a given core contract
+    function _onlyHashSeedSetterContract(address _coreContract) internal view {
+        require(
+            msg.sender == _hashSeedSetterContracts[_coreContract],
+            "Only Hash Seed Setter Contract"
+        );
+    }
+
+    /**
+     *
+     * @param _pseudorandomAtomicContract Address of the pseudorandom atomic
+     * contract to use for atomically generating random values. This contract
+     * does not have an owner, and therefore the pseudorandom atomic contract
+     * address cannot be changed after deployment.
+     */
+    constructor(address _pseudorandomAtomicContract) {
+        pseudorandomAtomicContract = IPseudorandomAtomic(
+            _pseudorandomAtomicContract
+        );
+        emit PseudorandomAtomicContractUpdated({
+            pseudorandomAtomicContract: _pseudorandomAtomicContract
+        });
+    }
+
+    /**
+     * @inheritdoc ISharedRandomizerV0
+     */
+    function setHashSeedSetterContract(
+        address _coreContract,
+        address _hashSeedSetterContract
+    ) external {
+        _onlyCoreAdminACL(
+            _coreContract,
+            this.setHashSeedSetterContract.selector
+        );
+        _hashSeedSetterContracts[_coreContract] = _hashSeedSetterContract;
+        emit HashSeedSetterForCoreUpdated({
+            coreContract: _coreContract,
+            hashSeedSetterContract: _hashSeedSetterContract
+        });
+    }
+
+    /**
+     * @inheritdoc ISharedRandomizerV0
+     */
+    function toggleProjectIsPolyptych(
+        address _coreContract,
+        uint256 _projectId
+    ) external {
+        _onlyArtist(_coreContract, _projectId);
+        _projectIsPolyptych[_coreContract][_projectId] = !_projectIsPolyptych[
+            _coreContract
+        ][_projectId];
+        emit ProjectIsPolyptychUpdated({
+            coreContract: _coreContract,
+            projectId: _projectId,
+            isPolyptych: _projectIsPolyptych[_coreContract][_projectId]
+        });
+    }
+
+    /**
+     * @inheritdoc ISharedRandomizerV0
+     */
+    function setPolyptychHashSeed(
+        address _coreContract,
+        uint256 _tokenId,
+        bytes12 _hashSeed
+    ) external {
+        _onlyHashSeedSetterContract(_coreContract);
+        _polyptychHashSeed[_coreContract][_tokenId] = _hashSeed;
+        // @dev event indicating token hash seed assigned is not required for
+        // subgraph indexing because token hash seeds are still assigned
+        // atomically in `assignTokenHash` function. If token hash seeds were
+        // assigned async, event emission may be required to support subgraph
+        // indexing.
+    }
+
+    /**
+     * @inheritdoc IRandomizer_V3CoreBase
+     */
+    function assignTokenHash(uint256 _tokenId) external {
+        // @dev this function is callable by any core contract, and does not
+        // does not require any gating.
+        // @dev naming variables for readability
+        address coreContract = msg.sender;
+        uint256 projectId = _tokenId / ONE_MILLION;
+        bytes32 hashSeed;
+        if (_projectIsPolyptych[coreContract][projectId]) {
+            hashSeed = _polyptychHashSeed[coreContract][_tokenId];
+        } else {
+            hashSeed = _getPseudorandomAtomic(coreContract, _tokenId);
+        }
+        // verify that the hash seed is non-zero
+        require(hashSeed != 0, "Only non-zero hash seed");
+        // assign the token hash seed on the core contract
+        IGenArt721CoreContractV3_Base(coreContract).setTokenHash_8PT(
+            _tokenId,
+            hashSeed
+        );
+    }
+
+    /**
+     * @inheritdoc ISharedRandomizerV0
+     */
+    function projectIsPolyptych(
+        address _coreContract,
+        uint256 _projectId
+    ) external view returns (bool _isPolyptych) {
+        return _projectIsPolyptych[_coreContract][_projectId];
+    }
+
+    /**
+     * @inheritdoc ISharedRandomizerV0
+     */
+    function hashSeedSetterContracts(
+        address _coreContract
+    ) external view returns (address _hashSeedSetterContract) {
+        return _hashSeedSetterContracts[_coreContract];
+    }
+
+    /**
+     * @inheritdoc ISharedRandomizerV0
+     */
+    function polyptychHashSeed(
+        address _coreContract,
+        uint256 _tokenId
+    ) external view returns (bytes12 _hashSeed) {
+        return _polyptychHashSeed[_coreContract][_tokenId];
+    }
+
+    /**
+     * @notice Internal function to atomically obtain a pseudorandom number
+     * from the configured pseudorandom contract.
+     * @param _coreContract - The core contract that is requesting an atomic
+     * pseudorandom number.
+     * @param _tokenId - The token ID on `_coreContract` that is associated
+     * with the pseudorandom number request.
+     */
+    function _getPseudorandomAtomic(
+        address _coreContract,
+        uint256 _tokenId
+    ) internal view returns (bytes32) {
+        return
+            pseudorandomAtomicContract.getPseudorandomAtomic(
+                keccak256(abi.encodePacked(_coreContract, _tokenId))
+            );
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@artblocks/contracts",
-  "version": "1.0.1",
+  "version": "1.0.3",
   "description": "Smart contracts used by Art Blocks",
   "files": [
     "/contracts/**/*.sol",
@@ -9,74 +9,77 @@
   "scripts": {
     "clean": "hardhat clean",
     "compile": "hardhat compile",
-    "gh-action-compile": "hardhat --config gh-action.config.ts compile",
+    "build": "hardhat --config build-package.config.ts compile",
     "docgen": "hardhat docgen",
     "generate:typechain": "typechain --target ethers-v5 --outDir ./scripts/contracts './artifacts/contracts/**/!(*.dbg)*.json'",
     "test": "hardhat test",
+    "size": "hardhat size-contracts",
     "test:parallel": "hardhat test --parallel",
     "coverage": "hardhat coverage",
     "format": "prettier --write 'contracts/**/*.sol' && prettier --write 'scripts/**/*.ts' && prettier --write 'test/**/*.ts'",
     "lint": "prettier --check 'contracts/**/*.sol' && prettier --check 'scripts/**/*.ts' && prettier --check 'test/**/*.ts' && npx eslint 'test/**/*.ts'",
     "remix": "remixd -s ./ --remix-ide https://remix.ethereum.org",
-    "deploy:goerli:v3-engine": "yarn hardhat run --network goerli scripts/engine/V3/generic-engine-deployer.ts",
-    "deploy:mainnet:v3-engine": "yarn hardhat run --network mainnet scripts/engine/V3/generic-engine-deployer.ts",
-    "deploy:goerli:minter": "yarn hardhat run --network goerli scripts/minter-deployments/generic-minter-deployer-v3core.ts",
-    "deploy:mainnet:minter": "yarn hardhat run --network mainnet scripts/minter-deployments/generic-minter-deployer-v3core.ts"
-  },
-  "husky": {
-    "hooks": {
-      "pre-commit": "yarn lint",
-      "pre-push": "yarn test"
-    }
+    "codegen": "yarn --cwd=\"../..\" codegen:project contracts",
+    "deploy:dev:v3-engine": "yarn codegen && NODE_ENV=dev yarn hardhat run --network goerli scripts/engine/V3/generic-engine-deployer.ts",
+    "deploy:dev-arbitrum:v3-engine": "yarn codegen && NODE_ENV=arbitrum-dev yarn hardhat run --network arbitrum-goerli scripts/engine/V3/generic-engine-deployer.ts",
+    "deploy:staging-arbitrum:v3-engine": "yarn codegen && NODE_ENV=arbitrum-staging yarn hardhat run --network arbitrum-goerli scripts/engine/V3/generic-engine-deployer.ts",
+    "deploy:staging:v3-engine": "yarn codegen && NODE_ENV=staging yarn hardhat run --network goerli scripts/engine/V3/generic-engine-deployer.ts",
+    "deploy:mainnet:v3-engine": "yarn codegen && NODE_ENV=mainnet yarn hardhat run --network mainnet scripts/engine/V3/generic-engine-deployer.ts",
+    "deploy:goerli:minter": "yarn hardhat run --network goerli scripts/minter-deployments/V3/generic-minter-deployer-v3core.ts",
+    "deploy:mainnet:minter": "yarn hardhat run --network mainnet scripts/minter-deployments/V3/generic-minter-deployer-v3core.ts",
+    "pre-commit": "yarn lint"
   },
   "devDependencies": {
-    "@aws-sdk/client-s3": "^3.245.0",
-    "@aws-sdk/credential-providers": "^3.245.0",
+    "@aws-sdk/client-s3": "^3.338.0",
+    "@aws-sdk/credential-providers": "^3.338.0",
     "@defi-wonderland/smock": "^2.3.4",
     "@gnosis.pm/safe-contracts": "^1.3.0",
     "@gnosis.pm/safe-core-sdk": "^2.1.0",
     "@gnosis.pm/safe-core-sdk-types": "^1.7.0",
     "@gnosis.pm/safe-ethers-lib": "1.1.0",
     "@gnosis.pm/safe-service-client": "^1.4.0",
+    "@nomicfoundation/hardhat-network-helpers": "^1.0.8",
     "@nomiclabs/hardhat-ethers": "^2.2.1",
     "@nomiclabs/hardhat-etherscan": "^3.1.4",
-    "@nomiclabs/hardhat-solhint": "^2.0.0",
+    "@nomiclabs/hardhat-solhint": "^3.0.0",
     "@nomiclabs/hardhat-truffle5": "^2.0.7",
     "@nomiclabs/hardhat-waffle": "^2.0.3",
     "@nomiclabs/hardhat-web3": "^2.0.0",
-    "@openzeppelin/hardhat-upgrades": "^1.22.0",
+    "@openzeppelin/hardhat-upgrades": "^1.26.0",
     "@openzeppelin/test-helpers": "^0.5.16",
-    "@remix-project/remixd": "^0.5.6",
+    "@remix-project/remixd": "^0.6.14",
     "@typechain/ethers-v5": "^6.0.5",
-    "@types/jest": "^27.0.3",
-    "@types/mocha": "^9.1.1",
+    "@types/jest": "^29.4.0",
+    "@types/mocha": "^10.0.1",
     "@types/prompt": "^1.1.5",
-    "@typescript-eslint/eslint-plugin": "^5.48.0",
-    "@typescript-eslint/parser": "^5.48.0",
-    "aws-sdk-client-mock": "^0.6.2",
+    "@typescript-eslint/eslint-plugin": "^5.59.7",
+    "@typescript-eslint/parser": "^5.59.7",
+    "aws-sdk-client-mock": "^2.1.1",
     "chai": "^4.3.7",
     "coveralls": "^3.1.1",
-    "dotenv": "^8.2.0",
-    "eslint": "^8.31.0",
+    "dotenv": "^16.0.3",
+    "eslint": "^8.41.0",
     "eslint-plugin-mocha": "^10.1.0",
-    "ethereum-waffle": "^3.4.4",
+    "eslint-config-custom": "*",
+    "ethereum-waffle": "^4.0.10",
     "ethers": "^5.7.2",
     "hardhat": "^2.12.5",
-    "hardhat-contract-sizer": "^2.6.1",
+    "hardhat-contract-sizer": "^2.9.0",
     "hardhat-docgen": "^1.3.0",
     "hardhat-gas-reporter": "^1.0.9",
-    "husky": "^7.0.4",
+    "husky": "^8.0.3",
     "istanbul-combine": "^0.3.0",
     "keccak256": "^1.0.6",
-    "merkletreejs": "^0.2.31",
+    "merkletreejs": "^0.3.9",
     "prettier": "^2.8.1",
     "prettier-plugin-solidity": "^1.1.1",
     "prompt": "^1.3.0",
     "prompt-sync": "^4.2.0",
     "solidity-coverage": "^0.8.0",
     "ts-node": "^9.1.1",
+    "tsconfig": "*",
     "typechain": "^4.0.3",
-    "typescript": "^4.9.4"
+    "typescript": "^5.0.2"
   },
   "author": "Art Blocks, Inc",
   "license": "LGPL-3.0-only",
@@ -84,6 +87,9 @@
     "@openzeppelin-0.5/contracts": "npm:@openzeppelin/contracts@2.5.1",
     "@openzeppelin-4.5/contracts": "npm:@openzeppelin/contracts@4.5.0",
     "@openzeppelin-4.7/contracts": "npm:@openzeppelin/contracts@4.7.1",
-    "@openzeppelin-4.8/contracts-upgradeable": "npm:@openzeppelin/contracts-upgradeable@4.8.0"
+    "@openzeppelin-4.8/contracts-upgradeable": "npm:@openzeppelin/contracts-upgradeable@4.8.0",
+    "@urql/exchange-retry": "^1.0.0",
+    "graphql": "^16.6.0",
+    "urql": "^4.0.0"
   }
 }

package/.env.example

@@ -1,10 +0,0 @@
-MAINNET_JSON_RPC_PROVIDER_URL=
-GOERLI_JSON_RPC_PROVIDER_URL=
-PALM_MAINNET_JSON_RPC_PROVIDER_URL=
-PALM_TESTNET_JSON_RPC_PROVIDER_URL=
-MAINNET_PRIVATE_KEY=
-TESTNET_PRIVATE_KEY=
-ETHERSCAN_API_KEY=
-AWS_ACCESS_KEY_ID=
-AWS_SECRET_ACCESS_KEY=
-COINMARKETCAP_API_KEY=

package/artifacts/contracts/BasicPolyptychRandomizerV0.sol/BasicPolyptychRandomizerV0.json

@@ -1,229 +0,0 @@
-{
-  "_format": "hh-sol-artifact-1",
-  "contractName": "BasicPolyptychRandomizerV0",
-  "sourceName": "contracts/BasicPolyptychRandomizerV0.sol",
-  "abi": [
-    {
-      "anonymous": false,
-      "inputs": [
-        {
-          "indexed": true,
-          "internalType": "address",
-          "name": "_contractAddress",
-          "type": "address"
-        }
-      ],
-      "name": "HashSeedSetterUpdated",
-      "type": "event"
-    },
-    {
-      "anonymous": false,
-      "inputs": [
-        {
-          "indexed": true,
-          "internalType": "address",
-          "name": "previousOwner",
-          "type": "address"
-        },
-        {
-          "indexed": true,
-          "internalType": "address",
-          "name": "newOwner",
-          "type": "address"
-        }
-      ],
-      "name": "OwnershipTransferred",
-      "type": "event"
-    },
-    {
-      "anonymous": false,
-      "inputs": [
-        {
-          "indexed": false,
-          "internalType": "uint256",
-          "name": "_projectId",
-          "type": "uint256"
-        },
-        {
-          "indexed": false,
-          "internalType": "bool",
-          "name": "_isPolyptych",
-          "type": "bool"
-        }
-      ],
-      "name": "ProjectIsPolyptychUpdated",
-      "type": "event"
-    },
-    {
-      "inputs": [
-        {
-          "internalType": "address",
-          "name": "_genArt721Core",
-          "type": "address"
-        }
-      ],
-      "name": "assignCoreAndRenounce",
-      "outputs": [],
-      "stateMutability": "nonpayable",
-      "type": "function"
-    },
-    {
-      "inputs": [
-        {
-          "internalType": "uint256",
-          "name": "_tokenId",
-          "type": "uint256"
-        }
-      ],
-      "name": "assignTokenHash",
-      "outputs": [],
-      "stateMutability": "nonpayable",
-      "type": "function"
-    },
-    {
-      "inputs": [],
-      "name": "genArt721Core",
-      "outputs": [
-        {
-          "internalType": "contract IGenArt721CoreContractV3_Base",
-          "name": "",
-          "type": "address"
-        }
-      ],
-      "stateMutability": "view",
-      "type": "function"
-    },
-    {
-      "inputs": [],
-      "name": "hashSeedSetterContract",
-      "outputs": [
-        {
-          "internalType": "address",
-          "name": "",
-          "type": "address"
-        }
-      ],
-      "stateMutability": "view",
-      "type": "function"
-    },
-    {
-      "inputs": [],
-      "name": "owner",
-      "outputs": [
-        {
-          "internalType": "address",
-          "name": "",
-          "type": "address"
-        }
-      ],
-      "stateMutability": "view",
-      "type": "function"
-    },
-    {
-      "inputs": [
-        {
-          "internalType": "uint256",
-          "name": "",
-          "type": "uint256"
-        }
-      ],
-      "name": "polyptychHashSeeds",
-      "outputs": [
-        {
-          "internalType": "bytes12",
-          "name": "",
-          "type": "bytes12"
-        }
-      ],
-      "stateMutability": "view",
-      "type": "function"
-    },
-    {
-      "inputs": [
-        {
-          "internalType": "uint256",
-          "name": "",
-          "type": "uint256"
-        }
-      ],
-      "name": "projectIsPolyptych",
-      "outputs": [
-        {
-          "internalType": "bool",
-          "name": "",
-          "type": "bool"
-        }
-      ],
-      "stateMutability": "view",
-      "type": "function"
-    },
-    {
-      "inputs": [],
-      "name": "renounceOwnership",
-      "outputs": [],
-      "stateMutability": "nonpayable",
-      "type": "function"
-    },
-    {
-      "inputs": [
-        {
-          "internalType": "address",
-          "name": "_contractAddress",
-          "type": "address"
-        }
-      ],
-      "name": "setHashSeedSetterContract",
-      "outputs": [],
-      "stateMutability": "nonpayable",
-      "type": "function"
-    },
-    {
-      "inputs": [
-        {
-          "internalType": "uint256",
-          "name": "_tokenId",
-          "type": "uint256"
-        },
-        {
-          "internalType": "bytes12",
-          "name": "_hashSeed",
-          "type": "bytes12"
-        }
-      ],
-      "name": "setPolyptychHashSeed",
-      "outputs": [],
-      "stateMutability": "nonpayable",
-      "type": "function"
-    },
-    {
-      "inputs": [
-        {
-          "internalType": "uint256",
-          "name": "_projectId",
-          "type": "uint256"
-        }
-      ],
-      "name": "toggleProjectIsPolyptych",
-      "outputs": [],
-      "stateMutability": "nonpayable",
-      "type": "function"
-    },
-    {
-      "inputs": [
-        {
-          "internalType": "address",
-          "name": "newOwner",
-          "type": "address"
-        }
-      ],
-      "name": "transferOwnership",
-      "outputs": [],
-      "stateMutability": "nonpayable",
-      "type": "function"
-    }
-  ],
-  "bytecode": "0x608060405234801561001057600080fd5b5061001a3361001f565b61006f565b600080546001600160a01b038381166001600160a01b0319831681178455604051919092169283917f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e09190a35050565b6109b28061007e6000396000f3fe608060405234801561001057600080fd5b50600436106100a45760003560e01c806308aacdf1146100a95780633897bb42146100e1578063447aa1c51461011d57806359e4a2ad1461013257806366b92a0e14610145578063715018a6146101705780638da5cb5b14610178578063b628171a14610180578063e19133e214610193578063eaa76157146101a6578063eb037309146101b9578063f2fde38b146101cc575b600080fd5b6100cc6100b736600461082e565b60036020526000908152604090205460ff1681565b60405190151581526020015b60405180910390f35b6101046100ef36600461082e565b60026020526000908152604090205460a01b81565b6040516001600160a01b031990911681526020016100d8565b61013061012b36600461085c565b6101df565b005b610130610140366004610880565b6102fa565b600454610158906001600160a01b031681565b6040516001600160a01b0390911681526020016100d8565b61013061037b565b61015861038f565b61013061018e36600461082e565b61039e565b600154610158906001600160a01b031681565b6101306101b436600461085c565b6105b8565b6101306101c736600461082e565b6105ea565b6101306101da36600461085c565b610709565b60015460405163230448b160e01b815233600482015230602482015263447aa1c560e01b60448201819052916001600160a01b03169063230448b1906064016020604051808303816000875af115801561023d573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061026191906108bd565b6102af5760405162461bcd60e51b815260206004820152601a60248201527913db9b1e4810dbdc994810591b5a5b9050d308185b1b1bddd95960321b60448201526064015b60405180910390fd5b600480546001600160a01b0319166001600160a01b0384169081179091556040517f8efe01ac3eede6840252c9e2462d05448dc65a012877da2bcf1e32c06a161a3d90600090a25050565b6004546001600160a01b031633146103525760405162461bcd60e51b815260206004820152601b60248201527a13db9b1e481a185cda14d9595914d95d1d195c90dbdb9d1c9858dd602a1b60448201526064016102a6565b60009182526002602052604090912080546001600160601b03191660a09290921c919091179055565b61038361077f565b61038d60006107de565b565b6000546001600160a01b031690565b6001546001600160a01b031633146103ed5760405162461bcd60e51b815260206004820152601260248201527113db9b1e4818dbdc99481b585e4818d85b1b60721b60448201526064016102a6565b600360006103fe620f42408461090b565b815260208101919091526040016000205460ff16156104eb5760008181526002602052604081205460a01b906001600160a01b03198216900361047d5760405162461bcd60e51b815260206004820152601760248201527613db9b1e481b9bdb8b5e995c9bc81a185cda081cd95959604a1b60448201526064016102a6565b60015460405161078f60e21b8152600481018490526001600160a01b0319831660248201526001600160a01b0390911690611e3c90604401600060405180830381600087803b1580156104cf57600080fd5b505af11580156104e3573d6000803e3d6000fd5b505050505050565b42600082436104fb60018261091f565b408461050860c882610938565b61051390600161094c565b6040805160208101969096528501939093526060840191909152608083015260a082015260c00160408051808303601f1901815290829052805160209091012060015461078f60e21b835260048301869052602483018290529092506001600160a01b031690611e3c90604401600060405180830381600087803b15801561059a57600080fd5b505af11580156105ae573d6000803e3d6000fd5b5050505050505b50565b6105c061077f565b6105c861037b565b600180546001600160a01b0319166001600160a01b0392909216919091179055565b60015460405163a47d29cb60e01b81526004810183905282916001600160a01b03169063a47d29cb90602401602060405180830381865afa158015610633573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610657919061095f565b6001600160a01b0316336001600160a01b0316146106a55760405162461bcd60e51b815260206004820152600b60248201526a13db9b1e48105c9d1a5cdd60aa1b60448201526064016102a6565b600082815260036020908152604091829020805460ff8082161560ff199092168217909255835186815291161515918101919091527fede330a7b41e8a7cd3e273fa4093f4fb1ab8d9b0dd270a9931dc4e5035cf1d28910160405180910390a15050565b61071161077f565b6001600160a01b0381166107765760405162461bcd60e51b815260206004820152602660248201527f4f776e61626c653a206e6577206f776e657220697320746865207a65726f206160448201526564647265737360d01b60648201526084016102a6565b6105b5816107de565b3361078861038f565b6001600160a01b03161461038d5760405162461bcd60e51b815260206004820181905260248201527f4f776e61626c653a2063616c6c6572206973206e6f7420746865206f776e657260448201526064016102a6565b600080546001600160a01b038381166001600160a01b0319831681178455604051919092169283917f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e09190a35050565b60006020828403121561084057600080fd5b5035919050565b6001600160a01b03811681146105b557600080fd5b60006020828403121561086e57600080fd5b813561087981610847565b9392505050565b6000806040838503121561089357600080fd5b8235915060208301356001600160a01b0319811681146108b257600080fd5b809150509250929050565b6000602082840312156108cf57600080fd5b8151801515811461087957600080fd5b634e487b7160e01b600052601260045260246000fd5b634e487b7160e01b600052601160045260246000fd5b60008261091a5761091a6108df565b500490565b81810381811115610932576109326108f5565b92915050565b600082610947576109476108df565b500690565b80820180821115610932576109326108f5565b60006020828403121561097157600080fd5b81516108798161084756fea264697066735822122042f74c8c5443eff8cbaafb45aba4fd81f9f937f7c46c81ffba753cb327e99ce164736f6c63430008110033",
-  "deployedBytecode": "0x608060405234801561001057600080fd5b50600436106100a45760003560e01c806308aacdf1146100a95780633897bb42146100e1578063447aa1c51461011d57806359e4a2ad1461013257806366b92a0e14610145578063715018a6146101705780638da5cb5b14610178578063b628171a14610180578063e19133e214610193578063eaa76157146101a6578063eb037309146101b9578063f2fde38b146101cc575b600080fd5b6100cc6100b736600461082e565b60036020526000908152604090205460ff1681565b60405190151581526020015b60405180910390f35b6101046100ef36600461082e565b60026020526000908152604090205460a01b81565b6040516001600160a01b031990911681526020016100d8565b61013061012b36600461085c565b6101df565b005b610130610140366004610880565b6102fa565b600454610158906001600160a01b031681565b6040516001600160a01b0390911681526020016100d8565b61013061037b565b61015861038f565b61013061018e36600461082e565b61039e565b600154610158906001600160a01b031681565b6101306101b436600461085c565b6105b8565b6101306101c736600461082e565b6105ea565b6101306101da36600461085c565b610709565b60015460405163230448b160e01b815233600482015230602482015263447aa1c560e01b60448201819052916001600160a01b03169063230448b1906064016020604051808303816000875af115801561023d573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061026191906108bd565b6102af5760405162461bcd60e51b815260206004820152601a60248201527913db9b1e4810dbdc994810591b5a5b9050d308185b1b1bddd95960321b60448201526064015b60405180910390fd5b600480546001600160a01b0319166001600160a01b0384169081179091556040517f8efe01ac3eede6840252c9e2462d05448dc65a012877da2bcf1e32c06a161a3d90600090a25050565b6004546001600160a01b031633146103525760405162461bcd60e51b815260206004820152601b60248201527a13db9b1e481a185cda14d9595914d95d1d195c90dbdb9d1c9858dd602a1b60448201526064016102a6565b60009182526002602052604090912080546001600160601b03191660a09290921c919091179055565b61038361077f565b61038d60006107de565b565b6000546001600160a01b031690565b6001546001600160a01b031633146103ed5760405162461bcd60e51b815260206004820152601260248201527113db9b1e4818dbdc99481b585e4818d85b1b60721b60448201526064016102a6565b600360006103fe620f42408461090b565b815260208101919091526040016000205460ff16156104eb5760008181526002602052604081205460a01b906001600160a01b03198216900361047d5760405162461bcd60e51b815260206004820152601760248201527613db9b1e481b9bdb8b5e995c9bc81a185cda081cd95959604a1b60448201526064016102a6565b60015460405161078f60e21b8152600481018490526001600160a01b0319831660248201526001600160a01b0390911690611e3c90604401600060405180830381600087803b1580156104cf57600080fd5b505af11580156104e3573d6000803e3d6000fd5b505050505050565b42600082436104fb60018261091f565b408461050860c882610938565b61051390600161094c565b6040805160208101969096528501939093526060840191909152608083015260a082015260c00160408051808303601f1901815290829052805160209091012060015461078f60e21b835260048301869052602483018290529092506001600160a01b031690611e3c90604401600060405180830381600087803b15801561059a57600080fd5b505af11580156105ae573d6000803e3d6000fd5b5050505050505b50565b6105c061077f565b6105c861037b565b600180546001600160a01b0319166001600160a01b0392909216919091179055565b60015460405163a47d29cb60e01b81526004810183905282916001600160a01b03169063a47d29cb90602401602060405180830381865afa158015610633573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610657919061095f565b6001600160a01b0316336001600160a01b0316146106a55760405162461bcd60e51b815260206004820152600b60248201526a13db9b1e48105c9d1a5cdd60aa1b60448201526064016102a6565b600082815260036020908152604091829020805460ff8082161560ff199092168217909255835186815291161515918101919091527fede330a7b41e8a7cd3e273fa4093f4fb1ab8d9b0dd270a9931dc4e5035cf1d28910160405180910390a15050565b61071161077f565b6001600160a01b0381166107765760405162461bcd60e51b815260206004820152602660248201527f4f776e61626c653a206e6577206f776e657220697320746865207a65726f206160448201526564647265737360d01b60648201526084016102a6565b6105b5816107de565b3361078861038f565b6001600160a01b03161461038d5760405162461bcd60e51b815260206004820181905260248201527f4f776e61626c653a2063616c6c6572206973206e6f7420746865206f776e657260448201526064016102a6565b600080546001600160a01b038381166001600160a01b0319831681178455604051919092169283917f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e09190a35050565b60006020828403121561084057600080fd5b5035919050565b6001600160a01b03811681146105b557600080fd5b60006020828403121561086e57600080fd5b813561087981610847565b9392505050565b6000806040838503121561089357600080fd5b8235915060208301356001600160a01b0319811681146108b257600080fd5b809150509250929050565b6000602082840312156108cf57600080fd5b8151801515811461087957600080fd5b634e487b7160e01b600052601260045260246000fd5b634e487b7160e01b600052601160045260246000fd5b60008261091a5761091a6108df565b500490565b81810381811115610932576109326108f5565b92915050565b600082610947576109476108df565b500690565b80820180821115610932576109326108f5565b60006020828403121561097157600080fd5b81516108798161084756fea264697066735822122042f74c8c5443eff8cbaafb45aba4fd81f9f937f7c46c81ffba753cb327e99ce164736f6c63430008110033",
-  "linkReferences": {},
-  "deployedLinkReferences": {}
-}