Referral tracking & gamification, out of the box

Quick Start

npm install @transmitter/referral-tracker
# or
npm install @transmitter/rewards-engine

# Then in your code:
import { createReferralTracker } from '@transmitter/referral-tracker';

const tracker = createReferralTracker({
  licenseKey: 'YOUR_LICENSE_KEY',
  supabaseUrl: process.env.SUPABASE_URL,
  supabaseKey: process.env.SUPABASE_KEY,
});

Extend Onchain & Beyond

Every reward event fires an async hook. Wire onchain payouts, NFT minting, notifications — or any side effect. The engine handles the state machine; you handle downstream.

onLevelUp: async ({ userId, newLevel }) => {
  await wallet.transfer({
    to: userId, token: 'usdc',
    amount: BigInt(newLevel * 1_000_000),
    network: 'base',
  });
},
onRewardIssued: async ({ referrerId, amount, referralId }) => {
  await wallet.transfer({
    to: referrerId, token: 'usdc',
    amount: BigInt(amount),
    network: 'base',
    idempotencyKey: referralId,
  });
},

Works with Coinbase CDP SDK, viem, ethers, Solana web3.js. userId can be a wallet address.