Repository navigation
Referral Network Formal Specification
This page specifies the Referral Network: permanent membership, credit allocation, admission, and custody. Its rate equations use ideal arithmetic. The companion Emission Accounting specifies chronological settlement, cumulative indices, and finite-precision rules. Rationale explains the incentives and their limits; it does not add exceptions to the rules.
There is one logical non-earning protocol root. Its scarce auctioned seats have
earning depth 0; the protocol root receives no override. Every ordinary node
has one permanent parent, and a node at maximum depth
A member cannot change parent, insert an intermediary into an existing edge, sever its ancestry, or create a cycle. Withdrawing all balances does not delete membership or descendants. One owner may control multiple members.
| Symbol | Meaning |
|---|---|
| Global credit emission rate, decreasing continuously over time | |
| Credit emission rate allocated to asset lane |
|
| Member |
|
| Sum of eligible balances of all strict descendants of |
|
| Sum of all members' own eligible balances in the lane | |
| Issued credits escrowed by |
|
| Sum of credit escrow over |
|
| Member |
The following rate equations apply at time
For
Its total core income and gross override income are
Each source funds one
Core income sums to each nonempty lane's assigned emission. An ancestor's cut is calculated from the source's original attribution, not compounded from what another ancestor leaves behind. A member can earn overrides without own assets.
In ordinary active operation the allocator supplies
The parent's outgoing marketing rate is
For an immediate child
The member's final income rate is
with incoming family allocation zero for an auctioned seat. Every family
allocation is a deduction from one member and an addition to another, so
Only gross overrides fund
A parent can change
Ordinary admission transfers the parent's current credit fee to its owner and creates the immutable edge. The parent's nonnegative fee increment applies once to a successful join, saturating at the representable maximum. Zero fee and zero increment are valid. The parent may edit future prices, and a payer can enforce a maximum accepted fee.
Top-level admission requires a scarce, authenticated auction allocation. The winning payment in already-issued credits is burned, rather than paid to a member. The first paid auction requires a separately documented existing or genesis credit inventory; this model does not invent a free first seat or mint its own auction payment.
Family escrow remains the child's principal and cannot simultaneously back another family stake or be spent. Accrued rewards become issued credits when collected once; uncollected claims do not count as escrow. A collect-and-stake operation performs those steps in that order.
The authoritative aggregates are
Each asset position enters
New members start with zero assets, family escrow, child escrow, marketing fraction, and accrued entitlement. An ordinary child's incoming family checkpoint starts at its parent's current stored index; the first positive escrow still requires full settlement under the old family terms. Missing lane positions begin at the lane's current index, with no claim on earlier emission.
An admission offer contains two unsigned whole credit-base-unit amounts,
current_fee and increment, each at most
This saturation is a quote rule. Other balances, totals, and accrued claims use checked arithmetic; they must not silently saturate.
| Action | Required transition |
|---|---|
| Activate an auctioned seat | Authenticate the unique award, consume it once, burn its final issued-credit price, and create a depth-zero member. Losing or refundable bids are not winning payments. |
| Join under a parent | Authenticate the existing parent and new identity, check remaining depth and the payer's maximum fee, transfer the current fee, create the permanent edge, and advance the quote once. |
| Change an offer | The parent owner changes the fee or increment for future joins; existing edges and earnings are unchanged. |
| Change an asset balance | Settle the affected lane and complete ancestor path at the old balances, then update the member's own balance, the lane total, and each ancestor's descendant total. |
| Change a marketing fraction | The owner settles every contributing lane under the old fraction and escrow total before installing the new fraction. |
| Change child escrow | Settle every parent source and the child's incoming family allocation under its old escrow, then change that principal and the parent's child-escrow total together. |
| Change gauge allocation | Settle the old routing interval before applying new lane weights. |
| Collect credits | Remove accrued net whole credit base units and issue that amount once; retain the member's fractional claim. |
All state changes and required custody movements are atomic. Rejected actions transfer nothing and change no price or entitlement. Authorization must bind each state record to its protocol, lane, member, or auction award; a caller cannot supply a different account with convenient cached totals. The emission snapshot must be authenticated, chronological, and consistent at a given timestamp.
Top-level seats cannot escrow into the non-earning root. A child can partially or fully withdraw family principal after settlement, without a mandatory lock, penalty, or forfeiture. The same issued principal cannot simultaneously back family escrow, gauge pledges, clearing commitments, or auction bids.
Collection may issue only the claims already materialized. To collect all entitlement through a specified time, first settle the member's core sources, its immediate parent's gross-override sources, and its incoming family index. A child with no asset records can still earn from every source lane of its parent. Emission Accounting specifies those checkpoints and the ownership of fractional residuals.
The ideal model conserves allocated emission. It also gives two limited splitting properties: moving fixed assets within a connected owned region under unchanged outside ancestry does not improve its combined core attribution, and splitting the same credit escrow among aliases under one parent does not improve their combined family share.
These are not universal Sybil or coalition-resistance claims. See Rationale for their scope. Before deployment, implementations must validate numerical bounds, remainder ownership, exclusive custody, and complete historical settlement. The formulas alone do not establish those implementation guarantees.
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