> 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/trust-and-fairness/verification.md).

# Player verification

Linking an off-platform identity to your wallet, what it unlocks, what it stores, and why it is one-way.

Every wallet has a player profile. Verification ties that wallet to an off-platform identity as well. It is optional, and [what it unlocks](#what-verification-unlocks) is listed below.

## Profile basics: nickname and avatar

Anyone can set a **nickname** and an **avatar** on the Player page, verified or not, and both appear beside your wallet in lobbies, participant lists, leaderboards and team rosters.

* **Nickname.** A short display name. Uniqueness is not enforced, so collisions are separated by the truncated wallet shown next to it.
* **Avatar.** An image you upload. Without one you get a pattern generated from your wallet address, the same one every time.

Both live off chain on your profile and can change any time.

Sign in without a nickname and the app offers to set one, with a picture, on the spot. **Not now** closes it until you next sign in or reload. Tick **Don't show this again** before you close it and it stays away for good, on every device. Either way, the Player page is always where you set them.

<figure><img src="https://3421471796-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7dtEnU4lv7j0vOpw19z4%2Fuploads%2Fgit-blob-904a199c79a2f759fc462b67eebe55b3265f6fe4%2Fapp-nickname-avatar-fields-banner.png?alt=media" alt="The nickname field and the avatar upload on the Player page"><figcaption><p>Open to everyone, verified or not, and changeable any time.</p></figcaption></figure>

## What gets verified

An account with one of the providers the platform has enabled. X and Telegram are the ones most players use, and the Verification tab on the Player page is the live list, so what you see there is what is on offer.

Verifying marks the wallet as verified and gives you access to that identity's display name and avatar, which you can adopt as your profile if you like.

{% columns %}
{% column width="70%" %}

<figure><img src="https://3421471796-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7dtEnU4lv7j0vOpw19z4%2Fuploads%2Fgit-blob-7e5c0bfe9ea7d60c487c17e8e7147778dcb8e925%2Fapp-verification-tab-desktop.png?alt=media" alt="The verification tab on the player page listing the available providers with a link button beside each"><figcaption><p>Whichever providers the platform has enabled.</p></figcaption></figure>
{% endcolumn %}

{% column width="30%" %}

<figure><img src="https://3421471796-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7dtEnU4lv7j0vOpw19z4%2Fuploads%2Fgit-blob-4f60e6d2c0289d3628c4d4fa82592d93757e28da%2Fapp-verification-tab-mobile.png?alt=media" alt="The verification tab on the player page listing the available providers with a link button beside each, on a phone"><figcaption><p>On a phone</p></figcaption></figure>
{% endcolumn %}
{% endcolumns %}

## When verification is offered

{% hint style="info" %}
After your first race. A brand new wallet cannot verify: the providers are listed from the start but refuse until there is a race in your history, which stops an empty wallet minting a badge and walking away.
{% endhint %}

There is no deadline. Once you qualify you can verify whenever, or never.

It happens once, off chain: you authorise the provider, the platform confirms it, and your wallet is marked verified from then on. The mark lives on your profile and shows beside your nickname in lobbies, leaderboards and rosters.

## What verification unlocks

* **Signing in without your wallet app.** A linked account signs you in instead of a signed message, which on a phone is the difference between staying in your browser and being bounced to the wallet app and back. See [Signing in with a linked account](#signing-in-with-a-linked-account).
* [**Playing without signing every action**](/docs/races/delegated-play.md)**.** The program refuses to grant it to an unverified wallet, for one reason: the point is not reaching for your wallet, and a linked account is what gets you back in without one.
* **Races reserved for verified players.** A creator can admit verified wallets only, which keeps throwaway wallets out without an invite list. You need to be verified to enter one, and to host one. See [Race access and gating](/docs/races/access-and-gating.md#verified-players-only).
* **An identity badge**, a green dot on your avatar that other players see on race cards and in lobbies.
* **Your Telegram handle in announcements**, for Telegram-verified players who opt in. See below.

<figure><img src="https://3421471796-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7dtEnU4lv7j0vOpw19z4%2Fuploads%2Fgit-blob-282a0fd8f30a9525d55f8a3b95889d05f0c5b41e%2Fapp-verified-badge-banner.png?alt=media" alt="A lobby participant row with the green verified dot on the player&#x27;s avatar"><figcaption><p>The badge travels with you: race cards, lobbies, leaderboards, rosters.</p></figcaption></figure>

## Signing in with a linked account

Your first sign-in is always the wallet, because signing a message is the only thing that proves the wallet is yours. After you have linked an account, the login screen offers it as a second way in.

It resolves, it does not create: signing in with a social account finds the wallet that account is linked to, and if it is linked to nothing the platform says so rather than making an account.

Two things it deliberately cannot do. It cannot link an account, since linking starts from a wallet you have already proved you own. And it never grants an operator session; an operator signs in with their wallet.

Which accounts appear depends on the providers the platform has enabled.

This is half of playing without ever opening your wallet app. [Playing without your wallet app](/docs/races/without-the-wallet-app.md) is the other half, and the order to do them in.

## Telegram handle in group announcements

Verify with Telegram and you can opt into showing your **handle** in the platform's Telegram announcements: wins, podiums, tournament results and similar posts.

It is off by default, and you toggle it from the Player page once Telegram-verified. On, announcements tag your `@handle` so the broadcast reaches you and your contacts; off, they use your nickname only. Flip it whenever you like, though past announcements are not rewritten.

<figure><img src="https://3421471796-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7dtEnU4lv7j0vOpw19z4%2Fuploads%2Fgit-blob-8cd15324dfd68c4d008dfbce949b3c43c61f5e62%2Fapp-telegram-handle-toggle-banner.png?alt=media" alt="The Telegram handle toggle on the Player page, switched off"><figcaption><p>Off until you turn it on, and only offered once Telegram is linked.</p></figcaption></figure>

## Privacy

The platform stores only what it needs: a stable identifier from the provider, your display name and your avatar image. It never receives your email, phone number or any other personal data, and the permission you give covers only what confirms you control the account.

{% hint style="danger" %}
Verification is one-way. There is no unverify: nothing on the platform, and no instruction in the program, sets the flag back. Link an account deliberately rather than to try it out.
{% endhint %}

## Multiple providers per wallet

You can verify with several providers at once, and the platform shows whichever identity you make primary. Future events may reward being verified across several, but the flag itself is binary.

**Any linked account signs you in, and none of them is the primary for that.** Verify with X, link Google later, and either will do. That is the practical reason to link a second: lose access to the first and the second is still a way back into your wallet without your wallet app. Only the first link costs an on-chain transaction.

{% hint style="warning" %}
**One social account belongs to one wallet.** A wallet can carry several providers, but a given X, Telegram or Facebook account links to exactly one wallet, and trying it on a second is refused. That is what stops one person fielding several verified players in a Verified Only race.
{% endhint %}

## What verification does not do

* It does not change your race history.
* It does not give you a boost.
* It does not discount entry fees.
* It does not let the platform refund you out of band. Refunds are always on chain.