create-mud 2.0.0-alpha.1.21 → 2.0.0-alpha.1.211

package/dist/templates/phaser/packages/client/vite.config.ts

@@ -0,0 +1,15 @@
+import { defineConfig } from "vite";
+import react from "@vitejs/plugin-react";
+
+export default defineConfig({
+  plugins: [react()],
+  server: {
+    port: 3000,
+    fs: {
+      strict: false,
+    },
+  },
+  build: {
+    target: "es2022",
+  },
+});

package/dist/templates/phaser/packages/contracts/.env

@@ -0,0 +1,8 @@
+# This .env file is for demonstration purposes only.
+#
+# This should usually be excluded via .gitignore and the env vars attached to
+# your deployment enviroment, but we're including this here for ease of local
+# development. Please do not commit changes to this file!
+#
+# Anvil default private key:
+PRIVATE_KEY=0xac0974bec39a17e36ba4a6b4d238ff944bacb478cbed5efcae784d7bf4f2ff80

package/dist/templates/{minimal → phaser}/packages/contracts/.gitignore

@@ -3,8 +3,9 @@ cache/
 node_modules/
 bindings/
 artifacts/
-deployments
 abi/
 types/
 broadcast/
-.env
+
+# Ignore MUD deploy artifacts
+deploys/**/*.json

package/dist/templates/{minimal → phaser}/packages/contracts/.solhint.json

@@ -1,5 +1,6 @@
 {
-  "extends": "solhint:recommended",
+  "extends": ["solhint:recommended", "mud"],
+  "plugins": ["mud"],
   "rules": {
     "compiler-version": ["error", ">=0.8.0"],
     "avoid-low-level-calls": "off",

package/dist/templates/phaser/packages/contracts/foundry.toml

@@ -0,0 +1,22 @@
+[profile.default]
+solc_version = "0.8.13"
+ffi = false
+fuzz_runs = 256
+optimizer = true
+optimizer_runs = 3000
+verbosity = 2
+src = "src"
+test = "test"
+out = "out"
+allow_paths = ["../../node_modules", "../../../../packages"]
+extra_output_files = [
+  "abi",
+  "evm.bytecode"
+]
+fs_permissions = [{ access = "read", path = "./"}]
+
+[profile.lattice-testnet]
+eth_rpc_url = "https://follower.testnet-chain.linfra.xyz"
+
+[profile.hackathon-testnet]
+eth_rpc_url = "https://lattice-goerli-sequencer.optimism.io"

package/dist/templates/phaser/packages/contracts/mud.config.ts

@@ -0,0 +1,10 @@
+import { mudConfig } from "@latticexyz/world/register";
+
+export default mudConfig({
+  tables: {
+    Counter: {
+      keySchema: {},
+      schema: "uint32",
+    },
+  },
+});

package/dist/templates/phaser/packages/contracts/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "contracts",
+  "version": "0.0.0",
+  "private": true,
+  "license": "MIT",
+  "scripts": {
+    "build": "forge clean && forge build",
+    "deploy": "pnpm run initialize && mud deploy",
+    "deploy:hackathon": "pnpm run initialize && mud deploy --profile=hackathon-testnet",
+    "deploy:testnet": "pnpm run initialize && mud deploy --profile=lattice-testnet",
+    "dev": "pnpm mud dev-contracts --tsgenOutput ../client/src/mud",
+    "initialize": "pnpm run tablegen && pnpm run worldgen && pnpm run build && pnpm run worldtypes && pnpm run tsgen",
+    "lint": "pnpm run prettier && pnpm run solhint",
+    "prettier": "prettier --write 'src/**/*.sol'",
+    "solhint": "solhint --config ./.solhint.json 'src/**/*.sol' --fix",
+    "tablegen": "mud tablegen",
+    "test": "tsc --noEmit && mud test",
+    "tsgen": "mud tsgen --configPath mud.config.ts --out ../client/src/mud",
+    "worldgen": "mud worldgen",
+    "worldtypes": "rimraf types && typechain --target=ethers-v5 out/IWorld.sol/IWorld.json"
+  },
+  "dependencies": {
+    "@ethersproject/abi": "^5.7.0",
+    "@ethersproject/bytes": "^5.7.0",
+    "@ethersproject/providers": "^5.7.2",
+    "@latticexyz/cli": "{{mud-version}}",
+    "@latticexyz/schema-type": "{{mud-version}}",
+    "@latticexyz/std-contracts": "{{mud-version}}",
+    "@latticexyz/store": "{{mud-version}}",
+    "@latticexyz/world": "{{mud-version}}",
+    "ethers": "^5.7.2"
+  },
+  "devDependencies": {
+    "@typechain/ethers-v5": "^10.2.0",
+    "@types/node": "^18.15.11",
+    "ds-test": "https://github.com/dapphub/ds-test.git#c9ce3f25bde29fc5eb9901842bf02850dfd2d084",
+    "forge-std": "https://github.com/foundry-rs/forge-std.git#b4f121555729b3afb3c5ffccb62ff4b6e2818fd3",
+    "prettier": "^2.6.2",
+    "prettier-plugin-solidity": "^1.0.0-beta.19",
+    "solhint": "^3.3.7",
+    "solhint-config-mud": "{{mud-version}}",
+    "solhint-plugin-mud": "{{mud-version}}",
+    "typechain": "^8.1.1"
+  }
+}

package/dist/templates/phaser/packages/contracts/remappings.txt

@@ -0,0 +1,3 @@
+ds-test/=./node_modules/ds-test/src/
+forge-std/=./node_modules/forge-std/src/
+@latticexyz/=./node_modules/@latticexyz/

package/dist/templates/phaser/packages/contracts/script/PostDeploy.s.sol

@@ -0,0 +1,17 @@
+// SPDX-License-Identifier: MIT
+pragma solidity >=0.8.0;
+
+import { Script } from "forge-std/Script.sol";
+import { console } from "forge-std/console.sol";
+import { IWorld } from "../src/codegen/world/IWorld.sol";
+
+contract PostDeploy is Script {
+  function run(address worldAddress) external {
+    // Load the private key from the `PRIVATE_KEY` environment variable (in .env)
+    uint256 deployerPrivateKey = vm.envUint("PRIVATE_KEY");
+
+    // Start broadcasting transactions from the deployer account
+    vm.startBroadcast(deployerPrivateKey);
+    vm.stopBroadcast();
+  }
+}

package/dist/templates/phaser/packages/contracts/src/codegen/Tables.sol

@@ -0,0 +1,6 @@
+// SPDX-License-Identifier: MIT
+pragma solidity >=0.8.0;
+
+/* Autogenerated file. Do not edit manually. */
+
+import { Counter, CounterTableId } from "./tables/Counter.sol";

package/dist/templates/phaser/packages/contracts/src/codegen/tables/Counter.sol

@@ -0,0 +1,120 @@
+// SPDX-License-Identifier: MIT
+pragma solidity >=0.8.0;
+
+/* Autogenerated file. Do not edit manually. */
+
+// Import schema type
+import { SchemaType } from "@latticexyz/schema-type/src/solidity/SchemaType.sol";
+
+// Import store internals
+import { IStore } from "@latticexyz/store/src/IStore.sol";
+import { StoreSwitch } from "@latticexyz/store/src/StoreSwitch.sol";
+import { StoreCore } from "@latticexyz/store/src/StoreCore.sol";
+import { Bytes } from "@latticexyz/store/src/Bytes.sol";
+import { Memory } from "@latticexyz/store/src/Memory.sol";
+import { SliceLib } from "@latticexyz/store/src/Slice.sol";
+import { EncodeArray } from "@latticexyz/store/src/tightcoder/EncodeArray.sol";
+import { Schema, SchemaLib } from "@latticexyz/store/src/Schema.sol";
+import { PackedCounter, PackedCounterLib } from "@latticexyz/store/src/PackedCounter.sol";
+
+bytes32 constant _tableId = bytes32(abi.encodePacked(bytes16(""), bytes16("Counter")));
+bytes32 constant CounterTableId = _tableId;
+
+library Counter {
+  /** Get the table's schema */
+  function getSchema() internal pure returns (Schema) {
+    SchemaType[] memory _schema = new SchemaType[](1);
+    _schema[0] = SchemaType.UINT32;
+
+    return SchemaLib.encode(_schema);
+  }
+
+  function getKeySchema() internal pure returns (Schema) {
+    SchemaType[] memory _schema = new SchemaType[](0);
+
+    return SchemaLib.encode(_schema);
+  }
+
+  /** Get the table's metadata */
+  function getMetadata() internal pure returns (string memory, string[] memory) {
+    string[] memory _fieldNames = new string[](1);
+    _fieldNames[0] = "value";
+    return ("Counter", _fieldNames);
+  }
+
+  /** Register the table's schema */
+  function registerSchema() internal {
+    StoreSwitch.registerSchema(_tableId, getSchema(), getKeySchema());
+  }
+
+  /** Register the table's schema (using the specified store) */
+  function registerSchema(IStore _store) internal {
+    _store.registerSchema(_tableId, getSchema(), getKeySchema());
+  }
+
+  /** Set the table's metadata */
+  function setMetadata() internal {
+    (string memory _tableName, string[] memory _fieldNames) = getMetadata();
+    StoreSwitch.setMetadata(_tableId, _tableName, _fieldNames);
+  }
+
+  /** Set the table's metadata (using the specified store) */
+  function setMetadata(IStore _store) internal {
+    (string memory _tableName, string[] memory _fieldNames) = getMetadata();
+    _store.setMetadata(_tableId, _tableName, _fieldNames);
+  }
+
+  /** Get value */
+  function get() internal view returns (uint32 value) {
+    bytes32[] memory _keyTuple = new bytes32[](0);
+
+    bytes memory _blob = StoreSwitch.getField(_tableId, _keyTuple, 0);
+    return (uint32(Bytes.slice4(_blob, 0)));
+  }
+
+  /** Get value (using the specified store) */
+  function get(IStore _store) internal view returns (uint32 value) {
+    bytes32[] memory _keyTuple = new bytes32[](0);
+
+    bytes memory _blob = _store.getField(_tableId, _keyTuple, 0);
+    return (uint32(Bytes.slice4(_blob, 0)));
+  }
+
+  /** Set value */
+  function set(uint32 value) internal {
+    bytes32[] memory _keyTuple = new bytes32[](0);
+
+    StoreSwitch.setField(_tableId, _keyTuple, 0, abi.encodePacked((value)));
+  }
+
+  /** Set value (using the specified store) */
+  function set(IStore _store, uint32 value) internal {
+    bytes32[] memory _keyTuple = new bytes32[](0);
+
+    _store.setField(_tableId, _keyTuple, 0, abi.encodePacked((value)));
+  }
+
+  /** Tightly pack full data using this table's schema */
+  function encode(uint32 value) internal view returns (bytes memory) {
+    return abi.encodePacked(value);
+  }
+
+  /** Encode keys as a bytes32 array using this table's schema */
+  function encodeKeyTuple() internal pure returns (bytes32[] memory _keyTuple) {
+    _keyTuple = new bytes32[](0);
+  }
+
+  /* Delete all data for given keys */
+  function deleteRecord() internal {
+    bytes32[] memory _keyTuple = new bytes32[](0);
+
+    StoreSwitch.deleteRecord(_tableId, _keyTuple);
+  }
+
+  /* Delete all data for given keys (using the specified store) */
+  function deleteRecord(IStore _store) internal {
+    bytes32[] memory _keyTuple = new bytes32[](0);
+
+    _store.deleteRecord(_tableId, _keyTuple);
+  }
+}

package/dist/templates/phaser/packages/contracts/src/codegen/world/IIncrementSystem.sol

@@ -0,0 +1,8 @@
+// SPDX-License-Identifier: MIT
+pragma solidity >=0.8.0;
+
+/* Autogenerated file. Do not edit manually. */
+
+interface IIncrementSystem {
+  function increment() external returns (uint32);
+}

package/dist/templates/phaser/packages/contracts/src/codegen/world/IWorld.sol

@@ -0,0 +1,16 @@
+// SPDX-License-Identifier: MIT
+pragma solidity >=0.8.0;
+
+/* Autogenerated file. Do not edit manually. */
+
+import { IBaseWorld } from "@latticexyz/world/src/interfaces/IBaseWorld.sol";
+
+import { IIncrementSystem } from "./IIncrementSystem.sol";
+
+/**
+ * The IWorld interface includes all systems dynamically added to the World
+ * during the deploy process.
+ */
+interface IWorld is IBaseWorld, IIncrementSystem {
+
+}

package/dist/templates/phaser/packages/contracts/src/systems/IncrementSystem.sol

@@ -0,0 +1,14 @@
+// SPDX-License-Identifier: MIT
+pragma solidity >=0.8.0;
+
+import { System } from "@latticexyz/world/src/System.sol";
+import { Counter } from "../codegen/Tables.sol";
+
+contract IncrementSystem is System {
+  function increment() public returns (uint32) {
+    uint32 counter = Counter.get();
+    uint32 newValue = counter + 1;
+    Counter.set(newValue);
+    return newValue;
+  }
+}

package/dist/templates/phaser/packages/contracts/test/CounterTest.t.sol

@@ -0,0 +1,38 @@
+// SPDX-License-Identifier: MIT
+pragma solidity >=0.8.0;
+
+import "forge-std/Test.sol";
+import { MudV2Test } from "@latticexyz/std-contracts/src/test/MudV2Test.t.sol";
+import { getKeysWithValue } from "@latticexyz/world/src/modules/keyswithvalue/getKeysWithValue.sol";
+
+import { IWorld } from "../src/codegen/world/IWorld.sol";
+import { Counter, CounterTableId } from "../src/codegen/Tables.sol";
+
+contract CounterTest is MudV2Test {
+  IWorld public world;
+
+  function setUp() public override {
+    super.setUp();
+    world = IWorld(worldAddress);
+  }
+
+  function testWorldExists() public {
+    uint256 codeSize;
+    address addr = worldAddress;
+    assembly {
+      codeSize := extcodesize(addr)
+    }
+    assertTrue(codeSize > 0);
+  }
+
+  function testCounter() public {
+    // Expect the counter to be 1 because it was incremented in the PostDeploy script.
+    uint32 counter = Counter.get(world);
+    assertEq(counter, 1);
+
+    // Expect the counter to be 2 after calling increment.
+    world.increment();
+    counter = Counter.get(world);
+    assertEq(counter, 2);
+  }
+}

package/dist/templates/phaser/packages/contracts/tsconfig.json

@@ -0,0 +1,13 @@
+// Visit https://aka.ms/tsconfig.json for all config options
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "module": "commonjs",
+    "strict": true,
+    "resolveJsonModule": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "moduleResolution": "node"
+  }
+}

package/dist/templates/phaser/packages/contracts/worlds.json

@@ -0,0 +1,5 @@
+{
+  "31337": {
+    "address": "0x5FbDB2315678afecb367f032d93F642f64180aa3"
+  }
+}

package/dist/templates/react/.eslintrc

@@ -0,0 +1,10 @@
+{
+  "root": true,
+  "parser": "@typescript-eslint/parser",
+  "plugins": ["@typescript-eslint"],
+  "extends": [
+    "eslint:recommended",
+    "plugin:@typescript-eslint/eslint-recommended",
+    "plugin:@typescript-eslint/recommended"
+  ]
+}

package/dist/templates/react/package.json

@@ -3,13 +3,23 @@
   "private": true,
   "scripts": {
     "build": "pnpm recursive run build",
-    "dev": "run-pty % pnpm dev:node % pnpm dev:client % pnpm dev:contracts",
+    "dev": "concurrently -n contracts,client -c cyan,magenta \"cd packages/contracts && pnpm run dev\" \"cd packages/client && pnpm run dev\"",
     "dev:client": "pnpm --filter 'client' run dev",
     "dev:contracts": "pnpm --filter 'contracts' dev",
-    "dev:node": "pnpm --filter 'contracts' devnode"
+    "foundry:up": "curl -L https://foundry.paradigm.xyz | bash && bash $HOME/.foundry/bin/foundryup",
+    "initialize": "pnpm recursive run initialize",
+    "mud:up": "pnpm recursive exec mud set-version -v canary && pnpm install",
+    "prepare": "(forge --version || pnpm foundry:up)",
+    "test": "pnpm recursive run test"
   },
   "devDependencies": {
-    "run-pty": "^4.0.3"
+    "@latticexyz/cli": "{{mud-version}}",
+    "@typescript-eslint/eslint-plugin": "5.46.1",
+    "@typescript-eslint/parser": "5.46.1",
+    "concurrently": "^8.0.1",
+    "eslint": "8.29.0",
+    "rimraf": "^3.0.2",
+    "typescript": "^4.9.5"
   },
   "engines": {
     "node": "18.x",

package/dist/templates/react/packages/client/.env

@@ -0,0 +1 @@
+VITE_CHAIN_ID=31337

package/dist/templates/react/packages/client/.eslintrc

@@ -1,16 +1,6 @@
 {
-  "env": {
-    "node": true
-  },
-  "parser": "@typescript-eslint/parser",
-  "plugins": ["@typescript-eslint", "react", "react-hooks"],
-  "extends": [
-    "eslint:recommended",
-    "plugin:@typescript-eslint/eslint-recommended",
-    "plugin:@typescript-eslint/recommended",
-    "plugin:react/recommended",
-    "plugin:react-hooks/recommended"
-  ],
+  "extends": ["../../.eslintrc", "plugin:react/recommended", "plugin:react-hooks/recommended"],
+  "plugins": ["react", "react-hooks"],
   "rules": {
     "react/react-in-jsx-scope": "off"
   }

package/dist/templates/react/packages/client/package.json

@@ -6,38 +6,35 @@
   "type": "module",
   "scripts": {
     "build": "vite build",
-    "dev": "vite",
-    "preview": "vite preview"
+    "dev": "wait-port localhost:8545 && vite",
+    "initialize": "pnpm build",
+    "preview": "vite preview",
+    "test": "tsc --noEmit"
   },
   "dependencies": {
-    "@improbable-eng/grpc-web": "^0.15.0",
+    "@ethersproject/providers": "^5.7.2",
+    "@latticexyz/common": "{{mud-version}}",
+    "@latticexyz/dev-tools": "{{mud-version}}",
     "@latticexyz/network": "{{mud-version}}",
     "@latticexyz/react": "{{mud-version}}",
     "@latticexyz/recs": "{{mud-version}}",
-    "@latticexyz/services": "{{mud-version}}",
+    "@latticexyz/schema-type": "{{mud-version}}",
     "@latticexyz/std-client": "{{mud-version}}",
     "@latticexyz/utils": "{{mud-version}}",
-    "async-mutex": "^0.4.0",
+    "@latticexyz/world": "{{mud-version}}",
+    "@wagmi/chains": "^0.2.22",
     "contracts": "workspace:*",
     "ethers": "^5.7.2",
-    "mobx": "^6.7.0",
-    "nice-grpc": "^2.0.1",
-    "nice-grpc-web": "^2.0.1",
-    "proxy-deep": "^3.1.1",
     "react": "^18.2.0",
-    "react-dom": "^18.2.0",
-    "threads": "^1.7.0"
+    "react-dom": "^18.2.0"
   },
   "devDependencies": {
-    "@types/react": "^18.0.26",
-    "@types/react-dom": "^18.0.9",
-    "@typescript-eslint/eslint-plugin": "^5.46.1",
-    "@typescript-eslint/parser": "^5.46.1",
-    "@vitejs/plugin-react": "^3.0.0",
-    "eslint": "^8.29.0",
-    "eslint-plugin-react": "^7.31.11",
-    "eslint-plugin-react-hooks": "^4.6.0",
-    "typescript": "^4.9.5",
-    "vite": "^4.2.1"
+    "@types/react": "^18.2.6",
+    "@types/react-dom": "^18.2.4",
+    "@vitejs/plugin-react": "^3.1.0",
+    "eslint-plugin-react": "7.31.11",
+    "eslint-plugin-react-hooks": "4.6.0",
+    "vite": "^4.2.1",
+    "wait-port": "^1.0.4"
   }
 }

package/dist/templates/react/packages/client/src/App.tsx

@@ -1,17 +1,15 @@
-import { SingletonID, TxQueue } from "@latticexyz/network";
-import { World } from "@latticexyz/recs";
-import { SystemTypes } from "contracts/types/SystemTypes";
 import { useComponentValue } from "@latticexyz/react";
-import { components, singletonIndex } from ".";
+import { useMUD } from "./MUDContext";
 
-type Props = {
-  world: World;
-  systems: TxQueue<SystemTypes>;
-  components: typeof components;
-};
+export const App = () => {
+  const {
+    components: { Counter },
+    systemCalls: { increment },
+    network: { singletonEntity },
+  } = useMUD();
+
+  const counter = useComponentValue(Counter, singletonEntity);
 
-export const App = ({ systems, components }: Props) => {
-  const counter = useComponentValue(components.Counter, singletonIndex);
   return (
     <>
       <div>
@@ -19,9 +17,9 @@ export const App = ({ systems, components }: Props) => {
       </div>
       <button
         type="button"
-        onClick={(event) => {
+        onClick={async (event) => {
           event.preventDefault();
-          systems["system.Increment"].executeTyped(SingletonID);
+          console.log("new counter value:", await increment());
         }}
       >
         Increment

package/dist/templates/react/packages/client/src/MUDContext.tsx

@@ -0,0 +1,21 @@
+import { createContext, ReactNode, useContext } from "react";
+import { SetupResult } from "./mud/setup";
+
+const MUDContext = createContext<SetupResult | null>(null);
+
+type Props = {
+  children: ReactNode;
+  value: SetupResult;
+};
+
+export const MUDProvider = ({ children, value }: Props) => {
+  const currentValue = useContext(MUDContext);
+  if (currentValue) throw new Error("MUDProvider can only be used once");
+  return <MUDContext.Provider value={value}>{children}</MUDContext.Provider>;
+};
+
+export const useMUD = () => {
+  const value = useContext(MUDContext);
+  if (!value) throw new Error("Must be used within a MUDProvider");
+  return value;
+};

package/dist/templates/react/packages/client/src/index.tsx

@@ -1,38 +1,19 @@
 import ReactDOM from "react-dom/client";
-import { setupMUDNetwork } from "@latticexyz/std-client";
-import { createWorld } from "@latticexyz/recs";
-import { SystemTypes } from "contracts/types/SystemTypes";
-import { SystemAbis } from "contracts/types/SystemAbis.mjs";
-import { defineNumberComponent } from "@latticexyz/std-client";
-import { config } from "./config";
+import { mount as mountDevTools } from "@latticexyz/dev-tools";
 import { App } from "./App";
-import { SingletonID } from "@latticexyz/network";
+import { setup } from "./mud/setup";
+import { MUDProvider } from "./MUDContext";
 
 const rootElement = document.getElementById("react-root");
 if (!rootElement) throw new Error("React root not found");
 const root = ReactDOM.createRoot(rootElement);
 
-// The world contains references to all entities, all components and disposers.
-const world = createWorld();
-export const singletonIndex = world.registerEntity({ id: SingletonID });
-
-// Components contain the application state.
-// If a contractId is provided, MUD syncs the state with the corresponding
-// component contract (in this case `CounterComponent.sol`)
-export const components = {
-  Counter: defineNumberComponent(world, {
-    metadata: {
-      contractId: "component.Counter",
-    },
-  }),
-};
-
-// This is where the magic happens
-setupMUDNetwork<typeof components, SystemTypes>(config, world, components, SystemAbis).then(
-  ({ startSync, systems }) => {
-    // After setting up the network, we can tell MUD to start the synchronization process.
-    startSync();
-
-    root.render(<App world={world} systems={systems} components={components} />);
-  }
-);
+// TODO: figure out if we actually want this to be async or if we should render something else in the meantime
+setup().then((result) => {
+  root.render(
+    <MUDProvider value={result}>
+      <App />
+    </MUDProvider>
+  );
+  mountDevTools();
+});

package/dist/templates/react/packages/client/src/mud/contractComponents.ts

@@ -0,0 +1,24 @@
+/* Autogenerated file. Do not edit manually. */
+
+import { TableId } from "@latticexyz/utils";
+import { defineComponent, Type as RecsType, World } from "@latticexyz/recs";
+
+export function defineContractComponents(world: World) {
+  return {
+    Counter: (() => {
+      const tableId = new TableId("", "Counter");
+      return defineComponent(
+        world,
+        {
+          value: RecsType.Number,
+        },
+        {
+          metadata: {
+            contractId: tableId.toHexString(),
+            tableId: tableId.toString(),
+          },
+        }
+      );
+    })(),
+  };
+}

package/dist/templates/react/packages/client/src/mud/createClientComponents.ts

@@ -0,0 +1,10 @@
+import { SetupNetworkResult } from "./setupNetwork";
+
+export type ClientComponents = ReturnType<typeof createClientComponents>;
+
+export function createClientComponents({ components }: SetupNetworkResult) {
+  return {
+    ...components,
+    // add your client components or overrides here
+  };
+}