Votre site, dans chaque casa.

Niveau 0 · 0 minute

Ça marche déjà.

Si votre site fonctionne avec MetaMask, Xverse, Magic Eden ou Unisat, il fonctionne dans Casa Tookan. Aucun SDK à installer, aucun cas particulier dans votre code.

1. Ouvrez votre site dans l’app

   Dans Casa Tookan, allez dans Explorer et tapez votre URL.

2. Connectez et signez, comme d’habitude

   Chaque demande ouvre la fenêtre de signature de Casa Tookan. Elle montre votre site et la casa qui signe : vous n’avez aucune interface à construire.

   EVM Bitcoin Counterparty

   connect.jsCopier

   const [address] = await window.ethereum.request({ method: 'eth_requestAccounts' });
   const signature = await window.ethereum.request({
     method: 'personal_sign',
     params: ['Welcome to Orb Quest!', address],
   });

3. Suivez la casa

   L’utilisateur peut changer de casa depuis la barre d’adresse à tout moment, et votre page reçoit l’événement habituel. Chaque casa a aussi son propre localStorage : les sessions ne se mélangent pas.

   connect.jsCopier

   window.ethereum.on('accountsChanged', ([next]) => setPlayer(next));

window.addEventListener('eip6963:announceProvider', (e) => {
  if (e.detail.info.rdns === 'com.everdreamsoft.casatookan') useProvider(e.detail.provider);
});
window.dispatchEvent(new Event('eip6963:requestProvider'));

// Vous voulez juste savoir si vous êtes dans Casa Tookan ?
const inCasaTookan = window.casaTookan?.isCasaTookan === true;

await window.BitcoinProvider.request('signPsbt', {
  psbt,                                    // base64
  signInputs: { [address]: [0, 1] },
  broadcast: true,
  fees: [{ kind: 'service', address: 'bc1q…', sats: 750 }],
});

// Dialecte Unisat : les mêmes frais dans les options (signPsbts : dans les options de chaque PSBT).
await window.unisat.signPsbt(psbtHex, {
  toSignInputs,
  fees: [{ kind: 'service', address: 'bc1q…', sats: 750 }],
});

Niveau 1 · Un lien

Faites entrer les joueurs directement.

Quelqu’un qui visite votre site dans Safari ou Chrome n’y a pas de portefeuille. Un bouton ouvre la même page dans Casa Tookan. Sans l’app, il ouvre une page avec l’App Store, Google Play et « continuer dans le navigateur ».

<a id="open-casa" href="#">
  <img src="https://casatookan.com/assets/badges/open-in-casatookan-fr-dark.svg"
       alt="Ouvrir dans Casa Tookan" width="212" height="56">
</a>
<script>
  // déjà dans Casa Tookan : rien à ouvrir
  if (window.casaTookan) document.getElementById('open-casa').hidden = true;
  else document.getElementById('open-casa').href =
    'https://casatookan.com/open?url=' + encodeURIComponent(location.href) + '&ref=votre-app';
</script>

Niveau 2 · 5 minutes

Devenez une app.

Votre site a sans doute déjà un web manifest. Ajoutez-y un membre wallet et Casa Tookan présente votre site comme une app.

1 2 3 4 5 6 7

1. 1
   Bannière · wallet.heroImageUrl, 1200×630
2. 2
   Icône · icons, 1024×1024 opaque
3. 3
   Nom · name, 32 caractères
4. 4
   Sous-titre · wallet.subtitle, 30 caractères
5. 5
   Catégorie · la première de vos categories
6. 6
   Chaînes · wallet.chains
7. 7
   Description · description, 170 caractères

La page du Dev Playground, dessinée à partir de son manifest avec la mise en page de Casa Tookan par le validateur. Votre manifest remplit chacun de ces éléments.

• Votre nom et votre icôneDans la barre d’adresse et la fenêtre de signature
• Un écran de démarrageVotre visuel sur votre couleur pendant le chargement
• Une carte dans Explorer › AppsAvec votre bannière, à un geste
• Des prérequis clairsUn message explique ce qui manque

1. Décrivez votre app

   Seul le nom est obligatoire. Le JSON se met à jour pendant la saisie.

   Nom 32 caractères Sous-titre 30 caractères Catégorie Aucune gamescollectiblesfinancesocialutilitymarketplaceart-creativityeducationdeveloper-tools Fond du splash

   Chaînes nécessaires

   Bitcoin Counterparty Ethereum Base Kaia J’appellerai ready()

   Manifest complet Seulement wallet

   Pour un site qui n’a pas encore de manifest.

   site.webmanifestCopier

   Standard W3C, vous l’avez peut-être déjàwallet, ce que vous ajoutez

2. Publiez-le

   L’un ou l’autre. Casa Tookan vérifie les deux et utilise le premier qui contient un membre wallet.

   Où	Quand le choisir
   Votre manifest existant, lié par <link rel="manifest"> sur votre page d’accueil	Vous en avez déjà un. Gardez le lien dans le HTML servi : un lien ajouté par un script n’est pas vu.
   /.well-known/wallet-app.json	Vous préférez le garder à part. Même JSON, servi seul.

   Servez-le en application/json. Placez les images à côté : une icône opaque de 1024×1024, une bannière de 1200×630, un splash de 200×200. Ce sont les tailles de Farcaster : un seul jeu d’images sert aux deux.

3. Autorisez les navigateurs à le lire

   Envoyez Access-Control-Allow-Origin: * sur tout ce qui est sous /.well-known/, 404 comprises, et sur vos images. Le validateur et Casa Tookan sur le web en ont besoin ; l’app mobile s’en passe. Sans cela, un farcaster.json absent ressemble à une panne réseau.

   Apache nginx

   .htaccessCopier

   # THE_REQUEST, pas REQUEST_URI : reste /.well-known/ après une réécriture vers index.php
   <If "%{THE_REQUEST} =~ m#\s/\.well-known/#">
     Header always set Access-Control-Allow-Origin "*"
   </If>

4. Vérifiez-le

   Le validateur charge votre manifest en ligne, teste chaque image et montre votre app telle que Casa Tookan la dessinera. Casa Tookan lit les manifests une fois par lancement : relancez l’app pour voir un changement.

Niveau 3 · Une ligne

Levez le rideau au bon moment.

Déclarez wallet.ready dans vos capabilities. Votre splash reste alors affiché jusqu’à ce que votre premier écran soit dessiné : les joueurs ne voient jamais une page à moitié chargée.

await loadAssets();
renderTitleScreen();
window.wallet?.ready();   // le splash s’efface, votre jeu est là

Niveau 4 · 30 minutes

Connexion depuis partout.

Depuis un navigateur ordinaire ou un jeu natif, envoyez le joueur vers Casa Tookan avec un challenge. Il revient avec ses adresses Bitcoin et Ethereum, chacune prouvée par une signature, sans mot de passe ni extension.

1. Envoyez le joueur vers Casa Tookan

   Votre serveur génère un challenge aléatoire à usage unique. Votre page ouvre le lien.

   login.jsCopier

   const { challenge } = await fetch('/auth/challenge').then((r) => r.json());
   
   location.href = 'casatookan://x-callback-url/getaddress'
     + '?x-success=' + encodeURIComponent('https://orbquest.game/auth/casa')
     + '&msg=' + encodeURIComponent(challenge);

2. Le joueur approuve

   Il voit votre site dans la fenêtre de signature, choisit une casa et touche Se connecter. Casa Tookan ouvre alors votre callback avec address, msg et sig :

   https://orbquest.game/auth/casa?address=…&msg=…&sig=…Copier

   address = chain:bitcoin;1Ca5a…T00k;;separator;;chain:ethereum;0x1614…1313
   sig     = chain:bitcoin;H8k2…=;;separator;;chain:ethereum;0x5f1c…1b

3. Vérifiez sur votre serveur

   Vérifiez que le challenge est le vôtre et inutilisé, puis vérifiez les deux signatures. Attention : celle d’EVM n’est pas personal_sign.

   verify.jsCopier

   import bitcoinMessage from 'bitcoinjs-message';
   import { recoverAddress, keccak256, toUtf8Bytes } from 'ethers';
   
   // "chain:bitcoin;1Ca5…;;separator;;chain:ethereum;0x16…" → { bitcoin, ethereum }
   const entries = (s) => Object.fromEntries(s.split(';;separator;;').map((e) => {
     const i = e.indexOf(';');
     return [e.slice('chain:'.length, i), e.slice(i + 1)];
   }));
   
   export function verifyCasaLogin(query, expectedChallenge) {
     const p = new URLSearchParams(query);
     const msg = p.get('msg');
     if (msg !== expectedChallenge) throw new Error('challenge');   // puis brûlez-le
     const addr = entries(p.get('address'));
     const sig = entries(p.get('sig'));
   
     // Bitcoin : BIP-137, signé par l’adresse Legacy.
     if (!bitcoinMessage.verify(msg, addr.bitcoin, sig.bitcoin)) throw new Error('bitcoin');
   
     // EVM : secp256k1 brut sur keccak256(msg), pas EIP-191.
     const signer = recoverAddress(keccak256(toUtf8Bytes(msg)), sig.ethereum);
     if (signer.toLowerCase() !== addr.ethereum.toLowerCase()) throw new Error('ethereum');
   
     return addr;
   }

Niveau 5 · Un après-midi Aperçu

Connaissez vos joueurs.

Un Casa Estates ID, c’est un compte par joueur, quels que soient ses appareils et ses phrases de récupération. Indexez vos sauvegardes sur un numéro stable ; ne demandez les adresses que lorsque vous en avez besoin. Conçu pour les jeux qui distribuent des récompenses.

1. Déclarez-le dans votre manifest

   Dans votre membre wallet :

   site.webmanifest · walletCopier

   "capabilities": { "required": ["casatookan:identity.ceid"] },
   "extensions": {
     "casatookan": {
       "identity": { "reason": "Votre CEID conserve votre progression sur tous vos appareils." }
     }
   }

2. Connectez le joueur

   signin.jsCopier

   if (window.casaTookan?.ceid?.available) {
     const { nonce } = await fetch('/auth/nonce').then((r) => r.json());
     const { token } = await window.casaTookan.ceid.signIn({ nonce });
     await fetch('/auth/casa', { method: 'POST', body: token });
   }

3. Vérifiez le jeton sur votre serveur

   server.js · joseCopier

   import { createRemoteJWKSet, jwtVerify } from 'jose';
   
   const JWKS = createRemoteJWKSet(new URL('https://ctserver.everdreamsoft.com/.well-known/jwks.json'));
   
   const { payload } = await jwtVerify(token, JWKS, {
     issuer: 'https://ctserver.everdreamsoft.com',
     audience: 'https://orbquest.game',
     clockTolerance: 60,
   });
   // vérifiez payload.nonce, puis identifiez le joueur par payload.ceid

Avant de publier

Six vérifications. Vos coches sont enregistrées dans ce navigateur.

• Connectez, signez et envoyez une fois dans le navigateur de Casa Tookan, sur iOS et sur Android.
• Changez de casa depuis la barre d’adresse : votre page suit accountsChanged.
• Votre manifest passe le validateur, images et CORS compris.
• Le splash se termine dès que votre premier écran est dessiné, sans attendre la limite de 10 secondes.
• Les callbacks de connexion sont en https://, et chaque challenge est à usage unique.
• Signatures et jetons sont vérifiés sur votre serveur : une vérification dans la page seule ne suffit pas.

Boîte à outils