Se connecter avec un Casa Estates ID

Le CEID

Un Casa Estates ID est un compte de joueur, public comme un identifiant Farcaster. Un joueur peut ne jamais vous montrer d’adresse : un jeu sans blockchain, ou un jeu qui n’a besoin d’une adresse que des mois plus tard pour une distribution de récompenses, fonctionne de la même façon.

Déroulé

1. Votre serveur génère un nonceAléatoire, à usage unique, de courte durée, lié à la session qui recevra le token.
2. La page fait la demandesignIn({ nonce }). Casa Tookan affiche une feuille avec votre nom, votre icône et votre domaine. La première fois, il crée le CEID du joueur, sans formulaire à remplir.
3. Le joueur approuveLa clé du CEID signe autour de votre nonce dans le signataire natif de Casa Tookan. Sa phrase de récupération n’en sort jamais.
4. Le serveur de Casa Tookan émet le tokenIl vérifie la signature et l’appareil, ajoute les faits et signe un JWT pour votre origine (aud).
5. Votre serveur le vérifieAvec les clés publiées (JWKS), sans appeler Casa Tookan. Puis vous lisez vous-même les adresses partagées on-chain. Ne vous fiez jamais à un wallet pour savoir ce que possède un joueur.
6. Plus tard, demandez des adressesrequestAddresses({ nonce, chains, reason }) quand vous en avez besoin : une distribution, un inventaire. Un nouveau token les transporte.

Manifest

Déclarez-le dans votre Wallet App Manifest : la capability casatookan:identity.ceid, et l’objet identity sous wallet.extensions.casatookan (propre à Casa Tookan : les autres wallets l’ignorent).

{
  "name": "Orb Quest",
  "wallet": {
    "version": "1",
    "capabilities": { "required": ["casatookan:identity.ceid"] },
    "extensions": {
      "casatookan": {
        "identity": {
          "reason": "Your CEID keeps your progress across devices.",
          "addresses": [
            { "chain": "bip122:000000000019d6689c085ae165831e93", "max": 2, "reason": "Activate the orbs you hold on Counterparty" },
            { "chain": "eip155:1", "max": 1, "reason": "Your Ethereum cards" }
          ]
        }
      }
    }
  }
}

Dans la page

Disponible dans le navigateur de Casa Tookan quand le manifest déclare casatookan:identity.ceid. Les appels sont rejetés avec une erreur dont le code indique la raison :

const { nonce } = await fetch('/auth/nonce').then((r) => r.json());

// account only: no address leaves the wallet
const { token } = await window.casaTookan.ceid.signIn({ nonce });
await fetch('/auth/casa', { method: 'POST', body: token });

// months later, for the drop
const { nonce: n2 } = await fetch('/auth/nonce').then((r) => r.json());
const { token: withAddresses } = await window.casaTookan.ceid.requestAddresses({
  nonce: n2,
  chains: [{ chain: 'bip122:000000000019d6689c085ae165831e93', max: 1 }],
  reason: 'Where should we send your reward?',
});

Le token

Un JWT (ES256) signé par le serveur de Casa Tookan, valable 24 heures. Demandez-en ensuite un nouveau ; si rien n’a changé, aucune feuille ne s’affiche.

{
  "iss": "https://ctserver.everdreamsoft.com",
  "aud": "https://orbquest.game",
  "sub": "ceid:48213907",
  "env": "production",
  "ceid": 48213907,
  "username": "CasaTookanUser#48213907",
  "usernameDefault": true,
  "addresses": [
    { "chain": "bip122:000000000019d6689c085ae165831e93", "address": "1Abc…k9Z", "since": "2026-03-02" }
  ],
  "facts": {
    "deviceAttested": true,
    "deviceUnique": true,
    "transfers": 0,
    "ceidAge": 214,
    "farcaster": { "fid": 4242 }
  },
  "nonce": "…", "iat": 1791878400, "exp": 1791964800
}

Le vérifier sur votre serveur

Jamais dans la page seule : un token vérifié uniquement dans le navigateur peut être falsifié par le joueur.

1. SignatureAvec les clés de https://ctserver.everdreamsoft.com/.well-known/jwks.json (mettez-les en cache, suivez kid). Elles ne signent que les tokens de production : un token de développement y échoue de lui-même.
2. Audience et émetteuraud est exactement votre origine, iss est le serveur de Casa Tookan.
3. NonceCelui que vous avez émis pour cette session, non utilisé. Brûlez-le.
4. Duréeexp non dépassé (tolérez une minute de décalage d’horloge).

import { createRemoteJWKSet, jwtVerify } from 'jose';

const JWKS = createRemoteJWKSet(new URL('https://ctserver.everdreamsoft.com/.well-known/jwks.json'));

export async function verifyCasaToken(token, expectedNonce) {
  const { payload } = await jwtVerify(token, JWKS, {
    issuer: 'https://ctserver.everdreamsoft.com',
    audience: 'https://orbquest.game',
    clockTolerance: 60,
  });
  if (payload.nonce !== expectedNonce) throw new Error('nonce');
  return payload; // key the player on payload.ceid
}

Builds de développement

Testez avec Casa Tookan Dev. Ses CEID vivent à part de ceux de production et sont signés par une clé de développement publiée sur https://ctserver.everdreamsoft.com/.well-known/jwks-dev.json. Pointez votre serveur de staging dessus et vérifiez env === "development" ; votre serveur de production garde les clés de production et ne voit jamais de comptes de test. Les builds TestFlight de l’app principale s’attestent comme production : ne testez pas avec.

Comptes multiples

Le partage d’adresses par app ne protège pas contre une personne qui joue sous plusieurs identités. Le tableau ci-dessous donne la parade à chaque attaque.

Les règles que suivent les joueurs

Confidentialité

L’essayer dans le playground

La mini app playground développeur a un onglet CEID qui joue chacun des scénarios ci-dessus (première connexion, jeu sans adresses, la distribution, les refus, les tokens expirés, rejoués et étrangers, un changement de nom, une nouvelle phrase, le seuil anti-Sybil), à côté d’onglets pour l’environnement, le manifest, les providers et les deep links. Ouvrez ctserver.everdreamsoft.com/playground/ dans Casa Tookan : il se connecte au serveur de Casa Tookan (un build de développement reçoit des tokens env: "development"). Dans un navigateur ordinaire, il joue contre un wallet simulé et un émetteur simulé, sous leurs propres émetteur et clé, si bien qu’un token simulé ne passe jamais pour un token de Casa Tookan.