Contract Source Code (Solidity Multiple files format)

IDE

• Blockscan IDE
• 🤖 Code ReaderBeta
• Remix IDE

More Options

• Similar
• Sol2Uml
• Submit Audit
• Compare

// Copyright (C) 2018  Argent Labs Ltd. <https://argent.xyz>

// This program is free software: you can redistribute it and/or modify
// it under the terms of the GNU General Public License as published by
// the Free Software Foundation, either version 3 of the License, or
// (at your option) any later version.

// This program is distributed in the hope that it will be useful,
// but WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
// GNU General Public License for more details.

// You should have received a copy of the GNU General Public License
// along with this program.  If not, see <http://www.gnu.org/licenses/>.

// SPDX-License-Identifier: GPL-3.0-only
pragma solidity ^0.6.12;

import "./Utils.sol";
import "./BaseFeature.sol";
import "./IGuardianStorage.sol";

/**
 * @title RecoveryManager
 * @notice Feature to manage the recovery of a wallet owner.
 * Recovery is executed by a consensus of the wallet's guardians and takes 24 hours before it can be finalized.
 * Once finalised the ownership of the wallet is transfered to a new address.
 * @author Julien Niset - <[email protected]>
 * @author Olivier Van Den Biggelaar - <[email protected]>
 */
contract RecoveryManager is BaseFeature {

    bytes32 constant NAME = "RecoveryManager";

    bytes4 constant internal EXECUTE_RECOVERY_PREFIX = bytes4(keccak256("executeRecovery(address,address)"));
    bytes4 constant internal FINALIZE_RECOVERY_PREFIX = bytes4(keccak256("finalizeRecovery(address)"));
    bytes4 constant internal CANCEL_RECOVERY_PREFIX = bytes4(keccak256("cancelRecovery(address)"));
    bytes4 constant internal TRANSFER_OWNERSHIP_PREFIX = bytes4(keccak256("transferOwnership(address,address)"));

    struct RecoveryConfig {
        address recovery;
        uint64 executeAfter;
        uint32 guardianCount;
    }

    // Wallet specific storage
    mapping (address => RecoveryConfig) internal recoveryConfigs;

    // Recovery period
    uint256 public recoveryPeriod;
    // Lock period
    uint256 public lockPeriod;
    // Guardian Storage
    IGuardianStorage public guardianStorage;

    // *************** Events *************************** //

    event RecoveryExecuted(address indexed wallet, address indexed _recovery, uint64 executeAfter);
    event RecoveryFinalized(address indexed wallet, address indexed _recovery);
    event RecoveryCanceled(address indexed wallet, address indexed _recovery);
    event OwnershipTransfered(address indexed wallet, address indexed _newOwner);

    // *************** Modifiers ************************ //

    /**
     * @notice Throws if there is no ongoing recovery procedure.
     */
    modifier onlyWhenRecovery(address _wallet) {
        require(recoveryConfigs[_wallet].executeAfter > 0, "RM: there must be an ongoing recovery");
        _;
    }

    /**
     * @notice Throws if there is an ongoing recovery procedure.
     */
    modifier notWhenRecovery(address _wallet) {
        require(recoveryConfigs[_wallet].executeAfter == 0, "RM: there cannot be an ongoing recovery");
        _;
    }

    // *************** Constructor ************************ //

    constructor(
        ILockStorage _lockStorage,
        IGuardianStorage _guardianStorage,
        IVersionManager _versionManager,
        uint256 _recoveryPeriod,
        uint256 _lockPeriod
    )
        BaseFeature(_lockStorage, _versionManager, NAME)
        public
    {
        // For the wallet to be secure we must have recoveryPeriod >= securityPeriod + securityWindow
        // where securityPeriod and securityWindow are the security parameters of adding/removing guardians
        // and confirming large transfers.
        require(_lockPeriod >= _recoveryPeriod, "RM: insecure security periods");
        recoveryPeriod = _recoveryPeriod;
        lockPeriod = _lockPeriod;
        guardianStorage = _guardianStorage;
    }

    // *************** External functions ************************ //

    /**
     * @notice Lets the guardians start the execution of the recovery procedure.
     * Once triggered the recovery is pending for the security period before it can be finalised.
     * Must be confirmed by N guardians, where N = ((Nb Guardian + 1) / 2).
     * @param _wallet The target wallet.
     * @param _recovery The address to which ownership should be transferred.
     */
    function executeRecovery(address _wallet, address _recovery) external onlyWalletFeature(_wallet) notWhenRecovery(_wallet) {
        validateNewOwner(_wallet, _recovery);
        RecoveryConfig storage config = recoveryConfigs[_wallet];
        config.recovery = _recovery;
        config.executeAfter = uint64(block.timestamp + recoveryPeriod);
        config.guardianCount = uint32(guardianStorage.guardianCount(_wallet));
        setLock(_wallet, block.timestamp + lockPeriod);
        emit RecoveryExecuted(_wallet, _recovery, config.executeAfter);
    }

    /**
     * @notice Finalizes an ongoing recovery procedure if the security period is over.
     * The method is public and callable by anyone to enable orchestration.
     * @param _wallet The target wallet.
     */
    function finalizeRecovery(address _wallet) external onlyWhenRecovery(_wallet) {
        RecoveryConfig storage config = recoveryConfigs[address(_wallet)];
        require(uint64(block.timestamp) > config.executeAfter, "RM: the recovery period is not over yet");
        address recoveryOwner = config.recovery;
        delete recoveryConfigs[_wallet];

        versionManager.setOwner(_wallet, recoveryOwner);
        setLock(_wallet, 0);

        emit RecoveryFinalized(_wallet, recoveryOwner);
    }

    /**
     * @notice Lets the owner cancel an ongoing recovery procedure.
     * Must be confirmed by N guardians, where N = ((Nb Guardian + 1) / 2) - 1.
     * @param _wallet The target wallet.
     */
    function cancelRecovery(address _wallet) external onlyWalletFeature(_wallet) onlyWhenRecovery(_wallet) {
        RecoveryConfig storage config = recoveryConfigs[address(_wallet)];
        address recoveryOwner = config.recovery;
        delete recoveryConfigs[_wallet];
        setLock(_wallet, 0);

        emit RecoveryCanceled(_wallet, recoveryOwner);
    }

    /**
     * @notice Lets the owner transfer the wallet ownership. This is executed immediately.
     * @param _wallet The target wallet.
     * @param _newOwner The address to which ownership should be transferred.
     */
    function transferOwnership(address _wallet, address _newOwner) external onlyWalletFeature(_wallet) onlyWhenUnlocked(_wallet) {
        validateNewOwner(_wallet, _newOwner);
        versionManager.setOwner(_wallet, _newOwner);

        emit OwnershipTransfered(_wallet, _newOwner);
    }

    /**
    * @notice Gets the details of the ongoing recovery procedure if any.
    * @param _wallet The target wallet.
    */
    function getRecovery(address _wallet) external view returns(address _address, uint64 _executeAfter, uint32 _guardianCount) {
        RecoveryConfig storage config = recoveryConfigs[_wallet];
        return (config.recovery, config.executeAfter, config.guardianCount);
    }

    /**
     * @inheritdoc IFeature
     */
    function getRequiredSignatures(address _wallet, bytes calldata _data) external view override returns (uint256, OwnerSignature) {
        bytes4 methodId = Utils.functionPrefix(_data);
        if (methodId == EXECUTE_RECOVERY_PREFIX) {
            uint walletGuardians = guardianStorage.guardianCount(_wallet);
            require(walletGuardians > 0, "RM: no guardians set on wallet");
            uint numberOfSignaturesRequired = Utils.ceil(walletGuardians, 2);
            return (numberOfSignaturesRequired, OwnerSignature.Disallowed);
        }
        if (methodId == FINALIZE_RECOVERY_PREFIX) {
            return (0, OwnerSignature.Anyone);
        }
        if (methodId == CANCEL_RECOVERY_PREFIX) {
            uint numberOfSignaturesRequired = Utils.ceil(recoveryConfigs[_wallet].guardianCount + 1, 2);
            return (numberOfSignaturesRequired, OwnerSignature.Optional);
        }
        if (methodId == TRANSFER_OWNERSHIP_PREFIX) {
            uint majorityGuardians = Utils.ceil(guardianStorage.guardianCount(_wallet), 2);
            uint numberOfSignaturesRequired = SafeMath.add(majorityGuardians, 1);
            return (numberOfSignaturesRequired, OwnerSignature.Required);
        }

        revert("RM: unknown method");
    }

    // *************** Internal Functions ********************* //

    function validateNewOwner(address _wallet, address _newOwner) internal view {
        require(_newOwner != address(0), "RM: new owner address cannot be null");
        require(!guardianStorage.isGuardian(_wallet, _newOwner), "RM: new owner address cannot be a guardian");
    }

    function setLock(address _wallet, uint256 _releaseAfter) internal {
        versionManager.invokeStorage(
            _wallet,
            address(lockStorage),
            abi.encodeWithSelector(lockStorage.setLock.selector, _wallet, address(this), _releaseAfter)
        );
    }

}

// Copyright (C) 2018  Argent Labs Ltd. <https://argent.xyz>

// This program is free software: you can redistribute it and/or modify
// it under the terms of the GNU General Public License as published by
// the Free Software Foundation, either version 3 of the License, or
// (at your option) any later version.

// This program is distributed in the hope that it will be useful,
// but WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
// GNU General Public License for more details.s

// You should have received a copy of the GNU General Public License
// along with this program.  If not, see <http://www.gnu.org/licenses/>.

// SPDX-License-Identifier: GPL-3.0-only
pragma solidity ^0.6.12;

import "./SafeMath.sol";
import "./IWallet.sol";
import "./IModuleRegistry.sol";
import "./ILockStorage.sol";
import "./IFeature.sol";
import "./ERC20.sol";
import "./IVersionManager.sol";

/**
 * @title BaseFeature
 * @notice Base Feature contract that contains methods common to all Feature contracts.
 * @author Julien Niset - <[email protected]>, Olivier VDB - <[email protected]>
 */
contract BaseFeature is IFeature {

    // Empty calldata
    bytes constant internal EMPTY_BYTES = "";
    // Mock token address for ETH
    address constant internal ETH_TOKEN = 0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE;
    // The address of the Lock storage
    ILockStorage internal lockStorage;
    // The address of the Version Manager
    IVersionManager internal versionManager;

    event FeatureCreated(bytes32 name);

    /**
     * @notice Throws if the wallet is locked.
     */
    modifier onlyWhenUnlocked(address _wallet) {
        require(!lockStorage.isLocked(_wallet), "BF: wallet locked");
        _;
    }

    /**
     * @notice Throws if the sender is not the VersionManager.
     */
    modifier onlyVersionManager() {
        require(msg.sender == address(versionManager), "BF: caller must be VersionManager");
        _;
    }

    /**
     * @notice Throws if the sender is not the owner of the target wallet.
     */
    modifier onlyWalletOwner(address _wallet) {
        require(isOwner(_wallet, msg.sender), "BF: must be wallet owner");
        _;
    }

    /**
     * @notice Throws if the sender is not an authorised feature of the target wallet.
     */
    modifier onlyWalletFeature(address _wallet) {
        require(versionManager.isFeatureAuthorised(_wallet, msg.sender), "BF: must be a wallet feature");
        _;
    }

    /**
     * @notice Throws if the sender is not the owner of the target wallet or the feature itself.
     */
    modifier onlyWalletOwnerOrFeature(address _wallet) {
        // Wrapping in an internal method reduces deployment cost by avoiding duplication of inlined code
        verifyOwnerOrAuthorisedFeature(_wallet, msg.sender);
        _;
    }

    constructor(
        ILockStorage _lockStorage,
        IVersionManager _versionManager,
        bytes32 _name
    ) public {
        lockStorage = _lockStorage;
        versionManager = _versionManager;
        emit FeatureCreated(_name);
    }

    /**
    * @inheritdoc IFeature
    */
    function recoverToken(address _token) external virtual override {
        uint total = ERC20(_token).balanceOf(address(this));
        _token.call(abi.encodeWithSelector(ERC20(_token).transfer.selector, address(versionManager), total));
    }

    /**
     * @notice Inits the feature for a wallet by doing nothing.
     * @dev !! Overriding methods need make sure `init()` can only be called by the VersionManager !!
     * @param _wallet The wallet.
     */
    function init(address _wallet) external virtual override  {}

    /**
     * @inheritdoc IFeature
     */
    function getRequiredSignatures(address, bytes calldata) external virtual view override returns (uint256, OwnerSignature) {
        revert("BF: disabled method");
    }

    /**
     * @inheritdoc IFeature
     */
    function getStaticCallSignatures() external virtual override view returns (bytes4[] memory _sigs) {}

    /**
     * @inheritdoc IFeature
     */
    function isFeatureAuthorisedInVersionManager(address _wallet, address _feature) public override view returns (bool) {
        return versionManager.isFeatureAuthorised(_wallet, _feature);
    }

    /**
    * @notice Checks that the wallet address provided as the first parameter of _data matches _wallet
    * @return false if the addresses are different.
    */
    function verifyData(address _wallet, bytes calldata _data) internal pure returns (bool) {
        require(_data.length >= 36, "RM: Invalid dataWallet");
        address dataWallet = abi.decode(_data[4:], (address));
        return dataWallet == _wallet;
    }
    
     /**
     * @notice Helper method to check if an address is the owner of a target wallet.
     * @param _wallet The target wallet.
     * @param _addr The address.
     */
    function isOwner(address _wallet, address _addr) internal view returns (bool) {
        return IWallet(_wallet).owner() == _addr;
    }

    /**
     * @notice Verify that the caller is an authorised feature or the wallet owner.
     * @param _wallet The target wallet.
     * @param _sender The caller.
     */
    function verifyOwnerOrAuthorisedFeature(address _wallet, address _sender) internal view {
        require(isFeatureAuthorisedInVersionManager(_wallet, _sender) || isOwner(_wallet, _sender), "BF: must be owner or feature");
    }

    /**
     * @notice Helper method to invoke a wallet.
     * @param _wallet The target wallet.
     * @param _to The target address for the transaction.
     * @param _value The value of the transaction.
     * @param _data The data of the transaction.
     */
    function invokeWallet(address _wallet, address _to, uint256 _value, bytes memory _data)
        internal
        returns (bytes memory _res) 
    {
        _res = versionManager.checkAuthorisedFeatureAndInvokeWallet(_wallet, _to, _value, _data);
    }

}

pragma solidity >=0.5.4 <0.7.0;

/**
 * ERC20 contract interface.
 */
interface ERC20 {
    function totalSupply() external view returns (uint);
    function decimals() external view returns (uint);
    function balanceOf(address tokenOwner) external view returns (uint balance);
    function allowance(address tokenOwner, address spender) external view returns (uint remaining);
    function transfer(address to, uint tokens) external returns (bool success);
    function approve(address spender, uint tokens) external returns (bool success);
    function transferFrom(address from, address to, uint tokens) external returns (bool success);
}

// Copyright (C) 2018  Argent Labs Ltd. <https://argent.xyz>

// This program is free software: you can redistribute it and/or modify
// it under the terms of the GNU General Public License as published by
// the Free Software Foundation, either version 3 of the License, or
// (at your option) any later version.

// This program is distributed in the hope that it will be useful,
// but WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
// GNU General Public License for more details.

// You should have received a copy of the GNU General Public License
// along with this program.  If not, see <http://www.gnu.org/licenses/>.

// SPDX-License-Identifier: GPL-3.0-only
pragma solidity >=0.5.4 <0.7.0;

/**
 * @title IFeature
 * @notice Interface for a Feature.
 * @author Julien Niset - <[email protected]>, Olivier VDB - <[email protected]>
 */
interface IFeature {

    enum OwnerSignature {
        Anyone,             // Anyone
        Required,           // Owner required
        Optional,           // Owner and/or guardians
        Disallowed          // guardians only
    }

    /**
    * @notice Utility method to recover any ERC20 token that was sent to the Feature by mistake.
    * @param _token The token to recover.
    */
    function recoverToken(address _token) external;

    /**
     * @notice Inits a Feature for a wallet by e.g. setting some wallet specific parameters in storage.
     * @param _wallet The wallet.
     */
    function init(address _wallet) external;

    /**
     * @notice Helper method to check if an address is an authorised feature of a target wallet.
     * @param _wallet The target wallet.
     * @param _feature The address.
     */
    function isFeatureAuthorisedInVersionManager(address _wallet, address _feature) external view returns (bool);

    /**
    * @notice Gets the number of valid signatures that must be provided to execute a
    * specific relayed transaction.
    * @param _wallet The target wallet.
    * @param _data The data of the relayed transaction.
    * @return The number of required signatures and the wallet owner signature requirement.
    */
    function getRequiredSignatures(address _wallet, bytes calldata _data) external view returns (uint256, OwnerSignature);

    /**
    * @notice Gets the list of static call signatures that this feature responds to on behalf of wallets
    */
    function getStaticCallSignatures() external view returns (bytes4[] memory);
}

// Copyright (C) 2018  Argent Labs Ltd. <https://argent.xyz>

// This program is free software: you can redistribute it and/or modify
// it under the terms of the GNU General Public License as published by
// the Free Software Foundation, either version 3 of the License, or
// (at your option) any later version.

// This program is distributed in the hope that it will be useful,
// but WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
// GNU General Public License for more details.

// You should have received a copy of the GNU General Public License
// along with this program.  If not, see <http://www.gnu.org/licenses/>.

// SPDX-License-Identifier: GPL-3.0-only
pragma solidity >=0.5.4 <0.7.0;

interface IGuardianStorage {

    /**
     * @notice Lets an authorised module add a guardian to a wallet.
     * @param _wallet The target wallet.
     * @param _guardian The guardian to add.
     */
    function addGuardian(address _wallet, address _guardian) external;

    /**
     * @notice Lets an authorised module revoke a guardian from a wallet.
     * @param _wallet The target wallet.
     * @param _guardian The guardian to revoke.
     */
    function revokeGuardian(address _wallet, address _guardian) external;

    /**
     * @notice Checks if an account is a guardian for a wallet.
     * @param _wallet The target wallet.
     * @param _guardian The account.
     * @return true if the account is a guardian for a wallet.
     */
    function isGuardian(address _wallet, address _guardian) external view returns (bool);

    function isLocked(address _wallet) external view returns (bool);

    function getLock(address _wallet) external view returns (uint256);

    function getLocker(address _wallet) external view returns (address);

    function setLock(address _wallet, uint256 _releaseAfter) external;

    function getGuardians(address _wallet) external view returns (address[] memory);

    function guardianCount(address _wallet) external view returns (uint256);
}

// This program is free software: you can redistribute it and/or modify
// it under the terms of the GNU General Public License as published by
// the Free Software Foundation, either version 3 of the License, or
// (at your option) any later version.

// This program is distributed in the hope that it will be useful,
// but WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
// GNU General Public License for more details.

// You should have received a copy of the GNU General Public License
// along with this program.  If not, see <http://www.gnu.org/licenses/>.

// SPDX-License-Identifier: GPL-3.0-only
pragma solidity ^0.6.12;
pragma experimental ABIEncoderV2;

/**
 * @title ILimitStorage
 * @notice LimitStorage interface
 */
interface ILimitStorage {

    struct Limit {
        // the current limit
        uint128 current;
        // the pending limit if any
        uint128 pending;
        // when the pending limit becomes the current limit
        uint64 changeAfter;
    }

    struct DailySpent {
        // The amount already spent during the current period
        uint128 alreadySpent;
        // The end of the current period
        uint64 periodEnd;
    }

    function setLimit(address _wallet, Limit memory _limit) external;

    function getLimit(address _wallet) external view returns (Limit memory _limit);

    function setDailySpent(address _wallet, DailySpent memory _dailySpent) external;

    function getDailySpent(address _wallet) external view returns (DailySpent memory _dailySpent);

    function setLimitAndDailySpent(address _wallet, Limit memory _limit, DailySpent memory _dailySpent) external;

    function getLimitAndDailySpent(address _wallet) external view returns (Limit memory _limit, DailySpent memory _dailySpent);
}

// Copyright (C) 2018  Argent Labs Ltd. <https://argent.xyz>

// This program is free software: you can redistribute it and/or modify
// it under the terms of the GNU General Public License as published by
// the Free Software Foundation, either version 3 of the License, or
// (at your option) any later version.

// This program is distributed in the hope that it will be useful,
// but WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
// GNU General Public License for more details.

// You should have received a copy of the GNU General Public License
// along with this program.  If not, see <http://www.gnu.org/licenses/>.

// SPDX-License-Identifier: GPL-3.0-only
pragma solidity >=0.5.4 <0.7.0;

interface ILockStorage {
    function isLocked(address _wallet) external view returns (bool);

    function getLock(address _wallet) external view returns (uint256);

    function getLocker(address _wallet) external view returns (address);

    function setLock(address _wallet, address _locker, uint256 _releaseAfter) external;
}

// Copyright (C) 2020  Argent Labs Ltd. <https://argent.xyz>

// This program is free software: you can redistribute it and/or modify
// it under the terms of the GNU General Public License as published by
// the Free Software Foundation, either version 3 of the License, or
// (at your option) any later version.

// This program is distributed in the hope that it will be useful,
// but WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
// GNU General Public License for more details.

// You should have received a copy of the GNU General Public License
// along with this program.  If not, see <http://www.gnu.org/licenses/>.

// SPDX-License-Identifier: GPL-3.0-only
pragma solidity >=0.5.4 <0.7.0;

/**
 * @title IModuleRegistry
 * @notice Interface for the registry of authorised modules.
 */
interface IModuleRegistry {
    function registerModule(address _module, bytes32 _name) external;

    function deregisterModule(address _module) external;

    function registerUpgrader(address _upgrader, bytes32 _name) external;

    function deregisterUpgrader(address _upgrader) external;

    function recoverToken(address _token) external;

    function moduleInfo(address _module) external view returns (bytes32);

    function upgraderInfo(address _upgrader) external view returns (bytes32);

    function isRegisteredModule(address _module) external view returns (bool);

    function isRegisteredModule(address[] calldata _modules) external view returns (bool);

    function isRegisteredUpgrader(address _upgrader) external view returns (bool);
}

// Copyright (C) 2018  Argent Labs Ltd. <https://argent.xyz>

// This program is free software: you can redistribute it and/or modify
// it under the terms of the GNU General Public License as published by
// the Free Software Foundation, either version 3 of the License, or
// (at your option) any later version.

// This program is distributed in the hope that it will be useful,
// but WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
// GNU General Public License for more details.

// You should have received a copy of the GNU General Public License
// along with this program.  If not, see <http://www.gnu.org/licenses/>.

// SPDX-License-Identifier: GPL-3.0-only
pragma solidity >=0.5.4 <0.7.0;
pragma experimental ABIEncoderV2;

import "./ILimitStorage.sol";

/**
 * @title IVersionManager
 * @notice Interface for the VersionManager module.
 * @author Olivier VDB - <[email protected]>
 */
interface IVersionManager {
    /**
     * @notice Returns true if the feature is authorised for the wallet
     * @param _wallet The target wallet.
     * @param _feature The feature.
     */
    function isFeatureAuthorised(address _wallet, address _feature) external view returns (bool);

    /**
     * @notice Lets a feature (caller) invoke a wallet.
     * @param _wallet The target wallet.
     * @param _to The target address for the transaction.
     * @param _value The value of the transaction.
     * @param _data The data of the transaction.
     */
    function checkAuthorisedFeatureAndInvokeWallet(
        address _wallet,
        address _to,
        uint256 _value,
        bytes calldata _data
    ) external returns (bytes memory _res);

    /* ******* Backward Compatibility with old Storages and BaseWallet *************** */

    /**
     * @notice Sets a new owner for the wallet.
     * @param _newOwner The new owner.
     */
    function setOwner(address _wallet, address _newOwner) external;

    /**
     * @notice Lets a feature write data to a storage contract.
     * @param _wallet The target wallet.
     * @param _storage The storage contract.
     * @param _data The data of the call
     */
    function invokeStorage(address _wallet, address _storage, bytes calldata _data) external;

    /**
     * @notice Upgrade a wallet to a new version.
     * @param _wallet the wallet to upgrade
     * @param _toVersion the new version
     */
    function upgradeWallet(address _wallet, uint256 _toVersion) external;
 
}

// Copyright (C) 2018  Argent Labs Ltd. <https://argent.xyz>

// This program is free software: you can redistribute it and/or modify
// it under the terms of the GNU General Public License as published by
// the Free Software Foundation, either version 3 of the License, or
// (at your option) any later version.

// This program is distributed in the hope that it will be useful,
// but WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
// GNU General Public License for more details.

// You should have received a copy of the GNU General Public License
// along with this program.  If not, see <http://www.gnu.org/licenses/>.

// SPDX-License-Identifier: GPL-3.0-only
pragma solidity >=0.5.4 <0.7.0;

/**
 * @title IWallet
 * @notice Interface for the BaseWallet
 */
interface IWallet {
    /**
     * @notice Returns the wallet owner.
     * @return The wallet owner address.
     */
    function owner() external view returns (address);

    /**
     * @notice Returns the number of authorised modules.
     * @return The number of authorised modules.
     */
    function modules() external view returns (uint);

    /**
     * @notice Sets a new owner for the wallet.
     * @param _newOwner The new owner.
     */
    function setOwner(address _newOwner) external;

    /**
     * @notice Checks if a module is authorised on the wallet.
     * @param _module The module address to check.
     * @return `true` if the module is authorised, otherwise `false`.
     */
    function authorised(address _module) external view returns (bool);

    /**
     * @notice Returns the module responsible for a static call redirection.
     * @param _sig The signature of the static call.
     * @return the module doing the redirection
     */
    function enabled(bytes4 _sig) external view returns (address);

    /**
     * @notice Enables/Disables a module.
     * @param _module The target module.
     * @param _value Set to `true` to authorise the module.
     */
    function authoriseModule(address _module, bool _value) external;

    /**
    * @notice Enables a static method by specifying the target module to which the call must be delegated.
    * @param _module The target module.
    * @param _method The static method signature.
    */
    function enableStaticCall(address _module, bytes4 _method) external;
}

pragma solidity ^0.6.0;

/**
 * @dev Wrappers over Solidity's arithmetic operations with added overflow
 * checks.
 *
 * Arithmetic operations in Solidity wrap on overflow. This can easily result
 * in bugs, because programmers usually assume that an overflow raises an
 * error, which is the standard behavior in high level programming languages.
 * `SafeMath` restores this intuition by reverting the transaction when an
 * operation overflows.
 *
 * Using this library instead of the unchecked operations eliminates an entire
 * class of bugs, so it's recommended to use it always.
 */
library SafeMath {
    /**
     * @dev Returns the addition of two unsigned integers, reverting on
     * overflow.
     *
     * Counterpart to Solidity's `+` operator.
     *
     * Requirements:
     * - Addition cannot overflow.
     */
    function add(uint256 a, uint256 b) internal pure returns (uint256) {
        uint256 c = a + b;
        require(c >= a, "SafeMath: addition overflow");

        return c;
    }

    /**
     * @dev Returns the subtraction of two unsigned integers, reverting on
     * overflow (when the result is negative).
     *
     * Counterpart to Solidity's `-` operator.
     *
     * Requirements:
     * - Subtraction cannot overflow.
     */
    function sub(uint256 a, uint256 b) internal pure returns (uint256) {
        return sub(a, b, "SafeMath: subtraction overflow");
    }

    /**
     * @dev Returns the subtraction of two unsigned integers, reverting with custom message on
     * overflow (when the result is negative).
     *
     * Counterpart to Solidity's `-` operator.
     *
     * Requirements:
     * - Subtraction cannot overflow.
     */
    function sub(uint256 a, uint256 b, string memory errorMessage) internal pure returns (uint256) {
        require(b <= a, errorMessage);
        uint256 c = a - b;

        return c;
    }

    /**
     * @dev Returns the multiplication of two unsigned integers, reverting on
     * overflow.
     *
     * Counterpart to Solidity's `*` operator.
     *
     * Requirements:
     * - Multiplication cannot overflow.
     */
    function mul(uint256 a, uint256 b) internal pure returns (uint256) {
        // Gas optimization: this is cheaper than requiring 'a' not being zero, but the
        // benefit is lost if 'b' is also tested.
        // See: https://github.com/OpenZeppelin/openzeppelin-contracts/pull/522
        if (a == 0) {
            return 0;
        }

        uint256 c = a * b;
        require(c / a == b, "SafeMath: multiplication overflow");

        return c;
    }

    /**
     * @dev Returns the integer division of two unsigned integers. Reverts on
     * division by zero. The result is rounded towards zero.
     *
     * Counterpart to Solidity's `/` operator. Note: this function uses a
     * `revert` opcode (which leaves remaining gas untouched) while Solidity
     * uses an invalid opcode to revert (consuming all remaining gas).
     *
     * Requirements:
     * - The divisor cannot be zero.
     */
    function div(uint256 a, uint256 b) internal pure returns (uint256) {
        return div(a, b, "SafeMath: division by zero");
    }

    /**
     * @dev Returns the integer division of two unsigned integers. Reverts with custom message on
     * division by zero. The result is rounded towards zero.
     *
     * Counterpart to Solidity's `/` operator. Note: this function uses a
     * `revert` opcode (which leaves remaining gas untouched) while Solidity
     * uses an invalid opcode to revert (consuming all remaining gas).
     *
     * Requirements:
     * - The divisor cannot be zero.
     */
    function div(uint256 a, uint256 b, string memory errorMessage) internal pure returns (uint256) {
        // Solidity only automatically asserts when dividing by 0
        require(b > 0, errorMessage);
        uint256 c = a / b;
        // assert(a == b * c + a % b); // There is no case in which this doesn't hold

        return c;
    }

    /**
     * @dev Returns the remainder of dividing two unsigned integers. (unsigned integer modulo),
     * Reverts when dividing by zero.
     *
     * Counterpart to Solidity's `%` operator. This function uses a `revert`
     * opcode (which leaves remaining gas untouched) while Solidity uses an
     * invalid opcode to revert (consuming all remaining gas).
     *
     * Requirements:
     * - The divisor cannot be zero.
     */
    function mod(uint256 a, uint256 b) internal pure returns (uint256) {
        return mod(a, b, "SafeMath: modulo by zero");
    }

    /**
     * @dev Returns the remainder of dividing two unsigned integers. (unsigned integer modulo),
     * Reverts with custom message when dividing by zero.
     *
     * Counterpart to Solidity's `%` operator. This function uses a `revert`
     * opcode (which leaves remaining gas untouched) while Solidity uses an
     * invalid opcode to revert (consuming all remaining gas).
     *
     * Requirements:
     * - The divisor cannot be zero.
     */
    function mod(uint256 a, uint256 b, string memory errorMessage) internal pure returns (uint256) {
        require(b != 0, errorMessage);
        return a % b;
    }
}

// Copyright (C) 2020  Argent Labs Ltd. <https://argent.xyz>

// This program is free software: you can redistribute it and/or modify
// it under the terms of the GNU General Public License as published by
// the Free Software Foundation, either version 3 of the License, or
// (at your option) any later version.

// This program is distributed in the hope that it will be useful,
// but WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
// GNU General Public License for more details.

// You should have received a copy of the GNU General Public License
// along with this program.  If not, see <http://www.gnu.org/licenses/>.

// SPDX-License-Identifier: GPL-3.0-only
pragma solidity ^0.6.12;

/**
 * @title Utils
 * @notice Common utility methods used by modules.
 */
library Utils {

    /**
    * @notice Helper method to recover the signer at a given position from a list of concatenated signatures.
    * @param _signedHash The signed hash
    * @param _signatures The concatenated signatures.
    * @param _index The index of the signature to recover.
    */
    function recoverSigner(bytes32 _signedHash, bytes memory _signatures, uint _index) internal pure returns (address) {
        uint8 v;
        bytes32 r;
        bytes32 s;
        // we jump 32 (0x20) as the first slot of bytes contains the length
        // we jump 65 (0x41) per signature
        // for v we load 32 bytes ending with v (the first 31 come from s) then apply a mask
        // solhint-disable-next-line no-inline-assembly
        assembly {
            r := mload(add(_signatures, add(0x20,mul(0x41,_index))))
            s := mload(add(_signatures, add(0x40,mul(0x41,_index))))
            v := and(mload(add(_signatures, add(0x41,mul(0x41,_index)))), 0xff)
        }
        require(v == 27 || v == 28);

        address recoveredAddress = ecrecover(_signedHash, v, r, s);
        require(recoveredAddress != address(0), "Utils: ecrecover returned 0");
        return recoveredAddress;
    }

    /**
    * @notice Helper method to parse data and extract the method signature.
    */
    function functionPrefix(bytes memory _data) internal pure returns (bytes4 prefix) {
        require(_data.length >= 4, "RM: Invalid functionPrefix");
        // solhint-disable-next-line no-inline-assembly
        assembly {
            prefix := mload(add(_data, 0x20))
        }
    }

    /**
    * @notice Returns ceil(a / b).
    */
    function ceil(uint256 a, uint256 b) internal pure returns (uint256) {
        uint256 c = a / b;
        if (a % b == 0) {
            return c;
        } else {
            return c + 1;
        }
    }

    function min(uint256 a, uint256 b) internal pure returns (uint256) {
        if (a < b) {
            return a;
        }
        return b;
    }
}

• No Contract Security Audit Submitted- Submit Audit Here

[{"inputs":[{"internalType":"contract ILockStorage","name":"_lockStorage","type":"address"},{"internalType":"contract IGuardianStorage","name":"_guardianStorage","type":"address"},{"internalType":"contract IVersionManager","name":"_versionManager","type":"address"},{"internalType":"uint256","name":"_recoveryPeriod","type":"uint256"},{"internalType":"uint256","name":"_lockPeriod","type":"uint256"}],"stateMutability":"nonpayable","type":"constructor"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"bytes32","name":"name","type":"bytes32"}],"name":"FeatureCreated","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"wallet","type":"address"},{"indexed":true,"internalType":"address","name":"_newOwner","type":"address"}],"name":"OwnershipTransfered","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"wallet","type":"address"},{"indexed":true,"internalType":"address","name":"_recovery","type":"address"}],"name":"RecoveryCanceled","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"wallet","type":"address"},{"indexed":true,"internalType":"address","name":"_recovery","type":"address"},{"indexed":false,"internalType":"uint64","name":"executeAfter","type":"uint64"}],"name":"RecoveryExecuted","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"wallet","type":"address"},{"indexed":true,"internalType":"address","name":"_recovery","type":"address"}],"name":"RecoveryFinalized","type":"event"},{"inputs":[{"internalType":"address","name":"_wallet","type":"address"}],"name":"cancelRecovery","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"_wallet","type":"address"},{"internalType":"address","name":"_recovery","type":"address"}],"name":"executeRecovery","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"_wallet","type":"address"}],"name":"finalizeRecovery","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"_wallet","type":"address"}],"name":"getRecovery","outputs":[{"internalType":"address","name":"_address","type":"address"},{"internalType":"uint64","name":"_executeAfter","type":"uint64"},{"internalType":"uint32","name":"_guardianCount","type":"uint32"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"_wallet","type":"address"},{"internalType":"bytes","name":"_data","type":"bytes"}],"name":"getRequiredSignatures","outputs":[{"internalType":"uint256","name":"","type":"uint256"},{"internalType":"enum IFeature.OwnerSignature","name":"","type":"uint8"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"getStaticCallSignatures","outputs":[{"internalType":"bytes4[]","name":"_sigs","type":"bytes4[]"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"guardianStorage","outputs":[{"internalType":"contract IGuardianStorage","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"_wallet","type":"address"}],"name":"init","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"_wallet","type":"address"},{"internalType":"address","name":"_feature","type":"address"}],"name":"isFeatureAuthorisedInVersionManager","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"lockPeriod","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"_token","type":"address"}],"name":"recoverToken","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"recoveryPeriod","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"_wallet","type":"address"},{"internalType":"address","name":"_newOwner","type":"address"}],"name":"transferOwnership","outputs":[],"stateMutability":"nonpayable","type":"function"}]

0x608060405234801561001057600080fd5b50600436106100df5760003560e01c80639769c3fe1161008c578063b0ba4da011610066578063b0ba4da0146102ef578063c90db4471461031d578063d89784fc14610343578063ea2347e614610367576100df565b80639769c3fe1461022a5780639be65a6014610287578063a287fdbd146102ad576100df565b80633b73d67f116100bd5780633b73d67f1461014c5780633fd8b02f146101f45780636d435421146101fc576100df565b806316c3e22f146100e457806319ab453c146100fe578063315a7af314610126575b600080fd5b6100ec6103bf565b60408051918252519081900360200190f35b6101246004803603602081101561011457600080fd5b50356001600160a01b03166103c5565b005b6101246004803603602081101561013c57600080fd5b50356001600160a01b03166103c8565b6101cc6004803603604081101561016257600080fd5b6001600160a01b03823516919081019060408101602082013564010000000081111561018d57600080fd5b82018360208201111561019f57600080fd5b803590602001918460018302840111640100000000831117156101c157600080fd5b509092509050610570565b604051808381526020018260038111156101e257fe5b81526020019250505060405180910390f35b6100ec6108b6565b6101246004803603604081101561021257600080fd5b506001600160a01b03813581169160200135166108bc565b6102506004803603602081101561024057600080fd5b50356001600160a01b0316610b2c565b604080516001600160a01b03909416845267ffffffffffffffff909216602084015263ffffffff1682820152519081900360600190f35b6101246004803603602081101561029d57600080fd5b50356001600160a01b0316610b6c565b6102db600480360360408110156102c357600080fd5b506001600160a01b0381358116916020013516610ceb565b604080519115158252519081900360200190f35b6101246004803603604081101561030557600080fd5b506001600160a01b0381358116916020013516610d79565b6101246004803603602081101561033357600080fd5b50356001600160a01b031661103e565b61034b6111ec565b604080516001600160a01b039092168252519081900360200190f35b61036f6111fb565b60408051602080825283518183015283519192839290830191858101910280838360005b838110156103ab578181015183820152602001610393565b505050509050019250505060405180910390f35b60035481565b50565b6001600160a01b0381166000908152600260205260409020548190600160a01b900467ffffffffffffffff1661042f5760405162461bcd60e51b81526004018080602001828103825260258152602001806115986025913960400191505060405180910390fd5b6001600160a01b0382166000908152600260205260409020805467ffffffffffffffff600160a01b9091048116429091161161049c5760405162461bcd60e51b81526004018080602001828103825260278152602001806115716027913960400191505060405180910390fd5b80546001600160a01b038481166000818152600260205260408082208290556001548151630a669ef360e21b8152600481019490945294841660248401819052905190949093169263299a7bcc92604480820193929182900301818387803b15801561050757600080fd5b505af115801561051b573d6000803e3d6000fd5b5050505061052a846000611200565b806001600160a01b0316846001600160a01b03167fd8667de85dae2d56d76e700d16de53d21ac2ce4d5549cb0bf51c55fdc37f0bc160405160405180910390a350505050565b60008060006105b485858080601f01602080910402602001604051908101604052809392919081815260200183838082843760009201919091525061136192505050565b90506001600160e01b031981167fb0ba4da00000000000000000000000000000000000000000000000000000000014156106d557600554604080516328207dbb60e11b81526001600160a01b03898116600483015291516000939290921691635040fb7691602480820192602092909190829003018186803b15801561063957600080fd5b505afa15801561064d573d6000803e3d6000fd5b505050506040513d602081101561066357600080fd5b50519050806106b9576040805162461bcd60e51b815260206004820152601e60248201527f524d3a206e6f20677561726469616e7320736574206f6e2077616c6c65740000604482015290519081900360640190fd5b60006106c68260026113c2565b9450600393506108ae92505050565b6001600160e01b031981167f315a7af30000000000000000000000000000000000000000000000000000000014156107145760008092509250506108ae565b6001600160e01b031981167fc90db44700000000000000000000000000000000000000000000000000000000141561078d576001600160a01b038616600090815260026020819052604082205461077f91600160e01b90910463ffffffff90811660010116906113c2565b9350600292506108ae915050565b6001600160e01b031981167f6d43542100000000000000000000000000000000000000000000000000000000141561086157600554604080516328207dbb60e11b81526001600160a01b0389811660048301529151600093610843931691635040fb76916024808301926020929190829003018186803b15801561081057600080fd5b505afa158015610824573d6000803e3d6000fd5b505050506040513d602081101561083a57600080fd5b505160026113c2565b905060006108528260016113f0565b9450600193506108ae92505050565b6040805162461bcd60e51b815260206004820152601260248201527f524d3a20756e6b6e6f776e206d6574686f640000000000000000000000000000604482015290519081900360640190fd5b935093915050565b60045481565b60015460408051635a51fd4360e01b81526001600160a01b038086166004830152336024830152915185939290921691635a51fd4391604480820192602092909190829003018186803b15801561091257600080fd5b505afa158015610926573d6000803e3d6000fd5b505050506040513d602081101561093c57600080fd5b505161098f576040805162461bcd60e51b815260206004820152601c60248201527f42463a206d75737420626520612077616c6c6574206665617475726500000000604482015290519081900360640190fd5b600054604080517f4a4fbeec0000000000000000000000000000000000000000000000000000000081526001600160a01b038087166004830152915186939290921691634a4fbeec91602480820192602092909190829003018186803b1580156109f857600080fd5b505afa158015610a0c573d6000803e3d6000fd5b505050506040513d6020811015610a2257600080fd5b505115610a76576040805162461bcd60e51b815260206004820152601160248201527f42463a2077616c6c6574206c6f636b6564000000000000000000000000000000604482015290519081900360640190fd5b610a808484611451565b60015460408051630a669ef360e21b81526001600160a01b03878116600483015286811660248301529151919092169163299a7bcc91604480830192600092919082900301818387803b158015610ad657600080fd5b505af1158015610aea573d6000803e3d6000fd5b50506040516001600160a01b038087169350871691507f0d18b5fd22306e373229b9439188228edca81207d1667f604daf6cef8aa3ee6790600090a350505050565b6001600160a01b0390811660009081526002602052604090205490811691600160a01b820467ffffffffffffffff1691600160e01b900463ffffffff1690565b6000816001600160a01b03166370a08231306040518263ffffffff1660e01b815260040180826001600160a01b0316815260200191505060206040518083038186803b158015610bbb57600080fd5b505afa158015610bcf573d6000803e3d6000fd5b505050506040513d6020811015610be557600080fd5b5051600154604080516001600160a01b039283166024820152604480820185905282518083039091018152606490910182526020810180516001600160e01b03167fa9059cbb00000000000000000000000000000000000000000000000000000000178152915181519495509286169390929182918083835b60208310610c7d5780518252601f199092019160209182019101610c5e565b6001836020036101000a0380198251168184511680821785525050505050509050019150506000604051808303816000865af19150503d8060008114610cdf576040519150601f19603f3d011682016040523d82523d6000602084013e610ce4565b606091505b5050505050565b60015460408051635a51fd4360e01b81526001600160a01b038581166004830152848116602483015291516000939290921691635a51fd4391604480820192602092909190829003018186803b158015610d4457600080fd5b505afa158015610d58573d6000803e3d6000fd5b505050506040513d6020811015610d6e57600080fd5b505190505b92915050565b60015460408051635a51fd4360e01b81526001600160a01b038086166004830152336024830152915185939290921691635a51fd4391604480820192602092909190829003018186803b158015610dcf57600080fd5b505afa158015610de3573d6000803e3d6000fd5b505050506040513d6020811015610df957600080fd5b5051610e4c576040805162461bcd60e51b815260206004820152601c60248201527f42463a206d75737420626520612077616c6c6574206665617475726500000000604482015290519081900360640190fd5b6001600160a01b0383166000908152600260205260409020548390600160a01b900467ffffffffffffffff1615610eb45760405162461bcd60e51b81526004018080602001828103825260278152602001806115e16027913960400191505060405180910390fd5b610ebe8484611451565b6001600160a01b0380851660008181526002602090815260409182902080548886167fffffffffffffffffffffffff00000000000000000000000000000000000000009091161780825560035467ffffffffffffffff4290910116600160a01b027fffffffff0000000000000000ffffffffffffffffffffffffffffffffffffffff90911617815560055483516328207dbb60e11b81526004810195909552925190949290921692635040fb769260248083019392829003018186803b158015610f8757600080fd5b505afa158015610f9b573d6000803e3d6000fd5b505050506040513d6020811015610fb157600080fd5b5051815463ffffffff909116600160e01b026001600160e01b03909116178155600454610fe19086904201611200565b805460408051600160a01b90920467ffffffffffffffff168252516001600160a01b0386811692908816917f5f59bfd9baba55ae30bb440923cbbe30987d50e12a4e9134ffac3fd9afc3526d916020908290030190a35050505050565b60015460408051635a51fd4360e01b81526001600160a01b038085166004830152336024830152915184939290921691635a51fd4391604480820192602092909190829003018186803b15801561109457600080fd5b505afa1580156110a8573d6000803e3d6000fd5b505050506040513d60208110156110be57600080fd5b5051611111576040805162461bcd60e51b815260206004820152601c60248201527f42463a206d75737420626520612077616c6c6574206665617475726500000000604482015290519081900360640190fd5b6001600160a01b0382166000908152600260205260409020548290600160a01b900467ffffffffffffffff166111785760405162461bcd60e51b81526004018080602001828103825260258152602001806115986025913960400191505060405180910390fd5b6001600160a01b0380841660009081526002602052604081208054828255909216906111a5908690611200565b806001600160a01b0316856001600160a01b03167fc45926607303da71dbeffd2ed5c6b00f581982586b697655d19ae4c4d558f25960405160405180910390a35050505050565b6005546001600160a01b031681565b606090565b60015460008054604080516001600160a01b0387811660248084018290523060448086019190915260648086018b9052865180870382018152608496870188526020810180516001600160e01b03167f6b221d140000000000000000000000000000000000000000000000000000000017815297517fe452b7900000000000000000000000000000000000000000000000000000000081526004810195865298861693890184905260609289019283528051918901919091528051949099169863e452b790988c98939791969495929493909301929091908190849084905b838110156112f75781810151838201526020016112df565b50505050905090810190601f1680156113245780820380516001836020036101000a031916815260200191505b50945050505050600060405180830381600087803b15801561134557600080fd5b505af1158015611359573d6000803e3d6000fd5b505050505050565b60006004825110156113ba576040805162461bcd60e51b815260206004820152601a60248201527f524d3a20496e76616c69642066756e6374696f6e507265666978000000000000604482015290519081900360640190fd5b506020015190565b6000808284816113ce57fe5b0490508284816113da57fe5b066113e6579050610d73565b6001019050610d73565b60008282018381101561144a576040805162461bcd60e51b815260206004820152601b60248201527f536166654d6174683a206164646974696f6e206f766572666c6f770000000000604482015290519081900360640190fd5b9392505050565b6001600160a01b0381166114965760405162461bcd60e51b81526004018080602001828103825260248152602001806115bd6024913960400191505060405180910390fd5b600554604080517fd4ee97340000000000000000000000000000000000000000000000000000000081526001600160a01b03858116600483015284811660248301529151919092169163d4ee9734916044808301926020929190829003018186803b15801561150457600080fd5b505afa158015611518573d6000803e3d6000fd5b505050506040513d602081101561152e57600080fd5b50511561156c5760405162461bcd60e51b815260040180806020018281038252602a815260200180611608602a913960400191505060405180910390fd5b505056fe524d3a20746865207265636f7665727920706572696f64206973206e6f74206f76657220796574524d3a207468657265206d75737420626520616e206f6e676f696e67207265636f76657279524d3a206e6577206f776e657220616464726573732063616e6e6f74206265206e756c6c524d3a2074686572652063616e6e6f7420626520616e206f6e676f696e67207265636f76657279524d3a206e6577206f776e657220616464726573732063616e6e6f74206265206120677561726469616ea264697066735822122083ce219571fba08c472722a2cae64222634ae81ad954852cfebf34e2779c75ae64736f6c634300060c0033

1247:7878:9:-:0;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2012:29;;;:::i;:::-;;;;;;;;;;;;;;;;3645:60:0;;;;;;;;;;;;;;;;-1:-1:-1;3645:60:0;-1:-1:-1;;;;;3645:60:0;;:::i;:::-;;5184:501:9;;;;;;;;;;;;;;;;-1:-1:-1;5184:501:9;-1:-1:-1;;;;;5184:501:9;;:::i;7231:1253::-;;;;;;;;;;;;;;;;-1:-1:-1;;;;;7231:1253:9;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;-1:-1:-1;7231:1253:9;;-1:-1:-1;7231:1253:9;-1:-1:-1;7231:1253:9;:::i;:::-;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2066:25;;;:::i;6488:286::-;;;;;;;;;;;;;;;;-1:-1:-1;;;;;;6488:286:9;;;;;;;;;;:::i;6908:273::-;;;;;;;;;;;;;;;;-1:-1:-1;6908:273:9;-1:-1:-1;;;;;6908:273:9;;:::i;:::-;;;;-1:-1:-1;;;;;6908:273:9;;;;;;;;;;;;;;;;;;;;;;;;;;;;3181:242:0;;;;;;;;;;;;;;;;-1:-1:-1;3181:242:0;-1:-1:-1;;;;;3181:242:0;;:::i;4122:193::-;;;;;;;;;;;;;;;;-1:-1:-1;;;;;;4122:193:0;;;;;;;;;;:::i;:::-;;;;;;;;;;;;;;;;;;4401:557:9;;;;;;;;;;;;;;;;-1:-1:-1;;;;;;4401:557:9;;;;;;;;;;:::i;5896:360::-;;;;;;;;;;;;;;;;-1:-1:-1;5896:360:9;-1:-1:-1;;;;;5896:360:9;;:::i;2121:39::-;;;:::i;:::-;;;;-1:-1:-1;;;;;2121:39:9;;;;;;;;;;;;;;3972:100:0;;;:::i;:::-;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2012:29:9;;;;:::o;3645:60:0:-;;:::o;5184:501:9:-;-1:-1:-1;;;;;2775:24:9;;2815:1;2775:24;;;:15;:24;;;;;:37;:24;;-1:-1:-1;;;2775:37:9;;;;2767:91;;;;-1:-1:-1;;;2767:91:9;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;-1:-1:-1;;;;;5304:33:9;::::1;5272:29;5304:33:::0;;;:15:::1;:33;::::0;;;;5381:19;;::::1;-1:-1:-1::0;;;5381:19:9;;::::1;::::0;::::1;5362:15;5355:45:::0;;::::1;;5347:97;;;;-1:-1:-1::0;;;5347:97:9::1;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;5478:15:::0;;-1:-1:-1;;;;;5510:24:9;;::::1;5454:21;5510:24:::0;;;:15:::1;:24;::::0;;;;;5503:31;;;5478:15;5545:14;:47;;-1:-1:-1;;;5545:47:9;;::::1;::::0;::::1;::::0;;;;5478:15;;::::1;5545:47:::0;;;;;;;;5478:15;;5545:14;;::::1;::::0;:23:::1;::::0;:47;;;;;5454:21;5545:47;;;;;;5454:21;5545:14;:47;::::1;;::::0;::::1;;;;::::0;::::1;;;;;;;;;;;;::::0;::::1;;;;;;;;;5602:19;5610:7;5619:1;5602:7;:19::i;:::-;5664:13;-1:-1:-1::0;;;;;5637:41:9::1;5655:7;-1:-1:-1::0;;;;;5637:41:9::1;;;;;;;;;;;2868:1;;5184:501:::0;;:::o;7231:1253::-;7333:7;7342:14;7368:15;7386:27;7407:5;;7386:27;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;-1:-1:-1;7386:20:9;;-1:-1:-1;;;7386:27:9:i;:::-;7368:45;-1:-1:-1;;;;;;;7427:35:9;;;;7423:357;;;7501:15;;:38;;;-1:-1:-1;;;7501:38:9;;-1:-1:-1;;;;;7501:38:9;;;;;;;;;7478:20;;7501:15;;;;;:29;;:38;;;;;;;;;;;;;;;:15;:38;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;-1:-1:-1;7501:38:9;;-1:-1:-1;7561:19:9;7553:62;;;;;-1:-1:-1;;;7553:62:9;;;;;;;;;;;;;;;;;;;;;;;;;;;;7629:31;7663:30;7674:15;7691:1;7663:10;:30::i;:::-;7629:64;-1:-1:-1;7743:25:9;;-1:-1:-1;7707:62:9;;-1:-1:-1;;;7707:62:9;7423:357;-1:-1:-1;;;;;;7793:36:9;;;;7789:100;;;7853:1;7856:21;7845:33;;;;;;;7789:100;-1:-1:-1;;;;;;7902:34:9;;;;7898:230;;;-1:-1:-1;;;;;7997:24:9;;7952:31;7997:24;;;:15;:24;;;;;;;:38;7986:57;;-1:-1:-1;;;7997:38:9;;;;;;;8038:1;7997:42;7986:57;;:10;:57::i;:::-;7952:91;-1:-1:-1;8093:23:9;;-1:-1:-1;8057:60:9;;-1:-1:-1;;8057:60:9;7898:230;-1:-1:-1;;;;;;8141:37:9;;;;8137:302;;;8230:15;;:38;;;-1:-1:-1;;;8230:38:9;;-1:-1:-1;;;;;8230:38:9;;;;;;;;;8194:22;;8219:53;;8230:15;;:29;;:38;;;;;;;;;;;;;;:15;:38;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;-1:-1:-1;8230:38:9;8270:1;8219:10;:53::i;:::-;8194:78;;8286:31;8320:34;8333:17;8352:1;8320:12;:34::i;:::-;8286:68;-1:-1:-1;8404:23:9;;-1:-1:-1;8368:60:9;;-1:-1:-1;;;8368:60:9;8137:302;8449:28;;;-1:-1:-1;;;8449:28:9;;;;;;;;;;;;;;;;;;;;;;;;;;;7231:1253;;;;;;;:::o;2066:25::-;;;;:::o;6488:286::-;2421:14:0;;:55;;;-1:-1:-1;;;2421:55:0;;-1:-1:-1;;;;;2421:55:0;;;;;;;2465:10;2421:55;;;;;;6578:7:9;;2421:14:0;;;;;:34;;:55;;;;;;;;;;;;;;;:14;:55;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;-1:-1:-1;2421:55:0;2413:96;;;;;-1:-1:-1;;;2413:96:0;;;;;;;;;;;;;;;;;;;;;;;;;;;;1723:11:::1;::::0;:29:::1;::::0;;;;;-1:-1:-1;;;;;1723:29:0;;::::1;;::::0;::::1;::::0;;;6604:7:9;;1723:11:0;;;::::1;::::0;:20:::1;::::0;:29;;;;;::::1;::::0;;;;;;;;;:11;:29;::::1;;::::0;::::1;;;;::::0;::::1;;;;;;;;;;;;::::0;::::1;;;;;;;;;;;;;;;;;;;::::0;::::1;;-1:-1:-1::0;1723:29:0;1722:30:::1;1714:60;;;::::0;;-1:-1:-1;;;1714:60:0;;::::1;;::::0;::::1;::::0;::::1;::::0;;;;::::1;::::0;;;;;;;;;;;;;::::1;;6623:36:9::2;6640:7;6649:9;6623:16;:36::i;:::-;6669:14;::::0;:43:::2;::::0;;-1:-1:-1;;;6669:43:9;;-1:-1:-1;;;;;6669:43:9;;::::2;;::::0;::::2;::::0;;;::::2;::::0;;;;;;:14;;;::::2;::::0;:23:::2;::::0;:43;;;;;:14:::2;::::0;:43;;;;;;;:14;;:43;::::2;;::::0;::::2;;;;::::0;::::2;;;;;;;;;;;;::::0;::::2;;;;;-1:-1:-1::0;;6728:39:9::2;::::0;-1:-1:-1;;;;;6728:39:9;;::::2;::::0;-1:-1:-1;6728:39:9;::::2;::::0;-1:-1:-1;6728:39:9::2;::::0;;;::::2;2519:1:0::1;6488:286:9::0;;;:::o;6908:273::-;-1:-1:-1;;;;;7073:24:9;;;6968:16;7073:24;;;:15;:24;;;;;7115:15;;;;;-1:-1:-1;;;7132:19:9;;;;;-1:-1:-1;;;7153:20:9;;;;;6908:273::o;3181:242:0:-;3255:10;3274:6;-1:-1:-1;;;;;3268:23:0;;3300:4;3268:38;;;;;;;;;;;;;-1:-1:-1;;;;;3268:38:0;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;-1:-1:-1;3268:38:0;3392:14;;3328:87;;;-1:-1:-1;;;;;3392:14:0;;;3328:87;;;;;;;;;;;;;;;;;;;;;;;;;;;3268:38;3328:87;;;;-1:-1:-1;;;;;3328:87:0;3351:31;3328:87;;;3316:100;;;;3268:38;;-1:-1:-1;3316:11:0;;;;3328:87;;3316:100;;;;;3328:87;3316:100;;;;;;;;;;-1:-1:-1;;3316:100:0;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;3181:242;;:::o;4122:193::-;4255:14;;:53;;;-1:-1:-1;;;4255:53:0;;-1:-1:-1;;;;;4255:53:0;;;;;;;;;;;;;;;;4232:4;;4255:14;;;;;:34;;:53;;;;;;;;;;;;;;;:14;:53;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;-1:-1:-1;4255:53:0;;-1:-1:-1;4122:193:0;;;;;:::o;4401:557:9:-;2421:14:0;;:55;;;-1:-1:-1;;;2421:55:0;;-1:-1:-1;;;;;2421:55:0;;;;;;;2465:10;2421:55;;;;;;4489:7:9;;2421:14:0;;;;;:34;;:55;;;;;;;;;;;;;;;:14;:55;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;-1:-1:-1;2421:55:0;2413:96;;;;;-1:-1:-1;;;2413:96:0;;;;;;;;;;;;;;;;;;;;;;;;;;;;-1:-1:-1;;;;;3023:24:9;::::1;;::::0;;;:15:::1;:24;::::0;;;;:37;:24;;-1:-1:-1;;;3023:37:9;::::1;;;:42:::0;3015:94:::1;;;;-1:-1:-1::0;;;3015:94:9::1;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;4533:36:::2;4550:7;4559:9;4533:16;:36::i;:::-;-1:-1:-1::0;;;;;4611:24:9;;::::2;4579:29;4611:24:::0;;;:15:::2;:24;::::0;;;;;;;;4645:27;;;;::::2;::::0;;;::::2;;::::0;;;4729:14:::2;::::0;4682:62:::2;4711:15;:32:::0;;::::2;4682:62;-1:-1:-1::0;;;4682:62:9::2;::::0;;;::::2;;::::0;;4784:15:::2;::::0;:38;;-1:-1:-1;;;4784:38:9;;::::2;::::0;::::2;::::0;;;;;;4611:24;;4784:15;;;::::2;::::0;:29:::2;::::0;:38;;;;;4611:24;4784:38;;;;;:15;:38;::::2;;::::0;::::2;;;;::::0;::::2;;;;;;;;;;;;::::0;::::2;;;;;;;;;;;;;;;;;;;::::0;::::2;;-1:-1:-1::0;4784:38:9;4754:69;;::::2;::::0;;::::2;-1:-1:-1::0;;;4754:69:9::2;-1:-1:-1::0;;;;;4754:69:9;;::::2;;::::0;;4868:10:::2;::::0;4833:46:::2;::::0;4841:7;;4850:15:::2;:28;4833:7;:46::i;:::-;4931:19:::0;;4894:57:::2;::::0;;-1:-1:-1;;;4931:19:9;;::::2;;;4894:57:::0;;;-1:-1:-1;;;;;4894:57:9;;::::2;::::0;;;::::2;::::0;::::2;::::0;::::2;::::0;;;;;;::::2;3119:1;2519::0::1;4401:557:9::0;;;:::o;5896:360::-;2421:14:0;;:55;;;-1:-1:-1;;;2421:55:0;;-1:-1:-1;;;;;2421:55:0;;;;;;;2465:10;2421:55;;;;;;5964:7:9;;2421:14:0;;;;;:34;;:55;;;;;;;;;;;;;;;:14;:55;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;-1:-1:-1;2421:55:0;2413:96;;;;;-1:-1:-1;;;2413:96:0;;;;;;;;;;;;;;;;;;;;;;;;;;;;-1:-1:-1;;;;;2775:24:9;::::1;2815:1;2775:24:::0;;;:15:::1;:24;::::0;;;;:37;:24;;-1:-1:-1;;;2775:37:9;::::1;;;2767:91;;;;-1:-1:-1::0;;;2767:91:9::1;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;-1:-1:-1::0;;;;;6041:33:9;;::::2;6009:29;6041:33:::0;;;:15:::2;:33;::::0;;;;6108:15;;6133:31;;;6041:33;;6108:15:::2;::::0;6174:19:::2;::::0;6065:7;;6174::::2;:19::i;:::-;6235:13;-1:-1:-1::0;;;;;6209:40:9::2;6226:7;-1:-1:-1::0;;;;;6209:40:9::2;;;;;;;;;;;2868:1;;2519::0::1;5896:360:9::0;;:::o;2121:39::-;;;-1:-1:-1;;;;;2121:39:9;;:::o;3972:100:0:-;4047:21;3972:100;:::o;8841:281:9:-;8917:14;;;8988:11;;9014:91;;;-1:-1:-1;;;;;9014:91:9;;;;;;;;;;9084:4;9014:91;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;-1:-1:-1;;;;;9014:91:9;9037:28;9014:91;;;8917:198;;;;;;;;;;;8988:11;;;8917:198;;;;;;;;;;;;;;;;;;;;;;;;:14;;;;;:28;;8959:7;;8988:11;;9014:91;;8917:198;;;;;;;;;9014:91;;8917:198;;;;;9014:91;;8917:198;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;8841:281;;:::o;2155:286:11:-;2222:13;2271:1;2255:5;:12;:17;;2247:56;;;;;-1:-1:-1;;;2247:56:11;;;;;;;;;;;;;;;;;;;;;;;;;;;;-1:-1:-1;2419:4:11;2408:16;2402:23;;2378:57::o;2497:203::-;2556:7;2575:9;2591:1;2587;:5;;;;;;2575:17;;2610:1;2606;:5;;;;;;2602:92;;2639:1;-1:-1:-1;2632:8:11;;2602:92;2682:1;2678:5;;-1:-1:-1;2671:12:11;;834:176:10;892:7;923:5;;;946:6;;;;938:46;;;;;-1:-1:-1;;;938:46:10;;;;;;;;;;;;;;;;;;;;;;;;;;;;1002:1;834:176;-1:-1:-1;;;834:176:10:o;8558:277:9:-;-1:-1:-1;;;;;8652:23:9;;8644:72;;;;-1:-1:-1;;;8644:72:9;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;8735:15;;:46;;;;;;-1:-1:-1;;;;;8735:46:9;;;;;;;;;;;;;;;;:15;;;;;:26;;:46;;;;;;;;;;;;;;:15;:46;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;-1:-1:-1;8735:46:9;8734:47;8726:102;;;;-1:-1:-1;;;8726:102:9;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;8558:277;;:::o

ipfs://83ce219571fba08c472722a2cae64222634ae81ad954852cfebf34e2779c75ae