Skip to content

feat(growth): referral reward loop (+5 credits) [0xcFDa9f32d292661740a6d0B4c00867E34c05c56D] - #115

Open
meridianmindx wants to merge 1 commit into
Nexussyn:mainfrom
meridianmindx:agent/eve/issue-2
Open

feat(growth): referral reward loop (+5 credits) [0xcFDa9f32d292661740a6d0B4c00867E34c05c56D]#115
meridianmindx wants to merge 1 commit into
Nexussyn:mainfrom
meridianmindx:agent/eve/issue-2

Conversation

@meridianmindx

Copy link
Copy Markdown

Summary

Closes #2 β€” referral reward loop for +20% conversion.

When user B converts with user A's referral code, A receives 5 free credits once. Duplicate (code, new_user) pairs are rejected.

Changes

  • migrations/add_referral_system.sql β€” idempotent tables + process_referral() (balances, notifications, system_events)
  • src/growth/referral.ts β€” ReferralStore + processReferral()
  • tests/referral.test.ts β€” happy path, idempotency, multi-user, invalid/self-referral

Acceptance criteria

  • SQL referral_codes (code, owner_id, uses, credits_awarded)
  • process_referral(referral_code, new_user_id)
  • Credits added to referrer balance
  • Event logged as referral_conversion
  • Notifications for both users
  • Idempotent (no double-award)
  • Tests: happy path + duplicate prevention

Verification

deno test tests/referral.test.ts  β†’ 7/7 passed
deno test tests/pricing.test.ts   β†’ 5/5 passed (no regressions)

Payout

USDC on Base (x402): 0xcFDa9f32d292661740a6d0B4c00867E34c05c56D
Contributor: meridianmindx

…ussyn#2)

Implement processReferral + SQL migration enhancements (balances, notifications, system_events) so successful referrals grant 5 free credits once per code/user.
@meridianmindx

Copy link
Copy Markdown
Author

Friendly bump for merge when you have a moment β€” still MERGEABLE with payout address in the title. Happy to address any review notes same day so we can clear the USDC reward on merge.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[AGENT-TASK] Implement referral reward loop β€” +20% conversion

1 participant