For the complete documentation index, see llms.txt. This page is also available as Markdown.

Referral Program

Earn a share of the protocol fee generated by the people you invite to stake.

Share your invite link. When someone stakes XDC for the first time through your link, they become your referral - permanently and on-chain - and you earn a share of the protocol fee their staking generates, for as long as they stay staked.


How it works

  1. Get your link. Connect your wallet on the Referral page and copy your personal invite link (primestaking.xyz/xdc-liquid-staking?ref=<your address>).

  2. They stake through it. When an invitee opens your link and makes their first stake (at least the minimum bind amount, currently 100 XDC), the ReferralRegistry binds you as their referrer in the same transaction that deposits their XDC. The binding is one-time and immutable.

  3. You earn a fee share. Each epoch, your reward is a share of the protocol fee generated by your referees' staked balances, proportional to how much they staked and for how long.

  4. You claim. Epoch rewards are published as an on-chain Merkle distribution (ReferralRewards); claim yours from the Referral page whenever you like. There is no expiry.


How earnings are calculated

For each epoch:

your payout = referralShare × protocolFeeCollected
              × (your referees' time-weighted psXDC balance ÷ total time-weighted supply)
  • Time-weighted means balance multiplied by how long it was held during the epoch - more staked, longer staked, more earned.

  • The payout table is computed from on-chain data and published as a Merkle root; the contract only ever pays what the posted root says and can never be posted underfunded.


Why extra wallets gain nothing

Referral payouts scale with referred capital and time only. Splitting the same capital across many wallets earns exactly what one wallet earns - there are no signup or per-wallet bonuses anywhere. Referring your own second wallet just returns a small slice of the fee your own stake generated (always less than the fee itself), so the protocol never pays out more than it collected. This makes the program safe to run openly.


Contracts

Contract
Address
Role

ReferralRegistry

Binds one immutable referrer per wallet on the first stake; forwards the stake to the vault. Minimum bind: 100 XDC.

ReferralRewards

Epoch Merkle distributor. Roots are immutable per epoch and must be fully funded before posting; unclaimed liability can never be swept.

Both contracts are non-upgradeable and never custody user principal - the registry forwards deposits straight to the vault (shares mint to the staker), and the distributor only holds each epoch's referral-fee allocation.

How Rewards WorkDeployed Contracts & Addresses

Last updated