MONUMENTUM / MONUMPROTOCOL SPECIFICATION · V0.2

THE CURVE
IS ALIVE.

A research-stage adaptive elastic market for a native ETH/MONUM pair, implemented as a Uniswap v4 custom-curve Hook for Robinhood Chain.

FIXED SUPPLYREAL RESERVESSAME-SWAP RESPONSEPUBLIC STATE
03CURVE RESPONSES
07CORE STATE VARIABLES
13BOUNDED PARAMETERS
07CANONICAL EVENTS
22PASSING TESTS
512×FUZZ RUNS / CAMPAIGN

00 / EXECUTIVE SUMMARY

Meme markets do not need less energy. They need better curves.

MONUMENTUM is a fixed-supply token paired with native ETH through a custom Uniswap v4 curve. Instead of following one indifferent reserve path, the curve treats concentrated buy flow, concentrated sell flow, and cooling activity as observable state.

Dense buys can activate token-side depth before that same swap settles. Dense sells can activate defensive depth before that same sell settles, retaining more ETH than the baseline constant-product quote. As pressure fades, active token inventory can be recalled gradually within an explicit ETH-backed budget.

The objective is not a fixed price, guaranteed appreciation, or a ban on selling. The objective is a transparent response surface: one market whose marginal curve adapts to the density and direction of participation.

ONE LIVING CURVEABSORB. DEFEND. RECOVER.
01

Same-swap

The current order participates in the response it triggers.

02

Fully backed

Every reserve unit corresponds to a real PoolManager claim.

03

Bounded

Activation, decay, recovery, and fees live inside public limits.

04

Inspectable

State, quotes, transitions, and budgets are available onchain.

01 / DESIGN OBJECTIVES

Preserve the rush. Extend the horizon.

A conventional fixed curve maps reserves to price without remembering how participation arrived. MONUMENTUM adds a bounded pressure state while preserving permissionless execution and user-defined slippage.

01

Narrow extreme entry dispersion

Activate depth during concentrated buys so later orders in the same demand wave do not face an entirely passive curve.

02

Make panic extraction progressively less attractive

Respond to dense sells by deepening token-side inventory and retaining additional real ETH inside the market.

03

Recover without unbacked price engineering

Reclassify inventory slowly only when the potential ETH liability is covered by explicit budget.

04

Keep the token itself simple

No transfer tax, external mint, rebase, blacklist, or wallet-level restrictions are required by the mechanism.

Non-objective: eliminating volatility.

An adaptive curve can change the shape of execution. It cannot guarantee demand, remove drawdowns, prevent losses, or convert speculative participation into certain profit.

02 / SYSTEM ARCHITECTURE

Four components. One canonical reserve state.

The prototype separates the fixed-supply asset, protocol custody, curve logic, and settlement accounting. This limits the token contract's authority and makes the market mechanism independently inspectable.

01 / ASSETMONUM TOKEN

Fixed supply ERC-20. No curve logic in user balances.

02 / CONTROLRESERVE VAULT

Seeds real ETH and MONUM; owns the protocol LP position.

03 / LOGICV4 HOOK

Quotes, activates, recalls, checkpoints, and emits state.

04 / SETTLEMENTPOOLMANAGER

Holds the ERC-6909 claims that back every internal reserve.

Pool constraints

ConstraintPrototype behavior
PairOne managed native ETH / MONUM pool
CurveCustom accounting through a Uniswap v4 Hook
Fee modeDynamic-fee pool flag; Hook configuration supplies the active fee
Liquidity authorityOnly the protocol reserve vault may seed liquidity
External additionsRejected to prevent reserve-accounting bypass
WithdrawalsLocked in the proof-of-concept implementation
Settlement assetsNative ETH and the fixed-supply MONUM token only

The Hook is also the protocol LP receipt token in the prototype. This receipt is accounting infrastructure, not a public promise of redeemability. A production migration design must be specified before any withdrawal path exists.

03 / RESERVE ACCOUNTING

A real token reserve, split into active and inactive state.

The treasury never creates virtual MONUM. It deposits real token inventory into PoolManager through the Hook, then classifies that inventory by its role in the live quote.

SymbolState variableMeaning
EethReserveNative ETH controlled by the Hook and available to settle the managed market.
AactiveTokenReserveMONUM currently participating in the marginal custom curve.
IinactiveTokenReserveReal MONUM held in reserve and eligible for bounded activation.
BcontractionBudgetEthETH liability capacity earmarked for token-side recovery.
HᵦbuyHeatWadDecaying buy-pressure state, bounded between zero and 1e18.
HₛsellStressWadDecaying sell-pressure state, bounded between zero and 1e18.
TlastCheckpointTimestamp from which lazy decay and recovery are calculated.
CANONICAL IDENTITIES
PoolManager ETH claim   = E
PoolManager MONUM claim = A + I

total managed MONUM = active inventory + inactive inventory
reclassification changes state, not total token supply

What activation means

Activation moves real MONUM from I to A as part of a quote. Recall moves real MONUM from A back to I. Neither operation transfers tokens from user wallets, withdraws ETH from the market, or changes the ERC-20 total supply.

NO

External mint

NO

Rebase

NO

Wallet seizure

NO

Unbacked reserve

04 / PRESSURE ENGINE

Measure relative flow, not raw hype.

Buy heat and sell stress are separate decaying state variables. Each order is normalized against the relevant reserve, so the response scales with market depth rather than treating one absolute trade size as universal.

Opposing-flow damping

A sell arriving during buy heat first cancels some buy heat. A buy arriving during sell stress first cancels some sell stress. Only the remaining directional flow can create new pressure and inventory activation.

NET DIRECTIONAL SIGNAL
dampingCapacity = opposingFlow × dampingCoefficient
cancelledPressure = min(oldPressure, dampingCapacity)

directionalShare
  = residualSameDirectionFlow / rawRelativeFlow

actualActivation
  = unconstrainedActivation × directionalShare

This prevents rapid alternating flow from receiving the full benefit of both response directions. It does not claim to eliminate MEV; adversarial ordering remains part of the production threat model.

A

05 / ABSORB DENSE BUYS

The current buy participates in its own response.

The mechanism does not wait for a later block. A buy first contributes to buy heat; the resulting bounded activation is then included in the same transaction's quote.

The unconstrained ratio interpolates between the configured base and maximum release using average heat across the transaction. It is then reduced by the directional share and capped by available inactive inventory.

TRIGGERRelative buy flow
RESPONSEActivate inactive MONUM
TIMINGBefore same-swap settlement
BOUNDHeat, config, direction, inventory
D

06 / DEFEND DENSE SELLS

Make a crowded exit progressively less rewarding.

The current sell enters the stress calculation before its output is determined. Persistent stress is weighted toward pre-existing state so one isolated sell cannot immediately claim the maximum response.

Every seller retains ordinary transaction-level minimum-output protection. The protocol does not block a wallet or change its balance. Instead, the published curve produces a different marginal quote while sell density is high.

Retained ETH is real economic capacity.

The difference between the baseline output and defended output stays in the PoolManager claim. Subject to reserve bounds, that difference is credited to later recovery.

R

07 / RECOVER AS PRESSURE FADES

Fast expansion. Deliberate contraction.

When buy heat and sell stress cool, the target active inventory moves from its hot-market ceiling toward its cold-market floor. Recall is rate-limited, target-limited, inventory-limited, and ETH-budget-limited.

DECAY AND ACTIVE TARGET
buyHeat'    = max(0, buyHeat - buyDecay × dt)
sellStress' = max(0, sellStress - sellDecay × dt)
pressure    = max(buyHeat', sellStress')

targetRatio
  = minActiveRatio
  + (maxActiveRatio - minActiveRatio) × pressure

targetActive = (A + I) × targetRatio

Recalled MONUM remains under Hook control as inactive inventory. ETH remains in its PoolManager claim. The budget is consumed as an accounting liability bound, preventing the mechanism from treating a purely internal reclassification as free economic value.

08 / FEES & RECOVERY BUDGET

Contraction is paid for, not wished into existence.

Unbacked recall can create a predictable before-and-after trade. MONUMENTUM therefore allows recovery only to the extent that its additional ETH liability is covered.

01

Buy fees

ETH-denominated fees collected on buys are automatically credited to the recovery budget.

02

Sell defense

ETH retained relative to the baseline sell quote can become budget without leaving the market.

03

Explicit funding

The vault may earmark already-seeded ETH principal through a public transaction and event.

BUDGET INVARIANT
0 ≤ contractionBudgetEth ≤ ethReserve

budget is never a second ETH balance
budget is a bounded purpose inside the same backed ETH claim

Sell-side fees are accounted in the token input path. They do not become ETH recovery capacity merely because a fee occurred. This distinction keeps the budget denominated in the liability asset it is meant to cover.

09 / QUOTE ENGINE

Exact input, exact output, and a state that moves with both.

Four public quote paths cover ETH-to-MONUM and MONUM-to-ETH in exact-input and exact-output form. Quotes preview elapsed-time changes first, then model the direction-specific pressure response.

PathInput knownOutput knownResponse
Exact-input buyGross ETHCalculated MONUMBuy heat + activation
Exact-output buyCalculated ETHRequested MONUMBuy heat + activation
Exact-input sellGross MONUMCalculated ETHSell stress + defense
Exact-output sellCalculated MONUMRequested ETHSell stress + defense

Why exact-output uses search

Required input affects relative flow; relative flow affects pressure; pressure affects activation; activation changes the quote. The prototype resolves that circular dependency with a bounded monotonic binary search and reverts if convergence is not reached.

QUOTE SAFEGUARDS
requested output < available reserve
input and output remain within implementation bounds
binary search is iteration-bounded
failure to converge reverts QuoteDidNotConverge
execution remains subject to user minimum/maximum limits

10 / SWAP LIFECYCLE

One transaction. Six explicit stages.

01

Preview

Read elapsed time and derive effective cold-state recovery.

02

Checkpoint

Commit decay, recall, budget, and reserve changes.

03

Normalize

Convert the current order to relative reserve flow.

04

Net

Cancel opposing pressure before granting new response.

05

Activate

Move bounded real MONUM into the current marginal curve.

06

Settle

Exchange assets, update claims, and emit canonical state.

No delayed reserve dump.

Buy- and sell-side activation is calculated before the triggering trade settles. The protocol does not wait for a later keeper transaction to react to the order.

11 / TIME & BLOCK SEMANTICS

Same-swap response. Elapsed-time recovery.

Trading responses are synchronous with the triggering swap. Cooling is measured by elapsed seconds, not by assuming a fixed block interval. This prevents chain timing variance from silently changing the intended decay rate.

T₀ / BEFORE SWAPLazy state

Stored state may be older than the current timestamp.

T₁ / CHECKPOINTTime catches up

Decay and eligible recovery are calculated for all elapsed seconds.

T₂ / CURRENT ORDERPressure responds

The current order contributes before its quote is finalized.

T₃ / AFTER SWAPState is public

Updated reserves and pressure are emitted for indexers.

Anyone can call checkpoint(), but no keeper is required for correctness: previewState() derives the same effective state without a write, and every swap checkpoints before execution.

DISPLAY SEMANTICS

With no trade, a venue cannot invent a new historical trade print. A MONUMENTUM interface should show both the last executed price and the current Hook marginal quote so quiet recovery is visible without falsifying candles.

12 / PUBLIC INTERFACES & EVENTS

The curve should be observable without trusting the interface.

Read and control surface

FunctionPurpose
previewState()Read the effective decayed and recovered state without writing.
curveState()Read the last committed storage state.
spotPriceWad()Read the current marginal ETH-per-MONUM quote after preview.
checkpoint()Permissionlessly commit elapsed-time decay and recovery.
quoteExactInput…Preview exact-input buy or sell output against current state.
quoteExactOutput…Preview required input using bounded binary search.
fundContractionBudget()Assign seeded ETH backing to future recovery.
activateInitialTokenLiquidity()One-time activation of seeded token inventory.

Canonical event stream

EventMeaning
InitialTokenLiquidityActivatedInitial active inventory becomes part of the live curve.
CurveCheckpointDecay, recall, reserve state, budget, and marginal price snapshot.
ContractionBudgetFundedExplicit ETH budget was assigned to recovery capacity.
ContractionBudgetSpentRecovery consumed budget and recalled active MONUM.
SellDefenseBudgetEarnedETH retained versus the baseline sell quote became budget.
TreasuryTokenActivatedInactive MONUM was activated for a buy or sell response.
CurveStateAfterSwapCanonical post-swap reserves, pressure, fee, and amounts.

Minimum production dashboard

01Last executed price
02Current marginal quote
03Buy heat
04Sell stress
05Active MONUM
06Inactive MONUM
07ETH reserve
08Recovery budget
09Current activation
10Baseline sell quote
11Defended sell quote
12User slippage bound

13 / PARAMETER SURFACE

Every response has a ceiling, floor, or rate limit.

The following values are the current prototype deployment defaults. They are test inputs—not final launch parameters and not a recommendation.

ParameterPrototype defaultInterpretation
Swap fee3,000 pips0.30% on prototype swaps
Base buy release2,500 bpsMinimum buy-side activation response
Maximum buy release8,000 bpsUpper bound at maximum buy heat
Base sell release0 bpsNo automatic cold-market sell activation
Maximum sell release8,000 bpsUpper bound at maximum sell stress
Minimum active inventory1,000 bps10% target when pressure is fully cold
Maximum active inventory8,000 bps80% target at maximum pressure
Buy sensitivity0.50 WADRelative-flow contribution to buy heat
Sell sensitivity0.75 WADRelative-flow contribution to sell stress
Opposing-flow damping0.75 WADHow strongly opposite flow cancels old pressure
Buy heat decay0.003333 WAD/sApproximately 300 seconds from 1 to 0
Sell stress decay0.001667 WAD/sApproximately 600 seconds from 1 to 0
Recall rate0.001 WAD/sAt most 0.1% of managed supply per second

Prototype allocation

ItemCurrent script defaultStatus
Total token supply1,000,000,000Fixed at deployment
Reserve vault allocation800,000,00080% of prototype supply
Initially active inventory80,000,00010% of vault inventory
Initial recovery budget0 ETHMust be explicitly supplied or earned
Tick spacing60Pool initialization parameter
Initial sqrt price1:1 referenceDeployment input, not a price promise
CALIBRATION REQUIREMENT

Production values require simulation against clustered flow, adversarial ordering, reserve shocks, low-liquidity launch states, sequencer conditions, and multiple volatility regimes. Large maximum responses are not automatically safer because they are more visible.

14 / SECURITY MODEL

Solvency invariants first. Market behavior second.

The prototype assumes PoolManager, the chain, the deployed token, and the configured controller behave according to their contracts. The mechanism must remain solvent and internally consistent even when users choose adversarial trade sizes and sequences.

Threat matrix

ThreatCurrent controlProduction requirement
Unbacked recall arbitrageETH liability budget boundIndependent economic review
Split-order gamingRelative flow + opposing-flow dampingMEV and order-routing simulations
Alternating-direction farmingOpposing pressure is cancelled firstSearch over multi-block strategies
Reserve accounting driftPoolManager-claim invariantsFormal invariant suite and audit
Exact-output non-convergenceBounded search with explicit revertGas and edge-case verification
Malicious external LPOnly controller can add; removal lockedAudited migration and emergency policy
Admin compromiseNarrow one-time setup surfaceTimelock, multisig, monitoring
Oracle manipulationCore curve uses its own reserves, not an oracleUI must not imply external fair value
Sequencer or ordering riskNo claim of preventionChain-specific liveness and MEV review
Interface deceptionOnchain reads and eventsOpen-source canonical dashboard

Explicit reverts

NotController

Unauthorized liquidity or reserve action

InvalidPoolCurrencies

Pair is not native ETH / managed token

InvalidConfiguration

Parameter set violates protocol bounds

LiquidityLocked

Unsupported withdrawal attempt

CurveNotSeeded

Quote or swap before reserve initialization

InsufficientOutputReserve

Requested output exceeds real reserve

InsufficientContractionBudgetBacking

Budget exceeds backed ETH capacity

AmountTooLarge

Input exceeds safe implementation range

QuoteDidNotConverge

Exact-output search failed its bounded solve

15 / GOVERNANCE & DEPLOYMENT

Initialization is powerful. Ongoing control should be narrow.

The reserve vault owns the setup path: it connects to one Hook, deposits real assets, activates initial inventory, and optionally earmarks recovery budget. The Hook address itself is mined with CREATE2 so its permission flags are encoded in the deployed address.

  1. 01
    Validate network

    Require Robinhood Chain ID 4663 and deployed infrastructure code.

  2. 02
    Deploy fixed-supply token and reserve vault

    Production metadata must explicitly use MONUMENTUM / MONUM.

  3. 03
    Mine and deploy the Hook address

    Encode before-initialize, before-swap, delta, and liquidity permission flags.

  4. 04
    Initialize the native ETH / MONUM pool

    Use the dynamic fee flag, configured tick spacing, and declared initial price.

  5. 05
    Seed and verify real claims

    Deposit ETH and MONUM, activate initial inventory, and assert reserve identities.

  6. 06
    Transfer ownership

    Move vault control to the published production timelock and multisig.

Deployment constantPrototype value
Chain ID4663
PoolManager0x8366…0951
CREATE2 deployer0x4e59…956C
Required acknowledgementACKNOWLEDGE_UNAUDITED=true
Hook flagsinitialize + swap + delta + liquidity guards
CONTROL POLICY

The prototype vault is Ownable. Production ownership should be a disclosed timelock plus multisig, with no hidden parameter path and no casual liquidity withdrawal. Any migration or emergency power must be narrow, delayed, documented, and visible before activation.

16 / VERIFICATION & TEST EVIDENCE

The mechanism is implemented. The production claim is not yet earned.

The current Foundry suite contains 22 passing tests, including deterministic scenarios and 512-run fuzz campaigns. These results establish prototype behavior; they do not replace independent audits, formal verification, or public adversarial review.

22PASSING FOUNDRY TESTS
512×RUNS PER FUZZ CAMPAIGN
0CLAIMS OF PRODUCTION AUDIT
Test familyVerified prototype behavior
Reserve backingPoolManager ETH and token claims equal internal reserve accounting.
Same-swap buysThe current buy changes heat and token activation before settlement.
Same-swap sellsThe current sell changes stress and defensive depth before settlement.
Split-order resistanceTwo-way and ten-way dense sell splits do not improve aggregate extraction.
Round tripsImmediate buy/sell and sell/buy sequences do not produce risk-free principal extraction.
Cold recoveryBudget-backed checkpoint recall changes the live marginal quote while preserving claims.
Exact-output pathsQuoted input matches execution for both directions.
Fuzz invariants512-run campaigns cover quotes, split sells, round trips, checkpoints, and token claims.

Evidence still required

  1. Independent review of the custom accounting and reserve identities.
  2. Formalized invariants across every exact-input and exact-output path.
  3. Agent-based simulation across launch, FOMO, panic, and quiet regimes.
  4. Search for profitable multi-block, split-order, and alternating-flow strategies.
  5. Fork validation against final Robinhood Chain infrastructure.
  6. Gas profiling, denial-of-service analysis, audit, and public bug bounty.

17 / LIMITS, DISCLOSURES & ROADMAP

A mechanism can shape execution. It cannot manufacture certainty.

NOT A

Stablecoin

MONUM does not target or guarantee a fixed unit of account.

NOT A

Price floor

Recovery changes the marginal curve; it cannot promise a minimum market price.

NOT AN

Anti-sell lock

Sells remain executable when user slippage conditions are satisfied.

NOT AN

Automatic profit system

Participants can lose money, and volatility can remain extreme.

Road to activation

  1. Freeze the economic specification and publish the parameter rationale.
  2. Complete market simulation and adversarial strategy search.
  3. Finish the live quote, reserve, heat, stress, and budget dashboard.
  4. Install timelocked multisig ownership and publish every privileged action.
  5. Commission independent audits and resolve every critical finding.
  6. Open a public review period and bug bounty before accepting user funds.
  7. Publish the official address only through monum.fun and verified channels.

QUICK GLOSSARY

Activation Moving real MONUM from inactive to active reserve state.Recall Moving eligible active MONUM back to inactive reserve state.Heat Decaying state derived from recent relative buy flow.Stress Decaying state derived from recent relative sell flow.Defense credit ETH retained versus the baseline sell quote.Marginal quote The Hook's current executable curve price, not a historical trade.

RESEARCH-STAGE NOTICE — The contracts described here have not been independently audited. Custom accounting and custom curve logic are experimental. No user funds should be deposited into the prototype. Until an official contract is published on monum.fun, no MONUMENTUM or MONUM token is live.

BUILT FOR THE RUSH. DESIGNED FOR THE BUILD.

TURN MOMENTUM
INTO MONUMENTS.