Documentation_

REFAMILY is an attention and referral layer for tokens launched on Pump.fun. A token creator chooses a referral share. A caller shares a unique callout link. A trader signs a wallet consent message through that link. REFAMILY observes eligible trading activity, assigns qualified volume to the caller, and uses that volume to allocate a share of collected creator fees.

The referral is token-specific. A link view alone does not attribute a trader, and a signature does not execute a trade or transfer funds.

Pump.fun remains the token launch and trading venue. REFAMILY stores token settings, callout relationships and indexed trade records. Solana transaction history is the reference for on-chain activity; dashboard rows are an index, not custody of trader funds.

Sign in, link a Solana wallet, enter token metadata, choose a referral share, an attribution window and an attribution model, then optionally specify a dev buy. The launch transaction is prepared for your selected wallet to approve. That wallet pays the network and launch costs plus any dev-buy amount. If you buy, the tokens go to that same wallet.

The dev buy is optional (up to 85 SOL in the current form). Check the wallet prompt and its actual costs before signing. There is no promise of a specific launch cost or token return.

After a token is live, a caller with a linked payout wallet can create a unique token-specific callout. Share its /c/… link anywhere, including X. The landing page displays the token, caller and link activity. REFAMILY records views, clicks and successful wallet connections separately.

Posting about a token without creating and sharing a REFAMILY callout link does not automatically create a referral. X-post scanning, where available, is separate from wallet attribution.

The trader connects a compatible Solana wallet and signs a message naming that wallet, the callout code and a timestamp. The signature proves wallet control and consents to token-specific attribution. It does not authorize a transaction or move SOL. A Passport number is created for a newly seen wallet; the optional ecosystem opt-in is separate.

The trader must sign per callout to attach that relationship. They can skip signing and trade without attribution. The signed message is time-limited for submission; the attribution lasts for the token’s configured window.

Creators configure when callout relationships expire: 24 hours, 7 days, 30 days or lifetime. Trades before a signature or after expiry do not credit that callout. If a wallet has multiple active callouts for a token, its model decides where eligible volume goes.

The current “creator choice” model follows the split rule in the calculation engine. This is attribution of observed activity, not ownership of the trader’s wallet or future trades outside the active window.

REFAMILY syncs token transaction data via Helius and indexes observed buys and sells. Only eligible activity within an active signed attribution contributes to a caller’s payout weight. Raw volume and qualified volume are different metrics.

These filters reduce simple volume gaming; they do not guarantee fraud-free activity. Trade indexing may lag or miss activity if RPC or provider data is incomplete.

Pump.fun creator fees accrue to the REFAMILY fee collector because it is the on-chain creator for platform launches. The platform claims those fees into the collector wallet. At batch time, the current implementation allocates the pool of unbatched claimed fees across platform tokens in proportion to their tracked trading volume in the batch period; this is an accounting estimate, not a direct per-token fee receipt ledger.

The caller pool is split between callers in proportion to their qualified volume for the token and period. If no caller has qualified volume, the caller pool returns to the creator share. Recipients without a payout wallet and amounts below the configured minimum are marked skipped.

A token’s referral percentage applies to its allocated creator fees, not to each trader’s trade size or to their wallet balance. The protocol rate, payout minimum and operational limits are fixed platform settings.

Payouts run automatically on a schedule: the pipeline syncs trades, claims fees, builds the split and pays everyone in SOL without any manual steps, once unclaimed fees pass the configured threshold. Payouts are still not per-trade — they settle in periodic batches. The fee collector funds the distributor for the pending amount, and the distributor sends SOL to recorded recipient wallets. Batch and daily limits, a pause switch and audit events provide operational safeguards. Partial or failed transfers are retried on the next run.

Token pages and caller views expose callout views, clicks, connected wallets and tracked activity. Dashboards show your launched tokens, callouts, earnings and profile. Leaderboards compare trader counts, volume, call performance and other indexed metrics. These displays are informational and may lag the chain.

Launches are unlimited — there are no tiers or holding requirements. The $REFAMILY utility token is not a claim on platform fees and does not need to pass through referred trades.

The treasury destination and $REFAMILY mint are platform settings. No earnings, launch outcome, execution time or completeness of detected trades is guaranteed.