Mayavi
Scenarios
EVMlaunch_replay

Real-launch vesting-cliff replay

Forks at the cliff block of a real token launch and simulates aggregate sell pressure to compare against on-chain truth in the post-cliff window. Defaults reproduce the canonical ENA 2025-04-02 first cliff; analysts override per-field to replay other launches. Sprint 4-A1i follow-up #1 PR-B wires every field the scenario builder consumes (#114 array-of-primitives + #115 array-of-tuples plumbing) — all defaults match `mayavi/scenarios/launch_replay_ena.yaml`.

Run inputs
Top-level scenario parameters; written to the runs row alongside the persisted lifecycle state.

Scenario instance label persisted with the run row.

Scenario params
Per-scenario fields generated from the JSON-Schema published at GET /scenarios/{type}.

Token contract address being replayed (default: ENA).

Block at which the cliff lands (typically a few blocks past fork_block so the build phase sees state pre-cliff). Default: ENA's 22181090 (2025-04-02 12:00 UTC, derived from the fork anchor + ~1090 blocks).

Total token amount unlocked at the cliff (in wei / smallest unit). Default: 200,000,000 ENA (18 dec) — the conservatively sized liquid share of ENA's 1-year cliff.

Synthetic recipient EOAs that get the cliff unlock distributed via recipient_share_bps. Default: a single placeholder EOA matching the ENA YAML's aggregated-recipient simplification.

Per-recipient share in basis points; must sum to 10000 and match recipient_addresses length. Default: [10000] (single recipient holds 100%).

Per-pool [label, address, fee_bps] tuples. The first pool is the trade pool (recipients sell into it); additional pools are tracked for cross-pool comparison only. Default: ENA/WETH 30bps Uniswap V3 pool.

label
address
fee_bps

Counter-asset for the cliff sells (default: WETH).

Sell-rate exponent for the recipient agents (0 = uniform drip; >1 = front-loaded panic; <1 = back-loaded patience).

Step at which recipients first see their unlocked balance.

Minimum acceptable fraction of the Quoter-fair output; swaps with worse expected slippage skip and record a no-quote failure.

Cancel