@universal-everything/sdk-core-lukso 1.0.0 → 1.1.0-dev.16b651c

package/dist/index.d.ts

@@ -152,5 +152,32 @@ type BuildDeploymentResult = {
  * MUST be sent unchanged.
  */
 declare function buildLsp23Deployment(opts: BuildDeploymentOpts): BuildDeploymentResult;
+/**
+ * The GENERATING controller of an LSP23 deployment: the controller the
+ * post-deployment calldata grants on the fresh UP. Because the factory's
+ * CREATE2 salt commits to `postDeploymentModuleCalldata`, the key granted
+ * here is the one that ends up controlling a redeploy of the same address on
+ * another chain — every other controller is added later (a `setDataBatch` on
+ * the live UP, e.g. a daily-use key added after deployment) and is not part
+ * of the address.
+ *
+ * Identified by STRUCTURE, not by permission bits: decode the
+ * `(bytes32[] keys, bytes[] values)` setDataBatch payload, take the
+ * `AddressPermissions:Permissions:<address>` entries, and drop the Universal
+ * Receiver Delegate (the address the same calldata sets under the
+ * `LSP1UniversalReceiverDelegate` key; the canonical LUKSO URD as fallback).
+ * Exactly one controller must remain — that is the generating key,
+ * lowercased. `null` = unknown, never "none": the calldata does not decode,
+ * grants no controller besides the URD, or grants MORE THAN ONE (ambiguous —
+ * the entry order is chosen by whoever built the calldata, so picking "the
+ * first" would let a hostile dapp choose which key we record; refusing to
+ * pick means it can only make the value unknown). Every producer we know of
+ * (extension, mobile app, our own builder) grants exactly one controller plus
+ * the URD. Not tied to the permission mask the producer chose, so a future
+ * deploy granting the generating key a narrower mask still resolves. Only
+ * meaningful on LSP23 post-deployment calldata — a plain `setDataBatch` on a
+ * live UP may legitimately grant many.
+ */
+declare function extractLsp23GeneratingController(postDeploymentModuleCalldata: Hex): Hex | null;
 
-export { type BuildDeploymentOpts, type BuildDeploymentResult, DEPLOY_ERC1167_PROXIES_ABI, LUKSO_LSP23_CONSTANTS, type LuksoLsp23Constants, buildLsp23Deployment, deriveLsp23ProxyAddress, generateLsp23Salt };
+export { type BuildDeploymentOpts, type BuildDeploymentResult, DEPLOY_ERC1167_PROXIES_ABI, LUKSO_LSP23_CONSTANTS, type LuksoLsp23Constants, buildLsp23Deployment, deriveLsp23ProxyAddress, extractLsp23GeneratingController, generateLsp23Salt };

package/dist/index.js

@@ -1,5 +1,6 @@
 // src/lsp23.ts
 import {
+  decodeAbiParameters,
   decodeFunctionData,
   encodeAbiParameters,
   encodeFunctionData,
@@ -192,10 +193,42 @@ function buildLsp23Deployment(opts) {
     deploymentCalldata: calldata
   };
 }
+function extractLsp23GeneratingController(postDeploymentModuleCalldata) {
+  let keys;
+  let values;
+  try {
+    [keys, values] = decodeAbiParameters(
+      [{ type: "bytes32[]" }, { type: "bytes[]" }],
+      postDeploymentModuleCalldata
+    );
+  } catch {
+    return null;
+  }
+  const prefix = LSP6_PERMISSIONS_PREFIX.toLowerCase();
+  const urd = /* @__PURE__ */ new Set([
+    LUKSO_LSP23_CONSTANTS.universalReceiverDelegate.toLowerCase()
+  ]);
+  const granted = /* @__PURE__ */ new Set();
+  for (let i = 0; i < keys.length; i++) {
+    const key = keys[i].toLowerCase();
+    const value = values[i];
+    if (key === LSP1_URD_KEY && value?.length === 42) {
+      urd.add(value.toLowerCase());
+      continue;
+    }
+    if (!key.startsWith(prefix) || key.length !== 66) continue;
+    if (value?.length !== 66) continue;
+    granted.add(`0x${key.slice(prefix.length)}`);
+  }
+  const controllers = [...granted].filter((a) => !urd.has(a));
+  if (controllers.length !== 1) return null;
+  return controllers[0];
+}
 export {
   DEPLOY_ERC1167_PROXIES_ABI,
   LUKSO_LSP23_CONSTANTS,
   buildLsp23Deployment,
   deriveLsp23ProxyAddress,
+  extractLsp23GeneratingController,
   generateLsp23Salt
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@universal-everything/sdk-core-lukso",
-  "version": "1.0.0",
+  "version": "1.1.0-dev.16b651c",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/universal-everything/universal-relayer.git",
@@ -23,7 +23,7 @@
   },
   "dependencies": {
     "viem": "^2.21.0",
-    "@universal-everything/sdk-core": "1.1.0"
+    "@universal-everything/sdk-core": "1.2.0-dev.16b651c"
   },
   "devDependencies": {
     "typescript": "^5.7.0",