> For the complete documentation index, see [llms.txt](https://docs.witty.game/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.witty.game/welcome-to-witty/lingo.md). # Lingo Lingo is a competitive word game where you wager real ETH against other players. Each player gets their own secret 5-letter word to solve. The winner is whoever solves it better — fewer guesses, more accurate tiles. Every game is a duel. Every word is a bet. ## How to Play ### The Basics Lingo is a head-to-head word game. Two players enter a match, each betting the same amount of ETH. Each player gets their own secret 5-letter word. The match is **asynchronous**: you might play immediately, or you might have to wait for another player to join and take their turn. When both players have finished, the result is decided. ### Tile Feedback Type any valid 5-letter word and submit. After each guess, the tiles reveal how close you were: | Color | Meaning | | ------------- | ----------------------------------------- | | 🟩 **Green** | Correct letter, correct position | | 🟧 **Orange** | Letter is in the word, but wrong position | | ⬛ **Grey** | Letter is not in the word | You have up to 6 guesses. ### Match Flow 1. **Pick a tier** — choose your stake and enter the queue 2. **Get matched** — paired with an opponent at the same stake 3. **Solve your word** — up to 6 guesses; take your time, it's async 4. **Result** — once both players finish, the winner is determined and ETH settles on-chain ### Winning It's not about speed — it's about how well you solve your word. Outcomes are decided in this order: 1. **Fewer attempts** — the player who solved in fewer guesses wins 2. **More greens** — if attempts are equal, whoever accumulated more green tiles across all guesses wins 3. **More oranges** — if greens are also equal, whoever accumulated more orange tiles wins 4. **Coin toss** — if everything is identical, a random coin toss decides **Jackpot:** Solve your word in a single attempt to claim the jackpot on top of your winnings. Both players always receive different words. ### Betting Tiers Three tiers. Pick your stakes. | Tier | Stake (per player) | Pot | Winner Takes | | ------------- | ------------------ | --------- | ------------ | | 🎲 **Casual** | 0.001 ETH | 0.002 ETH | \~0.0019 ETH | | 🦐 **Shrimp** | 0.01 ETH | 0.02 ETH | \~0.019 ETH | | 🐋 **Whale** | 0.1 ETH | 0.2 ETH | \~0.19 ETH | *5% fee on each pot: 2.5% to the jackpot pool, 2.5% to the protocol.* Higher tiers earn more LP per win and more gems per win — but losses also cost more LP at higher ranks. ## Jackpot Every match contributes 2.5% of the pot to a shared jackpot pool. Solve your word in a single attempt — in any tier — and you win a portion of that pool instantly, on top of your normal match winnings. ### Jackpot Payout by Tier The amount you win scales with the tier you're playing in: | Tier | Jackpot Payout | | --------- | --------------------- | | 🎲 Casual | 1/111th of the pool | | 🦐 Shrimp | 10/111th of the pool | | 🐋 Whale | 100/111th of the pool | This means a Whale jackpot win is worth 100× a Casual jackpot win, proportional to the stake. The pool is never fully drained by a single win — the remaining balance stays in the pool and keeps growing. ### Transparency Disclaimer The jackpot pool has been seeded with 3 ETH by the Lingo team. We reserve the right to withdraw that initial seed at any time. All funds contributed by players through match fees are separate and will never be touched by the team — only distributed to jackpot winners. ## Ranks & LP ### How It Works Every match earns or costs you **LP (League Points)**. Your LP total determines your rank. There are three ranks: Bronze, Silver, and Gold. | Rank | LP Required | Can Demote? | | --------- | ----------- | ----------- | | 🥉 Bronze | 0+ | — | | 🥈 Silver | 300+ | No | | 🥇 Gold | 1000+ | No | Once you reach Silver or Gold, you can't fall back. Ranks are permanent milestones. ### LP Per Game | Tier | Bronze Win / Loss | Silver Win / Loss | Gold Win / Loss | | ------ | ----------------- | ----------------- | --------------- | | Casual | +10 / -5 | +10 / -10 | +10 / -15 | | Shrimp | +30 / 0 | +30 / -10 | +30 / -20 | | Whale | +100 / 0 | +100 / 0 | +100 / 0 | **What this means in practice:** * **Bronze** — Casual losses cost LP, but Shrimp and Whale losses don't. Low-stakes entry point. * **Silver** — losses start to bite across tiers. You need to perform to climb. * **Gold** — Casual losses hurt the most relatively; Shrimp and Whale have no LP loss, making high-tier play the safest path to maintaining rank. Every match always has a winner — the tiebreaker chain ends in a coin toss, so there are no draws. ## Gems & the Shop ### What Are Gems? Gems are Lingo's in-game currency. Earn them through play, spend them in the shop. ### Earning Gems | Source | Gems | | --------------------- | ------------------------ | | Enter a referral code | 300 | | Casual win | 10 | | Shrimp win | 50 | | Whale win | 250 | | Daily streak | 10–50 (see Daily Streak) | | Achievements | varies | ### Spending Gems | Item | Cost | Notes | | --------------- | -------- | ------------------------------------ | | Hint Pack | 100 gems | One-time unlock, infinite use | | Nickname Change | 100 gems | First set is free; changes cost gems | | Sticker Pack | 200 gems | 1 random sticker | ## Daily Streak Log in and play every day to build your streak. The longer the streak, the more gems per day. | Consecutive Days | Gems/Day | | ---------------- | -------- | | Day 1 | 10 | | Day 2 | 20 | | Day 3 | 30 | | Day 4 | 40 | | Day 5+ | 50 (max) | Miss a day and the streak resets to 10. **Over 7 days:** | Scenario | Total Gems | | -------------- | ---------- | | Perfect streak | 250 | | Break on day 4 | 160 | *** ## Stickers Stickers are cosmetic items. They can be set as your profile picture and displayed during matches. * **1 sticker per pack** — 200 gems each * Stickers have **rarity tiers**: Common, Rare, Epic, Legendary * **Duplicates upgrade** your sticker to higher levels (Lv1 → Lv2 → Lv3) * Use any sticker as your **PFP** ### Upgrading Stickers Each level has a point value. To upgrade, you consume stickers whose combined value meets the threshold: | Level | Value | | ----- | ----- | | Lv1 | 1 | | Lv2 | 10 | | Lv3 | 100 | * **Upgrade to Lv2:** consume stickers worth 10 total (e.g. 10× Lv1) * **Upgrade to Lv3:** consume stickers worth 100 total (e.g. 10× Lv2, or 100× Lv1, or any mix) You receive 1 free sticker when you create your account. --- # 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://docs.witty.game/welcome-to-witty/lingo.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.