@ensuro/core 2.0.0-beta1 → 2.0.0-beta10

package/README.md

@@ -1,3 +1,9 @@
+[![Tests](https://github.com/ensuro/ensuro/actions/workflows/tests.yaml/badge.svg)](https://github.com/ensuro/ensuro/actions/workflows/tests.yaml)
+[![cov](https://github.com/ensuro/ensuro/raw/main/badges/coverage.svg)](https://github.com/ensuro/ensuro/actions/workflows/tests.yaml)
+[![Build and Push Docker Image to Google Artifact Registry](https://github.com/ensuro/ensuro/actions/workflows/build-base-image.yaml/badge.svg)](https://github.com/ensuro/ensuro/actions/workflows/build-base-image.yaml)
+[![release](https://badgen.net/github/release/ensuro/ensuro)](https://github.com/ensuro/ensuro/releases)
+[![NPM Package](https://github.com/ensuro/ensuro/actions/workflows/npm.yaml/badge.svg)](https://www.npmjs.com/package/@ensuro/core)
+
 # Ensuro - Decentralized capital for insurance
 
 Ensuro is a decentralized protocol that manages the capital to support insurance products.
@@ -17,47 +23,50 @@ Each policy sold and active it's a _risk_ or potential loss, a random variable t
 
 <dl>
 <dt>PolicyPool</dt>
-<dd>This is the main contract that keeps track of active policies and manages the assets. It has the methods for LP to deposit/withdraw. The PolicyPool is connected to a set of eTokens and RiskModules.</dd>
-</dl>
-
-<dl>
-<dt>PolicyNFT</dt>
-<dd>This contract follows ERC721 standard to control the ownership of the policies (each policy is an NFT). Policies are minted by PolicyPool.</dd>
+<dd>
+PolicyPool is the protocol's main contract. It keeps track of active policies and receives spending allowances. It has methods for LP to deposit/withdraw, acting as a gateway. The PolicyPool is connected to a set of eTokens, Premiums Accounts, and RiskModules.
+This contract also follows the ERC721 standard, minting an NFT for each policy created. The owner of the NFT is who will receive the payout in case there's any.
+</dd>
 </dl>
 
 <dl>
-<dt>PolicyPoolConfig</dt>
-<dd>This contract holds some configurable components of the protocol such as treasury address and the installed risk modules. Also this module holds the access control permissions for the governance actions.</dd>
+<dt>AccessManager</dt>
+<dd>This contract the access control permissions for the governance actions.</dd>
 </dl>
 
 <dl>
 <dt>EToken</dt>
-<dd>This is a ERC20 compatible contract that represents the capital of each liquidity provider in a given pool. The valuation is one-to-one with the underlyng stablecoin. The view scr() returns the amount of capital that's locked backing up policies. For this capital locked, the pool receives an interest (scrInterestRate() / tokenInterestRate()) that is continously accrued in the balance of eToken holders.</dd>
+<dd>EToken is an ERC20-compatible contract that counts the capital of each liquidity provider in a given pool. The valuation is one-to-one with the underlying stablecoin. The view `scr()` returns the amount of capital that's locked backing up policies. For this capital locked, the pool receives an interest (see `scrInterestRate()` and `tokenInterestRate()`) that is continuously accrued in the balance of eToken holders.</dd>
 </dl>
 
 <dl>
 <dt>RiskModule</dt>
-<dd>This is a base contract that needs to be reimplemented with the specific logic related with custom policy parameters, validation of the received price and with different strategies for policy resolution (e.g. using oracles). This is the contract that must be called by a customer for creating a new policy that, after doing validations and storing parameters needed for resolution, will submit the new policy to the PolicyPool.</dd>
+<dd>This base contract allows risk partners and customers to interact with the protocol. It needs to be reimplemented for each different product, each time defining the proper policy parameters, price validation, and policy resolution strategy (e.g., using oracles). RiskModule must be called to create a new policy; after validating the price and storing parameters needed for resolution, RiskModule submits the policy to PolicyPool.</dd>
 </dl>
 
 <dl>
 <dt>PremiumsAccount</dt>
-<dd>The risk modules are grouped in *premiums accounts* that keep track of the pure premiums (active and earned) their policies. The responsability of these contracts is keeping track of the premiums and releasing the payouts. When premiums are exhausted (losses more than expected), they borrow money from the *eTokens* to cover the payouts. This money will be repaid when/if later the premiums account has surplus (losses less than expected).</dd>
+<dd>The risk modules are grouped in premiums accounts that keep track of their policies' pure premiums (active and earned). The responsibility of these contracts is to keep track of the premiums and release the payouts. When premiums are exhausted (losses more than expected), they borrow money from the eTokens to cover the payouts. This money will be repaid when/if later the premiums account has a surplus (losses less than expected).</dd>
+</dl>
+
+<dl>
+<dt>AssetManager</dt>
+<dd>Both _eTokens_ and _PremiumsAccounts_ are _reserves_ because they hold assets. It's possible to assign to each reserve an AssetManager. The AssetManager is a contract that operates in the reserve's context (through delegatecalls) and manages the assets by applying some strategy to invest in other DeFi protocols to generate additional returns.</dd>
 </dl>
 
 <dl>
 <dt>LPWhitelist</dt>
-<dd>This is an optional component. If present it controls which Liquidity Providers can deposit or transfer their <i>eTokens</i>.</dd>
+<dd>This is an optional component. If present it controls which Liquidity Providers can deposit or transfer their <i>eTokens</i>. Each eToken may be or not connected to a whitelist.</dd>
 </dl>
 
 <dl>
 <dt>Policy</dt>
-<dd>This is a library with the struct and the calculation of relevant attributes of a policy. It includes the logic around the distribution of the premium, calculation of SCR, shared coverage and other behaviour of the protocol.</dd>
+<dd>Policy is a library with the struct and the calculation of relevant attributes of a policy. It includes the logic around the premium distribution, SCR calculation, shared coverage, and other protocol behaviors.</dd>
 </dl>
 
 ## Governance
 
-The protocol uses three levels of access control, plus a guardian role. The roles are managed by the PolicyPoolConfig smart contract.
+The protocol uses three levels of access control, plus a guardian role. These roles can be assigned at protocol level or specifically for a component. The roles are managed by the AccessManager smart contract.
 
 More info about governance in https://docs.google.com/spreadsheets/d/1LqlogRn8AlnLq1rPTd5UT7CJI3uc31PdBaxj4pX3mtE/edit?usp=sharing
 

package/build/contracts/AccessManager.sol/AccessManager.json

@@ -0,0 +1,559 @@
+{
+  "_format": "hh-sol-artifact-1",
+  "contractName": "AccessManager",
+  "sourceName": "contracts/AccessManager.sol",
+  "abi": [
+    {
+      "anonymous": false,
+      "inputs": [
+        {
+          "indexed": false,
+          "internalType": "address",
+          "name": "previousAdmin",
+          "type": "address"
+        },
+        {
+          "indexed": false,
+          "internalType": "address",
+          "name": "newAdmin",
+          "type": "address"
+        }
+      ],
+      "name": "AdminChanged",
+      "type": "event"
+    },
+    {
+      "anonymous": false,
+      "inputs": [
+        {
+          "indexed": true,
+          "internalType": "address",
+          "name": "beacon",
+          "type": "address"
+        }
+      ],
+      "name": "BeaconUpgraded",
+      "type": "event"
+    },
+    {
+      "anonymous": false,
+      "inputs": [
+        {
+          "indexed": false,
+          "internalType": "uint8",
+          "name": "version",
+          "type": "uint8"
+        }
+      ],
+      "name": "Initialized",
+      "type": "event"
+    },
+    {
+      "anonymous": false,
+      "inputs": [
+        {
+          "indexed": true,
+          "internalType": "bytes32",
+          "name": "role",
+          "type": "bytes32"
+        },
+        {
+          "indexed": true,
+          "internalType": "bytes32",
+          "name": "previousAdminRole",
+          "type": "bytes32"
+        },
+        {
+          "indexed": true,
+          "internalType": "bytes32",
+          "name": "newAdminRole",
+          "type": "bytes32"
+        }
+      ],
+      "name": "RoleAdminChanged",
+      "type": "event"
+    },
+    {
+      "anonymous": false,
+      "inputs": [
+        {
+          "indexed": true,
+          "internalType": "bytes32",
+          "name": "role",
+          "type": "bytes32"
+        },
+        {
+          "indexed": true,
+          "internalType": "address",
+          "name": "account",
+          "type": "address"
+        },
+        {
+          "indexed": true,
+          "internalType": "address",
+          "name": "sender",
+          "type": "address"
+        }
+      ],
+      "name": "RoleGranted",
+      "type": "event"
+    },
+    {
+      "anonymous": false,
+      "inputs": [
+        {
+          "indexed": true,
+          "internalType": "bytes32",
+          "name": "role",
+          "type": "bytes32"
+        },
+        {
+          "indexed": true,
+          "internalType": "address",
+          "name": "account",
+          "type": "address"
+        },
+        {
+          "indexed": true,
+          "internalType": "address",
+          "name": "sender",
+          "type": "address"
+        }
+      ],
+      "name": "RoleRevoked",
+      "type": "event"
+    },
+    {
+      "anonymous": false,
+      "inputs": [
+        {
+          "indexed": true,
+          "internalType": "address",
+          "name": "implementation",
+          "type": "address"
+        }
+      ],
+      "name": "Upgraded",
+      "type": "event"
+    },
+    {
+      "inputs": [],
+      "name": "DEFAULT_ADMIN_ROLE",
+      "outputs": [
+        {
+          "internalType": "bytes32",
+          "name": "",
+          "type": "bytes32"
+        }
+      ],
+      "stateMutability": "view",
+      "type": "function"
+    },
+    {
+      "inputs": [],
+      "name": "GUARDIAN_ROLE",
+      "outputs": [
+        {
+          "internalType": "bytes32",
+          "name": "",
+          "type": "bytes32"
+        }
+      ],
+      "stateMutability": "view",
+      "type": "function"
+    },
+    {
+      "inputs": [],
+      "name": "LEVEL1_ROLE",
+      "outputs": [
+        {
+          "internalType": "bytes32",
+          "name": "",
+          "type": "bytes32"
+        }
+      ],
+      "stateMutability": "view",
+      "type": "function"
+    },
+    {
+      "inputs": [],
+      "name": "LEVEL2_ROLE",
+      "outputs": [
+        {
+          "internalType": "bytes32",
+          "name": "",
+          "type": "bytes32"
+        }
+      ],
+      "stateMutability": "view",
+      "type": "function"
+    },
+    {
+      "inputs": [],
+      "name": "LEVEL3_ROLE",
+      "outputs": [
+        {
+          "internalType": "bytes32",
+          "name": "",
+          "type": "bytes32"
+        }
+      ],
+      "stateMutability": "view",
+      "type": "function"
+    },
+    {
+      "inputs": [
+        {
+          "internalType": "address",
+          "name": "component",
+          "type": "address"
+        },
+        {
+          "internalType": "bytes32",
+          "name": "role",
+          "type": "bytes32"
+        },
+        {
+          "internalType": "address",
+          "name": "account",
+          "type": "address"
+        },
+        {
+          "internalType": "bool",
+          "name": "alsoGlobal",
+          "type": "bool"
+        }
+      ],
+      "name": "checkComponentRole",
+      "outputs": [],
+      "stateMutability": "view",
+      "type": "function"
+    },
+    {
+      "inputs": [
+        {
+          "internalType": "address",
+          "name": "component",
+          "type": "address"
+        },
+        {
+          "internalType": "bytes32",
+          "name": "role1",
+          "type": "bytes32"
+        },
+        {
+          "internalType": "bytes32",
+          "name": "role2",
+          "type": "bytes32"
+        },
+        {
+          "internalType": "address",
+          "name": "account",
+          "type": "address"
+        },
+        {
+          "internalType": "bool",
+          "name": "alsoGlobal",
+          "type": "bool"
+        }
+      ],
+      "name": "checkComponentRole2",
+      "outputs": [],
+      "stateMutability": "view",
+      "type": "function"
+    },
+    {
+      "inputs": [
+        {
+          "internalType": "bytes32",
+          "name": "role",
+          "type": "bytes32"
+        },
+        {
+          "internalType": "address",
+          "name": "account",
+          "type": "address"
+        }
+      ],
+      "name": "checkRole",
+      "outputs": [],
+      "stateMutability": "view",
+      "type": "function"
+    },
+    {
+      "inputs": [
+        {
+          "internalType": "bytes32",
+          "name": "role1",
+          "type": "bytes32"
+        },
+        {
+          "internalType": "bytes32",
+          "name": "role2",
+          "type": "bytes32"
+        },
+        {
+          "internalType": "address",
+          "name": "account",
+          "type": "address"
+        }
+      ],
+      "name": "checkRole2",
+      "outputs": [],
+      "stateMutability": "view",
+      "type": "function"
+    },
+    {
+      "inputs": [
+        {
+          "internalType": "address",
+          "name": "component",
+          "type": "address"
+        },
+        {
+          "internalType": "bytes32",
+          "name": "role",
+          "type": "bytes32"
+        }
+      ],
+      "name": "getComponentRole",
+      "outputs": [
+        {
+          "internalType": "bytes32",
+          "name": "",
+          "type": "bytes32"
+        }
+      ],
+      "stateMutability": "pure",
+      "type": "function"
+    },
+    {
+      "inputs": [
+        {
+          "internalType": "bytes32",
+          "name": "role",
+          "type": "bytes32"
+        }
+      ],
+      "name": "getRoleAdmin",
+      "outputs": [
+        {
+          "internalType": "bytes32",
+          "name": "",
+          "type": "bytes32"
+        }
+      ],
+      "stateMutability": "view",
+      "type": "function"
+    },
+    {
+      "inputs": [
+        {
+          "internalType": "address",
+          "name": "component",
+          "type": "address"
+        },
+        {
+          "internalType": "bytes32",
+          "name": "role",
+          "type": "bytes32"
+        },
+        {
+          "internalType": "address",
+          "name": "account",
+          "type": "address"
+        }
+      ],
+      "name": "grantComponentRole",
+      "outputs": [],
+      "stateMutability": "nonpayable",
+      "type": "function"
+    },
+    {
+      "inputs": [
+        {
+          "internalType": "bytes32",
+          "name": "role",
+          "type": "bytes32"
+        },
+        {
+          "internalType": "address",
+          "name": "account",
+          "type": "address"
+        }
+      ],
+      "name": "grantRole",
+      "outputs": [],
+      "stateMutability": "nonpayable",
+      "type": "function"
+    },
+    {
+      "inputs": [
+        {
+          "internalType": "address",
+          "name": "component",
+          "type": "address"
+        },
+        {
+          "internalType": "bytes32",
+          "name": "role",
+          "type": "bytes32"
+        },
+        {
+          "internalType": "address",
+          "name": "account",
+          "type": "address"
+        },
+        {
+          "internalType": "bool",
+          "name": "alsoGlobal",
+          "type": "bool"
+        }
+      ],
+      "name": "hasComponentRole",
+      "outputs": [
+        {
+          "internalType": "bool",
+          "name": "",
+          "type": "bool"
+        }
+      ],
+      "stateMutability": "view",
+      "type": "function"
+    },
+    {
+      "inputs": [
+        {
+          "internalType": "bytes32",
+          "name": "role",
+          "type": "bytes32"
+        },
+        {
+          "internalType": "address",
+          "name": "account",
+          "type": "address"
+        }
+      ],
+      "name": "hasRole",
+      "outputs": [
+        {
+          "internalType": "bool",
+          "name": "",
+          "type": "bool"
+        }
+      ],
+      "stateMutability": "view",
+      "type": "function"
+    },
+    {
+      "inputs": [],
+      "name": "initialize",
+      "outputs": [],
+      "stateMutability": "nonpayable",
+      "type": "function"
+    },
+    {
+      "inputs": [],
+      "name": "proxiableUUID",
+      "outputs": [
+        {
+          "internalType": "bytes32",
+          "name": "",
+          "type": "bytes32"
+        }
+      ],
+      "stateMutability": "view",
+      "type": "function"
+    },
+    {
+      "inputs": [
+        {
+          "internalType": "bytes32",
+          "name": "role",
+          "type": "bytes32"
+        },
+        {
+          "internalType": "address",
+          "name": "account",
+          "type": "address"
+        }
+      ],
+      "name": "renounceRole",
+      "outputs": [],
+      "stateMutability": "nonpayable",
+      "type": "function"
+    },
+    {
+      "inputs": [
+        {
+          "internalType": "bytes32",
+          "name": "role",
+          "type": "bytes32"
+        },
+        {
+          "internalType": "address",
+          "name": "account",
+          "type": "address"
+        }
+      ],
+      "name": "revokeRole",
+      "outputs": [],
+      "stateMutability": "nonpayable",
+      "type": "function"
+    },
+    {
+      "inputs": [
+        {
+          "internalType": "bytes4",
+          "name": "interfaceId",
+          "type": "bytes4"
+        }
+      ],
+      "name": "supportsInterface",
+      "outputs": [
+        {
+          "internalType": "bool",
+          "name": "",
+          "type": "bool"
+        }
+      ],
+      "stateMutability": "view",
+      "type": "function"
+    },
+    {
+      "inputs": [
+        {
+          "internalType": "address",
+          "name": "newImplementation",
+          "type": "address"
+        }
+      ],
+      "name": "upgradeTo",
+      "outputs": [],
+      "stateMutability": "nonpayable",
+      "type": "function"
+    },
+    {
+      "inputs": [
+        {
+          "internalType": "address",
+          "name": "newImplementation",
+          "type": "address"
+        },
+        {
+          "internalType": "bytes",
+          "name": "data",
+          "type": "bytes"
+        }
+      ],
+      "name": "upgradeToAndCall",
+      "outputs": [],
+      "stateMutability": "payable",
+      "type": "function"
+    }
+  ],
+  "bytecode": "0x60a06040523060805234801561001457600080fd5b5060805161175a61004c600039600081816105a6015281816105e60152818161069e015281816106de015261076d015261175a6000f3fe6080604052600436106101355760003560e01c806352d1902d116100ab578063a217fddf1161006f578063a217fddf14610388578063b3efcbd21461039d578063c5b8f5cf146103bd578063d547741f146103dd578063f67b2bad146103fd578063f6a421fc1461043157600080fd5b806352d1902d146102ea5780635b494dd5146102ff5780635ff57d20146103335780638129fc1c1461035357806391d148541461036857600080fd5b80632f2ff15d116100fd5780632f2ff15d1461022357806336568abe146102435780633659cfe614610263578063374c96c8146102835780634a47a3e0146102a35780634f1ef286146102d757600080fd5b806301ffc9a71461013a57806312d9a6ad1461016f578063248a9ca31461019157806324ea54f4146101cf5780632b1cff1f14610203575b600080fd5b34801561014657600080fd5b5061015a6101553660046111bd565b610451565b60405190151581526020015b60405180910390f35b34801561017b57600080fd5b5061018f61018a366004611203565b610488565b005b34801561019d57600080fd5b506101c16101ac36600461122f565b60009081526065602052604090206001015490565b604051908152602001610166565b3480156101db57600080fd5b506101c17f55435dd261a4b9b3364963f7738a7a662ad9c84396d64be3365284bb7f0a504181565b34801561020f57600080fd5b5061018f61021e366004611258565b610496565b34801561022f57600080fd5b5061018f61023e366004611203565b6104f3565b34801561024f57600080fd5b5061018f61025e366004611203565b61051d565b34801561026f57600080fd5b5061018f61027e3660046112af565b61059c565b34801561028f57600080fd5b506101c161029e3660046112ca565b61067b565b3480156102af57600080fd5b506101c17fa82e22387fca439f316d78ca566f383218ab8ae1b3e830178c9c82cbd16749c081565b61018f6102e536600461130a565b610694565b3480156102f657600080fd5b506101c1610760565b34801561030b57600080fd5b506101c17f5ec196419322369c6bac572d883f4d990ae5ec82f7d93cdf89b85dbb05b63c2781565b34801561033f57600080fd5b5061018f61034e3660046113cc565b610813565b34801561035f57600080fd5b5061018f61083f565b34801561037457600080fd5b5061015a610383366004611203565b610918565b34801561039457600080fd5b506101c1600081565b3480156103a957600080fd5b5061015a6103b83660046113cc565b610943565b3480156103c957600080fd5b5061018f6103d8366004611419565b610979565b3480156103e957600080fd5b5061018f6103f8366004611203565b610991565b34801561040957600080fd5b506101c17fbf372ca3ebecfe59ac256f17697941bbe63302aced610e8b0e3646f743c7beb281565b34801561043d57600080fd5b5061018f61044c36600461144e565b6109b6565b60006001600160e01b03198216637965db0b60e01b148061048257506301ffc9a760e01b6001600160e01b03198316145b92915050565b61049282826109df565b5050565b8080156104a857506104a88483610918565b6104ec576104bf6104b9868661067b565b83610918565b6104ec578080156104d557506104d58383610918565b6104ec576104ec6104e6868561067b565b836109df565b5050505050565b60008281526065602052604090206001015461050e81610a43565b6105188383610a4d565b505050565b6001600160a01b03811633146105925760405162461bcd60e51b815260206004820152602f60248201527f416363657373436f6e74726f6c3a2063616e206f6e6c792072656e6f756e636560448201526e103937b632b9903337b91039b2b63360891b60648201526084015b60405180910390fd5b6104928282610ad3565b6001600160a01b037f00000000000000000000000000000000000000000000000000000000000000001630036105e45760405162461bcd60e51b815260040161058990611481565b7f00000000000000000000000000000000000000000000000000000000000000006001600160a01b031661062d6000805160206116de833981519152546001600160a01b031690565b6001600160a01b0316146106535760405162461bcd60e51b8152600401610589906114cd565b61065c81610b3a565b6040805160008082526020820190925261067891839190610b94565b50565b60609190911b6bffffffffffffffffffffffff19161890565b6001600160a01b037f00000000000000000000000000000000000000000000000000000000000000001630036106dc5760405162461bcd60e51b815260040161058990611481565b7f00000000000000000000000000000000000000000000000000000000000000006001600160a01b03166107256000805160206116de833981519152546001600160a01b031690565b6001600160a01b03161461074b5760405162461bcd60e51b8152600401610589906114cd565b61075482610b3a565b61049282826001610b94565b6000306001600160a01b037f000000000000000000000000000000000000000000000000000000000000000016146108005760405162461bcd60e51b815260206004820152603860248201527f555550535570677261646561626c653a206d757374206e6f742062652063616c60448201527f6c6564207468726f7567682064656c656761746563616c6c00000000000000006064820152608401610589565b506000805160206116de83398151915290565b80158061082757506108258383610918565b155b15610839576108396104e6858561067b565b50505050565b600054610100900460ff161580801561085f5750600054600160ff909116105b806108795750303b158015610879575060005460ff166001145b6108955760405162461bcd60e51b815260040161058990611519565b6000805460ff1916600117905580156108b8576000805461ff0019166101001790555b6108c0610cff565b6108c8610cff565b6108d0610d6c565b8015610678576000805461ff0019169055604051600181527f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb38474024989060200160405180910390a150565b60009182526065602090815260408084206001600160a01b0393909316845291905290205460ff1690565b600081801561095757506109578484610918565b80610970575061097061096a868661067b565b84610918565b95945050505050565b6109838382610918565b6105185761051882826109df565b6000828152606560205260409020600101546109ac81610a43565b6105188383610ad3565b6109c36101ac848461067b565b6109cc81610a43565b6108396109d9858561067b565b83610a4d565b6109e98282610918565b61049257610a01816001600160a01b03166014610df0565b610a0c836020610df0565b604051602001610a1d92919061158b565b60408051601f198184030181529082905262461bcd60e51b825261058991600401611600565b61067881336109df565b610a578282610918565b6104925760008281526065602090815260408083206001600160a01b03851684529091529020805460ff19166001179055610a8f3390565b6001600160a01b0316816001600160a01b0316837f2f8788117e7eff1d82e926ec794901d17c78024a50270940304540a733656f0d60405160405180910390a45050565b610add8282610918565b156104925760008281526065602090815260408083206001600160a01b0385168085529252808320805460ff1916905551339285917ff6391f5c32d9c69d2a47ea670b442974b53935d1edc7fd64eb21e047a839171b9190a45050565b7f55435dd261a4b9b3364963f7738a7a662ad9c84396d64be3365284bb7f0a50417fbf372ca3ebecfe59ac256f17697941bbe63302aced610e8b0e3646f743c7beb2610b868233610918565b6105185761051881336109df565b7f4910fdfa16fed3260ed0e7147f7cc6da11a60208b5b9406d12a635614ffd91435460ff1615610bc75761051883610f93565b826001600160a01b03166352d1902d6040518163ffffffff1660e01b8152600401602060405180830381865afa925050508015610c21575060408051601f3d908101601f19168201909252610c1e91810190611633565b60015b610c845760405162461bcd60e51b815260206004820152602e60248201527f45524331393637557067726164653a206e657720696d706c656d656e7461746960448201526d6f6e206973206e6f74205555505360901b6064820152608401610589565b6000805160206116de8339815191528114610cf35760405162461bcd60e51b815260206004820152602960248201527f45524331393637557067726164653a20756e737570706f727465642070726f786044820152681a58589b195555525160ba1b6064820152608401610589565b5061051883838361102f565b600054610100900460ff16610d6a5760405162461bcd60e51b815260206004820152602b60248201527f496e697469616c697a61626c653a20636f6e7472616374206973206e6f74206960448201526a6e697469616c697a696e6760a81b6064820152608401610589565b565b600054610100900460ff1615808015610d8c5750600054600160ff909116105b80610da65750303b158015610da6575060005460ff166001145b610dc25760405162461bcd60e51b815260040161058990611519565b6000805460ff191660011790558015610de5576000805461ff0019166101001790555b6108d0600033611054565b60606000610dff836002611662565b610e0a906002611681565b67ffffffffffffffff811115610e2257610e226112f4565b6040519080825280601f01601f191660200182016040528015610e4c576020820181803683370190505b509050600360fc1b81600081518110610e6757610e67611694565b60200101906001600160f81b031916908160001a905350600f60fb1b81600181518110610e9657610e96611694565b60200101906001600160f81b031916908160001a9053506000610eba846002611662565b610ec5906001611681565b90505b6001811115610f3d576f181899199a1a9b1b9c1cb0b131b232b360811b85600f1660108110610ef957610ef9611694565b1a60f81b828281518110610f0f57610f0f611694565b60200101906001600160f81b031916908160001a90535060049490941c93610f36816116aa565b9050610ec8565b508315610f8c5760405162461bcd60e51b815260206004820181905260248201527f537472696e67733a20686578206c656e67746820696e73756666696369656e746044820152606401610589565b9392505050565b6001600160a01b0381163b6110005760405162461bcd60e51b815260206004820152602d60248201527f455243313936373a206e657720696d706c656d656e746174696f6e206973206e60448201526c1bdd08184818dbdb9d1c9858dd609a1b6064820152608401610589565b6000805160206116de83398151915280546001600160a01b0319166001600160a01b0392909216919091179055565b6110388361105e565b6000825111806110455750805b1561051857610839838361109e565b6104928282610a4d565b61106781610f93565b6040516001600160a01b038216907fbc7cd75a20ee27fd9adebab32041f755214dbc6bffa90cc0225b39da2e5c2d3b90600090a250565b60606001600160a01b0383163b6111065760405162461bcd60e51b815260206004820152602660248201527f416464726573733a2064656c65676174652063616c6c20746f206e6f6e2d636f6044820152651b9d1c9858dd60d21b6064820152608401610589565b600080846001600160a01b03168460405161112191906116c1565b600060405180830381855af49150503d806000811461115c576040519150601f19603f3d011682016040523d82523d6000602084013e611161565b606091505b509150915061097082826040518060600160405280602781526020016116fe6027913960608315611193575081610f8c565b8251156111a35782518084602001fd5b8160405162461bcd60e51b81526004016105899190611600565b6000602082840312156111cf57600080fd5b81356001600160e01b031981168114610f8c57600080fd5b80356001600160a01b03811681146111fe57600080fd5b919050565b6000806040838503121561121657600080fd5b82359150611226602084016111e7565b90509250929050565b60006020828403121561124157600080fd5b5035919050565b803580151581146111fe57600080fd5b600080600080600060a0868803121561127057600080fd5b611279866111e7565b94506020860135935060408601359250611295606087016111e7565b91506112a360808701611248565b90509295509295909350565b6000602082840312156112c157600080fd5b610f8c826111e7565b600080604083850312156112dd57600080fd5b6112e6836111e7565b946020939093013593505050565b634e487b7160e01b600052604160045260246000fd5b6000806040838503121561131d57600080fd5b611326836111e7565b9150602083013567ffffffffffffffff8082111561134357600080fd5b818501915085601f83011261135757600080fd5b813581811115611369576113696112f4565b604051601f8201601f19908116603f01168101908382118183101715611391576113916112f4565b816040528281528860208487010111156113aa57600080fd5b8260208601602083013760006020848301015280955050505050509250929050565b600080600080608085870312156113e257600080fd5b6113eb856111e7565b935060208501359250611400604086016111e7565b915061140e60608601611248565b905092959194509250565b60008060006060848603121561142e57600080fd5b8335925060208401359150611445604085016111e7565b90509250925092565b60008060006060848603121561146357600080fd5b61146c846111e7565b925060208401359150611445604085016111e7565b6020808252602c908201527f46756e6374696f6e206d7573742062652063616c6c6564207468726f7567682060408201526b19195b1959d85d1958d85b1b60a21b606082015260800190565b6020808252602c908201527f46756e6374696f6e206d7573742062652063616c6c6564207468726f7567682060408201526b6163746976652070726f787960a01b606082015260800190565b6020808252602e908201527f496e697469616c697a61626c653a20636f6e747261637420697320616c72656160408201526d191e481a5b9a5d1a585b1a5e995960921b606082015260800190565b60005b8381101561158257818101518382015260200161156a565b50506000910152565b7f416363657373436f6e74726f6c3a206163636f756e74200000000000000000008152600083516115c3816017850160208801611567565b7001034b99036b4b9b9b4b733903937b6329607d1b60179184019182015283516115f4816028840160208801611567565b01602801949350505050565b602081526000825180602084015261161f816040850160208701611567565b601f01601f19169190910160400192915050565b60006020828403121561164557600080fd5b5051919050565b634e487b7160e01b600052601160045260246000fd5b600081600019048311821515161561167c5761167c61164c565b500290565b808201808211156104825761048261164c565b634e487b7160e01b600052603260045260246000fd5b6000816116b9576116b961164c565b506000190190565b600082516116d3818460208701611567565b919091019291505056fe360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc416464726573733a206c6f772d6c6576656c2064656c65676174652063616c6c206661696c6564a2646970667358221220ee0d8053bb608ae88edc70ba069ed8bc5a916e28dcebd34fc917a4e788822ccf64736f6c63430008100033",
+  "deployedBytecode": "0x6080604052600436106101355760003560e01c806352d1902d116100ab578063a217fddf1161006f578063a217fddf14610388578063b3efcbd21461039d578063c5b8f5cf146103bd578063d547741f146103dd578063f67b2bad146103fd578063f6a421fc1461043157600080fd5b806352d1902d146102ea5780635b494dd5146102ff5780635ff57d20146103335780638129fc1c1461035357806391d148541461036857600080fd5b80632f2ff15d116100fd5780632f2ff15d1461022357806336568abe146102435780633659cfe614610263578063374c96c8146102835780634a47a3e0146102a35780634f1ef286146102d757600080fd5b806301ffc9a71461013a57806312d9a6ad1461016f578063248a9ca31461019157806324ea54f4146101cf5780632b1cff1f14610203575b600080fd5b34801561014657600080fd5b5061015a6101553660046111bd565b610451565b60405190151581526020015b60405180910390f35b34801561017b57600080fd5b5061018f61018a366004611203565b610488565b005b34801561019d57600080fd5b506101c16101ac36600461122f565b60009081526065602052604090206001015490565b604051908152602001610166565b3480156101db57600080fd5b506101c17f55435dd261a4b9b3364963f7738a7a662ad9c84396d64be3365284bb7f0a504181565b34801561020f57600080fd5b5061018f61021e366004611258565b610496565b34801561022f57600080fd5b5061018f61023e366004611203565b6104f3565b34801561024f57600080fd5b5061018f61025e366004611203565b61051d565b34801561026f57600080fd5b5061018f61027e3660046112af565b61059c565b34801561028f57600080fd5b506101c161029e3660046112ca565b61067b565b3480156102af57600080fd5b506101c17fa82e22387fca439f316d78ca566f383218ab8ae1b3e830178c9c82cbd16749c081565b61018f6102e536600461130a565b610694565b3480156102f657600080fd5b506101c1610760565b34801561030b57600080fd5b506101c17f5ec196419322369c6bac572d883f4d990ae5ec82f7d93cdf89b85dbb05b63c2781565b34801561033f57600080fd5b5061018f61034e3660046113cc565b610813565b34801561035f57600080fd5b5061018f61083f565b34801561037457600080fd5b5061015a610383366004611203565b610918565b34801561039457600080fd5b506101c1600081565b3480156103a957600080fd5b5061015a6103b83660046113cc565b610943565b3480156103c957600080fd5b5061018f6103d8366004611419565b610979565b3480156103e957600080fd5b5061018f6103f8366004611203565b610991565b34801561040957600080fd5b506101c17fbf372ca3ebecfe59ac256f17697941bbe63302aced610e8b0e3646f743c7beb281565b34801561043d57600080fd5b5061018f61044c36600461144e565b6109b6565b60006001600160e01b03198216637965db0b60e01b148061048257506301ffc9a760e01b6001600160e01b03198316145b92915050565b61049282826109df565b5050565b8080156104a857506104a88483610918565b6104ec576104bf6104b9868661067b565b83610918565b6104ec578080156104d557506104d58383610918565b6104ec576104ec6104e6868561067b565b836109df565b5050505050565b60008281526065602052604090206001015461050e81610a43565b6105188383610a4d565b505050565b6001600160a01b03811633146105925760405162461bcd60e51b815260206004820152602f60248201527f416363657373436f6e74726f6c3a2063616e206f6e6c792072656e6f756e636560448201526e103937b632b9903337b91039b2b63360891b60648201526084015b60405180910390fd5b6104928282610ad3565b6001600160a01b037f00000000000000000000000000000000000000000000000000000000000000001630036105e45760405162461bcd60e51b815260040161058990611481565b7f00000000000000000000000000000000000000000000000000000000000000006001600160a01b031661062d6000805160206116de833981519152546001600160a01b031690565b6001600160a01b0316146106535760405162461bcd60e51b8152600401610589906114cd565b61065c81610b3a565b6040805160008082526020820190925261067891839190610b94565b50565b60609190911b6bffffffffffffffffffffffff19161890565b6001600160a01b037f00000000000000000000000000000000000000000000000000000000000000001630036106dc5760405162461bcd60e51b815260040161058990611481565b7f00000000000000000000000000000000000000000000000000000000000000006001600160a01b03166107256000805160206116de833981519152546001600160a01b031690565b6001600160a01b03161461074b5760405162461bcd60e51b8152600401610589906114cd565b61075482610b3a565b61049282826001610b94565b6000306001600160a01b037f000000000000000000000000000000000000000000000000000000000000000016146108005760405162461bcd60e51b815260206004820152603860248201527f555550535570677261646561626c653a206d757374206e6f742062652063616c60448201527f6c6564207468726f7567682064656c656761746563616c6c00000000000000006064820152608401610589565b506000805160206116de83398151915290565b80158061082757506108258383610918565b155b15610839576108396104e6858561067b565b50505050565b600054610100900460ff161580801561085f5750600054600160ff909116105b806108795750303b158015610879575060005460ff166001145b6108955760405162461bcd60e51b815260040161058990611519565b6000805460ff1916600117905580156108b8576000805461ff0019166101001790555b6108c0610cff565b6108c8610cff565b6108d0610d6c565b8015610678576000805461ff0019169055604051600181527f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb38474024989060200160405180910390a150565b60009182526065602090815260408084206001600160a01b0393909316845291905290205460ff1690565b600081801561095757506109578484610918565b80610970575061097061096a868661067b565b84610918565b95945050505050565b6109838382610918565b6105185761051882826109df565b6000828152606560205260409020600101546109ac81610a43565b6105188383610ad3565b6109c36101ac848461067b565b6109cc81610a43565b6108396109d9858561067b565b83610a4d565b6109e98282610918565b61049257610a01816001600160a01b03166014610df0565b610a0c836020610df0565b604051602001610a1d92919061158b565b60408051601f198184030181529082905262461bcd60e51b825261058991600401611600565b61067881336109df565b610a578282610918565b6104925760008281526065602090815260408083206001600160a01b03851684529091529020805460ff19166001179055610a8f3390565b6001600160a01b0316816001600160a01b0316837f2f8788117e7eff1d82e926ec794901d17c78024a50270940304540a733656f0d60405160405180910390a45050565b610add8282610918565b156104925760008281526065602090815260408083206001600160a01b0385168085529252808320805460ff1916905551339285917ff6391f5c32d9c69d2a47ea670b442974b53935d1edc7fd64eb21e047a839171b9190a45050565b7f55435dd261a4b9b3364963f7738a7a662ad9c84396d64be3365284bb7f0a50417fbf372ca3ebecfe59ac256f17697941bbe63302aced610e8b0e3646f743c7beb2610b868233610918565b6105185761051881336109df565b7f4910fdfa16fed3260ed0e7147f7cc6da11a60208b5b9406d12a635614ffd91435460ff1615610bc75761051883610f93565b826001600160a01b03166352d1902d6040518163ffffffff1660e01b8152600401602060405180830381865afa925050508015610c21575060408051601f3d908101601f19168201909252610c1e91810190611633565b60015b610c845760405162461bcd60e51b815260206004820152602e60248201527f45524331393637557067726164653a206e657720696d706c656d656e7461746960448201526d6f6e206973206e6f74205555505360901b6064820152608401610589565b6000805160206116de8339815191528114610cf35760405162461bcd60e51b815260206004820152602960248201527f45524331393637557067726164653a20756e737570706f727465642070726f786044820152681a58589b195555525160ba1b6064820152608401610589565b5061051883838361102f565b600054610100900460ff16610d6a5760405162461bcd60e51b815260206004820152602b60248201527f496e697469616c697a61626c653a20636f6e7472616374206973206e6f74206960448201526a6e697469616c697a696e6760a81b6064820152608401610589565b565b600054610100900460ff1615808015610d8c5750600054600160ff909116105b80610da65750303b158015610da6575060005460ff166001145b610dc25760405162461bcd60e51b815260040161058990611519565b6000805460ff191660011790558015610de5576000805461ff0019166101001790555b6108d0600033611054565b60606000610dff836002611662565b610e0a906002611681565b67ffffffffffffffff811115610e2257610e226112f4565b6040519080825280601f01601f191660200182016040528015610e4c576020820181803683370190505b509050600360fc1b81600081518110610e6757610e67611694565b60200101906001600160f81b031916908160001a905350600f60fb1b81600181518110610e9657610e96611694565b60200101906001600160f81b031916908160001a9053506000610eba846002611662565b610ec5906001611681565b90505b6001811115610f3d576f181899199a1a9b1b9c1cb0b131b232b360811b85600f1660108110610ef957610ef9611694565b1a60f81b828281518110610f0f57610f0f611694565b60200101906001600160f81b031916908160001a90535060049490941c93610f36816116aa565b9050610ec8565b508315610f8c5760405162461bcd60e51b815260206004820181905260248201527f537472696e67733a20686578206c656e67746820696e73756666696369656e746044820152606401610589565b9392505050565b6001600160a01b0381163b6110005760405162461bcd60e51b815260206004820152602d60248201527f455243313936373a206e657720696d706c656d656e746174696f6e206973206e60448201526c1bdd08184818dbdb9d1c9858dd609a1b6064820152608401610589565b6000805160206116de83398151915280546001600160a01b0319166001600160a01b0392909216919091179055565b6110388361105e565b6000825111806110455750805b1561051857610839838361109e565b6104928282610a4d565b61106781610f93565b6040516001600160a01b038216907fbc7cd75a20ee27fd9adebab32041f755214dbc6bffa90cc0225b39da2e5c2d3b90600090a250565b60606001600160a01b0383163b6111065760405162461bcd60e51b815260206004820152602660248201527f416464726573733a2064656c65676174652063616c6c20746f206e6f6e2d636f6044820152651b9d1c9858dd60d21b6064820152608401610589565b600080846001600160a01b03168460405161112191906116c1565b600060405180830381855af49150503d806000811461115c576040519150601f19603f3d011682016040523d82523d6000602084013e611161565b606091505b509150915061097082826040518060600160405280602781526020016116fe6027913960608315611193575081610f8c565b8251156111a35782518084602001fd5b8160405162461bcd60e51b81526004016105899190611600565b6000602082840312156111cf57600080fd5b81356001600160e01b031981168114610f8c57600080fd5b80356001600160a01b03811681146111fe57600080fd5b919050565b6000806040838503121561121657600080fd5b82359150611226602084016111e7565b90509250929050565b60006020828403121561124157600080fd5b5035919050565b803580151581146111fe57600080fd5b600080600080600060a0868803121561127057600080fd5b611279866111e7565b94506020860135935060408601359250611295606087016111e7565b91506112a360808701611248565b90509295509295909350565b6000602082840312156112c157600080fd5b610f8c826111e7565b600080604083850312156112dd57600080fd5b6112e6836111e7565b946020939093013593505050565b634e487b7160e01b600052604160045260246000fd5b6000806040838503121561131d57600080fd5b611326836111e7565b9150602083013567ffffffffffffffff8082111561134357600080fd5b818501915085601f83011261135757600080fd5b813581811115611369576113696112f4565b604051601f8201601f19908116603f01168101908382118183101715611391576113916112f4565b816040528281528860208487010111156113aa57600080fd5b8260208601602083013760006020848301015280955050505050509250929050565b600080600080608085870312156113e257600080fd5b6113eb856111e7565b935060208501359250611400604086016111e7565b915061140e60608601611248565b905092959194509250565b60008060006060848603121561142e57600080fd5b8335925060208401359150611445604085016111e7565b90509250925092565b60008060006060848603121561146357600080fd5b61146c846111e7565b925060208401359150611445604085016111e7565b6020808252602c908201527f46756e6374696f6e206d7573742062652063616c6c6564207468726f7567682060408201526b19195b1959d85d1958d85b1b60a21b606082015260800190565b6020808252602c908201527f46756e6374696f6e206d7573742062652063616c6c6564207468726f7567682060408201526b6163746976652070726f787960a01b606082015260800190565b6020808252602e908201527f496e697469616c697a61626c653a20636f6e747261637420697320616c72656160408201526d191e481a5b9a5d1a585b1a5e995960921b606082015260800190565b60005b8381101561158257818101518382015260200161156a565b50506000910152565b7f416363657373436f6e74726f6c3a206163636f756e74200000000000000000008152600083516115c3816017850160208801611567565b7001034b99036b4b9b9b4b733903937b6329607d1b60179184019182015283516115f4816028840160208801611567565b01602801949350505050565b602081526000825180602084015261161f816040850160208701611567565b601f01601f19169190910160400192915050565b60006020828403121561164557600080fd5b5051919050565b634e487b7160e01b600052601160045260246000fd5b600081600019048311821515161561167c5761167c61164c565b500290565b808201808211156104825761048261164c565b634e487b7160e01b600052603260045260246000fd5b6000816116b9576116b961164c565b506000190190565b600082516116d3818460208701611567565b919091019291505056fe360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc416464726573733a206c6f772d6c6576656c2064656c65676174652063616c6c206661696c6564a2646970667358221220ee0d8053bb608ae88edc70ba069ed8bc5a916e28dcebd34fc917a4e788822ccf64736f6c63430008100033",
+  "linkReferences": {},
+  "deployedLinkReferences": {}
+}