Skip to content

Referral Network

mister-mayflower edited this page Nov 9, 2026 · 5 revisions

The Referral Network divides a scheduled stream of Mayflower credits among eligible asset holders and their referral ancestors. A parent can then spend some of its referral commissions on a marketing offer for its immediate children. Those children divide the offer by escrowing credits.

The global emission rate decreases continuously; the cumulative amount available to distribute continues growing while emission is positive. The tree divides each interval's scheduled budget without increasing it.

The formal specification defines the allocation rules and action contracts. Emission Accounting defines historical settlement and finite-precision accounting. Authentication, token custody, and auction authorization must enforce those contracts atomically.

One tree, two forms of admission

The logical protocol root earns nothing. Beneath it are a small number of scarce, auctioned earning seats at depth 0. A winning seat payment is made in credits and burned. The auction and the credit inventory needed to bootstrap the first paid auction are separate protocol responsibilities.

An ordinary member instead selects an existing parent and pays that parent's current join fee in credits. This payment belongs to the parent. A parent can set a zero fee, and can change its offer for future joiners.

The chosen parent connection is permanent. Deposits and escrow balances can change, but an existing connection cannot move, be severed, or have another node inserted into it. A node's upline is its chain of earning ancestors; its downline is its entire descendant subtree.

Asset balances determine the core allocation

Each asset has its own emission lane. An external allocator, such as gauge voting, divides the global credit budget among lanes. Each lane compares eligible asset balances within that lane; it does not add raw BTC, ETH, and SOL quantities.

At depth $d$, a member retains $1-dq$ of the gross attribution from its own eligible assets. Each of its $d$ earning ancestors receives a fixed fraction $q$. The intended referral configuration fixes maximum depth $H\gt 0$ and override rate $q$, with

$$q\gt 0,\qquad Hq\lt 1.$$

For example, at depth 2 with $q=10\%$, a source's gross attribution is divided 80% to its holder, 10% to its parent, and 10% to its grandparent. The deposited principal is not divided. A grandparent benefits from descendant assets even if the intervening parent has no assets of its own.

A node at depth $H$ cannot recruit children, but retains a positive own-asset share and can participate in its parent's family marketing pool.

Credits divide the optional family budget

A parent chooses a marketing fraction $\mu$ between 0% and 100%. It shares that fraction of its gross downline override income, aggregated in credits across all asset lanes. Its own-asset earnings and incoming family allocations are outside this budget.

Immediate children divide the budget in proportion to their escrowed credits. Their assets, number of accounts, and descendants' escrow are not the weights. A received family allocation stays with its recipient; it is not shared onward or charged another upline commission. If no child has credits escrowed, the parent keeps the otherwise undistributed budget.

This gives families distinct offers. A productive downline can fund a larger pool, while more competing child escrow reduces each staker's fraction. A parent can change $\mu$ at any time for future accrual. It is a discretionary marketing budget, not a permanent yield commitment. Mutualization explains the mechanism.

Balances change; history does not

Buying, selling, depositing, and withdrawing assets affect subsequent core allocation. Staking or withdrawing credits affects subsequent family allocations. Neither action changes the parent connection or earns rewards from an earlier interval. Escrow principal is withdrawable without a mandatory lock period.

Before changing a family's marketing percentage or credit weights, accounting must settle its earlier override income from every contributing lane. The emission accounting page defines that history and the implementation requirements.

Explore the model

Page What it explains
Formal Specification The allocation equations, conservation, and implementation boundary
Mutualization Credit escrow, family allocations, and examples
Link Shopping Comparing permanent positions and participant-controlled offers
Parameters Fixed network terms and participant choices
Rationale Recruitment incentives, identity splitting, and economic limits
Diagrams Admission, commissions, and marketing flows

The rules allocate the existing emission budget; they do not guarantee that recruitment increases every member's absolute earnings. Credit Emissions explains the budget, and Credit Channel Weighting explains its allocation among assets.

Clone this wiki locally