> For the complete documentation index, see [llms.txt](https://jester.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://jester.gitbook.io/docs/tokenomics/referrals.md).

# Referrals

## 🤝 Referrals

Referrals are part of **Castellan**, the onboarding and loyalty layer of the Jester ecosystem. They help grow the Court, and they earn **Favour**, the court’s currency of merit.

{% hint style="info" %}
Favour is used throughout Jester’s loyalty economy, and it ties directly into Spoils distribution each Season.
{% endhint %}

### ✅ What counts as a referral

A referral becomes **successful** when a new user:

1. Starts the bot using your referral link or code
2. Completes their **first successful wallet verification**

Clicks alone are tracked, but verification is what finalizes rewards.

***

### 🔗 Getting your referral link

After you are verified, open Castellan’s main menu and tap **Referral**.

Your referral link follows this pattern:

`https://t.me/jesterValetBot?start=<YOUR_REFERRAL_CODE>`

Share this link directly, or have someone enter your code during onboarding (if prompted).

***

### 🏰 Referral rewards

#### 3-level network depth

Referrals pay out across a **3-level network**:

* **Level 1**, direct, someone verified using your link
* **Level 2**, referrals made by your Level 1 users
* **Level 3**, referrals made by your Level 2 users

#### Current reward amounts (Favour)

When a referred user completes verification, rewards are credited:

| Level | Who it is       | Reward      |
| ----: | --------------- | ----------- |
|    L1 | Direct referral | +100 Favour |
|    L2 | Indirect        | +25 Favour  |
|    L3 | Extended        | +10 Favour  |

New user bonus:

* A newly verified user who used a referral code also receives **+25 Favour**

{% hint style="warning" %}
Rewards and safeguards may evolve over time.
{% endhint %}

### 🧾 Referral stats in Castellan

Inside the **Referral** menu you can:

* Set a custom referral code
* See total link clicks and conversions
* View referral-related placeholders, where applicable

***

### ✍️ Custom referral codes

You can set a custom referral code inside Castellan.

Rules:

* 4 to 15 characters
* Letters and numbers only
* No spaces or symbols
* Case-insensitive (stored and displayed in uppercase)

{% hint style="warning" %}
Offensive names may be changed at the sole discretion of JESTER. Please keep it clean.
{% endhint %}

***

### 🛡️ Safeguards and abuse prevention

Referrals are designed as a growth flywheel, not a way to farm rewards.

Common safeguards include:

* No self-referrals (linked wallets flagged)
* Anti-abuse checks for suspicious patterns
* Optional maturity requirements (example, activity window or minimum trade volume)

{% hint style="info" %}
Favour resets each Season, so referrals must stay part of real activity to keep meaning long-term.
{% endhint %}

***

### ❔ FAQ

#### Do I need to be verified to refer people?

Yes. Your referral menu and link are available after verification.

#### My friend clicked my link but verified later, will it still count?

Yes. The referral finalizes when they complete verification.

#### What if someone already verified before using my link?

Referrals only apply on first successful verification, so it will not count as a new referral reward event.

#### Where do I see my rewards?

Your Favour and referral stats are visible through bot menus. Referral stats live in Castellan’s Referral menu.

#### My friend wants me to&#x20;

Your Favour and referral stats are visible through bot menus. Referral stats live in Castellan’s Referral menu.