Architecture Overview

Contract System

evently is composed of independent smart contracts deployed on MegaETH mainnet.

+---------------------------+
|   EventlyProfiles.sol     |  ← Identity, stats, referrals, swap points
+------------+--------------+
             | reads/writes profile data
+------------v--------------+
|   EventlyMarketsV3.sol    |  ← Prediction markets (LMSR b=200 + CLOB)
|       v3.2 post-audit     |    Pending deployment post professional audit
+---------------------------+

The Markets contract is fully independent — it only reads USDm balances and approvals from the ERC-20 contract. The Profiles contract tracks identity and onchain social layer.

---

Deployed Addresses (Mainnet — Chain ID 4326)

Contract	Address
EventlyMarketsV3	TBD (pending deployment post professional audit)
EventlyProfiles (v1.3)	0x9F0708145BCCD1F5B16F610cB8a75A63fA4A9a24
USDm	0xFAfDdbb3FC7688494971a79cc65DCa3EF82079E7
MegaNames	0x5B424C6CCba77b32b9625a6fd5A30D409d20d997
Admin wallet	0x21CbC99a2E8c68F1C2955991E07c0C22ea895Da1

---

Design Principles

• Pull payment pattern — winners pull funds via redeemWinnings() / claimCancelRefund(); no push transfers that can fail

• Checks-Effects-Interactions (CEI) — state reset before all external calls

• ReentrancyGuard — custom _locked mutex on all state-mutating external functions

• No upgradeability — contracts are immutable; new versions are redeployed

• Transparency — all events emitted for full on-chain auditability

---

EventlyMarketsV3 — Key Architecture

LMSR AMM (b=200 USDm) as market maker of last resort. CLOB (Central Limit Order Book) with bids and asks matched first at price-time priority.

BUY order  → CLOB asks filled first → remainder to LMSR AMM
SELL order → CLOB bids filled first → remainder rests as limit ask
           → OR: sellToAMM() for instant AMM execution

ERC-1155 shares: 1 winning share = 1 USDm at redemption. Solvency guaranteed by LMSR invariant: poolBalance + subsidyDeposited >= total winning shares.

AI audit complete (7 tools, v3.2). No open blockers. Awaiting professional audit (Pashov/CertiK).

---

Gas Configuration (MegaETH-Specific)

MegaETH has near-zero gas costs (~1ms blocks, ~100K TPS). Transaction configuration in the frontend:

maxFeePerGas: 1_000_000n     // 1 gwei
maxPriorityFeePerGas: 0n

---

Off-Chain Infrastructure

Component	Tech	Purpose
Database	Supabase (PostgreSQL)	Market metadata, user profiles, trade history cache
Frontend	Next.js + Tailwind + wagmi	React app at evently.market
Real-time	watchContractEvent (wagmi)	~1ms block polling for live trade feed
Bridge/Swap	LiFi SDK	60+ routes to MegaETH
Market import	Polymarket CLOB API	Live odds comparison