トークン化株式を Solana の貸付市場に載せる:発行体に何を止められるかを知ってから
Solana の貸付市場に Token-2022 のトークン化株式(たとえば Kamino の xStocks TSLAx)を載せる前に、3 つのことをする。その mint の発行体が保有者に何をできるかを採点する。変わったら CI が落ちるように固定する。いちばん強い権限を市場の本番のバイナリで再生して、どの操作が止まるかを見る。
完成図
最後には、こうなる。載せる候補の mint をすべて採点し、発行体の権限が変わったら終了コード 1 で止まる上場前の検査。その権限の 1 つが Kamino の本番の貸付バイナリに何をするかの再生。そして、今日の時点で読んだ市場全体の調査。mainnet には読み取りの要求しか送らない。本物の鍵は使わず、再生の取引はローカルの LiteSVM の中でテスト用の鍵で署名する。下は、私たちが実際に動かしたときの出力だ。



動かしてみる (約 11 分)
- 1
載せる候補の mint を採点する
約 3 分mkdir listing-check && cd listing-check # needs Node 18+ npm init -y && npm i github:psyto/issuer-powers # save check.mjs (below), then: node check.mjscheck.mjs
// Grade each mint's issuer powers; pin them on the first run, then fail on any change. import { existsSync, readFileSync, writeFileSync } from "node:fs"; import { readIssuerPowers, assess, gating, diffPowers } from "issuer-powers"; const RPC = process.env.RPC ?? "https://api.mainnet-beta.solana.com"; // read-only const MINTS = { TSLAx: "XsDoVfqeBukxuZHWhdvWHBhgEHjGNst4MLodqsJHzoB", // xStocks NVDAon: "gEGtLTPNQ7jcg25zTetkbmF7teoDLcrfTnQfmn2ondo", // Ondo USDC: "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", }; const pins = existsSync("pins.json") ? JSON.parse(readFileSync("pins.json", "utf8")) : {}; let drift = 0; for (const [name, mint] of Object.entries(MINTS)) { const p = await readIssuerPowers(mint, RPC); const a = assess(p); console.log(`${name.padEnd(7)} ${a.level.padEnd(10)} gating=${gating(p).model}`); for (const why of a.custodial) console.log(` ${why}`); if (!pins[name]) pins[name] = p; else for (const d of diffPowers(pins[name], p)) (drift++, console.log(` DRIFT ${d}`)); } writeFileSync("pins.json", JSON.stringify(pins, null, 1)); process.exit(drift ? 1 : 0);見える結果
TSLAx custodial gating=latent permanentDelegate=5aMN…FvEq (move or burn any holder's balance) NVDAon haltable gating=latent USDC haltable gating=boundarymint ごとに、公開の mainnet RPC へ読み取りだけの getAccountInfo を 1 回送る。鍵は要らない。assess は、いちばん強い権限で採点する。TSLAx(xStocks)は、どの保有者の残高でも動かしたり焼却したりできる permanent delegate を持つので custodial。Ondo の mint(NVDAon)と USDC は凍結の権限を持つので haltable だ。gating は、保有者のあいだの送金がどう制限されるかを示す。latent は、今は自由に動くが、hook や凍結の権限で後から制限をかけられる状態。boundary は、送金時に何も確かめない状態。採点は mint についての事実で、発行体への評価ではない。最初の実行で pins.json が書かれる。
- 2
固定して、変化を CI が捕まえるのを見る
約 2 分node check.mjs; echo "exit $?" # same powers as the pin: exit 0 # replay a delegate rotation: put another address in the pin node -e 'const fs=require("fs"),p=JSON.parse(fs.readFileSync("pins.json")),t=p.TSLAx;t.permanentDelegate=t.extensionAuthorities["permanentDelegate.delegate"]="PrevDe1egate111111111111111111111111111111";fs.writeFileSync("pins.json",JSON.stringify(p))' node check.mjs; echo "exit $?"見える結果
TSLAx custodial gating=latent permanentDelegate=5aMN…FvEq (move or burn any holder's balance) NVDAon haltable gating=latent USDC haltable gating=boundary exit 0 TSLAx custodial gating=latent permanentDelegate=5aMN…FvEq (move or burn any holder's balance) DRIFT authorities.permanentDelegate.delegate: expected "PrevDe1egate111111111111111111111111111111", got "5aMNNLQJwAEeoemTEMkv5NVjqKwvvefRYCQ5Z67HFvEq" NVDAon haltable gating=latent USDC haltable gating=boundary exit 1diffPowers は、固定した状態と今の状態を比べる。すべての権限、拡張の組み合わせ、hook のプログラムだ。Token-2022 の mint は初期化したあとに permanent delegate を足せないが、delegate はその権限を別のアドレスに渡せる。ここでは固定側を書き換えてその変化を再現し、実行は終了コード 1 で止まる。これを走らせる CI は、そこで落ちる。一時停止のフラグと scaled-UI の倍率はふだんの運用で動くので、比べない。だから一時停止は、別に確かめる。
- 3
delegate の権限を Kamino の本番のバイナリで再生する
約 5 分cd .. # needs Rust (cargo), the Solana CLI and Python 3 git clone https://github.com/psyto/issuer-drill && cd issuer-drill scripts/dump-programs.sh # read-only: klend and Token-2022 from mainnet cargo run --release 2>/dev/null | sed 's/Program KLend.*Program log: //' | grep -A8 -E '^## seize-1(\+refill)?:'見える結果
Wrote program to klend.so Wrote program to token_2022.so 6482390f659a6774b059768313b6f701b14819110f9e10db8fa651a311e9c97b klend.so 15a2e615a42e20f31714bbaaee43002ae6f1cda2e8d7118243117ab3c1342e2d token_2022.so ## seize-1: permanent delegate moves 1 raw unit (1e-8 TSLAx) out of Kamino's TSLAx vault TSLAx vault 729892224197 -> 729892224196 raw units liquidate TSLAx-backed loan REFUSED panicked at 'attempt to subtract with overflow', programs/klend/src/lending_market/lending_checks.rs:442:9 borrower repays USDC ok TSLAx depositor withdraws REFUSED panicked at 'attempt to subtract with overflow', programs/klend/src/lending_market/lending_checks.rs:442:9 depositor takes cTokens out ok TSLAx borrower repays TSLAx REFUSED panicked at 'attempt to subtract with overflow', programs/klend/src/lending_market/lending_checks.rs:442:9 new TSLAx deposit REFUSED panicked at 'attempt to subtract with overflow', programs/klend/src/lending_market/lending_checks.rs:442:9 lend USDC (other reserve) ok -- ## seize-1+refill: as seize-1, then anyone sends 1 raw unit back into the vault TSLAx vault 729892224197 -> 729892224197 raw units liquidate TSLAx-backed loan ok borrower repays USDC ok TSLAx depositor withdraws ok depositor takes cTokens out ok TSLAx borrower repays TSLAx ok new TSLAx deposit ok lend USDC (other reserve) okLiteSVM で、Kamino の mainnet の klend のバイナリと Token-2022 を、xStocks 市場の 1 スロット分の mainnet のスナップショット(スロット 465177911)に対して動かす。発行体の鍵はテスト用の鍵に置き換えてあるので、実行が発行体として操作できる。置き換えたものは、すべて README に一覧がある。Kamino は、預け手全員の TSLAx を 1 つの金庫に置いている。だから delegate がそこから 1 raw unit(1e-8 TSLAx)動かすと、全ポジションで清算、引き出しと償還、TSLAx の返済、新しい預け入れが panic する。USDC の返済、cToken の持ち出し、USDC の貸し出しは動く。誰かがその 1 単位を戻せば、すべて元どおり動く。絞り込まずに実行すると、一時停止、hook の設定、金庫の凍結も表に出る。この 3 つは、Kamino 自身の検査がエラーで拒む。ハッシュは、README が 2026-11-04 に取得したものと同じだ。
- 4
今日の市場全体を調べる
約 1 分python3 tools/vault_slack.py 5wJeMrUYECGq41fxRESKALVcHnNX26TAWy4W98yULsua # read-only見える結果
MSTRx $ 9,053,971 vault=8132552631585 avail=8132552631585 slack=0 deleg=5aMNNLQJwAEeoemTEMkv5NVjqKwvvefRYCQ5Z67HFvEq USDC $ 5,845,809 vault=399725254944 avail=399725254944 slack=0 deleg=None SPYx $ 3,850,449 vault=495779384820 avail=495779384820 slack=0 deleg=5aMNNLQJwAEeoemTEMkv5NVjqKwvvefRYCQ5Z67HFvEq QQQx $ 3,726,206 vault=537743268258 avail=537743268258 slack=0 deleg=5aMNNLQJwAEeoemTEMkv5NVjqKwvvefRYCQ5Z67HFvEq GOOGLx $ 3,392,202 vault=1144107960561 avail=1144107960561 slack=0 deleg=5aMNNLQJwAEeoemTEMkv5NVjqKwvvefRYCQ5Z67HFvEq TSLAx $ 2,693,983 vault=690009984179 avail=690009984179 slack=0 deleg=5aMNNLQJwAEeoemTEMkv5NVjqKwvvefRYCQ5Z67HFvEq NVDAx $ 2,033,429 vault=1243396039981 avail=1243396039981 slack=0 deleg=5aMNNLQJwAEeoemTEMkv5NVjqKwvvefRYCQ5Z67HFvEq CRCLx $ 1,015,958 vault=1634686279997 avail=1634686279997 slack=0 deleg=5aMNNLQJwAEeoemTEMkv5NVjqKwvvefRYCQ5Z67HFvEq cbBTC $ 303,923 vault=472517849 avail=472517849 slack=0 deleg=None HOODx $ 289,218 vault=371722130458 avail=371722130458 slack=0 deleg=5aMNNLQJwAEeoemTEMkv5NVjqKwvvefRYCQ5Z67HFvEq AAPLx $ 280,900 vault=78550588862 avail=78550588862 slack=0 deleg=5aMNNLQJwAEeoemTEMkv5NVjqKwvvefRYCQ5Z67HFvEq USDG $ 11,862 vault=2518743439 avail=2518743439 slack=0 deleg=2apBGMsS6ti9RyF5TwQTDswXBWskiJP2LD4cUEDqYJjk METAx $ 1 vault=100000 avail=100000 slack=0 deleg=5aMNNLQJwAEeoemTEMkv5NVjqKwvvefRYCQ5Z67HFvEqKamino の xStocks 市場のリザーブすべてを、1 スロットで読む。供給額、金庫の残高とリザーブ自身の帳簿の差(slack)、トークンの permanent delegate だ。10 の xStocks のリザーブは同じ delegate を持ち、slack はすべて 0。手順 3 で TSLAx のリザーブが止まったのと同じ条件だ(最後まで動かしたのは TSLAx だけ)。slack が負なら、金庫がすでに帳簿を下回っているということになる。USDC と cbBTC には delegate がなく、USDG は別の delegate を持つ。リザーブの一覧は Kamino の公開 API から、残りは公開の RPC から読み、clone の中の fixtures/vault_slack.json を書き換える。
なぜ必要か:実際に起きたこと(実測)
- 2026-11-04 Kamino の mainnet のバイナリと、1 スロット分のスナップショットで再生した。TSLAx の mint の permanent delegate が、リザーブの金庫から 1 raw unit(1e-8 TSLAx)を動かす。その単位が戻されるまで、全ポジションで TSLAx の預け入れ、引き出しと償還、TSLAx の返済、TSLAx を担保にしたローンの清算が止まった。その市場では、供給が合計約 2,210 万ドルの 10 の xStocks のリザーブが同じ delegate を持ち、金庫の slack は 0 だった。Kamino には klend#95 として報告した。これは mint が許していることで、発行体が実際にしたことではない。 出典 (新しいタブで開きます)
- 2026-11-14 スロット 469475563 での私たちの調査:同じ 10 のリザーブは slack が 0 のままで、供給は 2,630 万ドルだった。mainnet の klend のバイナリの sha256 は 2026-11-04 と同じで、klend#95 はまだ閉じていなかった。 出典 (新しいタブで開きます)
組み立てる:部品
1. 発行体の権限を採点し、CI で固定する: issuer-powers (新しいタブで開きます)
mint の Token-2022 の拡張を読んで採点する。custodial(permanent delegate)、haltable(凍結、一時停止、凍結状態で始まる口座)、mutable(scaled UI、hook、手数料、発行や閉鎖の権限)、benign。gating は、保有者のあいだの送金がどこで制限されるかを示す。diffPowers は、名前で扱っていない拡張も含めて、すべての権限を比べる。TypeScript、ESM、実行時の依存なし。ネットワークを使うのは readIssuerPowers だけ。Apache-2.0。
npm i github:psyto/issuer-powersimport { readIssuerPowers, assess, gating, diffPowers } from "issuer-powers";
const p = await readIssuerPowers(mint, RPC); // one getAccountInfo, jsonParsed
assess(p).level; // "custodial" | "haltable" | "mutable" | "benign"
gating(p).model; // "latent", "boundary", "per-transfer", …
diffPowers(pinned, p); // [] while nothing changed2. 権限を市場の本番のバイナリで再生する: issuer-drill (新しいタブで開きます)
1 つの発見を再現するための道具で、ライブラリではない。自分の市場に持ち出せるのは 2 つ。プロトコルの mainnet のバイナリを、1 スロット分の mainnet のスナップショットに対して LiteSVM で動かすやり方(src/main.rs、tools/snapshot.py)と、金庫の slack と permanent delegate を市場全体で調べる tools/vault_slack.py だ。Rust、Solana CLI、Python 3 が要る。Apache-2.0。
git clone https://github.com/psyto/issuer-drill && cd issuer-drill
scripts/dump-programs.sh && cargo run --release
python3 tools/vault_slack.py <market> # any Kamino market: vault slack and delegates深く学ぶ(この順で)
- Token-2022 の permanent delegate: 何ができるか、どう設定し手放すか、そしてトークンがまとめて置かれる場所で一番効く理由。
- Token-2022 の拡張 (新しいタブで開きます): issuer-powers が読むほかの権限:凍結、一時停止、transfer hook、scaled UI amount、default account state。
- Solana Internals 12 章:金庫のプログラム: プログラムが預け入れを 1 つの金庫にまとめ、その横で自分の帳簿をつけるしくみ。
- Kamino-Finance/klend#95 (新しいタブで開きます): 報告の本文:通る処理、送金後の検査がオーバーフローする箇所、戻せばリザーブが動く理由。
- issuer-drill:本物の部分とそうでない部分 (新しいタブで開きます): 再生が置き換えているものの一覧。信じる前、使い回す前に。
本番の前に
- 上場前の検査を定期的に、そして上場の設定を変える前に毎回走らせる。一時停止は別に確かめる。diffPowers は、一時停止のフラグをわざと比べない。
- 載せる市場で、リザーブごとの金庫の slack を調べる。金庫が帳簿を下回ったリザーブは、再生で止まった状態そのものだ。再生では、足りない分を戻すとリザーブは動いた。 開く (新しいタブで開きます)
- 市場のバイナリのハッシュが変わったら、再生をもう一度走らせる。直っていれば、panic の行がきちんとしたエラーか ok に変わる。 開く (新しいタブで開きます)
- issuer-drill が最後まで動かしたのは、TSLAx のリザーブだけ。ほかのリザーブは delegate と金庫の slack を調べただけで、実行していない。発行体の鍵はテスト用の鍵。TSLAx の値段は、1 件のローンを清算できるように 0.76 倍にしてある。Kamino 側の対応(設定、緊急モード、プログラムの更新)は再現していない。バイナリと klend のソースの対応は、メッセージの file:line から推定したものだ。
- 発行体が実際にこれらの権限をどう使うかは、ここではわからない。示しているのは、mint が何を許しているかと、権限が使われたときに市場がどうなるかだ。
- issuer-powers はまだ npm にない。GitHub から入れるので、コミットを固定して使う(github:psyto/issuer-powers#<commit>)。どちらの部品も mainnet には何も送らない(issuer-drill の取引は LiteSVM の中だけで、テスト用の鍵で動く)。どちらも監査前。
通した記録
2026-11-14 公開リポジトリから、2026-11-14 の UTC 21:16 から 21:18 に 4 つの手順をたどった。issuer-powers が DRIFT を 1 行で出すようになったあと、21:53 に新しいフォルダで手順 1 と 2 をもう一度実行した(上の出力はこのときのもの)。npm i github:psyto/issuer-powers(269a636 に解決。先に f8f6f05 で SSH なしでも入ることを確認)、上の check.mjs を mainnet に対して実行(269a636 での issuer-powers 自身の試験は 31 件通過)。psyto/issuer-drill の d07ad1f を新しく clone し、scripts/dump-programs.sh(sha256 は上のとおりで README と同じ)と cargo run --release(7 つの場面すべて README の表のとおり。out/results.json は変化なし)。続けて tools/vault_slack.py をスロット 469475563 で実行した。最初の通しは、この環境で計算機の時間が約 70 秒(cargo のビルドが 45 秒、crate は取得済み)。上の分数は、読んで貼り付ける時間込みの目安だ。画像は、これらの出力を描画したもの。
Fabrknt は独立していて、Kamino、xStocks、Ondo とは提携していない。部品は監査前。