Skip to main content

Referral System

Earn rewards by inviting friends to join the QuikDB network. Get +1% earnings bonus for each verified referral (up to 5 referrals = 5% boost).

How It Works​

  1. Get your referral code - Generated automatically when you register
  2. Share with friends - Give them your 8-character code
  3. They apply it - During or after registration
  4. You both earn - Bonus rewards once they link a device

CLI Commands​

Generate Your Referral Code​

Your code is created automatically during registration, but you can view or regenerate it:

quikdb referral generate

View Your Referral Stats​

See total referrals, pending verifications, and rewards earned:

quikdb referral status

Shows:

  • Your referral code
  • Total referrals
  • Pending/verified counts
  • Rewards earned
  • List of referred users

Apply Someone's Referral Code​

Two ways to use a referral code:

During registration:

quikdb device register --referral-code KPYKTZ0U

After registration:

quikdb referral apply KPYKTZ0U

Replace KPYKTZ0U with the actual referral code.

Rewards Structure​

Referrer Benefits​

  • +1% earnings bonus per verified referral
  • Maximum 5% total bonus (5 verified referrals)
  • Applies to both QUIK tokens and LSK stipends
  • Permanent boost as long as referred users stay active

Referee Benefits​

  • Join an established network
  • Same earning potential as all users
  • Can create your own referral code after registration

Verification Requirements​

A referral becomes "verified" when the referred user:

  1. Completes device registration
  2. Links their device to a wallet
  3. Runs their first heartbeat successfully

Web Dashboard​

View your referral stats at nodes.quikdb.com/referrals:

  • Your unique referral code
  • Copy code with one click
  • View CLI command examples
  • Track total and active referrals
  • Monitor bonus percentage

Referral Code Format​

  • 8 characters long
  • Uppercase alphanumeric
  • Unique per user
  • Permanent (doesn't expire)
  • Auto-generated during registration

Example: KPYKTZ0U

Common Questions​

Can I change my referral code?​

No, referral codes are permanent and tied to your wallet address.

What if I forgot to use a referral code?​

You can apply one after registration using quikdb referral apply CODE.

How many people can use my code?​

Unlimited. Your code works for as many referrals as you can get.

When do I get my bonus?​

The +1% bonus activates immediately when a referral is verified (after their first heartbeat).

Can I refer myself?​

No, you cannot use your own referral code.

Do referrals expire?​

No, once verified, referral relationships and bonuses are permanent.

Troubleshooting​

"User already referred" error​

You can only apply one referral code per wallet. Once set, it cannot be changed.

"Invalid referral code format"​

Codes must be exactly 8 uppercase alphanumeric characters. Check for typos.

"Referral code not active"​

The code may be invalid or from an inactive user. Verify with the person who gave you the code.

"User not registered"​

You must complete quikdb device register before applying a referral code.

Best Practices​

  1. Share your code in crypto communities, forums, and social media
  2. Help friends set up - Guide them through registration
  3. Track your stats regularly with quikdb referral status
  4. Maximize your bonus - Aim for 5 verified referrals for full 5% boost
  5. Stay active - Your bonus only applies while your device is earning

Technical Details​

  • Referral codes are stored on the blockchain
  • Rewards are calculated per heartbeat (every 2 minutes)
  • Bonuses stack additively (+1% each, not multiplicative)
  • Backend verifies all referral relationships before applying bonuses
  • Stats sync between CLI and web dashboard in real-time