@black-market/sdk 0.15.1 → 0.16.1

package/src/lifecycle/raeto-abi.ts

@@ -0,0 +1,223 @@
+// Generated from the verified RaetoFeeCollectorV1 ABI by scripts/generate-raeto-presets.mjs.
+// Provenance: test/fixtures/raeto-registry-readback.json, abiProvenance.
+export const raetoFeeCollectorV1Abi = [
+  {
+    "anonymous": false,
+    "inputs": [
+      {
+        "indexed": true,
+        "internalType": "address",
+        "name": "launchToken",
+        "type": "address"
+      },
+      {
+        "indexed": true,
+        "internalType": "bytes32",
+        "name": "poolId",
+        "type": "bytes32"
+      },
+      {
+        "indexed": true,
+        "internalType": "address",
+        "name": "asset",
+        "type": "address"
+      },
+      {
+        "indexed": false,
+        "internalType": "uint256",
+        "name": "grossQuoteCollected",
+        "type": "uint256"
+      },
+      {
+        "indexed": false,
+        "internalType": "uint256",
+        "name": "raetoAmount",
+        "type": "uint256"
+      },
+      {
+        "indexed": false,
+        "internalType": "uint256",
+        "name": "forwardedQuote",
+        "type": "uint256"
+      },
+      {
+        "indexed": false,
+        "internalType": "uint16",
+        "name": "shareBps",
+        "type": "uint16"
+      },
+      {
+        "indexed": false,
+        "internalType": "uint256",
+        "name": "owedAfter",
+        "type": "uint256"
+      }
+    ],
+    "name": "RaetoFeesBooked",
+    "type": "event"
+  },
+  {
+    "anonymous": false,
+    "inputs": [
+      {
+        "indexed": true,
+        "internalType": "address",
+        "name": "launchToken",
+        "type": "address"
+      },
+      {
+        "indexed": true,
+        "internalType": "bytes32",
+        "name": "poolId",
+        "type": "bytes32"
+      },
+      {
+        "indexed": true,
+        "internalType": "address",
+        "name": "payout",
+        "type": "address"
+      },
+      {
+        "indexed": false,
+        "internalType": "address",
+        "name": "asset",
+        "type": "address"
+      },
+      {
+        "indexed": false,
+        "internalType": "uint256",
+        "name": "amount",
+        "type": "uint256"
+      }
+    ],
+    "name": "RaetoFeesClaimed",
+    "type": "event"
+  },
+  {
+    "anonymous": false,
+    "inputs": [
+      {
+        "indexed": true,
+        "internalType": "address",
+        "name": "launchToken",
+        "type": "address"
+      },
+      {
+        "indexed": true,
+        "internalType": "bytes32",
+        "name": "poolId",
+        "type": "bytes32"
+      },
+      {
+        "indexed": true,
+        "internalType": "address",
+        "name": "operator",
+        "type": "address"
+      },
+      {
+        "indexed": false,
+        "internalType": "uint16",
+        "name": "previousShareBps",
+        "type": "uint16"
+      },
+      {
+        "indexed": false,
+        "internalType": "uint16",
+        "name": "newShareBps",
+        "type": "uint16"
+      }
+    ],
+    "name": "RaetoShareUpdated",
+    "type": "event"
+  },
+  {
+    "inputs": [
+      {
+        "internalType": "address",
+        "name": "asset",
+        "type": "address"
+      }
+    ],
+    "name": "claimRaeto",
+    "outputs": [
+      {
+        "internalType": "uint256",
+        "name": "amount",
+        "type": "uint256"
+      }
+    ],
+    "stateMutability": "nonpayable",
+    "type": "function"
+  },
+  {
+    "inputs": [],
+    "name": "launchToken",
+    "outputs": [
+      {
+        "internalType": "address",
+        "name": "",
+        "type": "address"
+      }
+    ],
+    "stateMutability": "view",
+    "type": "function"
+  },
+  {
+    "inputs": [
+      {
+        "internalType": "address",
+        "name": "asset",
+        "type": "address"
+      }
+    ],
+    "name": "owed",
+    "outputs": [
+      {
+        "internalType": "uint256",
+        "name": "amount",
+        "type": "uint256"
+      }
+    ],
+    "stateMutability": "view",
+    "type": "function"
+  },
+  {
+    "inputs": [],
+    "name": "quoteAsset",
+    "outputs": [
+      {
+        "internalType": "address",
+        "name": "",
+        "type": "address"
+      }
+    ],
+    "stateMutability": "view",
+    "type": "function"
+  },
+  {
+    "inputs": [
+      {
+        "internalType": "uint16",
+        "name": "newShareBps",
+        "type": "uint16"
+      }
+    ],
+    "name": "setShareBps",
+    "outputs": [],
+    "stateMutability": "nonpayable",
+    "type": "function"
+  },
+  {
+    "inputs": [],
+    "name": "shareBps",
+    "outputs": [
+      {
+        "internalType": "uint16",
+        "name": "",
+        "type": "uint16"
+      }
+    ],
+    "stateMutability": "view",
+    "type": "function"
+  }
+] as const;

package/src/lifecycle/raeto.ts

@@ -0,0 +1,61 @@
+import { encodeAbiParameters, type Hex } from "viem";
+import { decodePoolBoundV4LifecycleMarketConfig } from "./markets.js";
+import type { LaunchPlanV1 } from "./schema.js";
+import { LifecyclePlanningError } from "./types.js";
+
+export const RAETO_FIXED_PROFILE_ID: Hex = "0x9161833b162e7ca8160b11c64aedb307561e19a9136fd32f99cd797aab6da3ca";
+export const RAETO_DYNAMIC_PROFILE_ID: Hex = "0x08387d00ee4f75f860810cc8fb434087328592c2f39ea3321109e589039f80e1";
+export const RAETO_FIXED_ADAPTER_ID: Hex = "0x911d7ecefe56489d329235e3484829717dc00400d4181902f0f2de45f9338615";
+export const RAETO_DYNAMIC_ADAPTER_ID: Hex = "0x8ab9c8c9b8fd4c8bbf12b780d9474463fa0fa52e3b450f0d5f68fd067dc1674d";
+export const RAETO_PAYOUT_REGISTRY_ADDRESS = "0xBEC2C0e91612090F82df6743F31CDF18B4386b50";
+/** The deployed collectors accept this menu, not the wider range in later source. */
+export const RAETO_SHARE_BPS_OPTIONS = Object.freeze([500, 1000, 2500, 5000, 7500] as const);
+export const RAETO_QUOTE_ASSETS = Object.freeze([
+  "0x0Bd7D308f8E1639FAb988df18A8011f41EAcAD73",
+  "0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168",
+] as const);
+export type RaetoLaunchConfigV1 = { shareBps: number };
+
+export function isRaetoProfile(profileId: Hex): boolean {
+  const id = profileId.toLowerCase();
+  return id === RAETO_FIXED_PROFILE_ID || id === RAETO_DYNAMIC_PROFILE_ID;
+}
+
+export function validateRaetoLaunchConfig(config: RaetoLaunchConfigV1): void {
+  if (!RAETO_SHARE_BPS_OPTIONS.some((share) => share === config.shareBps)) {
+    throw new LifecyclePlanningError("INVALID_RAETO_CONFIG", "Raeto shareBps must be one of 500, 1000, 2500, 5000 or 7500");
+  }
+}
+
+/** Exactly abi.encode(RaetoLaunchConfigV1): one static uint16 word. */
+export function encodeRaetoLaunchTail(config: RaetoLaunchConfigV1): Hex {
+  validateRaetoLaunchConfig(config);
+  return encodeAbiParameters([{ type: "uint16" }], [config.shareBps]);
+}
+
+export function decodeRaetoLaunchTail(encoded: Hex): RaetoLaunchConfigV1 {
+  if (!/^0x[0-9a-fA-F]{64}$/.test(encoded)) throw new LifecyclePlanningError("INVALID_RAETO_CONFIG", "Raeto tail must be exactly one ABI word");
+  const share = BigInt(encoded);
+  if (share > 65535n) throw new LifecyclePlanningError("INVALID_RAETO_CONFIG", "Raeto tail must contain a canonical uint16");
+  const config = { shareBps: Number(share) };
+  validateRaetoLaunchConfig(config);
+  return config;
+}
+
+/** Raeto uses the normal lifecycle creator/funding route, not the UFG proxy. */
+export function validateRaetoLaunchPlan(plan: LaunchPlanV1): void {
+  try {
+    if (plan.markets.length === 0) throw new Error("A Raeto plan requires at least one market");
+    for (const market of plan.markets) {
+      if (!isRaetoProfile(market.profileId) || market.configVersion !== 6 ||
+        !RAETO_QUOTE_ASSETS.some((quote) => quote.toLowerCase() === market.quoteAsset.toLowerCase()) ||
+        market.adapterId.toLowerCase() !== (market.profileId.toLowerCase() === RAETO_FIXED_PROFILE_ID ? RAETO_FIXED_ADAPTER_ID : RAETO_DYNAMIC_ADAPTER_ID)) {
+        throw new Error("Every Raeto market requires its Raeto config6 profile/adapter and a WETH or USDG quote");
+      }
+      const config = decodePoolBoundV4LifecycleMarketConfig(market.config, 6);
+      if (config.profileId.toLowerCase() !== market.profileId.toLowerCase()) throw new Error("Raeto config profile differs from its market");
+    }
+  } catch (error) {
+    throw new LifecyclePlanningError("INVALID_RAETO_PLAN", error instanceof Error ? error.message : "Invalid Raeto launch plan");
+  }
+}

package/src/lifecycle/transactions.ts

@@ -7,6 +7,8 @@ import { ufgLaunchProxyV1Abi } from "./ufg-abi.js";
 import { UFG_LAUNCH_PROXY_ADDRESS, isUfgProfile } from "./ufg-config.js";
 import { decodeAbyssLifecycleMarketConfig, decodePoolBoundV4LifecycleMarketConfig, decodeV4LifecycleMarketConfig, isPoolBoundV4ConfigVersion } from "./markets.js";
 import { isHmmProfile } from "./hmm.js";
+import { isRaetoProfile } from "./raeto.js";
+import { isAutoCompoundProfile } from "./auto-compound.js";
 import type { UfgLaunchConfig } from "./ufg-config.js";
 
 // Native9,723,187 Abyss3 (0x679d…e77), fork32-position10,900,786;
@@ -16,6 +18,10 @@ const preparationCosts = {
   v4: { market: 9_000_000n, position: 40_000n },
   ufg: { market: 10_000_000n, position: 70_000n },
   hmm: { market: 15_000_000n, position: 50_000n },
+  // template-gas-matrix.json: Raeto1 <=9.13M,32 <=11.23M.
+  raeto: { market: 9_300_000n, position: 70_000n },
+  // Same matrix: auto-compound1 <=8.71M,32 <=10.76M.
+  autoCompound: { market: 8_900_000n, position: 70_000n },
 } as const;
 export const LIFECYCLE_CAPACITY_PADDING_BPS = 2500;
 /** Full single-market observations include call overhead. Add conservative full
@@ -30,7 +36,8 @@ export function preparationGasEstimate(plan: LaunchPlanV1, first: number, count:
       : isPoolBoundV4ConfigVersion(market.configVersion) ? decodePoolBoundV4LifecycleMarketConfig(market.config, market.configVersion).positions.length
       : decodeV4LifecycleMarketConfig(market.config).positions.length;
     const cost = market.configVersion === 1 ? preparationCosts.abyss : isHmmProfile(market.profileId) ? preparationCosts.hmm
-      : isUfgProfile(market.profileId) ? preparationCosts.ufg : preparationCosts.v4;
+      : isUfgProfile(market.profileId) ? preparationCosts.ufg : isRaetoProfile(market.profileId) ? preparationCosts.raeto
+      : isAutoCompoundProfile(market.profileId) ? preparationCosts.autoCompound : preparationCosts.v4;
     gas += cost.market + cost.position * BigInt(positions - 1);
   }
   return gas;

package/src/lifecycle/types.ts

@@ -86,7 +86,7 @@ export type LifecycleOpeningBuyQuote = {
   tokenOut: bigint; sqrtPriceAfterX96: bigint;
 };
 /** Versioned compute budgets with headroom, never transaction gas-limit sizing.
- * Atomic budget is absent when conversion work is outside the template model. */
+ * Atomic budget is absent for launches with more than one market. */
 export type LifecycleLaunchGasBounds = {
   atomicComputeGasUpperBound?: bigint; activationComputeGasUpperBound: bigint;
 };
@@ -164,7 +164,7 @@ export type PlannedLaunch = {
 };
 export type PlanLaunchOptions = {
   client: LifecycleRpcClient; account: Address; plan: LaunchPlanV1;
-  /** Atomic requires one market, no conversion and a known budget fitting with headroom.
+  /** Atomic requires one market and a known budget, including conversions, fitting with headroom.
    * All other unstarted launches are staged; started launches retain canonical mode. */
   mode: LaunchExecutionMode; limits?: LifecycleLimitSource; receipts?: readonly LifecycleReceiptReference[];
   confirmations?: number; signal?: AbortSignal;