@evvm/testnet-contracts 2.3.0 → 3.0.1

package/contracts/staking/lib/SignatureUtils.sol

@@ -1,105 +0,0 @@
-// SPDX-License-Identifier: EVVM-NONCOMMERCIAL-1.0
-// Full license terms available at: https://www.evvm.info/docs/EVVMNoncommercialLicense
-pragma solidity ^0.8.0;
-/**
- * @title SignatureUtils
- * @author Mate Labs
- * @notice Library for EIP-191 signature verification in the Staking contract
- * @dev This library is exclusive to the Staking.sol contract and provides
- * functions to verify signatures for staking operations.
- *
- * Signature Format:
- * All signatures follow the EIP-191 standard with message format:
- * "[evvmID],[functionName],[isStaking],[amountOfStaking],[nonce]"
- *
- * Supported Operations:
- * - Presale staking: Limited staking for pre-approved addresses
- * - Public staking: Open staking for all users when enabled
- */
-
-import {
-    SignatureUtil
-} from "@evvm/testnet-contracts/library/utils/SignatureUtil.sol";
-import {
-    AdvancedStrings
-} from "@evvm/testnet-contracts/library/utils/AdvancedStrings.sol";
-
-library SignatureUtils {
-    /**
-     * @dev Uses EIP-191 (https://eips.ethereum.org/EIPS/eip-191) for message signing
-     *      and verification. The following functions verify messages signed by users
-     *      for staking operations.
-     */
-
-    /**
-     * @notice Verifies an EIP-191 signature for presale staking operations
-     * @dev Message format: "[evvmID],presaleStaking,[isStaking],[amountOfStaking],[nonce]"
-     *      Presale staking has a limit of 2 staking tokens per user
-     * @param evvmID Unique identifier of the EVVM instance
-     * @param signer Address that should have signed the message
-     * @param isStaking True for staking operation, false for unstaking
-     * @param amountOfStaking Amount of staking tokens (always 1 for presale)
-     * @param nonce Unique nonce to prevent replay attacks
-     * @param signature 65-byte EIP-191 signature to verify
-     * @return True if the signature is valid and matches the expected signer
-     */
-    function verifyMessageSignedForPresaleStake(
-        uint256 evvmID,
-        address signer,
-        bool isStaking,
-        uint256 amountOfStaking,
-        uint256 nonce,
-        bytes memory signature
-    ) internal pure returns (bool) {
-        return
-            SignatureUtil.verifySignature(
-                evvmID,
-                "presaleStaking",
-                string.concat(
-                    AdvancedStrings.boolToString(isStaking),
-                    ",",
-                    AdvancedStrings.uintToString(amountOfStaking),
-                    ",",
-                    AdvancedStrings.uintToString(nonce)
-                ),
-                signature,
-                signer
-            );
-    }
-
-    /**
-     * @notice Verifies an EIP-191 signature for public staking operations
-     * @dev Message format: "[evvmID],publicStaking,[isStaking],[amountOfStaking],[nonce]"
-     *      Public staking is available to all users when the feature is enabled
-     * @param evvmID Unique identifier of the EVVM instance
-     * @param signer Address that should have signed the message
-     * @param isStaking True for staking operation, false for unstaking
-     * @param amountOfStaking Amount of staking tokens to stake/unstake
-     * @param nonce Unique nonce to prevent replay attacks
-     * @param signature 65-byte EIP-191 signature to verify
-     * @return True if the signature is valid and matches the expected signer
-     */
-    function verifyMessageSignedForPublicStake(
-        uint256 evvmID,
-        address signer,
-        bool isStaking,
-        uint256 amountOfStaking,
-        uint256 nonce,
-        bytes memory signature
-    ) internal pure returns (bool) {
-        return
-            SignatureUtil.verifySignature(
-                evvmID,
-                "publicStaking",
-                string.concat(
-                    AdvancedStrings.boolToString(isStaking),
-                    ",",
-                    AdvancedStrings.uintToString(amountOfStaking),
-                    ",",
-                    AdvancedStrings.uintToString(nonce)
-                ),
-                signature,
-                signer
-            );
-    }
-}

package/contracts/staking/lib/StakingStructs.sol

@@ -1,106 +0,0 @@
-// SPDX-License-Identifier: EVVM-NONCOMMERCIAL-1.0
-// Full license terms available at: https://www.evvm.info/docs/EVVMNoncommercialLicense
-
-pragma solidity ^0.8.0;
-/**
- * @title StakingStructs
- * @author Mate Labs
- * @notice Abstract contract containing all data structures used by the Staking contract
- * @dev This contract is exclusive to the Staking.sol contract and defines the data
- * structures for managing staking operations, governance proposals, and user history.
- *
- * Structure Categories:
- * - Staker Metadata: presaleStakerMetadata, HistoryMetadata
- * - Governance Proposals: AddressTypeProposal, UintTypeProposal, BoolTypeProposal
- * - Service Staking: ServiceStakingMetadata, AccountMetadata
- */
-
-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;
-    }
-
-}

package/contracts/treasuryTwoChains/lib/ErrorsLib.sol

@@ -1,48 +0,0 @@
-// SPDX-License-Identifier: EVVM-NONCOMMERCIAL-1.0
-// Full license terms available at: https://www.evvm.info/docs/EVVMNoncommercialLicense
-
-pragma solidity ^0.8.0;
-
-/**
- * @title ErrorsLib
- * @author Mate labs
- * @notice Custom error definitions for Treasury Cross-Chain operations
- * @dev Centralized error library for both TreasuryHostChainStation and TreasuryExternalChainStation
- *      Provides gas-efficient custom errors with descriptive names for better debugging
- *      and user experience across all cross-chain treasury operations
- */
-library ErrorsLib {
-    /// @notice Thrown when a user has insufficient balance for the requested operation
-    /// @dev Used in withdraw operations and Fisher bridge transfers when EVVM balance is too low
-    error InsufficientBalance();
-
-    /// @notice Thrown when attempting to withdraw or bridge the Principal Token (MATE)
-    /// @dev Principal Token is reserved for EVVM ecosystem operations and cannot be withdrawn cross-chain
-    error PrincipalTokenIsNotWithdrawable();
-
-    /// @notice Thrown when deposit amount validation fails
-    /// @dev Generic validation error for deposit amount issues beyond zero checks
-    error InvalidDepositAmount();
-
-    /// @notice Thrown when deposit or transfer amount is zero or negative
-    /// @dev Prevents meaningless transactions and ensures positive value transfers
-    error DepositAmountMustBeGreaterThanZero();
-
-    /// @notice Thrown when Hyperlane message sender is not the authorized mailbox contract
-    /// @dev Security check to prevent unauthorized cross-chain message execution via Hyperlane
-    error MailboxNotAuthorized();
-
-    /// @notice Thrown when cross-chain message sender is not the authorized counterpart station
-    /// @dev Security check across all protocols (Hyperlane, LayerZero, Axelar) to prevent impersonation
-    error SenderNotAuthorized();
-
-    /// @notice Thrown when cross-chain message originates from non-authorized chain
-    /// @dev Prevents cross-chain attacks from unauthorized chains or wrong network configurations
-    error ChainIdNotAuthorized();
-
-    /// @notice Thrown when Fisher bridge signature verification fails
-    /// @dev Security check for Fisher bridge operations to ensure transaction authenticity and prevent replay attacks
-    error InvalidSignature();
-
-    error WindowToChangeEvvmIDExpired();
-}

package/contracts/treasuryTwoChains/lib/ExternalChainStationStructs.sol

@@ -1,80 +0,0 @@
-// SPDX-License-Identifier: EVVM-NONCOMMERCIAL-1.0
-// Full license terms available at: https://www.evvm.info/docs/EVVMNoncommercialLicense
-
-pragma solidity ^0.8.0;
-
-/**
- * @title ExternalChainStationStructs
- * @author Mate labs
- * @notice Shared data structures for External Chain Station cross-chain treasury operations
- * @dev Defines all structural types used by TreasuryExternalChainStation contract
- *      These structures ensure type safety and consistency for cross-chain operations
- *      from external chains to the host chain in the EVVM ecosystem
- */
-abstract contract ExternalChainStationStructs {
-    /// @notice Time-delayed address change proposal structure for governance
-    /// @dev Used for admin and Fisher executor address changes with 1-day delay
-    /// @param current Currently active address with full privileges
-    /// @param proposal Proposed new address waiting for acceptance
-    /// @param timeToAccept Timestamp when the proposal becomes acceptable
-    struct AddressTypeProposal {
-        address current;
-        address proposal;
-        uint256 timeToAccept;
-    }
-
-    /// @notice Hyperlane protocol configuration for cross-chain messaging
-    /// @dev Configuration for reliable cross-chain communication via Hyperlane
-    /// @param hostChainStationDomainId Hyperlane domain identifier for the host chain
-    /// @param hostChainStationAddress Host chain station address in bytes32 format
-    /// @param mailboxAddress Hyperlane mailbox contract address on this chain
-    struct HyperlaneConfig {
-        uint32 hostChainStationDomainId;
-        bytes32 hostChainStationAddress;
-        address mailboxAddress;
-    }
-
-    /// @notice LayerZero protocol configuration for omnichain messaging
-    /// @dev Configuration for omnichain interoperability via LayerZero V2
-    /// @param hostChainStationEid LayerZero endpoint identifier for the host chain
-    /// @param hostChainStationAddress Host chain station address in bytes32 format
-    /// @param endpointAddress LayerZero V2 endpoint contract address on this chain
-    struct LayerZeroConfig {
-        uint32 hostChainStationEid;
-        bytes32 hostChainStationAddress;
-        address endpointAddress;
-    }
-
-    /// @notice Axelar protocol configuration for cross-chain communication
-    /// @dev Configuration for secure cross-chain transfers via Axelar Network
-    /// @param hostChainStationChainName Axelar chain identifier for the host chain
-    /// @param hostChainStationAddress Host chain station address in string format
-    /// @param gasServiceAddress Axelar gas service contract address for fee payments
-    /// @param gatewayAddress Axelar gateway contract address for message routing
-    struct AxelarConfig {
-        string hostChainStationChainName;
-        string hostChainStationAddress;
-        address gasServiceAddress;
-        address gatewayAddress;
-    }
-
-    /// @notice Unified cross-chain configuration for all supported protocols
-    /// @dev Single structure containing all protocol configurations for deployment
-    struct CrosschainConfig {
-        HyperlaneConfig hyperlane;
-        LayerZeroConfig layerZero;
-        AxelarConfig axelar;
-    }
-
-    /// @notice Parameters for coordinated host chain address changes across all protocols
-    /// @dev Used to propose and execute synchronized address updates with time delay
-    /// @param porposeAddress_AddressType Address format for Hyperlane and LayerZero protocols
-    /// @param porposeAddress_StringType String format for Axelar protocol compatibility
-    /// @param timeToAccept Timestamp when the address change proposal can be executed
-    struct ChangeHostChainAddressParams {
-        address porposeAddress_AddressType;
-        string porposeAddress_StringType;
-        uint256 timeToAccept;
-    }
-}
-

package/contracts/treasuryTwoChains/lib/HostChainStationStructs.sol

@@ -1,87 +0,0 @@
-// SPDX-License-Identifier: EVVM-NONCOMMERCIAL-1.0
-// Full license terms available at: https://www.evvm.info/docs/EVVMNoncommercialLicense
-
-pragma solidity ^0.8.0;
-
-/**
- * @title HostChainStationStructs
- * @author Mate labs
- * @notice Shared data structures for Host Chain Station cross-chain treasury operations
- * @dev Defines all structural types used by TreasuryHostChainStation contract
- *      These structures ensure type safety and consistency for cross-chain operations
- *      from the host chain to external chains in the EVVM ecosystem
- */
-
-abstract contract HostChainStationStructs {
-    /// @notice Time-delayed address change proposal structure for governance
-    /// @dev Used for admin and Fisher executor address changes with 1-day delay
-    /// @param current Currently active address with full privileges
-    /// @param proposal Proposed new address waiting for acceptance
-    /// @param timeToAccept Timestamp when the proposal becomes acceptable
-    struct AddressTypeProposal {
-        address current;
-        address proposal;
-        uint256 timeToAccept;
-    }
-
-    /// @notice Hyperlane protocol configuration for cross-chain messaging
-    /// @dev Configuration for reliable cross-chain communication via Hyperlane
-    /// @param externalChainStationDomainId Hyperlane domain identifier for the external chain
-    /// @param externalChainStationAddress External chain station address in bytes32 format
-    /// @param mailboxAddress Hyperlane mailbox contract address on this host chain
-    struct HyperlaneConfig {
-        uint32 externalChainStationDomainId;
-        bytes32 externalChainStationAddress;
-        address mailboxAddress;
-    }
-
-    /// @notice LayerZero protocol configuration for omnichain messaging
-    /// @dev Configuration for omnichain interoperability via LayerZero V2
-    /// @param externalChainStationEid LayerZero endpoint identifier for the external chain
-    /// @param externalChainStationAddress External chain station address in bytes32 format
-    /// @param endpointAddress LayerZero V2 endpoint contract address on this host chain
-    struct LayerZeroConfig {
-        uint32 externalChainStationEid;
-        bytes32 externalChainStationAddress;
-        address endpointAddress;
-    }
-
-    /// @notice Axelar protocol configuration for cross-chain communication
-    /// @dev Configuration for secure cross-chain transfers via Axelar Network
-    /// @param externalChainStationChainName Axelar chain identifier for the external chain
-    /// @param externalChainStationAddress External chain station address in string format
-    /// @param gasServiceAddress Axelar gas service contract address for fee payments
-    /// @param gatewayAddress Axelar gateway contract address for message routing
-    struct AxelarConfig {
-        string externalChainStationChainName;
-        string externalChainStationAddress;
-        address gasServiceAddress;
-        address gatewayAddress;
-    }
-
-    /// @notice Unified cross-chain configuration for all supported protocols
-    /// @dev Single structure containing all protocol configurations for deployment
-    /// @param externalChainStationDomainId Hyperlane domain ID for external chain
-    /// @param mailboxAddress Hyperlane mailbox contract address
-    /// @param externalChainStationEid LayerZero endpoint ID for external chain
-    /// @param endpointAddress LayerZero V2 endpoint contract address
-    /// @param externalChainStationChainName Axelar chain name for external chain
-    /// @param gasServiceAddress Axelar gas service contract address
-    /// @param gatewayAddress Axelar gateway contract address
-    struct CrosschainConfig {
-        HyperlaneConfig hyperlane;
-        LayerZeroConfig layerZero;
-        AxelarConfig axelar;
-    }
-
-    /// @notice Parameters for coordinated external chain address changes across all protocols
-    /// @dev Used to propose and execute synchronized address updates with time delay
-    /// @param porposeAddress_AddressType Address format for Hyperlane and LayerZero protocols
-    /// @param porposeAddress_StringType String format for Axelar protocol compatibility
-    /// @param timeToAccept Timestamp when the address change proposal can be executed
-    struct ChangeExternalChainAddressParams {
-        address porposeAddress_AddressType;
-        string porposeAddress_StringType;
-        uint256 timeToAccept;
-    }
-}

package/contracts/treasuryTwoChains/lib/SignatureUtils.sol

@@ -1,79 +0,0 @@
-// SPDX-License-Identifier: EVVM-NONCOMMERCIAL-1.0
-// Full license terms available at: https://www.evvm.info/docs/EVVMNoncommercialLicense
-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";
-
-/**
- * @title SignatureUtils
- * @author Mate labs
- * @notice Signature verification utilities for Treasury Cross-Chain Fisher Bridge operations
- * @dev Specialized signature verification for Fisher Bridge transactions in the EVVM cross-chain treasury system
- *      Provides EIP-191 compliant signature verification with structured message format for enhanced security
- *
- * Key Features:
- * - EIP-191 standard message signing format for wallet compatibility
- * - Fisher Bridge specific message structure for transaction authenticity
- * - Nonce-based replay attack prevention
- * - EVVM ID integration for cross-instance security
- * - Support for both ETH and ERC20 token bridge operations
- *
- * Security Model:
- * - Structured message format: "{evvmID},fisherBridge,{parameters}"
- * - Nonce validation prevents replay attacks across chains
- * - EVVM ID ensures signatures are valid only for specific EVVM instances
- * - Address and amount validation through signature verification
- */
-library SignatureUtils {
-    /// @notice Verifies Fisher Bridge transaction signatures using EIP-191 standard
-    /// @dev Constructs and verifies structured message for Fisher Bridge cross-chain operations
-    ///      Message format: "{evvmID},fisherBridge,{addressToReceive},{nonce},{tokenAddress},{priorityFee},{amount}"
-    ///      This ensures each signature is unique and prevents cross-chain replay attacks
-    ///
-    /// @param evvmID Unique identifier of the EVVM instance (prevents cross-instance replay)
-    /// @param signer Address that should have signed the message (transaction originator)
-    /// @param addressToReceive Destination address on the target chain for the bridged tokens
-    /// @param nonce Sequential nonce for the user to prevent replay attacks
-    /// @param tokenAddress Contract address of the token being bridged (address(0) for ETH)
-    /// @param priorityFee Fee amount paid to Fisher executor for priority processing
-    /// @param amount Total amount of tokens being bridged across chains
-    /// @param signature ECDSA signature (65 bytes) created by the signer using their private key
-    /// @return bool True if the signature is valid and matches the expected signer, false otherwise
-    ///
-    /// @dev Security Features:
-    ///      - EIP-191 compliance ensures wallet compatibility (MetaMask, WalletConnect, etc.)
-    ///      - Structured message prevents parameter manipulation
-    ///      - EVVM ID binding prevents cross-instance attacks
-    ///      - Nonce inclusion prevents replay attacks
-    ///      - All parameters are included in signature for integrity verification
-    function verifyMessageSignedForFisherBridge(
-        uint256 evvmID,
-        address signer,
-        address addressToReceive,
-        uint256 nonce,
-        address tokenAddress,
-        uint256 priorityFee,
-        uint256 amount,
-        bytes memory signature
-    ) internal pure returns (bool) {
-        return
-            SignatureUtil.verifySignature(
-                evvmID,
-                "fisherBridge",
-                string.concat(
-                    AdvancedStrings.addressToString(addressToReceive),
-                    ",",
-                    AdvancedStrings.uintToString(nonce),
-                    ",",
-                    AdvancedStrings.addressToString(tokenAddress),
-                    ",",
-                    AdvancedStrings.uintToString(priorityFee),
-                    ",",
-                    AdvancedStrings.uintToString(amount)
-                ),
-                signature,
-                signer
-            );
-    }
-}

package/library/utils/GovernanceUtils.sol

@@ -1,81 +0,0 @@
-// SPDX-License-Identifier: EVVM-NONCOMMERCIAL-1.0
-// Full license terms available at: https://www.evvm.info/docs/EVVMNoncommercialLicense
-
-pragma solidity ^0.8.0;
-
-library ProposalStructs {
-    /**
-     * @dev Struct for managing address change proposals with time delay
-     * @param current Currently active address
-     * @param proposal Proposed new address waiting for approval
-     * @param timeToAccept Timestamp when the proposal can be accepted
-     */
-    struct AddressTypeProposal {
-        address current;
-        address proposal;
-        uint256 timeToAccept;
-    }
-
-    /**
-     * @dev Struct for managing uint256 value proposals with time delay
-     * @param current Currently active value
-     * @param proposal Proposed new value waiting for approval
-     * @param timeToAccept Timestamp when the proposal can be accepted
-     */
-    struct UintTypeProposal {
-        uint256 current;
-        uint256 proposal;
-        uint256 timeToAccept;
-    }
-
-    /**
-     * @dev Struct for managing boolean flag changes with time delay
-     * @param flag Current boolean state
-     * @param timeToAcceptChange Timestamp when the flag change can be executed
-     */
-    struct BoolTypeProposal {
-        bool flag;
-        uint256 timeToAcceptChange;
-    }
-}
-
-/**
- * @title AdminControlled
- * @notice Base contract for admin-controlled contracts with time-delayed governance
- */
-abstract contract AdminControlled {
-    ProposalStructs.AddressTypeProposal public admin;
-
-    event AdminProposed(address indexed newAdmin, uint256 timeToAccept);
-    event AdminAccepted(address indexed newAdmin);
-
-    error SenderIsNotAdmin();
-    error ProposalNotReady();
-
-    modifier onlyAdmin() {
-        if (msg.sender != admin.current) revert SenderIsNotAdmin();
-        _;
-    }
-
-    /**
-     * @notice Proposes a new admin with time delay
-     * @param newAdmin Address of proposed admin
-     * @param delay Time delay before proposal can be accepted
-     */
-    function proposeAdmin(address newAdmin, uint256 delay) external onlyAdmin {
-        admin.proposal = newAdmin;
-        admin.timeToAccept = block.timestamp + delay;
-        emit AdminProposed(newAdmin, admin.timeToAccept);
-    }
-
-    /**
-     * @notice Accepts the admin proposal after time delay
-     */
-    function acceptAdminProposal() external onlyAdmin {
-        if (block.timestamp < admin.timeToAccept) revert ProposalNotReady();
-        admin.current = admin.proposal;
-        admin.proposal = address(0);
-        admin.timeToAccept = 0;
-        emit AdminAccepted(admin.current);
-    }
-}

package/library/utils/nonces/AsyncNonce.sol

@@ -1,74 +0,0 @@
-// SPDX-License-Identifier: EVVM-NONCOMMERCIAL-1.0
-// Full license terms available at: https://www.evvm.info/docs/EVVMNoncommercialLicense
-
-pragma solidity ^0.8.0;
-/**
- * @title AsyncNonce
- * @author Mate Labs
- * @notice Abstract contract for asynchronous nonce management in EVVM services
- * @dev Provides replay protection using a bitmap-style nonce system where each nonce
- * can be used only once, but nonces can be used in any order (non-sequential).
- *
- * Key Features:
- * - Non-sequential nonce usage (any unused nonce is valid)
- * - Gas-efficient O(1) lookup and marking
- * - Suitable for parallel transaction submission
- *
- * Use Cases:
- * - Services that allow users to submit multiple transactions simultaneously
- * - Operations where transaction ordering is not critical
- * - Batch operations where sequential nonces would be a bottleneck
- *
- * This contract is designed for use by community-developed services that need
- * flexible replay protection without strict ordering requirements.
- */
-
-abstract contract AsyncNonce {
-    /// @dev Thrown when attempting to use a nonce that has already been consumed
-    error AsyncNonceAlreadyUsed();
-
-    /// @dev Mapping to track used nonces: user address => nonce value => used flag
-    mapping(address user => mapping(uint256 nonce => bool availability))
-        private asyncNonce;
-
-    /**
-     * @notice Marks a nonce as used for a specific user
-     * @dev Should be called after successful operation validation to prevent replay
-     * @param user Address of the user whose nonce is being marked
-     * @param nonce The nonce value to mark as used
-     */
-    function markAsyncNonceAsUsed(
-        address user,
-        uint256 nonce
-    ) internal virtual {
-        asyncNonce[user][nonce] = true;
-    }
-
-    /**
-     * @notice Verifies that a nonce has not been used yet
-     * @dev Reverts with AsyncNonceAlreadyUsed if the nonce was previously consumed
-     * @param user Address of the user to check the nonce for
-     * @param nonce The nonce value to verify
-     * @custom:throws AsyncNonceAlreadyUsed If the nonce has already been used
-     */
-    function verifyAsyncNonce(
-        address user,
-        uint256 nonce
-    ) internal view virtual {
-        if (asyncNonce[user][nonce]) revert AsyncNonceAlreadyUsed();
-    }
-
-    /**
-     * @notice Checks if a specific nonce has been used by a user
-     * @dev Public view function for external queries and UI integration
-     * @param user Address of the user to check
-     * @param nonce The nonce value to query
-     * @return True if the nonce has been used, false if available
-     */
-    function getIfUsedAsyncNonce(
-        address user,
-        uint256 nonce
-    ) public view virtual returns (bool) {
-        return asyncNonce[user][nonce];
-    }
-}