@dev.sail.money/sailor 0.0.2-13 → 0.0.2-16

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dev.sail.money/sailor",
-  "version": "0.0.2-13",
+  "version": "0.0.2-16",
   "description": "Operator toolkit for Sail Protocol",
   "bin": {
     "sailor": "packages/cli/dist/index.cjs"

package/packages/cli/dist/index.cjs

@@ -40880,6 +40880,282 @@ Register it later with: sailor mandate attach --address ${deployed} --sma <SMA>`
     attached: options.attach ? { sma: options.sma, txHash: attachTxHash } : null
   });
 }
+var CLONE_INIT_PREFIX = "0x3d602d80600a3d3981f3363d3d373d3d3d363d73";
+var CLONE_INIT_SUFFIX = "0x5af43d82803e903d91602b57fd5bf3";
+var PERMISSION_FACTORY_ABI = [
+  {
+    type: "function",
+    name: "deployAndAttach",
+    stateMutability: "payable",
+    inputs: [
+      { name: "account", type: "address" },
+      { name: "impl", type: "address" },
+      { name: "salt", type: "bytes32" },
+      { name: "initData", type: "bytes" },
+      { name: "kernelDeadline", type: "uint256" },
+      { name: "kernelSig", type: "bytes" }
+    ],
+    outputs: [{ name: "clone", type: "address" }]
+  }
+];
+var CLONE_TEMPLATES = {
+  boundedApprove: {
+    label: "Bounded Approve",
+    buildInitData: (p) => encodeFunctionData({
+      abi: [
+        {
+          type: "function",
+          name: "initialize",
+          stateMutability: "nonpayable",
+          inputs: [
+            { name: "allowedTokens", type: "address[]" },
+            { name: "allowedSpenders", type: "address[]" },
+            { name: "_maxAmountPerTx", type: "uint256" },
+            { name: "_permissionSigner", type: "address" }
+          ],
+          outputs: []
+        }
+      ],
+      functionName: "initialize",
+      args: [p.tokens, p.spenders, p.max, p.permissionSigner]
+    }),
+    describe: (p) => [
+      { label: "Allowed tokens", value: p.tokens.join(", ") },
+      { label: "Allowed spenders", value: p.spenders.join(", ") },
+      {
+        label: "Max approval / tx",
+        value: p.max === maxUint256 ? "unlimited (uint256 max)" : p.max.toString()
+      }
+    ]
+  }
+};
+function predictCloneAddress(impl, factory, submitter, salt) {
+  const namespacedSalt = keccak256(
+    encodeAbiParameters([{ type: "address" }, { type: "bytes32" }], [submitter, salt])
+  );
+  const initCode = concatHex([CLONE_INIT_PREFIX, impl, CLONE_INIT_SUFFIX]);
+  return getCreate2Address({
+    from: factory,
+    salt: namespacedSalt,
+    bytecodeHash: keccak256(initCode)
+  });
+}
+function parseAddressList(csv, flag) {
+  if (!csv) throw new Error(`${flag} is required (comma-separated address list)`);
+  const list = csv.split(",").map((s) => s.trim()).filter(Boolean);
+  if (list.length === 0) throw new Error(`${flag} is empty`);
+  for (const a of list) {
+    if (!isAddress(a)) throw new Error(`${flag} contains an invalid address: ${a}`);
+  }
+  return list;
+}
+async function mandateDeployClone(options) {
+  const project = requireProject();
+  const channel = await createSigningChannel(process.cwd());
+  try {
+    await channel.start();
+    await runDeployClone(project, channel, options);
+  } catch (err) {
+    fail(err, options.json);
+  } finally {
+    channel.stop();
+  }
+}
+async function runDeployClone(project, channel, options) {
+  const json = !!options.json;
+  const say = (fn) => {
+    if (!json) fn();
+  };
+  if (!isAddress(options.sma)) throw new Error(`Invalid --sma address: ${options.sma}`);
+  const sma = options.sma;
+  const spec = CLONE_TEMPLATES[options.template];
+  if (!spec) {
+    throw new Error(
+      `Unsupported clone template "${options.template}". Supported: ${Object.keys(CLONE_TEMPLATES).join(", ")}`
+    );
+  }
+  const impl = project.deployment.standaloneTemplates?.[options.template];
+  if (!impl || !isAddress(impl)) {
+    throw new Error(
+      `No "${options.template}" standalone template is bundled for chain ${project.chainId}.`
+    );
+  }
+  const chain2 = getChainById(project.chainId);
+  const publicClient = publicClientFor(project);
+  const agentSigner = await loadManagerSigner2();
+  const registered = await publicClient.readContract({
+    address: project.contracts.kernel,
+    abi: SailKernelAbi,
+    functionName: "registered",
+    args: [sma]
+  });
+  if (!registered) {
+    throw new Error(`SMA ${sma} is not registered with SailKernel; cannot register a permission.`);
+  }
+  const kernelConfig = await publicClient.readContract({
+    address: project.contracts.kernel,
+    abi: SailKernelAbi,
+    functionName: "configs",
+    args: [sma]
+  });
+  const permissionSigner = kernelConfig[0];
+  const initParams = {
+    permissionSigner,
+    tokens: parseAddressList(options.tokens, "--tokens"),
+    spenders: parseAddressList(options.spenders, "--spenders"),
+    max: options.max ? BigInt(options.max) : maxUint256
+  };
+  const initData = spec.buildInitData(initParams);
+  const submitter = agentSigner.address;
+  const salt = keccak256(
+    encodeAbiParameters(
+      [{ type: "address" }, { type: "address" }, { type: "uint256" }],
+      [sma, impl, BigInt(Math.floor(Date.now() / 1e3))]
+    )
+  );
+  const clone = predictCloneAddress(impl, project.contracts.permissionFactory, submitter, salt);
+  say(() => {
+    console.log(`
+${spec.label} clone (${options.template})`);
+    console.log(`  logic impl:      ${impl}`);
+    console.log(`  predicted clone: ${clone}`);
+    console.log(`  SMA:             ${sma}`);
+    for (const d of spec.describe(initParams)) console.log(`  ${d.label}: ${d.value}`);
+    console.log(`
+\u2192 Signing station:
+  Open ${channel.url} and connect your Owner wallet
+`);
+  });
+  const nonce = await publicClient.readContract({
+    address: project.contracts.kernel,
+    abi: SailKernelAbi,
+    functionName: "signerNonces",
+    args: [sma]
+  });
+  let registerPermissionHasDeadline = false;
+  try {
+    const caps = await detectKernelCapabilities(publicClient, project.contracts.kernel, {
+      chainId: project.chainId
+    });
+    registerPermissionHasDeadline = caps.registerPermissionHasDeadline;
+  } catch {
+  }
+  const deadline = registerPermissionHasDeadline ? BigInt(Math.floor(Date.now() / 1e3) + 300) : void 0;
+  const typedData = buildRegisterPermissionTypedData({
+    chainId: project.chainId,
+    kernel: project.contracts.kernel,
+    account: sma,
+    permission: clone,
+    nonce,
+    hasDeadline: registerPermissionHasDeadline,
+    deadline
+  });
+  const label = options.label ?? `${spec.label} (${options.template})`;
+  say(
+    () => console.log(
+      `Pushing signing request \u2014 the mandate signer (${permissionSigner}) must sign in the browser.`
+    )
+  );
+  const response = await channel.requestSignature({
+    type: "typed-data",
+    kind: "register-permission",
+    title: `Authorize "${label}"`,
+    description: `Sign to authorize a new ${spec.label} permission on your SMA. The agent deploys and registers it in one transaction.`,
+    chainId: project.chainId,
+    details: [
+      { label: "SMA", value: sma },
+      { label: "Permission (predicted)", value: clone },
+      { label: "Template", value: options.template },
+      { label: "Mandate signer", value: permissionSigner },
+      ...spec.describe(initParams)
+    ],
+    typedData
+  });
+  if (response.status === "rejected") {
+    throw new Error(`User rejected authorization: ${response.reason ?? "no reason given"}`);
+  }
+  if (response.status !== "signature") {
+    throw new Error(`Expected EIP-712 signature response, got: ${response.status}`);
+  }
+  const signature = response.signature;
+  try {
+    const recoveredSigner = await recoverTypedDataAddress({
+      domain: sailKernelDomain({ chainId: project.chainId, kernel: project.contracts.kernel }),
+      types: registerPermissionHasDeadline ? REGISTER_PERMISSION_TYPES : REGISTER_PERMISSION_TYPES_NO_DEADLINE,
+      primaryType: "RegisterPermission",
+      message: registerPermissionHasDeadline ? { account: sma, permission: clone, nonce, deadline } : { account: sma, permission: clone, nonce },
+      signature
+    });
+    if (recoveredSigner.toLowerCase() !== permissionSigner.toLowerCase()) {
+      throw new Error(
+        `Security: RegisterPermission was signed by ${recoveredSigner} but the on-chain mandate signer is ${permissionSigner}.
+Connect the owner wallet (mandate signer) in the browser \u2014 the agent wallet must never sign permission registrations.`
+      );
+    }
+  } catch (err) {
+    if (err.message.startsWith("Security:")) throw err;
+  }
+  const fee = await estimatePermissionFee(publicClient, project.contracts.governance, clone);
+  if (!registerPermissionHasDeadline || deadline === void 0) {
+    throw new Error(
+      "deploy-clone requires a selective kernel (RegisterPermission with deadline). This chain's kernel does not match."
+    );
+  }
+  say(() => console.log(`Submitting deployAndAttach (agent pays gas; fee ${fee} wei)\u2026`));
+  const walletClient = createWalletClient({
+    account: agentSigner.viemAccount,
+    chain: chain2,
+    transport: http(getRpcUrl(project.chainId))
+  });
+  const data = encodeFunctionData({
+    abi: PERMISSION_FACTORY_ABI,
+    functionName: "deployAndAttach",
+    args: [sma, impl, salt, initData, deadline, signature]
+  });
+  const txHash = await walletClient.sendTransaction({
+    to: project.contracts.permissionFactory,
+    data,
+    value: fee,
+    account: agentSigner.viemAccount,
+    chain: chain2
+  });
+  say(() => console.log("Waiting for confirmation\u2026"));
+  const receipt = await publicClient.waitForTransactionReceipt({ hash: txHash });
+  if (receipt.status !== "success") {
+    throw new Error(`deployAndAttach reverted (tx ${txHash})`);
+  }
+  const attached = await pollForPermission(publicClient, project.contracts.kernel, sma, clone);
+  if (!attached) {
+    throw new Error(
+      `Tx ${txHash} mined, but clone ${clone} is not in getPermissions(${sma}). Verify on-chain.`
+    );
+  }
+  say(() => console.log("\u2713", `Deployed + registered ${spec.label} at ${clone}`));
+  const store = new MandateStore();
+  store.add({
+    name: label,
+    address: clone,
+    txHash,
+    chainId: project.chainId,
+    deployedAt: (/* @__PURE__ */ new Date()).toISOString()
+  });
+  store.recordAttachment(clone, { sma, txHash });
+  appendActivity({
+    ts: nowIso(),
+    actor: "agent",
+    type: "permission_registered",
+    permission: clone,
+    name: label,
+    sma,
+    txHash,
+    chainId: project.chainId
+  });
+  emit(json, () => {
+  }, {
+    status: "ok",
+    clone: { template: options.template, address: clone, impl, txHash, sma, chainId: project.chainId }
+  });
+}
 async function mandateAttach(options) {
   const project = requireProject();
   const channel = await createSigningChannel(process.cwd());
@@ -42114,7 +42390,8 @@ Configure the chain in @sail/chains or set KERNEL_ADDRESS in .sail/.env.local.`
     } catch (err) {
       console.error(`could not read registered permissions: ${err.message}`);
     }
-    let tickDispatched = 0;
+    let tickExecuted = 0;
+    let tickReverted = 0;
     let tickSkipped = 0;
     for (const rawDispatch of dispatches) {
       const dispatch = rawDispatch;
@@ -42193,9 +42470,15 @@ Configure the chain in @sail/chains or set KERNEL_ADDRESS in .sail/.env.local.`
           } catch {
           }
         }
-        appendActivity({ ts: nowIso(), actor: "agent", type: "dispatch_executed", permission, target, txHash: result.txHash });
-        console.log(`executed: ${result.txHash}`);
-        tickDispatched++;
+        if (!result.success) {
+          appendActivity({ ts: nowIso(), actor: "agent", type: "dispatch_reverted", permission, target, txHash: result.txHash, gasUsed: String(result.gasUsed) });
+          console.error(`reverted: ${result.txHash}  (gas used: ${result.gasUsed})`);
+          tickReverted++;
+        } else {
+          appendActivity({ ts: nowIso(), actor: "agent", type: "dispatch_executed", permission, target, txHash: result.txHash });
+          console.log(`executed: ${result.txHash}`);
+          tickExecuted++;
+        }
       } catch (err) {
         const reason = err.message;
         console.error(`dispatch error: ${reason}`);
@@ -42204,13 +42487,10 @@ Configure the chain in @sail/chains or set KERNEL_ADDRESS in .sail/.env.local.`
       }
     }
     if (dispatches.length > 0) {
-      if (tickSkipped > 0) {
-        console.log(
-          `tick complete: ${tickDispatched} dispatched, ${tickSkipped} skipped (no matching permission or denied)`
-        );
-      } else {
-        console.log(`tick complete: ${tickDispatched} dispatched`);
-      }
+      const parts = [`${tickExecuted} executed`];
+      if (tickReverted > 0) parts.push(`${tickReverted} reverted`);
+      if (tickSkipped > 0) parts.push(`${tickSkipped} skipped`);
+      console.log(`tick complete: ${parts.join(", ")}`);
     }
     appendActivity({ ts: nowIso(), actor: "agent", type: "tick_end" });
   }
@@ -42707,6 +42987,7 @@ mandate.command("prepare").description("Prepare a mandate draft for review and s
 mandate.command("sign").description("Review and confirm the permissions authorized for your SMA").option("--yes", "Skip the confirmation prompt (for non-interactive / CI use)").action(actionWith(mandateSign));
 mandate.command("deploy").description("Deploy a Foundry-compiled permission contract via the browser signing UI").option("--artifact <path>", "Path to the Foundry artifact JSON (out/<Name>.sol/<Name>.json)").option("--contract <name>", "Contract name; resolves to <out>/<name>.sol/<name>.json").option("--out <dir>", "Foundry output directory", "out").option("--name <label>", "Label to track this permission under (defaults to contract name)").option("--args <json>", `Constructor args as a JSON array, e.g. '[["0x.."],"1000"]'`).option("--build", "Run `forge build` before deploying").option("--attach", "After deploy, register the permission on --sma").option("--sma <address>", "SMA to register on (required with --attach)").option("--json", "Emit machine-readable JSON").action(actionWith(mandateDeploy));
 mandate.command("attach").description("Register an already-deployed permission on an SMA (EIP-712 RegisterPermission)").requiredOption("--address <mandateOrName>", "Permission address, or a name tracked locally").requiredOption("--sma <address>", "SMA to register the permission on").option("--label <label>", "Human-readable label shown in the signing UI").option("--json", "Emit machine-readable JSON").action(actionWith(mandateAttach));
+mandate.command("deploy-clone").description("Deploy + register a standalone clone permission (e.g. boundedApprove) via the signing UI").requiredOption("--template <key>", "Standalone clone template key (e.g. boundedApprove)").requiredOption("--sma <address>", "SMA to deploy the clone for and register it on").option("--tokens <csv>", "Comma-separated allowed token addresses").option("--spenders <csv>", "Comma-separated allowed spender addresses").option("--max <amount>", "Max amount per tx in base units (default: uint256 max)").option("--label <label>", "Human-readable label to track this permission under").option("--json", "Emit machine-readable JSON").action(actionWith(mandateDeployClone));
 mandate.command("revoke").description("Revoke permission(s) from an SMA (EIP-712 RevokePermissions, owner-authorized)").option("--address <permissionOrName>", "Permission address, or a name tracked locally").requiredOption("--sma <address>", "Safe (SMA) to revoke the permission(s) from").option("--all", "Revoke every permission currently registered on the SMA").option("--json", "Output JSON").action(actionWith(mandateRevoke));
 mandate.command("templates").description("Show how to author your own permission contract (and any community-deployed addresses)").option("--json", "Emit machine-readable JSON").action(actionWith(mandateTemplates));
 mandate.command("list").description("List permission contracts deployed from this project").action(action(async () => mandateContractsList()));

package/packages/sdk/dist/intelligence.d.ts

@@ -5,7 +5,7 @@
  * Do not edit manually — run `pnpm build` to regenerate.
  *
  * Spec version : 1.2.0
- * Generated at : 2026-06-06T08:08:18.501Z
+ * Generated at : 2026-06-06T19:10:39.495Z
  */
 export declare const SAIL_INTELLIGENCE_BASE_URL = "https://api.sail.money";
 export declare const SAIL_INTELLIGENCE_DOCS_URL = "https://api.sail.money/docs";

package/packages/sdk/dist/intelligence.js

@@ -5,7 +5,7 @@
  * Do not edit manually — run `pnpm build` to regenerate.
  *
  * Spec version : 1.2.0
- * Generated at : 2026-06-06T08:08:18.501Z
+ * Generated at : 2026-06-06T19:10:39.495Z
  */
 export const SAIL_INTELLIGENCE_BASE_URL = "https://api.sail.money";
 export const SAIL_INTELLIGENCE_DOCS_URL = "https://api.sail.money/docs";

package/packages/sdk/dist/templates/ammLiquidity.d.ts

@@ -1,16 +1,29 @@
 import type { Address, PermissionTemplate } from "../types.js";
-/** Params for SharedAmmLiquidityPermission. */
+/**
+ * Params for SharedAMMLiquidityPermission.
+ *
+ * Matches the on-chain `_applyConfig` decode exactly:
+ *   abi.decode(params, (address[], address[], uint128, bool, bool, bool, bool, bool))
+ *     → allowedTargets, allowedTokens, maxAmountPerTokenPerTx,
+ *       allowMint, allowIncrease, allowDecrease, allowCollect, allowBurn
+ */
 export type AmmLiquidityParams = {
-    /** Maximum total liquidity value in USD-equivalent (18-decimal WAD). */
-    maxLiquidityValueUsd: number;
-    /** Pool addresses the agent may LP into. */
-    allowedPools: Address[];
-    /** Protocol identifiers allowed (e.g. ["uniswapV3", "curveV2", "balancer"]). */
-    allowedProtocols: string[];
-    /** Whether single-sided deposits are permitted. */
-    allowSingleSided: boolean;
-    /** Maximum price range width in basis points (Uni V3 only). */
-    maxRangeBps?: number;
+    /** Position-manager / router addresses the agent may call (UniV3 NPM, Aerodrome, …). */
+    allowedTargets: Address[];
+    /** Token addresses the agent may provide as liquidity. */
+    allowedTokens: Address[];
+    /** Maximum amount of any single token per tx, in that token's base units (uint128). */
+    maxAmountPerTokenPerTx: bigint;
+    /** Allow mint / open-position (and Aerodrome add-liquidity). */
+    allowMint: boolean;
+    /** Allow increaseLiquidity. */
+    allowIncrease: boolean;
+    /** Allow decreaseLiquidity (and Aerodrome remove-liquidity). */
+    allowDecrease: boolean;
+    /** Allow collect (fee withdrawal). */
+    allowCollect: boolean;
+    /** Allow burn (close position NFT). */
+    allowBurn: boolean;
 };
 export declare const ammLiquidityTemplate: PermissionTemplate<AmmLiquidityParams>;
 //# sourceMappingURL=ammLiquidity.d.ts.map

package/packages/sdk/dist/templates/ammLiquidity.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ammLiquidity.d.ts","sourceRoot":"","sources":["../../src/templates/ammLiquidity.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAA2B,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAExF,+CAA+C;AAC/C,MAAM,MAAM,kBAAkB,GAAG;IAC/B,wEAAwE;IACxE,oBAAoB,EAAE,MAAM,CAAC;IAC7B,4CAA4C;IAC5C,YAAY,EAAE,OAAO,EAAE,CAAC;IACxB,gFAAgF;IAChF,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,mDAAmD;IACnD,gBAAgB,EAAE,OAAO,CAAC;IAC1B,+DAA+D;IAC/D,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAUF,eAAO,MAAM,oBAAoB,EAAE,kBAAkB,CAAC,kBAAkB,CAuDvE,CAAC"}
+{"version":3,"file":"ammLiquidity.d.ts","sourceRoot":"","sources":["../../src/templates/ammLiquidity.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAA2B,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAExF;;;;;;;GAOG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC/B,wFAAwF;IACxF,cAAc,EAAE,OAAO,EAAE,CAAC;IAC1B,0DAA0D;IAC1D,aAAa,EAAE,OAAO,EAAE,CAAC;IACzB,uFAAuF;IACvF,sBAAsB,EAAE,MAAM,CAAC;IAC/B,gEAAgE;IAChE,SAAS,EAAE,OAAO,CAAC;IACnB,+BAA+B;IAC/B,aAAa,EAAE,OAAO,CAAC;IACvB,gEAAgE;IAChE,aAAa,EAAE,OAAO,CAAC;IACvB,sCAAsC;IACtC,YAAY,EAAE,OAAO,CAAC;IACtB,uCAAuC;IACvC,SAAS,EAAE,OAAO,CAAC;CACpB,CAAC;AAaF,eAAO,MAAM,oBAAoB,EAAE,kBAAkB,CAAC,kBAAkB,CAyDvE,CAAC"}

package/packages/sdk/dist/templates/ammLiquidity.js

@@ -1,56 +1,64 @@
 import { decodeAbiParameters, encodeAbiParameters } from "viem";
 const ABI = [
-    { name: "maxLiquidityValueUsd", type: "uint256" },
-    { name: "allowedPools", type: "address[]" },
-    { name: "allowedProtocols", type: "string[]" },
-    { name: "allowSingleSided", type: "bool" },
-    { name: "maxRangeBps", type: "uint256" },
+    { name: "allowedTargets", type: "address[]" },
+    { name: "allowedTokens", type: "address[]" },
+    { name: "maxAmountPerTokenPerTx", type: "uint128" },
+    { name: "allowMint", type: "bool" },
+    { name: "allowIncrease", type: "bool" },
+    { name: "allowDecrease", type: "bool" },
+    { name: "allowCollect", type: "bool" },
+    { name: "allowBurn", type: "bool" },
 ];
 export const ammLiquidityTemplate = {
-    name: "SharedAmmLiquidityPermission",
+    name: "SharedAMMLiquidityPermission",
     address: "0x0000000000000000000000000000000000000000",
     encoder: {
         encode(params) {
             return encodeAbiParameters(ABI, [
-                BigInt(Math.round(params.maxLiquidityValueUsd)),
-                params.allowedPools,
-                params.allowedProtocols,
-                params.allowSingleSided,
-                BigInt(params.maxRangeBps ?? 0),
+                params.allowedTargets,
+                params.allowedTokens,
+                params.maxAmountPerTokenPerTx,
+                params.allowMint,
+                params.allowIncrease,
+                params.allowDecrease,
+                params.allowCollect,
+                params.allowBurn,
             ]);
         },
         decode(data) {
             const decoded = decodeAbiParameters(ABI, data);
-            const maxRangeBps = Number(decoded[4]);
             return {
-                maxLiquidityValueUsd: Number(decoded[0]),
-                allowedPools: [...decoded[1]],
-                allowedProtocols: [...decoded[2]],
-                allowSingleSided: decoded[3],
-                ...(maxRangeBps > 0 ? { maxRangeBps } : {}),
+                allowedTargets: [...decoded[0]],
+                allowedTokens: [...decoded[1]],
+                maxAmountPerTokenPerTx: decoded[2],
+                allowMint: decoded[3],
+                allowIncrease: decoded[4],
+                allowDecrease: decoded[5],
+                allowCollect: decoded[6],
+                allowBurn: decoded[7],
             };
         },
     },
     explainer: {
         explain(params) {
             const warnings = [];
-            if (params.allowSingleSided) {
-                warnings.push("Single-sided deposits permitted — may result in immediate impermanent loss");
+            if (params.allowedTargets.length === 0) {
+                warnings.push("No targets specified — all liquidity operations will be blocked");
             }
-            if (params.maxRangeBps !== undefined && params.maxRangeBps > 5000) {
-                warnings.push(`Wide price range allowed: ±${params.maxRangeBps / 100}%`);
-            }
-            const rangeNote = params.maxRangeBps !== undefined
-                ? `Maximum price range (Uni V3): ±${params.maxRangeBps / 100}%`
-                : null;
+            const ops = [
+                params.allowMint && "mint",
+                params.allowIncrease && "increase",
+                params.allowDecrease && "decrease",
+                params.allowCollect && "collect",
+                params.allowBurn && "burn",
+            ].filter(Boolean);
             return {
-                templateName: "SharedAmmLiquidityPermission",
+                templateName: "SharedAMMLiquidityPermission",
                 humanReadable: [
-                    `Maximum liquidity value: $${params.maxLiquidityValueUsd.toLocaleString()} USD`,
-                    `Allowed protocols: ${params.allowedProtocols.join(", ")}`,
-                    `Allowed pools (${params.allowedPools.length}): ${params.allowedPools.join(", ")}`,
-                    `Single-sided deposits: ${params.allowSingleSided ? "allowed" : "not allowed"}`,
-                    ...(rangeNote ? [rangeNote] : []),
+                    `Maximum amount per token per tx: ${params.maxAmountPerTokenPerTx.toString()} (base units)`,
+                    `Allowed targets (${params.allowedTargets.length}): ${params.allowedTargets.join(", ")}`,
+                    `Allowed tokens: ${params.allowedTokens.join(", ")}`,
+                    `Enabled operations: ${ops.length ? ops.join(", ") : "none"}`,
                 ],
                 warnings,
             };

package/packages/sdk/dist/templates/ammLiquidity.js.map

@@ -1 +1 @@
-{"version":3,"file":"ammLiquidity.js","sourceRoot":"","sources":["../../src/templates/ammLiquidity.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"ammLiquidity.js","sourceRoot":"","sources":["../../src/templates/ammLiquidity.ts"],"names":[],"mappings":"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"}

package/packages/sdk/dist/templates/approveAndCallBatch.d.ts

@@ -1,14 +1,28 @@
-import type { Address, PermissionTemplate } from "../types.js";
-/** Params for SharedApproveAndCallBatchPermission. */
+import type { Address, Hex, PermissionTemplate } from "../types.js";
+/**
+ * Params for SharedApproveAndCallBatchPermission.
+ *
+ * Matches the on-chain `_applyConfig` decode exactly:
+ *   abi.decode(params, (Config))
+ * where Config is the tuple
+ *   (address[] tokens, address[] spenders, address[] consumingTargets,
+ *    bytes4[] consumingSelectors, uint256[] maxApprovalAmounts, bool requireAmountMatch)
+ *
+ * Note: the contract encodes a SINGLE struct, so the blob is one top-level tuple.
+ */
 export type ApproveAndCallBatchParams = {
-    /** Spender addresses that may receive ERC-20 approvals. */
-    allowedSpenders: Address[];
-    /** Token addresses for which approvals may be granted. */
-    allowedTokens: Address[];
-    /** Maximum total approval value per batch in USD-equivalent (18-decimal WAD). */
-    maxApprovalValueUsd: number;
-    /** Whether infinite (max-uint) approvals are permitted. */
-    allowInfiniteApprovals: boolean;
+    /** Allowlisted ERC-20 tokens that may be approved. Index-parallel with `maxApprovalAmounts`. */
+    tokens: Address[];
+    /** Allowlisted spenders that may receive the allowance. */
+    spenders: Address[];
+    /** Allowlisted consuming-call targets (often the same as spenders). */
+    consumingTargets: Address[];
+    /** Allowlisted selectors for the consuming call (4-byte hex, e.g. "0x095ea7b3"). */
+    consumingSelectors: Hex[];
+    /** Max approve amount per token, index-parallel with `tokens`. */
+    maxApprovalAmounts: bigint[];
+    /** When true, the consuming call's leading uint256 arg must equal the approved amount. */
+    requireAmountMatch: boolean;
 };
 export declare const approveAndCallBatchTemplate: PermissionTemplate<ApproveAndCallBatchParams>;
 //# sourceMappingURL=approveAndCallBatch.d.ts.map

package/packages/sdk/dist/templates/approveAndCallBatch.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"approveAndCallBatch.d.ts","sourceRoot":"","sources":["../../src/templates/approveAndCallBatch.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAA2B,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAExF,sDAAsD;AACtD,MAAM,MAAM,yBAAyB,GAAG;IACtC,2DAA2D;IAC3D,eAAe,EAAE,OAAO,EAAE,CAAC;IAC3B,0DAA0D;IAC1D,aAAa,EAAE,OAAO,EAAE,CAAC;IACzB,iFAAiF;IACjF,mBAAmB,EAAE,MAAM,CAAC;IAC5B,2DAA2D;IAC3D,sBAAsB,EAAE,OAAO,CAAC;CACjC,CAAC;AASF,eAAO,MAAM,2BAA2B,EAAE,kBAAkB,CAAC,yBAAyB,CAgDrF,CAAC"}
+{"version":3,"file":"approveAndCallBatch.d.ts","sourceRoot":"","sources":["../../src/templates/approveAndCallBatch.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,GAAG,EAAsB,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAExF;;;;;;;;;;GAUG;AACH,MAAM,MAAM,yBAAyB,GAAG;IACtC,gGAAgG;IAChG,MAAM,EAAE,OAAO,EAAE,CAAC;IAClB,2DAA2D;IAC3D,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,uEAAuE;IACvE,gBAAgB,EAAE,OAAO,EAAE,CAAC;IAC5B,oFAAoF;IACpF,kBAAkB,EAAE,GAAG,EAAE,CAAC;IAC1B,kEAAkE;IAClE,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,0FAA0F;IAC1F,kBAAkB,EAAE,OAAO,CAAC;CAC7B,CAAC;AAaF,eAAO,MAAM,2BAA2B,EAAE,kBAAkB,CAAC,yBAAyB,CA4DrF,CAAC"}