Skip to content

Referral rewards

Claim a referral link and understand first-touch launch revenue payouts.

Referral links assign a launch wallet to one referrer. The assignment uses the first valid referral code saved for that browser and becomes permanent when the wallet signs in.

  1. Open Referral rewards.
  2. Choose a custom address using 3–24 lowercase letters, numbers, or single hyphens.
  3. Connect the wallet that should receive payouts and sign the one-time login message.
  4. Copy or share the link shown on the page, such as https://spawn.finance/r/alice.

Each wallet receives one permanent custom address. Generated links claimed before custom addresses were available continue working. A wallet cannot refer itself.

First-touch attribution

A shared /r/:code link redirects through the ?ref= query parameter. Spawn validates the code and stores the first valid code in a same-site browser cookie for 180 days. Later referral links do not replace it.

Before a token launch, the launcher signs in. Spawn binds the stored code to that wallet if the wallet has no existing attribution. A later browser, session, or referral link cannot change the wallet assignment.

The launch transaction writes the attributed referrer into referrerForToken. This on-chain value controls payouts for the lifetime of the token.

Revenue split

For collected Uniswap LP fees, the launch fee recipient keeps 70%. The remaining 30% is Spawn revenue. A referred token splits that revenue equally, so the referrer receives 15% of the total LP collection and Spawn receives 15%.

The Spawn router also divides its buy and sell fee equally between the referrer and Spawn. Unreferred tokens keep the existing revenue distribution.

Factory LP collections can pay in WETH and the launched token. Router referral fees pay in ETH or WETH. Each contract sends the payout directly to the wallet that claimed the referral code.

Verify a token referral

const referralAbi = [
  "function referrerForToken(address token) view returns (address)",
  "function referralFeesGenerated(address referrer,address asset) view returns (uint256)",
];

const referrer = await factory.referrerForToken(tokenAddress);
const wethPaid = await factory.referralFeesGenerated(referrer, wethAddress);

The router exposes referralFeesGenerated(address referrer) for its ETH and WETH-denominated payouts. The referral dashboard combines those amounts with WETH payouts recorded by the factory.