Integrate one shared referral identity across your app. The existing ViralKit client handles code resolution and ERC-20 approval plus purchase transactions.
Pass the viem public client and connected wallet client from your app.
// Local SDK source; not published to npm yet.
import { createViralKitClient } from "~~/lib/viralkit";
const viralKit = createViralKitClient({ publicClient, walletClient });Referral codes resolve onchain. The contract splits payment only after a successful campaign purchase.
const hash = await viralKit.purchaseWithReferral(campaignId, referralCode);
const receipt = await publicClient.waitForTransactionReceipt({ hash });
if (receipt.status !== "success") throw new Error("Purchase failed");
const hasAccess = await viralKit.hasPurchased(campaignId, buyerAddress);Configure price, AUSD token, metadata, and referral share from the campaign workspace.
A registered code can travel across your participating apps. Pass it as a `ref` query parameter in a share link, then submit it with the campaign purchase.
import { zeroAddress } from "viem";
const referrer = await viralKit.resolveReferralCode(referralCode);
if (referrer !== zeroAddress) {
// Pass referralCode to purchaseWithReferral after user confirmation.
}