@latticexyz/world 2.2.20-31870811b975d44f4b5d14ae69fd623914237584 → 2.2.20-b774ab28b3de6cefcbfce5e1bb6fcb68b9374abf

package/dist/{chunk-NVV4GS3R.js → chunk-2W4TKC47.js}

@@ -7,7 +7,7 @@ import {
   resolveSystems,
   validateNamespace,
   validateSystems
-} from "./chunk-6E2JY6MZ.js";
+} from "./chunk-XSBK355I.js";
 
 // ts/config/v2/namespaces.ts
 import { flatMorph } from "@ark/util";
@@ -111,4 +111,4 @@ export {
   resolveWorld,
   defineWorld
 };
-//# sourceMappingURL=chunk-NVV4GS3R.js.map
+//# sourceMappingURL=chunk-2W4TKC47.js.map

package/dist/{chunk-6KRKTNJ5.js → chunk-SGZK356L.js}

@@ -1,10 +1,16 @@
 import {
   defineWorld
-} from "./chunk-NVV4GS3R.js";
+} from "./chunk-2W4TKC47.js";
 
 // mud.config.ts
-var tablesConfig = defineWorld({
+var configInput = {
   namespace: "world",
+  // NOTE: this namespace is only used for tables, the core system is deployed in the root namespace.
+  codegen: {
+    worldImportPath: "./src",
+    worldgenDirectory: "interfaces",
+    worldInterfaceName: "IBaseWorld"
+  },
   userTypes: {
     ResourceId: { filePath: "@latticexyz/store/src/ResourceId.sol", type: "bytes32" }
   },
@@ -105,48 +111,22 @@ var tablesConfig = defineWorld({
       },
       key: []
     }
-  }
-});
-var systemsConfig = defineWorld({
-  namespace: "",
-  codegen: {
-    worldImportPath: "./src",
-    worldgenDirectory: "interfaces",
-    worldInterfaceName: "IBaseWorld",
-    generateSystemLibraries: true,
-    systemLibrariesDirectory: "experimental/systems"
   },
-  // Keep aligned with src/modules/init/constants.sol
-  systems: {
-    AccessManagementSystem: {
-      name: "AccessManagement"
-    },
-    BalanceTransferSystem: {
-      name: "BalanceTransfer"
-    },
-    BatchCallSystem: {
-      name: "BatchCall"
-    },
-    RegistrationSystem: {
-      name: "Registration"
-    },
-    // abstract systems that are deployed as part of RegistrationSystem
-    ModuleInstallationSystem: {
-      name: "Registration"
-    },
-    StoreRegistrationSystem: {
-      name: "Registration"
-    },
-    WorldRegistrationSystem: {
-      name: "Registration"
-    }
-  }
-});
-var mud_config_default = tablesConfig;
+  excludeSystems: [
+    // Worldgen currently does not support systems inheriting logic
+    // from other contracts, so all parts of RegistrationSystem are named
+    // System too to be included in the IBaseWorld interface.
+    // However, IStoreRegistrationSystem overlaps with IStore if
+    // included in IBaseWorld, so it needs to be excluded from worldgen.
+    // TODO: add support for inheritance to worldgen
+    // (see: https://github.com/latticexyz/mud/issues/631)
+    "StoreRegistrationSystem"
+  ]
+};
+var mud_config_default = defineWorld(configInput);
 
 export {
-  tablesConfig,
-  systemsConfig,
+  configInput,
   mud_config_default
 };
-//# sourceMappingURL=chunk-6KRKTNJ5.js.map
+//# sourceMappingURL=chunk-SGZK356L.js.map

package/dist/chunk-SGZK356L.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../mud.config.ts"],"sourcesContent":["import { defineWorld } from \"./ts/config/v2/world\";\n\n/**\n * @internal\n */\nexport const configInput = {\n  namespace: \"world\", // NOTE: this namespace is only used for tables, the core system is deployed in the root namespace.\n  codegen: {\n    worldImportPath: \"./src\",\n    worldgenDirectory: \"interfaces\",\n    worldInterfaceName: \"IBaseWorld\",\n  },\n  userTypes: {\n    ResourceId: { filePath: \"@latticexyz/store/src/ResourceId.sol\", type: \"bytes32\" },\n  },\n  tables: {\n    NamespaceOwner: {\n      schema: {\n        namespaceId: \"ResourceId\",\n        owner: \"address\",\n      },\n      key: [\"namespaceId\"],\n    },\n    ResourceAccess: {\n      schema: {\n        resourceId: \"ResourceId\",\n        caller: \"address\",\n        access: \"bool\",\n      },\n      key: [\"resourceId\", \"caller\"],\n    },\n    InstalledModules: {\n      schema: {\n        moduleAddress: \"address\",\n        argumentsHash: \"bytes32\", // Hash of the params passed to the `install` function\n        isInstalled: \"bool\",\n      },\n      key: [\"moduleAddress\", \"argumentsHash\"],\n    },\n    UserDelegationControl: {\n      schema: {\n        delegator: \"address\",\n        delegatee: \"address\",\n        delegationControlId: \"ResourceId\",\n      },\n      key: [\"delegator\", \"delegatee\"],\n    },\n    NamespaceDelegationControl: {\n      schema: {\n        namespaceId: \"ResourceId\",\n        delegationControlId: \"ResourceId\",\n      },\n      key: [\"namespaceId\"],\n    },\n    Balances: {\n      schema: {\n        namespaceId: \"ResourceId\",\n        balance: \"uint256\",\n      },\n      key: [\"namespaceId\"],\n    },\n    Systems: {\n      schema: {\n        systemId: \"ResourceId\",\n        system: \"address\",\n        publicAccess: \"bool\",\n      },\n      key: [\"systemId\"],\n      codegen: {\n        dataStruct: false,\n      },\n    },\n    SystemRegistry: {\n      schema: {\n        system: \"address\",\n        systemId: \"ResourceId\",\n      },\n      key: [\"system\"],\n    },\n    SystemHooks: {\n      schema: {\n        systemId: \"ResourceId\",\n        value: \"bytes21[]\",\n      },\n      key: [\"systemId\"],\n    },\n    FunctionSelectors: {\n      schema: {\n        worldFunctionSelector: \"bytes4\",\n        systemId: \"ResourceId\",\n        systemFunctionSelector: \"bytes4\",\n      },\n      key: [\"worldFunctionSelector\"],\n      codegen: {\n        dataStruct: false,\n      },\n    },\n    FunctionSignatures: {\n      type: \"offchainTable\",\n      schema: {\n        functionSelector: \"bytes4\",\n        functionSignature: \"string\",\n      },\n      key: [\"functionSelector\"],\n    },\n    InitModuleAddress: {\n      schema: {\n        value: \"address\",\n      },\n      key: [],\n    },\n  },\n  excludeSystems: [\n    // Worldgen currently does not support systems inheriting logic\n    // from other contracts, so all parts of RegistrationSystem are named\n    // System too to be included in the IBaseWorld interface.\n    // However, IStoreRegistrationSystem overlaps with IStore if\n    // included in IBaseWorld, so it needs to be excluded from worldgen.\n    // TODO: add support for inheritance to worldgen\n    // (see: https://github.com/latticexyz/mud/issues/631)\n    \"StoreRegistrationSystem\",\n  ],\n} as const;\n\nexport default defineWorld(configInput);\n"],"mappings":";;;;;AAKO,IAAM,cAAc;AAAA,EACzB,WAAW;AAAA;AAAA,EACX,SAAS;AAAA,IACP,iBAAiB;AAAA,IACjB,mBAAmB;AAAA,IACnB,oBAAoB;AAAA,EACtB;AAAA,EACA,WAAW;AAAA,IACT,YAAY,EAAE,UAAU,wCAAwC,MAAM,UAAU;AAAA,EAClF;AAAA,EACA,QAAQ;AAAA,IACN,gBAAgB;AAAA,MACd,QAAQ;AAAA,QACN,aAAa;AAAA,QACb,OAAO;AAAA,MACT;AAAA,MACA,KAAK,CAAC,aAAa;AAAA,IACrB;AAAA,IACA,gBAAgB;AAAA,MACd,QAAQ;AAAA,QACN,YAAY;AAAA,QACZ,QAAQ;AAAA,QACR,QAAQ;AAAA,MACV;AAAA,MACA,KAAK,CAAC,cAAc,QAAQ;AAAA,IAC9B;AAAA,IACA,kBAAkB;AAAA,MAChB,QAAQ;AAAA,QACN,eAAe;AAAA,QACf,eAAe;AAAA;AAAA,QACf,aAAa;AAAA,MACf;AAAA,MACA,KAAK,CAAC,iBAAiB,eAAe;AAAA,IACxC;AAAA,IACA,uBAAuB;AAAA,MACrB,QAAQ;AAAA,QACN,WAAW;AAAA,QACX,WAAW;AAAA,QACX,qBAAqB;AAAA,MACvB;AAAA,MACA,KAAK,CAAC,aAAa,WAAW;AAAA,IAChC;AAAA,IACA,4BAA4B;AAAA,MAC1B,QAAQ;AAAA,QACN,aAAa;AAAA,QACb,qBAAqB;AAAA,MACvB;AAAA,MACA,KAAK,CAAC,aAAa;AAAA,IACrB;AAAA,IACA,UAAU;AAAA,MACR,QAAQ;AAAA,QACN,aAAa;AAAA,QACb,SAAS;AAAA,MACX;AAAA,MACA,KAAK,CAAC,aAAa;AAAA,IACrB;AAAA,IACA,SAAS;AAAA,MACP,QAAQ;AAAA,QACN,UAAU;AAAA,QACV,QAAQ;AAAA,QACR,cAAc;AAAA,MAChB;AAAA,MACA,KAAK,CAAC,UAAU;AAAA,MAChB,SAAS;AAAA,QACP,YAAY;AAAA,MACd;AAAA,IACF;AAAA,IACA,gBAAgB;AAAA,MACd,QAAQ;AAAA,QACN,QAAQ;AAAA,QACR,UAAU;AAAA,MACZ;AAAA,MACA,KAAK,CAAC,QAAQ;AAAA,IAChB;AAAA,IACA,aAAa;AAAA,MACX,QAAQ;AAAA,QACN,UAAU;AAAA,QACV,OAAO;AAAA,MACT;AAAA,MACA,KAAK,CAAC,UAAU;AAAA,IAClB;AAAA,IACA,mBAAmB;AAAA,MACjB,QAAQ;AAAA,QACN,uBAAuB;AAAA,QACvB,UAAU;AAAA,QACV,wBAAwB;AAAA,MAC1B;AAAA,MACA,KAAK,CAAC,uBAAuB;AAAA,MAC7B,SAAS;AAAA,QACP,YAAY;AAAA,MACd;AAAA,IACF;AAAA,IACA,oBAAoB;AAAA,MAClB,MAAM;AAAA,MACN,QAAQ;AAAA,QACN,kBAAkB;AAAA,QAClB,mBAAmB;AAAA,MACrB;AAAA,MACA,KAAK,CAAC,kBAAkB;AAAA,IAC1B;AAAA,IACA,mBAAmB;AAAA,MACjB,QAAQ;AAAA,QACN,OAAO;AAAA,MACT;AAAA,MACA,KAAK,CAAC;AAAA,IACR;AAAA,EACF;AAAA,EACA,gBAAgB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAQd;AAAA,EACF;AACF;AAEA,IAAO,qBAAQ,YAAY,WAAW;","names":[]}

package/dist/{chunk-6E2JY6MZ.js → chunk-XSBK355I.js}

@@ -10,7 +10,6 @@ var SYSTEM_DEFAULTS = {
 };
 var MODULE_DEFAULTS = {
   root: false,
-  useDelegation: false,
   args: [],
   artifactPath: void 0
 };
@@ -140,4 +139,4 @@ export {
   validateNamespace,
   resolveNamespace
 };
-//# sourceMappingURL=chunk-6E2JY6MZ.js.map
+//# sourceMappingURL=chunk-XSBK355I.js.map

package/dist/chunk-XSBK355I.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../ts/config/v2/defaults.ts","../ts/config/v2/system.ts","../ts/config/v2/systems.ts","../ts/config/v2/namespace.ts"],"sourcesContent":["import { CodegenInput, DeployInput, ModuleInput, SystemDeployInput, SystemInput, WorldInput } from \"./input\";\n\nexport const SYSTEM_DEPLOY_DEFAULTS = {\n  disabled: false,\n  registerWorldFunctions: true,\n} as const satisfies Required<SystemDeployInput>;\n\nexport type SYSTEM_DEPLOY_DEFAULTS = typeof SYSTEM_DEPLOY_DEFAULTS;\n\nexport const SYSTEM_DEFAULTS = {\n  namespaceLabel: \"\",\n  openAccess: true,\n  accessList: [],\n} as const satisfies Omit<Required<SystemInput>, \"label\" | \"namespace\" | \"name\" | \"deploy\">;\n\nexport type SYSTEM_DEFAULTS = typeof SYSTEM_DEFAULTS;\n\nexport const MODULE_DEFAULTS = {\n  root: false,\n  args: [],\n  artifactPath: undefined,\n} as const satisfies Pick<ModuleInput, \"root\" | \"args\" | \"artifactPath\">;\n\nexport type MODULE_DEFAULTS = typeof MODULE_DEFAULTS;\n\nexport const CODEGEN_DEFAULTS = {\n  worldInterfaceName: \"IWorld\",\n  worldgenDirectory: \"world\",\n  systemLibrariesDirectory: \"systems\",\n  generateSystemLibraries: false,\n  worldImportPath: \"@latticexyz/world/src\",\n} as const satisfies CodegenInput;\n\nexport type CODEGEN_DEFAULTS = typeof CODEGEN_DEFAULTS;\n\nexport const DEPLOY_DEFAULTS = {\n  postDeployScript: \"PostDeploy\",\n  deploysDirectory: \"./deploys\",\n  worldsFile: \"./worlds.json\",\n  upgradeableWorldImplementation: false,\n} as const satisfies DeployInput;\n\nexport type DEPLOY_DEFAULTS = typeof DEPLOY_DEFAULTS;\n\nexport const CONFIG_DEFAULTS = {\n  systems: {},\n  tables: {},\n  excludeSystems: [],\n  modules: [],\n  codegen: CODEGEN_DEFAULTS,\n  deploy: DEPLOY_DEFAULTS,\n} as const satisfies WorldInput;\n\nexport type CONFIG_DEFAULTS = typeof CONFIG_DEFAULTS;\n","import { SYSTEM_DEFAULTS, SYSTEM_DEPLOY_DEFAULTS } from \"./defaults\";\nimport { SystemInput } from \"./input\";\nimport { hasOwnKey, mergeIfUndefined } from \"@latticexyz/store/internal\";\nimport { ErrorMessage, narrow, requiredKeyOf, show } from \"@ark/util\";\nimport { Hex } from \"viem\";\nimport { resourceToHex } from \"@latticexyz/common\";\n\nexport type ValidateSystemOptions = { readonly inNamespace?: true };\n\nexport type requiredSystemKey<inNamespace extends true | undefined> = Exclude<\n  requiredKeyOf<SystemInput>,\n  inNamespace extends true ? \"label\" | \"namespaceLabel\" | \"namespace\" : never\n>;\n\nexport type validateSystem<input, options extends ValidateSystemOptions = {}> = {\n  [key in keyof input | requiredSystemKey<options[\"inNamespace\"]>]: key extends keyof SystemInput\n    ? key extends \"label\" | \"namespaceLabel\" | \"namespace\"\n      ? options[\"inNamespace\"] extends true\n        ? ErrorMessage<\"Overrides of `label`, `namespaceLabel`, and `namespace` are not allowed for systems in this context.\">\n        : key extends keyof input\n          ? narrow<input[key]>\n          : never\n      : SystemInput[key]\n    : ErrorMessage<`Key \\`${key & string}\\` does not exist in SystemInput`>;\n};\n\nexport function validateSystem<input>(\n  input: input,\n  options: ValidateSystemOptions = {},\n): asserts input is SystemInput & input {\n  if (typeof input !== \"object\" || input == null) {\n    throw new Error(`Expected full system config, got \\`${JSON.stringify(input)}\\``);\n  }\n\n  if (\n    options.inNamespace &&\n    (hasOwnKey(input, \"label\") || hasOwnKey(input, \"namespaceLabel\") || hasOwnKey(input, \"namespace\"))\n  ) {\n    throw new Error(\n      \"Overrides of `label`, `namespaceLabel`, and `namespace` are not allowed for systems in this context.\",\n    );\n  }\n\n  if (\n    hasOwnKey(input, \"namespaceLabel\") &&\n    typeof input.namespaceLabel === \"string\" &&\n    (!hasOwnKey(input, \"namespace\") || typeof input.namespace !== \"string\") &&\n    input.namespaceLabel.length > 14\n  ) {\n    throw new Error(\n      `System \\`namespace\\` defaults to \\`namespaceLabel\\`, but must fit into a \\`bytes14\\` and \"${input.namespaceLabel}\" is too long. Provide explicit \\`namespace\\` override.`,\n    );\n  }\n\n  if (hasOwnKey(input, \"namespace\") && typeof input.namespace === \"string\" && input.namespace.length > 14) {\n    throw new Error(`System \\`namespace\\` must fit into a \\`bytes14\\`, but \"${input.namespace}\" is too long.`);\n  }\n  if (hasOwnKey(input, \"name\") && typeof input.name === \"string\" && input.name.length > 16) {\n    throw new Error(`System \\`name\\` must fit into a \\`bytes16\\`, but \"${input.name}\" is too long.`);\n  }\n}\n\nexport type resolveSystem<input> = input extends SystemInput\n  ? {\n      readonly label: input[\"label\"];\n      readonly namespaceLabel: undefined extends input[\"namespaceLabel\"]\n        ? typeof SYSTEM_DEFAULTS.namespaceLabel\n        : input[\"namespaceLabel\"];\n      readonly namespace: string;\n      readonly name: string;\n      readonly systemId: Hex;\n      readonly openAccess: undefined extends input[\"openAccess\"] ? SYSTEM_DEFAULTS[\"openAccess\"] : input[\"openAccess\"];\n      readonly accessList: undefined extends input[\"accessList\"] ? SYSTEM_DEFAULTS[\"accessList\"] : input[\"accessList\"];\n      readonly deploy: show<\n        mergeIfUndefined<undefined extends input[\"deploy\"] ? {} : input[\"deploy\"], SYSTEM_DEPLOY_DEFAULTS>\n      >;\n    }\n  : never;\n\nexport function resolveSystem<input extends SystemInput>(input: input): resolveSystem<input> {\n  const namespaceLabel = input.namespaceLabel ?? SYSTEM_DEFAULTS.namespaceLabel;\n  // validate ensures this is length constrained\n  const namespace = input.namespace ?? namespaceLabel;\n\n  const label = input.label;\n  const name = input.name ?? label.slice(0, 16);\n  const systemId = resourceToHex({ type: \"system\", namespace, name });\n\n  return mergeIfUndefined(\n    {\n      ...input,\n      label,\n      namespaceLabel,\n      namespace,\n      name,\n      systemId,\n      deploy: mergeIfUndefined(input.deploy ?? {}, SYSTEM_DEPLOY_DEFAULTS),\n    },\n    SYSTEM_DEFAULTS,\n  ) as never;\n}\n\nexport function defineSystem<input>(input: validateSystem<input>): resolveSystem<input> {\n  validateSystem(input);\n  return resolveSystem(input) as never;\n}\n","import { ErrorMessage } from \"@ark/util\";\nimport { isObject } from \"@latticexyz/store/internal\";\nimport { SystemsInput } from \"./input\";\nimport { resolveSystem, validateSystem } from \"./system\";\n\n// TODO: add nuance between \"in namespace\" (namespace provided in context) and \"in systems\" (label provided in context)\n\nexport type validateSystems<input> = {\n  [label in keyof input]: input[label] extends object\n    ? validateSystem<input[label], { inNamespace: true }>\n    : ErrorMessage<`Expected a system config for ${label & string}.`>;\n};\n\nexport function validateSystems(input: unknown): asserts input is SystemsInput {\n  if (isObject(input)) {\n    for (const system of Object.values(input)) {\n      validateSystem(system, { inNamespace: true });\n    }\n    return;\n  }\n  throw new Error(`Expected system config, received ${JSON.stringify(input)}`);\n}\n\nexport type resolveSystems<systems extends SystemsInput, namespaceLabel extends string> = {\n  [label in keyof systems]: resolveSystem<\n    systems[label] & { label: label; namespaceLabel: namespaceLabel; namespace: string }\n  >;\n};\n\nexport function resolveSystems<systems extends SystemsInput, namespaceLabel extends string>(\n  systems: systems,\n  namespaceLabel: namespaceLabel,\n  namespace: string,\n): resolveSystems<systems, namespaceLabel> {\n  return Object.fromEntries(\n    Object.entries(systems).map(([label, system]) => {\n      return [label, resolveSystem({ ...system, label, namespaceLabel, namespace })];\n    }),\n  ) as never;\n}\n","import { NamespaceInput, SystemsInput } from \"./input\";\nimport {\n  hasOwnKey,\n  validateNamespace as validateStoreNamespace,\n  resolveNamespace as resolveStoreNamespace,\n  Scope,\n  AbiTypeScope,\n} from \"@latticexyz/store/internal\";\nimport { resolveSystems, validateSystems } from \"./systems\";\nimport { show } from \"@ark/util\";\n\nexport type validateNamespace<input, scope extends Scope = AbiTypeScope> = {\n  [key in keyof input]: key extends \"systems\" ? validateSystems<input[key]> : validateStoreNamespace<input, scope>[key];\n};\n\nexport function validateNamespace<scope extends Scope = AbiTypeScope>(\n  input: unknown,\n  scope: scope,\n): asserts input is NamespaceInput {\n  if (hasOwnKey(input, \"systems\")) {\n    validateSystems(input.systems);\n  }\n  validateStoreNamespace(input, scope);\n}\n\nexport type resolveNamespace<input, scope extends Scope = AbiTypeScope> = input extends NamespaceInput\n  ? show<\n      resolveStoreNamespace<input, scope> & {\n        readonly systems: input[\"systems\"] extends SystemsInput\n          ? show<resolveSystems<input[\"systems\"], resolveStoreNamespace<input, scope>[\"label\"]>>\n          : {};\n      }\n    >\n  : never;\n\nexport function resolveNamespace<const input extends NamespaceInput, scope extends Scope = AbiTypeScope>(\n  input: input,\n  scope: scope = AbiTypeScope as never,\n): resolveNamespace<input, scope> {\n  const namespace = resolveStoreNamespace(input, scope);\n  const systems = resolveSystems(input.systems ?? {}, namespace.label, namespace.namespace);\n  return {\n    ...namespace,\n    systems,\n  } as never;\n}\n"],"mappings":"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","names":["hasOwnKey","hasOwnKey"]}

package/dist/{dynamicResolution-Bul4y_B0.d.ts → dynamicResolution-AmVd5Qtd.d.ts}

@@ -3,14 +3,13 @@ import { Namespace as Namespace$1 } from '@latticexyz/store/internal';
 import { Hex } from 'viem';
 
 type Module = {
-    /** Should this module be installed as a root module? */
-    readonly root: boolean;
     /**
-     * Allow the module to call systems on your behalf.
-     * Useful when modules need to create namespaces or
-     * upgrade systems in namespaces you own.
+     * The name of the module
+     * @deprecated
      */
-    readonly useDelegation: boolean;
+    readonly name?: string;
+    /** Should this module be installed as a root module? */
+    readonly root: boolean;
     /** Arguments to be passed to the module's install method */
     readonly args: readonly (ValueWithType | DynamicResolution)[];
     /**
@@ -23,11 +22,6 @@ type Module = {
      * If not provided, it's assumed that this is a local module as part of the project's source and the artifact will be looked up in forge's output directory.
      */
     readonly artifactPath: string | undefined;
-    /**
-     * The name of the module
-     * @deprecated
-     */
-    readonly name?: string;
 };
 type SystemDeploy = {
     /**

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-export { W as WorldInput, d as defineWorld } from './world-NqdA4pfW.js';
-export { W as World } from './dynamicResolution-Bul4y_B0.js';
+export { W as WorldInput, d as defineWorld } from './world-Nl5BmMma.js';
+export { W as World } from './dynamicResolution-AmVd5Qtd.js';
 import '@ark/util';
 import '@latticexyz/store/internal';
 import 'viem';

package/dist/index.js

@@ -1,7 +1,7 @@
 import {
   defineWorld
-} from "./chunk-NVV4GS3R.js";
-import "./chunk-6E2JY6MZ.js";
+} from "./chunk-2W4TKC47.js";
+import "./chunk-XSBK355I.js";
 import "./chunk-5WRI5ZAA.js";
 
 // ts/worldEvents.ts

package/dist/internal.d.ts

@@ -1,7 +1,7 @@
 import { Abi, ContractFunctionName, Hex, EncodeFunctionDataParameters, Address, Chain, Account, Client, Transport, WalletActions } from 'viem';
 import { AbiParametersToPrimitiveTypes, ExtractAbiFunction } from 'abitype';
-export { C as CODEGEN_DEFAULTS, b as CONFIG_DEFAULTS, k as CodegenInput, D as DEPLOY_DEFAULTS, j as DeployInput, M as MODULE_DEFAULTS, i as ModuleInput, N as NamespaceInput, h as NamespacesInput, a as SYSTEM_DEFAULTS, S as SYSTEM_DEPLOY_DEFAULTS, e as SystemDeployInput, f as SystemInput, g as SystemsInput, V as ValidateSystemOptions, W as WorldInput, o as defineNamespaces, t as defineSystem, d as defineWorld, p as requiredSystemKey, r as resolveCodegen, c as resolveDeploy, l as resolveNamespace, y as resolveNamespaceMode, n as resolveNamespaces, s as resolveSystem, w as resolveSystems, z as resolveWorld, v as validateNamespace, m as validateNamespaces, q as validateSystem, u as validateSystems, x as validateWorld } from './world-NqdA4pfW.js';
-export { C as Codegen, f as Deploy, D as DynamicResolution, M as Module, N as Namespace, e as Namespaces, c as System, S as SystemDeploy, d as Systems, V as ValueWithType, W as World, i as isDynamicResolution, a as isValueWithType, r as resolveTableId, b as resolveWithContext } from './dynamicResolution-Bul4y_B0.js';
+export { C as CODEGEN_DEFAULTS, b as CONFIG_DEFAULTS, k as CodegenInput, D as DEPLOY_DEFAULTS, j as DeployInput, M as MODULE_DEFAULTS, i as ModuleInput, N as NamespaceInput, h as NamespacesInput, a as SYSTEM_DEFAULTS, S as SYSTEM_DEPLOY_DEFAULTS, e as SystemDeployInput, f as SystemInput, g as SystemsInput, V as ValidateSystemOptions, W as WorldInput, o as defineNamespaces, t as defineSystem, d as defineWorld, p as requiredSystemKey, r as resolveCodegen, c as resolveDeploy, l as resolveNamespace, y as resolveNamespaceMode, n as resolveNamespaces, s as resolveSystem, w as resolveSystems, z as resolveWorld, v as validateNamespace, m as validateNamespaces, q as validateSystem, u as validateSystems, x as validateWorld } from './world-Nl5BmMma.js';
+export { C as Codegen, f as Deploy, D as DynamicResolution, M as Module, N as Namespace, e as Namespaces, c as System, S as SystemDeploy, d as Systems, V as ValueWithType, W as World, i as isDynamicResolution, a as isValueWithType, r as resolveTableId, b as resolveWithContext } from './dynamicResolution-AmVd5Qtd.js';
 import '@ark/util';
 import '@latticexyz/store/internal';
 import '@latticexyz/store';
@@ -126,21 +126,19 @@ declare const worldCallAbi: readonly [{
 type worldCallAbi = typeof worldCallAbi;
 
 type SystemCall<abi extends Abi, functionName extends ContractFunctionName<abi>> = {
-    [k in ContractFunctionName<abi>]: {
-        /**
-         * System's resource ID
-         */
-        readonly systemId: Hex;
-        /**
-         * System ABI
-         */
-        readonly abi: abi;
-        /**
-         * System function name to call
-         */
-        readonly functionName: k;
-    } & Pick<EncodeFunctionDataParameters<abi, k>, "args">;
-}[functionName];
+    /**
+     * System ABI
+     */
+    readonly abi: abi;
+    /**
+     * System's resource ID
+     */
+    readonly systemId: Hex;
+    /**
+     * System function name to call
+     */
+    readonly functionName: functionName;
+} & Pick<EncodeFunctionDataParameters<abi, functionName>, "args">;
 /** Encode a system call to be passed as arguments into `World.call` */
 declare function encodeSystemCall<abi extends Abi, functionName extends ContractFunctionName<abi>>({ abi, systemId, functionName, args, }: SystemCall<abi, functionName>): AbiParametersToPrimitiveTypes<ExtractAbiFunction<worldCallAbi, "call">["inputs"]>;
 
@@ -150,14 +148,11 @@ type SystemCallFrom<abi extends Abi, functionName extends ContractFunctionName<a
 /** Encode a system call to be passed as arguments into `World.callFrom` */
 declare function encodeSystemCallFrom<abi extends Abi, functionName extends ContractFunctionName<abi>>({ abi, from, systemId, functionName, args, }: SystemCallFrom<abi, functionName>): AbiParametersToPrimitiveTypes<ExtractAbiFunction<worldCallAbi, "callFrom">["inputs"]>;
 
-type SystemCalls<abis extends readonly Abi[]> = {
-    [k in keyof abis]: SystemCall<abis[k], ContractFunctionName<abis[k]>>;
-};
 /** Encode system calls to be passed as arguments into `World.batchCall` */
-declare function encodeSystemCalls<abis extends readonly Abi[]>(systemCalls: SystemCalls<abis>): AbiParametersToPrimitiveTypes<ExtractAbiFunction<worldCallAbi, "batchCall">["inputs"]>;
+declare function encodeSystemCalls<abi extends Abi, functionName extends ContractFunctionName<abi>>(abi: abi, systemCalls: readonly Omit<SystemCall<abi, functionName>, "abi">[]): AbiParametersToPrimitiveTypes<ExtractAbiFunction<worldCallAbi, "batchCall">["inputs"]>;
 
 /** Encode system calls to be passed as arguments into `World.batchCallFrom` */
-declare function encodeSystemCallsFrom<abis extends readonly Abi[]>(from: Address, systemCalls: SystemCalls<abis>): AbiParametersToPrimitiveTypes<ExtractAbiFunction<worldCallAbi, "batchCallFrom">["inputs"]>;
+declare function encodeSystemCallsFrom<abi extends Abi, functionName extends ContractFunctionName<abi>>(abi: abi, from: Address, systemCalls: readonly Omit<SystemCallFrom<abi, functionName>, "abi" | "from">[]): AbiParametersToPrimitiveTypes<ExtractAbiFunction<worldCallAbi, "batchCallFrom">["inputs"]>;
 
 type CallFromParameters = {
     worldAddress: Hex;
@@ -171,4 +166,4 @@ type SystemFunction = {
 };
 declare function callFrom(params: CallFromParameters): <chain extends Chain, account extends Account | undefined>(client: Client<Transport, chain, account>) => Pick<WalletActions<chain, account>, "writeContract">;
 
-export { type SystemCall, type SystemCallFrom, type SystemCalls, callFrom, encodeSystemCall, encodeSystemCallFrom, encodeSystemCalls, encodeSystemCallsFrom };
+export { type SystemCall, type SystemCallFrom, callFrom, encodeSystemCall, encodeSystemCallFrom, encodeSystemCalls, encodeSystemCallsFrom };

package/dist/internal.js

@@ -1,6 +1,6 @@
 import {
   mud_config_default
-} from "./chunk-6KRKTNJ5.js";
+} from "./chunk-SGZK356L.js";
 import {
   defineNamespaces,
   defineWorld,
@@ -10,7 +10,7 @@ import {
   resolveWorld,
   validateNamespaces,
   validateWorld
-} from "./chunk-NVV4GS3R.js";
+} from "./chunk-2W4TKC47.js";
 import {
   CODEGEN_DEFAULTS,
   CONFIG_DEFAULTS,
@@ -25,7 +25,7 @@ import {
   validateNamespace,
   validateSystem,
   validateSystems
-} from "./chunk-6E2JY6MZ.js";
+} from "./chunk-XSBK355I.js";
 import "./chunk-5WRI5ZAA.js";
 
 // ts/encodeSystemCall.ts
@@ -87,9 +87,9 @@ function encodeSystemCallFrom({
 
 // ts/encodeSystemCalls.ts
 import { encodeFunctionData as encodeFunctionData3 } from "viem";
-function encodeSystemCalls(systemCalls) {
+function encodeSystemCalls(abi, systemCalls) {
   return [
-    systemCalls.map(({ abi, systemId, functionName, args }) => ({
+    systemCalls.map(({ systemId, functionName, args }) => ({
       systemId,
       callData: encodeFunctionData3({
         abi,
@@ -102,9 +102,9 @@ function encodeSystemCalls(systemCalls) {
 
 // ts/encodeSystemCallsFrom.ts
 import { encodeFunctionData as encodeFunctionData4 } from "viem";
-function encodeSystemCallsFrom(from, systemCalls) {
+function encodeSystemCallsFrom(abi, from, systemCalls) {
   return [
-    systemCalls.map(({ abi, systemId, functionName, args }) => ({
+    systemCalls.map(({ systemId, functionName, args }) => ({
       from,
       systemId,
       callData: encodeFunctionData4({

package/dist/internal.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../ts/encodeSystemCall.ts","../ts/normalizeSystemFunctionName.ts","../ts/encodeSystemCallFrom.ts","../ts/encodeSystemCalls.ts","../ts/encodeSystemCallsFrom.ts","../ts/actions/callFrom.ts","../ts/config/v2/dynamicResolution.ts"],"sourcesContent":["import { Abi, EncodeFunctionDataParameters, Hex, encodeFunctionData, type ContractFunctionName } from \"viem\";\nimport type { AbiParametersToPrimitiveTypes, ExtractAbiFunction } from \"abitype\";\nimport { worldCallAbi } from \"./worldCallAbi\";\nimport { internal_normalizeSystemFunctionName } from \"./normalizeSystemFunctionName\";\n\nexport type SystemCall<abi extends Abi, functionName extends ContractFunctionName<abi>> = {\n  [k in ContractFunctionName<abi>]: {\n    /**\n     * System's resource ID\n     */\n    readonly systemId: Hex;\n    /**\n     * System ABI\n     */\n    readonly abi: abi;\n    /**\n     * System function name to call\n     */\n    readonly functionName: k;\n  } & Pick<EncodeFunctionDataParameters<abi, k>, \"args\">;\n}[functionName];\n\n/** Encode a system call to be passed as arguments into `World.call` */\nexport function encodeSystemCall<abi extends Abi, functionName extends ContractFunctionName<abi>>({\n  abi,\n  systemId,\n  functionName,\n  args,\n}: SystemCall<abi, functionName>): AbiParametersToPrimitiveTypes<ExtractAbiFunction<worldCallAbi, \"call\">[\"inputs\"]> {\n  return [\n    systemId,\n    encodeFunctionData<abi, functionName>({\n      abi,\n      functionName: internal_normalizeSystemFunctionName(systemId, functionName),\n      args,\n    } as EncodeFunctionDataParameters<abi, functionName>),\n  ];\n}\n","import { hexToResource, resourceToLabel } from \"@latticexyz/common\";\nimport { Hex } from \"viem\";\n\n/** @internal */\nexport function internal_normalizeSystemFunctionName(systemId: Hex, functionName: string) {\n  const resource = hexToResource(systemId);\n  const worldFunctionPrefix = resource.namespace !== \"\" ? `${resource.namespace}__` : null;\n  if (worldFunctionPrefix != null && functionName.startsWith(worldFunctionPrefix)) {\n    console.warn(\n      // eslint-disable-next-line max-len\n      `Detected world function name \"${functionName}\" used in call to system \"${resourceToLabel(resource)}\".\\n\\nIt's recommended to use a system ABI and system function name with these methods instead.`,\n    );\n    return functionName.slice(worldFunctionPrefix.length);\n  }\n  return functionName;\n}\n","import { Abi, EncodeFunctionDataParameters, encodeFunctionData, Address, type ContractFunctionName } from \"viem\";\nimport type { AbiParametersToPrimitiveTypes, ExtractAbiFunction } from \"abitype\";\nimport { SystemCall } from \"./encodeSystemCall\";\nimport { worldCallAbi } from \"./worldCallAbi\";\nimport { internal_normalizeSystemFunctionName } from \"./normalizeSystemFunctionName\";\n\nexport type SystemCallFrom<abi extends Abi, functionName extends ContractFunctionName<abi>> = SystemCall<\n  abi,\n  functionName\n> & {\n  readonly from: Address;\n};\n\n/** Encode a system call to be passed as arguments into `World.callFrom` */\nexport function encodeSystemCallFrom<abi extends Abi, functionName extends ContractFunctionName<abi>>({\n  abi,\n  from,\n  systemId,\n  functionName,\n  args,\n}: SystemCallFrom<abi, functionName>): AbiParametersToPrimitiveTypes<\n  ExtractAbiFunction<worldCallAbi, \"callFrom\">[\"inputs\"]\n> {\n  return [\n    from,\n    systemId,\n    encodeFunctionData<abi, functionName>({\n      abi,\n      functionName: internal_normalizeSystemFunctionName(systemId, functionName),\n      args,\n    } as EncodeFunctionDataParameters<abi, functionName>),\n  ];\n}\n","import { Abi, encodeFunctionData, type ContractFunctionName } from \"viem\";\nimport { SystemCall } from \"./encodeSystemCall\";\nimport type { AbiParametersToPrimitiveTypes, ExtractAbiFunction } from \"abitype\";\nimport { worldCallAbi } from \"./worldCallAbi\";\nimport { internal_normalizeSystemFunctionName } from \"./normalizeSystemFunctionName\";\n\nexport type SystemCalls<abis extends readonly Abi[]> = {\n  [k in keyof abis]: SystemCall<abis[k], ContractFunctionName<abis[k]>>;\n};\n\n/** Encode system calls to be passed as arguments into `World.batchCall` */\nexport function encodeSystemCalls<abis extends readonly Abi[]>(\n  systemCalls: SystemCalls<abis>,\n): AbiParametersToPrimitiveTypes<ExtractAbiFunction<worldCallAbi, \"batchCall\">[\"inputs\"]> {\n  return [\n    systemCalls.map(({ abi, systemId, functionName, args }) => ({\n      systemId,\n      callData: encodeFunctionData({\n        abi,\n        functionName: internal_normalizeSystemFunctionName(systemId, functionName),\n        args,\n      }),\n    })),\n  ];\n}\n","import { Abi, Address, encodeFunctionData } from \"viem\";\nimport type { AbiParametersToPrimitiveTypes, ExtractAbiFunction } from \"abitype\";\nimport { worldCallAbi } from \"./worldCallAbi\";\nimport { internal_normalizeSystemFunctionName } from \"./normalizeSystemFunctionName\";\nimport { SystemCalls } from \"./encodeSystemCalls\";\n\n/** Encode system calls to be passed as arguments into `World.batchCallFrom` */\nexport function encodeSystemCallsFrom<abis extends readonly Abi[]>(\n  from: Address,\n  systemCalls: SystemCalls<abis>,\n): AbiParametersToPrimitiveTypes<ExtractAbiFunction<worldCallAbi, \"batchCallFrom\">[\"inputs\"]> {\n  return [\n    systemCalls.map(({ abi, systemId, functionName, args }) => ({\n      from,\n      systemId,\n      callData: encodeFunctionData({\n        abi,\n        functionName: internal_normalizeSystemFunctionName(systemId, functionName),\n        args,\n      }),\n    })),\n  ];\n}\n","import {\n  slice,\n  concat,\n  type Transport,\n  type Chain,\n  type Account,\n  type Hex,\n  type WalletActions,\n  type Client,\n  type PublicActions,\n  type WriteContractParameters,\n  type EncodeFunctionDataParameters,\n} from \"viem\";\nimport { getAction, encodeFunctionData } from \"viem/utils\";\nimport { readContract, writeContract as viem_writeContract } from \"viem/actions\";\nimport { readHex } from \"@latticexyz/common\";\nimport {\n  getKeySchema,\n  getValueSchema,\n  getSchemaTypes,\n  decodeValueArgs,\n  encodeKey,\n} from \"@latticexyz/protocol-parser/internal\";\nimport worldConfig from \"../../mud.config\";\nimport { worldCallAbi } from \"../worldCallAbi\";\n\ntype CallFromParameters = {\n  worldAddress: Hex;\n  delegatorAddress: Hex;\n  worldFunctionToSystemFunction?: (worldFunctionSelector: Hex) => Promise<SystemFunction>;\n  publicClient?: Client;\n};\n\ntype SystemFunction = { systemId: Hex; systemFunctionSelector: Hex };\n\n// By extending viem clients with this function after delegation, the delegation is automatically applied to World contract writes.\n// This means that these writes are made on behalf of the delegator.\n// Internally, it transforms the write arguments to use `callFrom`.\n//\n// Accepts either `worldFunctionToSystemFunction` or `publicClient` as an argument.\n// `worldFunctionToSystemFunction` allows manually providing the mapping function, thus users can utilize their client store for the lookup.\n// If `publicClient` is provided instead, this function retrieves the corresponding system function from the World contract.\n//\n// The function mapping is cached to avoid redundant retrievals for the same World function.\nexport function callFrom(\n  params: CallFromParameters,\n): <chain extends Chain, account extends Account | undefined>(\n  client: Client<Transport, chain, account>,\n) => Pick<WalletActions<chain, account>, \"writeContract\"> {\n  return (client) => ({\n    async writeContract(writeArgs) {\n      const _writeContract = getAction(client, viem_writeContract, \"writeContract\");\n\n      // Skip if the contract isn't the World or the function called should not be redirected through `callFrom`.\n      if (\n        writeArgs.address !== params.worldAddress ||\n        writeArgs.functionName === \"call\" ||\n        writeArgs.functionName === \"callFrom\" ||\n        writeArgs.functionName === \"batchCallFrom\" ||\n        writeArgs.functionName === \"callWithSignature\"\n      ) {\n        return _writeContract(writeArgs);\n      }\n\n      // Wrap system calls from `batchCall` with delegator for a `batchCallFrom`\n      // TODO: remove this specific workaround once https://github.com/latticexyz/mud/pull/3506 lands\n      if (writeArgs.functionName === \"batchCall\") {\n        const batchCallArgs = writeArgs as unknown as WriteContractParameters<worldCallAbi, \"batchCall\">;\n        const [systemCalls] = batchCallArgs.args;\n        if (!systemCalls.length) {\n          throw new Error(\"`batchCall` should have at least one system call.\");\n        }\n\n        return _writeContract({\n          ...batchCallArgs,\n          functionName: \"batchCallFrom\",\n          args: [systemCalls.map((systemCall) => ({ from: params.delegatorAddress, ...systemCall }))],\n        });\n      }\n\n      // Encode the World's calldata (which includes the World's function selector).\n      const worldCalldata = encodeFunctionData({\n        abi: writeArgs.abi,\n        functionName: writeArgs.functionName,\n        args: writeArgs.args,\n      } as unknown as EncodeFunctionDataParameters);\n\n      // The first 4 bytes of calldata represent the function selector.\n      const worldFunctionSelector = slice(worldCalldata, 0, 4);\n\n      // Get the systemId and System's function selector.\n      const { systemId, systemFunctionSelector } = await worldFunctionToSystemFunction({\n        ...params,\n        publicClient: params.publicClient ?? client,\n        worldFunctionSelector,\n      });\n\n      // Construct the System's calldata by replacing the World's function selector with the System's.\n      // Use `readHex` instead of `slice` to prevent out-of-bounds errors with calldata that has no args.\n      const systemCalldata = concat([systemFunctionSelector, readHex(worldCalldata, 4)]);\n\n      // Call `writeContract` with the new args.\n      return _writeContract({\n        ...(writeArgs as unknown as WriteContractParameters<worldCallAbi, \"callFrom\">),\n        functionName: \"callFrom\",\n        args: [params.delegatorAddress, systemId, systemCalldata],\n      });\n    },\n  });\n}\n\nconst systemFunctionCache = new Map<Hex, SystemFunction>();\n\nasync function worldFunctionToSystemFunction(params: {\n  worldAddress: Hex;\n  delegatorAddress: Hex;\n  worldFunctionSelector: Hex;\n  worldFunctionToSystemFunction?: (worldFunctionSelector: Hex) => Promise<SystemFunction>;\n  publicClient: Client;\n}): Promise<SystemFunction> {\n  const cacheKey = concat([params.worldAddress, params.worldFunctionSelector]);\n\n  // Use cache if the function has been called previously.\n  const cached = systemFunctionCache.get(cacheKey);\n  if (cached) return cached;\n\n  // If a mapping function is provided, use it. Otherwise, call the World contract.\n  const systemFunction = params.worldFunctionToSystemFunction\n    ? await params.worldFunctionToSystemFunction(params.worldFunctionSelector)\n    : await retrieveSystemFunctionFromContract(params.publicClient, params.worldAddress, params.worldFunctionSelector);\n\n  systemFunctionCache.set(cacheKey, systemFunction);\n\n  return systemFunction;\n}\n\nasync function retrieveSystemFunctionFromContract(\n  publicClient: Client,\n  worldAddress: Hex,\n  worldFunctionSelector: Hex,\n): Promise<SystemFunction> {\n  const table = worldConfig.tables.world__FunctionSelectors;\n\n  const keySchema = getSchemaTypes(getKeySchema(table));\n  const valueSchema = getSchemaTypes(getValueSchema(table));\n\n  const _readContract = getAction(publicClient, readContract, \"readContract\") as PublicActions[\"readContract\"];\n\n  const [staticData, encodedLengths, dynamicData] = await _readContract({\n    address: worldAddress,\n    abi: [\n      {\n        type: \"function\",\n        name: \"getRecord\",\n        inputs: [\n          {\n            name: \"tableId\",\n            type: \"bytes32\",\n            internalType: \"ResourceId\",\n          },\n          {\n            name: \"keyTuple\",\n            type: \"bytes32[]\",\n            internalType: \"bytes32[]\",\n          },\n        ],\n        outputs: [\n          {\n            name: \"staticData\",\n            type: \"bytes\",\n            internalType: \"bytes\",\n          },\n          {\n            name: \"encodedLengths\",\n            type: \"bytes32\",\n            internalType: \"EncodedLengths\",\n          },\n          {\n            name: \"dynamicData\",\n            type: \"bytes\",\n            internalType: \"bytes\",\n          },\n        ],\n        stateMutability: \"view\",\n      },\n    ],\n    functionName: \"getRecord\",\n    args: [table.tableId, encodeKey(keySchema, { worldFunctionSelector })],\n  });\n\n  const decoded = decodeValueArgs(valueSchema, { staticData, encodedLengths, dynamicData });\n\n  const systemFunction: SystemFunction = {\n    systemId: decoded.systemId,\n    systemFunctionSelector: decoded.systemFunctionSelector,\n  };\n\n  return systemFunction;\n}\n","import { World } from \"./output\";\n\nexport type DynamicResolution = {\n  // TODO: add systemAddress support\n  type: \"tableId\";\n  input: string;\n};\n\nexport type ValueWithType = {\n  value: string | number | Uint8Array;\n  type: string;\n};\n\n/**\n * Dynamically resolve a table name to a table id at deploy time\n */\nexport function resolveTableId(tableName: string) {\n  return {\n    type: \"tableId\",\n    input: tableName,\n  } as const;\n}\n\n/** Type guard for DynamicResolution */\nexport function isDynamicResolution(value: unknown): value is DynamicResolution {\n  return typeof value === \"object\" && value !== null && \"type\" in value && \"input\" in value;\n}\n\n/** Type guard for ValueWithType */\nexport function isValueWithType(value: unknown): value is ValueWithType {\n  return typeof value === \"object\" && value !== null && \"type\" in value && \"value\" in value;\n}\n\n/**\n * Turn a DynamicResolution object into a ValueWithType based on the provided context\n */\nexport function resolveWithContext(\n  input: unknown,\n  context: { config: World; systemAddresses?: Record<string, Promise<string>> },\n): ValueWithType {\n  if (isValueWithType(input)) return input;\n\n  if (isDynamicResolution(input)) {\n    if (input.type === \"tableId\") {\n      const tableEntries = Object.entries(context.config.tables).filter(\n        ([tableName, table]) => tableName === input.input || table.name === input.input,\n      );\n\n      if (tableEntries.length > 1) {\n        throw new Error(\n          `Found more than one table with name \"${input.input}\". Try using one of the following table names instead: ${tableEntries.map(([tableName]) => tableName).join(\", \")}`,\n        );\n      }\n\n      if (tableEntries.length === 1) {\n        const [entry] = tableEntries;\n        const [, table] = entry;\n        return { type: \"bytes32\", value: table.tableId };\n      }\n    }\n  }\n\n  throw new Error(`Could not resolve dynamic resolution:\\n${JSON.stringify(input, null, 2)}`);\n}\n"],"mappings":"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","names":["encodeFunctionData","encodeFunctionData","encodeFunctionData","encodeFunctionData","encodeFunctionData","encodeFunctionData","encodeFunctionData","encodeFunctionData"]}
+{"version":3,"sources":["../ts/encodeSystemCall.ts","../ts/normalizeSystemFunctionName.ts","../ts/encodeSystemCallFrom.ts","../ts/encodeSystemCalls.ts","../ts/encodeSystemCallsFrom.ts","../ts/actions/callFrom.ts","../ts/config/v2/dynamicResolution.ts"],"sourcesContent":["import { Abi, EncodeFunctionDataParameters, Hex, encodeFunctionData, type ContractFunctionName } from \"viem\";\nimport type { AbiParametersToPrimitiveTypes, ExtractAbiFunction } from \"abitype\";\nimport { worldCallAbi } from \"./worldCallAbi\";\nimport { internal_normalizeSystemFunctionName } from \"./normalizeSystemFunctionName\";\n\nexport type SystemCall<abi extends Abi, functionName extends ContractFunctionName<abi>> = {\n  /**\n   * System ABI\n   */\n  readonly abi: abi;\n  /**\n   * System's resource ID\n   */\n  readonly systemId: Hex;\n  /**\n   * System function name to call\n   */\n  readonly functionName: functionName;\n} & Pick<EncodeFunctionDataParameters<abi, functionName>, \"args\">;\n\n/** Encode a system call to be passed as arguments into `World.call` */\nexport function encodeSystemCall<abi extends Abi, functionName extends ContractFunctionName<abi>>({\n  abi,\n  systemId,\n  functionName,\n  args,\n}: SystemCall<abi, functionName>): AbiParametersToPrimitiveTypes<ExtractAbiFunction<worldCallAbi, \"call\">[\"inputs\"]> {\n  return [\n    systemId,\n    encodeFunctionData<abi, functionName>({\n      abi,\n      functionName: internal_normalizeSystemFunctionName(systemId, functionName),\n      args,\n    } as EncodeFunctionDataParameters<abi, functionName>),\n  ];\n}\n","import { hexToResource, resourceToLabel } from \"@latticexyz/common\";\nimport { Hex } from \"viem\";\n\n/** @internal */\nexport function internal_normalizeSystemFunctionName(systemId: Hex, functionName: string) {\n  const resource = hexToResource(systemId);\n  const worldFunctionPrefix = resource.namespace !== \"\" ? `${resource.namespace}__` : null;\n  if (worldFunctionPrefix != null && functionName.startsWith(worldFunctionPrefix)) {\n    console.warn(\n      // eslint-disable-next-line max-len\n      `Detected world function name \"${functionName}\" used in call to system \"${resourceToLabel(resource)}\".\\n\\nIt's recommended to use a system ABI and system function name with these methods instead.`,\n    );\n    return functionName.slice(worldFunctionPrefix.length);\n  }\n  return functionName;\n}\n","import { Abi, EncodeFunctionDataParameters, encodeFunctionData, Address, type ContractFunctionName } from \"viem\";\nimport type { AbiParametersToPrimitiveTypes, ExtractAbiFunction } from \"abitype\";\nimport { SystemCall } from \"./encodeSystemCall\";\nimport { worldCallAbi } from \"./worldCallAbi\";\nimport { internal_normalizeSystemFunctionName } from \"./normalizeSystemFunctionName\";\n\nexport type SystemCallFrom<abi extends Abi, functionName extends ContractFunctionName<abi>> = SystemCall<\n  abi,\n  functionName\n> & {\n  readonly from: Address;\n};\n\n/** Encode a system call to be passed as arguments into `World.callFrom` */\nexport function encodeSystemCallFrom<abi extends Abi, functionName extends ContractFunctionName<abi>>({\n  abi,\n  from,\n  systemId,\n  functionName,\n  args,\n}: SystemCallFrom<abi, functionName>): AbiParametersToPrimitiveTypes<\n  ExtractAbiFunction<worldCallAbi, \"callFrom\">[\"inputs\"]\n> {\n  return [\n    from,\n    systemId,\n    encodeFunctionData<abi, functionName>({\n      abi,\n      functionName: internal_normalizeSystemFunctionName(systemId, functionName),\n      args,\n    } as EncodeFunctionDataParameters<abi, functionName>),\n  ];\n}\n","import { Abi, EncodeFunctionDataParameters, encodeFunctionData, type ContractFunctionName } from \"viem\";\nimport { SystemCall } from \"./encodeSystemCall\";\nimport type { AbiParametersToPrimitiveTypes, ExtractAbiFunction } from \"abitype\";\nimport { worldCallAbi } from \"./worldCallAbi\";\nimport { internal_normalizeSystemFunctionName } from \"./normalizeSystemFunctionName\";\n\n/** Encode system calls to be passed as arguments into `World.batchCall` */\nexport function encodeSystemCalls<abi extends Abi, functionName extends ContractFunctionName<abi>>(\n  abi: abi,\n  systemCalls: readonly Omit<SystemCall<abi, functionName>, \"abi\">[],\n): AbiParametersToPrimitiveTypes<ExtractAbiFunction<worldCallAbi, \"batchCall\">[\"inputs\"]> {\n  return [\n    systemCalls.map(({ systemId, functionName, args }) => ({\n      systemId,\n      callData: encodeFunctionData<abi, functionName>({\n        abi,\n        functionName: internal_normalizeSystemFunctionName(systemId, functionName),\n        args,\n      } as EncodeFunctionDataParameters<abi, functionName>),\n    })),\n  ];\n}\n","import { Abi, Address, EncodeFunctionDataParameters, encodeFunctionData, type ContractFunctionName } from \"viem\";\nimport { SystemCallFrom } from \"./encodeSystemCallFrom\";\nimport type { AbiParametersToPrimitiveTypes, ExtractAbiFunction } from \"abitype\";\nimport { worldCallAbi } from \"./worldCallAbi\";\nimport { internal_normalizeSystemFunctionName } from \"./normalizeSystemFunctionName\";\n\n/** Encode system calls to be passed as arguments into `World.batchCallFrom` */\nexport function encodeSystemCallsFrom<abi extends Abi, functionName extends ContractFunctionName<abi>>(\n  abi: abi,\n  from: Address,\n  systemCalls: readonly Omit<SystemCallFrom<abi, functionName>, \"abi\" | \"from\">[],\n): AbiParametersToPrimitiveTypes<ExtractAbiFunction<worldCallAbi, \"batchCallFrom\">[\"inputs\"]> {\n  return [\n    systemCalls.map(({ systemId, functionName, args }) => ({\n      from,\n      systemId,\n      callData: encodeFunctionData<abi, functionName>({\n        abi,\n        functionName: internal_normalizeSystemFunctionName(systemId, functionName),\n        args,\n      } as EncodeFunctionDataParameters<abi, functionName>),\n    })),\n  ];\n}\n","import {\n  slice,\n  concat,\n  type Transport,\n  type Chain,\n  type Account,\n  type Hex,\n  type WalletActions,\n  type Client,\n  type PublicActions,\n  type WriteContractParameters,\n  type EncodeFunctionDataParameters,\n} from \"viem\";\nimport { getAction, encodeFunctionData } from \"viem/utils\";\nimport { readContract, writeContract as viem_writeContract } from \"viem/actions\";\nimport { readHex } from \"@latticexyz/common\";\nimport {\n  getKeySchema,\n  getValueSchema,\n  getSchemaTypes,\n  decodeValueArgs,\n  encodeKey,\n} from \"@latticexyz/protocol-parser/internal\";\nimport worldConfig from \"../../mud.config\";\nimport { worldCallAbi } from \"../worldCallAbi\";\n\ntype CallFromParameters = {\n  worldAddress: Hex;\n  delegatorAddress: Hex;\n  worldFunctionToSystemFunction?: (worldFunctionSelector: Hex) => Promise<SystemFunction>;\n  publicClient?: Client;\n};\n\ntype SystemFunction = { systemId: Hex; systemFunctionSelector: Hex };\n\n// By extending viem clients with this function after delegation, the delegation is automatically applied to World contract writes.\n// This means that these writes are made on behalf of the delegator.\n// Internally, it transforms the write arguments to use `callFrom`.\n//\n// Accepts either `worldFunctionToSystemFunction` or `publicClient` as an argument.\n// `worldFunctionToSystemFunction` allows manually providing the mapping function, thus users can utilize their client store for the lookup.\n// If `publicClient` is provided instead, this function retrieves the corresponding system function from the World contract.\n//\n// The function mapping is cached to avoid redundant retrievals for the same World function.\nexport function callFrom(\n  params: CallFromParameters,\n): <chain extends Chain, account extends Account | undefined>(\n  client: Client<Transport, chain, account>,\n) => Pick<WalletActions<chain, account>, \"writeContract\"> {\n  return (client) => ({\n    async writeContract(writeArgs) {\n      const _writeContract = getAction(client, viem_writeContract, \"writeContract\");\n\n      // Skip if the contract isn't the World or the function called should not be redirected through `callFrom`.\n      if (\n        writeArgs.address !== params.worldAddress ||\n        writeArgs.functionName === \"call\" ||\n        writeArgs.functionName === \"callFrom\" ||\n        writeArgs.functionName === \"batchCallFrom\" ||\n        writeArgs.functionName === \"callWithSignature\"\n      ) {\n        return _writeContract(writeArgs);\n      }\n\n      // Wrap system calls from `batchCall` with delegator for a `batchCallFrom`\n      // TODO: remove this specific workaround once https://github.com/latticexyz/mud/pull/3506 lands\n      if (writeArgs.functionName === \"batchCall\") {\n        const batchCallArgs = writeArgs as unknown as WriteContractParameters<worldCallAbi, \"batchCall\">;\n        const [systemCalls] = batchCallArgs.args;\n        if (!systemCalls.length) {\n          throw new Error(\"`batchCall` should have at least one system call.\");\n        }\n\n        return _writeContract({\n          ...batchCallArgs,\n          functionName: \"batchCallFrom\",\n          args: [systemCalls.map((systemCall) => ({ from: params.delegatorAddress, ...systemCall }))],\n        });\n      }\n\n      // Encode the World's calldata (which includes the World's function selector).\n      const worldCalldata = encodeFunctionData({\n        abi: writeArgs.abi,\n        functionName: writeArgs.functionName,\n        args: writeArgs.args,\n      } as unknown as EncodeFunctionDataParameters);\n\n      // The first 4 bytes of calldata represent the function selector.\n      const worldFunctionSelector = slice(worldCalldata, 0, 4);\n\n      // Get the systemId and System's function selector.\n      const { systemId, systemFunctionSelector } = await worldFunctionToSystemFunction({\n        ...params,\n        publicClient: params.publicClient ?? client,\n        worldFunctionSelector,\n      });\n\n      // Construct the System's calldata by replacing the World's function selector with the System's.\n      // Use `readHex` instead of `slice` to prevent out-of-bounds errors with calldata that has no args.\n      const systemCalldata = concat([systemFunctionSelector, readHex(worldCalldata, 4)]);\n\n      // Call `writeContract` with the new args.\n      return _writeContract({\n        ...(writeArgs as unknown as WriteContractParameters<worldCallAbi, \"callFrom\">),\n        functionName: \"callFrom\",\n        args: [params.delegatorAddress, systemId, systemCalldata],\n      });\n    },\n  });\n}\n\nconst systemFunctionCache = new Map<Hex, SystemFunction>();\n\nasync function worldFunctionToSystemFunction(params: {\n  worldAddress: Hex;\n  delegatorAddress: Hex;\n  worldFunctionSelector: Hex;\n  worldFunctionToSystemFunction?: (worldFunctionSelector: Hex) => Promise<SystemFunction>;\n  publicClient: Client;\n}): Promise<SystemFunction> {\n  const cacheKey = concat([params.worldAddress, params.worldFunctionSelector]);\n\n  // Use cache if the function has been called previously.\n  const cached = systemFunctionCache.get(cacheKey);\n  if (cached) return cached;\n\n  // If a mapping function is provided, use it. Otherwise, call the World contract.\n  const systemFunction = params.worldFunctionToSystemFunction\n    ? await params.worldFunctionToSystemFunction(params.worldFunctionSelector)\n    : await retrieveSystemFunctionFromContract(params.publicClient, params.worldAddress, params.worldFunctionSelector);\n\n  systemFunctionCache.set(cacheKey, systemFunction);\n\n  return systemFunction;\n}\n\nasync function retrieveSystemFunctionFromContract(\n  publicClient: Client,\n  worldAddress: Hex,\n  worldFunctionSelector: Hex,\n): Promise<SystemFunction> {\n  const table = worldConfig.tables.world__FunctionSelectors;\n\n  const keySchema = getSchemaTypes(getKeySchema(table));\n  const valueSchema = getSchemaTypes(getValueSchema(table));\n\n  const _readContract = getAction(publicClient, readContract, \"readContract\") as PublicActions[\"readContract\"];\n\n  const [staticData, encodedLengths, dynamicData] = await _readContract({\n    address: worldAddress,\n    abi: [\n      {\n        type: \"function\",\n        name: \"getRecord\",\n        inputs: [\n          {\n            name: \"tableId\",\n            type: \"bytes32\",\n            internalType: \"ResourceId\",\n          },\n          {\n            name: \"keyTuple\",\n            type: \"bytes32[]\",\n            internalType: \"bytes32[]\",\n          },\n        ],\n        outputs: [\n          {\n            name: \"staticData\",\n            type: \"bytes\",\n            internalType: \"bytes\",\n          },\n          {\n            name: \"encodedLengths\",\n            type: \"bytes32\",\n            internalType: \"EncodedLengths\",\n          },\n          {\n            name: \"dynamicData\",\n            type: \"bytes\",\n            internalType: \"bytes\",\n          },\n        ],\n        stateMutability: \"view\",\n      },\n    ],\n    functionName: \"getRecord\",\n    args: [table.tableId, encodeKey(keySchema, { worldFunctionSelector })],\n  });\n\n  const decoded = decodeValueArgs(valueSchema, { staticData, encodedLengths, dynamicData });\n\n  const systemFunction: SystemFunction = {\n    systemId: decoded.systemId,\n    systemFunctionSelector: decoded.systemFunctionSelector,\n  };\n\n  return systemFunction;\n}\n","import { World } from \"./output\";\n\nexport type DynamicResolution = {\n  // TODO: add systemAddress support\n  type: \"tableId\";\n  input: string;\n};\n\nexport type ValueWithType = {\n  value: string | number | Uint8Array;\n  type: string;\n};\n\n/**\n * Dynamically resolve a table name to a table id at deploy time\n */\nexport function resolveTableId(tableName: string) {\n  return {\n    type: \"tableId\",\n    input: tableName,\n  } as const;\n}\n\n/** Type guard for DynamicResolution */\nexport function isDynamicResolution(value: unknown): value is DynamicResolution {\n  return typeof value === \"object\" && value !== null && \"type\" in value && \"input\" in value;\n}\n\n/** Type guard for ValueWithType */\nexport function isValueWithType(value: unknown): value is ValueWithType {\n  return typeof value === \"object\" && value !== null && \"type\" in value && \"value\" in value;\n}\n\n/**\n * Turn a DynamicResolution object into a ValueWithType based on the provided context\n */\nexport function resolveWithContext(\n  input: unknown,\n  context: { config: World; systemAddresses?: Record<string, Promise<string>> },\n): ValueWithType {\n  if (isValueWithType(input)) return input;\n\n  if (isDynamicResolution(input)) {\n    if (input.type === \"tableId\") {\n      const tableEntries = Object.entries(context.config.tables).filter(\n        ([tableName, table]) => tableName === input.input || table.name === input.input,\n      );\n\n      if (tableEntries.length > 1) {\n        throw new Error(\n          `Found more than one table with name \"${input.input}\". Try using one of the following table names instead: ${tableEntries.map(([tableName]) => tableName).join(\", \")}`,\n        );\n      }\n\n      if (tableEntries.length === 1) {\n        const [entry] = tableEntries;\n        const [, table] = entry;\n        return { type: \"bytes32\", value: table.tableId };\n      }\n    }\n  }\n\n  throw new Error(`Could not resolve dynamic resolution:\\n${JSON.stringify(input, null, 2)}`);\n}\n"],"mappings":"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","names":["encodeFunctionData","encodeFunctionData","encodeFunctionData","encodeFunctionData","encodeFunctionData","encodeFunctionData","encodeFunctionData","encodeFunctionData"]}