@black-market/sdk 0.15.1 → 0.16.1

package/dist/lifecycle/types.d.ts

@@ -136,7 +136,7 @@ export type LifecycleOpeningBuyQuote = {
     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;
@@ -284,7 +284,7 @@ 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;

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

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

package/docs/launch-lifecycle.md

@@ -1,6 +1,6 @@
 # Launch a token with the TypeScript SDK
 
-Use SDK **0.14.1** on Robinhood Chain mainnet (**4663**). For a first launch, run
+Use SDK **0.16.1** on Robinhood Chain mainnet (**4663**). For a first launch, run
 [`launch-erc20-abyss.ts`](../examples/launch-erc20-abyss.ts): one market, one position,
 one buy. [Runner setup](../examples/README.md) covers its environment and commands.
 This guide explains the economics and the public APIs for your own integration.
@@ -19,6 +19,7 @@ staking, or dividends. A pool profile selects the admitted venue/hook implementa
 | HMM V2 | `V4HmmFixedPool`, `V4HmmDynamicPool` | Auxiliary fee-funded bids/asks; LP and developer fees 0; explicit risk guards. |
 | UFG | Abyss QUOTE/QUOTE_ORACLE or `V4UfgFixedPool`, `V4UfgDynamicPool` | Treasury route; ERC20 without rewards; quote-only fees, executor bounty 0. |
 | Auto-compounding | `V4AutoCompoundStaticPool`, `V4AutoCompoundDynamicPool` | Net hook fees fund permanently locked full-range liquidity; both fee modes; LP and developer fees 0. |
+| Raeto | `V4RaetoFixedPool`, `V4RaetoDynamicPool` | QuoteOnly WETH/USDG; Raeto share 5/10/25/50/75%; LP and developer fees 0. |
 
 SDK presets are the source of supported profiles and deployment wiring. Profiles
 registered after this release appear with a subsequent SDK update.
@@ -311,24 +312,23 @@ uses **now + 300 seconds**, at most 1,200 seconds and never beyond plan expiry.
 Staging can outlive the conversion even while the plan is valid. Do not edit a
 saved deadline or replace committed conversion bytes after begin.
 
-## Prepare and simulate
+## Prepare and plan
 
 | Mode | Transactions after any approvals | Choose when |
 | --- | --- | --- |
-| `atomic` | One transaction creates, prepares, mints, locks, buys, and opens. | The exact full launch fits the execution envelope. |
-| `staged` | Begin → prepare batches → one activation that mints, locks, buys, and opens all markets. | Preparation needs separate transactions. |
+| `atomic` | One transaction funds (including conversion), creates, prepares, mints, locks, buys, and opens. | One known-profile market's padded compute plus poster allocation fits the native envelope. |
+| `staged` | Begin funds and creates → prepare batches → one activation that mints, locks, buys, and opens all markets. | Multiple markets or the conservative atomic budget requires separate preparation. |
 
 Staging is not rollback. A begun plan remains begun after its deadline until cancelled.
 Activation cannot be split into separate position mints or buys.
-An atomic request is a preference: conservative capacity bounds or an actual atomic capacity failure may select staged. Explicit staged stays staged. No markets or buys are removed. Review and persist returned `planned.mode`.
+An atomic request is a preference: multiple markets or an atomic capacity bound above the native envelope select staged. The atomic basis includes an empirical2M compute reserve per `Swap` funding entry before at-least-25% padding; this is not a universal bound on arbitrary router code. Explicit staged stays staged. No markets or buys are removed. Review and persist returned `planned.mode`.
 
 | Operation | Options type / purpose |
 | --- | --- |
-| `prepareAndPlanLifecycleLaunch` | `PrepareAndPlanLifecycleLaunchOptions`: `client`, `account`, `plan`, `mode`; optional `ufg: { config }`, `buySlippageBps`, `limits`, `fork`, `receipts`, `confirmations`, `signal`, `onProgress`, topology opt-outs. |
-| `planLaunch` | `PlanLaunchOptions`: same execution context, including optional `ufg: { config }` and `signal`; re-admits an already-finalized plan without changing salts/minima. |
-| `simulateLaunchPlan` | `client`, `planned`; optional `limits`, `fork`, `receipts`, `confirmations`, `signal`. |
+| `prepareAndPlanLifecycleLaunch` | `PrepareAndPlanLifecycleLaunchOptions`: `client`, `account`, `plan`, `mode`; optional `ufg: { config }`, `buySlippageBps`, `limits`, `receipts`, `confirmations`, `signal`, `onProgress`, topology opt-outs. |
+| `planLaunch` | `PlanLaunchOptions`: same execution context, including optional `ufg: { config }` and `signal`; checks an already-finalized plan without changing salts/minima. |
 | `readLaunchProgress` | `client`, `planned`; optional `receipts`, `confirmations`, `signal`. |
-| `buildNextTransaction` | Progress options, plus optional `action`, `limits`, `fork`, `reviewedTransaction`. |
+| `buildNextTransaction` | Progress options, plus optional `action`, `limits`, `reviewedTransaction`. |
 
 `buildLaunchTransactions` compiles unsigned commands; it does not prove execution.
 Persist `serializeLaunchPlan(planned.plan)`, returned `planned.mode`, confirmation policy,
@@ -337,32 +337,30 @@ Do not serialize the entire `PlannedLaunch`, which can contain live limit callba
 
 Every launch step uses the native total transaction ceiling:32M on4663, including
 poster gas. Approvals omit gas/fees for wallet preparation. Covered Robinhood
-ArbOS61 templates use capacity bounds and exact local ordered-buy math, never
-component-sized gas limits. Their evidence is `profiled` / `not-run`, not a receipt.
-Conversion-carrying begin/atomic and consuming activation require exact native
-execution. Unknown coverage or uncertain activation gets full-sequence execution
-before begin. Explicit `simulateLaunchPlan` always executes; a generic fork is not Nitro proof.
-
-Review checks the complete sequence, not just a successful prefix. There is no
-SDK-invented 50M aggregate cap. A caller `maxSimulationGas` still tightens policy;
-incomplete execution proof refuses admission. A refused full review cannot begin
-a new launch. Only the immediate command receives final gas/price/estimate/admission.
-Suffix metrics remain provisional; build-next admits only the canonical next command
-at its fresh native-ceiling budget, never reusing a provisional estimate.
+templates use deterministic capacity bounds and exact local ordered-buy math,
+never component-sized gas limits or launch simulation. This includes conversion:
+the router enforces committed output floors and deadlines only on submission.
+Unknown coverage refuses `UNKNOWN_GAS_PROFILE`; oversized unsplittable activation
+refuses `ACTIVATION_GAS_LIMIT` before begin. There is no execution fallback.
+
+Only the immediate command receives fresh gas/price/estimate/assessment.
+Build-next checks the canonical next command against its fresh native-ceiling
+budget, current inputs and poster prices. A ready assessment is not a receipt or
+execution proof; no successful prefix authorizes an over-budget activation.
 
 See [capacity, native/fork evidence and migration](lifecycle-gas-profiles.md)
-for exact proof fields, upfront affordability and the public capacity-bound helper.
+for the reserve assumptions, upfront affordability and public capacity-bound helper.
 
 Review the returned final plan/hash, aligned price, burn, retained supply, fees,
 ordered buy outputs/minima, funding, refunds, and complete gas envelope. A fresh
-`buildNextTransaction` admits the immediate next step as canonical progress advances.
+`buildNextTransaction` checks the immediate next step as canonical progress advances.
 The wallet owns sending-RPC preparation; `submissionClient` has been removed.
 
 `planned.transactions[0]` contains exact immediate `from/to/data/value` and, for
 launch commands, native-ceiling `gas` and current `gasPrice`. Approvals omit both.
 There is no fixed wallet nonce; the wallet assigns it. The plan identity nonce is unchanged.
-The envelope is reusable, but its block-bound admission is historical, not permission
-to sign later. Pass it as `reviewedTransaction` for fresh immediate admission after
+The envelope is reusable, but its block-bound assessment is historical, not permission
+to sign later. Pass it as `reviewedTransaction` for fresh immediate checks after
 review or recovery. This is not a second user review gate.
 Reuse `planned.progress` for the same result's display instead of reading progress
 independently beside the plan.
@@ -373,25 +371,25 @@ never silently rewrite it. A lower caller complete-envelope cap refuses rather t
 shrinking gas. Held prices below the pinned fee floor also refuse without bumping.
 On Nitro the floor is max(ArbGasInfo L2 price, header base fee); twice base fee is
 fresh recommendation headroom only. Reserve value plus ceiling×price, without
-adding poster fees again. Actual activation capacity refusal asks the user to
-reduce positions/pools; a large conservative bound alone is not such a refusal.
+adding poster fees again. An activation budget above the ceiling asks the user to
+reduce positions/pools; this conservative refusal is not proof of actual overflow.
 
 On chain4663, one RPC L2 header pins the invocation. Token prediction, native/token
 balances, allowances, launch progress, Nitro getters and prices share one Multicall3 call
 at that explicit L2 block. Further independent stages use one aggregate, even for
 one or two reads. Multicall3's block-number/hash getters expose L1 values on Nitro
 and must not select the L2 pin.
-The same pin survives salt mining and buy calibration; there are no final chain or
+The same pin survives salt mining and buy protection; there are no final chain or
 canonical-header guard reads. Receipt confirmation/reorg checks remain.
 
-Required native execution validates the exact calldata once; there is no later
-exact-gas replay. Poster allocation comes from the same-review price tuple and a
-local size bound, not a per-transaction oracle. Build-next encodes only its canonical
-next command, preserving normal/UFG calldata and original/clipped batch spans.
+Poster allocation comes from the same-review price tuple and a local size bound,
+not a per-transaction oracle. Build-next encodes only its canonical next command,
+preserving normal/UFG calldata and original/clipped batch spans. It does not
+execute conversion or activation calldata or read/assign a wallet nonce.
 
-Multicall3 runtime, Nitro backend capability and account-code observations are
-retained for the caller's session. Chain identity is observed once per bound client;
-recreate the client on chain changes. Financial state and required proof stay fresh.
+Multicall3 runtime and static preset observations are retained for the caller's
+session. Chain identity is observed once per bound client; recreate the client
+on chain changes. Financial state, funding allowances and capacity checks stay fresh.
 The 4663 preset uses the deployed `hookSaltMiner`; returned salts are verified
 locally. Its deployed `launchLens` supplies dependent progress, market, balance
 and hook-mining reads in the same initial aggregate. Callers need no lens
@@ -655,6 +653,69 @@ exit fee; this is not a guaranteed USD floor. Accrued pool fees are not collecte
 backing. Inspect collection failure events as well as receipt success; a fork check
 needed at least 750k gas for `collect()`, not a universal mainnet gas limit.
 
+## Configure Raeto
+
+Raeto is a constrained **fee-sharing offering**, not a UFG treasury or a redemption
+contract. Select `V4RaetoFixedPool` (fixed maximum hook fee) or
+`V4RaetoDynamicPool` (minimum/maximum/sensitivity schedule). The hook creation
+bytes are identical to the ordinary zero-royalty fixed/dynamic templates; the
+Raeto collector, factory, locker, adapter and frozen terms are different.
+
+```ts
+import {
+  getKnownLifecycleProfile, KnownLifecycleProfile, RAETO_QUOTE_ASSETS,
+  RAETO_SHARE_BPS_OPTIONS, encodeRaetoLaunchTail, validateRaetoLaunchPlan,
+  type RaetoLaunchConfigV1,
+} from "@black-market/sdk/lifecycle";
+
+const preset = getKnownLifecycleProfile({
+  chainId: 4663, orchestrator: "0x91560876033d568d25CDe98C78c33ff8FC43962c",
+  key: KnownLifecycleProfile.V4RaetoFixedPool,
+})!;
+const raetoLaunchConfig: RaetoLaunchConfigV1 = { shareBps: 500 };
+console.log(preset.profile.id, RAETO_QUOTE_ASSETS, RAETO_SHARE_BPS_OPTIONS,
+  encodeRaetoLaunchTail(raetoLaunchConfig));
+// Add raetoLaunchConfig to the market's V4PoolBoundLifecycleMarketConfigV6.
+// Once all markets are built: validateRaetoLaunchPlan(plan).
+```
+
+Every Raeto-route market must use its Raeto config6 profile/adapter, **WETH or
+USDG**, `feeMode: 1` (QuoteOnly), `lpFeePips: 0`, and `developerFeeBps: 0`.
+One V4 market per quote means at most two Raeto markets, with at most 32 total
+positions. Preserve normal token/reward choices and fee-asset policies; no UFG
+proxy, treasury, special nonce, or UFG funding approvals are involved.
+
+Set `raetoLaunchConfig.shareBps` to **500, 1000, 2500, 5000, or 7500**.
+The 5% floor cannot be disabled. **1234, 8000 and 10000 are not deployed options**,
+even though a newer local contract source accepts a wider range. This release
+pins the deployed five-item menu, proved by read-only calls to both live factories
+at block 101,180,179. The encoder appends exactly one canonical 32-byte uint16
+word; missing/extra/mixed HMM/UFG/auto-compounding tails reject.
+
+Use `validateRaetoLaunchPlan(plan)` for the exclusive Raeto route; it rejects
+every non-Raeto or malformed market with `INVALID_RAETO_PLAN`. Config/tail and
+market fee/quote errors use `INVALID_RAETO_CONFIG`. Then use the ordinary
+`prepareAndPlanLifecycleLaunch` / `buildNextTransaction` flow. A share change
+changes the full plan hash, but Raeto's hook-constructor commitment hashes only
+the zero-salt V6 prefix, not the collector share. Always re-review changed plans.
+
+At collection the collector books `floor(post-treasury quote fees × shareBps /
+10000)` as Raeto credit and forwards the remainder into the normal fee hub.
+The **current fee owner** can call `setShareBps` with another menu value,
+including immediately before collection; that selection applies to all
+uncollected fees. Collection does not pay or consult the payout registry.
+Anyone can call `claimRaeto(quoteAsset)` to pay the registry's **current** payout,
+not a caller-selected recipient. Donations are not fee revenue or Raeto credit.
+Use `raetoFeeCollectorV1Abi` for `shareBps`, `owed`, token/quote getters, the
+share/claim methods and `RaetoShareUpdated` / `RaetoFeesBooked` /
+`RaetoFeesClaimed`. [Reference and preserved deployment evidence](reference.md#raeto-profiles)
+identify the payout registry and profile/adapter IDs.
+
+Both variants use the measured v4 capacity model, with deterministic preparation
+batches, exact local opening-buy quotes and the unchanged native 32M total gas
+ceiling. A ready assessment is a budget/input check, **not execution proof**.
+See [gas evidence](lifecycle-gas-profiles.md#raeto-and-auto-compounding-v4-evidence).
+
 ## Configure auto-compounding
 
 Select `V4AutoCompoundStaticPool` for a fixed hook fee or
@@ -691,11 +752,16 @@ include the recorded readback and read-only verification command.
 
 The hook owns its new full-range liquidity permanently; the non-compounding
 remainder follows the launch's normal fee-asset policies. It burns the allocated
-launch-token fees and uses quote fees to buy and compound. Every post-opening swap
-performs compounding in `afterSwap`; insufficient gas reverts with
-`CompoundOutOfGas()` rather than silently skipping work. Do not cap swap gas below
-`eth_estimateGas`. Launch transactions retain the SDK's native ceiling; these new
-templates require exact execution admission, not uncalibrated fixed-hook capacity bounds.
+launch-token fees and uses quote fees to buy and compound. During launch,
+`_attemptCompound` defers until `openingCompletedAt` is set **after all opening
+buys**, so the local ordered opening-buy curve remains exact. Post-opening swaps
+can compound in `afterSwap`; the hook's low-gas guard reverts `CompoundOutOfGas()`.
+Do not cap swap gas below `eth_estimateGas` or treat launch bounds as swap limits.
+Launch transactions now have measured static/dynamic capacity and preparation
+costs retained in `robinhood-4663-capacity-v5`, not ordinary fixed-hook guesses. They retain
+the native 32M total gas ceiling and never execute calldata during planning.
+See [the fork matrix and ArbOS caveat](lifecycle-gas-profiles.md#raeto-and-auto-compounding-v4-evidence).
+
 
 <a id="0100-release-hmm-v2-only"></a>
 ## Configure HMM V2

package/docs/lifecycle-gas-profiles.md

@@ -1,6 +1,6 @@
 # Lifecycle gas, capacity, execution evidence and RPC budgets
 
-Version 0.15.0 separates the native transaction ceiling, conservative capacity bounds, exact curve quotes and actual execution proof. A local quote or submitted hash is not an execution receipt.
+Version **0.16.1**, model **`robinhood-4663-capacity-v5`**, separates the native transaction ceiling, conservative capacity bounds, exact opening-curve quotes and actual transaction receipts. A ready assessment is not execution proof.
 
 ## One native ceiling, not component-sized gas
 
@@ -12,43 +12,192 @@ A reviewed launch gas differing from the ceiling is stale and refuses with `STAL
 
 ## Capacity selects the mode, not the gas limit
 
-`computeLifecycleLaunchGasBounds({ plan, predictedToken, ufg?, headroomBps? })` returns conservative `atomicComputeGasUpperBound` and `activationComputeGasUpperBound`, excluding poster gas, or undefined for unknown coverage. The versioned model accounts for token/reward creation, actual UFG proxy/treasury route, market/position work, ordered buys, NFT minting and HMM forwarding overhead. UFG route overhead is independent of market profile names.
+`computeLifecycleLaunchGasBounds({ plan, predictedToken, ufg?, headroomBps? })` returns conservative `atomicComputeGasUpperBound` and `activationComputeGasUpperBound`, excluding poster gas, or undefined for unknown coverage. The v5 model retains v4 coverage for Raeto fixed/dynamic and current auto-compounding static/dynamic in addition to the existing Abyss, V4, HMM and UFG templates. It accounts for token/reward creation, actual UFG proxy/treasury route, measured market/position work, ordered buys, NFT minting and HMM forwarding overhead, and adds atomic conversion work. UFG route overhead is independent of market profile names.
 
-An atomic request is a preference. A conservative atomic bound plus poster allocation above the ceiling selects staged; explicit staged remains staged. An actual atomic capacity failure can also select staged with fresh full-sequence admission. Review and persist returned `planned.mode`, not the requested mode. No positions, markets or buys are dropped.
+An atomic request is a preference. Multiple markets always select staged; one known-profile market can remain atomic, including conversion funding, only when its padded compute bound plus poster allocation fits. Explicit staged remains staged. Review and persist returned `planned.mode`, not the requested mode. No positions, markets or buys are dropped, and the gas envelope is never resized.
 
-A large conservative activation upper bound is uncertainty, not proof of overflow. Uncertain activation receives exact full-sequence execution before begin. An actual activation capacity failure returns `capacityConstraint: "activation"` and asks the user to reduce positions/pools; staging cannot split activation. For example, an independently observed24-position activation fit32M despite a larger conservative upper bound, while a32-position deep Abyss activation needed a47.48M minimum successful envelope. Neither observation licenses a universal count-only hard cap.
+Preparation greedily packs contiguous markets using measured per-template/per-position costs, full calldata processing and padding. Activation cannot split. An activation bound plus poster allocation above 32M refuses before begin with `ACTIVATION_GAS_LIMIT`; an unknown profile refuses with `UNKNOWN_GAS_PROFILE`. A conservative refusal is not proof the actual transaction would overflow, but there is no simulation or execution fallback.
 
-## Which admission path runs
+### Atomic conversion reserve (v5)
 
-| Command | Covered direct plan with proven-fit activation | Plan containing an aggregator conversion |
-| --- | --- | --- |
-| Approval/reset | Wallet prepares gas/fees | Wallet prepares gas/fees |
-| Begin | Conditional template admission | Exact native execution of the conversion |
-| Prepare markets/hooks | Conditional template admission | Conditional admission when isolated after begin |
-| Activate and opening buys | Conditional admission and exact local curve math | Exact native execution consuming conversion funding |
-| Atomic launch | Conditional admission and exact local curve math | Exact native execution of the complete transaction |
-| Cancel | Conditional admission | Conditional admission when isolated |
-
-A conversion review proves the complete staged sequence through activation in one validated `eth_simulateV1` call, with every launch call at32M. Unknown template/currency coverage, another chain/ArbOS epoch or uncertain activation also uses real execution. A refused full review cannot authorize a new begin from a successful prefix; already-started recovery and cancellation remain available. Explicit `simulateLaunchPlan` always requests execution. A generic EVM fork is not Nitro protocol proof.
+Funding escrow executes every `Swap` during begin, including the begin inside
+`launchAtomic`. For an atomic command, add **2,000,000 compute gas per Swap funding
+entry** to the existing template basis. Count entries independently, regardless
+of input token, native input or router address. Then apply the existing rule:
 
-Unknown curve behavior retains a separate provisional, unvalidated buy-output diagnostic at the same ceiling before protecting minima. It is not gas sizing, final admission or a retry. The final protected commitment still requires its exact execution. There is no SDK-invented50M aggregate window; explicit `maxSimulationGas` policies remain enforced against complete observed work without prefix admission.
-
-### Honest result fields
+```text
+basis = existing template work + 2,000,000 × Swap funding count
+compute bound = max(
+  ceil(basis × (10,000 + max(2,500, headroomBps)) / 10,000),
+  basis + existing HMM forwarding reserve
+)
+```
 
-- Conditional admission: `backend/confidence: "profiled"`, `executionProof: "not-run"`, `protocolFit: "profiled"`. `gasProfile` carries `version`, capacity `bounds` and local `initialBuys`, not per-step estimates or fabricated receipts.
-- The immediate fixed-ceiling budget is `simulation.estimate`, with `feeConfidence: "native-ceiling-and-data"` and no invented `gasUsed`. Approval budgets are absent.
-- Successful exact native execution reports `backend: "eth_simulateV1"`, `executionProof: "proved"`, `protocolFit: "proved"` after required postconditions.
-- Only an immediate launch command receives final gas/price/estimate/admission. Exact suffix steps remain `provisional: true` with no executable estimate. Build-next constructs only the canonical next command at a fresh pin; it never treats a suffix observation as an estimate.
+Existing full encoded-calldata processing, token/reward creation, fee-asset,
+position and buy costs remain in the basis. Nitro poster allocation is added
+only for the fit comparison; it remains inside the unchanged32M envelope.
+Staged activation excludes the conversion reserve because its funding already
+executed during begin; begin still uses the full native ceiling. ERC20-input
+approvals remain wallet-prepared and are refreshed before the atomic command.
+
+The2M coefficient is a bounded empirical planning reserve for the current
+conversion path, not a universal upper bound on arbitrary admitted router code,
+route complexity or future upgrades. Calldata's structural bound alone does not
+bound external execution work. A fit is not simulation or execution proof.
+Input/target/spender admission, exact funding value, committed output floors and
+deadlines remain wallet/on-chain responsibilities. Unknown launch templates
+still refuse; larger atomic budgets select staged, and oversized unsplittable
+activation budgets refuse before begin. Planning and fresh build-next apply the
+same model and never simulate launch calldata or read wallet nonces.
+
+## What planning does, and does not prove
+
+Planning and build-next read one pinned input/progress snapshot, compute exact local opening-buy outputs, check deterministic capacity and check affordability. They **never execute launch calldata**, including for conversion funding. The real router enforces its committed conversion floor/deadline when the user submits the transaction.
+
+| Command | Planning/build-next behavior |
+| --- | --- |
+| Approval/reset | Discover allowance; wallet owns gas preparation. |
+| Begin | Check inputs, complete activation capacity and full-ceiling affordability. |
+| Prepare markets/hooks | Pack deterministic contiguous batches and check their budgets. |
+| Activate and opening buys | Check unsplittable activation capacity and exact local ordered-buy floors. |
+| Atomic launch | Require one known-profile market whose padded compute, including each Swap reserve, plus poster fits. |
+| Cancel | Build from canonical progress; no new profile capacity requirement. |
+
+Check `planned.assessment.ready`, `code`, `reason`, optional `capacityConstraint`,
+`assessment.estimate` and `assessment.gasProfile`. The gas profile contains
+`version`, capacity `bounds` and exact local `initialBuys`, never invented
+`gasUsed`. Launch commands use the native ceiling; approvals omit gas/fees.
+Only actual included receipts and canonical Active/public-market state establish
+execution. The owned fork harness below exercises the real contracts separately;
+it is never selected as a planning backend.
 
 ## Retained empirical evidence
 
-`robinhood-4663-arbos61-v1` covers shipped Abyss configuration-v1 and the calibrated fixed/dynamic V4 configuration-v6 templates, including HMM/UFG, on ArbOS61 with an EOA payer and known release quote implementations. Auto-compounding presets are not covered by these capacity bounds and require exact execution. This is capacity coverage, not a currency admission allowlist. Unknown currencies remain supported through exact execution; smart-account proof is not claimed.
+The v5 model retains the v4 [Raeto and auto-compounding measurements](#raeto-and-auto-compounding-v4-evidence) and adds the conversion reserve described above. Recorded v4 smoke evidence keeps its original version and is not rewritten as new execution evidence. These are empirical capacity bounds, not gas-limit sizing, a promise about arbitrary upgrades/future ArbOS rules, or native execution proof. Currency admission is separate: only Raeto imposes its deployed WETH/USDG quote allowlist.
 
 Research retained176 lifecycle receipts, including75 successful current-template atomic/activation observations with opening buys. Isolated forks extend depth, buys and combinations; failed CREATE2 cases were not counted as successful coverage. One Abyss and one fixed-V4 historical native/fork calibration matched compute exactly (19,272,603 and18,130,251 gas), while minimum successful envelopes were higher (20,527,230 and19,356,279). These two calibrations do not establish general Anvil/Nitro equivalence. Compute and poster components remain separate. Profiles are empirical capacity bounds, never transaction gas sizing or proof about arbitrary upgrades/future ArbOS rules.
 
+## Raeto and auto-compounding v4 evidence
+
+`test/integration/template-gas.fork.mjs` owns an explicitly supplied loopback
+Anvil on **8571** and accepts only its unlocked default development account.
+It never loads a key or sends to mainnet. Each case snapshots/reverts the fork
+and executes real SDK-produced calldata against the admitted deployment graph.
+The matrix retains full portable plans and receipts' transaction hashes,
+block numbers, `gasUsed`, characterization envelopes, calldata sizes,
+Anvil minimum-gas estimates and separate 32M `eth_call` fit results in
+`test/fixtures/template-gas-matrix.json`. Separate read-only SDK planning/build-next
+assessments, referencing those retained real executions without replaying them,
+are in `test/fixtures/template-gas-smoke.json`.
+The creator/token identity may repeat across **isolated, reverted** cases, and
+identical CREATE2 preimages reuse the SDK's deterministic mined salt. This avoids
+unnecessary new empty-slot archive queries without retaining any launch state
+between experiments. Complete plans identify the exact identity used in every
+observation. The harness verifies the source pin and Anvil version and always
+skips any scenario already recorded. The final missing-case selection covers
+boundary depths/buys/market counts rather than repeating a redundant Cartesian
+interior. Earlier valid observations remain in the evidence unchanged.
+
+The source block/hash and Anvil version are recorded per run. Public RPC pruning,
+rate limits and archive backend failures are not execution failures; the final
+missing cases use a configured Alchemy archive. Its credential-bearing URL is
+never logged or committed; evidence identifies the provider only as `alchemy`.
+The synthetic economics ($5,000 FDV, WETH $3,000 / USDG $1) are explicit test
+fixtures, not a live pricing recommendation.
+Single-position recipes and adjacent 8-position distributions use SDK helpers;
+an explicit adjacent 32-band fixture reaches the templates' structural maximum
+without changing the public distribution catalogue's 2–16-position API.
+Two-market cases divide at most 32 **total** positions between WETH and USDG.
+Raeto cannot have a third V4 market because those are its only allowed quotes.
+
+Anvil does not implement ArbOS precompiles. The harness reads
+`ArbGasInfo.getPricesInWei` from the real native chain through the configured
+archive at the fork's source pin. For read-only LaunchLens planning snapshots,
+an `eth_call`-only ArbSys override maps `arbBlockNumber()` / `arbBlockHash(uint256)`
+to Anvil's actual `NUMBER` / `BLOCKHASH` environment; it does not invent balances,
+progress, addresses or protocol results. No deployed launch code/storage is
+overridden and no measured launch is replayed by that smoke. All launch execution
+uses the ordinary fork contracts.
+USDG fixture funding is an ordinary deployed-token transfer from the fork's
+real PoolManager balance, using fork-only impersonation; protocol code/storage
+is not replaced. Characterization uses 100M gas to measure without assuming fit,
+and separately calls the exact launch at 32M. The read-only profiled smoke checks
+the SDK's actual 32M next-command envelope without re-executing a retained case.
+**Anvil compute and successful local 32M calls are not native ArbOS/poster proof.**
+
+The committed run contains **84 real launches / 186 successful launch
+transactions** at Robinhood block **101,180,179**
+(`0xe778e5d89ca2cab5843eedeb8c27b10f5463313d4b95b8971986ac72e297933c`):
+59 retained observations plus 25 approved missing boundary cases. No retained
+case was replayed. Depths are 1/8/32 total positions, one/two markets and
+0/1/4 ordered buys, with both Raeto quotes and both auto-compound fee modes.
+
+Observed peak EVM `gasUsed`, in millions (preparation columns distinguish batch size):
+
+| Template | Cases | Atomic max | Prepare 1 market max | Prepare 2 markets max | Activation max |
+| --- | ---: | ---: | ---: | ---: | ---: |
+| Raeto fixed | 42 | 41.664 | 11.222 | 17.831 | 22.228 |
+| Raeto dynamic | 22 | 41.694 | 11.186 | 17.804 | 22.332 |
+| Auto-compound static | 10 | 41.285 | 10.694 | 16.874 | 22.403 |
+| Auto-compound dynamic | 10 | 41.369 | 10.753 | 16.992 | 22.445 |
+
+The 32-position atomic extremes exceed 32M and select staged; their
+activations fit. All measured one/eight-position atomic cases fit, including
+several buys. `test/template-gas.test.mjs` requires every transaction's observed
+gas **and** Anvil forwarding estimate to fit its model bound, at least 5%
+observed-gas margin, and a bound below 32M whenever the observation fit that
+ceiling. Begin uses the native 32M budget rather than a fabricated estimate.
+
+V4 template coefficients below are compute basis, before at least **25%**
+padding (or larger requested headroom), calldata processing and applicable
+token/reward/NFT/fee-asset work. Existing offerings' coefficients are unchanged.
+
+| Component | Raeto fixed/dynamic | Auto-compound static/dynamic |
+| --- | --- | --- |
+| One-market atomic base | 18,000,000 | 18,000,000 |
+| Atomic extra position | 600,000 | 600,000 |
+| Activation call base | 1,500,000 | 1,500,000 |
+| Activation per market | 500,000 | 750,000 |
+| Activation per position | 500,000 | 500,000 |
+| Preparation per market | 9,300,000 | 8,900,000 |
+| Preparation extra position | 70,000 | 70,000 |
+| Each opening buy | 500,000 + 25,000 × that market's positions | Same |
+
+The per-buy position term matters: at 32 positions the measured marginal
+exceeds 1M gas per buy, so inheriting the ordinary flat 0.5M would understate
+larger buy sequences. Full calldata contributes 24 gas/byte and fee assets
+100,000 each before padding. `computeLifecycleLaunchGasBounds` remains the
+consumer API; coefficients are not transaction gas limits.
+
+Auto-compounding's `_attemptCompound` exits for `Opening` before its 80k
+low-gas guard whenever `_openingCompletedAt == 0`. The orchestrator executes all
+ordered `_buy` calls before `_openMarkets`; opening completion is the terminal
+market boundary. The harness checks exact quote spend/token outputs against
+`InitialBuyExecuted`, every opening deferral, no `CompoundExecuted`, and
+opening-completed event ordering. Therefore launch activation needs no
+post-opening compounding forwarding reserve; HMM's separate reserve stays intact.
+These launch constants are **not** gas limits for post-opening swaps.
+
+```sh
+# In each terminal, source the existing credential environment without printing it:
+source ~/.config/robinhood-archive-rpc.env
+export ROBINHOOD_ARCHIVE_RPC_URL
+# Terminal 1; stop Anvil when finished:
+anvil --fork-url "$ROBINHOOD_ARCHIVE_RPC_URL" \
+  --fork-block-number 101180179 --chain-id 4663 --port 8571 --host 127.0.0.1 \
+  --hardfork cancun --gas-limit 120000000 --quiet
+# Terminal 2, in the worktree (source/export the environment here too):
+pnpm build
+TEMPLATE_FORK_RPC_URL=http://127.0.0.1:8571 \
+  node test/integration/template-gas.fork.mjs
+# Read-only assessment of retained executed plans; no launch replay:
+TEMPLATE_FORK_RPC_URL=http://127.0.0.1:8571 \
+  node test/integration/template-gas.fork.mjs --smoke
+```
+
 ## Exact ordered opening-buy math
 
-`computeLifecycleOpeningBuys({ plan, predictedToken })` follows all liquidity bands, prior buys, initialized zero-net ticks, bitmap boundaries, both currency directions, LP/opening-hook fees, partial fills and integer output floors. HMM opening work occurs after initial buys. V4's zero price-limit sentinel resolves locally to the contract-defined directional limit without changing calldata; Abyss still rejects zero.
+`computeLifecycleOpeningBuys({ plan, predictedToken })` follows all liquidity bands, prior buys, initialized zero-net ticks, bitmap boundaries, both currency directions, LP/opening-hook fees, partial fills and integer output floors. HMM opening work occurs after initial buys. Auto-compounding defers until opening completes, after all initial buys; Raeto reuses the ordinary fixed/dynamic fee curve. V4's zero price-limit sentinel resolves locally to the contract-defined directional limit without changing calldata; Abyss still rejects zero.
 
 Covered `buySlippageBps` protection uses `floor(tokenOut * (10000 - bps) / 10000)`. A zero floor rejects, never becomes1. Independent parity matched token output, quote spent and final square-root price across97 native/fork cases, including both directions, overlapping bands and gaps. Portable historical vectors and focused rounding/sentinel cases live under `test/fixtures/lifecycle-opening-buys.json` and `test/lifecycle-opening-buys.test.mjs`. These conditional curve quotes do not prove conversion, funding or wallet submission.