Onchain Atlas

Referral Rewards

Pays whoever brings in a new user a cut of that user's activity, turning existing users into a distributed sales force.

Also called: referral program · affiliate rewards · invite-and-earn

What it is

Referral rewards are a smart-contract-enforced version of an affiliate program: when someone refers a new user to a protocol or creator, and that new user does something valuable (buys, subscribes, trades), a percentage automatically flows to the referrer. Because it's coded into the contract rather than tracked by a company's internal ledger, the payout is transparent, automatic, and hard to dispute.

How it works

  1. A user generates a unique referral link or code, which is often just their own wallet address tagged onto a URL or embedded in a transaction's calldata.
  2. A new user arrives via that link and performs a qualifying action — minting an NFT, subscribing to a creator, buying a token, opening a position — through a transaction that includes the referrer's address as a parameter.
  3. The contract handling that transaction is written to split the incoming payment: a percentage is routed to the protocol/creator, and a percentage is routed to the referrer's address, all within the same transaction.
  4. Some designs pay the referral bounty as a one-time bonus (e.g., on first purchase); others pay an ongoing share of everything the referred user ever spends (a "revenue share" model), or a share of a specific token allocation set aside for referrals.
  5. Multi-level designs extend this further, splitting rewards across a chain of referrers (the person who referred the referrer also gets a smaller cut), similar to multi-level marketing structures.
  6. Because the referrer address is just data passed into a transaction, there's typically no verification that the "referral" was a genuine, independent user — the mechanism trusts that the on-chain link between addresses reflects a real introduction.
  7. Payouts settle atomically with the triggering transaction, or accrue in a claimable balance the referrer withdraws later.

Why designers use it

  • Turns existing users into low-cost growth channels, since the protocol only pays out when new value is actually generated, not for cold marketing spend.
  • Aligns incentives transparently onchain, so referrers can verify their own payouts rather than trusting a company's opaque tracking dashboard.
  • Can bootstrap adoption quickly in competitive markets where users have many similar options and word-of-mouth incentives push them toward one over another.

Failure modes

  • Self-referral / Sybil farming: a single person creates many wallets, "refers" themselves, and performs the qualifying action across all of them to farm rewards with no real new users involved.
  • Reward-driven low-quality growth: users referred purely to collect a bounty often churn immediately after the qualifying action, inflating apparent growth without real engagement.
  • Multi-level payout structures can resemble pyramid schemes, where later referrers earn most of the reward from ever-growing recruitment rather than genuine product usage.
  • Fee/reward misdesign: if the referral cut is carved out of the same pool that funds core protocol operations, aggressive referral spend can undermine the protocol's own sustainability.
  • Front-running referral codes: bots can intercept and rewrite pending transactions to insert their own address as the referrer, stealing bounties meant for someone else.

What to check before using it

  • Check whether the reward comes from genuine new revenue or is subsidized from a fixed token allocation that could run out or dilute holders.
  • Look for Sybil resistance: is there any friction (KYC, minimum activity, cooldowns) that makes mass self-referral farming unprofitable?
  • Verify whether payouts are one-time or ongoing, and how that compares to the actual lifetime value the referred user is expected to bring.
  • Understand the depth of the referral tree (single-level vs multi-level) and whether deeper structures risk resembling a pyramid scheme.
  • Confirm the transaction flow can't be front-run or manipulated to redirect a referral bounty to the wrong address.

Experiments that used it · 2

Shown oldest first, so you can watch the design evolve.

Stars Arena
Avalanche's friend.tech fork whose bonding-curve 'Tickets' briefly made it the chain's hottest SocialFi app before a reentrancy exploit drained ~$3M in AVAX ten days after launch.
2023 exploited
Fabric / Hypersub
Fabric's Subscription Token Protocol (STP) turned recurring subscriptions into time-based ERC-721 NFTs, and its Hypersub app became the de facto membership layer of the Farcaster creator economy before the company pivoted to DEX aggregation.
2023 technically successful commercially unsuccessful