[yu23ki14]

なにをしたか

Goldsky が持っている情報のうち、MCP に出ていたのは ThanksToken アドレス・クエストモジュール・Open クエストの id とタイトルだけでした。エージェントが「いま何 THX 持ってる?」「先月誰が誰に送った?」「レビュー待ちは?」に答えられない状態だったので、読み取りツールを 3 本 → 7 本にします。

ツール	変更
toban_workspace_info	全 7 種の hatId、6 モジュールのアドレス、creator/owner、開設日を追加。未インデックスなら indexed: false を返して落とさない
toban_member_status	thxBalance（受け取った量）、thxSentTotal（送った累計）、roles[] を追加
toban_open_quests	status 引数（Open / PendingReview / Completed / Cancelled）と limit。報酬シェア数・説明・承認数・提出者・各タイムスタンプ・パーマリンクを追加。discordUserId は任意化
toban_quest_detail	新設 — 提出の試行履歴（取り下げ／却下／承認）と承認者一覧、IPFS メタデータ URI
toban_thx_history	新設 — 送付履歴。data を UTF-8 に復元してメッセージも返す。direction / sinceDays / limit
toban_workspace_members	新設 — ロールシェア保有者とエスクロー中のシェア
toban_reward_distributions	新設 — 分配予定日・トークン・入金/実行/返却額

署名まわりは触っていません

書き込み系（toban_thx_propose / toban_quest_submit_propose）は変更なしです。「エージェントは提案しかできず、署名するのはクリック」「行為者は Discord 署名済み interaction からしか読まない」「performThx / performQuestSubmit がチェーンへの唯一の経路」という不変条件と、turnkey/policy.json には一切手を入れていません。追加したのは全部 GraphQL の読み取りです。

レビューで見てほしいところ

1. 読み取りクエリを chain.ts ではなく新しい src/mcp/queries.ts に置きました。
chain.ts は ABI と書き込みパスの resolver を持っていて、turnkey/policy.json と並べて監査できる大きさに保ちたいためです。共有するのは postGraphQL だけ（error handling を 1 箇所に保つため export しました）。

2. ワークスペーススコープをテストで担保しています。
全クエリが treeId を filter に載せ、全リストが first を取ります（上限 100）。トークンがギルドを、ギルドがワークスペースを固定するのが読み取り側の唯一の防壁なので、「実際にインデクサーに投げた変数」を assert するテストにしました（calls[0].variables.where を検証）。

3. 「送受信の両方」は where.or ではなく 2 エイリアスで引いています。
graph-node の or は兄弟フィルタと並ぶ形になり、その兄弟がワークスペーススコープなので優先順位を推測で書きたくありませんでした。1 リクエストのままで曖昧さがありません。

4. 単位を応答自体に載せました。 ここが一番議論の余地があると思います。

数量は互換性のない 3 単位が混在します。サブグラフは ERC-20 の decimals を持っていないので、raw は原理的に換算できません。

単位	項目	計算するとき
thx	thxBalance amountThx など	換算済み。そのまま合計・比較してよい
shares	amountShares shares	ロールシェアの個数。割合の分母は 10000
raw	totalDepositedRaw など	ERC-20 の最小単位。換算しない。生の値のまま「単位未確定」と伝える

フィールド名の接尾辞に加えて、応答に units ブロック（項目 → 単位、および使った単位の注記）を付けています:

{
  "distributions": [{ "balances": [{ "totalDepositedRaw": "1000000" }] }],
  "units": {
    "fields": { "totalDepositedRaw": "raw" },
    "notes": { "raw": "ERC-20 の最小単位そのまま。小数桁をインデクサーが持っていないため未換算。…" }
  }
}

ドキュメントだけにしなかったのは、事故が起きるのは読んだ瞬間だからです。サードパーティのエージェントが読むのは JSON で、SKILL.md を配れるのは自分たちが運用する OpenClaw だけ。totalDepositedRaw: "1000000" を「100 万円ぶん」と読むのが一番ありそうな失敗で、USDC なら 1 USDC、18 桁のトークンなら 0.000000000001 と桁が 6 つ違います。

notes にはその応答で実際に使われている単位の分だけ入ります（クエスト一覧に thx の説明は付かない）。コンテキストを無駄に積まないためで、テストで担保しています。

テスト

68 → 91 全通過。新規 23 本は subgraph の fetch をスタブして、以下をカバーしています。

• ワークスペーススコープが実際にクエリへ載っていること
• 自作クエストが「完了報告できる一覧」から除外されること
• 両方向マージの並び順と件数上限
• 不正な status / sinceDays の拒否（＝インデクサーを叩かずに止まること）
• 逆引き（identity Worker）が落ちても履歴自体は返すこと
• 制御文字の除去（mintFrom は public なので data は任意のバイト列）
• *Thx / *Shares / *Raw で終わる全キーが units.fields に存在すること（新フィールドの登録漏れ検出）

デプロイ

手順に変更はありません。 新しい secret も binding も増えていないので、deploy:sepolia / deploy:base をそのまま実行できます。

ただし pkgs/openclaw/skills/toban/SKILL.md を更新しているので、Fly 側に反映するには pnpm openclaw push:config が必要です（イメージには焼き込まれていません）。

🤖 Generated with Claude Code

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated
toban	Ready	Preview	Sep 16, 2026 8:14am UTC