@sm-lab/recipes 0.2.0

package/dist/cm.mjs

@@ -0,0 +1,305 @@
+import { a as deposit, c as RESUME_ROLE, d as addKeys, h as roleMember, m as actAs, n as topUpActiveKeys, o as DEFAULT_ADMIN_ROLE, p as randomSeed, u as SET_TREE_ROLE, v as resolveGate } from "./topup-B2NzJV7_.mjs";
+import { concat, keccak256, toHex, zeroAddress } from "viem";
+import { curatedGateAbi, metaRegistryAbi } from "@sm-lab/receipts";
+import { buildAddressesTree } from "@sm-lab/merkle";
+//#region src/cm/index.ts
+/** An empty MetaRegistry OperatorGroup — used to reset a group to its zero state. */
+const EMPTY_GROUP = {
+	name: "",
+	subNodeOperators: [],
+	externalOperators: []
+};
+/**
+* Create a node operator through a curated gate by temporarily installing a 2-leaf merkle
+* tree that admits `operator`, creating the operator, then restoring the gate's original
+* tree. (Port of `NodeOperators.createCuratedOperator`; no post-assertions — returns noId.)
+*/
+async function createCuratedOperator(ctx, opts) {
+	if (ctx.module !== "cm") throw new Error("@sm-lab/recipes/cm: createCuratedOperator requires ctx.module === \"cm\"");
+	const gate = {
+		address: resolveGate(ctx, opts.selector),
+		abi: curatedGateAbi
+	};
+	const extra = opts.extra ?? deriveExtra(opts.operator);
+	const origRoot = await ctx.client.readContract({
+		...gate,
+		functionName: "treeRoot"
+	});
+	const origCid = await ctx.client.readContract({
+		...gate,
+		functionName: "treeCid"
+	});
+	const admin = await roleMember(ctx, gate, DEFAULT_ADMIN_ROLE);
+	const tree = buildAddressesTree([opts.operator, extra]);
+	const tmpRoot = tree.root;
+	const proof = tree.getProof([opts.operator]);
+	const tmpCid = `tmp-cid-${opts.operator.toLowerCase()}`;
+	await actAs(ctx, admin, async (from) => {
+		await ctx.client.writeContract({
+			...gate,
+			functionName: "grantRole",
+			args: [SET_TREE_ROLE, admin],
+			account: from,
+			chain: null
+		});
+		if (await ctx.client.readContract({
+			...gate,
+			functionName: "isPaused"
+		})) {
+			await ctx.client.writeContract({
+				...gate,
+				functionName: "grantRole",
+				args: [RESUME_ROLE, admin],
+				account: from,
+				chain: null
+			});
+			await ctx.client.writeContract({
+				...gate,
+				functionName: "resume",
+				account: from,
+				chain: null
+			});
+		}
+		await ctx.client.writeContract({
+			...gate,
+			functionName: "setTreeParams",
+			args: [tmpRoot, tmpCid],
+			account: from,
+			chain: null
+		});
+	});
+	try {
+		const { result, request } = await ctx.client.simulateContract({
+			...gate,
+			functionName: "createNodeOperator",
+			args: [
+				opts.name ?? "fork-operator",
+				opts.description ?? "fork-test",
+				zeroAddress,
+				zeroAddress,
+				proof
+			],
+			account: opts.operator
+		});
+		const noId = result;
+		await actAs(ctx, opts.operator, () => ctx.client.writeContract({
+			...request,
+			chain: null
+		}));
+		return { noId };
+	} finally {
+		await actAs(ctx, admin, (from) => ctx.client.writeContract({
+			...gate,
+			functionName: "setTreeParams",
+			args: [origRoot, origCid],
+			account: from,
+			chain: null
+		}));
+	}
+}
+/**
+* Create a node-operator group on the MetaRegistry: reset any pre-existing memberships of the
+* named operators, then write a fresh group under `NO_GROUP_ID`. Port of
+* `MetaRegistryHelpers.createOperatorGroup` (the `MANAGE_OPERATOR_GROUPS_ROLE` member acts).
+*/
+async function createOperatorGroup(ctx, opts) {
+	if (ctx.module !== "cm") throw new Error("@sm-lab/recipes/cm: createOperatorGroup requires ctx.module === \"cm\"");
+	if (opts.pairs.length < 1) throw new Error("@sm-lab/recipes/cm: createOperatorGroup needs ≥1 [noId, shareBps] pair");
+	const shareSum = opts.pairs.reduce((acc, [, s]) => acc + s, 0n);
+	if (shareSum !== 10000n) throw new Error(`@sm-lab/recipes/cm: shares must sum to 10000 bps (got ${shareSum})`);
+	const mr = {
+		address: ctx.addresses.MetaRegistry,
+		abi: metaRegistryAbi
+	};
+	const manager = await roleMember(ctx, mr, await ctx.client.readContract({
+		...mr,
+		functionName: "MANAGE_OPERATOR_GROUPS_ROLE"
+	}));
+	const noGroupId = await ctx.client.readContract({
+		...mr,
+		functionName: "NO_GROUP_ID"
+	});
+	const gids = await Promise.all(opts.pairs.map(([noId]) => ctx.client.readContract({
+		...mr,
+		functionName: "getNodeOperatorGroupId",
+		args: [noId]
+	})));
+	const toReset = /* @__PURE__ */ new Set();
+	for (const gid of gids) if (gid !== noGroupId) toReset.add(gid);
+	const resetGroupIds = [...toReset];
+	const subNodeOperators = opts.pairs.map(([noId, share]) => ({
+		nodeOperatorId: noId,
+		share: Number(share)
+	}));
+	const group = {
+		name: opts.name ?? "",
+		subNodeOperators,
+		externalOperators: []
+	};
+	await actAs(ctx, manager, async (from) => {
+		for (const gid of resetGroupIds) await ctx.client.writeContract({
+			...mr,
+			functionName: "createOrUpdateOperatorGroup",
+			args: [gid, EMPTY_GROUP],
+			account: from,
+			chain: null
+		});
+		await ctx.client.writeContract({
+			...mr,
+			functionName: "createOrUpdateOperatorGroup",
+			args: [noGroupId, group],
+			account: from,
+			chain: null
+		});
+	});
+	return {
+		subNodeOperators,
+		resetGroupIds
+	};
+}
+/**
+* Reset the operator group that contains `noId` to its empty state. Port of
+* `MetaRegistryHelpers.resetOperatorGroup`; throws if the operator is in no group.
+*/
+async function resetOperatorGroup(ctx, opts) {
+	if (ctx.module !== "cm") throw new Error("@sm-lab/recipes/cm: resetOperatorGroup requires ctx.module === \"cm\"");
+	const mr = {
+		address: ctx.addresses.MetaRegistry,
+		abi: metaRegistryAbi
+	};
+	const manager = await roleMember(ctx, mr, await ctx.client.readContract({
+		...mr,
+		functionName: "MANAGE_OPERATOR_GROUPS_ROLE"
+	}));
+	const gid = await ctx.client.readContract({
+		...mr,
+		functionName: "getNodeOperatorGroupId",
+		args: [opts.noId]
+	});
+	if (gid === await ctx.client.readContract({
+		...mr,
+		functionName: "NO_GROUP_ID"
+	})) throw new Error("@sm-lab/recipes/cm: operator not in a group");
+	await actAs(ctx, manager, (from) => ctx.client.writeContract({
+		...mr,
+		functionName: "createOrUpdateOperatorGroup",
+		args: [gid, EMPTY_GROUP],
+		account: from,
+		chain: null
+	}));
+	return { groupId: gid };
+}
+/**
+* Set a bond-curve weight on the MetaRegistry. Port of
+* `MetaRegistryHelpers.setBondCurveWeight` (the `SET_BOND_CURVE_WEIGHT_ROLE` member acts).
+*/
+async function setBondCurveWeight(ctx, opts) {
+	if (ctx.module !== "cm") throw new Error("@sm-lab/recipes/cm: setBondCurveWeight requires ctx.module === \"cm\"");
+	const mr = {
+		address: ctx.addresses.MetaRegistry,
+		abi: metaRegistryAbi
+	};
+	await actAs(ctx, await roleMember(ctx, mr, await ctx.client.readContract({
+		...mr,
+		functionName: "SET_BOND_CURVE_WEIGHT_ROLE"
+	})), (from) => ctx.client.writeContract({
+		...mr,
+		functionName: "setBondCurveWeight",
+		args: [opts.curveId, opts.weight],
+		account: from,
+		chain: null
+	}));
+	return {
+		curveId: opts.curveId,
+		weight: opts.weight
+	};
+}
+/** A deterministic address distinct from `operator` (low 20 bytes of its keccak hash). */
+function deriveExtra(operator) {
+	return `0x${keccak256(operator).slice(-40)}`;
+}
+/** A deterministic address from a seed + label (low 20 bytes of keccak — mirrors deriveExtra). */
+function deriveOperatorAddress(seed, i) {
+	return `0x${keccak256(concat([seed, toHex(`cm-operator-${i}`)])).slice(-40)}`;
+}
+/** A deterministic key seed from a seed + label (so the 7 addKeys calls never collide on pubkeys). */
+function keySeed(seed, label) {
+	return keccak256(concat([seed, toHex(label)]));
+}
+/**
+* Seed a realistic cm fork in one call: create 3 gate operators, group them 34/33/33, then key /
+* deposit / top-up across 3 rounds (and add a final key to two of them). Port of `fork.just
+* seed-cm`. Composes already-tested recipes; uses the noIds returned by `createCuratedOperator`
+* (not hardcoded 0/1/2) so it is correct on a non-fresh fork too. Deterministic when `seed` is set.
+*/
+async function seedCm(ctx, opts = {}) {
+	if (ctx.module !== "cm") throw new Error("@sm-lab/recipes/cm: seedCm requires ctx.module === \"cm\"");
+	const selector = opts.selector ?? "po";
+	const seed = opts.seed ?? randomSeed();
+	const operators = [
+		deriveOperatorAddress(seed, 0),
+		deriveOperatorAddress(seed, 1),
+		deriveOperatorAddress(seed, 2)
+	];
+	const { noId: na } = await createCuratedOperator(ctx, {
+		selector,
+		operator: operators[0]
+	});
+	const { noId: nb } = await createCuratedOperator(ctx, {
+		selector,
+		operator: operators[1]
+	});
+	const { noId: nc } = await createCuratedOperator(ctx, {
+		selector,
+		operator: operators[2]
+	});
+	const noIds = [
+		na,
+		nb,
+		nc
+	];
+	await createOperatorGroup(ctx, { pairs: [
+		[na, 3400n],
+		[nb, 3300n],
+		[nc, 3300n]
+	] });
+	await addKeys(ctx, {
+		noId: na,
+		count: 4,
+		seed: keySeed(seed, "r0")
+	});
+	await deposit(ctx, { count: 100 });
+	await topUpActiveKeys(ctx, { noId: na });
+	await addKeys(ctx, {
+		noId: nb,
+		count: 5,
+		seed: keySeed(seed, "r1")
+	});
+	await deposit(ctx, { count: 100 });
+	await topUpActiveKeys(ctx, { noId: nb });
+	await addKeys(ctx, {
+		noId: na,
+		count: 6,
+		seed: keySeed(seed, "r2")
+	});
+	await deposit(ctx, { count: 100 });
+	await topUpActiveKeys(ctx, { noId: na });
+	await addKeys(ctx, {
+		noId: na,
+		count: 1,
+		seed: keySeed(seed, "r3")
+	});
+	await addKeys(ctx, {
+		noId: nb,
+		count: 1,
+		seed: keySeed(seed, "r4")
+	});
+	return {
+		noIds,
+		operators
+	};
+}
+//#endregion
+export { createCuratedOperator, createOperatorGroup, resetOperatorGroup, seedCm, setBondCurveWeight };
+
+//# sourceMappingURL=cm.mjs.map

package/dist/cm.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"cm.mjs","names":[],"sources":["../src/cm/index.ts"],"sourcesContent":["import { buildAddressesTree } from '@sm-lab/merkle';\nimport { curatedGateAbi, metaRegistryAbi } from '@sm-lab/receipts';\nimport type { CmAddressBook, Hex } from '@sm-lab/receipts';\nimport { concat, keccak256, toHex, zeroAddress } from 'viem';\nimport { actAs, roleMember } from '../act-as';\nimport { resolveGate, type Ctx, type CmGateSelector } from '../context';\nimport { randomSeed } from '../random';\nimport { addKeys } from '../recipes/add-keys';\nimport { deposit } from '../recipes/deposit';\nimport { topUpActiveKeys } from '../recipes/topup';\nimport { DEFAULT_ADMIN_ROLE, RESUME_ROLE, SET_TREE_ROLE } from '../roles';\n\n/** An empty MetaRegistry OperatorGroup — used to reset a group to its zero state. */\nconst EMPTY_GROUP = { name: '', subNodeOperators: [], externalOperators: [] };\n\nexport interface CreateCuratedOperatorOptions {\n  /** cm gate selector (po/pto/…) or a raw 0x… address. */\n  selector: CmGateSelector | string;\n  /** The new operator's address; also the merkle leaf proven into the temp tree. */\n  operator: Hex;\n  /** Second leaf for the N=2 temp tree; derived deterministically from `operator` if omitted. */\n  extra?: Hex;\n  name?: string;\n  description?: string;\n}\n\nexport interface CreateCuratedOperatorResult {\n  noId: bigint;\n}\n\n/**\n * Create a node operator through a curated gate by temporarily installing a 2-leaf merkle\n * tree that admits `operator`, creating the operator, then restoring the gate's original\n * tree. (Port of `NodeOperators.createCuratedOperator`; no post-assertions — returns noId.)\n */\nexport async function createCuratedOperator(\n  ctx: Ctx,\n  opts: CreateCuratedOperatorOptions,\n): Promise<CreateCuratedOperatorResult> {\n  if (ctx.module !== 'cm') {\n    throw new Error('@sm-lab/recipes/cm: createCuratedOperator requires ctx.module === \"cm\"');\n  }\n  const gate = { address: resolveGate(ctx, opts.selector), abi: curatedGateAbi } as const;\n  const extra = opts.extra ?? deriveExtra(opts.operator);\n\n  // Snapshot the original tree so we can restore it after creating the operator.\n  const origRoot = await ctx.client.readContract({ ...gate, functionName: 'treeRoot' });\n  const origCid = await ctx.client.readContract({ ...gate, functionName: 'treeCid' });\n  const admin = await roleMember(ctx, gate, DEFAULT_ADMIN_ROLE);\n\n  // N=2 OZ ['address'] tree; prove by value (OZ sorts leaves, so index is unreliable).\n  const tree = buildAddressesTree([opts.operator, extra]);\n  const tmpRoot = tree.root as Hex;\n  const proof = tree.getProof([opts.operator]) as Hex[];\n  const tmpCid = `tmp-cid-${opts.operator.toLowerCase()}`;\n\n  // Install the temp tree as the gate admin (grant SET_TREE_ROLE, resume if paused, set).\n  await actAs(ctx, admin, async (from) => {\n    await ctx.client.writeContract({\n      ...gate,\n      functionName: 'grantRole',\n      args: [SET_TREE_ROLE, admin],\n      account: from,\n      chain: null,\n    });\n    const paused = await ctx.client.readContract({ ...gate, functionName: 'isPaused' });\n    if (paused) {\n      await ctx.client.writeContract({\n        ...gate,\n        functionName: 'grantRole',\n        args: [RESUME_ROLE, admin],\n        account: from,\n        chain: null,\n      });\n      await ctx.client.writeContract({\n        ...gate,\n        functionName: 'resume',\n        account: from,\n        chain: null,\n      });\n    }\n    await ctx.client.writeContract({\n      ...gate,\n      functionName: 'setTreeParams',\n      args: [tmpRoot, tmpCid],\n      account: from,\n      chain: null,\n    });\n  });\n\n  // Capture the returned noId via simulate, then send the real tx as the operator.\n  // The restore runs in `finally` so a failed create never leaves the gate with the\n  // temporary tree installed on the fork (matching actAs's stop-on-any-exit discipline).\n  try {\n    const { result, request } = await ctx.client.simulateContract({\n      ...gate,\n      functionName: 'createNodeOperator',\n      args: [\n        opts.name ?? 'fork-operator',\n        opts.description ?? 'fork-test',\n        zeroAddress,\n        zeroAddress,\n        proof,\n      ],\n      account: opts.operator,\n    });\n    const noId = result as bigint;\n    await actAs(ctx, opts.operator, () => ctx.client.writeContract({ ...request, chain: null }));\n    return { noId };\n  } finally {\n    await actAs(ctx, admin, (from) =>\n      ctx.client.writeContract({\n        ...gate,\n        functionName: 'setTreeParams',\n        args: [origRoot, origCid],\n        account: from,\n        chain: null,\n      }),\n    );\n  }\n}\n\nexport interface CreateOperatorGroupOptions {\n  /** [nodeOperatorId, shareBps] pairs; shares in basis points (e.g. 6000 = 60%), must sum to 10000. */\n  pairs: [bigint, bigint][];\n  /** Optional group name (Solidity leaves it ''); default ''. */\n  name?: string;\n}\n\nexport interface CreateOperatorGroupResult {\n  /** The sub-node-operators written into the NO_GROUP_ID group, in input order. */\n  subNodeOperators: { nodeOperatorId: bigint; share: number }[];\n  /** Group ids reset to EMPTY_GROUP first (operators previously in a group), de-duplicated. */\n  resetGroupIds: bigint[];\n}\n\n/**\n * Create a node-operator group on the MetaRegistry: reset any pre-existing memberships of the\n * named operators, then write a fresh group under `NO_GROUP_ID`. Port of\n * `MetaRegistryHelpers.createOperatorGroup` (the `MANAGE_OPERATOR_GROUPS_ROLE` member acts).\n */\nexport async function createOperatorGroup(\n  ctx: Ctx,\n  opts: CreateOperatorGroupOptions,\n): Promise<CreateOperatorGroupResult> {\n  if (ctx.module !== 'cm') {\n    throw new Error('@sm-lab/recipes/cm: createOperatorGroup requires ctx.module === \"cm\"');\n  }\n  // Validate input BEFORE any chain call — a precise error beats an opaque on-chain revert.\n  if (opts.pairs.length < 1)\n    throw new Error('@sm-lab/recipes/cm: createOperatorGroup needs ≥1 [noId, shareBps] pair');\n  const shareSum = opts.pairs.reduce((acc, [, s]) => acc + s, 0n);\n  if (shareSum !== 10000n)\n    throw new Error(`@sm-lab/recipes/cm: shares must sum to 10000 bps (got ${shareSum})`);\n\n  const mr = {\n    address: (ctx.addresses as CmAddressBook).MetaRegistry as Hex,\n    abi: metaRegistryAbi,\n  } as const;\n  const role = (await ctx.client.readContract({\n    ...mr,\n    functionName: 'MANAGE_OPERATOR_GROUPS_ROLE',\n  })) as Hex;\n  const manager = await roleMember(ctx, mr, role);\n\n  const noGroupId = (await ctx.client.readContract({\n    ...mr,\n    functionName: 'NO_GROUP_ID',\n  })) as bigint;\n\n  // Resolve current memberships up front (parallel reads — order-independent), then de-dup the gids\n  // to reset (a harmless divergence from Solidity's per-pair reset, which can double-reset an\n  // already-emptied gid). A Set preserves insertion order, so resetGroupIds stays deterministic in\n  // first-encounter order.\n  const gids = (await Promise.all(\n    opts.pairs.map(([noId]) =>\n      ctx.client.readContract({ ...mr, functionName: 'getNodeOperatorGroupId', args: [noId] }),\n    ),\n  )) as bigint[];\n  const toReset = new Set<bigint>();\n  for (const gid of gids) {\n    if (gid !== noGroupId) toReset.add(gid);\n  }\n  const resetGroupIds = [...toReset];\n\n  const subNodeOperators = opts.pairs.map(([noId, share]) => ({\n    nodeOperatorId: noId, // bigint (uint64)\n    share: Number(share), // number (uint16)\n  }));\n  const group = { name: opts.name ?? '', subNodeOperators, externalOperators: [] };\n\n  await actAs(ctx, manager, async (from) => {\n    for (const gid of resetGroupIds) {\n      // eslint-disable-next-line no-await-in-loop -- sequential by necessity (impersonation is global state)\n      await ctx.client.writeContract({\n        ...mr,\n        functionName: 'createOrUpdateOperatorGroup',\n        args: [gid, EMPTY_GROUP],\n        account: from,\n        chain: null,\n      });\n    }\n    await ctx.client.writeContract({\n      ...mr,\n      functionName: 'createOrUpdateOperatorGroup',\n      args: [noGroupId, group],\n      account: from,\n      chain: null,\n    });\n  });\n\n  return { subNodeOperators, resetGroupIds };\n}\n\nexport interface ResetOperatorGroupResult {\n  groupId: bigint;\n}\n\n/**\n * Reset the operator group that contains `noId` to its empty state. Port of\n * `MetaRegistryHelpers.resetOperatorGroup`; throws if the operator is in no group.\n */\nexport async function resetOperatorGroup(\n  ctx: Ctx,\n  opts: { noId: bigint },\n): Promise<ResetOperatorGroupResult> {\n  if (ctx.module !== 'cm') {\n    throw new Error('@sm-lab/recipes/cm: resetOperatorGroup requires ctx.module === \"cm\"');\n  }\n  const mr = {\n    address: (ctx.addresses as CmAddressBook).MetaRegistry as Hex,\n    abi: metaRegistryAbi,\n  } as const;\n  const role = (await ctx.client.readContract({\n    ...mr,\n    functionName: 'MANAGE_OPERATOR_GROUPS_ROLE',\n  })) as Hex;\n  const manager = await roleMember(ctx, mr, role);\n\n  const gid = (await ctx.client.readContract({\n    ...mr,\n    functionName: 'getNodeOperatorGroupId',\n    args: [opts.noId],\n  })) as bigint;\n  const noGroupId = (await ctx.client.readContract({\n    ...mr,\n    functionName: 'NO_GROUP_ID',\n  })) as bigint;\n  if (gid === noGroupId) throw new Error('@sm-lab/recipes/cm: operator not in a group');\n\n  await actAs(ctx, manager, (from) =>\n    ctx.client.writeContract({\n      ...mr,\n      functionName: 'createOrUpdateOperatorGroup',\n      args: [gid, EMPTY_GROUP],\n      account: from,\n      chain: null,\n    }),\n  );\n\n  return { groupId: gid };\n}\n\n/**\n * Set a bond-curve weight on the MetaRegistry. Port of\n * `MetaRegistryHelpers.setBondCurveWeight` (the `SET_BOND_CURVE_WEIGHT_ROLE` member acts).\n */\nexport async function setBondCurveWeight(\n  ctx: Ctx,\n  opts: { curveId: bigint; weight: bigint },\n): Promise<{ curveId: bigint; weight: bigint }> {\n  if (ctx.module !== 'cm') {\n    throw new Error('@sm-lab/recipes/cm: setBondCurveWeight requires ctx.module === \"cm\"');\n  }\n  const mr = {\n    address: (ctx.addresses as CmAddressBook).MetaRegistry as Hex,\n    abi: metaRegistryAbi,\n  } as const;\n  const role = (await ctx.client.readContract({\n    ...mr,\n    functionName: 'SET_BOND_CURVE_WEIGHT_ROLE',\n  })) as Hex;\n  const setter = await roleMember(ctx, mr, role);\n\n  await actAs(ctx, setter, (from) =>\n    ctx.client.writeContract({\n      ...mr,\n      functionName: 'setBondCurveWeight',\n      args: [opts.curveId, opts.weight],\n      account: from,\n      chain: null,\n    }),\n  );\n\n  return { curveId: opts.curveId, weight: opts.weight };\n}\n\n/** A deterministic address distinct from `operator` (low 20 bytes of its keccak hash). */\nfunction deriveExtra(operator: Hex): Hex {\n  const h = keccak256(operator); // 0x + 64 hex chars\n  return `0x${h.slice(-40)}` as Hex; // low 20 bytes → a valid, distinct address\n}\n\nexport interface SeedCmOptions {\n  /** cm gate selector for the 3 created operators (default 'po' = CuratedGates[0]). */\n  selector?: CmGateSelector | string;\n  /** Deterministic seed for the operator addresses + key material. Omit → fresh random. */\n  seed?: Hex;\n}\n\nexport interface SeedCmResult {\n  /** The 3 created operators' noIds, in creation order (a/b/c). */\n  noIds: [bigint, bigint, bigint];\n  /** The operator addresses generated for the gate, parallel to `noIds`. */\n  operators: [Hex, Hex, Hex];\n}\n\n/** A deterministic address from a seed + label (low 20 bytes of keccak — mirrors deriveExtra). */\nfunction deriveOperatorAddress(seed: Hex, i: number): Hex {\n  const h = keccak256(concat([seed, toHex(`cm-operator-${i}`)]));\n  return `0x${h.slice(-40)}` as Hex;\n}\n\n/** A deterministic key seed from a seed + label (so the 7 addKeys calls never collide on pubkeys). */\nfunction keySeed(seed: Hex, label: string): Hex {\n  return keccak256(concat([seed, toHex(label)]));\n}\n\n/**\n * Seed a realistic cm fork in one call: create 3 gate operators, group them 34/33/33, then key /\n * deposit / top-up across 3 rounds (and add a final key to two of them). Port of `fork.just\n * seed-cm`. Composes already-tested recipes; uses the noIds returned by `createCuratedOperator`\n * (not hardcoded 0/1/2) so it is correct on a non-fresh fork too. Deterministic when `seed` is set.\n */\nexport async function seedCm(ctx: Ctx, opts: SeedCmOptions = {}): Promise<SeedCmResult> {\n  if (ctx.module !== 'cm') {\n    throw new Error('@sm-lab/recipes/cm: seedCm requires ctx.module === \"cm\"');\n  }\n\n  const selector = opts.selector ?? 'po';\n  const seed = opts.seed ?? randomSeed();\n  const operators: [Hex, Hex, Hex] = [\n    deriveOperatorAddress(seed, 0),\n    deriveOperatorAddress(seed, 1),\n    deriveOperatorAddress(seed, 2),\n  ];\n\n  // Sequential by necessity: each createCuratedOperator installs/restores the gate temp tree and\n  // every later step reads fork state mutated by the prior ones.\n  const { noId: na } = await createCuratedOperator(ctx, { selector, operator: operators[0] });\n  const { noId: nb } = await createCuratedOperator(ctx, { selector, operator: operators[1] });\n  const { noId: nc } = await createCuratedOperator(ctx, { selector, operator: operators[2] });\n  const noIds: [bigint, bigint, bigint] = [na, nb, nc];\n\n  await createOperatorGroup(ctx, {\n    pairs: [\n      [na, 3400n],\n      [nb, 3300n],\n      [nc, 3300n],\n    ],\n  });\n\n  // 3 add/deposit/topup rounds, mapping the source's operator indices 0/1/0 to na/nb/na. Each\n  // addKeys gets a distinct per-call label (r0..r4) so na's three calls draw different key material.\n  // Note: keccak256(seed) % 2^20 startIndex ranges CAN collide across seeds (birthday in 1M space),\n  // but that is benign here — CSM does not dedup pubkeys (SigningKeys.sol has no uniqueness check).\n  await addKeys(ctx, { noId: na, count: 4, seed: keySeed(seed, 'r0') });\n  await deposit(ctx, { count: 100 });\n  await topUpActiveKeys(ctx, { noId: na });\n\n  await addKeys(ctx, { noId: nb, count: 5, seed: keySeed(seed, 'r1') });\n  await deposit(ctx, { count: 100 });\n  await topUpActiveKeys(ctx, { noId: nb });\n\n  await addKeys(ctx, { noId: na, count: 6, seed: keySeed(seed, 'r2') });\n  await deposit(ctx, { count: 100 });\n  await topUpActiveKeys(ctx, { noId: na });\n\n  // Final keys, no deposit/topup.\n  await addKeys(ctx, { noId: na, count: 1, seed: keySeed(seed, 'r3') });\n  await addKeys(ctx, { noId: nb, count: 1, seed: keySeed(seed, 'r4') });\n\n  return { noIds, operators };\n}\n"],"mappings":"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"}