Referral Fees

Overview

Referral fees are rewards provided to third parties for facilitating user activities such as buying, selling, or auctioning a Fan Token on the Moxie protocol.

The Moxie protocol offers three types of referral fees:

• Buy/Sell Referral Fees
• Auction Referral Fees
• Signup Referral Fees

Each type has a unique fee split structure. For detailed information about referral fees and their respective split structures, visit here.

Contract Architecture

Referral fees are primarily managed by the ProtocolRewards.sol contract. This singleton contract is deployed once and handles the deposit and withdrawal of all referral fees.

Currently, only referrals on buy/sell transactions can included independently on-chain by calling the relevant smart contract functions.

Auction & signup referrals, however, can only be made through the referral links generated by moxie.xyz.

Buy/Sell Referral Fees

For every buy and sell Fan Token transactions that occurs on your platform, you can include your address as a referrer to receive the referral fees from each transaction.

This can be done easily by calling "v2" functions added from the December 4, 2024 contract upgrade in both the MoxieBondingCurveV2.sol and StakingV2.sol contracts. Those functions are:

Functions	Contract
buySharesV2	MoxieBondingCurveV2.sol
buySharesForV2	MoxieBondingCurveV2.sol
sellSharesV2	MoxieBondingCurveV2.sol
sellSharesForV2	MoxieBondingCurveV2.sol
buyAndLockV2	StakingV2.sol
buyAndLockForV2	StakingV2.sol
buyAndLockMultipleV2	StakingV2.sol
buyAndLockMultipleForV2	StakingV2.sol

When a user is calling one of the above functions on your platform, you can include your address in the _orderReferrer parameter to assign yourself as a parameter.

From there, the MoxieBondingCurveV2.sol and StakingV2.sol contracts will automatically calculate and deposit the referral fees into the ProtocolRewards.sol contract.

Once the referral fees are deposited into the ProtocolRewards.sol contract, they can be withdrawn anytime.

For buy/sell referral fees withdrawal from the ProtocolRewards.sol contract, simply call the withdraw function.

To learn more on how to buy/sell Fan Tokens with referral fees, you can continue following the tutorial below:

• Buy Fan Tokens
• Buy Fan Tokens On Behalf Of Others
• Sell Fan Tokens
• Sell Fan Tokens On Behalf Of Others

In addition, if you successfully onboard another user to moxie.xyz, you can earn 0.15% signup referral fees for every buy/sell transactions from that user indefinitely.

Auction Referral Fees

Auction referral fees are rewards provided to referrers who promoted certain Fan Token auction to another user that successfully bid on it.

For every successful bid on a Fan Token auction that you referred, you will earn 1.5% of that particular auction order proceeds.

Auction referral fees for this will be handled off-chain and will be paid out to the ProtocolRewards.sol contract where all other referral fees are accumulated and can be claimed on-chain.

Signup Referral Fees

Signup referral fees are rewards provided to referrers for successfully onboarding new users to create a new account in moxie.xyz.

For every user that you successfully onboard to moxie.xyz, you will be labelled as a Platform Referrer by Moxie for those users and will earn:

• 0.15% referral fees for every buy/sell transactions from that user indefinitely
• 1.5% of that user's Fan Token auction proceeds when they launch a Fan Token
• 10% of that user's Moxie Score added to your Moxie Score

Signup referral fees for this will be handled off-chain and will be paid out to the ProtocolRewards.sol contract where all other referral fees are accumulated and can be claimed on-chain.

Developer Support

If you have any questions or need help with other use cases, feel free to join the Moxie Official Warpcast channel and ask your questions there.

Our team is always ready to help you with any questions you may have.