Casa Estates ID でサインイン

CEID

Casa Estates ID はプレイヤーのアカウントで、Farcaster の id と同じく公開されています。プレイヤーがアドレスを一度も開示しないこともあります。ブロックチェーンを使わないゲームでも、数か月後の報酬配布のときに初めてアドレスが必要になるゲームでも、同じように動作します。

流れ

1. サーバーが nonce を作るランダムで、使い捨てで、有効期間が短く、トークンを受け取るセッションに結び付いたもの。
2. ページが依頼するsignIn({ nonce })。Casa Tookan はあなたの名前、アイコン、ドメインを表示したシートを出します。初回はプレイヤーの CEID を作成します。入力するものは何もありません。
3. プレイヤーが承認するCasa Tookan のネイティブ署名機能の中で、CEID の鍵があなたの nonce を含む内容に署名します。プレイヤーのリカバリーフレーズがそこから出ることはありません。
4. Casa Tookan のサーバーがトークンを発行する署名と端末を確認し、事実情報を加え、あなたのオリジン（aud）向けの JWT に署名します。
5. あなたのサーバーが検証する公開鍵（JWKS）に対して検証します。Casa Tookan を呼び出す必要はありません。その後、共有されたアドレスをあなた自身がオンチェーンで読み取ります。プレイヤーが何を持っているかについて、ウォレットを信用してはいけません。
6. 後から、アドレスを求めるドロップやインベントリなど、必要になったときに requestAddresses({ nonce, chains, reason }) を呼びます。新しいトークンにアドレスが含まれます。

マニフェスト

Wallet App Manifest で宣言します：casatookan:identity.ceid 機能と、wallet.extensions.casatookan の下の identity オブジェクトです。これは Casa Tookan 独自のもので、ほかのウォレットは無視します。

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

ページ内

マニフェストで casatookan:identity.ceid を宣言すると、Casa Tookan のブラウザ内で利用できます。呼び出しが失敗すると、理由を示す code を持つエラーで reject されます：

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

// 数か月後、ドロップのために
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?',
});

トークン

Casa Tookan のサーバーが署名した JWT（ES256）で、24時間有効です。その後は新しいトークンを求めてください。何も変わっていなければシートは表示されません。

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

サーバーで検証する

ページの中だけで検証してはいけません。ブラウザでしか確認していないトークンは、プレイヤーが偽造できます。

1. 署名https://ctserver.everdreamsoft.com/.well-known/jwks.json の鍵に対して検証します（キャッシュし、kid に従ってください）。これらは本番のトークンにしか署名しないため、開発用のトークンはそれだけで検証に失敗します。
2. オーディエンスと発行者aud があなたのオリジンと完全に一致し、iss が Casa Tookan のサーバーであること。
3. nonceこのセッションのためにあなたが発行した、未使用のもの。使ったら破棄します。
4. 時刻exp を過ぎていないこと（時計のずれを1分まで許容）。

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; // プレイヤーは payload.ceid をキーにする
}

開発ビルド

Casa Tookan Dev でテストしてください。その CEID は本番のものとは分けられており、https://ctserver.everdreamsoft.com/.well-known/jwks-dev.json で公開される開発用の鍵で署名されます。ステージングサーバーはそちらを参照して env === "development" を確認し、本番サーバーは本番の鍵のままにしておけば、テスト用アカウントを目にすることはありません。メインアプリの TestFlight ビルドは本番として証明されるので、テストには使わないでください。

複数アカウント

アプリごとにアドレスを共有する仕組みは、ひとりが複数人としてプレイすることを防ぐためのものではありません。対策は攻撃の種類ごとに次のとおりです。

プレイヤーに適用されるルール

プライバシー

プレイグラウンドで試す

開発者向けプレイグラウンドのミニアプリには CEID タブがあり、上記のすべてのシナリオを再現できます：初回サインイン、アドレスなしでのプレイ、ドロップ、拒否、期限切れ・再利用・別オリジンのトークン、名前の変更、新しいフレーズ、アンチシビルのしきい値。環境、マニフェスト、プロバイダー、ディープリンクのタブもあります。Casa Tookan で ctserver.everdreamsoft.com/playground/ を開くと、Casa Tookan のサーバーに対してサインインします（開発ビルドでは env: "development" のトークンになります）。通常のブラウザでは、独自の発行者と鍵を持つモックのウォレットとモックの発行者を相手に動作するため、モックのトークンが Casa Tookan のものとして通ることはありません。