Referral Program

#Overview

The program uses one referral level. It does not pay commissions on commissions. Every commission and invitee boost is paid from a fixed WEED reserve. No extra WEED is minted.

#How referral binding works

An invitee can bind once by calling the referral contract. A nonzero farm deposit may also pass a suggested referrer when the invitee is still unbound. Wallet connection alone never binds a referral.

The current EIP-712 path is different. The signed path proves only the referrer's signature; it does not require an invitee signature or an invitee transaction. Any caller can submit it and permanently bind the named unbound invitee.

#One-level rewards

A base reward looks up the invitee’s direct referrer only. The contract does not walk upward to pay parents of that referrer. Cycle checks prevent self-referrals and short referral loops from being recorded.

#Referrer commissions

For any bound invitee, the referrer’s current tier determines a commission percentage of the invitee’s settled base reward. The vault then clips the requested amount to per-payout, lifetime, and remaining-reserve limits before transfer.

#Invitee boosts

A bound invitee can receive an extra percentage based on the direct referrer’s current tier for the first 30 days after binding. The boost comes from the referral reserve and never changes the base reward calculation.

#Referral tiers

Higher tiers require both the displayed active-referral count and, where nonzero, a base-reward threshold. The threshold is the referrer's own cumulative settled base farming reward, not reward volume generated by invitees. Deployment-specific minimum stake and farming duration values are not final and must be published before use.

#Fixed reserve

The referral vault budget is 69,552,000 WEED. It is separate from the 316,848,000 WEED base farming budget and cannot mint more WEED.

#Reserve exhaustion

A payment can be clipped by the per-payout or account/category lifetime cap even while the global reserve still holds WEED. If the reserve itself is smaller than the allowed payment, the payment is clipped to what remains. When it is empty, referral extras stop while base rewards continue under their independent budget.

The coordinator preview subtracts the previewed commission from shared reserve before it knows the referrer's remaining lifetime allowance. If the vault later clips that commission to zero, the invitee boost may already have been reduced or removed even though reserve remains.

#Eligibility

A bound invitee becomes active only after meeting the deployment-configured minimum stake and farming-duration conditions. Dropping below the minimum stake resets eligibility and removes the invitee from the active count when applicable.

Passing the time threshold alone does not activate the count. Activation occurs only when a later successful base-reward hook runs the eligibility check.

Minimum stake and farming duration affect active-referral tier counting only. They do not gate payouts for a bound invitee's settled base reward. If the referrer already has a nonzero tier, that settlement can trigger a commission and, during the boost window, an invitee boost.

#Multi-pool eligibility blocker

Deposits currently add eligible stake across farms, but a normal withdrawal replaces that aggregate with the remaining amount in only the withdrawn farm. An emergency withdrawal reports zero even when the user still has principal in another farm. Active-referral eligibility and its timer can therefore reset incorrectly.

#Anti-abuse rules

• No self-referrals.
• No protocol address as referrer.
• One permanent binding per invitee.
• Signed bindings include invitee, referrer, nonce, deadline, chain ID, and verifying contract, but the current signer is only the referrer.
• Referral cycles and over-deep graphs are rejected.

#How to create a referral link

1. Connect a wallet after the referral contract is deployed.
2. Open Your referral link.
3. Copy the generated link only when the interface confirms the deployed verifying contract.
4. Share the link without promising returns.
5. The invitee should review the referrer address before a direct binding call or nonzero farm deposit.

#Risks and limitations

Bindings are intended to be permanent. A user can move between tiers, reserve capacity is finite, signatures can expire, and indexer views can lag. Referral earnings are not guaranteed and should never be presented as a reason to ignore farm risk.

#Current phase