Casa Tookan アプリを作る。

概要

マニフェスト

Casa Tookan は、どのウォレットでも読めるオープンなフォーマット Wallet App Manifest を読み込みます。中身は、あなたのサイトがおそらくすでに持っている W3C Web App Manifest に、標準にメンバーがないものだけを入れる wallet メンバーをひとつ加えたものです。

{
  "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" } }
    }
  }}

W3C 標準 青色、変更なし · 追加 ハイライト部分：拡張のすべて。

Casa Tookan が探す場所

1. https://<your-domain>/.well-known/wallet-app.json：同じ JSON を単体で配信したもの。
2. なければ、ホームページ（https://<your-domain>/）の <head> にある <link rel="manifest">。スクリプトで追加せず、配信される HTML に含めてください。

wallet メンバーを持つ最初のものがまるごと使われ、両者はマージされません。相対 URL は、マニフェストを取得した URL を基準に解決されます。

W3C 標準 そのまま再利用するメンバー

追加 wallet メンバー

すべてのフィールドは寛容に読み込まれます。チェックに通らないフィールドは無視され、残りはそのまま適用されます。

Casa Tookan のみ extensions.casatookan

identity：アプリがプレイヤーの Casa Estates ID に求めてよいもの：level（0–3）、reason（理由）、そして addresses（CAIP-2 チェーンごとに、アプリが求めることのあるアドレスの最大数。[{ "chain": "…", "max": 1–5, "reason": "…" }]）。CEID を参照してください。

association

任意のブロックチェーンアカウントで署名した、ドメインがあなたのものである証明：

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

• account：CAIP-10 アカウント。
• payload：base64url でエンコードした JSON { "domain": "your-domain", "issuedAt": "…" }。
• type：署名の種類（EVM は eip191、Bitcoin は bip322-simple）。
• signature：仕様で定義されたメッセージの署名。

Casa Tookan は保存しますが、まだ検証はしていません。今後、あなたのドメインに紐づく機能にはこれが必要になります。

画像

Farcaster ミニアプリと同じサイズなので、1 セットのファイルで両方に対応できます。アイコンは明るい背景にも暗い背景にも、丸いマスクの中にも置かれます。透過ではなく独自の背景を付け、絵柄は中央の 80 % 内に収めてください。SVG は使えません：多くのネイティブの画像ビューでは描画できないためです。バナーがない場合、ブラウザは Farcaster マニフェストの画像（3:2 のものは 1.91:1 にトリミング）を使い、それもなければ、ぼかした自身のコピーの上にアイコンを重ねて表示します。

チェーン

CAIP-2 ID。それ以外は無視されます。

ケイパビリティ

provider.* ケイパビリティと wallet.ready は、仕様のオープンレジストリに由来します。アプリをホストするどのウォレットでもそのまま提供できる名前です。Casa Tookan だけが提供するものには casatookan: プレフィックスが付き、他のウォレットはそれを無視します。旧名も引き続き有効です：casatookan.ready（現在は wallet.ready）、identity.ceid と identity.estate（現在はプレフィックス付き）。

Casa Tookan にない必須のチェーンやケイパビリティがあると、ユーザーに閉じられるお知らせが表示されます。アプリはそのまま開きます。任意のものは参考情報です。

ページ内

あなたのスクリプトより先に注入されます。署名は上記の標準プロバイダーを通して行います：Casa Tookan 専用の署名 API はありません。

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
}

window.wallet?.ready() を呼べば、それを提供するどのウォレットでもアプリが動きます。Casa Tookan かどうかを判定するのは、Casa Tookan 独自の機能を使うときだけにしてください。あなた自身のスクリプトが定義した window.wallet には手を加えません。

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

Casa Tookan による読み込み

Farcaster ミニアプリ

Casa Tookan は /.well-known/farcaster.json も読み込み、アクティブな Casa が Farcaster アカウントを持っている場合、@farcaster/miniapp-sdk で作られたミニアプリをホストします：コンテキスト、Sign In With Farcaster、ウォレット、触覚フィードバック。両方のマニフェストを配信すると、フィールドごとに、Wallet App Manifest を優先してマージされます。Wallet App Manifest が必要なのは、Casa Tookan で異なる部分を上書きしたいときか、Bitcoin と Counterparty を宣言したいときだけです。farcaster.json だけで宣言されたドメインは、その homeUrl 以下だけがアプリになります。

未対応：ミニアプリの追加とその通知（通知サーバーなし）、キャストの投稿（farcaster.xyz に引き渡し）。

プレイグラウンド

マニフェストを編集すると、Casa Tookan がそれをどう扱うかが入力に合わせて表示されます：アプリが行うチェック、あらゆるサイズのアイコン、ユーザーが目にする画面。最初は本物のマニフェスト、ctserver.everdreamsoft.com/.well-known/wallet-app.json で公開中の Dev Playground のものが入っています。名前、バナー、色を変えたり、自分のドメインから読み込んだり、マニフェストを貼り付けたりしてみてください。仕様の完全なチェックには、仕様のバリデーターを使ってください。

Dev Playground は icon-1024.png（1024 × 1024）、hero-1200x630.jpg、splash-200.png（200 × 200）を配信しています：アドレスバー、ブラウザ、アプリのページ、スプラッシュに 1 セットのファイルで対応しています。ctserver.everdreamsoft.com/playground から Casa Tookan で開いてみてください。