@ensuro/access-managed-proxy 0.1.0

package/contracts/amps/AccessManagedProxyS4.sol

@@ -0,0 +1,75 @@
+// SPDX-License-Identifier: MIT
+pragma solidity ^0.8.0;
+
+import {AccessManagedProxy} from "../AccessManagedProxy.sol";
+import {IAccessManager} from "@openzeppelin/contracts/access/manager/IAccessManager.sol";
+
+/**
+ * @title AccessManagedProxyS4
+ * @notice Specialization of AccessManagedProxy with pass thru (skips AM) for some messages for gas optimization
+ *
+ * @custom:security-contact security@ensuro.co
+ * @author Ensuro
+ */
+contract AccessManagedProxyS4 is AccessManagedProxy {
+  bytes4 internal immutable PASS_THRU_METHODS_0;
+  bytes4 internal immutable PASS_THRU_METHODS_1;
+  bytes4 internal immutable PASS_THRU_METHODS_2;
+  bytes4 internal immutable PASS_THRU_METHODS_3;
+
+  /**
+   * @notice Constructor of the proxy, defining the implementation and the access manager
+   * @dev Initializes the upgradeable proxy with an initial implementation specified by `implementation` and
+   *      with `manager` as the ACCESS_MANAGER that will handle access control.
+   *
+   * @param implementation The initial implementation contract.
+   * @param _data If nonempty, it's used as data in a delegate call to `implementation`. This will typically be an
+   *              encoded function call, and allows initializing the storage of the proxy like a Solidity constructor.
+   * @param manager The access manager that will handle access control
+   * @param passThruMethods The selector of methods that will skip the access control validation, typically used for
+   *                        views and other methods for gas optimization.
+   *
+   * Requirements:
+   *
+   * - If `data` is empty, `msg.value` must be zero.
+   */
+  constructor(
+    address implementation,
+    bytes memory _data,
+    IAccessManager manager,
+    bytes4[4] memory passThruMethods
+  ) payable AccessManagedProxy(implementation, _data, manager) {
+    PASS_THRU_METHODS_0 = passThruMethods[0];
+    PASS_THRU_METHODS_1 = passThruMethods[1];
+    PASS_THRU_METHODS_2 = passThruMethods[2];
+    PASS_THRU_METHODS_3 = passThruMethods[3];
+  }
+
+  /*
+   * @notice Skips the access control if the method called is one of the passThruMethods
+   * @dev See {PASS_THRU_METHODS()}
+   * @param selector The selector of the method called
+   * @return Whether the access control using ACCESS_MANAGER should be skipped or not
+   */
+  function _skipAC(bytes4 selector) internal view override returns (bool) {
+    return
+      selector == PASS_THRU_METHODS_0 ||
+      selector == PASS_THRU_METHODS_1 ||
+      selector == PASS_THRU_METHODS_2 ||
+      selector == PASS_THRU_METHODS_3;
+  }
+
+  /**
+   * @notice Gives observability to the methods that are skipped from access control
+   * @dev This list is fixed and defined on contract construction
+   * @return methods The list of method selectors that skip ACCESS_MANAGER access control
+   */
+  // solhint-disable-next-line func-name-mixedcase
+  function PASS_THRU_METHODS() external view returns (bytes4[] memory methods) {
+    methods = new bytes4[](4);
+    methods[0] = PASS_THRU_METHODS_0;
+    methods[1] = PASS_THRU_METHODS_1;
+    methods[2] = PASS_THRU_METHODS_2;
+    methods[3] = PASS_THRU_METHODS_3;
+  }
+}

package/contracts/amps/AccessManagedProxyS5.sol

@@ -0,0 +1,79 @@
+// SPDX-License-Identifier: MIT
+pragma solidity ^0.8.0;
+
+import {AccessManagedProxy} from "../AccessManagedProxy.sol";
+import {IAccessManager} from "@openzeppelin/contracts/access/manager/IAccessManager.sol";
+
+/**
+ * @title AccessManagedProxyS5
+ * @notice Specialization of AccessManagedProxy with pass thru (skips AM) for some messages for gas optimization
+ *
+ * @custom:security-contact security@ensuro.co
+ * @author Ensuro
+ */
+contract AccessManagedProxyS5 is AccessManagedProxy {
+  bytes4 internal immutable PASS_THRU_METHODS_0;
+  bytes4 internal immutable PASS_THRU_METHODS_1;
+  bytes4 internal immutable PASS_THRU_METHODS_2;
+  bytes4 internal immutable PASS_THRU_METHODS_3;
+  bytes4 internal immutable PASS_THRU_METHODS_4;
+
+  /**
+   * @notice Constructor of the proxy, defining the implementation and the access manager
+   * @dev Initializes the upgradeable proxy with an initial implementation specified by `implementation` and
+   *      with `manager` as the ACCESS_MANAGER that will handle access control.
+   *
+   * @param implementation The initial implementation contract.
+   * @param _data If nonempty, it's used as data in a delegate call to `implementation`. This will typically be an
+   *              encoded function call, and allows initializing the storage of the proxy like a Solidity constructor.
+   * @param manager The access manager that will handle access control
+   * @param passThruMethods The selector of methods that will skip the access control validation, typically used for
+   *                        views and other methods for gas optimization.
+   *
+   * Requirements:
+   *
+   * - If `data` is empty, `msg.value` must be zero.
+   */
+  constructor(
+    address implementation,
+    bytes memory _data,
+    IAccessManager manager,
+    bytes4[5] memory passThruMethods
+  ) payable AccessManagedProxy(implementation, _data, manager) {
+    PASS_THRU_METHODS_0 = passThruMethods[0];
+    PASS_THRU_METHODS_1 = passThruMethods[1];
+    PASS_THRU_METHODS_2 = passThruMethods[2];
+    PASS_THRU_METHODS_3 = passThruMethods[3];
+    PASS_THRU_METHODS_4 = passThruMethods[4];
+  }
+
+  /*
+   * @notice Skips the access control if the method called is one of the passThruMethods
+   * @dev See {PASS_THRU_METHODS()}
+   * @param selector The selector of the method called
+   * @return Whether the access control using ACCESS_MANAGER should be skipped or not
+   */
+  function _skipAC(bytes4 selector) internal view override returns (bool) {
+    return
+      selector == PASS_THRU_METHODS_0 ||
+      selector == PASS_THRU_METHODS_1 ||
+      selector == PASS_THRU_METHODS_2 ||
+      selector == PASS_THRU_METHODS_3 ||
+      selector == PASS_THRU_METHODS_4;
+  }
+
+  /**
+   * @notice Gives observability to the methods that are skipped from access control
+   * @dev This list is fixed and defined on contract construction
+   * @return methods The list of method selectors that skip ACCESS_MANAGER access control
+   */
+  // solhint-disable-next-line func-name-mixedcase
+  function PASS_THRU_METHODS() external view returns (bytes4[] memory methods) {
+    methods = new bytes4[](5);
+    methods[0] = PASS_THRU_METHODS_0;
+    methods[1] = PASS_THRU_METHODS_1;
+    methods[2] = PASS_THRU_METHODS_2;
+    methods[3] = PASS_THRU_METHODS_3;
+    methods[4] = PASS_THRU_METHODS_4;
+  }
+}

package/contracts/amps/AccessManagedProxyS6.sol

@@ -0,0 +1,83 @@
+// SPDX-License-Identifier: MIT
+pragma solidity ^0.8.0;
+
+import {AccessManagedProxy} from "../AccessManagedProxy.sol";
+import {IAccessManager} from "@openzeppelin/contracts/access/manager/IAccessManager.sol";
+
+/**
+ * @title AccessManagedProxyS6
+ * @notice Specialization of AccessManagedProxy with pass thru (skips AM) for some messages for gas optimization
+ *
+ * @custom:security-contact security@ensuro.co
+ * @author Ensuro
+ */
+contract AccessManagedProxyS6 is AccessManagedProxy {
+  bytes4 internal immutable PASS_THRU_METHODS_0;
+  bytes4 internal immutable PASS_THRU_METHODS_1;
+  bytes4 internal immutable PASS_THRU_METHODS_2;
+  bytes4 internal immutable PASS_THRU_METHODS_3;
+  bytes4 internal immutable PASS_THRU_METHODS_4;
+  bytes4 internal immutable PASS_THRU_METHODS_5;
+
+  /**
+   * @notice Constructor of the proxy, defining the implementation and the access manager
+   * @dev Initializes the upgradeable proxy with an initial implementation specified by `implementation` and
+   *      with `manager` as the ACCESS_MANAGER that will handle access control.
+   *
+   * @param implementation The initial implementation contract.
+   * @param _data If nonempty, it's used as data in a delegate call to `implementation`. This will typically be an
+   *              encoded function call, and allows initializing the storage of the proxy like a Solidity constructor.
+   * @param manager The access manager that will handle access control
+   * @param passThruMethods The selector of methods that will skip the access control validation, typically used for
+   *                        views and other methods for gas optimization.
+   *
+   * Requirements:
+   *
+   * - If `data` is empty, `msg.value` must be zero.
+   */
+  constructor(
+    address implementation,
+    bytes memory _data,
+    IAccessManager manager,
+    bytes4[6] memory passThruMethods
+  ) payable AccessManagedProxy(implementation, _data, manager) {
+    PASS_THRU_METHODS_0 = passThruMethods[0];
+    PASS_THRU_METHODS_1 = passThruMethods[1];
+    PASS_THRU_METHODS_2 = passThruMethods[2];
+    PASS_THRU_METHODS_3 = passThruMethods[3];
+    PASS_THRU_METHODS_4 = passThruMethods[4];
+    PASS_THRU_METHODS_5 = passThruMethods[5];
+  }
+
+  /*
+   * @notice Skips the access control if the method called is one of the passThruMethods
+   * @dev See {PASS_THRU_METHODS()}
+   * @param selector The selector of the method called
+   * @return Whether the access control using ACCESS_MANAGER should be skipped or not
+   */
+  function _skipAC(bytes4 selector) internal view override returns (bool) {
+    return
+      selector == PASS_THRU_METHODS_0 ||
+      selector == PASS_THRU_METHODS_1 ||
+      selector == PASS_THRU_METHODS_2 ||
+      selector == PASS_THRU_METHODS_3 ||
+      selector == PASS_THRU_METHODS_4 ||
+      selector == PASS_THRU_METHODS_5;
+  }
+
+  /**
+   * @notice Gives observability to the methods that are skipped from access control
+   * @dev This list is fixed and defined on contract construction
+   * @return methods The list of method selectors that skip ACCESS_MANAGER access control
+   */
+  // solhint-disable-next-line func-name-mixedcase
+  function PASS_THRU_METHODS() external view returns (bytes4[] memory methods) {
+    methods = new bytes4[](6);
+    methods[0] = PASS_THRU_METHODS_0;
+    methods[1] = PASS_THRU_METHODS_1;
+    methods[2] = PASS_THRU_METHODS_2;
+    methods[3] = PASS_THRU_METHODS_3;
+    methods[4] = PASS_THRU_METHODS_4;
+    methods[5] = PASS_THRU_METHODS_5;
+  }
+}

package/contracts/amps/AccessManagedProxyS7.sol

@@ -0,0 +1,87 @@
+// SPDX-License-Identifier: MIT
+pragma solidity ^0.8.0;
+
+import {AccessManagedProxy} from "../AccessManagedProxy.sol";
+import {IAccessManager} from "@openzeppelin/contracts/access/manager/IAccessManager.sol";
+
+/**
+ * @title AccessManagedProxyS7
+ * @notice Specialization of AccessManagedProxy with pass thru (skips AM) for some messages for gas optimization
+ *
+ * @custom:security-contact security@ensuro.co
+ * @author Ensuro
+ */
+contract AccessManagedProxyS7 is AccessManagedProxy {
+  bytes4 internal immutable PASS_THRU_METHODS_0;
+  bytes4 internal immutable PASS_THRU_METHODS_1;
+  bytes4 internal immutable PASS_THRU_METHODS_2;
+  bytes4 internal immutable PASS_THRU_METHODS_3;
+  bytes4 internal immutable PASS_THRU_METHODS_4;
+  bytes4 internal immutable PASS_THRU_METHODS_5;
+  bytes4 internal immutable PASS_THRU_METHODS_6;
+
+  /**
+   * @notice Constructor of the proxy, defining the implementation and the access manager
+   * @dev Initializes the upgradeable proxy with an initial implementation specified by `implementation` and
+   *      with `manager` as the ACCESS_MANAGER that will handle access control.
+   *
+   * @param implementation The initial implementation contract.
+   * @param _data If nonempty, it's used as data in a delegate call to `implementation`. This will typically be an
+   *              encoded function call, and allows initializing the storage of the proxy like a Solidity constructor.
+   * @param manager The access manager that will handle access control
+   * @param passThruMethods The selector of methods that will skip the access control validation, typically used for
+   *                        views and other methods for gas optimization.
+   *
+   * Requirements:
+   *
+   * - If `data` is empty, `msg.value` must be zero.
+   */
+  constructor(
+    address implementation,
+    bytes memory _data,
+    IAccessManager manager,
+    bytes4[7] memory passThruMethods
+  ) payable AccessManagedProxy(implementation, _data, manager) {
+    PASS_THRU_METHODS_0 = passThruMethods[0];
+    PASS_THRU_METHODS_1 = passThruMethods[1];
+    PASS_THRU_METHODS_2 = passThruMethods[2];
+    PASS_THRU_METHODS_3 = passThruMethods[3];
+    PASS_THRU_METHODS_4 = passThruMethods[4];
+    PASS_THRU_METHODS_5 = passThruMethods[5];
+    PASS_THRU_METHODS_6 = passThruMethods[6];
+  }
+
+  /*
+   * @notice Skips the access control if the method called is one of the passThruMethods
+   * @dev See {PASS_THRU_METHODS()}
+   * @param selector The selector of the method called
+   * @return Whether the access control using ACCESS_MANAGER should be skipped or not
+   */
+  function _skipAC(bytes4 selector) internal view override returns (bool) {
+    return
+      selector == PASS_THRU_METHODS_0 ||
+      selector == PASS_THRU_METHODS_1 ||
+      selector == PASS_THRU_METHODS_2 ||
+      selector == PASS_THRU_METHODS_3 ||
+      selector == PASS_THRU_METHODS_4 ||
+      selector == PASS_THRU_METHODS_5 ||
+      selector == PASS_THRU_METHODS_6;
+  }
+
+  /**
+   * @notice Gives observability to the methods that are skipped from access control
+   * @dev This list is fixed and defined on contract construction
+   * @return methods The list of method selectors that skip ACCESS_MANAGER access control
+   */
+  // solhint-disable-next-line func-name-mixedcase
+  function PASS_THRU_METHODS() external view returns (bytes4[] memory methods) {
+    methods = new bytes4[](7);
+    methods[0] = PASS_THRU_METHODS_0;
+    methods[1] = PASS_THRU_METHODS_1;
+    methods[2] = PASS_THRU_METHODS_2;
+    methods[3] = PASS_THRU_METHODS_3;
+    methods[4] = PASS_THRU_METHODS_4;
+    methods[5] = PASS_THRU_METHODS_5;
+    methods[6] = PASS_THRU_METHODS_6;
+  }
+}

package/contracts/amps/AccessManagedProxyS8.sol

@@ -0,0 +1,91 @@
+// SPDX-License-Identifier: MIT
+pragma solidity ^0.8.0;
+
+import {AccessManagedProxy} from "../AccessManagedProxy.sol";
+import {IAccessManager} from "@openzeppelin/contracts/access/manager/IAccessManager.sol";
+
+/**
+ * @title AccessManagedProxyS8
+ * @notice Specialization of AccessManagedProxy with pass thru (skips AM) for some messages for gas optimization
+ *
+ * @custom:security-contact security@ensuro.co
+ * @author Ensuro
+ */
+contract AccessManagedProxyS8 is AccessManagedProxy {
+  bytes4 internal immutable PASS_THRU_METHODS_0;
+  bytes4 internal immutable PASS_THRU_METHODS_1;
+  bytes4 internal immutable PASS_THRU_METHODS_2;
+  bytes4 internal immutable PASS_THRU_METHODS_3;
+  bytes4 internal immutable PASS_THRU_METHODS_4;
+  bytes4 internal immutable PASS_THRU_METHODS_5;
+  bytes4 internal immutable PASS_THRU_METHODS_6;
+  bytes4 internal immutable PASS_THRU_METHODS_7;
+
+  /**
+   * @notice Constructor of the proxy, defining the implementation and the access manager
+   * @dev Initializes the upgradeable proxy with an initial implementation specified by `implementation` and
+   *      with `manager` as the ACCESS_MANAGER that will handle access control.
+   *
+   * @param implementation The initial implementation contract.
+   * @param _data If nonempty, it's used as data in a delegate call to `implementation`. This will typically be an
+   *              encoded function call, and allows initializing the storage of the proxy like a Solidity constructor.
+   * @param manager The access manager that will handle access control
+   * @param passThruMethods The selector of methods that will skip the access control validation, typically used for
+   *                        views and other methods for gas optimization.
+   *
+   * Requirements:
+   *
+   * - If `data` is empty, `msg.value` must be zero.
+   */
+  constructor(
+    address implementation,
+    bytes memory _data,
+    IAccessManager manager,
+    bytes4[8] memory passThruMethods
+  ) payable AccessManagedProxy(implementation, _data, manager) {
+    PASS_THRU_METHODS_0 = passThruMethods[0];
+    PASS_THRU_METHODS_1 = passThruMethods[1];
+    PASS_THRU_METHODS_2 = passThruMethods[2];
+    PASS_THRU_METHODS_3 = passThruMethods[3];
+    PASS_THRU_METHODS_4 = passThruMethods[4];
+    PASS_THRU_METHODS_5 = passThruMethods[5];
+    PASS_THRU_METHODS_6 = passThruMethods[6];
+    PASS_THRU_METHODS_7 = passThruMethods[7];
+  }
+
+  /*
+   * @notice Skips the access control if the method called is one of the passThruMethods
+   * @dev See {PASS_THRU_METHODS()}
+   * @param selector The selector of the method called
+   * @return Whether the access control using ACCESS_MANAGER should be skipped or not
+   */
+  function _skipAC(bytes4 selector) internal view override returns (bool) {
+    return
+      selector == PASS_THRU_METHODS_0 ||
+      selector == PASS_THRU_METHODS_1 ||
+      selector == PASS_THRU_METHODS_2 ||
+      selector == PASS_THRU_METHODS_3 ||
+      selector == PASS_THRU_METHODS_4 ||
+      selector == PASS_THRU_METHODS_5 ||
+      selector == PASS_THRU_METHODS_6 ||
+      selector == PASS_THRU_METHODS_7;
+  }
+
+  /**
+   * @notice Gives observability to the methods that are skipped from access control
+   * @dev This list is fixed and defined on contract construction
+   * @return methods The list of method selectors that skip ACCESS_MANAGER access control
+   */
+  // solhint-disable-next-line func-name-mixedcase
+  function PASS_THRU_METHODS() external view returns (bytes4[] memory methods) {
+    methods = new bytes4[](8);
+    methods[0] = PASS_THRU_METHODS_0;
+    methods[1] = PASS_THRU_METHODS_1;
+    methods[2] = PASS_THRU_METHODS_2;
+    methods[3] = PASS_THRU_METHODS_3;
+    methods[4] = PASS_THRU_METHODS_4;
+    methods[5] = PASS_THRU_METHODS_5;
+    methods[6] = PASS_THRU_METHODS_6;
+    methods[7] = PASS_THRU_METHODS_7;
+  }
+}

package/contracts/amps/AccessManagedProxyS9.sol

@@ -0,0 +1,95 @@
+// SPDX-License-Identifier: MIT
+pragma solidity ^0.8.0;
+
+import {AccessManagedProxy} from "../AccessManagedProxy.sol";
+import {IAccessManager} from "@openzeppelin/contracts/access/manager/IAccessManager.sol";
+
+/**
+ * @title AccessManagedProxyS9
+ * @notice Specialization of AccessManagedProxy with pass thru (skips AM) for some messages for gas optimization
+ *
+ * @custom:security-contact security@ensuro.co
+ * @author Ensuro
+ */
+contract AccessManagedProxyS9 is AccessManagedProxy {
+  bytes4 internal immutable PASS_THRU_METHODS_0;
+  bytes4 internal immutable PASS_THRU_METHODS_1;
+  bytes4 internal immutable PASS_THRU_METHODS_2;
+  bytes4 internal immutable PASS_THRU_METHODS_3;
+  bytes4 internal immutable PASS_THRU_METHODS_4;
+  bytes4 internal immutable PASS_THRU_METHODS_5;
+  bytes4 internal immutable PASS_THRU_METHODS_6;
+  bytes4 internal immutable PASS_THRU_METHODS_7;
+  bytes4 internal immutable PASS_THRU_METHODS_8;
+
+  /**
+   * @notice Constructor of the proxy, defining the implementation and the access manager
+   * @dev Initializes the upgradeable proxy with an initial implementation specified by `implementation` and
+   *      with `manager` as the ACCESS_MANAGER that will handle access control.
+   *
+   * @param implementation The initial implementation contract.
+   * @param _data If nonempty, it's used as data in a delegate call to `implementation`. This will typically be an
+   *              encoded function call, and allows initializing the storage of the proxy like a Solidity constructor.
+   * @param manager The access manager that will handle access control
+   * @param passThruMethods The selector of methods that will skip the access control validation, typically used for
+   *                        views and other methods for gas optimization.
+   *
+   * Requirements:
+   *
+   * - If `data` is empty, `msg.value` must be zero.
+   */
+  constructor(
+    address implementation,
+    bytes memory _data,
+    IAccessManager manager,
+    bytes4[9] memory passThruMethods
+  ) payable AccessManagedProxy(implementation, _data, manager) {
+    PASS_THRU_METHODS_0 = passThruMethods[0];
+    PASS_THRU_METHODS_1 = passThruMethods[1];
+    PASS_THRU_METHODS_2 = passThruMethods[2];
+    PASS_THRU_METHODS_3 = passThruMethods[3];
+    PASS_THRU_METHODS_4 = passThruMethods[4];
+    PASS_THRU_METHODS_5 = passThruMethods[5];
+    PASS_THRU_METHODS_6 = passThruMethods[6];
+    PASS_THRU_METHODS_7 = passThruMethods[7];
+    PASS_THRU_METHODS_8 = passThruMethods[8];
+  }
+
+  /*
+   * @notice Skips the access control if the method called is one of the passThruMethods
+   * @dev See {PASS_THRU_METHODS()}
+   * @param selector The selector of the method called
+   * @return Whether the access control using ACCESS_MANAGER should be skipped or not
+   */
+  function _skipAC(bytes4 selector) internal view override returns (bool) {
+    return
+      selector == PASS_THRU_METHODS_0 ||
+      selector == PASS_THRU_METHODS_1 ||
+      selector == PASS_THRU_METHODS_2 ||
+      selector == PASS_THRU_METHODS_3 ||
+      selector == PASS_THRU_METHODS_4 ||
+      selector == PASS_THRU_METHODS_5 ||
+      selector == PASS_THRU_METHODS_6 ||
+      selector == PASS_THRU_METHODS_7 ||
+      selector == PASS_THRU_METHODS_8;
+  }
+
+  /**
+   * @notice Gives observability to the methods that are skipped from access control
+   * @dev This list is fixed and defined on contract construction
+   * @return methods The list of method selectors that skip ACCESS_MANAGER access control
+   */
+  // solhint-disable-next-line func-name-mixedcase
+  function PASS_THRU_METHODS() external view returns (bytes4[] memory methods) {
+    methods = new bytes4[](9);
+    methods[0] = PASS_THRU_METHODS_0;
+    methods[1] = PASS_THRU_METHODS_1;
+    methods[2] = PASS_THRU_METHODS_2;
+    methods[3] = PASS_THRU_METHODS_3;
+    methods[4] = PASS_THRU_METHODS_4;
+    methods[5] = PASS_THRU_METHODS_5;
+    methods[6] = PASS_THRU_METHODS_6;
+    methods[7] = PASS_THRU_METHODS_7;
+    methods[8] = PASS_THRU_METHODS_8;
+  }
+}

package/contracts/mock/DummyImplementation.sol

@@ -0,0 +1,53 @@
+// SPDX-License-Identifier: Apache-2.0
+pragma solidity ^0.8.16;
+
+import {UUPSUpgradeable} from "@openzeppelin/contracts-upgradeable/proxy/utils/UUPSUpgradeable.sol";
+
+/**
+ * @title Dummy implementation contract that supports upgrade and logs methods called
+ *
+ * @custom:security-contact security@ensuro.co
+ * @author Ensuro
+ */
+contract DummyImplementation is UUPSUpgradeable {
+  event MethodCalled(bytes4 selector);
+
+  /// @custom:oz-upgrades-unsafe-allow constructor
+  constructor() {
+    _disableInitializers();
+  }
+
+  function initialize() public virtual initializer {}
+
+  /// @inheritdoc UUPSUpgradeable
+  function _authorizeUpgrade(address newImplementation) internal override {}
+
+  // For making gas usage comparisons easier, I'm going to use different methods for each variant
+  function callThruAMP() external {
+    emit MethodCalled(this.callThruAMP.selector);
+  }
+
+  function callThru1967() external {
+    emit MethodCalled(this.callThru1967.selector);
+  }
+
+  function callDirect() external {
+    emit MethodCalled(this.callDirect.selector);
+  }
+
+  function callThruAMPSkippedMethod() external {
+    emit MethodCalled(this.callThruAMPSkippedMethod.selector);
+  }
+
+  function callThruAMPNonSkippedMethod() external {
+    emit MethodCalled(this.callThruAMPNonSkippedMethod.selector);
+  }
+
+  function viewMethod() external view returns (address) {
+    return msg.sender;
+  }
+
+  function pureMethod() external pure returns (uint256) {
+    return 123456;
+  }
+}

package/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "@ensuro/access-managed-proxy",
+  "description": "Variant of ERC-1967 proxy with built-in access control using OZ 5.x AccessManager",
+  "version": "0.1.0",
+  "files": [
+    "**/*.sol",
+    "/build",
+    "/js/*.js"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git@github.com:ensuro/access-managed-proxy.git"
+  },
+  "keywords": [
+    "solidity",
+    "ethereum",
+    "smart",
+    "contracts",
+    "decentralized",
+    "erc1967"
+  ],
+  "author": "Ensuro <guillermo@ensuro.co>",
+  "license": "Apache-2.0",
+  "bugs": {
+    "url": "https://github.com/ensuro/access-managed-proxy/issues"
+  },
+  "homepage": "https://github.com/ensuro/access-managed-proxy#readme"
+}