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:
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:
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.