Nodes manager (#132)

* Add nodes manager

* Add validator registration and LTV management to nodes manager

* Add fund/withdraw validators and withdrawals manager to nodes manager

* Replace deposit queue with direct deposits and add oracle signatures to register validators

* Add operator state management with merkle proofs and share donations to nodes manager

* Add EthCommunityVault with locked nodesManager as fee recipient and validators manager

* Add exit queue, pending penalties, and min balance checks to nodes manager

* Refactor nodes manager tests to use EthCommunityVault

* Add nonReentrant

* Fix snapshot

* Add NodesManager and NodesManagerOracle docs

* Add unaccountedExitedAssets to SubVaultsRegistry.sol

* Convert EthCommunityVault to ERC-20 vault and refactor deposit penalty handling

* Remove unused variable

* Add EthCommunityVaultCreated event

Author: tsudmi

.env.example

@@ -24,11 +24,27 @@ REMOVE_PREV_FACTORIES=false
 #OS_TOKEN_REDEEMER_OWNER=0x2685C0e39EEAAd383fB71ec3F493991d532A87ae
 #OS_TOKEN_REDEEMER_EXIT_QUEUE_UPDATE_DELAY=43200
 #VALIDATORS_REGISTRY=0x00000000219ab540356cBB839Cbe05303d7705Fa
+#COMMUNITY_VAULT_ADMIN=0x144a98cb1CdBb23610501fE6108858D9B7D24934
+#COMMUNITY_VAULT_NAME="SW Community Staked ETH"
+#COMMUNITY_VAULT_SYMBOL=csETH
+#COMMUNITY_VAULT_FEE_PERCENT=500
+#NODES_MANAGER_OWNER=0x144a98cb1CdBb23610501fE6108858D9B7D24934
+#NODES_MANAGER_MIN_DEPOSIT_ASSETS=10000000000000000
+#NODES_MANAGER_MIN_BALANCE_PERCENT=1000
+#NODES_MANAGER_STATE_UPDATE_DELAY=86400
 
 # hoodi
 #OS_TOKEN_REDEEMER_OWNER=0xFF2B6d2d5c205b99E2e6f607B6aFA3127B9957B6
 #OS_TOKEN_REDEEMER_EXIT_QUEUE_UPDATE_DELAY=43200
 #VALIDATORS_REGISTRY=0x00000000219ab540356cBB839Cbe05303d7705Fa
+#COMMUNITY_VAULT_ADMIN=0xFF2B6d2d5c205b99E2e6f607B6aFA3127B9957B6
+#COMMUNITY_VAULT_NAME="SW Community Staked ETH"
+#COMMUNITY_VAULT_SYMBOL=csETH
+#COMMUNITY_VAULT_FEE_PERCENT=500
+#NODES_MANAGER_OWNER=0xFF2B6d2d5c205b99E2e6f607B6aFA3127B9957B6
+#NODES_MANAGER_MIN_DEPOSIT_ASSETS=10000000000000000
+#NODES_MANAGER_MIN_BALANCE_PERCENT=1000
+#NODES_MANAGER_STATE_UPDATE_DELAY=86400
 
 # chiado
 #OS_TOKEN_REDEEMER_OWNER=0xFF2B6d2d5c205b99E2e6f607B6aFA3127B9957B6

contracts/interfaces/IEthCommunityVault.sol

@@ -0,0 +1,52 @@
+// SPDX-License-Identifier: BUSL-1.1
+
+pragma solidity ^0.8.22;
+
+import {IEthErc20Vault} from "./IEthErc20Vault.sol";
+
+/**
+ * @title IEthCommunityVault
+ * @author StakeWise
+ * @notice Defines the interface for the EthCommunityVault contract
+ */
+interface IEthCommunityVault is IEthErc20Vault {
+    /**
+     * @notice Event emitted on EthCommunityVault creation
+     * @param admin The address of the Vault admin
+     * @param nodesManager The address of the nodes manager
+     * @param capacity The capacity of the Vault
+     * @param feePercent The fee percent of the Vault
+     * @param name The name of the ERC20 token
+     * @param symbol The symbol of the ERC20 token
+     * @param metadataIpfsHash The IPFS hash of the Vault metadata
+     */
+    event EthCommunityVaultCreated(
+        address admin,
+        address nodesManager,
+        uint256 capacity,
+        uint16 feePercent,
+        string name,
+        string symbol,
+        string metadataIpfsHash
+    );
+
+    /**
+     * @dev Struct for initializing the EthCommunityVault contract
+     * @param admin The address of the Vault admin
+     * @param nodesManager The address of the nodes manager (fee recipient and validators manager)
+     * @param capacity The Vault stops accepting deposits after exceeding the capacity
+     * @param feePercent The fee percent that is charged by the Vault
+     * @param name The name of the ERC20 token
+     * @param symbol The symbol of the ERC20 token
+     * @param metadataIpfsHash The IPFS hash of the Vault's metadata file
+     */
+    struct EthCommunityVaultInitParams {
+        address admin;
+        address nodesManager;
+        uint256 capacity;
+        uint16 feePercent;
+        string name;
+        string symbol;
+        string metadataIpfsHash;
+    }
+}

contracts/interfaces/IEthNodesManager.sol

@@ -0,0 +1,18 @@
+// SPDX-License-Identifier: BUSL-1.1
+
+pragma solidity ^0.8.22;
+
+import {INodesManager} from "./INodesManager.sol";
+
+/**
+ * @title IEthNodesManager
+ * @author StakeWise
+ * @notice Defines the interface for the EthNodesManager contract
+ */
+interface IEthNodesManager is INodesManager {
+    /**
+     * @notice Deposits ETH as bond assets
+     * @return shares The vault shares received for the deposit
+     */
+    function deposit() external payable returns (uint256 shares);
+}