feat(world): add CallBatchSystem to core module

.changeset/wild-nails-wonder.md

@@ -0,0 +1,13 @@
+---
+"@latticexyz/world": minor
+---
+
+The `World` now has a `callBatch` method which allows multiple system calls to be batched into a single transaction.
+
+```solidity
+import { SystemCallData } from "@latticexyz/world/modules/core/types.sol";
+
+interface IBaseWorld {
+  function callBatch(SystemCallData[] calldata systemCalls) external returns (bytes[] memory returnDatas);
+}
+```

packages/world/gas-report.json

@@ -35,17 +35,23 @@
     "name": "AccessControl: requireAccess (this address)",
     "gasUsed": 153
   },
+  {
+    "file": "test/CallBatch.t.sol",
+    "test": "testCallBatchReturnData",
+    "name": "call systems with callBatch",
+    "gasUsed": 45546
+  },
   {
     "file": "test/KeysInTableModule.t.sol",
     "test": "testInstallComposite",
     "name": "install keys in table module",
-    "gasUsed": 1414653
+    "gasUsed": 1415069
   },
   {
     "file": "test/KeysInTableModule.t.sol",
     "test": "testInstallGas",
     "name": "install keys in table module",
-    "gasUsed": 1414653
+    "gasUsed": 1415069
   },
   {
     "file": "test/KeysInTableModule.t.sol",
@@ -57,13 +63,13 @@
     "file": "test/KeysInTableModule.t.sol",
     "test": "testInstallSingleton",
     "name": "install keys in table module",
-    "gasUsed": 1414653
+    "gasUsed": 1415069
   },
   {
     "file": "test/KeysInTableModule.t.sol",
     "test": "testSetAndDeleteRecordHookCompositeGas",
     "name": "install keys in table module",
-    "gasUsed": 1414653
+    "gasUsed": 1415069
   },
   {
     "file": "test/KeysInTableModule.t.sol",
@@ -81,7 +87,7 @@
     "file": "test/KeysInTableModule.t.sol",
     "test": "testSetAndDeleteRecordHookGas",
     "name": "install keys in table module",
-    "gasUsed": 1414653
+    "gasUsed": 1415069
   },
   {
     "file": "test/KeysInTableModule.t.sol",
@@ -99,7 +105,7 @@
     "file": "test/KeysWithValueModule.t.sol",
     "test": "testGetKeysWithValueGas",
     "name": "install keys with value module",
-    "gasUsed": 665378
+    "gasUsed": 665448
   },
   {
     "file": "test/KeysWithValueModule.t.sol",
@@ -117,7 +123,7 @@
     "file": "test/KeysWithValueModule.t.sol",
     "test": "testInstall",
     "name": "install keys with value module",
-    "gasUsed": 665378
+    "gasUsed": 665448
   },
   {
     "file": "test/KeysWithValueModule.t.sol",
@@ -129,7 +135,7 @@
     "file": "test/KeysWithValueModule.t.sol",
     "test": "testSetAndDeleteRecordHook",
     "name": "install keys with value module",
-    "gasUsed": 665378
+    "gasUsed": 665448
   },
   {
     "file": "test/KeysWithValueModule.t.sol",
@@ -147,7 +153,7 @@
     "file": "test/KeysWithValueModule.t.sol",
     "test": "testSetField",
     "name": "install keys with value module",
-    "gasUsed": 665378
+    "gasUsed": 665448
   },
   {
     "file": "test/KeysWithValueModule.t.sol",
@@ -231,7 +237,7 @@
     "file": "test/StandardDelegationsModule.t.sol",
     "test": "testCallFromCallboundDelegation",
     "name": "register a callbound delegation",
-    "gasUsed": 114589
+    "gasUsed": 114729
   },
   {
     "file": "test/StandardDelegationsModule.t.sol",
@@ -243,7 +249,7 @@
     "file": "test/StandardDelegationsModule.t.sol",
     "test": "testCallFromTimeboundDelegation",
     "name": "register a timebound delegation",
-    "gasUsed": 109084
+    "gasUsed": 109224
   },
   {
     "file": "test/StandardDelegationsModule.t.sol",
@@ -255,7 +261,7 @@
     "file": "test/UniqueEntityModule.t.sol",
     "test": "testInstall",
     "name": "install unique entity module",
-    "gasUsed": 690431
+    "gasUsed": 690539
   },
   {
     "file": "test/UniqueEntityModule.t.sol",
@@ -267,7 +273,7 @@
     "file": "test/UniqueEntityModule.t.sol",
     "test": "testInstallRoot",
     "name": "installRoot unique entity module",
-    "gasUsed": 680681
+    "gasUsed": 680735
   },
   {
     "file": "test/UniqueEntityModule.t.sol",
@@ -285,7 +291,7 @@
     "file": "test/World.t.sol",
     "test": "testCallFromUnlimitedDelegation",
     "name": "register an unlimited delegation",
-    "gasUsed": 50629
+    "gasUsed": 50617
   },
   {
     "file": "test/World.t.sol",
@@ -309,43 +315,43 @@
     "file": "test/World.t.sol",
     "test": "testRegisterFallbackSystem",
     "name": "Register a fallback system",
-    "gasUsed": 59306
+    "gasUsed": 59347
   },
   {
     "file": "test/World.t.sol",
     "test": "testRegisterFallbackSystem",
     "name": "Register a root fallback system",
-    "gasUsed": 52950
+    "gasUsed": 52972
   },
   {
     "file": "test/World.t.sol",
     "test": "testRegisterFunctionSelector",
     "name": "Register a function selector",
-    "gasUsed": 79872
+    "gasUsed": 79913
   },
   {
     "file": "test/World.t.sol",
     "test": "testRegisterNamespace",
     "name": "Register a new namespace",
-    "gasUsed": 123269
+    "gasUsed": 123225
   },
   {
     "file": "test/World.t.sol",
     "test": "testRegisterRootFunctionSelector",
     "name": "Register a root function selector",
-    "gasUsed": 74863
+    "gasUsed": 74885
   },
   {
     "file": "test/World.t.sol",
     "test": "testRegisterSystem",
     "name": "register a system",
-    "gasUsed": 165750
+    "gasUsed": 165772
   },
   {
     "file": "test/World.t.sol",
     "test": "testRegisterTable",
     "name": "Register a new table in the namespace",
-    "gasUsed": 651802
+    "gasUsed": 651898
   },
   {
     "file": "test/World.t.sol",

packages/world/src/interfaces/IBaseWorld.sol

@@ -9,6 +9,7 @@ import { IWorldKernel } from "../interfaces/IWorldKernel.sol";
 import { ICoreSystem } from "./ICoreSystem.sol";
 import { IAccessManagementSystem } from "./IAccessManagementSystem.sol";
 import { IBalanceTransferSystem } from "./IBalanceTransferSystem.sol";
+import { ICallBatchSystem } from "./ICallBatchSystem.sol";
 import { IModuleInstallationSystem } from "./IModuleInstallationSystem.sol";
 import { IWorldRegistrationSystem } from "./IWorldRegistrationSystem.sol";
 
@@ -22,6 +23,7 @@ interface IBaseWorld is
   ICoreSystem,
   IAccessManagementSystem,
   IBalanceTransferSystem,
+  ICallBatchSystem,
   IModuleInstallationSystem,
   IWorldRegistrationSystem
 {

packages/world/src/interfaces/ICallBatchSystem.sol

@@ -0,0 +1,10 @@
+// SPDX-License-Identifier: MIT
+pragma solidity >=0.8.21;
+
+/* Autogenerated file. Do not edit manually. */
+
+import { SystemCallData } from "./../modules/core/types.sol";
+
+interface ICallBatchSystem {
+  function callBatch(SystemCallData[] calldata systemCalls) external returns (bytes[] memory returnDatas);
+}

packages/world/src/modules/core/CoreModule.sol

@@ -28,6 +28,7 @@ import { Balances } from "./tables/Balances.sol";
 
 import { AccessManagementSystem } from "./implementations/AccessManagementSystem.sol";
 import { BalanceTransferSystem } from "./implementations/BalanceTransferSystem.sol";
+import { CallBatchSystem } from "./implementations/CallBatchSystem.sol";
 import { ModuleInstallationSystem } from "./implementations/ModuleInstallationSystem.sol";
 import { StoreRegistrationSystem } from "./implementations/StoreRegistrationSystem.sol";
 import { WorldRegistrationSystem } from "./implementations/WorldRegistrationSystem.sol";
@@ -102,14 +103,16 @@ contract CoreModule is Module {
    * Register function selectors for all CoreSystem functions in the World
    */
   function _registerFunctionSelectors() internal {
-    bytes4[16] memory functionSelectors = [
+    bytes4[17] memory functionSelectors = [
       // --- AccessManagementSystem ---
       AccessManagementSystem.grantAccess.selector,
       AccessManagementSystem.revokeAccess.selector,
       AccessManagementSystem.transferOwnership.selector,
       // --- BalanceTransferSystem ---
       BalanceTransferSystem.transferBalanceToNamespace.selector,
       BalanceTransferSystem.transferBalanceToAddress.selector,
+      // --- CallBatchSystem ---
+      CallBatchSystem.callBatch.selector,
       // --- ModuleInstallationSystem ---
       ModuleInstallationSystem.installModule.selector,
       // --- StoreRegistrationSystem ---

packages/world/src/modules/core/CoreSystem.sol

@@ -5,6 +5,7 @@ import { IWorldErrors } from "../../interfaces/IWorldErrors.sol";
 
 import { AccessManagementSystem } from "./implementations/AccessManagementSystem.sol";
 import { BalanceTransferSystem } from "./implementations/BalanceTransferSystem.sol";
+import { CallBatchSystem } from "./implementations/CallBatchSystem.sol";
 import { ModuleInstallationSystem } from "./implementations/ModuleInstallationSystem.sol";
 import { StoreRegistrationSystem } from "./implementations/StoreRegistrationSystem.sol";
 import { WorldRegistrationSystem } from "./implementations/WorldRegistrationSystem.sol";
@@ -17,6 +18,7 @@ contract CoreSystem is
   IWorldErrors,
   AccessManagementSystem,
   BalanceTransferSystem,
+  CallBatchSystem,
   ModuleInstallationSystem,
   StoreRegistrationSystem,
   WorldRegistrationSystem

packages/world/src/modules/core/implementations/CallBatchSystem.sol

@@ -0,0 +1,27 @@
+// SPDX-License-Identifier: MIT
+pragma solidity >=0.8.0;
+
+import { System } from "../../../System.sol";
+import { IBaseWorld } from "../../../interfaces/IBaseWorld.sol";
+import { revertWithBytes } from "../../../revertWithBytes.sol";
+
+import { SystemCallData } from "../types.sol";
+
+contract CallBatchSystem is System {
+  /**
+   * Batch calls to multiple systems into a single transaction, return the array of return data.
+   */
+  function callBatch(SystemCallData[] calldata systemCalls) public returns (bytes[] memory returnDatas) {
+    IBaseWorld world = IBaseWorld(_world());
+    returnDatas = new bytes[](systemCalls.length);
+
+    for (uint256 i; i < systemCalls.length; i++) {
+      (bool success, bytes memory returnData) = address(world).delegatecall(
+        abi.encodeCall(world.call, (systemCalls[i].systemId, systemCalls[i].callData))
+      );
+      if (!success) revertWithBytes(returnData);
+
+      returnDatas[i] = abi.decode(returnData, (bytes));
+    }
+  }
+}

packages/world/src/modules/core/types.sol

@@ -0,0 +1,9 @@
+// SPDX-License-Identifier: MIT
+pragma solidity >=0.8.21;
+
+import { ResourceId } from "@latticexyz/store/src/ResourceId.sol";
+
+struct SystemCallData {
+  ResourceId systemId;
+  bytes callData;
+}