> 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=` 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 Your Favour and referral stats are visible through bot menus. Referral stats live in Castellan’s Referral menu. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://jester.gitbook.io/docs/tokenomics/referrals.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.