Créez une app Casa Tookan.

En bref

Le manifeste

Casa Tookan lit le Wallet App Manifest, un format ouvert que n’importe quel wallet peut lire : le Web App Manifest du W3C que votre site a très probablement déjà, plus un membre wallet qui ne contient que ce pour quoi le standard n’a pas de membre.

{
  "name": "Orb Quest",
  "short_name": "Orbs",
  "description": "A card game played with your Counterparty assets.",
  "start_url": "/play",
  "scope": "/",
  "background_color": "#101820",
  "categories": ["games", "trading-cards", "counterparty"],
  "icons": [{ "src": "/icon-1024.png", "sizes": "1024x1024", "type": "image/png" }],
  "screenshots": [{ "src": "/shots/duel.png", "sizes": "1284x2778", "form_factor": "narrow" }],
  "wallet": {
    "version": "1",
    "subtitle": "Duel with your orbs",
    "heroImageUrl": "/hero-1200x630.png",
    "splashImageUrl": "/splash-200.png",
    "chains": { "required": ["bip122:000000000019d6689c085ae165831e93"], "optional": ["eip155:8453"] },
    "capabilities": {
      "required": ["provider.counterparty", "wallet.ready"],
      "optional": ["casatookan:identity.ceid"]
    },
    "extensions": {
      "casatookan": { "identity": { "level": 1, "reason": "One player per device" } }
    }
  }}

Standard W3C en bleu, inchangé · Ajouté en surbrillance : toute l’extension.

Où Casa Tookan le trouve

1. https://<your-domain>/.well-known/wallet-app.json : le même JSON, servi seul ;
2. sinon le <link rel="manifest"> du <head> de votre page d’accueil (https://<your-domain>/). Gardez-le dans le HTML servi : un lien ajouté par un script n’est pas vu.

Le premier qui a un membre wallet est utilisé en entier : les deux ne sont pas fusionnés. Les URL relatives sont résolues par rapport à l’URL d’où le manifeste a été récupéré.

Standard W3C Membres repris tels quels

Ajouté Le membre wallet

Chaque champ est lu avec indulgence : celui qui échoue à sa vérification est ignoré, le reste s’applique quand même.

Casa Tookan uniquement extensions.casatookan

identity : ce que votre app peut demander au Casa Estates ID du joueur : level (0–3), une reason, et addresses, le plus grand nombre d’adresses par chaîne CAIP-2 qu’elle demandera jamais ([{ "chain": "…", "max": 1–5, "reason": "…" }]). Voir CEID.

association

La preuve que le domaine vous appartient, signée par n’importe quel compte blockchain :

"association": {
  "account": "eip155:1:0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266",
  "payload": "eyJkb21haW4iOiJvcmJxdWVzdC5nYW1lIn0",
  "type": "eip191",
  "signature": "0x…"
}

• account : un compte CAIP-10 ;
• payload : du JSON en base64url { "domain": "your-domain", "issuedAt": "…" } ;
• type : le type de signature, eip191 pour EVM, bip322-simple pour Bitcoin ;
• signature : la signature du message défini dans la spécification.

Casa Tookan l’enregistre sans la vérifier pour l’instant. Elle sera exigée pour tout ce qui est propre à votre domaine.

Images

Les mêmes tailles que les mini apps Farcaster : un seul jeu de fichiers sert aux deux. L’icône se pose sur des fonds clairs et sombres et dans des masques ronds : donnez-lui un fond opaque, et gardez le dessin dans les 80 % centraux. Pas de SVG : beaucoup de vues d’image natives ne savent pas l’afficher. Sans bannière, Explorer se rabat sur les images de votre manifeste Farcaster (celles en 3:2 sont recadrées en 1,91:1), puis sur votre icône posée sur une copie floutée d’elle-même.

Chaînes

Des identifiants CAIP-2. Tout le reste est ignoré.

Capacités

Les capacités provider.* et wallet.ready viennent du registre ouvert de la spécification : des noms que tout wallet qui héberge des apps peut proposer tels quels. Ce que seul Casa Tookan propose porte son préfixe casatookan: ; les autres wallets l’ignorent. Les anciens noms restent acceptés : casatookan.ready (désormais wallet.ready), identity.ceid et identity.estate (désormais préfixés).

Une chaîne ou une capacité obligatoire qui manque à Casa Tookan affiche à l’utilisateur un avertissement que l’on peut fermer ; votre app s’ouvre quand même. Les optionnelles sont informatives.

Dans la page

Injecté avant vos propres scripts. La signature passe par les providers standard ci-dessus : il n’y a pas d’API de signature propre à Casa Tookan.

window.wallet = {
  ready(),        // hide the splash screen (the neutral name)
};

window.casaTookan = {   // Casa Tookan’s own
  isCasaTookan: true,
  version: '1',
  ready(),        // the same, by its former name
  ceid,           // Casa Estates ID sign-in
};

if (window.casaTookan?.isCasaTookan) {
  // running inside Casa Tookan: ceid is there
}

Appelez window.wallet?.ready() et votre app fonctionne dans tout wallet qui le propose ; ne testez la présence de Casa Tookan que pour ce qui lui est propre. Un window.wallet défini par vos propres scripts est laissé tel quel.

window.addEventListener('load', () => {
  renderFirstScreen();
  window.wallet?.ready();
});

Comment Casa Tookan le lit

Mini apps Farcaster

Casa Tookan lit aussi /.well-known/farcaster.json et héberge les mini apps construites avec @farcaster/miniapp-sdk quand la casa active possède un compte Farcaster : contexte, Sign In With Farcaster, le wallet, les retours haptiques. Servez les deux manifestes et ils sont fusionnés champ par champ, le Wallet App Manifest d’abord. Vous n’avez besoin d’un Wallet App Manifest que pour remplacer ce qui diffère dans Casa Tookan, ou pour déclarer Bitcoin et Counterparty. Un domaine déclaré par farcaster.json seul n’est l’app qu’à son homeUrl et en dessous.

Non pris en charge : l’ajout de la mini app et ses notifications (pas de serveur de notifications), la publication de casts (confiée à farcaster.xyz).

Playground

Modifiez un manifeste et voyez, au fil de la frappe, ce que Casa Tookan en fait : les vérifications que l’app applique, votre icône à toutes les tailles, et les écrans que vos utilisateurs verront. Il démarre avec un vrai manifeste, celui du Dev Playground, en ligne à ctserver.everdreamsoft.com/.well-known/wallet-app.json. Changez son nom, sa bannière ou sa couleur, chargez votre propre domaine, ou collez votre manifeste. Pour les vérifications complètes de la spécification, utilisez le validateur de la spécification.

Le Dev Playground sert icon-1024.png (1024 × 1024), hero-1200x630.jpg et splash-200.png (200 × 200) : un seul jeu de fichiers pour la barre d’adresse, Explorer, la fiche de l’app et l’écran de lancement. Ouvrez-le dans Casa Tookan depuis ctserver.everdreamsoft.com/playground.