Support Consistent Address Deployment Across Networks

.gitmodules

@@ -1,3 +1,6 @@
 [submodule "lib/openzeppelin-foundry-upgrades"]
 	path = lib/openzeppelin-foundry-upgrades
 	url = https://github.com/OpenZeppelin/openzeppelin-foundry-upgrades
+[submodule "lib/create3-deployer"]
+	path = lib/create3-deployer
+	url = https://github.com/storyprotocol/create3-deployer

contracts/LicenseToken.sol

@@ -19,7 +19,9 @@ import { ILicenseTemplate } from "./interfaces/modules/licensing/ILicenseTemplat
 contract LicenseToken is ILicenseToken, ERC721EnumerableUpgradeable, AccessManagedUpgradeable, UUPSUpgradeable {
     using Strings for *;
 
+    /// @custom:oz-upgrades-unsafe-allow state-variable-immutable
     ILicensingModule public immutable LICENSING_MODULE;
+    /// @custom:oz-upgrades-unsafe-allow state-variable-immutable
     IDisputeModule public immutable DISPUTE_MODULE;
 
     /// @notice Emitted for metadata updates, per EIP-4906

contracts/access/AccessController.sol

@@ -32,7 +32,9 @@ import { Errors } from "../lib/Errors.sol";
 contract AccessController is IAccessController, ProtocolPausableUpgradeable, UUPSUpgradeable {
     using IPAccountChecker for IIPAccountRegistry;
 
+    /// @custom:oz-upgrades-unsafe-allow state-variable-immutable
     IIPAccountRegistry public immutable IP_ACCOUNT_REGISTRY;
+    /// @custom:oz-upgrades-unsafe-allow state-variable-immutable
     IModuleRegistry public immutable MODULE_REGISTRY;
 
     /// @dev The storage struct of AccessController.

contracts/modules/licensing/LicensingModule.sol

@@ -67,6 +67,8 @@ contract LicensingModule is
     /// @custom:oz-upgrades-unsafe-allow state-variable-immutable
     ILicenseToken public immutable LICENSE_NFT;
 
+    /// @notice Returns the protocol-wide ModuleRegistry
+    /// @custom:oz-upgrades-unsafe-allow state-variable-immutable
     IModuleRegistry public immutable MODULE_REGISTRY;
 
     // keccak256(abi.encode(uint256(keccak256("story-protocol.LicensingModule")) - 1)) & ~bytes32(uint256(0xff));

contracts/registries/LicenseRegistry.sol

@@ -28,7 +28,9 @@ contract LicenseRegistry is ILicenseRegistry, AccessManagedUpgradeable, UUPSUpgr
     using EnumerableSet for EnumerableSet.AddressSet;
     using IPAccountStorageOps for IIPAccount;
 
+    /// @custom:oz-upgrades-unsafe-allow state-variable-immutable
     ILicensingModule public immutable LICENSING_MODULE;
+    /// @custom:oz-upgrades-unsafe-allow state-variable-immutable
     IDisputeModule public immutable DISPUTE_MODULE;
 
     /// @dev Storage of the LicenseRegistry

package.json

@@ -59,7 +59,6 @@
         "@openzeppelin/contracts": "5.0.2",
         "@openzeppelin/contracts-upgradeable": "5.0.2",
         "@openzeppelin/contracts-upgradeable-v4": "npm:@openzeppelin/[email protected]",
-        "erc6551": "^0.3.1",
-        "solady": "^0.0.191"
+        "erc6551": "^0.3.1"
     }
 }

remappings.txt

@@ -2,4 +2,4 @@ ds-test/=node_modules/ds-test/src/
 forge-std/=node_modules/forge-std/src/
 @openzeppelin/=node_modules/@openzeppelin/
 @openzeppelin-foundry-upgrades/=lib/openzeppelin-foundry-upgrades
-@solady/=node_modules/solady/
+@create3-deployer/=lib/create3-deployer

script/foundry/deployment/Main.s.sol

@@ -9,6 +9,8 @@ import { DeployHelper } from "../utils/DeployHelper.sol";
 
 contract Main is DeployHelper {
     address internal ERC6551_REGISTRY = 0x000000006551c19487814612e58FE06813775758;
+    address internal CREATE3_DEPLOYER = 0x384a891dFDE8180b054f04D66379f16B7a678Ad6;
+    uint256 internal CREATE3_DEFAULT_SEED = 0;
     // For arbitration policy
     uint256 internal constant ARBITRATION_PRICE = 1000 * 10 ** 6; // 1000 USDC
     // For royalty policy
@@ -17,6 +19,7 @@ contract Main is DeployHelper {
     constructor()
         DeployHelper(
             ERC6551_REGISTRY,
+            CREATE3_DEPLOYER,
             address(0), // replaced with USDC in DeployHelper.sol
             ARBITRATION_PRICE,
             MAX_ROYALTY_APPROVAL
@@ -27,12 +30,20 @@ contract Main is DeployHelper {
     /// forge script script/foundry/deployment/Main.s.sol:Main --rpc-url $RPC_URL --broadcast --verify -vvvv
 
     function run() public virtual override {
+        _run(CREATE3_DEFAULT_SEED);
+    }
+
+    function run(uint256 seed) public {
+        _run(seed);
+    }
+
+    function _run(uint256 seed) internal {
         // deploy all contracts via DeployHelper
         super.run(
+            seed, // create3 seed
             true, // runStorageLayoutCheck
             true // writeDeployments
         );
         _writeDeployment(); // write deployment json to deployments/deployment-{chainId}.json
-        _endBroadcast(); // BroadcastManager.s.sol
     }
 }