@black-market/sdk 0.11.0 → 0.13.0

package/examples/launch-example-support.ts

@@ -607,9 +607,7 @@ export function createLocalLaunchWallet({ privateKey, creator, chainId, orchestr
           if (request[field] < 0n) throw exampleError("INVALID_ENVELOPE", `${field} must be unsigned`);
         }
       }
-      request.nonce = envelope.nonce === undefined
-        ? exactNumber(await client.request({ method: "eth_getTransactionCount", params: [creator, "pending"] }), "nonce")
-        : exactNumber(envelope.nonce, "nonce");
+      if (envelope.nonce !== undefined) request.nonce = exactNumber(envelope.nonce, "nonce");
       if (request.type !== undefined) {
         request.type = transactionTypes[request.type];
         if (!request.type) throw exampleError("INVALID_ENVELOPE", "Only legacy/EIP-2930/EIP-1559 envelopes are supported");
@@ -622,6 +620,16 @@ export function createLocalLaunchWallet({ privateKey, creator, chainId, orchestr
         request.maxFeePerGas ??= fees.maxFeePerGas;
         request.maxPriorityFeePerGas ??= fees.maxPriorityFeePerGas;
       }
+      const [nonceValue, balanceValue] = await Promise.all([
+        client.request({ method: "eth_getTransactionCount", params: [creator, "pending"] }),
+        client.request({ method: "eth_getBalance", params: [creator, "pending"] }),
+      ]);
+      const pendingNonce = exactNumber(nonceValue, "pending nonce");
+      if (request.nonce !== undefined && request.nonce !== pendingNonce) throw exampleError("PENDING_NONCE_CHANGED", "Pending account nonce differs from the exact reviewed envelope");
+      request.nonce = pendingNonce;
+      const maximumFee = request.gas * (request.gasPrice ?? request.maxFeePerGas);
+      if (BigInt(balanceValue) < request.value + maximumFee) throw exampleError("INSUFFICIENT_PENDING_BALANCE", "Pending balance cannot fund the exact transaction value and maximum gas envelope");
+      await assertChain();
       const rawTransaction = await account.signTransaction(request);
       redactor.addSecret(rawTransaction);
       const wire = { ...envelope, chainId: toHex(id), nonce: toHex(request.nonce) };

package/examples/launch-example.ts

@@ -494,7 +494,7 @@ async function executePlan({ client, fixture, planned, sdk, artifacts, signal, l
     const next = await sdk.buildNextTransaction({ client, planned, receipts: references, limits, submissionClient: client, reviewedTransaction, signal });
     if (!next) return { references, activation };
     assert.ok(reviewedTransaction, "No transaction outside the saved review may be submitted");
-    for (const field of ["id", "kind", "chainId", "from", "to", "data", "value", "gas", "gasPrice"]) assert.equal(next[field], reviewedTransaction[field], `Fresh ${field} must match the saved review`);
+    for (const field of ["id", "kind", "chainId", "from", "to", "data", "value", "nonce", "gas", "gasPrice"]) assert.equal(next[field], reviewedTransaction[field], `Fresh ${field} must match the saved review`);
     if (retainedReferences.length) {
       const progress = await sdk.readLaunchProgress({ client, planned, receipts: references, confirmations: planned.confirmations, signal });
       assertRetainedExampleReceipts({ progress, references, artifacts });

package/examples/launch-lifecycle-smoke.ts

@@ -46,7 +46,7 @@ async function send(transaction) {
   const gasPrice = transaction.gasPrice ?? BigInt(await client.request({ method: "eth_gasPrice" }));
   const head = await client.request({ method: "eth_getBlockByNumber", params: ["latest", false] });
   const ceiling = [BigInt(head.gasLimit), BigInt(policy.chainTransactionGasLimit), BigInt(policy.rpcTransactionGasLimit), BigInt(policy.accountTransactionGasLimit)].reduce((a, b) => a < b ? a : b);
-  const wire = { from: transaction.from, to: transaction.to, data: transaction.data, value: toHex(transaction.value), gasPrice: toHex(gasPrice) };
+  const wire = { from: transaction.from, to: transaction.to, data: transaction.data, value: toHex(transaction.value), gasPrice: toHex(gasPrice), ...(transaction.nonce === undefined ? {} : { nonce: toHex(transaction.nonce) }) };
   const estimated = transaction.gas ?? ((BigInt(await client.request({ method: "eth_estimateGas", params: [{ ...wire, gas: toHex(ceiling) }] })) * BigInt(10000 + Number(policy.headroomBps)) + 9999n) / 10000n);
   assert.ok(estimated <= ceiling, "Unsigned helper must still fit explicit local execution admission");
   const transactionHash = await client.request({ method: "eth_sendTransaction", params: [{ ...wire, gas: toHex(estimated) }] });

package/examples/ufg-launch-config.ts

@@ -0,0 +1,31 @@
+// Pure configuration example; no RPC, wallet, key, signing or broadcast.
+// This is not a priced/admitted plan. Use core.predictToken(plan) for real fee policies,
+// derive funded one-sided positions, then prepareAndPlanLifecycleLaunch({ ..., ufg: { config } }).
+import { encodeAbiParameters, keccak256, zeroHash } from "viem";
+import {
+  getAddresses, KnownLifecycleProfile, getKnownLifecycleProfile,
+  UFG_ORCHESTRATOR_ADDRESS, UFG_LAUNCH_PROXY_ADDRESS, encodeUfgLaunchConfig,
+  hashUfgLaunchConfig, encodePoolBoundV4LifecycleMarketConfig,
+} from "@black-market/sdk";
+
+const identity = { chainId: 4663n, orchestrator: UFG_ORCHESTRATOR_ADDRESS };
+const config = { treasuryShareBps: 10000, exitFeeBps: 100, reserveAssets: [getAddresses(4663).weth] };
+for (const key of [KnownLifecycleProfile.V4UfgFixedPool, KnownLifecycleProfile.V4UfgDynamicPool]) {
+  const preset = getKnownLifecycleProfile({ ...identity, key })!;
+  const envelope = preset.profile.envelope!;
+  const encoded = encodePoolBoundV4LifecycleMarketConfig({
+    version: 6, lpFeePips: 0, tickSpacing: 60, sqrtPriceX96: 1n << 96n,
+    hookFeePips: 10000, minimumHookFeePips: 1000, feeSensitivityPipsSecondsPerTick: 7654321,
+    feeMode: 1, protocolFeeDenominator: envelope.protocolFeeDenominator,
+    treasury: envelope.protocolTreasury, externalLiquidityDisabled: false,
+    oracleConfigId: keccak256(encodeAbiParameters([{ type: "uint24" }, { type: "uint16" }], [1, 4096])),
+    hookSalt: zeroHash, profileId: preset.profile.id, termsDigest: envelope.termsDigest,
+    developerBeneficiary: envelope.beneficiary, developerFeeBps: 0,
+    // Geometry/price are illustrative. Real launch uses predicted token ordering and budget-funded ranges.
+    positions: [{ tickLower: 0, tickUpper: 887220, liquidity: 1000n, salt: zeroHash, maxTokenAmount: 1000000n }],
+    ufgLaunchConfig: config,
+  });
+  console.log(key, { proxy: UFG_LAUNCH_PROXY_ADDRESS, profileId: preset.profile.id,
+    configBytes: (encoded.length - 2) / 2, tailBytes: (encodeUfgLaunchConfig(config).length - 2) / 2,
+    launchConfigHash: hashUfgLaunchConfig(config) });
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@black-market/sdk",
-  "version": "0.11.0",
+  "version": "0.13.0",
   "description": "TypeScript SDK for Abyss token launches, swaps, and lending.",
   "license": "MIT",
   "repository": {

package/src/lifecycle/abi.ts

@@ -6,6 +6,7 @@ import {
 } from "./schema.js";
 import { poolBoundHookParametersV1Components, poolBoundHookParametersV2Components, v4LifecycleMarketComponents } from "./markets.js";
 export { hmmLiquidityManagerV2Abi, hmmFeeCollectorV2Abi, hmmFeeCollectorFactoryV2Abi, hmmFixedHookV2Abi, hmmDynamicHookV2Abi } from "./hmm-abi.js";
+export { ufgLaunchProxyV1Abi, ufgTreasuryFactoryV1Abi, ufgBlackMarketFactoryAbi, ufgBlackMarketTreasuryAbi } from "./ufg-abi.js";
 
 const planInput = { name: "plan", type: "tuple", components: launchPlanV1Components } as const;
 export const launchLifecycleAbi = [

package/src/lifecycle/deployments/ufg-dynamic-pool-20261021.ts

@@ -0,0 +1,74 @@
+import type { LaunchEnvelopeV2, AdapterRegistrationV1, ProfileRegistrationV1, ProfileTopologyV1 } from "../schema.js";
+
+// Generated by scripts/generate-ufg-presets.mjs from ufg-registry-readback.json.
+// Robinhood block 94551140, 0x0778956b5a7bad65f8182b969ac4efc6a7182a0a922fbcb94dc87bfea26e9cc4. Creation code is byte-identical to the existing dynamic zero-royalty hook.
+export const ufgDynamicEnvelope = Object.freeze({
+  artifactDigest: "0xd448a4117b78714cc4f96824356c6a90ec666449fde5c57e2b7bbe072f5e4a7a",
+  reviewManifestDigest: "0x0a3a0dfcae4fa51b2cccb2213e44800b7e3b74e681a66bc090f2e403a15b64b3",
+  configBoundsDigest: "0x72e0b2d542556d472a47f9c38b2c91079c72793af847dee77933f0eca203129d",
+  termsDigest: "0xbe3b09dc6d49fd548e76fed654b852039e8899e591ebacafc5e67f0692d0c699",
+  topology: 2,
+  configVersion: 6,
+  economicVersion: 3,
+  capabilities: 123n,
+  flags: 0n,
+  callbackFlags: 6908,
+  callbackMask: 16383,
+  protocolTreasury: "0x961981916AB6575C3af3eeCecbf6A3b7Fad7C9e1",
+  protocolFeeDenominator: 6,
+  beneficiary: "0x7cb44b8693b3C350A2BcD4b681aF85365aa27783",
+  maximumDeveloperFeeBps: 0,
+  bounds: Object.freeze({
+    minimumTickSpacing: 1,
+    maximumTickSpacing: 32767,
+    maximumPositions: 32,
+    maximumOracleCardinality: 4096,
+    feeModeFlags: 3,
+  }),
+  graph: Object.freeze({
+    manager: "0x8366a39CC670B4001A1121B8F6A443A643e40951",
+    hookRoot: "0x0000000000000000000000000000000000000000",
+    oracleFactory: "0xe7feF2BC860B25bbdEB6F6AB96d88bAAa77ddad7",
+    locker: "0xDa3bdeD722Bc45126752Ad6f28FAf27917D1a2fa",
+    collectorFactory: "0x46a8493b8f84E3Da412856Dd256263107e3873F2",
+    collectorDeployer: "0x50d6C10435dD928e426B8094FB944582c4FCa6f7",
+    hookDeployer: "0x435E0cb9b4C244edD5Bed40F9e39acdfcCd8d0f3",
+    coreCodeHash: "0x9fb8f46c3b980b9db25dfdb487a69a308a86be145860269b4036a4e74480787b",
+    managerCodeHash: "0xbd3881180b547f5fe817545743cfb4343e96b1bc6640dcd70c106b0066e95626",
+    hookRuntimeCodeHash: "0x0000000000000000000000000000000000000000000000000000000000000000",
+    oracleFactoryCodeHash: "0x974fb5c72d91ccb99f1eb4679a5d4432c82bbaa0906b1c2917ec4da3499b7b98",
+    lockerCodeHash: "0x686024936a31a60193d2c6ea15ddb97ee36fc59a805eb1856cde61116075b370",
+    collectorFactoryCodeHash: "0xb0bd33507bebe1bb969153961237ee9a5661dd9ed60b9384a8869fa03ec5ed51",
+    collectorDeployerCodeHash: "0x79118bf755c242e2a190f9602c021e59ccc49d51eeff3b0c1524b4a53c25618d",
+    hookDeployerCodeHash: "0xe2a9753e6a8858b32443cd32b89c0ac9de95673a85611383d2a7bebc3b9d1187",
+    hookCreationCodeHash: "0xd448a4117b78714cc4f96824356c6a90ec666449fde5c57e2b7bbe072f5e4a7a",
+    codeChunk0: "0x550187621373bcece198E44EA31bE6b3936c699b",
+    codeChunk0Hash: "0x818c56bf10ae21129fe54f1b8991d6f807ce4ccef35b34c56251c1fd2d7d623f",
+    codeChunk1: "0x6C6c05e1C61c69C85548887e5E06384934AE7d71",
+    codeChunk1Hash: "0xbc73944bfa7e74df5968907a05fe2579a17ab155d3a0db407588d1baff51b4de",
+    sharedHookSalt: "0x0000000000000000000000000000000000000000000000000000000000000000",
+  }),
+}) satisfies LaunchEnvelopeV2;
+export const ufgDynamicAdapter = Object.freeze({
+  implementation: "0x38FAA8061c91BA6B2D3ef735f110017d12705067",
+  codeHash: "0xa13c2d0e05e0cc6a366f85ecbfab37ef26136e0993999bed4dd46538eabce23c",
+  capabilities: 123n,
+  configVersion: 6,
+  enabled: true,
+}) satisfies AdapterRegistrationV1;
+export const ufgDynamicRegistration = Object.freeze({
+  adapterId: "0xc0906e17625b48240a87a3afc6ee921b653bdacd72906a16b359d0776d938518",
+  configSchema: "0x51c5ca14c40012f78425cd1afb1ea77980da3fed0490a00911a8a4ed34792045",
+  dependencyDigest: "0x43078cffe54d685efc2c8e05243c50956569c98fd608861b6ed81f6ab1ad49b3",
+  venue: "0x8366a39CC670B4001A1121B8F6A443A643e40951",
+  factory: "0x0000000000000000000000000000000000000000",
+  hook: "0x0000000000000000000000000000000000000000",
+  capabilities: 123n,
+  enabled: true,
+}) satisfies ProfileRegistrationV1;
+export const ufgDynamicTopology = Object.freeze({
+  hookTopology: 2,
+  configVersion: 6,
+  hookDeployer: "0x435E0cb9b4C244edD5Bed40F9e39acdfcCd8d0f3",
+  hookCreationCodeHash: "0xd448a4117b78714cc4f96824356c6a90ec666449fde5c57e2b7bbe072f5e4a7a",
+}) satisfies ProfileTopologyV1;

package/src/lifecycle/deployments/ufg-fixed-pool-20261021.ts

@@ -0,0 +1,74 @@
+import type { LaunchEnvelopeV2, AdapterRegistrationV1, ProfileRegistrationV1, ProfileTopologyV1 } from "../schema.js";
+
+// Generated by scripts/generate-ufg-presets.mjs from ufg-registry-readback.json.
+// Robinhood block 94551140, 0x0778956b5a7bad65f8182b969ac4efc6a7182a0a922fbcb94dc87bfea26e9cc4. Creation code is byte-identical to the existing fixed zero-royalty hook.
+export const ufgFixedEnvelope = Object.freeze({
+  artifactDigest: "0x11c4c7b1f265ed708b7d53ab828c89d237ca821333daa808f1913986c6f8f1ab",
+  reviewManifestDigest: "0x0a3a0dfcae4fa51b2cccb2213e44800b7e3b74e681a66bc090f2e403a15b64b3",
+  configBoundsDigest: "0x72e0b2d542556d472a47f9c38b2c91079c72793af847dee77933f0eca203129d",
+  termsDigest: "0xf2503b91eeec87f95c4f5e47df517a143422c766528c403ea44bdbd9b40df10e",
+  topology: 2,
+  configVersion: 6,
+  economicVersion: 3,
+  capabilities: 123n,
+  flags: 0n,
+  callbackFlags: 6908,
+  callbackMask: 16383,
+  protocolTreasury: "0x961981916AB6575C3af3eeCecbf6A3b7Fad7C9e1",
+  protocolFeeDenominator: 6,
+  beneficiary: "0x7cb44b8693b3C350A2BcD4b681aF85365aa27783",
+  maximumDeveloperFeeBps: 0,
+  bounds: Object.freeze({
+    minimumTickSpacing: 1,
+    maximumTickSpacing: 32767,
+    maximumPositions: 32,
+    maximumOracleCardinality: 4096,
+    feeModeFlags: 3,
+  }),
+  graph: Object.freeze({
+    manager: "0x8366a39CC670B4001A1121B8F6A443A643e40951",
+    hookRoot: "0x0000000000000000000000000000000000000000",
+    oracleFactory: "0xe7feF2BC860B25bbdEB6F6AB96d88bAAa77ddad7",
+    locker: "0xfbc0AbCD1A3EA65aF2196fa8Af1327a49B4C92FC",
+    collectorFactory: "0x46a8493b8f84E3Da412856Dd256263107e3873F2",
+    collectorDeployer: "0x50d6C10435dD928e426B8094FB944582c4FCa6f7",
+    hookDeployer: "0x4b04Ed1B02885DE905d8a14207EAC93F6AB231b2",
+    coreCodeHash: "0x9fb8f46c3b980b9db25dfdb487a69a308a86be145860269b4036a4e74480787b",
+    managerCodeHash: "0xbd3881180b547f5fe817545743cfb4343e96b1bc6640dcd70c106b0066e95626",
+    hookRuntimeCodeHash: "0x0000000000000000000000000000000000000000000000000000000000000000",
+    oracleFactoryCodeHash: "0x974fb5c72d91ccb99f1eb4679a5d4432c82bbaa0906b1c2917ec4da3499b7b98",
+    lockerCodeHash: "0xa6fd4decc88671feb632d1871688a96582b46fd500b53f587d0fe18dad23fc2d",
+    collectorFactoryCodeHash: "0xb0bd33507bebe1bb969153961237ee9a5661dd9ed60b9384a8869fa03ec5ed51",
+    collectorDeployerCodeHash: "0x79118bf755c242e2a190f9602c021e59ccc49d51eeff3b0c1524b4a53c25618d",
+    hookDeployerCodeHash: "0xc97b52314cfc0225fcc0a901382898870e57394b318124956367d8fd3818506c",
+    hookCreationCodeHash: "0x11c4c7b1f265ed708b7d53ab828c89d237ca821333daa808f1913986c6f8f1ab",
+    codeChunk0: "0x94Fd6fB6E3db16Ef97c9bEEA229617b2Ec00c196",
+    codeChunk0Hash: "0xe5f56287276954b21f4211cabf2d9c251aae68836c5fa86ce68091ffccdee26b",
+    codeChunk1: "0x191F43334Ed2D7d154BF635E961BCb0e9848CB7c",
+    codeChunk1Hash: "0x76efd61e1a109a85140ce3473c43694a83f490eaac54d18673c17872a5262a47",
+    sharedHookSalt: "0x0000000000000000000000000000000000000000000000000000000000000000",
+  }),
+}) satisfies LaunchEnvelopeV2;
+export const ufgFixedAdapter = Object.freeze({
+  implementation: "0x3c7bb8541DBe2C8576E1000C4B6B803fDD36CA5d",
+  codeHash: "0x27079feaeb1a0ce8034588c46d15fead2a6407451d6f9e37059cade7c2df7610",
+  capabilities: 123n,
+  configVersion: 6,
+  enabled: true,
+}) satisfies AdapterRegistrationV1;
+export const ufgFixedRegistration = Object.freeze({
+  adapterId: "0x073a4d46af70a3d4f69641e4f9dcdc9d8c279cd443daff960bbdf65a3b5fc758",
+  configSchema: "0x51c5ca14c40012f78425cd1afb1ea77980da3fed0490a00911a8a4ed34792045",
+  dependencyDigest: "0xead7c65bd240844e961647f7cd059948afd384dfea490807f576325cad78aee0",
+  venue: "0x8366a39CC670B4001A1121B8F6A443A643e40951",
+  factory: "0x0000000000000000000000000000000000000000",
+  hook: "0x0000000000000000000000000000000000000000",
+  capabilities: 123n,
+  enabled: true,
+}) satisfies ProfileRegistrationV1;
+export const ufgFixedTopology = Object.freeze({
+  hookTopology: 2,
+  configVersion: 6,
+  hookDeployer: "0x4b04Ed1B02885DE905d8a14207EAC93F6AB231b2",
+  hookCreationCodeHash: "0x11c4c7b1f265ed708b7d53ab828c89d237ca821333daa808f1913986c6f8f1ab",
+}) satisfies ProfileTopologyV1;

package/src/lifecycle/index.ts

@@ -4,6 +4,7 @@ export * from "./types.js";
 export * from "./abi.js";
 export * from "./markets.js";
 export * from "./hmm.js";
+export * from "./ufg.js";
 export * from "./progress.js";
 export * from "./fork.js";
 export * from "./authors.js";

package/src/lifecycle/markets.ts

@@ -2,6 +2,7 @@ import { concatHex, decodeAbiParameters, encodeAbiParameters, getAddress, hexToB
 import type { MarketConfigV1 } from "./schema.js";
 import { LifecyclePlanningError, type LifecycleProfile, type PoolBoundHookSaltProgress } from "./types.js";
 import { decodeHmmLaunchTail, encodeHmmLaunchTail, isHmmProfile, type HmmLaunchConfig } from "./hmm.js";
+import { decodeUfgLaunchConfig, encodeUfgLaunchConfig, isUfgProfile, type UfgLaunchConfig } from "./ufg-config.js";
 
 export type V4LifecyclePositionConfig = {
   tickLower: number; tickUpper: number; liquidity: bigint; salt: Hex; maxTokenAmount: bigint;
@@ -44,6 +45,7 @@ export type V4PoolBoundLifecycleMarketConfigV5 = Omit<V4LifecycleMarketConfig, "
 export type V4PoolBoundLifecycleMarketConfigV6 = Omit<V4LifecycleMarketConfig, "version"> & {
   version: 6; minimumHookFeePips: number; feeSensitivityPipsSecondsPerTick: number; hookSalt: Hex;
   hmmLaunchConfig?: HmmLaunchConfig;
+  ufgLaunchConfig?: UfgLaunchConfig;
 };
 export type V4PoolBoundLifecycleMarketConfig = V4PoolBoundLifecycleMarketConfigV5 | V4PoolBoundLifecycleMarketConfigV6;
 export const V4_LIFECYCLE_CONFIG_SCHEMA = keccak256(stringToHex("(uint16,uint24,int24,uint160,uint24,uint8,uint8,address,bool,bytes32,bytes32,bytes32,address,uint16,(int24,int24,uint128,bytes32,uint256)[])"));
@@ -90,9 +92,16 @@ function assertV1HookFeeShape(config: object): void {
   }
 }
 
-/** HMM profile selection requires a typed tail and appends it automatically. */
+/** Auxiliary launch profiles require their typed tail and append it automatically. */
 export function encodePoolBoundV4LifecycleMarketConfig(config: V4PoolBoundLifecycleMarketConfig): Hex {
   const prefix = encodePoolBoundV4Prefix(config);
+  if (isUfgProfile(config.profileId)) {
+    if (config.version !== 6 || config.ufgLaunchConfig === undefined) throw new LifecyclePlanningError("INVALID_UFG_CONFIG", "UFG profiles require config6 and an explicit ufgLaunchConfig");
+    if (config.hmmLaunchConfig !== undefined) throw new LifecyclePlanningError("INVALID_UFG_CONFIG", "UFG profiles cannot carry an HMM tail");
+    if (config.lpFeePips !== 0 || config.feeMode !== 1) throw new LifecyclePlanningError("INVALID_UFG_CONFIG", "UFG requires QuoteOnly feeMode 1 and zero LP fee");
+    return concatHex([prefix, encodeUfgLaunchConfig(config.ufgLaunchConfig)]);
+  }
+  if (config.version === 6 && config.ufgLaunchConfig !== undefined) throw new LifecyclePlanningError("INVALID_UFG_CONFIG", "A UFG launch tail requires a UFG profile");
   if (isHmmProfile(config.profileId)) {
     if (config.version !== 6 || config.hmmLaunchConfig === undefined) throw new LifecyclePlanningError("INVALID_HMM_CONFIG", "HMM profiles require config6 and an explicit hmmLaunchConfig");
     if (config.lpFeePips !== 0) throw new LifecyclePlanningError("INVALID_HOOK_FEES", "HMM profiles require zero LP fee");
@@ -126,6 +135,10 @@ export function decodePoolBoundV4LifecycleMarketConfig(encoded: Hex, expectedVer
     const prefixLength = encodePoolBoundV4Prefix(config).length;
     config.hmmLaunchConfig = decodeHmmLaunchTail(`0x${encoded.slice(prefixLength)}`);
   }
+  if (isUfgProfile(config.profileId)) {
+    if (config.version !== 6) throw new LifecyclePlanningError("INVALID_UFG_CONFIG", "UFG profiles require config6");
+    config.ufgLaunchConfig = decodeUfgLaunchConfig(`0x${encoded.slice(encodePoolBoundV4Prefix(config).length)}`);
+  }
   if (encodePoolBoundV4LifecycleMarketConfig(config).toLowerCase() !== encoded.toLowerCase()) throw new LifecyclePlanningError("INVALID_BOUND_MARKET", "Pool-bound config is not canonical for its explicit schema");
   return config;
 }
@@ -245,8 +258,8 @@ export function hashPoolBoundV4MarketCommitment(options: { chainId: bigint; core
   if (!isPoolBoundV4ConfigVersion(market.configVersion)) throw new LifecyclePlanningError("INVALID_BOUND_MARKET", "Pool-bound V4 market requires explicit config version 5 or 6");
   const config = decodePoolBoundV4LifecycleMarketConfig(market.config, market.configVersion);
   if (config.profileId.toLowerCase() !== market.profileId.toLowerCase()) throw new LifecyclePlanningError("INVALID_BOUND_MARKET", "Config profile differs from the committed market profile");
-  // The collector factory commits the V6 prefix, not the auxiliary HMM tail.
-  // The full plan commitment separately binds every byte of that tail.
+  // Collector factories commit only the V6 prefix, not auxiliary launch tails.
+  // The full plan commitment separately binds every byte of those tails.
   const configHash = keccak256(encodePoolBoundV4Prefix({ ...config, hookSalt: zeroHash }));
   return keccak256(encodeAbiParameters([
     { type: "bytes32" }, { type: "uint256" }, { type: "address" }, { type: "address" }, { type: "address" },