Repository navigation
Emission Accounting
Emissions accrue as earned entitlement before they become issued credits. This page specifies the accounting that implements the referral allocation rules. The first sections use ideal arithmetic; the finite-precision section defines rounding, carry ownership, and closure of shared residuals. Neither model permits a balance change to rewrite an earlier entitlement.
Let
where the integrand is defined as zero when
Allocation to an empty lane is unallocated and unissued, not a backlog for its next depositor. The external allocator must preserve previous weight intervals; using today's weight for an entire unprocessed past interval is incorrect.
The tree fixes maximum earning depth
The first term is own-asset income; the second is gross referral commission. Together they are the member's core earnings from that interval. Raw asset units are combined only within their lane; the resulting credit amounts can be added across lanes.
Both emission history and allocation history matter. Even while the global rate declines, a lane with 200 asset units might receive 10 credits in one hour and 90 in the next because its share of that stream increases. In that example, 100 effective core units held only during the first hour earn 5 credits. The same units held only during the second earn 45. A single average rate over both hours would lose that history.
Continuous rate variation is integrated into the cumulative lane index. It does not require a transaction at every instant. Checkpoints at balance, allocation, escrow, or policy changes preserve the relevant intervals.
For parent
For a valid member/lane settlement under unchanged family state:
own = (1 - d_i*q) * p_i,l * delta_I_l
override = q * D_i,l * delta_I_l
if S_i > 0:
marketing = mu_i * override
F_i += marketing / S_i
else:
marketing = 0
kept_i += own + override - marketing
I_i,l_seen = I_l
Only gross overrides fund marketing. Own-asset earnings, fees, escrow principal, and incoming family allocations do not enter that source. If no child escrows credits, the parent keeps the otherwise undistributable amount.
A child records its parent's family index at its previous incoming checkpoint:
kept_c += s_c * (F_parent - f_c_seen)
f_c_seen = F_parent
This family allocation does not update the child's own
A buy, sale, deposit, withdrawal, or other authenticated eligible-position
change first advances the affected lane to the event time under its old total.
It then settles the affected path from the earning seat toward the member under
the old balances, before updating the member's own balance, every ancestor's
descendant total, and
This preserves earnings before the trade and applies new balances only to future accrual. Credit escrow does not change automatically with an asset trade, and trading assets never changes the permanent parent connection.
Before changing a parent's marketing fraction, or any child's escrow and hence the family's total escrow, settle every contributing lane of that parent to the same effective time using the old family state.
For an escrow change, then settle the affected child's incoming family allocation using its old escrow amount. Only after that checkpoint may principal and the child/family escrow counters change. A marketing change likewise takes effect immediately after the common checkpoint, for subsequent accrual in every lane.
The source set must be complete and authenticated. A caller cannot supply only convenient lanes. Track historical member/lane records that can contain pending income; a current zero asset balance does not justify forgetting their history. Since incoming family allocations never fund outgoing marketing, this parent-source barrier does not require recursively materializing every ancestor's marketing income.
Consider two lanes:
- A escrows 100 credits and B escrows none.
- BTC and ETH each accrue 100 marketing credits. Before B enters, both sources settle under the old stake; A owns all 200.
- B escrows 100 credits. In the next interval, each lane produces 50 marketing credits. A and B each receive 50 from this new 100.
Correct cumulative family earnings are A = 250 and B = 50. If BTC settles before B enters but stale ETH income later uses the new denominator, B incorrectly captures 50 credits from before its deposit. A single aggregate family index does not prevent this error without the complete barrier.
Withdrawals and marketing-rate changes require the same protection. The first
staker receives no backpay from intervals with
A new member starts with zero own balances, descendant balances, credit escrow,
child escrow total, family index, marketing fraction, and accrued entitlement.
An ordinary child's incoming checkpoint starts at its parent's stored
A missing member/lane record represents zero contribution before activation. Checkpoint the current lane index before adding its first nonzero own or descendant balance, including an ancestor's first activation. A zero-escrow member still advances its incoming checkpoint when settled.
Collection can mint already-accrued net entitlement without eagerly processing
every source. An operation advertised as collecting everything through time
Collection debits the earned balance and issues the same whole credit amount once. Fractional earned entitlement remains with that member. A second collection without new entitlement mints nothing. All required state updates, custody movements, and mint/burn effects must succeed or fail together.
A single-lane asset change requires work proportional to affected ancestry. A credit-escrow or marketing change also processes all contributing lane sources of the affected parent in the reference implementation. It does not scan every sibling, but its work is not independent of the number of lanes.
The current accounting representation supports 16 lanes; depth is configured separately. A family barrier includes every lane ever materialized for that parent, including withdrawn positions. Shared gauge and lane records must be committed when residuals are closed, so independent branches can contend for those records even though no operation loads the whole tree.
The complete barrier must fit the deployment's execution limits. An alternative that splits it into transactions must preserve an authenticated snapshot and atomic economic effect: partially processed history cannot activate new stake against old income. A simple index does not by itself establish that property.
The following policy makes the ideal equations executable on a finite grid. Let
A shared pool with newly available credits
Thus
Commission and marketing fractions use exact integer numerators over
For a member/lane increment, let
For each such numerator
Own-income carries belong to that member's lane position. Retained-override carries belong to the parent individually. They survive asset withdrawals and family-policy changes. Marketing-rate carries belong to the shared family interval; they cannot be assigned to newcomers. Separate carries ensure that a fraction reserved for children is never first credited as the parent's income.
After settling old terms, an actual change closes the following shared residuals:
| Change | Residuals moved to explicit unallocated accounting |
|---|---|
| Gauge weight | Global gauge division residual |
| Asset balance | Global gauge residual and the affected lane's division residual |
| Family escrow or marketing fraction | Global gauge residual, every parent source lane's residual, family-index residual, and marketing-rate carry |
A closed residual is not awarded to later participants or returned as extra
parent income. The marketing-rate carry is recorded in its exact numerator
units; its credit value is that counter divided by
Closing a source lane's shared residual also affects other members of that lane: no one had yet received that residual as an individual entitlement. This is an explicit precision loss, not confiscation of accrued personal claims.
For one actual asset change the closed amount is at most
where
Collection alone rounds down to whole credit base units and retains the member's remaining fraction. Neither collection nor a change of terms permits double issuance against parent income and child liabilities.
The far-future token-supply/base-unit bound is deferred as described in Emission Schedule. That does not defer checked arithmetic, range analysis, or numerical validation for current operations.
Scheduled budget, earned-but-uncollected claims, issued credits, and escrowed principal are distinct quantities:
| Operation | Effect |
|---|---|
| Core and marketing accrual | Record net funded entitlement; no mint |
| Collection | Remove earned entitlement and mint the same amount once |
| Ordinary admission | Transfer issued credits to the parent; no burn or reward weight |
| Winning top-seat payment | Burn the authorized price in issued credits |
| Family escrow deposit/withdrawal | Move issued principal into/out of custody; no mint or burn |
Uncollected claims cannot pay a fee or back escrow until collected. A convenience collect-and-stake operation must realize each claim once before escrowing the issued tokens. Family allocations do not automatically compound. The same issued principal cannot simultaneously back multiple families or incompatible gauge, clearing, or auction commitments.
Issued supply reconciles as
issued supply = documented bootstrap supply
+ cumulative collected emission claims
- cumulative burns
Escrow is part of issued supply, not an additional claim on emission. Auction or other authorized burns do not replenish the schedule. Across the emission pipeline, collected claims, uncollected entitlements, pending accrual, and explicitly unallocated amounts must reconcile to the scheduled budget without counting marketed credits twice.
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