Documentation

How refer works.

refer is link-based referral marketing, on-chain. Share a link; the holders you bring earn you a share of creator fees, proportional to the time-weighted $REFER they hold. 100% of creator fees go to referrers — the dev keeps nothing. $REFER the coin is the live demo of the system.

Contents
  1. What refer is
  2. How it works
  3. The earning model
  4. Binding your wallet
  5. Claiming
  6. Your auto-wallet & key
  7. Why it's fair
  8. Transparency
  9. For projects
01

What refer is

refer turns word-of-mouth into a measurable, on-chain referral program. Anyone gets a link in one tap — no signup, no wallet connect. When the people you refer hold the token, you earn a cut of the protocol's creator fees.

$REFER (the coin) is the first, live demonstration. The same machinery is designed to work for any token (see For projects).

02

How it works

  1. Share — open the site and a referral link is generated for you instantly. Post it anywhere.
  2. Click — someone opens your link. The click is recorded as a vanity metric only; it earns nothing.
  3. Bind — they connect a wallet and sign a gasless message to bind it to your code (one-time, immutable).
  4. Hold — they hold $REFER in that bound wallet.
  5. Accrue — a snapshot job reads balances on a schedule and accrues token-hours (balance × time) to you.
  6. Epoch close — every 7 days the creator-fee pool is split by token-hours.
  7. Claim — sign a challenge with your key and the SOL is sent to your wallet.
03

The earning model

Earnings come from holdings over time, not from trades or clicks. Each referred wallet earns "token-hours": how much $REFER it holds multiplied by how long it holds. Your share of an epoch's fee pool is your token-hours divided by everyone's.

token_hours = balance × hours_held
your_share  = your_token_hours / total_token_hours
payout = your_share × epoch_fee_pool

This is a proportional share of whatever fees come in — never a fixed or guaranteed yield.

04

Binding your wallet

Binding is how a real wallet gets attached to a referral code so its holdings count. The referred user connects their wallet and signs a short message — a gasless signature, not a transaction, so it costs nothing.

05

Claiming your share

When an epoch closes and your earnings finalize, they become claimable from your dashboard. Claiming is a challenge → sign → claim flow:

  1. The server issues a one-time challenge message tied to your code and a nonce.
  2. You sign it with your auto-wallet key — gasless, and it proves you own the payout address.
  3. The server verifies the signature and sends SOL from the treasury to your wallet.

Funds come from the treasury, which collects the protocol's creator fees. The minimum claim is 0.01 SOL. Claims are replay-protected, so a signed challenge can't be reused.

06

Your auto-wallet & key

The moment you open the site, a Solana keypair is generated in your browser. It's both your referral identity (your code is derived from its public key) and your payout address — fee-share payouts settle to it.

⚠  Save your private key. It only lives in your browser; we can never recover it.
07

Why it's fair

The model is built so that real holders win and farmers don't:

08

Transparency

100% of creator fees go to referrers. The dev keeps nothing. The flow is meant to be verifiable end to end: creator fees → treasury → referrer payouts.

treasury address: published at launch

Once live, you'll be able to watch the treasury address on-chain and confirm that inflows (creator fees) match outflows (claims to referrers).

09

For projects Soon

The same engine is being generalized so any token can run its own holdings-based referral program — point it at a mint, set the payout rate, and hand your community links that pay them to bring real holders. It's not live yet; follow along from the For Projects page.