あなたのサイトを、すべての Casa に。

レベル 0 · 0 分

もう動いています。

サイトが MetaMask、Xverse、Magic Eden、Unisat で動くなら、Casa Tookan でも動きます。インストールする SDK も、コード内の特別扱いも要りません。

1. アプリでサイトを開く

   Casa Tookan でブラウザを開き、URL を入力します。

2. いつもどおり接続して署名する

   リクエストのたびに Casa Tookan の署名シートが開きます。あなたのサイトと署名する Casa が表示されるので、UI を作る必要はありません。

   EVM Bitcoin Counterparty

   connect.jsコピー

   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. Casa の切り替えに追従する

   ユーザーはいつでもアドレスバーから Casa を切り替えられ、ページには通常のイベントが届きます。各 Casa には専用の localStorage もあるので、セッションが混ざりません。

   connect.jsコピー

   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'));

// Just want to know you're inside 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 }],
});

// Unisat 方式：同じ fees をオプションに（signPsbts では各 PSBT のオプションに）。
await window.unisat.signPsbt(psbtHex, {
  toSignInputs,
  fees: [{ kind: 'service', address: 'bc1q…', sats: 750 }],
});

レベル 1 · リンク 1 つ

プレイヤーをまっすぐ迎え入れる。

Safari や Chrome でサイトを訪れた人は、そこにウォレットを持っていません。ボタン 1 つで、同じページが Casa Tookan の中で開きます。アプリがなければ、App Store・Google Play・「ブラウザで続ける」のページが開きます。

<a id="open-casa" href="#">
  <img src="https://casatookan.com/assets/badges/open-in-casatookan-ja-dark.svg"
       alt="Casa Tookan で開く" width="212" height="56">
</a>
<script>
  // すでに Casa Tookan の中: 開くものはありません
  if (window.casaTookan) document.getElementById('open-casa').hidden = true;
  else document.getElementById('open-casa').href =
    'https://casatookan.com/open?url=' + encodeURIComponent(location.href) + '&ref=your-app';
</script>

レベル 2 · 5 分

アプリになる。

サイトにはおそらく、すでにウェブマニフェストがあります。wallet メンバーを 1 つ追加すれば、Casa Tookan はあなたのサイトをアプリとして表示します。

1 2 3 4 5 6 7

1. 1
   バナー · wallet.heroImageUrl、1200×630
2. 2
   アイコン · icons、1024×1024、不透明
3. 3
   名前 · name、32 文字
4. 4
   サブタイトル · wallet.subtitle、30 文字
5. 5
   カテゴリ · categories の最初の値
6. 6
   チェーン · wallet.chains
7. 7
   説明 · description、170 文字

Dev Playground のページです。バリデーターが、そのマニフェストから Casa Tookan のレイアウトで描画しました。あなたのマニフェストが、これらすべてを埋めます。

• あなたの名前とアイコンアドレスバーと署名シートに
• スプラッシュ画面読み込み中、あなたの色の上にあなたのアートを
• ブラウザ › アプリ にカードバナー付きで、ワンタップで開ける
• 明確な動作要件壊れたページの代わりにお知らせを表示

1. アプリの情報を入力する

   必須なのは名前だけです。入力に合わせて JSON が更新されます。

   名前 32 文字 サブタイトル 30 文字 カテゴリ なし gamescollectiblesfinancesocialutilitymarketplaceart-creativityeducationdeveloper-tools スプラッシュの背景

   必要なチェーン

   Bitcoin Counterparty Ethereum Base Kaia ready() を呼び出す

   マニフェスト全体 wallet のみ

   まだマニフェストがないサイト向け。

   site.webmanifestコピー

   W3C 標準。すでにお持ちかもしれませんwallet、追加する部分

2. 公開する

   次のどちらかを使います。Casa Tookan は両方を確認し、wallet メンバーを持つ最初のものを使います。

   場所	選ぶとき
   ホームページの <link rel="manifest"> でリンクされた既存のマニフェスト	すでにある場合。リンクはスクリプトで追加せず、配信される HTML に含めてください。
   /.well-known/wallet-app.json	別にしておきたい場合。同じ JSON を単独で配信します。

   application/json として配信してください。画像はその隣に置きます: 1024×1024 の不透明なアイコン、1200×630 のバナー、200×200 のスプラッシュ。これは Farcaster と同じサイズなので、1 セットで両方に使えます。

3. ブラウザが読めるようにする

   /.well-known/ 以下のすべて（404 を含む）と画像に、Access-Control-Allow-Origin: * を付けてください。スマートフォンのアプリには不要ですが、バリデーターとウェブ版の Casa Tookan には必要です。これがないと、存在しない farcaster.json がネットワーク障害に見えてしまいます。

   Apache nginx

   .htaccessコピー

   # THE_REQUEST, not REQUEST_URI: still /.well-known/ after a rewrite to index.php
   <If "%{THE_REQUEST} =~ m#\s/\.well-known/#">
     Header always set Access-Control-Allow-Origin "*"
   </If>

4. 確認する

   バリデーターは公開中のマニフェストを読み込み、すべての画像をテストし、Casa Tookan が描画するとおりにアプリを表示します。Casa Tookan はマニフェストを起動ごとに 1 回読み込むので、変更を確認するにはアプリを再起動してください。

レベル 3 · 1 行

準備ができたらスプラッシュを閉じる。

capabilities で wallet.ready を宣言します。するとスプラッシュは最初の画面が描画されるまで表示されたままになり、プレイヤーが読み込み途中のページを見ることはありません。

await loadAssets();
renderTitleScreen();
window.wallet?.ready();   // the splash fades, your game is there

レベル 4 · 30 分

どこからでもログイン。

通常のブラウザやネイティブゲームから、チャレンジを付けてプレイヤーを Casa Tookan に送ります。プレイヤーは Bitcoin と Ethereum のアドレスを持って戻ってきます。どちらも署名で証明されています。パスワードも拡張機能も要りません。

1. プレイヤーを Casa Tookan に送る

   サーバーがランダムで使い捨てのチャレンジを作り、ページがリンクを開きます。

   login.jsコピー

   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. プレイヤーが承認する

   プレイヤーは署名シートであなたのサイトを確認し、Casa を選んでサインインをタップします。その後 Casa Tookan は、address、msg、sig を付けてコールバックを開きます。

   https://orbquest.game/auth/casa?address=…&msg=…&sig=…コピー

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

3. サーバーで検証する

   チャレンジが自分のもので未使用であることを確認し、次に両方の署名を確認します。注意: EVM の署名は personal_sign ではありません。

   verify.jsコピー

   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');   // then burn it
     const addr = entries(p.get('address'));
     const sig = entries(p.get('sig'));
   
     // Bitcoin: BIP-137, signed by the Legacy address.
     if (!bitcoinMessage.verify(msg, addr.bitcoin, sig.bitcoin)) throw new Error('bitcoin');
   
     // EVM: raw secp256k1 over keccak256(msg), not EIP-191.
     const signer = recoverAddress(keccak256(toUtf8Bytes(msg)), sig.ethereum);
     if (signer.toLowerCase() !== addr.ethereum.toLowerCase()) throw new Error('ethereum');
   
     return addr;
   }

レベル 5 · 半日 プレビュー

プレイヤーを知る。

Casa Estates ID は、デバイスやリカバリーフレーズをまたいで、プレイヤーごとに 1 つのアカウントです。セーブデータは変わらない番号に紐づけ、アドレスは必要なときだけ求めます。報酬を配るゲームのために作られています。

1. マニフェストで宣言する

   wallet メンバーの中に:

   site.webmanifest · walletコピー

   "capabilities": { "required": ["casatookan:identity.ceid"] },
   "extensions": {
     "casatookan": {
       "identity": { "reason": "Your CEID keeps your progress across devices." }
     }
   }

2. プレイヤーをサインインさせる

   signin.jsコピー

   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. サーバーでトークンを検証する

   server.js · joseコピー

   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,
   });
   // check payload.nonce, then key the player on payload.ceid

公開する前に

確認項目は 6 つです。チェックした状態はこのブラウザに保存されます。

• Casa Tookan のブラウザ内で、iOS と Android の両方で、接続・署名・送金を一度ずつ行う。
• アドレスバーから Casa を切り替える: ページが accountsChanged に追従する。
• マニフェストが、画像と CORS も含めてバリデーターを通過する。
• スプラッシュが、最初の画面が描画された時点で終わる（10 秒の上限に達する前）。
• ログインのコールバックは https:// で、チャレンジはそれぞれ使い捨て。
• 署名とトークンはサーバーで検証する。ページ内だけで済ませない。

ツールボックス