Skip to main content

Referral System

Invite people to join the QuikDB network and track verified referrals. The current programme may apply a referral percentage to eligible rewards, but registration, verification and a displayed balance do not guarantee a payout. Review the current programme terms before sharing a financial claim.

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. Verification is recorded - The programme applies the current referral rules after the device qualifies

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​

Current Recorded Rules​

  • The product currently records a 1% referral percentage per verified referral.
  • The recorded percentage is capped at 5%.
  • Payment eligibility, asset, timing and availability follow the current node-provider programme.
  • A recorded percentage or balance is not guaranteed income.

Referee Benefits​

  • Join an established network
  • The same programme eligibility review as other node providers
  • 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 recorded referral percentage updates after verification. Any payment remains subject to the current programme terms.

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. Check current terms - Programme rules can change independently of the referral code

Technical Details​

  • Referral codes are stored on the blockchain
  • Heartbeats and verification events feed the current programme record
  • 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