Currently in private alpha · For VC analysts & protocol teams

Tokenomics simulation,
bit-exact with mainnet.

Drop in any token contract. Run the vesting cliff, stress-test the cohort cascade, replay a historical incident. Get a defensible report in under two minutes — powered by real Solidity executing against forked mainnet state, not Python re-implementations.

Request access See the proof →
5/5 swaps bit-exact vs Uniswap V3 Quoter
+0 bps delta replaying historical mainnet swaps
~20s end-to-end vesting cliff scenario

Two scientifically distinct credibility proofs.

Existing tokenomics tools either re-implement protocol logic in Python (cadCAD, radCAD, Machinations) or sell only enterprise (Gauntlet, Chaos Labs). Mayavi’s engine runs actual revm against actual mainnet state — and we publish the receipts.

PROOF 1 · Static-call equivalence

Engine matches Uniswap’s own simulation oracle.

We call the on-chain Uniswap V3 Quoter contract for each test swap and assert our forked engine produces the exact same amountOut. Zero delta on every swap. Reproducible by anyone with an RPC URL.

$ mayavi validate

Mayavi engine bit-exact validation
============================================================
  [PASS] USDC->WETH 10k @ 0.05% pool   out=        3.8975  delta=  +0
  [PASS] USDC->WETH 100k @ 0.05% pool  out=       38.9682  delta=  +0
  [PASS] WETH->USDC 5 @ 0.05% pool     out=   12,815.5390  delta=  +0
  [PASS] WETH->USDC 50 @ 0.05% pool    out=  128,128.8483  delta=  +0
  [PASS] WETH->USDC 1 @ 0.30% pool     out=    2,556.1348  delta=  +0
============================================================
  PASS  5/5 swaps bit-exact with on-chain Quoter.
  Engine is provably equivalent to mainnet EVM.
PROOF 2 · Real-world replay

Real on-chain swap, replayed on a fork. Same output.

We pick a random historical Uniswap V3 swap, fork at block−1, and re-execute the original transaction with the original calldata from the original wallet. Bit-exact match. No synthetic inputs — this is the actual chain history.

$ mayavi replay --block 15000000

Replay of 1ee991c7...07f343 (block 15,000,000)
  from:           0x382f024BeB47676f4034Becb90565584d1B776Cd
  pool:           0x69D91B94f0AaF8e8A2586909fA77A5c2c89818d5
  actual out:                      1,797,413,272
  simulated out:                   1,797,413,272
  delta:                                      +0 (+0.0000 bps) [BIT-EXACT]
No other open-source tokenomics engine publishes a comparable equivalence proof. The closed competitors (Gauntlet, Chaos Labs) do this internally and charge $1.6M+/yr. We open the receipts so quants can audit before they trust.

The scenarios VCs and protocol teams actually ask for.

SHIPPED

Vesting cliff sell pressure

N heterogeneous recipients with sampled urgency profiles unlock at the cliff and route real swaps through the deepest WETH/USDC pool. Each recipient’s schedule is power-law tilted (TWAP, panic seller, patient drip-feed). Outputs cumulative price impact + per-recipient realized USDC.

$ mayavi run vesting_cliff.yaml
  swaps:     200 successful
  realized:  $25,630.49 USDC
  report:    data/reports/report_xxx.html
SHIPPED

Multi-cohort cliff collision

Real launches have team + seed + advisors with different unlock dates. Mayavi models each cohort separately so you can see what happens when team and seed unlocks land in the same week. Cohort-level breakdowns + peak-step impact KPI surface the worst moment for the protocol.

$ mayavi run multi_cohort.yaml
  swaps:     436 successful (33 recipients)
  realized:  $125,566.85 USDC
  cohorts:   team / seed / advisor breakdown
SHIPPED

Gymnasium env + cloud-GPU PPO

Wrap any liquidation decision as a gymnasium.Env and train a PPO policy with Stable-Baselines3. Same code runs on a consumer GTX 1650 and on Modal A10G — one modal run command swaps you to cloud.

Local GTX 1650:  FPS=140, 14s wallclock
Modal A10G:      FPS=298,  6s wallclock
Pipeline parity: 0 code changes
SHIPPED

Aave V3 leveraged borrower — PPO vs baselines

Real Pool, real interest accrual, real liquidation math. PPO trained 50,000 timesteps on Modal A10G ($0.14 actual GPU spend) against a 10-WETH supply / $7k-USDC borrow on the deployed Aave V3 Pool at block 19M. Scored against noop and repay_all baselines on the same fork over 32 deterministic eval episodes per strategy. Receipts: aave_ppo_v1_2026-05-04.json, methodology in docs/validation.md § 1b.

$ mayavi train aave_borrower --remote modal
  noop:       -0.0761%  (interest compounds on debt)
  ppo (50k):  +0.0713%  (+14.7 bps vs noop)
  repay_all:  +0.0899%  (analytical near-optimum)
  ppo captures ~79% of optimum at $0.14 cloud cost.
PHASE 2

Adversarial multi-agent training

Train a vesting agent against a learned MEV searcher and a learned oracle manipulator. This is where RL meaningfully beats TWAP — TWAP becomes exploitable, and the principal must adapt.

PHASE 2

Bonding curves & ve-token staking

Stress-test bonding curve dynamics, ve(3,3) inflation, gauge weight rotation. Same engine, new agent library.

SHIPPED

Stablecoin depeg → CDP cascade

Multi-agent stress test: N leveraged WETH-long Aave V3 borrowers (configurable, default 5 at HF ≈ 1.28) plus a liquidator wallet running one LiquidatorAgent per borrower. A one-shot OracleShockAgent spikes the AaveOracle USDC price (default $1.50, 50%) at a configurable step; borrowers' HF crashes below 1.0 and the cascade fires liquidationCall for real on the deployed Pool. Report ships borrower-cascade-index + cumulative-seizure-USD KPI charts. Methodology in docs/validation.md § 1c.

$ mayavi run mayavi/scenarios/depeg_cascade.yaml
  borrowers:    5      (HF~1.28, WETH-long)
  shock:        step 3, USDC -> $1.50
  liquidations: cascade fires next step
  report:       cascade KPIs + per-step pool tick
SHIPPED

Real-launch vesting-cliff replay — ENA

Sim-to-real validation against actual token launches. Ethena (ENA) first major cliff at block 22,180,000 (Apr 2 2025) replayed against on-chain Uniswap V3 DEX outflow over the 24h post-cliff window; per-pool delta asserted < 30% per the Phase 2 honest-posture rule (target ≤10%, acceptance ≤30%, above 30% documents a Phase 3 gap rather than tightens the tolerance). Wormhole (W) was scoped out: deepest W/WETH liquidity sits on Solana and Base, well below the $1M Ethereum-mainnet TVL threshold the comparison needs — reintroduction is queued behind cross-chain replay support. Full rationale in docs/validation.md § 3.

$ mayavi run mayavi/scenarios/launch_replay_ena.yaml
  fork_block:    22,180,000  (Etherscan-verified)
  cliff_block:   22,181,090  (2025-04-02 12:00 UTC)
  pool:          ENA/WETH 0.30% Uniswap V3
  gate:          delta_pct < 0.30 (24h cumulative outflow)

Built on real EVM, not Python re-implementations.

Execution kernel

pyrevm · the official Python bindings for Paradigm’s revm. Every token transfer, every Uniswap math op, every SSTORE runs through actual Solidity bytecode at the pinned mainnet block.

Agent framework

Hand-rolled PSUB scheduler · ~200 LOC, deliberately small. Heterogeneous agent populations (vesting recipients, arbitrageurs, MEV searchers) registered into one scheduler with seeded RNG for byte-identical replay.

RL / ML

gymnasium + Stable-Baselines3 + Modal · Single-agent envs train on consumer GPU; same code retargets to A10G/H100 on Modal for parallel rollouts. FPS=298 on A10G via snapshot/revert pattern.

Reports & data

Streamlit + Plotly + DuckDB + Jinja2 · Sliders for live exploration; branded HTML report with embedded charts; results streamed to DuckDB for analytical queries. PDF via browser print — no headless-Chrome plumbing.

Validation

Bit-exact against Uniswap V3 Quoter · Bit-exact replay of mainnet history. Both checks ship as mayavi validate and mayavi replay CLI commands; pin them in your CI to catch regressions.

Engineering posture

512 unit tests on every push, 5 layered coverage gates green (sim 90% / agents 99% / svm 94% / chains 100% / api 95%, all above their per-layer floors). mypy strict across 151 source files, ruff clean, GitHub Actions CI on every push, nightly fork-test cadence.

Request access · Private alpha

Get a token DD walkthrough.

30 minutes on a video call. Bring a token contract address; leave with a branded HTML report covering the cliff cascade and the worst-moment single-step impact under the cohort distribution you describe. No charge for first three pilots.

Pre-launch token projects, AI-x-crypto agent platforms, and protocol risk teams welcome. Add “Mayavi” to the email subject for fastest response.