/*
Copyright 2019-2021 StarkWare Industries Ltd.
Licensed under the Apache License, Version 2.0 (the "License").
You may not use this file except in compliance with the License.
You may obtain a copy of the License at
https://www.starkware.co/open-source-license/
Unless required by applicable law or agreed to in writing,
software distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions
and limitations under the License.
*/
// SPDX-License-Identifier: Apache-2.0.
pragma solidity ^0.6.11;
/*
Common Utility librarries.
I. Addresses (extending address).
*/
library Addresses {
function isContract(address account) internal view returns (bool) {
uint256 size;
assembly {
size := extcodesize(account)
}
return size > 0;
}
function performEthTransfer(address recipient, uint256 amount) internal {
(bool success, ) = recipient.call{value: amount}(""); // NOLINT: low-level-calls.
require(success, "ETH_TRANSFER_FAILED");
}
/*
Safe wrapper around ERC20/ERC721 calls.
This is required because many deployed ERC20 contracts don't return a value.
See https://github.com/ethereum/solidity/issues/4116.
*/
function safeTokenContractCall(address tokenAddress, bytes memory callData) internal {
require(isContract(tokenAddress), "BAD_TOKEN_ADDRESS");
// NOLINTNEXTLINE: low-level-calls.
(bool success, bytes memory returndata) = tokenAddress.call(callData);
require(success, string(returndata));
if (returndata.length > 0) {
require(abi.decode(returndata, (bool)), "TOKEN_OPERATION_FAILED");
}
}
/*
Validates that the passed contract address is of a real contract,
and that its id hash (as infered fromn identify()) matched the expected one.
*/
function validateContractId(address contractAddress, bytes32 expectedIdHash)
internal
{
require(isContract(contractAddress), "ADDRESS_NOT_CONTRACT");
(bool success, bytes memory returndata) = contractAddress.call( // NOLINT: low-level-calls.
abi.encodeWithSignature("identify()"));
require(success, "FAILED_TO_IDENTIFY_CONTRACT");
string memory realContractId = abi.decode(returndata, (string));
require(
keccak256(abi.encodePacked(realContractId)) == expectedIdHash,
"UNEXPECTED_CONTRACT_IDENTIFIER");
}
/*
Similar to safeTokenContractCall, but always ignores the return value.
Assumes some other method is used to detect the failures
(e.g. balance is checked before and after the call).
*/
function uncheckedTokenContractCall(address tokenAddress, bytes memory callData) internal {
// NOLINTNEXTLINE: low-level-calls.
(bool success, bytes memory returndata) = tokenAddress.call(callData);
require(success, string(returndata));
}
}
library UintArray {
function hashSubArray(uint256[] memory array, uint256 subArrayStart, uint256 subArraySize)
internal pure
returns(bytes32 subArrayHash)
{
require(array.length >= subArrayStart + subArraySize, "ILLEGAL_SUBARRAY_DIMENSIONS");
uint256 startOffsetBytes = 0x20 * (1 + subArrayStart);
uint256 dataSizeBytes = 0x20 * subArraySize;
assembly {
subArrayHash := keccak256(add(array, startOffsetBytes), dataSizeBytes)
}
}
/*
Returns the address of a cell in offset within a uint256[] array.
This allows assigning new variable of dynamic unit256[] pointing to a sub_array
with a layout of serialied uint256[] (i.e. length+content).
*/
function extractSerializedUintArray(uint256[] memory programOutput, uint256 offset)
internal pure
returns (uint256[] memory addr)
{
uint256 memOffset = 0x20 * (offset + 1);
assembly {
addr := add(programOutput, memOffset)
}
}
}
/*
II. StarkExTypes - Common data types.
*/
library StarkExTypes {
// Structure representing a list of verifiers (validity/availability).
// A statement is valid only if all the verifiers in the list agree on it.
// Adding a verifier to the list is immediate - this is used for fast resolution of
// any soundness issues.
// Removing from the list is time-locked, to ensure that any user of the system
// not content with the announced removal has ample time to leave the system before it is
// removed.
struct ApprovalChainData {
address[] list;
// Represents the time after which the verifier with the given address can be removed.
// Removal of the verifier with address A is allowed only in the case the value
// of unlockedForRemovalTime[A] != 0 and unlockedForRemovalTime[A] < (current time).
mapping (address => uint256) unlockedForRemovalTime;
}
}
/*
Copyright 2019-2021 StarkWare Industries Ltd.
Licensed under the Apache License, Version 2.0 (the "License").
You may not use this file except in compliance with the License.
You may obtain a copy of the License at
https://www.starkware.co/open-source-license/
Unless required by applicable law or agreed to in writing,
software distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions
and limitations under the License.
*/
// SPDX-License-Identifier: Apache-2.0.
pragma solidity ^0.6.11;
import "GovernanceStorage.sol";
import "MGovernance.sol";
/*
Implements Generic Governance, applicable for both proxy and main contract, and possibly others.
Notes:
1. This class is virtual (getGovernanceTag is not implemented).
2. The use of the same function names by both the Proxy and a delegated implementation
is not possible since calling the implementation functions is done via the default function
of the Proxy. For this reason, for example, the implementation of MainContract (MainGovernance)
exposes mainIsGovernor, which calls the internal isGovernor method.
*/
abstract contract Governance is GovernanceStorage, MGovernance {
event LogNominatedGovernor(address nominatedGovernor);
event LogNewGovernorAccepted(address acceptedGovernor);
event LogRemovedGovernor(address removedGovernor);
event LogNominationCancelled();
/*
Returns a string which uniquely identifies the type of the governance mechanism.
*/
function getGovernanceTag()
virtual
internal
pure
returns (string memory);
/*
Returns the GovernanceInfoStruct associated with the governance tag.
*/
function contractGovernanceInfo()
internal
view
returns (GovernanceInfoStruct storage) {
string memory tag = getGovernanceTag();
GovernanceInfoStruct storage gub = governanceInfo[tag];
require(gub.initialized, "NOT_INITIALIZED");
return gub;
}
/*
Current code intentionally prevents governance re-initialization.
This may be a problem in an upgrade situation, in a case that the upgrade-to implementation
performs an initialization (for real) and within that calls initGovernance().
Possible workarounds:
1. Clearing the governance info altogether by changing the MAIN_GOVERNANCE_INFO_TAG.
This will remove existing main governance information.
2. Modify the require part in this function, so that it will exit quietly
when trying to re-initialize (uncomment the lines below).
*/
function initGovernance()
internal
{
string memory tag = getGovernanceTag();
GovernanceInfoStruct storage gub = governanceInfo[tag];
// TODO(Remo,01/09/2021): Consider un-commenting lines below.
// if (gub.initialized) {
// return;
// }
require(!gub.initialized, "ALREADY_INITIALIZED");
gub.initialized = true; // to ensure addGovernor() won't fail.
// Add the initial governer.
addGovernor(msg.sender);
}
function isGovernor(address testGovernor)
internal view override
returns (bool){
GovernanceInfoStruct storage gub = contractGovernanceInfo();
return gub.effectiveGovernors[testGovernor];
}
/*
Cancels the nomination of a governor candidate.
*/
function cancelNomination() internal onlyGovernance() {
GovernanceInfoStruct storage gub = contractGovernanceInfo();
gub.candidateGovernor = address(0x0);
emit LogNominationCancelled();
}
function nominateNewGovernor(address newGovernor) internal onlyGovernance() {
GovernanceInfoStruct storage gub = contractGovernanceInfo();
require(!isGovernor(newGovernor), "ALREADY_GOVERNOR");
gub.candidateGovernor = newGovernor;
emit LogNominatedGovernor(newGovernor);
}
/*
The addGovernor is called in two cases:
1. by acceptGovernance when a new governor accepts its role.
2. by initGovernance to add the initial governor.
The difference is that the init path skips the nominate step
that would fail because of the onlyGovernance modifier.
*/
function addGovernor(address newGovernor) private {
require(!isGovernor(newGovernor), "ALREADY_GOVERNOR");
GovernanceInfoStruct storage gub = contractGovernanceInfo();
gub.effectiveGovernors[newGovernor] = true;
}
function acceptGovernance()
internal
{
// The new governor was proposed as a candidate by the current governor.
GovernanceInfoStruct storage gub = contractGovernanceInfo();
require(msg.sender == gub.candidateGovernor, "ONLY_CANDIDATE_GOVERNOR");
// Update state.
addGovernor(gub.candidateGovernor);
gub.candidateGovernor = address(0x0);
// Send a notification about the change of governor.
emit LogNewGovernorAccepted(msg.sender);
}
/*
Remove a governor from office.
*/
function removeGovernor(address governorForRemoval) internal onlyGovernance() {
require(msg.sender != governorForRemoval, "GOVERNOR_SELF_REMOVE");
GovernanceInfoStruct storage gub = contractGovernanceInfo();
require (isGovernor(governorForRemoval), "NOT_GOVERNOR");
gub.effectiveGovernors[governorForRemoval] = false;
emit LogRemovedGovernor(governorForRemoval);
}
}
/*
Copyright 2019-2021 StarkWare Industries Ltd.
Licensed under the Apache License, Version 2.0 (the "License").
You may not use this file except in compliance with the License.
You may obtain a copy of the License at
https://www.starkware.co/open-source-license/
Unless required by applicable law or agreed to in writing,
software distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions
and limitations under the License.
*/
// SPDX-License-Identifier: Apache-2.0.
pragma solidity ^0.6.11;
/*
Holds the governance slots for ALL entities, including proxy and the main contract.
*/
contract GovernanceStorage {
struct GovernanceInfoStruct {
mapping (address => bool) effectiveGovernors;
address candidateGovernor;
bool initialized;
}
// A map from a Governor tag to its own GovernanceInfoStruct.
mapping (string => GovernanceInfoStruct) internal governanceInfo;
}
/*
Copyright 2019-2021 StarkWare Industries Ltd.
Licensed under the Apache License, Version 2.0 (the "License").
You may not use this file except in compliance with the License.
You may obtain a copy of the License at
https://www.starkware.co/open-source-license/
Unless required by applicable law or agreed to in writing,
software distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions
and limitations under the License.
*/
// SPDX-License-Identifier: Apache-2.0.
pragma solidity ^0.6.11;
abstract contract MGovernance {
function isGovernor(address testGovernor)
internal
view
virtual
returns (bool);
/*
Allows calling the function only by a Governor.
*/
modifier onlyGovernance ()
{
require(isGovernor(msg.sender), "ONLY_GOVERNANCE");
_;
}
}
/*
Copyright 2019-2021 StarkWare Industries Ltd.
Licensed under the Apache License, Version 2.0 (the "License").
You may not use this file except in compliance with the License.
You may obtain a copy of the License at
https://www.starkware.co/open-source-license/
Unless required by applicable law or agreed to in writing,
software distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions
and limitations under the License.
*/
// SPDX-License-Identifier: Apache-2.0.
pragma solidity ^0.6.11;
import "ProxyGovernance.sol";
import "ProxyStorage.sol";
import "StorageSlots.sol";
import "Common.sol";
/**
The Proxy contract implements delegation of calls to other contracts (`implementations`), with
proper forwarding of return values and revert reasons. This pattern allows retaining the contract
storage while replacing implementation code.
The following operations are supported by the proxy contract:
- :sol:func:`addImplementation`: Defines a new implementation, the data with which it should be initialized and whether this will be the last version of implementation.
- :sol:func:`upgradeTo`: Once an implementation is added, the governor may upgrade to that implementation only after a safety time period has passed (time lock), the current implementation is not the last version and the implementation is not frozen (see :sol:mod:`FullWithdrawals`).
- :sol:func:`removeImplementation`: Any announced implementation may be removed. Removing an implementation is especially important once it has been used for an upgrade in order to avoid an additional unwanted revert to an older version.
The only entity allowed to perform the above operations is the proxy governor
(see :sol:mod:`ProxyGovernance`).
Every implementation is required to have an `initialize` function that replaces the constructor
of a normal contract. Furthermore, the only parameter of this function is an array of bytes
(`data`) which may be decoded arbitrarily by the `initialize` function. It is up to the
implementation to ensure that this function cannot be run more than once if so desired.
When an implementation is added (:sol:func:`addImplementation`) the initialization `data` is also
announced, allowing users of the contract to analyze the full effect of an upgrade to the new
implementation. During an :sol:func:`upgradeTo`, the `data` is provided again and only if it is
identical to the announced `data` is the upgrade performed by pointing the proxy to the new
implementation and calling its `initialize` function with this `data`.
It is the responsibility of the implementation not to overwrite any storage belonging to the
proxy (`ProxyStorage`). In addition, upon upgrade, the new implementation is assumed to be
backward compatible with previous implementations with respect to the storage used until that
point.
*/
contract Proxy is ProxyStorage, ProxyGovernance, StorageSlots {
// Emitted when the active implementation is replaced.
event ImplementationUpgraded(address indexed implementation, bytes initializer);
// Emitted when an implementation is submitted as an upgrade candidate and a time lock
// is activated.
event ImplementationAdded(address indexed implementation, bytes initializer, bool finalize);
// Emitted when an implementation is removed from the list of upgrade candidates.
event ImplementationRemoved(address indexed implementation, bytes initializer, bool finalize);
// Emitted when the implementation is finalized.
event FinalizedImplementation(address indexed implementation);
using Addresses for address;
string public constant PROXY_VERSION = "3.0.0";
constructor (uint256 upgradeActivationDelay)
public
{
initGovernance();
setUpgradeActivationDelay(upgradeActivationDelay);
}
function setUpgradeActivationDelay(uint256 delayInSeconds) private {
bytes32 slot = UPGRADE_DELAY_SLOT;
assembly {
sstore(slot, delayInSeconds)
}
}
function getUpgradeActivationDelay() public view returns (uint256 delay) {
bytes32 slot = UPGRADE_DELAY_SLOT;
assembly {
delay := sload(slot)
}
return delay;
}
/*
Returns the address of the current implementation.
*/
// NOLINTNEXTLINE external-function.
function implementation() public view returns(address _implementation) {
bytes32 slot = IMPLEMENTATION_SLOT;
assembly {
_implementation := sload(slot)
}
}
/*
Returns true if the implementation is frozen.
If the implementation was not assigned yet, returns false.
*/
function implementationIsFrozen() private returns (bool) {
address _implementation = implementation();
// We can't call low level implementation before it's assigned. (i.e. ZERO).
if (_implementation == address(0x0)) {
return false;
}
// NOLINTNEXTLINE: low-level-calls.
(bool success, bytes memory returndata) = _implementation.delegatecall(
abi.encodeWithSignature("isFrozen()"));
require(success, string(returndata));
return abi.decode(returndata, (bool));
}
/*
This method blocks delegation to initialize().
Only upgradeTo should be able to delegate call to initialize().
*/
function initialize(bytes calldata /*data*/)
external pure
{
revert("CANNOT_CALL_INITIALIZE");
}
modifier notFinalized()
{
require(isNotFinalized(), "IMPLEMENTATION_FINALIZED");
_;
}
/*
Forbids calling the function if the implementation is frozen.
This modifier relies on the lower level (logical contract) implementation of isFrozen().
*/
modifier notFrozen()
{
require(!implementationIsFrozen(), "STATE_IS_FROZEN");
_;
}
/*
This entry point serves only transactions with empty calldata. (i.e. pure value transfer tx).
We don't expect to receive such, thus block them.
*/
receive() external payable {
revert("CONTRACT_NOT_EXPECTED_TO_RECEIVE");
}
/*
Contract's default function. Delegates execution to the implementation contract.
It returns back to the external caller whatever the implementation delegated code returns.
*/
fallback() external payable {
address _implementation = implementation();
require (_implementation != address(0x0), "MISSING_IMPLEMENTATION");
assembly {
// Copy msg.data. We take full control of memory in this inline assembly
// block because it will not return to Solidity code. We overwrite the
// Solidity scratch pad at memory position 0.
calldatacopy(0, 0, calldatasize())
// Call the implementation.
// out and outsize are 0 for now, as we don't know the out size yet.
let result := delegatecall(gas(), _implementation, 0, calldatasize(), 0, 0)
// Copy the returned data.
returndatacopy(0, 0, returndatasize())
// TODO(Remo): Find a way to properly propagae inner OOG error.
switch result
// delegatecall returns 0 on error.
case 0 { revert(0, returndatasize()) }
default { return(0, returndatasize()) }
}
}
/*
Sets the implementation address of the proxy.
*/
function setImplementation(address newImplementation) private {
bytes32 slot = IMPLEMENTATION_SLOT;
assembly {
sstore(slot, newImplementation)
}
}
/*
Returns true if the contract is not in the finalized state.
*/
function isNotFinalized() public view returns (bool notFinal) {
bytes32 slot = FINALIZED_STATE_SLOT;
uint256 slotValue;
assembly {
slotValue := sload(slot)
}
notFinal = (slotValue == 0);
}
/*
Marks the current implementation as finalized.
*/
function setFinalizedFlag() private {
bytes32 slot = FINALIZED_STATE_SLOT;
assembly {
sstore(slot, 0x1)
}
}
/*
Introduce an implementation and its initialization vector,
and start the time-lock before it can be upgraded to.
addImplementation is not blocked when frozen or finalized.
(upgradeTo API is blocked when finalized or frozen).
*/
function addImplementation(address newImplementation, bytes calldata data, bool finalize)
external onlyGovernance {
require(newImplementation.isContract(), "ADDRESS_NOT_CONTRACT");
bytes32 implVectorHash = keccak256(abi.encode(newImplementation, data, finalize));
uint256 activationTime = block.timestamp + getUpgradeActivationDelay();
// First implementation should not have time-lock.
if (implementation() == address(0x0)) {
activationTime = block.timestamp;
}
enabledTime[implVectorHash] = activationTime;
emit ImplementationAdded(newImplementation, data, finalize);
}
/*
Removes a candidate implementation.
Note that it is possible to remove the current implementation. Doing so doesn't affect the
current implementation, but rather revokes it as a future candidate.
*/
function removeImplementation(address removedImplementation, bytes calldata data, bool finalize)
external onlyGovernance {
bytes32 implVectorHash = keccak256(abi.encode(removedImplementation, data, finalize));
// If we have initializer, we set the hash of it.
uint256 activationTime = enabledTime[implVectorHash];
require(activationTime > 0, "UNKNOWN_UPGRADE_INFORMATION");
delete enabledTime[implVectorHash];
emit ImplementationRemoved(removedImplementation, data, finalize);
}
/*
Upgrades the proxy to a new implementation, with its initialization.
to upgrade successfully, implementation must have been added time-lock agreeably
before, and the init vector must be identical ot the one submitted before.
Upon assignment of new implementation address,
its initialize will be called with the initializing vector (even if empty).
Therefore, the implementation MUST must have such a method.
Note - Initialization data is committed to in advance, therefore it must remain valid
until the actual contract upgrade takes place.
Care should be taken regarding initialization data and flow when planning the contract upgrade.
When planning contract upgrade, special care is also needed with regard to governance
(See comments in Governance.sol).
*/
// NOLINTNEXTLINE: reentrancy-events timestamp.
function upgradeTo(address newImplementation, bytes calldata data, bool finalize)
external payable onlyGovernance notFinalized notFrozen {
bytes32 implVectorHash = keccak256(abi.encode(newImplementation, data, finalize));
uint256 activationTime = enabledTime[implVectorHash];
require(activationTime > 0, "UNKNOWN_UPGRADE_INFORMATION");
require(newImplementation.isContract(), "ADDRESS_NOT_CONTRACT");
// NOLINTNEXTLINE: timestamp.
require(activationTime <= block.timestamp, "UPGRADE_NOT_ENABLED_YET");
setImplementation(newImplementation);
// NOLINTNEXTLINE: low-level-calls controlled-delegatecall.
(bool success, bytes memory returndata) = newImplementation.delegatecall(
abi.encodeWithSelector(this.initialize.selector, data));
require(success, string(returndata));
// Verify that the new implementation is not frozen post initialization.
// NOLINTNEXTLINE: low-level-calls controlled-delegatecall.
(success, returndata) = newImplementation.delegatecall(
abi.encodeWithSignature("isFrozen()"));
require(success, "CALL_TO_ISFROZEN_REVERTED");
require(!abi.decode(returndata, (bool)), "NEW_IMPLEMENTATION_FROZEN");
if (finalize) {
setFinalizedFlag();
emit FinalizedImplementation(newImplementation);
}
emit ImplementationUpgraded(newImplementation, data);
}
}
/*
Copyright 2019-2021 StarkWare Industries Ltd.
Licensed under the Apache License, Version 2.0 (the "License").
You may not use this file except in compliance with the License.
You may obtain a copy of the License at
https://www.starkware.co/open-source-license/
Unless required by applicable law or agreed to in writing,
software distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions
and limitations under the License.
*/
// SPDX-License-Identifier: Apache-2.0.
pragma solidity ^0.6.11;
import "Governance.sol";
/**
The Proxy contract is governed by one or more Governors of which the initial one is the
deployer of the contract.
A governor has the sole authority to perform the following operations:
1. Nominate additional governors (:sol:func:`proxyNominateNewGovernor`)
2. Remove other governors (:sol:func:`proxyRemoveGovernor`)
3. Add new `implementations` (proxied contracts)
4. Remove (new or old) `implementations`
5. Update `implementations` after a timelock allows it
Adding governors is performed in a two step procedure:
1. First, an existing governor nominates a new governor (:sol:func:`proxyNominateNewGovernor`)
2. Then, the new governor must accept governance to become a governor (:sol:func:`proxyAcceptGovernance`)
This two step procedure ensures that a governor public key cannot be nominated unless there is an
entity that has the corresponding private key. This is intended to prevent errors in the addition
process.
The governor private key should typically be held in a secure cold wallet or managed via a
multi-sig contract.
*/
/*
Implements Governance for the proxy contract.
It is a thin wrapper to the Governance contract,
which is needed so that it can have non-colliding function names,
and a specific tag (key) to allow unique state storage.
*/
contract ProxyGovernance is Governance {
// The tag is the string key that is used in the Governance storage mapping.
string public constant PROXY_GOVERNANCE_TAG = "StarkEx.Proxy.2019.GovernorsInformation";
function getGovernanceTag()
internal
pure
override
returns (string memory tag) {
tag = PROXY_GOVERNANCE_TAG;
}
function proxyIsGovernor(address testGovernor) external view returns (bool) {
return isGovernor(testGovernor);
}
function proxyNominateNewGovernor(address newGovernor) external {
nominateNewGovernor(newGovernor);
}
function proxyRemoveGovernor(address governorForRemoval) external {
removeGovernor(governorForRemoval);
}
function proxyAcceptGovernance()
external
{
acceptGovernance();
}
function proxyCancelNomination() external {
cancelNomination();
}
}
/*
Copyright 2019-2021 StarkWare Industries Ltd.
Licensed under the Apache License, Version 2.0 (the "License").
You may not use this file except in compliance with the License.
You may obtain a copy of the License at
https://www.starkware.co/open-source-license/
Unless required by applicable law or agreed to in writing,
software distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions
and limitations under the License.
*/
// SPDX-License-Identifier: Apache-2.0.
pragma solidity ^0.6.11;
import "GovernanceStorage.sol";
/*
Holds the Proxy-specific state variables.
This contract is inherited by the GovernanceStorage (and indirectly by MainStorage)
to prevent collision hazard.
*/
contract ProxyStorage is GovernanceStorage {
// NOLINTNEXTLINE: naming-convention uninitialized-state.
mapping (address => bytes32) internal initializationHash_DEPRECATED;
// The time after which we can switch to the implementation.
// Hash(implementation, data, finalize) => time.
mapping (bytes32 => uint256) internal enabledTime;
// A central storage of the flags whether implementation has been initialized.
// Note - it can be used flexibly enough to accommodate multiple levels of initialization
// (i.e. using different key salting schemes for different initialization levels).
mapping (bytes32 => bool) internal initialized;
}
/*
Copyright 2019-2021 StarkWare Industries Ltd.
Licensed under the Apache License, Version 2.0 (the "License").
You may not use this file except in compliance with the License.
You may obtain a copy of the License at
https://www.starkware.co/open-source-license/
Unless required by applicable law or agreed to in writing,
software distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions
and limitations under the License.
*/
// SPDX-License-Identifier: Apache-2.0.
pragma solidity ^0.6.11;
/**
StorageSlots holds the arbitrary storage slots used throughout the Proxy pattern.
Storage address slots are a mechanism to define an arbitrary location, that will not be
overlapped by the logical contracts.
*/
contract StorageSlots {
// Storage slot with the address of the current implementation.
// The address of the slot is keccak256("StarkWare2019.implemntation-slot").
// We need to keep this variable stored outside of the commonly used space,
// so that it's not overrun by the logical implementation (the proxied contract).
bytes32 internal constant IMPLEMENTATION_SLOT =
0x177667240aeeea7e35eabe3a35e18306f336219e1386f7710a6bf8783f761b24;
// Storage slot with the address of the call-proxy current implementation.
// The address of the slot is keccak256("'StarkWare2020.CallProxy.Implemntation.Slot'").
// We need to keep this variable stored outside of the commonly used space.
// so that it's not overrun by the logical implementation (the proxied contract).
bytes32 internal constant CALL_PROXY_IMPL_SLOT =
0x7184681641399eb4ad2fdb92114857ee6ff239f94ad635a1779978947b8843be;
// This storage slot stores the finalization flag.
// Once the value stored in this slot is set to non-zero
// the proxy blocks implementation upgrades.
// The current implementation is then referred to as Finalized.
// Web3.solidityKeccak(['string'], ["StarkWare2019.finalization-flag-slot"]).
bytes32 internal constant FINALIZED_STATE_SLOT =
0x7d433c6f837e8f93009937c466c82efbb5ba621fae36886d0cac433c5d0aa7d2;
// Storage slot to hold the upgrade delay (time-lock).
// The intention of this slot is to allow modification using an EIC.
// Web3.solidityKeccak(['string'], ['StarkWare.Upgradibility.Delay.Slot']).
bytes32 public constant UPGRADE_DELAY_SLOT =
0xc21dbb3089fcb2c4f4c6a67854ab4db2b0f233ea4b21b21f912d52d18fc5db1f;
}
{
"compilationTarget": {
"Proxy.sol": "Proxy"
},
"evmVersion": "istanbul",
"libraries": {},
"metadata": {
"bytecodeHash": "ipfs"
},
"optimizer": {
"enabled": true,
"runs": 100
},
"remappings": []
}
[{"inputs":[{"internalType":"uint256","name":"upgradeActivationDelay","type":"uint256"}],"stateMutability":"nonpayable","type":"constructor"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"implementation","type":"address"}],"name":"FinalizedImplementation","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"implementation","type":"address"},{"indexed":false,"internalType":"bytes","name":"initializer","type":"bytes"},{"indexed":false,"internalType":"bool","name":"finalize","type":"bool"}],"name":"ImplementationAdded","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"implementation","type":"address"},{"indexed":false,"internalType":"bytes","name":"initializer","type":"bytes"},{"indexed":false,"internalType":"bool","name":"finalize","type":"bool"}],"name":"ImplementationRemoved","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"implementation","type":"address"},{"indexed":false,"internalType":"bytes","name":"initializer","type":"bytes"}],"name":"ImplementationUpgraded","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"address","name":"acceptedGovernor","type":"address"}],"name":"LogNewGovernorAccepted","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"address","name":"nominatedGovernor","type":"address"}],"name":"LogNominatedGovernor","type":"event"},{"anonymous":false,"inputs":[],"name":"LogNominationCancelled","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"address","name":"removedGovernor","type":"address"}],"name":"LogRemovedGovernor","type":"event"},{"stateMutability":"payable","type":"fallback"},{"inputs":[],"name":"PROXY_GOVERNANCE_TAG","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"PROXY_VERSION","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"UPGRADE_DELAY_SLOT","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"newImplementation","type":"address"},{"internalType":"bytes","name":"data","type":"bytes"},{"internalType":"bool","name":"finalize","type":"bool"}],"name":"addImplementation","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"getUpgradeActivationDelay","outputs":[{"internalType":"uint256","name":"delay","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"implementation","outputs":[{"internalType":"address","name":"_implementation","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"bytes","name":"","type":"bytes"}],"name":"initialize","outputs":[],"stateMutability":"pure","type":"function"},{"inputs":[],"name":"isNotFinalized","outputs":[{"internalType":"bool","name":"notFinal","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"proxyAcceptGovernance","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"proxyCancelNomination","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"testGovernor","type":"address"}],"name":"proxyIsGovernor","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"newGovernor","type":"address"}],"name":"proxyNominateNewGovernor","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"governorForRemoval","type":"address"}],"name":"proxyRemoveGovernor","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"removedImplementation","type":"address"},{"internalType":"bytes","name":"data","type":"bytes"},{"internalType":"bool","name":"finalize","type":"bool"}],"name":"removeImplementation","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"newImplementation","type":"address"},{"internalType":"bytes","name":"data","type":"bytes"},{"internalType":"bool","name":"finalize","type":"bool"}],"name":"upgradeTo","outputs":[],"stateMutability":"payable","type":"function"},{"stateMutability":"payable","type":"receive"}]