Referral Manager

Learn how to earn referral rewards for each mint when you display Highlight projects on your site

Highlight offers a contract called ReferralManager, which acts as a proxy for our MintManager. By executing mints through this contract, you can capitalize on referral rewards, earning 10% of Highlight's mint fee.

On the ReferralManager, vectorMint721WithReferral, gatedNumMint721WithReferral and gatedChooseMint721WithReferral are the three methods supported, which essentially means that referrals are supported for all fixed price sales and private dutch auctions on Highlight.

vectorMint721WithReferral is used for mints on public sales, where you can pretty easily construct the arguments yourself.

The gatedNumMint721WithReferral and gatedChooseMint721WithReferral methods require an EIP712 based signature, and are used for gated mints and collector’s choice series mints. You can construct these arguments by hitting our API. In fact, you can construct mint args for every referral-supported mint using our API if you wanted to, with the following schema and endpoint:

API url: https://api.highlight.xyz:8080/

Graphql query: 

mutation ClaimMintTo($data: MintClaimInput!, $vectorId: String!) {
  claimMintTo(data: $data, vectorId: $vectorId) {
    contract {
      chainId
      address
      args
      method
      value
      gasLimit
    }
  }
}

where MintClaimInput = {
  numTokensToMint: number;
  referrer?: string; // here's where you'd pass the referrer address
  mintData?: string; // you can ignore this field
}

---

Review the ReferralManager contract on Github:

hl-evm-contracts/contracts/mint/referrals/ReferralManager.sol at main · highlightxyz/hl-evm-contractsGitHub

See the NFT contracts page to find the ReferralManager on each chain.