@evvm/testnet-contracts 2.1.3 → 2.2.1

package/contracts/staking/Staking.sol

@@ -41,99 +41,15 @@ pragma solidity ^0.8.0;
  * - Estimator integration for yield calculations
  */
 
-import {Evvm} from "@evvm/testnet-contracts/contracts/evvm/Evvm.sol";
-import {NameService} from "@evvm/testnet-contracts/contracts/nameService/NameService.sol";
-import {Estimator} from "@evvm/testnet-contracts/contracts/staking/Estimator.sol";
-import {ErrorsLib} from "@evvm/testnet-contracts/contracts/staking/lib/ErrorsLib.sol";
-import {SignatureUtils} from "@evvm/testnet-contracts/contracts/staking/lib/SignatureUtils.sol";
+import {IEvvm} from "@evvm/testnet-contracts/interfaces/IEvvm.sol";
+import {IEstimator} from "@evvm/testnet-contracts/interfaces/IEstimator.sol";
+import {AsyncNonce} from "@evvm/testnet-contracts/library/utils/nonces/AsyncNonce.sol";
+import {StakingStructs} from "@evvm/testnet-contracts/contracts/staking/lib/StakingStructs.sol";
+import {ErrorsLib} from "./lib/ErrorsLib.sol";
+import {SignatureUtils} from "./lib/SignatureUtils.sol";
 
-contract Staking {
-    /**
-     * @dev Metadata for presale stakers
-     * @param isAllow Whether the address is allowed to participate in presale staking
-     * @param stakingAmount Current number of staking tokens staked (max 2 for presale)
-     */
-    struct presaleStakerMetadata {
-        bool isAllow;
-        uint256 stakingAmount;
-    }
-
-    /**
-     * @dev Struct to store the history of the user
-     * @param transactionType Type of transaction:
-     *          - 0x01 for staking
-     *          - 0x02 for unstaking
-     *          - Other values for yield/reward transactions
-     * @param amount Amount of staking staked/unstaked or reward received
-     * @param timestamp Timestamp when the transaction occurred
-     * @param totalStaked Total amount of staking currently staked after this transaction
-     */
-    struct HistoryMetadata {
-        bytes32 transactionType;
-        uint256 amount;
-        uint256 timestamp;
-        uint256 totalStaked;
-    }
-
-    /**
-     * @dev Struct for managing address change proposals with time delay
-     * @param actual Current active address
-     * @param proposal Proposed new address
-     * @param timeToAccept Timestamp when the proposal can be accepted
-     */
-    struct AddressTypeProposal {
-        address actual;
-        address proposal;
-        uint256 timeToAccept;
-    }
-
-    /**
-     * @dev Struct for managing uint256 change proposals with time delay
-     * @param actual Current active value
-     * @param proposal Proposed new value
-     * @param timeToAccept Timestamp when the proposal can be accepted
-     */
-    struct UintTypeProposal {
-        uint256 actual;
-        uint256 proposal;
-        uint256 timeToAccept;
-    }
-
-    /**
-     * @dev Struct for managing boolean flag changes with time delay
-     * @param flag Current boolean state
-     * @param timeToAccept Timestamp when the flag change can be executed
-     */
-    struct BoolTypeProposal {
-        bool flag;
-        uint256 timeToAccept;
-    }
-
-    /**
-     * @dev Struct to store service staking metadata during the staking process
-     * @param service Address of the service or contract account
-     * @param timestamp Timestamp when the prepareServiceStaking was called
-     * @param amountOfStaking Amount of staking tokens to be staked
-     * @param amountServiceBeforeStaking Service's Principal Token balance before staking
-     * @param amountStakingBeforeStaking Staking contract's Principal Token balance before staking
-     */
-    struct ServiceStakingMetadata {
-        address service;
-        uint256 timestamp;
-        uint256 amountOfStaking;
-        uint256 amountServiceBeforeStaking;
-        uint256 amountStakingBeforeStaking;
-    }
-
-    /**
-     * @dev Struct to encapsulate account metadata for staking operations
-     * @param Address Address of the account
-     * @param IsAService Boolean indicating if the account is a smart contract (service) account
-     */
-    struct AccountMetadata {
-        address Address;
-        bool IsAService;
-    }
+contract Staking is AsyncNonce, StakingStructs {
+    uint256 constant TIME_TO_ACCEPT_PROPOSAL = 1 days;
 
     /// @dev Address of the EVVM core contract
     address private EVVM_ADDRESS;
@@ -154,7 +70,7 @@ contract Staking {
     /// @dev Golden Fisher address management with proposal system
     AddressTypeProposal private goldenFisher;
     /// @dev Estimator contract address management with proposal system
-    AddressTypeProposal private estimator;
+    AddressTypeProposal private estimatorAddress;
     /// @dev Time delay for regular staking after unstaking
     UintTypeProposal private secondsToUnlockStaking;
     /// @dev Time delay for full unstaking (21 days default)
@@ -169,15 +85,15 @@ contract Staking {
     /// @dev One-time setup breaker for estimator and EVVM addresses
     bytes1 private breakerSetupEstimatorAndEvvm;
 
-    /// @dev Mapping to track used nonces for staking operations per user
-    mapping(address => mapping(uint256 => bool)) private stakingNonce;
-
     /// @dev Mapping to store presale staker metadata
     mapping(address => presaleStakerMetadata) private userPresaleStaker;
 
     /// @dev Mapping to store complete staking history for each user
     mapping(address => HistoryMetadata[]) private userHistory;
 
+    IEvvm private evvm;
+    IEstimator private estimator;
+
     /// @dev Modifier to verify access to admin functions
     modifier onlyOwner() {
         if (msg.sender != admin.actual) revert ErrorsLib.SenderIsNotAdmin();
@@ -211,12 +127,12 @@ contract Staking {
 
         goldenFisher.actual = initialGoldenFisher;
 
-        allowPublicStaking.flag = true;
-        allowPresaleStaking.flag = false;
+        allowPublicStaking.flag = false;
+        allowPresaleStaking.flag = true;
 
         secondsToUnlockStaking.actual = 0;
 
-        secondsToUnllockFullUnstaking.actual = 30 seconds;
+        secondsToUnllockFullUnstaking.actual = 5 days;
 
         breakerSetupEstimatorAndEvvm = 0x01;
     }
@@ -233,9 +149,11 @@ contract Staking {
     ) external {
         if (breakerSetupEstimatorAndEvvm == 0x00) revert();
 
-        estimator.actual = _estimator;
+        estimatorAddress.actual = _estimator;
         EVVM_ADDRESS = _evvm;
         breakerSetupEstimatorAndEvvm = 0x00;
+        evvm = IEvvm(_evvm);
+        estimator = IEstimator(_estimator);
     }
 
     /**
@@ -258,7 +176,7 @@ contract Staking {
             isStaking,
             amountOfStaking,
             0,
-            Evvm(EVVM_ADDRESS).getNextCurrentSyncNonce(msg.sender),
+            evvm.getNextCurrentSyncNonce(msg.sender),
             false,
             signature_EVVM
         );
@@ -288,7 +206,7 @@ contract Staking {
     ) external {
         if (
             !SignatureUtils.verifyMessageSignedForStake(
-                Evvm(EVVM_ADDRESS).getEvvmID(),
+                evvm.getEvvmID(),
                 user,
                 false,
                 isStaking,
@@ -298,8 +216,7 @@ contract Staking {
             )
         ) revert ErrorsLib.InvalidSignatureOnStaking();
 
-        if (checkIfStakeNonceUsed(user, nonce))
-            revert ErrorsLib.StakingNonceAlreadyUsed();
+        verifyAsyncNonce(user, nonce);
 
         presaleClaims(isStaking, user);
 
@@ -316,7 +233,7 @@ contract Staking {
             signature_EVVM
         );
 
-        stakingNonce[user][nonce] = true;
+        markAsyncNonceAsUsed(user, nonce);
     }
 
     /**
@@ -381,7 +298,7 @@ contract Staking {
 
         if (
             !SignatureUtils.verifyMessageSignedForStake(
-                Evvm(EVVM_ADDRESS).getEvvmID(),
+                evvm.getEvvmID(),
                 user,
                 true,
                 isStaking,
@@ -391,8 +308,7 @@ contract Staking {
             )
         ) revert ErrorsLib.InvalidSignatureOnStaking();
 
-        if (checkIfStakeNonceUsed(user, nonce))
-            revert ErrorsLib.StakingNonceAlreadyUsed();
+        verifyAsyncNonce(user, nonce);
 
         stakingBaseProcess(
             AccountMetadata({Address: user, IsAService: false}),
@@ -404,19 +320,19 @@ contract Staking {
             signature_EVVM
         );
 
-        stakingNonce[user][nonce] = true;
+        markAsyncNonceAsUsed(user, nonce);
     }
 
     /**
      * @notice Prepares a service/contract account for staking by recording pre-staking state
      * @dev First step in the service staking process. Must be followed by payment via caPay and confirmServiceStaking in the same transaction
      * @param amountOfStaking Amount of staking tokens the service intends to stake
-     * 
+     *
      * Service Staking Process:
      * 1. Call prepareServiceStaking(amount) - Records balances and metadata
-     * 2. Use EVVM.caPay() to transfer the required Principal Tokens to this contract  
+     * 2. Use EVVM.caPay() to transfer the required Principal Tokens to this contract
      * 3. Call confirmServiceStaking() - Validates payment and completes staking
-     * 
+     *
      * @dev All three steps MUST occur in the same transaction or the staking will fail
      * @dev CRITICAL WARNING: If the process is not completed properly (especially if caPay is called
      *      but confirmServiceStaking is not), the Principal Tokens will remain locked in the staking
@@ -428,11 +344,11 @@ contract Staking {
             service: msg.sender,
             timestamp: block.timestamp,
             amountOfStaking: amountOfStaking,
-            amountServiceBeforeStaking: Evvm(EVVM_ADDRESS).getBalance(
+            amountServiceBeforeStaking: evvm.getBalance(
                 msg.sender,
                 PRINCIPAL_TOKEN_ADDRESS
             ),
-            amountStakingBeforeStaking: Evvm(EVVM_ADDRESS).getBalance(
+            amountStakingBeforeStaking: evvm.getBalance(
                 address(this),
                 PRINCIPAL_TOKEN_ADDRESS
             )
@@ -442,13 +358,13 @@ contract Staking {
     /**
      * @notice Confirms and completes the service staking operation after payment verification
      * @dev Final step in service staking. Validates that payment was made correctly and completes the staking process
-     * 
+     *
      * Validation checks:
      * - Service balance decreased by the exact staking cost
-     * - Staking contract balance increased by the exact staking cost  
+     * - Staking contract balance increased by the exact staking cost
      * - Operation occurs in the same transaction as prepareServiceStaking
      * - Caller matches the service that initiated the preparation
-     * 
+     *
      * @dev Only callable by the same contract that called prepareServiceStaking
      * @dev Must be called in the same transaction as prepareServiceStaking
      */
@@ -456,12 +372,12 @@ contract Staking {
         uint256 totalStakingRequired = PRICE_OF_STAKING *
             serviceStakingData.amountOfStaking;
 
-        uint256 actualServiceBalance = Evvm(EVVM_ADDRESS).getBalance(
+        uint256 actualServiceBalance = evvm.getBalance(
             msg.sender,
             PRINCIPAL_TOKEN_ADDRESS
         );
 
-        uint256 actualStakingBalance = Evvm(EVVM_ADDRESS).getBalance(
+        uint256 actualStakingBalance = evvm.getBalance(
             address(this),
             PRINCIPAL_TOKEN_ADDRESS
         );
@@ -499,7 +415,7 @@ contract Staking {
      * @notice Allows a service/contract account to unstake their staking tokens
      * @dev Simplified unstaking process for services - no signature or payment required, just direct unstaking
      * @param amountOfStaking Amount of staking tokens to unstake
-     * 
+     *
      * @dev The service will receive Principal Tokens equal to: amountOfStaking * PRICE_OF_STAKING
      * @dev Subject to the same time locks as regular unstaking (21 days for full unstake)
      * @dev Only callable by contract accounts (services), not EOAs
@@ -556,7 +472,7 @@ contract Staking {
                     signature_EVVM
                 );
 
-            Evvm(EVVM_ADDRESS).pointStaker(account.Address, 0x01);
+            evvm.pointStaker(account.Address, 0x01);
 
             auxSMsteBalance = userHistory[account.Address].length == 0
                 ? amountOfStaking
@@ -570,7 +486,7 @@ contract Staking {
                     block.timestamp
                 ) revert ErrorsLib.AddressMustWaitToFullUnstake();
 
-                Evvm(EVVM_ADDRESS).pointStaker(account.Address, 0x00);
+                evvm.pointStaker(account.Address, 0x00);
             }
 
             if (priorityFee_EVVM != 0 && !account.IsAService)
@@ -608,13 +524,13 @@ contract Staking {
         );
 
         if (
-            Evvm(EVVM_ADDRESS).isAddressStaker(msg.sender) &&
+            evvm.isAddressStaker(msg.sender) &&
             !account.IsAService
         ) {
             makeCaPay(
                 PRINCIPAL_TOKEN_ADDRESS,
                 msg.sender,
-                (Evvm(EVVM_ADDRESS).getRewardAmount() * 2) + priorityFee_EVVM
+                (evvm.getRewardAmount() * 2) + priorityFee_EVVM
             );
         }
     }
@@ -648,7 +564,7 @@ contract Staking {
                 amountTotalToBeRewarded,
                 idToOverwriteUserHistory,
                 timestampToBeOverwritten
-            ) = Estimator(estimator.actual).makeEstimation(user);
+            ) = estimator.makeEstimation(user);
 
             if (amountTotalToBeRewarded > 0) {
                 makeCaPay(tokenToBeRewarded, user, amountTotalToBeRewarded);
@@ -660,11 +576,11 @@ contract Staking {
                 userHistory[user][idToOverwriteUserHistory]
                     .timestamp = timestampToBeOverwritten;
 
-                if (Evvm(EVVM_ADDRESS).isAddressStaker(msg.sender)) {
+                if (evvm.isAddressStaker(msg.sender)) {
                     makeCaPay(
                         PRINCIPAL_TOKEN_ADDRESS,
                         msg.sender,
-                        (Evvm(EVVM_ADDRESS).getRewardAmount() * 1)
+                        (evvm.getRewardAmount() * 1)
                     );
                 }
             }
@@ -693,7 +609,7 @@ contract Staking {
         uint256 nonce,
         bytes memory signature
     ) internal {
-        Evvm(EVVM_ADDRESS).pay(
+        evvm.pay(
             user,
             address(this),
             "",
@@ -719,7 +635,7 @@ contract Staking {
         address user,
         uint256 amount
     ) internal {
-        Evvm(EVVM_ADDRESS).caPay(user, tokenAddress, amount);
+        evvm.caPay(user, tokenAddress, amount);
     }
 
     //▄▀▄▀▄▀▄▀▄▀▄▀▄▀▄▀▄▀▄▀▄▀▄▀▄▀▄▀▄▀▄▀▄▀▄▀▄▀▄▀▄▀▄▀▄▀▄▀▄▀▄▀▄▀▄▀▄▀▄▀▄▀▄▀▄▀▄▀▄▀▄▀▄▀
@@ -761,7 +677,7 @@ contract Staking {
      */
     function proposeAdmin(address _newAdmin) external onlyOwner {
         admin.proposal = _newAdmin;
-        admin.timeToAccept = block.timestamp + 1 minutes;
+        admin.timeToAccept = block.timestamp + TIME_TO_ACCEPT_PROPOSAL;
     }
 
     /**
@@ -795,7 +711,7 @@ contract Staking {
      */
     function proposeGoldenFisher(address _goldenFisher) external onlyOwner {
         goldenFisher.proposal = _goldenFisher;
-        goldenFisher.timeToAccept = block.timestamp + 1 minutes;
+        goldenFisher.timeToAccept = block.timestamp + TIME_TO_ACCEPT_PROPOSAL;
     }
 
     /**
@@ -829,7 +745,9 @@ contract Staking {
         uint256 _secondsToUnlockStaking
     ) external onlyOwner {
         secondsToUnlockStaking.proposal = _secondsToUnlockStaking;
-        secondsToUnlockStaking.timeToAccept = block.timestamp + 1 minutes;
+        secondsToUnlockStaking.timeToAccept =
+            block.timestamp +
+            TIME_TO_ACCEPT_PROPOSAL;
     }
 
     /**
@@ -863,7 +781,9 @@ contract Staking {
         uint256 _secondsToUnllockFullUnstaking
     ) external onlyOwner {
         secondsToUnllockFullUnstaking.proposal = _secondsToUnllockFullUnstaking;
-        secondsToUnllockFullUnstaking.timeToAccept = block.timestamp + 1 minutes;
+        secondsToUnllockFullUnstaking.timeToAccept =
+            block.timestamp +
+            TIME_TO_ACCEPT_PROPOSAL;
     }
 
     /**
@@ -894,7 +814,9 @@ contract Staking {
      * @dev Initiates the time-delayed process to enable/disable public staking
      */
     function prepareChangeAllowPublicStaking() external onlyOwner {
-        allowPublicStaking.timeToAccept = block.timestamp + 1 minutes;
+        allowPublicStaking.timeToAccept =
+            block.timestamp +
+            TIME_TO_ACCEPT_PROPOSAL;
     }
 
     /**
@@ -924,7 +846,9 @@ contract Staking {
      * @dev Initiates the time-delayed process to enable/disable presale staking
      */
     function prepareChangeAllowPresaleStaking() external onlyOwner {
-        allowPresaleStaking.timeToAccept = block.timestamp + 1 minutes;
+        allowPresaleStaking.timeToAccept =
+            block.timestamp +
+            TIME_TO_ACCEPT_PROPOSAL;
     }
 
     /**
@@ -955,8 +879,8 @@ contract Staking {
      * @param _estimator Address of the proposed new estimator contract
      */
     function proposeEstimator(address _estimator) external onlyOwner {
-        estimator.proposal = _estimator;
-        estimator.timeToAccept = block.timestamp + 1 minutes;
+        estimatorAddress.proposal = _estimator;
+        estimatorAddress.timeToAccept = block.timestamp + TIME_TO_ACCEPT_PROPOSAL;
     }
 
     /**
@@ -964,8 +888,8 @@ contract Staking {
      * @dev Only current admin can reject the pending estimator contract proposal
      */
     function rejectProposalEstimator() external onlyOwner {
-        estimator.proposal = address(0);
-        estimator.timeToAccept = 0;
+        estimatorAddress.proposal = address(0);
+        estimatorAddress.timeToAccept = 0;
     }
 
     /**
@@ -973,12 +897,13 @@ contract Staking {
      * @dev Can only be called by the current admin after the 1-day time delay
      */
     function acceptNewEstimator() external onlyOwner {
-        if (estimator.timeToAccept > block.timestamp) {
+        if (estimatorAddress.timeToAccept > block.timestamp) {
             revert();
         }
-        estimator.actual = estimator.proposal;
-        estimator.proposal = address(0);
-        estimator.timeToAccept = 0;
+        estimatorAddress.actual = estimatorAddress.proposal;
+        estimatorAddress.proposal = address(0);
+        estimatorAddress.timeToAccept = 0;
+        estimator = IEstimator(estimatorAddress.actual);
     }
 
     //▄▀▄▀▄▀▄▀▄▀▄▀▄▀▄▀▄▀▄▀▄▀▄▀▄▀▄▀▄▀▄▀▄▀▄▀▄▀▄▀▄▀▄▀▄▀▄▀▄▀▄▀▄▀▄▀▄▀▄▀▄▀▄▀▄▀▄▀▄▀▄▀▄▀
@@ -1113,20 +1038,6 @@ contract Staking {
         return userHistory[_account][lengthOfHistory - 1].totalStaked;
     }
 
-    /**
-     * @notice Checks if a specific nonce has been used for staking by a user
-     * @dev Prevents replay attacks by tracking used nonces
-     * @param _account Address to check the nonce for
-     * @param _nonce Nonce value to check
-     * @return True if the nonce has been used, false otherwise
-     */
-    function checkIfStakeNonceUsed(
-        address _account,
-        uint256 _nonce
-    ) public view returns (bool) {
-        return stakingNonce[_account][_nonce];
-    }
-
     /**
      * @notice Returns the current golden fisher address
      * @dev The golden fisher has special staking privileges
@@ -1167,7 +1078,7 @@ contract Staking {
      * @return Address of the current estimator contract
      */
     function getEstimatorAddress() external view returns (address) {
-        return estimator.actual;
+        return estimatorAddress.actual;
     }
 
     /**
@@ -1176,7 +1087,7 @@ contract Staking {
      * @return Address of the proposed estimator contract (zero address if none)
      */
     function getEstimatorProposal() external view returns (address) {
-        return estimator.proposal;
+        return estimatorAddress.proposal;
     }
 
     /**

package/contracts/staking/lib/ErrorsLib.sol

@@ -20,4 +20,3 @@ library ErrorsLib {
     error ServiceDoesNotStakeInSameTx();
     error AddressMismatch();
 }
-

package/contracts/staking/lib/SignatureUtils.sol

@@ -1,12 +1,10 @@
 // SPDX-License-Identifier: EVVM-NONCOMMERCIAL-1.0
 // Full license terms available at: https://www.evvm.info/docs/EVVMNoncommercialLicense
-
-import {SignatureRecover} from "@evvm/testnet-contracts/library/SignatureRecover.sol";
-import {AdvancedStrings} from "@evvm/testnet-contracts/library/AdvancedStrings.sol";
-import {Strings} from "@openzeppelin/contracts/utils/Strings.sol";
-
 pragma solidity ^0.8.0;
 
+import {SignatureUtil} from "@evvm/testnet-contracts/library/utils/SignatureUtil.sol";
+import {AdvancedStrings} from "@evvm/testnet-contracts/library/utils/AdvancedStrings.sol";
+
 library SignatureUtils {
     /**
      *  @dev using EIP-191 (https://eips.ethereum.org/EIPS/eip-191) can be used to sign and
@@ -24,42 +22,15 @@ library SignatureUtils {
         bytes memory signature
     ) internal pure returns (bool) {
         return
-            SignatureRecover.signatureVerification(
-                Strings.toString(evvmID),
+            SignatureUtil.verifySignature(
+                evvmID,
                 isExternalStaking ? "publicStaking" : "presaleStaking",
                 string.concat(
                     _isStaking ? "true" : "false",
                     ",",
-                    Strings.toString(_amountOfStaking),
-                    ",",
-                    Strings.toString(_nonce)
-                ),
-                signature,
-                user
-            );
-    }
-
-    function verifyMessageSignedForPublicServiceStake(
-        uint256 evvmID,
-        address user,
-        address serviceAddress,
-        bool _isStaking,
-        uint256 _amountOfStaking,
-        uint256 _nonce,
-        bytes memory signature
-    ) internal pure returns (bool) {
-        return
-            SignatureRecover.signatureVerification(
-                Strings.toString(evvmID),
-                "publicServiceStaking",
-                string.concat(
-                    AdvancedStrings.addressToString(serviceAddress),
-                    ",",
-                    _isStaking ? "true" : "false",
-                    ",",
-                    Strings.toString(_amountOfStaking),
+                    AdvancedStrings.uintToString(_amountOfStaking),
                     ",",
-                    Strings.toString(_nonce)
+                    AdvancedStrings.uintToString(_nonce)
                 ),
                 signature,
                 user

package/contracts/staking/lib/StakingStructs.sol

@@ -0,0 +1,94 @@
+// SPDX-License-Identifier: EVVM-NONCOMMERCIAL-1.0
+// Full license terms available at: https://www.evvm.info/docs/EVVMNoncommercialLicense
+
+pragma solidity ^0.8.0;
+
+abstract contract StakingStructs {
+    /**
+     * @dev Metadata for presale stakers
+     * @param isAllow Whether the address is allowed to participate in presale staking
+     * @param stakingAmount Current number of staking tokens staked (max 2 for presale)
+     */
+    struct presaleStakerMetadata {
+        bool isAllow;
+        uint256 stakingAmount;
+    }
+
+    /**
+     * @dev Struct to store the history of the user
+     * @param transactionType Type of transaction:
+     *          - 0x01 for staking
+     *          - 0x02 for unstaking
+     *          - Other values for yield/reward transactions
+     * @param amount Amount of staking staked/unstaked or reward received
+     * @param timestamp Timestamp when the transaction occurred
+     * @param totalStaked Total amount of staking currently staked after this transaction
+     */
+    struct HistoryMetadata {
+        bytes32 transactionType;
+        uint256 amount;
+        uint256 timestamp;
+        uint256 totalStaked;
+    }
+
+    /**
+     * @dev Struct for managing address change proposals with time delay
+     * @param actual Current active address
+     * @param proposal Proposed new address
+     * @param timeToAccept Timestamp when the proposal can be accepted
+     */
+    struct AddressTypeProposal {
+        address actual;
+        address proposal;
+        uint256 timeToAccept;
+    }
+
+    /**
+     * @dev Struct for managing uint256 change proposals with time delay
+     * @param actual Current active value
+     * @param proposal Proposed new value
+     * @param timeToAccept Timestamp when the proposal can be accepted
+     */
+    struct UintTypeProposal {
+        uint256 actual;
+        uint256 proposal;
+        uint256 timeToAccept;
+    }
+
+    /**
+     * @dev Struct for managing boolean flag changes with time delay
+     * @param flag Current boolean state
+     * @param timeToAccept Timestamp when the flag change can be executed
+     */
+    struct BoolTypeProposal {
+        bool flag;
+        uint256 timeToAccept;
+    }
+
+    /**
+     * @dev Struct to store service staking metadata during the staking process
+     * @param service Address of the service or contract account
+     * @param timestamp Timestamp when the prepareServiceStaking was called
+     * @param amountOfStaking Amount of staking tokens to be staked
+     * @param amountServiceBeforeStaking Service's Principal Token balance before staking
+     * @param amountStakingBeforeStaking Staking contract's Principal Token balance before staking
+     */
+    struct ServiceStakingMetadata {
+        address service;
+        uint256 timestamp;
+        uint256 amountOfStaking;
+        uint256 amountServiceBeforeStaking;
+        uint256 amountStakingBeforeStaking;
+    }
+
+    /**
+     * @dev Struct to encapsulate account metadata for staking operations
+     * @param Address Address of the account
+     * @param IsAService Boolean indicating if the account is a smart contract (service) account
+     */
+    struct AccountMetadata {
+        address Address;
+        bool IsAService;
+    }
+
+}