@black-market/sdk 0.16.1 → 0.17.0

package/src/lifecycle/deployments/rwa-dynamic-pool-v1-20261113.ts

@@ -0,0 +1,74 @@
+import type { LaunchEnvelopeV2, AdapterRegistrationV1, ProfileRegistrationV1, ProfileTopologyV1 } from "../schema.js";
+
+// Generated by scripts/generate-rwa-presets.mjs from admission and registry readback.
+// Robinhood block 113693643, 0xea409fea2955aa229e8b1bff0e63d4ffb88c8eba0f85bd8553d9e6479e545461; admission 0xce4c0d0ad3e25f2f82abfc3e28bf6aedbe7da8282360d07beb131d62b641a592.
+export const rwaDynamicEnvelope = Object.freeze({
+  artifactDigest: "0xd448a4117b78714cc4f96824356c6a90ec666449fde5c57e2b7bbe072f5e4a7a",
+  reviewManifestDigest: "0x03eacc82d31be9528ea12eee454bfa995a021bbfaa67612fc78a5a49dc98ce58",
+  configBoundsDigest: "0x11ec57e16f972e0ac5f687d4078d785a51de11d421bcf97e2ba129dfd83fe7b4",
+  termsDigest: "0xa8646837c15c4f01f34543b3783685fcc2a844bd738dd667161ea25149168dee",
+  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: 2,
+  }),
+  graph: Object.freeze({
+    manager: "0x8366a39CC670B4001A1121B8F6A443A643e40951",
+    hookRoot: "0x0000000000000000000000000000000000000000",
+    oracleFactory: "0xe7feF2BC860B25bbdEB6F6AB96d88bAAa77ddad7",
+    locker: "0xFFF8409ce0D9030ea30aB9B0C027B5fA0114a949",
+    collectorFactory: "0x7F999EB2127dD6C4702cBb716518EFFFb318d7d0",
+    collectorDeployer: "0x4B60a9D76c9184CC519CA3C5e3A371705b93a329",
+    hookDeployer: "0xCb4bCaEF4816F75EFa547a9F0F94d6116819848B",
+    coreCodeHash: "0x9fb8f46c3b980b9db25dfdb487a69a308a86be145860269b4036a4e74480787b",
+    managerCodeHash: "0xbd3881180b547f5fe817545743cfb4343e96b1bc6640dcd70c106b0066e95626",
+    hookRuntimeCodeHash: "0x0000000000000000000000000000000000000000000000000000000000000000",
+    oracleFactoryCodeHash: "0x974fb5c72d91ccb99f1eb4679a5d4432c82bbaa0906b1c2917ec4da3499b7b98",
+    lockerCodeHash: "0xe28dd3f6a99881b729ca294651a0c4c3dce1be485cec91add74ee4210fc7c7df",
+    collectorFactoryCodeHash: "0x73528940f83090464994ad6eb64f656c9b324204674b3408410d644b327299a2",
+    collectorDeployerCodeHash: "0x8a8a564ddea793e4be2fa135d85876dbe2461ca574841f3008e73de3c6ea9c97",
+    hookDeployerCodeHash: "0x1a4beb855873bf7d1da0d403741e1bf2fc6dfc7f26dd9893b58875c2a1dcba35",
+    hookCreationCodeHash: "0xd448a4117b78714cc4f96824356c6a90ec666449fde5c57e2b7bbe072f5e4a7a",
+    codeChunk0: "0x27BB9608aE394623bD23490367CaC137443c890c",
+    codeChunk0Hash: "0x818c56bf10ae21129fe54f1b8991d6f807ce4ccef35b34c56251c1fd2d7d623f",
+    codeChunk1: "0xD99b86Ab8CB65D49A6cE93ab8b1ebedeF513634E",
+    codeChunk1Hash: "0xbc73944bfa7e74df5968907a05fe2579a17ab155d3a0db407588d1baff51b4de",
+    sharedHookSalt: "0x0000000000000000000000000000000000000000000000000000000000000000",
+  }),
+}) satisfies LaunchEnvelopeV2;
+export const rwaDynamicAdapter = Object.freeze({
+  implementation: "0xF06a5EC32F0Bba89e4cA16E8AeCd56c9f125A157",
+  codeHash: "0xae6db24fa7ca9ed3bf65a2eb99e4c3c10f0564d801b73d9591bc5859752a3be1",
+  capabilities: 123n,
+  configVersion: 6,
+  enabled: true,
+}) satisfies AdapterRegistrationV1;
+export const rwaDynamicRegistration = Object.freeze({
+  adapterId: "0x46a5f7c611f6584cc99cffcdeb55183d6c3dcafe5fc6fcce85995be82639bbe1",
+  configSchema: "0x51c5ca14c40012f78425cd1afb1ea77980da3fed0490a00911a8a4ed34792045",
+  dependencyDigest: "0x6b0ef655a4eb9f8b81920ae63cd71bc26f320c5f819a4385534a3264ea152d2e",
+  venue: "0x8366a39CC670B4001A1121B8F6A443A643e40951",
+  factory: "0x0000000000000000000000000000000000000000",
+  hook: "0x0000000000000000000000000000000000000000",
+  capabilities: 123n,
+  enabled: true,
+}) satisfies ProfileRegistrationV1;
+export const rwaDynamicTopology = Object.freeze({
+  hookTopology: 2,
+  configVersion: 6,
+  hookDeployer: "0xCb4bCaEF4816F75EFa547a9F0F94d6116819848B",
+  hookCreationCodeHash: "0xd448a4117b78714cc4f96824356c6a90ec666449fde5c57e2b7bbe072f5e4a7a",
+}) satisfies ProfileTopologyV1;

package/src/lifecycle/deployments/rwa-fixed-pool-v1-20261113.ts

@@ -0,0 +1,74 @@
+import type { LaunchEnvelopeV2, AdapterRegistrationV1, ProfileRegistrationV1, ProfileTopologyV1 } from "../schema.js";
+
+// Generated by scripts/generate-rwa-presets.mjs from admission and registry readback.
+// Robinhood block 113693643, 0xea409fea2955aa229e8b1bff0e63d4ffb88c8eba0f85bd8553d9e6479e545461; admission 0xeea3456cd41b8b86dd17bbace3dfd9d96c04212beb5e1c7f421602176930cb17.
+export const rwaFixedEnvelope = Object.freeze({
+  artifactDigest: "0x11c4c7b1f265ed708b7d53ab828c89d237ca821333daa808f1913986c6f8f1ab",
+  reviewManifestDigest: "0x42e315ab29ad2507b1decb69246efa24a63c29c7afb900283037b78b4c5d28f5",
+  configBoundsDigest: "0x11ec57e16f972e0ac5f687d4078d785a51de11d421bcf97e2ba129dfd83fe7b4",
+  termsDigest: "0x8523375098878c66e6289b908069c0d0152897876a73a80a7c7696679341be64",
+  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: 2,
+  }),
+  graph: Object.freeze({
+    manager: "0x8366a39CC670B4001A1121B8F6A443A643e40951",
+    hookRoot: "0x0000000000000000000000000000000000000000",
+    oracleFactory: "0xe7feF2BC860B25bbdEB6F6AB96d88bAAa77ddad7",
+    locker: "0x5249CA601E8E695eFECf9375AaFA531141d7e2f0",
+    collectorFactory: "0x5A34F50e945220774b3210E05C0c3a3f6132955d",
+    collectorDeployer: "0x9488807200eba120d242f328374e1aA9A17bb185",
+    hookDeployer: "0x6ADeaa3d9fa1e3a5F04D2c0DeB21Bf438ce9Af9A",
+    coreCodeHash: "0x9fb8f46c3b980b9db25dfdb487a69a308a86be145860269b4036a4e74480787b",
+    managerCodeHash: "0xbd3881180b547f5fe817545743cfb4343e96b1bc6640dcd70c106b0066e95626",
+    hookRuntimeCodeHash: "0x0000000000000000000000000000000000000000000000000000000000000000",
+    oracleFactoryCodeHash: "0x974fb5c72d91ccb99f1eb4679a5d4432c82bbaa0906b1c2917ec4da3499b7b98",
+    lockerCodeHash: "0x9953bb0c86f09018368fcc2f019d08466370ce4f078cd48d38a2ac7e42c0eafd",
+    collectorFactoryCodeHash: "0x7b8708516701f1344d62cab07ab15d6eedc8266bb9506efd67a57d93576bf6aa",
+    collectorDeployerCodeHash: "0x8a8a564ddea793e4be2fa135d85876dbe2461ca574841f3008e73de3c6ea9c97",
+    hookDeployerCodeHash: "0x6622a5805ebfd327d6bd26f5466da8fced080fdb8b34811f431db538e56155af",
+    hookCreationCodeHash: "0x11c4c7b1f265ed708b7d53ab828c89d237ca821333daa808f1913986c6f8f1ab",
+    codeChunk0: "0xaBeaf6bF6DFF808eea159B7020Ca598A8765d8f7",
+    codeChunk0Hash: "0xe5f56287276954b21f4211cabf2d9c251aae68836c5fa86ce68091ffccdee26b",
+    codeChunk1: "0xE351513eA18691dA1aa62aD4eEA5596806461F17",
+    codeChunk1Hash: "0x76efd61e1a109a85140ce3473c43694a83f490eaac54d18673c17872a5262a47",
+    sharedHookSalt: "0x0000000000000000000000000000000000000000000000000000000000000000",
+  }),
+}) satisfies LaunchEnvelopeV2;
+export const rwaFixedAdapter = Object.freeze({
+  implementation: "0x56BF798a2eA3935E2f16ABC48d2E20D7b156800e",
+  codeHash: "0xf2d2e4c8d3272de1159811eabd17ba126a1a25cbee5cf9b64b4c299e67b43095",
+  capabilities: 123n,
+  configVersion: 6,
+  enabled: true,
+}) satisfies AdapterRegistrationV1;
+export const rwaFixedRegistration = Object.freeze({
+  adapterId: "0x0f13f4a8553a4dece69888deb425b04ff169d41132f3e2097034aff00f584dd6",
+  configSchema: "0x51c5ca14c40012f78425cd1afb1ea77980da3fed0490a00911a8a4ed34792045",
+  dependencyDigest: "0x5fce23ef64a1f6c510a299f9abdeb8ab686bb9e994bc1e607b15cd68acda3554",
+  venue: "0x8366a39CC670B4001A1121B8F6A443A643e40951",
+  factory: "0x0000000000000000000000000000000000000000",
+  hook: "0x0000000000000000000000000000000000000000",
+  capabilities: 123n,
+  enabled: true,
+}) satisfies ProfileRegistrationV1;
+export const rwaFixedTopology = Object.freeze({
+  hookTopology: 2,
+  configVersion: 6,
+  hookDeployer: "0x6ADeaa3d9fa1e3a5F04D2c0DeB21Bf438ce9Af9A",
+  hookCreationCodeHash: "0x11c4c7b1f265ed708b7d53ab828c89d237ca821333daa808f1913986c6f8f1ab",
+}) satisfies ProfileTopologyV1;

package/src/lifecycle/gas-profile.ts

@@ -10,18 +10,19 @@ import { UFG_LAUNCH_PROXY_ADDRESS, isUfgProfile, ufgPlanPrincipal, type UfgLaunc
 import { LifecyclePlanningError, type LifecycleBlock, type LifecycleLaunchGasBounds, type LifecycleLimitSource, type LifecycleOpeningBuyQuote, type LifecyclePlanningAssessment, type LifecycleRpcClient, type LifecycleTransaction, type PlannedLaunch } from "./types.js";
 import { isHmmProfile } from "./hmm.js";
 import { isRaetoProfile } from "./raeto.js";
+import { isRwaProfile } from "./rwa.js";
 
-export const LIFECYCLE_GAS_PROFILE_VERSION = "robinhood-4663-capacity-v5";
+export const LIFECYCLE_GAS_PROFILE_VERSION = "robinhood-4663-capacity-v6";
 export type NextTransactionEnvelope = Readonly<{ gas: bigint; gasPrice: bigint }>;
 const ceil = (value: bigint, divisor: bigint) => (value + divisor - 1n) / divisor;
 const approval = (transaction: LifecycleTransaction) => transaction.kind === "approve" || transaction.kind === "approve-reset";
-type MarketGas = { abyss: boolean; hmm: boolean; ufgHook: boolean; raeto: boolean; autoCompound: boolean; positions: number };
+type MarketGas = { abyss: boolean; hmm: boolean; ufgHook: boolean; raeto: boolean; rwa: boolean; autoCompound: boolean; positions: number };
 
 function marketGas(plan: LaunchPlanV1): MarketGas[] {
   return plan.markets.map((market) => {
     const abyss = market.configVersion === 1;
     const config = abyss ? decodeAbyssLifecycleMarketConfig(market.config) : decodePoolBoundV4LifecycleMarketConfig(market.config, 6);
-    return { abyss, hmm: isHmmProfile(market.profileId), ufgHook: isUfgProfile(market.profileId), raeto: isRaetoProfile(market.profileId), autoCompound: isAutoCompoundProfile(market.profileId), positions: config.positions.length };
+    return { abyss, hmm: isHmmProfile(market.profileId), ufgHook: isUfgProfile(market.profileId), raeto: isRaetoProfile(market.profileId), rwa: isRwaProfile(market.profileId), autoCompound: isAutoCompoundProfile(market.profileId), positions: config.positions.length };
   });
 }
 
@@ -53,6 +54,9 @@ const activationCosts = {
   abyss: { market: 500_000n, position: 1_250_000n },
   v4: { market: 250_000n, position: 500_000n },
   raeto: { market: 500_000n, position: 500_000n },
+  // template-gas-rwa-matrix.json: six-stock RWA activation marginal is ~0.54M/position; the
+  // 32-position four-buy activation (24.43M) still fits 32M, so its bound must stay below it.
+  rwa: { market: 250_000n, position: 540_000n },
   autoCompound: { market: 750_000n, position: 500_000n },
   hmm: 1_000_000n,
   ufg: 250_000n,
@@ -68,25 +72,31 @@ function capacityBasis(plan: LaunchPlanV1, transaction: LifecycleTransaction, ma
   // template-gas-matrix.json: Raeto/auto-compound atomic1 <=19.60M,
   // atomic8 <=23.99M; atomic32 exceeds32M. The18M calibration base plus
   // position/buy work and25% padding bounds compute and forwarding envelopes.
-  let gas = atomic ? (markets[0]!.raeto || markets[0]!.autoCompound ? 18_000_000n : 22_000_000n) + tokenCreationGas(plan.token) + (ufgRoute ? 6_500_000n : 0n)
+  // template-gas-rwa-matrix.json: RWA atomic1 <=22.79M, atomic8 four buys <=27.39M
+  // (still within 32M), so its tighter 17M base keeps that observed fit plannable.
+  const first = markets[0]!;
+  let gas = atomic ? (first.rwa ? 17_000_000n : first.raeto || first.autoCompound ? 18_000_000n : 22_000_000n) + tokenCreationGas(plan.token) + (ufgRoute ? 6_500_000n : 0n)
     : activationCosts.call + (ufgRoute ? activationCosts.ufg : 0n);
   // Escrow executes each Swap during begin, including within atomic. This
   // empirical2M reserve is padded below, not a proof for arbitrary router code.
   if (atomic) for (const funding of plan.funding) if (funding.kind === LifecycleFundingKind.Swap) gas += 2_000_000n;
   for (const market of markets) {
     if (atomic) gas += (market.hmm ? 7_000_000n : market.ufgHook ? 1_000_000n : market.abyss ? 500_000n : 0n) +
-      (market.abyss ? 1_500_000n : 600_000n) * BigInt(market.positions - 1);
+      (market.abyss ? 1_500_000n : market.rwa ? 550_000n : 600_000n) * BigInt(market.positions - 1);
     else {
-      const cost = market.abyss ? activationCosts.abyss : market.raeto ? activationCosts.raeto : market.autoCompound ? activationCosts.autoCompound : activationCosts.v4;
+      const cost = market.abyss ? activationCosts.abyss : market.raeto ? activationCosts.raeto : market.rwa ? activationCosts.rwa : market.autoCompound ? activationCosts.autoCompound : activationCosts.v4;
       gas += cost.market + cost.position * BigInt(market.positions) + (market.hmm ? activationCosts.hmm : market.ufgHook ? activationCosts.ufg : 0n);
     }
   }
   gas += activationCosts.buy * BigInt(quotes.length);
   // These collectors revalidate the prepared position set for each buy. At32
   // positions the measured marginal exceeds1M/buy; flat0.5M is insufficient.
+  // RWA buys use ~0.66M at one position and ~1.25M at 32 (forwarding estimate
+  // ~1.7M/buy), so a flat part covers small shapes and a smaller position term large ones.
   for (const quote of quotes) {
     const market = markets[quote.marketIndex]!;
-    if (market.raeto || market.autoCompound) gas += 25_000n * BigInt(market.positions);
+    if (market.rwa) gas += 150_000n + 20_000n * BigInt(market.positions);
+    else if (market.raeto || market.autoCompound) gas += 25_000n * BigInt(market.positions);
   }
   if (plan.token.kind === LifecycleTokenKind.ERC404) for (const quote of quotes) gas += activationCosts.nft * ceil(quote.tokenOut, plan.token.nftUnit);
   return gas + 24n * BigInt((transaction.data.length - 2) / 2) + 100_000n * BigInt(plan.feeAssets.length);

package/src/lifecycle/index.ts

@@ -8,6 +8,8 @@ export * from "./ufg.js";
 export * from "./auto-compound.js";
 export * from "./raeto.js";
 export * from "./raeto-abi.js";
+export * from "./rwa.js";
+export * from "./rwa-abi.js";
 export { ABYSS_LIFECYCLE_CONFIG_SCHEMA, readLifecycleTokenAtBlock, readLifecycleHeadProgress, predictLifecycleToken,
   validateV4LifecycleOracle, readLifecycleProfiles, readPoolBoundHookDeployment,
   buildPoolBoundHookDeploymentTransaction, validateLifecycleMarketIdentity, readLaunchProgress } from "./progress.js";

package/src/lifecycle/markets.ts

@@ -5,6 +5,7 @@ import { decodeHmmLaunchTail, encodeHmmLaunchTail, isHmmProfile, type HmmLaunchC
 import { decodeUfgLaunchConfig, encodeUfgLaunchConfig, isUfgProfile, type UfgLaunchConfig } from "./ufg-config.js";
 import { decodeAutoCompoundTail, encodeAutoCompoundTail, isAutoCompoundProfile, validateAutoCompoundConfig, type AutoCompoundConfigV1 } from "./auto-compound.js";
 import { decodeRaetoLaunchTail, encodeRaetoLaunchTail, isRaetoProfile, RAETO_QUOTE_ASSETS, validateRaetoLaunchConfig, type RaetoLaunchConfigV1 } from "./raeto.js";
+import { decodeRwaLaunchTail, encodeRwaLaunchTail, isRwaProfile, RWA_QUOTE_ASSET, validateRwaLaunchConfig, type RwaLaunchConfigV1 } from "./rwa.js";
 
 export type V4LifecyclePositionConfig = {
   tickLower: number; tickUpper: number; liquidity: bigint; salt: Hex; maxTokenAmount: bigint;
@@ -50,6 +51,7 @@ export type V4PoolBoundLifecycleMarketConfigV6 = Omit<V4LifecycleMarketConfig, "
   ufgLaunchConfig?: UfgLaunchConfig;
   autoCompoundConfig?: AutoCompoundConfigV1;
   raetoLaunchConfig?: RaetoLaunchConfigV1;
+  rwaLaunchConfig?: RwaLaunchConfigV1;
 };
 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)[])"));
@@ -98,7 +100,7 @@ function assertV1HookFeeShape(config: object): void {
 
 function validateAutoCompoundMarket(config: V4LifecycleMarketConfig | V4PoolBoundLifecycleMarketConfig): asserts config is V4PoolBoundLifecycleMarketConfigV6 & { autoCompoundConfig: AutoCompoundConfigV1 } {
   if (config.version !== 6 || config.autoCompoundConfig === undefined) throw new LifecyclePlanningError("INVALID_AUTO_COMPOUND_CONFIG", "Auto-compounding profiles require config6 and an explicit autoCompoundConfig");
-  if (config.hmmLaunchConfig !== undefined || config.ufgLaunchConfig !== undefined || config.raetoLaunchConfig !== undefined) throw new LifecyclePlanningError("INVALID_AUTO_COMPOUND_CONFIG", "Auto-compounding profiles cannot carry HMM, UFG or Raeto tails");
+  if (config.hmmLaunchConfig !== undefined || config.ufgLaunchConfig !== undefined || config.raetoLaunchConfig !== undefined || config.rwaLaunchConfig !== undefined) throw new LifecyclePlanningError("INVALID_AUTO_COMPOUND_CONFIG", "Auto-compounding profiles cannot carry HMM, UFG, Raeto or RWA tails");
   if (config.lpFeePips !== 0) throw new LifecyclePlanningError("INVALID_HOOK_FEES", "Auto-compounding profiles require zero LP fee");
   if (config.developerFeeBps !== 0) throw new LifecyclePlanningError("DEVELOPER_FEE_CEILING", "Auto-compounding profiles require zero developer fee");
   validateAutoCompoundConfig(config.autoCompoundConfig);
@@ -106,11 +108,18 @@ function validateAutoCompoundMarket(config: V4LifecycleMarketConfig | V4PoolBoun
 
 function validateRaetoMarket(config: V4LifecycleMarketConfig | V4PoolBoundLifecycleMarketConfig): asserts config is V4PoolBoundLifecycleMarketConfigV6 & { raetoLaunchConfig: RaetoLaunchConfigV1 } {
   if (config.version !== 6 || config.raetoLaunchConfig === undefined) throw new LifecyclePlanningError("INVALID_RAETO_CONFIG", "Raeto profiles require config6 and an explicit raetoLaunchConfig");
-  if (config.hmmLaunchConfig !== undefined || config.ufgLaunchConfig !== undefined || config.autoCompoundConfig !== undefined) throw new LifecyclePlanningError("INVALID_RAETO_CONFIG", "Raeto profiles cannot carry HMM, UFG or auto-compounding tails");
+  if (config.hmmLaunchConfig !== undefined || config.ufgLaunchConfig !== undefined || config.autoCompoundConfig !== undefined || config.rwaLaunchConfig !== undefined) throw new LifecyclePlanningError("INVALID_RAETO_CONFIG", "Raeto profiles cannot carry HMM, UFG, auto-compounding or RWA tails");
   if (config.feeMode !== 1 || config.lpFeePips !== 0 || config.developerFeeBps !== 0) throw new LifecyclePlanningError("INVALID_RAETO_CONFIG", "Raeto requires QuoteOnly feeMode 1, zero LP fee and zero developer fee");
   validateRaetoLaunchConfig(config.raetoLaunchConfig);
 }
 
+function validateRwaMarket(config: V4LifecycleMarketConfig | V4PoolBoundLifecycleMarketConfig): asserts config is V4PoolBoundLifecycleMarketConfigV6 & { rwaLaunchConfig: RwaLaunchConfigV1 } {
+  if (config.version !== 6 || config.rwaLaunchConfig === undefined) throw new LifecyclePlanningError("INVALID_RWA_CONFIG", "RWA profiles require config6 and an explicit rwaLaunchConfig");
+  if (config.hmmLaunchConfig !== undefined || config.ufgLaunchConfig !== undefined || config.autoCompoundConfig !== undefined || config.raetoLaunchConfig !== undefined) throw new LifecyclePlanningError("INVALID_RWA_CONFIG", "RWA profiles cannot carry HMM, UFG, auto-compounding or Raeto tails");
+  if (config.feeMode !== 1 || config.lpFeePips !== 0 || config.developerFeeBps !== 0) throw new LifecyclePlanningError("INVALID_RWA_CONFIG", "RWA requires QuoteOnly feeMode 1, zero LP fee and zero developer fee");
+  validateRwaLaunchConfig(config.rwaLaunchConfig);
+}
+
 /** Auxiliary launch profiles require their typed tail and append it automatically. */
 export function encodePoolBoundV4LifecycleMarketConfig(config: V4PoolBoundLifecycleMarketConfig): Hex {
   const prefix = encodePoolBoundV4Prefix(config);
@@ -119,6 +128,11 @@ export function encodePoolBoundV4LifecycleMarketConfig(config: V4PoolBoundLifecy
     return concatHex([prefix, encodeRaetoLaunchTail(config.raetoLaunchConfig)]);
   }
   if (config.version === 6 && config.raetoLaunchConfig !== undefined) throw new LifecyclePlanningError("INVALID_RAETO_CONFIG", "A Raeto tail requires a Raeto profile");
+  if (isRwaProfile(config.profileId)) {
+    validateRwaMarket(config);
+    return concatHex([prefix, encodeRwaLaunchTail(config.rwaLaunchConfig)]);
+  }
+  if (config.version === 6 && config.rwaLaunchConfig !== undefined) throw new LifecyclePlanningError("INVALID_RWA_CONFIG", "An RWA tail requires an RWA profile");
   if (isAutoCompoundProfile(config.profileId)) {
     validateAutoCompoundMarket(config);
     return concatHex([prefix, encodeAutoCompoundTail(config.autoCompoundConfig)]);
@@ -163,6 +177,10 @@ export function decodePoolBoundV4LifecycleMarketConfig(encoded: Hex, expectedVer
     if (config.version !== 6) throw new LifecyclePlanningError("INVALID_RAETO_CONFIG", "Raeto profiles require config6");
     config.raetoLaunchConfig = decodeRaetoLaunchTail(`0x${encoded.slice(encodePoolBoundV4Prefix(config).length)}`);
   }
+  if (isRwaProfile(config.profileId)) {
+    if (config.version !== 6) throw new LifecyclePlanningError("INVALID_RWA_CONFIG", "RWA profiles require config6");
+    config.rwaLaunchConfig = decodeRwaLaunchTail(`0x${encoded.slice(encodePoolBoundV4Prefix(config).length)}`);
+  }
   if (isAutoCompoundProfile(config.profileId)) {
     if (config.version !== 6) throw new LifecyclePlanningError("INVALID_AUTO_COMPOUND_CONFIG", "Auto-compounding profiles require config6");
     config.autoCompoundConfig = decodeAutoCompoundTail(`0x${encoded.slice(encodePoolBoundV4Prefix(config).length)}`);
@@ -202,6 +220,10 @@ export function validateV4LifecycleMarket(options: {
     validateRaetoMarket(config);
     if (!RAETO_QUOTE_ASSETS.some((quote) => quote.toLowerCase() === market.quoteAsset.toLowerCase())) throw new LifecyclePlanningError("INVALID_RAETO_CONFIG", "Raeto quote asset must be WETH or USDG");
   } else if (config.version === 6 && config.raetoLaunchConfig !== undefined) throw new LifecyclePlanningError("INVALID_RAETO_CONFIG", "A Raeto tail requires a Raeto profile");
+  if (isRwaProfile(config.profileId)) {
+    validateRwaMarket(config);
+    if (market.quoteAsset.toLowerCase() !== RWA_QUOTE_ASSET.toLowerCase()) throw new LifecyclePlanningError("INVALID_RWA_CONFIG", "RWA quote asset must be USDG");
+  } else if (config.version === 6 && config.rwaLaunchConfig !== undefined) throw new LifecyclePlanningError("INVALID_RWA_CONFIG", "An RWA tail requires an RWA profile");
   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 ||

package/src/lifecycle/opening-buys.ts

@@ -52,7 +52,7 @@ function openingState(plan: LaunchPlanV1, marketIndex: number): OpeningState {
     const config = decodePoolBoundV4LifecycleMarketConfig(market.config, 6);
     if (config.profileId.toLowerCase() !== market.profileId.toLowerCase()) throw new LifecyclePlanningError("INVALID_MARKET", "V4 opening config differs from the selected profile");
     price = config.sqrtPriceX96; spacing = config.tickSpacing; lpFee = BigInt(config.lpFeePips); positions = config.positions;
-    const dynamic = preset.key === KnownLifecycleProfile.V4DynamicFeePool || preset.key === KnownLifecycleProfile.V4HmmDynamicPool || preset.key === KnownLifecycleProfile.V4UfgDynamicPool || preset.key === KnownLifecycleProfile.V4AutoCompoundDynamicPool || preset.key === KnownLifecycleProfile.V4RaetoDynamicPool;
+    const dynamic = preset.key === KnownLifecycleProfile.V4DynamicFeePool || preset.key === KnownLifecycleProfile.V4HmmDynamicPool || preset.key === KnownLifecycleProfile.V4UfgDynamicPool || preset.key === KnownLifecycleProfile.V4AutoCompoundDynamicPool || preset.key === KnownLifecycleProfile.V4RaetoDynamicPool || preset.key === KnownLifecycleProfile.V4RwaDynamicPool;
     hookFee = BigInt(dynamic ? config.minimumHookFeePips! : config.hookFeePips);
   }
   const tick = getTickAtSqrtRatio(price), liquidityNet = new Map<number, bigint>();

package/src/lifecycle/planner.ts

@@ -19,6 +19,7 @@ import { computeLifecycleOpeningBuys, hasProfiledOpeningMath } from "./opening-b
 import { assessLifecycleTransactions, deriveLifecycleLaunchCapacity, type NextTransactionEnvelope, type ProfiledLaunchCapacity } from "./gas-profile.js";
 import type { LifecycleOpeningBuyQuote } from "./types.js";
 import { isRaetoProfile, RAETO_QUOTE_ASSETS } from "./raeto.js";
+import { validateRwaLaunchPlan } from "./rwa.js";
 
 type ValidatedPlanShape = {
   commitment: Hex;
@@ -81,6 +82,7 @@ function validatePlanShape(plan: LaunchPlanV1): ValidatedPlanShape {
     previous = BigInt(policy.asset);
   }
   if (plan.feeAssets.some((policy) => policy.rewardsBps !== 0) !== (plan.token.rewardMode !== LifecycleRewardMode.None)) throw new LifecyclePlanningError("INVALID_FEE_POLICY", "Reward-enabled tokens require a rewards share; reward-free tokens cannot commit rewards shares");
+  validateRwaLaunchPlan(plan);
   previous = 0n;
   for (const funding of plan.funding) {
     if (BigInt(funding.asset) <= previous || funding.amount <= 0n || funding.inputAmount <= 0n) throw new LifecyclePlanningError("INVALID_FUNDING", "Funding output assets must be positive, unique and ascending");
@@ -471,7 +473,10 @@ function finalizeNextTransaction(options: BuildNextTransactionOptions, next: Lif
 /** Recovery observes actual canonical receipts, then constructs and budgets only
  * the next command. No launch transaction is executed during planning. */
 export async function buildNextTransaction(options: BuildNextTransactionOptions): Promise<LifecycleTransaction | undefined> {
-  if (options.action !== "cancel") for (const market of options.planned.plan.markets) validateRaetoMarketContext(market);
+  if (options.action !== "cancel") {
+    for (const market of options.planned.plan.markets) validateRaetoMarketContext(market);
+    validateRwaLaunchPlan(options.planned.plan);
+  }
   const original = options.planned, matches = observedFields(original);
   const assertInput = () => {
     if (options.planned !== original || !matches()) throw new LifecyclePlanningError("PLAN_MUTATED", "Stored launch context changed while constructing its next transaction");

package/src/lifecycle/presets.ts

@@ -17,6 +17,9 @@ import { AUTO_COMPOUND_STATIC_V1_PROFILE_ID, AUTO_COMPOUND_DYNAMIC_V1_PROFILE_ID
 import { raetoFixedEnvelope, raetoFixedAdapter, raetoFixedRegistration } from "./deployments/raeto-fixed-pool-v1-20261029.js";
 import { raetoDynamicEnvelope, raetoDynamicAdapter, raetoDynamicRegistration } from "./deployments/raeto-dynamic-pool-v1-20261029.js";
 import { RAETO_FIXED_PROFILE_ID, RAETO_DYNAMIC_PROFILE_ID } from "./raeto.js";
+import { rwaFixedEnvelope, rwaFixedAdapter, rwaFixedRegistration } from "./deployments/rwa-fixed-pool-v1-20261113.js";
+import { rwaDynamicEnvelope, rwaDynamicAdapter, rwaDynamicRegistration } from "./deployments/rwa-dynamic-pool-v1-20261113.js";
+import { RWA_FIXED_PROFILE_ID, RWA_DYNAMIC_PROFILE_ID } from "./rwa.js";
 
 export enum KnownLifecycleProfile {
   Abyss0 = "abyss-0",
@@ -33,6 +36,8 @@ export enum KnownLifecycleProfile {
   V4AutoCompoundDynamicPool = "v4-auto-compound-dynamic-pool",
   V4RaetoFixedPool = "v4-raeto-fixed-pool",
   V4RaetoDynamicPool = "v4-raeto-dynamic-pool",
+  V4RwaFixedPool = "v4-rwa-fixed-pool",
+  V4RwaDynamicPool = "v4-rwa-dynamic-pool",
 }
 
 export enum KnownLifecycleHook {
@@ -367,6 +372,8 @@ const knownDeployment: LifecycleDeploymentPreset = Object.freeze({
     poolBoundPreset(KnownLifecycleProfile.V4AutoCompoundDynamicPool, AUTO_COMPOUND_DYNAMIC_V1_PROFILE_ID, autoCompoundDynamicEnvelope, autoCompoundDynamicAdapter, autoCompoundDynamicRegistration, autoCompoundDynamicCreationCode),
     poolBoundPreset(KnownLifecycleProfile.V4RaetoFixedPool, RAETO_FIXED_PROFILE_ID, raetoFixedEnvelope, raetoFixedAdapter, raetoFixedRegistration, fixedFeePoolHookV1CreationCode),
     poolBoundPreset(KnownLifecycleProfile.V4RaetoDynamicPool, RAETO_DYNAMIC_PROFILE_ID, raetoDynamicEnvelope, raetoDynamicAdapter, raetoDynamicRegistration, dynamicFeePoolHookV1CreationCode),
+    poolBoundPreset(KnownLifecycleProfile.V4RwaFixedPool, RWA_FIXED_PROFILE_ID, rwaFixedEnvelope, rwaFixedAdapter, rwaFixedRegistration, fixedFeePoolHookV1CreationCode),
+    poolBoundPreset(KnownLifecycleProfile.V4RwaDynamicPool, RWA_DYNAMIC_PROFILE_ID, rwaDynamicEnvelope, rwaDynamicAdapter, rwaDynamicRegistration, dynamicFeePoolHookV1CreationCode),
   ]),
   provenance: Object.freeze({ sourceCommit: "e174ce695c7010f50ca9211b07b9f178c990beac", deploymentBlock: 82880546n }),
 });
@@ -396,7 +403,7 @@ export function getKnownLifecycleProfile(options: KnownLifecycleDeploymentIdenti
   return undefined;
 }
 
-/** Stable, frozen order: Abyss, fixed/dynamic V4, HMM, UFG, auto-compounding, then Raeto. */
+/** Stable, frozen order: Abyss, fixed/dynamic V4, HMM, UFG, auto-compounding, Raeto, then RWA. */
 export function listKnownLifecycleProfiles(options: KnownLifecycleDeploymentIdentity): readonly LifecycleProfilePreset[] {
   return getKnownLifecycleDeployment(options)?.profiles ?? noProfiles;
 }

package/src/lifecycle/raeto-abi.ts

@@ -1,4 +1,4 @@
-// Generated from the verified RaetoFeeCollectorV1 ABI by scripts/generate-raeto-presets.mjs.
+// Generated from the verified Raeto collector/registry ABIs by scripts/generate-raeto-presets.mjs.
 // Provenance: test/fixtures/raeto-registry-readback.json, abiProvenance.
 export const raetoFeeCollectorV1Abi = [
   {
@@ -181,6 +181,32 @@ export const raetoFeeCollectorV1Abi = [
     "stateMutability": "view",
     "type": "function"
   },
+  {
+    "inputs": [],
+    "name": "payoutRegistry",
+    "outputs": [
+      {
+        "internalType": "address",
+        "name": "",
+        "type": "address"
+      }
+    ],
+    "stateMutability": "view",
+    "type": "function"
+  },
+  {
+    "inputs": [],
+    "name": "poolId",
+    "outputs": [
+      {
+        "internalType": "bytes32",
+        "name": "",
+        "type": "bytes32"
+      }
+    ],
+    "stateMutability": "view",
+    "type": "function"
+  },
   {
     "inputs": [],
     "name": "quoteAsset",
@@ -221,3 +247,17 @@ export const raetoFeeCollectorV1Abi = [
     "type": "function"
   }
 ] as const;
+
+export const raetoPayoutRegistryV1Abi = [
+  {
+    "name": "payout",
+    "type": "function",
+    "stateMutability": "view",
+    "inputs": [],
+    "outputs": [
+      {
+        "type": "address"
+      }
+    ]
+  }
+] as const;