Repository navigation
AVM Specification
This page specifies the Amplifying Value Machine. The equations describe exact arithmetic unless the numerical rules explicitly say otherwise. AVM Rationale explains the design choices; AVM Evolution gives the state transitions.
Each market fixes a smooth, strictly increasing characteristic function
| Symbol | Meaning |
|---|---|
| Floor price, in reserve units per AVA | |
| Ramp end, on the progress axis | |
| Ramp width | |
| Ramp start | |
| Signed vertical offset of the main schedule | |
| Pricing progress, in AVA units | |
| Actual circulating AVA supply | |
| Physical floor-tail quantity | |
| Liquid reserve held by the market | |
| Outstanding reserve advances secured by AVA positions | |
| Required backing for the current circulation |
Progress and circulation are separate quantities. Ordinary issuance advances
both; floor issuance and special floor redemption change only circulation.
Consequently, price must be evaluated at
A characteristic engine receives a batch of spans on the progress axis and
returns results in request order. For a span with start
Evaluations use only the characteristic's fixed parameters and the requested spans. The AVM uses those evaluations to construct the pricing schedule, quote trades, calculate backing, and verify floor raises.
Define the main and ramp functions:
The schedule is
At
The spot price is
This is the ramp constraint: the ramp occupies less area than extending main backward over the same interval. Floor raises can use this difference to fund a higher floor.
A fresh market starts with
Its initial schedule is
The physical floor tail has
Equivalently,
When
Equality describes an exactly funded market without surplus. Donations and
conservative rounding can leave surplus. Advances move backing from liquid
reserve into collateralized positions;
For a position with
For ordinary issuance of
The buyer supplies
For ordinary redemption of
If the sale reaches below the old ramp end, the schedule contracts after the quote. The exact contraction rules are in AVM Evolution. Redemption fees and any required advance repayment reduce the holder's net payout. Numerical contraction may also require a conservative backing deduction.
Authorized floor issuance adds
A proposal chooses a positive floor increment
The main offset
The proposal must pass the floor-join check and the chosen backing-change
policy. An area-preserving raise has
Calculations use lower and upper bounds enclosing exact values. Issuance charges the upper cost bound and redemption pays the lower proceeds bound. When a sale contracts within the ramp, that proceeds bound deducts an upper bound on any additional retained backing caused by rounding the main offset upward. An operation fails when its bounds cannot certify the required inequalities.
With proposed ramp
- The entire enclosure for
$G$ must lie in$[0,\epsilon_p]$ . - An ordinary raise requires the entire enclosure for
$B'-B$ to lie in$[-\epsilon_B,0]$ . - A surplus-funded raise requires it to lie in
$[0,\epsilon_B]$ . - The upper bound for
$B'$ must be covered by$H+D$ .
These are directional acceptance intervals, not symmetric error margins. Setting both allowances to zero requests exact joins and exact backing preservation.
Fees are charged in the reserve asset. With integer fee rate
In the intended Mayflower integration, each fee-bearing AVM action transfers its protocol allocation into revenue clearing in the same transaction. The destination is a pot for the market's base reserve asset in an epoch accepting funding. Token transfer and recognition of funding must succeed together with the AVM transition; a failed required funding step fails the transaction. There is no deferred transfer through an operator's fee wallet or conversion into another asset. This routing belongs to the integrating AVM program, while the arithmetic specifies the fee amounts.
The integrating program authenticates market and position state and binds each market to its characteristic engine, parameters, and ramp multiplier for the life of the market. The AVM relies on that engine to enclose the true values and integrals. The integrating program also enforces collateral custody and option authorization and atomically settles token supply changes, reserve transfers, fees, and the new state.
AVM
AVM features
Linear AVM
Referral network
- Overview
- Rationale
- Specification
- Parameters and authority
- Family marketing
- Choosing a parent
- Diagrams
Credits
- Mayflower Credits
- Earning credits
- Channel weighting
- Credits and revenue clearing
- Long-term economics
Credit emissions
- Overview
- Emission rate and cumulative budget
- Lane allocation
- Participation and referral rewards
- Accrual, collection, and conservation
Revenue clearing