@black-market/sdk 0.1.0 → 0.3.1

package/dist/lifecycle/markets.d.ts

@@ -0,0 +1,349 @@
+import { type Address, type Hex } from "viem";
+import type { MarketConfigV1 } from "./schema.js";
+import { type LifecycleProfile, type PoolBoundHookSaltProgress } from "./types.js";
+export type V4LifecyclePositionConfig = {
+    tickLower: number;
+    tickUpper: number;
+    liquidity: bigint;
+    salt: Hex;
+    maxTokenAmount: bigint;
+};
+export type V4LifecycleMarketConfig = {
+    version: 4;
+    lpFeePips: number;
+    tickSpacing: number;
+    sqrtPriceX96: bigint;
+    hookFeePips: number;
+    feeMode: number;
+    protocolFeeDenominator: number;
+    treasury: Address;
+    externalLiquidityDisabled: boolean;
+    oracleConfigId: Hex;
+    profileId: Hex;
+    termsDigest: Hex;
+    developerBeneficiary: Address;
+    developerFeeBps: number;
+    positions: readonly V4LifecyclePositionConfig[];
+};
+export declare const v4LifecyclePositionComponents: readonly [{
+    readonly name: "tickLower";
+    readonly type: "int24";
+}, {
+    readonly name: "tickUpper";
+    readonly type: "int24";
+}, {
+    readonly name: "liquidity";
+    readonly type: "uint128";
+}, {
+    readonly name: "salt";
+    readonly type: "bytes32";
+}, {
+    readonly name: "maxTokenAmount";
+    readonly type: "uint256";
+}];
+export declare const v4LifecycleMarketComponents: readonly [{
+    readonly name: "version";
+    readonly type: "uint16";
+}, {
+    readonly name: "lpFeePips";
+    readonly type: "uint24";
+}, {
+    readonly name: "tickSpacing";
+    readonly type: "int24";
+}, {
+    readonly name: "sqrtPriceX96";
+    readonly type: "uint160";
+}, {
+    readonly name: "hookFeePips";
+    readonly type: "uint24";
+}, {
+    readonly name: "feeMode";
+    readonly type: "uint8";
+}, {
+    readonly name: "protocolFeeDenominator";
+    readonly type: "uint8";
+}, {
+    readonly name: "treasury";
+    readonly type: "address";
+}, {
+    readonly name: "externalLiquidityDisabled";
+    readonly type: "bool";
+}, {
+    readonly name: "oracleConfigId";
+    readonly type: "bytes32";
+}, {
+    readonly name: "profileId";
+    readonly type: "bytes32";
+}, {
+    readonly name: "termsDigest";
+    readonly type: "bytes32";
+}, {
+    readonly name: "developerBeneficiary";
+    readonly type: "address";
+}, {
+    readonly name: "developerFeeBps";
+    readonly type: "uint16";
+}, {
+    readonly name: "positions";
+    readonly type: "tuple[]";
+    readonly components: readonly [{
+        readonly name: "tickLower";
+        readonly type: "int24";
+    }, {
+        readonly name: "tickUpper";
+        readonly type: "int24";
+    }, {
+        readonly name: "liquidity";
+        readonly type: "uint128";
+    }, {
+        readonly name: "salt";
+        readonly type: "bytes32";
+    }, {
+        readonly name: "maxTokenAmount";
+        readonly type: "uint256";
+    }];
+}];
+export declare function encodeV4LifecycleMarketConfig(config: V4LifecycleMarketConfig): Hex;
+export declare function decodeV4LifecycleMarketConfig(encoded: Hex): V4LifecycleMarketConfig;
+export type V4PoolBoundLifecycleMarketConfig = Omit<V4LifecycleMarketConfig, "version"> & {
+    version: 5;
+    hookSalt: Hex;
+};
+export declare const V4_LIFECYCLE_CONFIG_SCHEMA: `0x${string}`;
+export declare const V4_POOL_BOUND_LIFECYCLE_CONFIG_SCHEMA: `0x${string}`;
+export declare const V4_POOL_BOUND_MARKET_ECONOMICS_DOMAIN: `0x${string}`;
+export declare const V4_LIFECYCLE_HOOK_PERMISSION_MASK = 16383n;
+export declare const V4_LIFECYCLE_HOOK_PERMISSIONS = 6908n;
+export declare const poolBoundV4LifecycleMarketComponents: readonly [{
+    readonly name: "version";
+    readonly type: "uint16";
+}, {
+    readonly name: "lpFeePips";
+    readonly type: "uint24";
+}, {
+    readonly name: "tickSpacing";
+    readonly type: "int24";
+}, {
+    readonly name: "sqrtPriceX96";
+    readonly type: "uint160";
+}, {
+    readonly name: "hookFeePips";
+    readonly type: "uint24";
+}, {
+    readonly name: "feeMode";
+    readonly type: "uint8";
+}, {
+    readonly name: "protocolFeeDenominator";
+    readonly type: "uint8";
+}, {
+    readonly name: "treasury";
+    readonly type: "address";
+}, {
+    readonly name: "externalLiquidityDisabled";
+    readonly type: "bool";
+}, {
+    readonly name: "oracleConfigId";
+    readonly type: "bytes32";
+}, {
+    readonly name: "hookSalt";
+    readonly type: "bytes32";
+}, {
+    readonly name: "profileId";
+    readonly type: "bytes32";
+}, {
+    readonly name: "termsDigest";
+    readonly type: "bytes32";
+}, {
+    readonly name: "developerBeneficiary";
+    readonly type: "address";
+}, {
+    readonly name: "developerFeeBps";
+    readonly type: "uint16";
+}, {
+    readonly name: "positions";
+    readonly type: "tuple[]";
+    readonly components: readonly [{
+        readonly name: "tickLower";
+        readonly type: "int24";
+    }, {
+        readonly name: "tickUpper";
+        readonly type: "int24";
+    }, {
+        readonly name: "liquidity";
+        readonly type: "uint128";
+    }, {
+        readonly name: "salt";
+        readonly type: "bytes32";
+    }, {
+        readonly name: "maxTokenAmount";
+        readonly type: "uint256";
+    }];
+}];
+export declare function encodePoolBoundV4LifecycleMarketConfig(config: V4PoolBoundLifecycleMarketConfig): Hex;
+export declare function decodePoolBoundV4LifecycleMarketConfig(encoded: Hex): V4PoolBoundLifecycleMarketConfig;
+/** Exact pending-source admission terms; author identity is never the live payout address. */
+export declare function validateReviewedV4LifecycleMarket(options: {
+    market: MarketConfigV1;
+    config: V4LifecycleMarketConfig | V4PoolBoundLifecycleMarketConfig;
+    profile: LifecycleProfile;
+    token: Address;
+}): void;
+export type PoolBoundHookParametersV1 = {
+    poolManager: Address;
+    registrar: Address;
+    oracleFactory: Address;
+    core: Address;
+    liquidityLocker: Address;
+    token: Address;
+    quoteCurrency: Address;
+    lpFeePips: number;
+    tickSpacing: number;
+    sqrtPriceX96: bigint;
+    hookFeePips: number;
+    feeMode: number;
+    protocolFeeDenominator: number;
+    treasury: Address;
+    externalLiquidityDisabled: boolean;
+    oracleConfigId: Hex;
+    marketCommitment: Hex;
+    expectedPositionCount: number;
+};
+export declare const poolBoundHookParametersV1Components: readonly [{
+    readonly name: "poolManager";
+    readonly type: "address";
+}, {
+    readonly name: "registrar";
+    readonly type: "address";
+}, {
+    readonly name: "oracleFactory";
+    readonly type: "address";
+}, {
+    readonly name: "core";
+    readonly type: "address";
+}, {
+    readonly name: "liquidityLocker";
+    readonly type: "address";
+}, {
+    readonly name: "token";
+    readonly type: "address";
+}, {
+    readonly name: "quoteCurrency";
+    readonly type: "address";
+}, {
+    readonly name: "lpFeePips";
+    readonly type: "uint24";
+}, {
+    readonly name: "tickSpacing";
+    readonly type: "int24";
+}, {
+    readonly name: "sqrtPriceX96";
+    readonly type: "uint160";
+}, {
+    readonly name: "hookFeePips";
+    readonly type: "uint24";
+}, {
+    readonly name: "feeMode";
+    readonly type: "uint8";
+}, {
+    readonly name: "protocolFeeDenominator";
+    readonly type: "uint8";
+}, {
+    readonly name: "treasury";
+    readonly type: "address";
+}, {
+    readonly name: "externalLiquidityDisabled";
+    readonly type: "bool";
+}, {
+    readonly name: "oracleConfigId";
+    readonly type: "bytes32";
+}, {
+    readonly name: "marketCommitment";
+    readonly type: "bytes32";
+}, {
+    readonly name: "expectedPositionCount";
+    readonly type: "uint32";
+}];
+export declare function encodePoolBoundHookParameters(parameters: PoolBoundHookParametersV1): Hex;
+export declare function hashPoolBoundV4MarketCommitment(options: {
+    chainId: bigint;
+    core: Address;
+    registrar: Address;
+    token: Address;
+    market: MarketConfigV1;
+}): Hex;
+export declare function hasLifecycleV4HookPermissions(hook: Address): boolean;
+export declare function predictPoolBoundHookAddress(options: {
+    deployer: Address;
+    initCodeHash: Hex;
+    salt: Hex;
+}): Address;
+export declare function poolBoundHookInitCodeHash(creationCode: Hex, parameters: PoolBoundHookParametersV1): Hex;
+/** Deterministic CREATE2 search with a macrotask boundary before work and between bounded batches. */
+export declare function minePoolBoundHookSalt(options: {
+    deployer: Address;
+    initCodeHash: Hex;
+    startSalt?: bigint;
+    signal?: AbortSignal;
+    onProgress?: (progress: PoolBoundHookSaltProgress) => void;
+}): Promise<{
+    salt: Hex;
+    predictedHook: Address;
+}>;
+export type AbyssLifecyclePositionConfig = {
+    tickLower: number;
+    tickUpper: number;
+    liquidity: bigint;
+    tokenAmountMaximum: bigint;
+};
+export type AbyssLifecycleMarketConfig = {
+    profile: number;
+    fee: number;
+    oracleConfigId: Hex;
+    openingSqrtPriceX96: bigint;
+    positions: readonly AbyssLifecyclePositionConfig[];
+};
+export declare const abyssLifecyclePositionComponents: readonly [{
+    readonly name: "tickLower";
+    readonly type: "int24";
+}, {
+    readonly name: "tickUpper";
+    readonly type: "int24";
+}, {
+    readonly name: "liquidity";
+    readonly type: "uint128";
+}, {
+    readonly name: "tokenAmountMaximum";
+    readonly type: "uint256";
+}];
+export declare const abyssLifecycleMarketComponents: readonly [{
+    readonly name: "profile";
+    readonly type: "uint8";
+}, {
+    readonly name: "fee";
+    readonly type: "uint24";
+}, {
+    readonly name: "oracleConfigId";
+    readonly type: "bytes32";
+}, {
+    readonly name: "openingSqrtPriceX96";
+    readonly type: "uint160";
+}, {
+    readonly name: "positions";
+    readonly type: "tuple[]";
+    readonly components: readonly [{
+        readonly name: "tickLower";
+        readonly type: "int24";
+    }, {
+        readonly name: "tickUpper";
+        readonly type: "int24";
+    }, {
+        readonly name: "liquidity";
+        readonly type: "uint128";
+    }, {
+        readonly name: "tokenAmountMaximum";
+        readonly type: "uint256";
+    }];
+}];
+export declare function encodeAbyssLifecycleMarketConfig(config: AbyssLifecycleMarketConfig): Hex;
+export declare function decodeAbyssLifecycleMarketConfig(encoded: Hex): AbyssLifecycleMarketConfig;
+//# sourceMappingURL=markets.d.ts.map

package/dist/lifecycle/markets.d.ts.map

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

package/dist/lifecycle/markets.js

@@ -0,0 +1,184 @@
+import { concatHex, decodeAbiParameters, encodeAbiParameters, getCreate2Address, keccak256, stringToHex, toHex, zeroHash } from "viem";
+import { LifecyclePlanningError } from "./types.js";
+export const v4LifecyclePositionComponents = [
+    { name: "tickLower", type: "int24" }, { name: "tickUpper", type: "int24" },
+    { name: "liquidity", type: "uint128" }, { name: "salt", type: "bytes32" }, { name: "maxTokenAmount", type: "uint256" },
+];
+export const v4LifecycleMarketComponents = [
+    { name: "version", type: "uint16" }, { name: "lpFeePips", type: "uint24" }, { name: "tickSpacing", type: "int24" },
+    { name: "sqrtPriceX96", type: "uint160" }, { name: "hookFeePips", type: "uint24" }, { name: "feeMode", type: "uint8" },
+    { name: "protocolFeeDenominator", type: "uint8" }, { name: "treasury", type: "address" },
+    { name: "externalLiquidityDisabled", type: "bool" },
+    { name: "oracleConfigId", type: "bytes32" },
+    { name: "profileId", type: "bytes32" }, { name: "termsDigest", type: "bytes32" },
+    { name: "developerBeneficiary", type: "address" }, { name: "developerFeeBps", type: "uint16" },
+    { name: "positions", type: "tuple[]", components: v4LifecyclePositionComponents },
+];
+export function encodeV4LifecycleMarketConfig(config) {
+    if (config.version !== 4)
+        throw new Error("Shared V4 lifecycle market config version must be 4");
+    if (!Number.isInteger(config.developerFeeBps) || config.developerFeeBps < 0 || config.developerFeeBps > 65535)
+        throw new Error("developerFeeBps must be an explicit uint16");
+    return encodeAbiParameters([{ type: "tuple", components: v4LifecycleMarketComponents }], [config]);
+}
+export function decodeV4LifecycleMarketConfig(encoded) {
+    const config = decodeAbiParameters([{ type: "tuple", components: v4LifecycleMarketComponents }], encoded)[0];
+    if (config.version !== 4)
+        throw new Error("Shared V4 lifecycle market config version must be 4");
+    return config;
+}
+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)[])"));
+export const V4_POOL_BOUND_LIFECYCLE_CONFIG_SCHEMA = keccak256(stringToHex("(uint16,uint24,int24,uint160,uint24,uint8,uint8,address,bool,bytes32,bytes32,bytes32,bytes32,address,uint16,(int24,int24,uint128,bytes32,uint256)[])"));
+export const V4_POOL_BOUND_MARKET_ECONOMICS_DOMAIN = keccak256(stringToHex("black-market.reviewed-pool-bound-market-economics.v1"));
+export const V4_LIFECYCLE_HOOK_PERMISSION_MASK = 0x3fffn;
+export const V4_LIFECYCLE_HOOK_PERMISSIONS = 0x1afcn;
+export const poolBoundV4LifecycleMarketComponents = [
+    { name: "version", type: "uint16" }, { name: "lpFeePips", type: "uint24" }, { name: "tickSpacing", type: "int24" },
+    { name: "sqrtPriceX96", type: "uint160" }, { name: "hookFeePips", type: "uint24" }, { name: "feeMode", type: "uint8" },
+    { name: "protocolFeeDenominator", type: "uint8" }, { name: "treasury", type: "address" },
+    { name: "externalLiquidityDisabled", type: "bool" }, { name: "oracleConfigId", type: "bytes32" },
+    { name: "hookSalt", type: "bytes32" },
+    { name: "profileId", type: "bytes32" }, { name: "termsDigest", type: "bytes32" },
+    { name: "developerBeneficiary", type: "address" }, { name: "developerFeeBps", type: "uint16" },
+    { name: "positions", type: "tuple[]", components: v4LifecyclePositionComponents },
+];
+export function encodePoolBoundV4LifecycleMarketConfig(config) {
+    if (config.version !== 5)
+        throw new Error("Pool-bound V4 lifecycle market config version must be 5");
+    if (!Number.isInteger(config.developerFeeBps) || config.developerFeeBps < 0 || config.developerFeeBps > 65535)
+        throw new Error("developerFeeBps must be an explicit uint16");
+    return encodeAbiParameters([{ type: "tuple", components: poolBoundV4LifecycleMarketComponents }], [config]);
+}
+export function decodePoolBoundV4LifecycleMarketConfig(encoded) {
+    const config = decodeAbiParameters([{ type: "tuple", components: poolBoundV4LifecycleMarketComponents }], encoded)[0];
+    if (config.version !== 5)
+        throw new Error("Pool-bound V4 lifecycle market config version must be 5");
+    return config;
+}
+/** Exact pending-source admission terms; author identity is never the live payout address. */
+export function validateReviewedV4LifecycleMarket(options) {
+    const { market, config, profile, token } = options;
+    if (config.version !== 4 && config.version !== 5)
+        throw new LifecyclePlanningError("UNSUPPORTED_CONFIG_VERSION", "Reviewed V4 config version must be 4 or 5");
+    const { envelope, developerTerms: terms, protocolMaximumDeveloperFeeBps: protocolCeiling } = profile;
+    if (envelope === undefined || terms === undefined || protocolCeiling === undefined || !terms.enabled ||
+        profile.topology.hookTopology !== (config.version === 4 ? 1 : 2) || market.configVersion !== config.version ||
+        profile.topology.configVersion !== config.version || profile.adapter.configVersion !== config.version ||
+        envelope.topology !== profile.topology.hookTopology || envelope.configVersion !== config.version || envelope.economicVersion !== 3 ||
+        market.adapterId.toLowerCase() !== profile.registration.adapterId.toLowerCase() ||
+        market.profileId.toLowerCase() !== profile.id.toLowerCase() || config.profileId.toLowerCase() !== profile.id.toLowerCase() ||
+        terms.adapter.toLowerCase() !== profile.adapter.implementation.toLowerCase() ||
+        config.termsDigest.toLowerCase() !== envelope.termsDigest.toLowerCase() || config.termsDigest.toLowerCase() !== terms.termsDigest.toLowerCase() ||
+        config.developerBeneficiary.toLowerCase() !== envelope.beneficiary.toLowerCase() ||
+        config.developerBeneficiary.toLowerCase() !== terms.beneficiary.toLowerCase() ||
+        BigInt(config.developerBeneficiary) === 0n || config.developerBeneficiary.toLowerCase() === token.toLowerCase() ||
+        config.developerBeneficiary.toLowerCase() === market.quoteAsset.toLowerCase()) {
+        throw new LifecyclePlanningError("REVIEWED_TERMS_MISMATCH", "Market must explicitly bind the admitted profile, frozen terms and stable author identity");
+    }
+    if (!Number.isInteger(config.developerFeeBps) || config.developerFeeBps < 0 ||
+        config.developerFeeBps > envelope.maximumDeveloperFeeBps || config.developerFeeBps > terms.maximumDeveloperFeeBps ||
+        config.developerFeeBps > protocolCeiling)
+        throw new LifecyclePlanningError("DEVELOPER_FEE_CEILING", "Explicit developer fee exceeds the reviewed or protocol ceiling");
+    const b = envelope.bounds;
+    if (config.treasury.toLowerCase() !== envelope.protocolTreasury.toLowerCase() ||
+        config.protocolFeeDenominator !== envelope.protocolFeeDenominator || config.hookFeePips > b.maximumHookFeePips ||
+        config.lpFeePips > b.maximumLpFeePips || !Number.isInteger(config.feeMode) || config.feeMode < 0 || config.feeMode > 1 || (b.feeModeFlags & (1 << config.feeMode)) === 0 ||
+        config.tickSpacing < b.minimumTickSpacing || config.tickSpacing > b.maximumTickSpacing ||
+        config.positions.length === 0 || config.positions.length > b.maximumPositions || config.externalLiquidityDisabled !== b.externalLiquidityDisabled ||
+        config.oracleConfigId.toLowerCase() !== b.oracleConfigId.toLowerCase()) {
+        throw new LifecyclePlanningError("REVIEWED_BOUNDS_MISMATCH", "Market economics exceed or differ from the exact admitted envelope bounds");
+    }
+}
+export const poolBoundHookParametersV1Components = [
+    { name: "poolManager", type: "address" }, { name: "registrar", type: "address" },
+    { name: "oracleFactory", type: "address" }, { name: "core", type: "address" },
+    { name: "liquidityLocker", type: "address" }, { name: "token", type: "address" },
+    { name: "quoteCurrency", type: "address" }, { name: "lpFeePips", type: "uint24" },
+    { name: "tickSpacing", type: "int24" }, { name: "sqrtPriceX96", type: "uint160" },
+    { name: "hookFeePips", type: "uint24" }, { name: "feeMode", type: "uint8" },
+    { name: "protocolFeeDenominator", type: "uint8" }, { name: "treasury", type: "address" },
+    { name: "externalLiquidityDisabled", type: "bool" }, { name: "oracleConfigId", type: "bytes32" },
+    { name: "marketCommitment", type: "bytes32" }, { name: "expectedPositionCount", type: "uint32" },
+];
+export function encodePoolBoundHookParameters(parameters) {
+    return encodeAbiParameters([{ type: "tuple", components: poolBoundHookParametersV1Components }], [parameters]);
+}
+export function hashPoolBoundV4MarketCommitment(options) {
+    const { chainId, core, registrar, token, market } = options;
+    if (market.configVersion !== 5)
+        throw new LifecyclePlanningError("INVALID_BOUND_MARKET", "Pool-bound V4 market requires reviewed config version 5");
+    const config = decodePoolBoundV4LifecycleMarketConfig(market.config);
+    if (config.profileId.toLowerCase() !== market.profileId.toLowerCase())
+        throw new LifecyclePlanningError("INVALID_BOUND_MARKET", "Config profile differs from the committed market profile");
+    const configHash = keccak256(encodePoolBoundV4LifecycleMarketConfig({ ...config, hookSalt: zeroHash }));
+    return keccak256(encodeAbiParameters([
+        { type: "bytes32" }, { type: "uint256" }, { type: "address" }, { type: "address" }, { type: "address" },
+        { type: "bytes32" }, { type: "bytes32" }, { type: "address" }, { type: "uint256" }, { type: "uint32" }, { type: "bytes32" },
+    ], [V4_POOL_BOUND_MARKET_ECONOMICS_DOMAIN, chainId, core, registrar, token, market.adapterId, market.profileId, market.quoteAsset, market.tokenBudget, market.configVersion, configHash]));
+}
+export function hasLifecycleV4HookPermissions(hook) {
+    return (BigInt(hook) & V4_LIFECYCLE_HOOK_PERMISSION_MASK) === V4_LIFECYCLE_HOOK_PERMISSIONS;
+}
+export function predictPoolBoundHookAddress(options) {
+    return getCreate2Address({ from: options.deployer, bytecodeHash: options.initCodeHash, salt: options.salt });
+}
+export function poolBoundHookInitCodeHash(creationCode, parameters) {
+    return keccak256(concatHex([creationCode, encodePoolBoundHookParameters(parameters)]));
+}
+/** Deterministic CREATE2 search with a macrotask boundary before work and between bounded batches. */
+export async function minePoolBoundHookSalt(options) {
+    const { signal, onProgress } = options;
+    let candidate = options.startSalt ?? 0n;
+    if (candidate < 0n || candidate >= 1n << 256n)
+        throw new LifecyclePlanningError("INVALID_HOOK_SALT", "Starting hook salt must fit uint256");
+    const checkCancelled = () => {
+        if (signal?.aborted)
+            throw Object.assign(new Error("Pool-bound hook salt mining cancelled"), { name: "AbortError" });
+    };
+    let attempts = 0n;
+    checkCancelled();
+    const initialSalt = toHex(candidate, { size: 32 });
+    onProgress?.({ attempts, salt: initialSalt, predictedHook: predictPoolBoundHookAddress({ deployer: options.deployer, initCodeHash: options.initCodeHash, salt: initialSalt }) });
+    for (;;) {
+        checkCancelled();
+        await new Promise((resolve) => globalThis.setTimeout(resolve, 0));
+        checkCancelled();
+        const deadline = Date.now() + 8;
+        let last;
+        for (let batch = 0; batch < 256 && (batch === 0 || Date.now() < deadline); batch += 1) {
+            checkCancelled();
+            if (candidate >= 1n << 256n)
+                throw new LifecyclePlanningError("HOOK_SALT_EXHAUSTED", "No valid hook address remains in the uint256 salt range");
+            const salt = toHex(candidate, { size: 32 });
+            const predictedHook = predictPoolBoundHookAddress({ deployer: options.deployer, initCodeHash: options.initCodeHash, salt });
+            attempts += 1n;
+            last = { attempts, salt, predictedHook };
+            if (hasLifecycleV4HookPermissions(predictedHook)) {
+                onProgress?.(last);
+                checkCancelled();
+                return { salt, predictedHook };
+            }
+            candidate += 1n;
+        }
+        if (last !== undefined)
+            onProgress?.(last);
+    }
+}
+export const abyssLifecyclePositionComponents = [
+    { name: "tickLower", type: "int24" }, { name: "tickUpper", type: "int24" },
+    { name: "liquidity", type: "uint128" }, { name: "tokenAmountMaximum", type: "uint256" },
+];
+export const abyssLifecycleMarketComponents = [
+    { name: "profile", type: "uint8" }, { name: "fee", type: "uint24" }, { name: "oracleConfigId", type: "bytes32" },
+    { name: "openingSqrtPriceX96", type: "uint160" },
+    { name: "positions", type: "tuple[]", components: abyssLifecyclePositionComponents },
+];
+export function encodeAbyssLifecycleMarketConfig(config) {
+    if (!Number.isInteger(config.profile) || config.profile < 0 || config.profile > 3)
+        throw new Error("Unsupported Abyss lifecycle pool profile");
+    return encodeAbiParameters([{ type: "tuple", components: abyssLifecycleMarketComponents }], [config]);
+}
+export function decodeAbyssLifecycleMarketConfig(encoded) {
+    return decodeAbiParameters([{ type: "tuple", components: abyssLifecycleMarketComponents }], encoded)[0];
+}
+//# sourceMappingURL=markets.js.map

package/dist/lifecycle/markets.js.map

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

package/dist/lifecycle/planner.d.ts

@@ -0,0 +1,20 @@
+import { type LaunchPlanV1 } from "./schema.js";
+import { type BuildNextTransactionOptions, type LifecyclePoolBoundHookDeployment, type LifecycleRpcClient, type LifecycleSimulation, type LifecycleTransaction, type PlannedLaunch, type PlanLaunchOptions, type PoolBoundLifecyclePreparationProgress, type SimulateLaunchPlanOptions } from "./types.js";
+/** Mines only certified bound markets, then re-reads the exact final economics and derived identities. */
+export declare function preparePoolBoundLifecyclePlan(options: {
+    client: LifecycleRpcClient;
+    plan: LaunchPlanV1;
+    signal?: AbortSignal;
+    onProgress?: (progress: PoolBoundLifecyclePreparationProgress) => void;
+}): Promise<{
+    plan: LaunchPlanV1;
+    deployments: readonly LifecyclePoolBoundHookDeployment[];
+}>;
+/** Exact economic commitment with explicit execution mode and current-state admission. No broadcasts. */
+export declare function planLaunch(options: PlanLaunchOptions): Promise<PlannedLaunch>;
+/** Re-reads canonical state, revalidates all prerequisites, and proves the remaining sequence afresh. */
+export declare function buildNextTransaction(options: BuildNextTransactionOptions): Promise<LifecycleTransaction | undefined>;
+/** Re-simulates only canonical unfinished work with the same submitted receipt
+ * evidence and confirmation depth as build-next, never silently dropping context. */
+export declare function simulateLaunchPlan(options: SimulateLaunchPlanOptions): Promise<LifecycleSimulation>;
+//# sourceMappingURL=planner.d.ts.map

package/dist/lifecycle/planner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"planner.d.ts","sourceRoot":"","sources":["../../src/lifecycle/planner.ts"],"names":[],"mappings":"AAEA,OAAO,EAAyX,KAAK,YAAY,EAAyB,MAAM,aAAa,CAAC;AAK9b,OAAO,EAA0B,KAAK,2BAA2B,EAAwF,KAAK,gCAAgC,EAAyB,KAAK,kBAAkB,EAAE,KAAK,mBAAmB,EAAE,KAAK,oBAAoB,EAAE,KAAK,aAAa,EAAE,KAAK,iBAAiB,EAAE,KAAK,qCAAqC,EAAE,KAAK,yBAAyB,EAAE,MAAM,YAAY,CAAC;AA8Nhb,0GAA0G;AAC1G,wBAAsB,6BAA6B,CAAC,OAAO,EAAE;IAC3D,MAAM,EAAE,kBAAkB,CAAC;IAAC,IAAI,EAAE,YAAY,CAAC;IAAC,MAAM,CAAC,EAAE,WAAW,CAAC;IACrE,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,qCAAqC,KAAK,IAAI,CAAC;CACxE,GAAG,OAAO,CAAC;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,WAAW,EAAE,SAAS,gCAAgC,EAAE,CAAA;CAAE,CAAC,CAiD5F;AAED,yGAAyG;AACzG,wBAAsB,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,aAAa,CAAC,CA+DnF;AAED,yGAAyG;AACzG,wBAAsB,oBAAoB,CAAC,OAAO,EAAE,2BAA2B,GAAG,OAAO,CAAC,oBAAoB,GAAG,SAAS,CAAC,CA2B1H;AAED;qFACqF;AACrF,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,yBAAyB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAUzG"}