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.
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
- Share — open the site and a referral link is generated for you instantly. Post it anywhere.
- Click — someone opens your link. The click is recorded as a vanity metric only; it earns nothing.
- Bind — they connect a wallet and sign a gasless message to bind it to your code (one-time, immutable).
- Hold — they hold $REFER in that bound wallet.
- Accrue — a snapshot job reads balances on a schedule and accrues token-hours (balance × time) to you.
- Epoch close — every 7 days the creator-fee pool is split by token-hours.
- 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
- Epoch length: 7 days. Earnings finalize when the epoch closes; until then your dashboard shows a live estimate.
- Minimum hold: a wallet must hold at least 10,000 $REFER at a snapshot to count for that snapshot.
- Snapshots: roughly every 60 minutes, with ±15 minutes of random jitter so the timing can't be gamed.
- Weighting is linear: a wallet that holds twice as much, or twice as long, counts twice as much. A whale referral counts more than a dust referral.
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.
- Proof of ownership: the signature must come from the wallet being bound. You can only bind a wallet you actually control.
- One-time & immutable: a wallet binds once. It can't be re-pointed to a different referrer later, so nobody can hijack a wallet that's already accruing.
- No self-referral: you can't bind your own referrer wallet under your own code.
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:
- The server issues a one-time challenge message tied to your code and a nonce.
- You sign it with your auto-wallet key — gasless, and it proves you own the payout address.
- 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.
- Export and back up the private key the first time you visit.
- If you clear your browser data without saving it, the wallet — and anything claimable to it — is gone.
- Anyone with the key controls the wallet. Treat it like any other crypto secret.
07
Why it's fair
The model is built so that real holders win and farmers don't:
- Minimum hold (10,000 $REFER) — dusting hundreds of wallets earns nothing.
- One-time, immutable bind — a wallet can't be re-assigned to game attribution.
- Signature required — only a wallet's true owner can bind it.
- Time-weighting — earnings need sustained holding. Shuffling one bag between wallets between snapshots earns ~nothing, because a bag can only be in one wallet per snapshot.
- Self-referral rejected — you can't refer yourself.
- Funder-cluster flagging — wallets funded from a shared source are flagged for manual review.
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.