✨ Add bytes32 to address utils (#1456)

Author: Vectorized

.github/workflows/ci.yml

@@ -78,7 +78,7 @@ jobs:
             forge test --fuzz-runs 5000
           )
 
-  tests-nightly:
+  tests-ithaca:
     name: Forge Ithaca Testing
     runs-on: ubuntu-latest
     strategy:
@@ -89,7 +89,7 @@ jobs:
       - name: Install Foundry Nightly
         uses: foundry-rs/foundry-toolchain@v1
         with:
-          version: nightly
+          version: stable
       - name: Install Dependencies
         run: forge install
       - name: Run Tests with ${{ matrix.profile }}

docs/utils/libbytes.md

@@ -455,4 +455,20 @@ Returns bytes in calldata. Performs bounds checks.
 function emptyCalldata() internal pure returns (bytes calldata result)
 ```
 
-Returns empty calldata bytes. For silencing the compiler.
+Returns empty calldata bytes. For silencing the compiler.
+
+### msbToAddress(bytes32)
+
+```solidity
+function msbToAddress(bytes32 x) internal pure returns (address)
+```
+
+Returns the most significant 20 bytes as an address.
+
+### lsbToAddress(bytes32)
+
+```solidity
+function lsbToAddress(bytes32 x) internal pure returns (address)
+```
+
+Returns the least significant 20 bytes as an address.

src/utils/LibBytes.sol

@@ -849,4 +849,14 @@ library LibBytes {
             result.length := 0
         }
     }
+
+    /// @dev Returns the most significant 20 bytes as an address.
+    function msbToAddress(bytes32 x) internal pure returns (address) {
+        return address(bytes20(x));
+    }
+
+    /// @dev Returns the least significant 20 bytes as an address.
+    function lsbToAddress(bytes32 x) internal pure returns (address) {
+        return address(uint160(uint256(x)));
+    }
 }

src/utils/g/LibBytes.sol

@@ -853,4 +853,14 @@ library LibBytes {
             result.length := 0
         }
     }
+
+    /// @dev Returns the most significant 20 bytes as an address.
+    function msbToAddress(bytes32 x) internal pure returns (address) {
+        return address(bytes20(x));
+    }
+
+    /// @dev Returns the least significant 20 bytes as an address.
+    function lsbToAddress(bytes32 x) internal pure returns (address) {
+        return address(uint160(uint256(x)));
+    }
 }

test/LibBytes.t.sol

@@ -366,4 +366,11 @@ contract LibBytesTest is SoladyTest {
             return type(uint256).max;
         }
     }
+
+    function testBytes32ToAddress(bytes32 x) public {
+        uint256 msb = uint256(x) >> 96;
+        uint256 lsb = (uint256(x) << 96) >> 96;
+        assertEq(uint160(LibBytes.msbToAddress(x)), msb);
+        assertEq(uint160(LibBytes.lsbToAddress(x)), lsb);
+    }
 }