> For the complete documentation index, see [llms.txt](https://theluckyducks.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://theluckyducks.gitbook.io/docs/readme.md).

# Welcome

On-chain duck racing on Solana. Provably fair races, verifiable NFTs, and prizes paid out by a smart contract.

The Lucky Ducks is duck racing, fully on chain. Every race is provably fair, every NFT is verifiable, and a smart contract pays every prize. No house edge. Just ducks!

<figure><img src="https://3421471796-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7dtEnU4lv7j0vOpw19z4%2Fuploads%2Fgit-blob-8072b2c8cd646a064cb419b288d96507abcf74ae%2Fdocs-hero-race-canvas.png?alt=media" alt="Seven ducks racing across the pond with position markers above them"><figcaption><p>A seven player race, mid-run. The animation follows the seed the oracle published on chain.</p></figcaption></figure>

## What you can do here

* **Race** up to 20 players, in WTA (Winner Takes All) or Podium Split [mode](/docs/races/race-modes.md).
* **Collect** four NFT collections: Runners unlock advanced features, Boosts add speed, Tracks change the scenery, Cosmetics dress up your duck.
* **Compete** in tournaments where teams race for one on-chain pot, split between the winning team.
* **Team up** with other players in a [team](/docs/competition/teams.md). Your races feed the standing automatically, with no sign-up and no entry fee.
* **Stake** in SOL or any supported SPL token, Legacy or Token-2022. The platform takes a small treasury fee, the rest goes to the winners.
* **Play fast** by pre-funding a vault and letting the platform sign for you, so joining takes one tap instead of a wallet approval.

## A provably fair draw for any community

A race is a random draw with an on-chain payout, so it works as one. Fund the prize yourself with a **sponsored race** and players join for nothing: the oracle picks the winner, the contract pays out, and nobody, the team included, can steer it.

* **Give away tokens.** Sponsor the pot in SOL or any supported token, open the seats, and let the draw run. Winner takes all, or Podium Split pays three.
* **Keep it to your people.** Gate entry on holding your NFT collection or a minimum balance of your token, on Solana or on a supported chain such as Ethereum, Base or Polygon.
* **Run a closed draw.** An invite list of wallets you choose, and only those wallets can enter.
* **Prove it afterwards.** Every seed, ranking and transfer is on chain, so a winner who asks can check the draw themselves.

{% hint style="info" %}
Sponsoring a race needs a Runner NFT in your wallet, and the prize token has to be one the platform has approved. The organiser pays the prize plus the small race costs; the race account's rent comes back when it closes. See [Advanced options](/docs/races/advanced-options.md), [Race access and gating](/docs/races/access-and-gating.md) and [Fees and prizes](/docs/economy/fees-and-prizes.md).
{% endhint %}

## Where to find things

Read top to bottom on a first visit, or jump straight in.

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th><th data-hidden data-card-cover data-type="files"></th></tr></thead><tbody><tr><td><strong>Getting Started</strong></td><td>What the platform is, how one race goes, and the shortest path to your first one.</td><td><a href="/docs/getting-started/what-is-lucky-ducks.md">What is The Lucky Ducks</a></td><td><a href="https://3421471796-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7dtEnU4lv7j0vOpw19z4%2Fuploads%2Fgit-blob-2a43fc04ed395ae9f8076567f803fa0153c64be7%2Fdocs-card-getting-started.png?alt=media">docs-card-getting-started.png</a></td></tr><tr><td><strong>Races</strong></td><td>Creating, joining, gating and cancelling a race, and every option on the form.</td><td><a href="/docs/races/creating-a-race.md">Creating a race</a></td><td><a href="https://3421471796-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7dtEnU4lv7j0vOpw19z4%2Fuploads%2Fgit-blob-48478a38a90df018addbd0acb22f5ec0bf373a39%2Fdocs-card-races.png?alt=media">docs-card-races.png</a></td></tr><tr><td><strong>NFTs</strong></td><td>The four collections, what each one changes, and where to acquire or rent one.</td><td><a href="/docs/nfts/nfts.md">Overview</a></td><td><a href="https://3421471796-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7dtEnU4lv7j0vOpw19z4%2Fuploads%2Fgit-blob-a7f0d24c8860764ba92dbf5f20b7da3873b39476%2Fdocs-card-nfts.png?alt=media">docs-card-nfts.png</a></td></tr><tr><td><strong>Competition</strong></td><td>Tournaments, teams, rematches, badges and the community lottery.</td><td><a href="/docs/competition/tournaments.md">Tournaments</a></td><td><a href="https://3421471796-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7dtEnU4lv7j0vOpw19z4%2Fuploads%2Fgit-blob-7db4e49a8d448e23a23a69b5cc93e06c75af5ccf%2Fdocs-card-competition.png?alt=media">docs-card-competition.png</a></td></tr><tr><td><strong>Economy</strong></td><td>What a race costs, where the money goes, and what comes back to you.</td><td><a href="/docs/economy/fees-and-prizes.md">Fees and prizes</a></td><td><a href="https://3421471796-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7dtEnU4lv7j0vOpw19z4%2Fuploads%2Fgit-blob-38906abcf653f0c7f1b1cafe8d1c5091886527bb%2Fdocs-card-economy.png?alt=media">docs-card-economy.png</a></td></tr><tr><td><strong>Trust and Fairness</strong></td><td>Where the randomness comes from, and how to check a race result yourself.</td><td><a href="/docs/trust-and-fairness/fairness.md">Provable randomness</a></td><td><a href="https://3421471796-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7dtEnU4lv7j0vOpw19z4%2Fuploads%2Fgit-blob-5557fc2181bec171cbbb35677d7c51f02c712d1b%2Fdocs-card-trust.png?alt=media">docs-card-trust.png</a></td></tr><tr><td><strong>Help</strong></td><td>Common questions, a glossary, the Telegram bot, and where to reach the team.</td><td><a href="/docs/help/faq.md">FAQ</a></td><td><a href="https://3421471796-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7dtEnU4lv7j0vOpw19z4%2Fuploads%2Fgit-blob-3bddb2367dc1e39c4b7d5daf7c19c3cc41cd2a0d%2Fdocs-card-help.png?alt=media">docs-card-help.png</a></td></tr></tbody></table>

{% hint style="info" %}
Anything here wrong or out of date? Ping us on Telegram or X. See [Social networks](/docs/help/social-networks.md) for every channel. The platform moves fast and the docs follow.
{% endhint %}
