Skip to main content

Integration Guide

Integrate unKat today into your protocol to enjoy fee sharing and push Katana limits !

  • For DApps and Frontends: Allow users to claim their rewards through your app through unKat and receive a share of the claiming fee through our referral program.
  • For Builders: Integrate a 1-1 unlocked version of the Kat token, create lending, perp, options for the Kat token throuhg unKat.

Brand Kit​

Unlocked Cash and UnKat brand kits are available on Figma.

Referral Program​

Earn Through Integrations !

Frontends and protocols integrating unKat can receive referral fees:

Set the referral address during claim to receive up to 5% fee on the amount minted by the users.

Works seamlessly through our smart contracts and Merkl API.

Ideal for protocols that direct users to stake, mint, or LP and expect to receive Kat rewards through Merkl.

Custom Arrangements:

For strategic LPs, market makers, or DeFi platforms contributing meaningful TVL or utility, custom fee structures may apply. All proposals are reviewed case-by-case to ensure fairness. Please contact @unlockedKAT on Telegram.

Technical details​

To integrate unKat into your app:

Step 1:

Contact @unlockedKAT on Telegram and request to join our referral program, the fee share percentage will be discussed case by case.

Once validated we will ask an address from your project and will whitelist it on our factory, fees shared will be sent to that address.

Step 2:

On your frontend or contract call the Merkl distributor contract the same way as if you wanted to claim normal kat/reward tokens.

The Merkl distributor code is available on github and is deployed on katana at 0x3Ef3D8bA38EBe18DB133cEc108f4D14CE00Dd9Ae.

You will need the Merkl proofs for the user claiming, they are available on the Merkl API.

Step 3:

Instead of calling the function claim() which directly send the user's rewards to its wallet. You will need to call the function claimWithRecipient().

All the values can be set to default like when using the normal claim() except:

  • The recipient needs to be set to the unKat address when claiming kat. (can be set back to the user address for other tokens)
  • The data needs to be set to abi.encode(address referralAddress) when claiming kat. (can be set empty for other tokens)

It's important to always set the data when claiming unKat as otherwise Merkl will not execute the hook on our unKat contract, so if you have a valid referral use it! If not then just set any random data, the unKat contract will just ignore it if it's not a valid referral. Don't leave it empty or Merkl will not execute the hook and users may not receive their unKat tokens.