revshare state

Denom

Denom is the only asset this realm accounts.

MaxMembers

MaxMembers bounds the distribution loop; MaxWeight bounds a single weight. Together they cap totalWeight at 200,000, which makes the remainder step of the split ((A%W)\*w) provably overflow-free for any int64 coin amount — the conservation math cannot trap.

MaxWeight

MaxMembers bounds the distribution loop; MaxWeight bounds a single weight. Together they cap totalWeight at 200,000, which makes the remainder step of the split ((A%W)\*w) provably overflow-free for any int64 coin amount — the conservation math cannot trap.

member

admin

// manages members, plans; stages a successor

pendingAdmin

// staged by TransferAdmin, completes via AcceptAdmin

sweeper

// may sweep out-of-band surplus

self

// this realm's address, captured at deploy

members

// insertion-ordered; bounded by MaxMembers

totalWeight

ledger

planIDs

// plans created through this realm (ops/Render)

pulled

// lifetime revenue pulled over boundary B2

init.13

AddMember

AddMember adds a weighted member. Weight changes never touch earned balances; they shape future pulls only.

SetWeight

SetWeight changes a member's weight for future distributions.

RemoveMember

RemoveMember removes a member from future distributions. The member's earned balance is untouched and stays claimable forever.

CreatePlan

CreatePlan creates a subscription plan THROUGH this realm, making the realm the plan's provider downstream. Admin only: the per-provider plan quota downstream is a griefable resource.

RetirePlan

RetirePlan retires one of this realm's plans downstream. Admin only.

Pull

Pull claims this realm's entire accrued provider balance from the subscriptions realm and distributes it to the members by weight. Permissionless: pulling can only move the receivable into member balances at the fixed weights, so anyone may crank it. Refuses BEFORE the downstream call when no member could receive the funds.

distribute

distribute splits amount by member weight. Shares are computed as (A/W)\*w + ((A%W)\*w)/W — floor(A\*w/W) without any multiplication that can overflow. The remainder (\< number of members) goes to the highest-weight member, lowest address on ties: deterministic, and it leaves the realm with no undistributed pool at rest.

dustRecipient

Claim

Claim sends amount ugnot of the caller's earned balance to the caller.

ClaimAll

ClaimAll sends the caller's entire earned balance to the caller.

SweepDenom

SweepDenom recovers out-of-band coins to the sweeper. For the accounting denom the reserve is the full ledger liability — member balances are structurally unsweepable. Sweeper only.

TransferAdmin

TransferAdmin stages a two-step admin handover.

AcceptAdmin

AcceptAdmin completes the handover; only the staged successor may. The sweeper role moves with the admin.

Admin

PendingAdmin

MemberCount

TotalWeight

MemberWeight

BalanceOf

UsersTotal

Pulled

NumPlans

PlanID

Address

Held

Receivable

Receivable reads this realm's accrued, not-yet-pulled provider balance inside the subscriptions realm — the other side of value boundary B2. It is deliberately NOT part of Held or of the local conservation equation.

Render

indexOf

assertNoSend

assertAdmin

itoa