chore: update naming (#1408)

**Motivation:**

We use `burnOrRedistributable` everywhere. Let's just use escrow
instead. Much simpler.

**Modifications:**

`burnOrRedistributable -> escrow`.

**Result:**

Better readability.

---------

Co-authored-by: clandestine.eth <[email protected]>

Author: ypatil12

src/contracts/core/SlashEscrow.sol

@@ -11,7 +11,7 @@ contract SlashEscrow is ISlashEscrow {
     using SafeERC20 for IERC20;
 
     /// @inheritdoc ISlashEscrow
-    function burnOrRedistributeUnderlyingTokens(
+    function releaseTokens(
         ISlashEscrowFactory slashEscrowFactory,
         ISlashEscrow slashEscrowImplementation,
         OperatorSet calldata operatorSet,

src/contracts/core/SlashEscrowFactory.sol

@@ -42,7 +42,7 @@ contract SlashEscrowFactory is Initializable, SlashEscrowFactoryStorage, Ownable
     ) external initializer {
         _transferOwnership(initialOwner);
         _setPausedStatus(initialPausedStatus);
-        _setGlobalBurnOrRedistributionDelay(initialGlobalDelayBlocks);
+        _setGlobalEscrowDelay(initialGlobalDelayBlocks);
     }
 
     /**
@@ -72,14 +72,14 @@ contract SlashEscrowFactory is Initializable, SlashEscrowFactoryStorage, Ownable
 
         // Set the start block for the slash ID.
         _slashIdToStartBlock[operatorSet.key()][slashId] = uint32(block.number);
-        emit StartBurnOrRedistribution(operatorSet, slashId, strategy, uint32(block.number));
+        emit StartEscrow(operatorSet, slashId, strategy, uint32(block.number));
     }
 
     /// @inheritdoc ISlashEscrowFactory
     function releaseSlashEscrow(
         OperatorSet calldata operatorSet,
         uint256 slashId
-    ) external virtual onlyWhenNotPaused(PAUSED_BURN_OR_REDISTRIBUTE_SHARES) {
+    ) external virtual onlyWhenNotPaused(PAUSED_RELEASE_ESCROW) {
         address redistributionRecipient = allocationManager.getRedistributionRecipient(operatorSet);
 
         // If the redistribution recipient is not the default burn address...
@@ -88,10 +88,10 @@ contract SlashEscrowFactory is Initializable, SlashEscrowFactoryStorage, Ownable
         }
 
         // Assert that the slash ID is not paused
-        require(!isBurnOrRedistributionPaused(operatorSet, slashId), IPausable.CurrentlyPaused());
+        require(!isEscrowPaused(operatorSet, slashId), IPausable.CurrentlyPaused());
 
         // Assert that the escrow delay has elapsed
-        require(block.number >= getBurnOrRedistributionCompleteBlock(operatorSet, slashId), EscrowDelayNotElapsed());
+        require(block.number >= getEscrowCompleteBlock(operatorSet, slashId), EscrowDelayNotElapsed());
 
         // Calling `decreaseBurnOrRedistributableShares` will transfer the underlying tokens to the `SlashEscrow`.
         // NOTE: While `decreaseBurnOrRedistributableShares` may have already been called, we call it again to ensure that the
@@ -127,17 +127,17 @@ contract SlashEscrowFactory is Initializable, SlashEscrowFactoryStorage, Ownable
      */
 
     /// @inheritdoc ISlashEscrowFactory
-    function pauseRedistribution(OperatorSet calldata operatorSet, uint256 slashId) external virtual onlyPauser {
+    function pauseEscrow(OperatorSet calldata operatorSet, uint256 slashId) external virtual onlyPauser {
         _checkNewPausedStatus(operatorSet, slashId, true);
         _paused[operatorSet.key()][slashId] = true;
-        emit RedistributionPaused(operatorSet, slashId);
+        emit EscrowPaused(operatorSet, slashId);
     }
 
     /// @inheritdoc ISlashEscrowFactory
-    function unpauseRedistribution(OperatorSet calldata operatorSet, uint256 slashId) external virtual onlyUnpauser {
+    function unpauseEscrow(OperatorSet calldata operatorSet, uint256 slashId) external virtual onlyUnpauser {
         _checkNewPausedStatus(operatorSet, slashId, false);
         _paused[operatorSet.key()][slashId] = false;
-        emit RedistributionUnpaused(operatorSet, slashId);
+        emit EscrowUnpaused(operatorSet, slashId);
     }
 
     /**
@@ -147,16 +147,16 @@ contract SlashEscrowFactory is Initializable, SlashEscrowFactoryStorage, Ownable
      */
 
     /// @inheritdoc ISlashEscrowFactory
-    function setGlobalBurnOrRedistributionDelay(
+    function setGlobalEscrowDelay(
         uint32 delay
     ) external onlyOwner {
-        _setGlobalBurnOrRedistributionDelay(delay);
+        _setGlobalEscrowDelay(delay);
     }
 
     /// @inheritdoc ISlashEscrowFactory
-    function setStrategyBurnOrRedistributionDelay(IStrategy strategy, uint32 delay) external onlyOwner {
-        _strategyBurnOrRedistributionDelayBlocks[address(strategy)] = delay;
-        emit StrategyBurnOrRedistributionDelaySet(strategy, delay);
+    function setStrategyEscrowDelay(IStrategy strategy, uint32 delay) external onlyOwner {
+        _strategyEscrowDelayBlocks[address(strategy)] = delay;
+        emit StrategyEscrowDelaySet(strategy, delay);
     }
 
     /**
@@ -184,7 +184,7 @@ contract SlashEscrowFactory is Initializable, SlashEscrowFactoryStorage, Ownable
             address strategy = pendingStrategiesForSlashId.at(i - 1);
 
             // Burn or redistribute the underlying tokens for the strategy.
-            slashEscrow.burnOrRedistributeUnderlyingTokens(
+            slashEscrow.releaseTokens(
                 ISlashEscrowFactory(address(this)),
                 slashEscrowImplementation,
                 operatorSet,
@@ -195,7 +195,7 @@ contract SlashEscrowFactory is Initializable, SlashEscrowFactoryStorage, Ownable
 
             // Remove the strategy and underlying amount from the pending burn or redistributions map.
             pendingStrategiesForSlashId.remove(strategy);
-            emit BurnOrRedistributionComplete(operatorSet, slashId, IStrategy(strategy), redistributionRecipient);
+            emit EscrowComplete(operatorSet, slashId, IStrategy(strategy), redistributionRecipient);
         }
 
         // Remove the slash ID from the pending slash IDs set.
@@ -210,12 +210,12 @@ contract SlashEscrowFactory is Initializable, SlashEscrowFactoryStorage, Ownable
         }
     }
 
-    /// @notice Sets the global burn or redistribution delay.
-    function _setGlobalBurnOrRedistributionDelay(
+    /// @notice Sets the global escrow delay.
+    function _setGlobalEscrowDelay(
         uint32 delay
     ) internal {
-        _globalBurnOrRedistributionDelayBlocks = delay;
-        emit GlobalBurnOrRedistributionDelaySet(delay);
+        _globalEscrowDelayBlocks = delay;
+        emit GlobalEscrowDelaySet(delay);
     }
 
     /// @notice Checks that the new paused status is not the same as the current paused status.
@@ -300,7 +300,7 @@ contract SlashEscrowFactory is Initializable, SlashEscrowFactoryStorage, Ownable
             // For each slashId, get the complete block.
             completeBlocks[i] = new uint32[](slashIds[i].length);
             for (uint256 j = 0; j < slashIds[i].length; j++) {
-                completeBlocks[i][j] = getBurnOrRedistributionCompleteBlock(operatorSets[i], slashIds[i][j]);
+                completeBlocks[i][j] = getEscrowCompleteBlock(operatorSets[i], slashIds[i][j]);
             }
         }
     }
@@ -362,55 +362,46 @@ contract SlashEscrowFactory is Initializable, SlashEscrowFactoryStorage, Ownable
     }
 
     /// @inheritdoc ISlashEscrowFactory
-    function isBurnOrRedistributionPaused(
-        OperatorSet calldata operatorSet,
-        uint256 slashId
-    ) public view returns (bool) {
+    function isEscrowPaused(OperatorSet calldata operatorSet, uint256 slashId) public view returns (bool) {
         return _paused[operatorSet.key()][slashId];
     }
 
     /// @inheritdoc ISlashEscrowFactory
-    function getBurnOrRedistributionStartBlock(
-        OperatorSet memory operatorSet,
-        uint256 slashId
-    ) public view returns (uint256) {
+    function getEscrowStartBlock(OperatorSet memory operatorSet, uint256 slashId) public view returns (uint256) {
         return _slashIdToStartBlock[operatorSet.key()][slashId];
     }
 
     /// @inheritdoc ISlashEscrowFactory
-    function getBurnOrRedistributionCompleteBlock(
-        OperatorSet memory operatorSet,
-        uint256 slashId
-    ) public view returns (uint32) {
+    function getEscrowCompleteBlock(OperatorSet memory operatorSet, uint256 slashId) public view returns (uint32) {
         IStrategy[] memory strategies = getPendingStrategiesForSlashId(operatorSet, slashId);
 
         // Loop through all strategies and return the max delay
         uint32 maxStrategyDelay;
         for (uint256 i = 0; i < strategies.length; ++i) {
-            uint32 delay = getStrategyBurnOrRedistributionDelay(IStrategy(address(strategies[i])));
+            uint32 delay = getStrategyEscrowDelay(IStrategy(address(strategies[i])));
             if (delay > maxStrategyDelay) {
                 maxStrategyDelay = delay;
             }
         }
 
         // The escrow can be released once the max strategy delay has elapsed.
-        return uint32(getBurnOrRedistributionStartBlock(operatorSet, slashId) + maxStrategyDelay + 1);
+        return uint32(getEscrowStartBlock(operatorSet, slashId) + maxStrategyDelay + 1);
     }
 
     /// @inheritdoc ISlashEscrowFactory
-    function getStrategyBurnOrRedistributionDelay(
+    function getStrategyEscrowDelay(
         IStrategy strategy
     ) public view returns (uint32) {
-        uint32 globalDelay = _globalBurnOrRedistributionDelayBlocks;
-        uint32 strategyDelay = _strategyBurnOrRedistributionDelayBlocks[address(strategy)];
+        uint32 globalDelay = _globalEscrowDelayBlocks;
+        uint32 strategyDelay = _strategyEscrowDelayBlocks[address(strategy)];
 
         // Return whichever delay is greater.
         return strategyDelay > globalDelay ? strategyDelay : globalDelay;
     }
 
     /// @inheritdoc ISlashEscrowFactory
-    function getGlobalBurnOrRedistributionDelay() external view returns (uint32) {
-        return _globalBurnOrRedistributionDelayBlocks;
+    function getGlobalEscrowDelay() external view returns (uint32) {
+        return _globalEscrowDelayBlocks;
     }
 
     /// @inheritdoc ISlashEscrowFactory

src/contracts/core/SlashEscrowFactoryStorage.sol

@@ -15,8 +15,8 @@ abstract contract SlashEscrowFactoryStorage is ISlashEscrowFactory {
     address internal constant DEFAULT_BURN_ADDRESS = 0x00000000000000000000000000000000000E16E4;
 
     /// @notice The pause status for the `releaseSlashEscrow` function.
-    /// @dev Allows all burn or redistribution outflows to be temporarily halted.
-    uint8 public constant PAUSED_BURN_OR_REDISTRIBUTE_SHARES = 0;
+    /// @dev Allows all escrow outflows to be temporarily halted.
+    uint8 public constant PAUSED_RELEASE_ESCROW = 0;
 
     // Immutable Storage
 
@@ -48,11 +48,11 @@ abstract contract SlashEscrowFactoryStorage is ISlashEscrowFactory {
     /// @notice Returns the paused status for a given operator set and slash ID.
     mapping(bytes32 operatorSetKey => mapping(uint256 slashId => bool paused)) internal _paused;
 
-    /// @dev Returns the burn or redistribution delay for a given strategy.
-    uint32 internal _globalBurnOrRedistributionDelayBlocks;
+    /// @dev Returns the global escrow delay for all strategies.
+    uint32 internal _globalEscrowDelayBlocks;
 
     /// @dev Returns the operator set delay for a given strategy.
-    mapping(address strategy => uint32 delay) internal _strategyBurnOrRedistributionDelayBlocks;
+    mapping(address strategy => uint32 delay) internal _strategyEscrowDelayBlocks;
 
     // Constructor
 

src/contracts/interfaces/ISlashEscrow.sol

@@ -19,7 +19,7 @@ interface ISlashEscrow {
     /// @param slashId The slash ID that was used to create the slash escrow.
     /// @param recipient The recipient of the underlying tokens.
     /// @param strategy The strategy that was used to create the slash escrow.
-    function burnOrRedistributeUnderlyingTokens(
+    function releaseTokens(
         ISlashEscrowFactory slashEscrowFactory,
         ISlashEscrow slashEscrowImplementation,
         OperatorSet calldata operatorSet,
@@ -32,7 +32,7 @@ interface ISlashEscrow {
     /// @dev Validates that the provided parameters deterministically generate this contract's address using CREATE2.
     /// - Uses ClonesUpgradeable.predictDeterministicAddress() to compute the expected address from the parameters.
     /// - Compares the computed address against this contract's address to validate parameter integrity.
-    /// - Provides a stateless validation mechanism for burnOrRedistributeUnderlyingTokens() inputs.
+    /// - Provides a stateless validation mechanism for releaseTokens() inputs.
     /// - Security relies on the cryptographic properties of CREATE2 address derivation.
     /// - Attack vector would require finding a hash collision in the CREATE2 address computation.
     /// @param slashEscrowFactory The factory contract that created the slash escrow.