# トークン化株式を Solana の貸付市場に載せる：発行体に何を止められるかを知ってから

Solana の貸付市場に Token-2022 のトークン化株式(たとえば Kamino の xStocks TSLAx)を載せる前に、3 つのことをする。その mint の発行体が保有者に何をできるかを採点する。変わったら CI が落ちるように固定する。いちばん強い権限を市場の本番のバイナリで再生して、どの操作が止まるかを見る。

## 完成図

最後には、こうなる。載せる候補の mint をすべて採点し、発行体の権限が変わったら終了コード 1 で止まる上場前の検査。その権限の 1 つが Kamino の本番の貸付バイナリに何をするかの再生。そして、今日の時点で読んだ市場全体の調査。mainnet には読み取りの要求しか送らない。本物の鍵は使わず、再生の取引はローカルの LiteSVM の中でテスト用の鍵で署名する。下は、私たちが実際に動かしたときの出力だ。

- 上場前の検査:TSLAx は custodial(permanent delegate がある)、Ondo の mint と USDC は haltable。固定した delegate を書き換えると、次の実行は DRIFT を出して終了コード 1 で止まる。 (https://fabrknt.com/recipes/stock-lending-listing/check.jpg)
- LiteSVM で動かした Kamino の本番のバイナリ。TSLAx の金庫から 1 raw unit 抜くと、4 つの操作が panic する(lending_checks.rs:442)。1 raw unit 戻すと、すべて動く。 (https://fabrknt.com/recipes/stock-lending-listing/drill.jpg)
- 2026-11-14 の Kamino の xStocks 市場:10 の xStocks のリザーブが同じ permanent delegate を持ち、どの金庫も余り(slack)が 0。 (https://fabrknt.com/recipes/stock-lending-listing/survey.jpg)

## 動かしてみる (~11 min)

### 1. 載せる候補の mint を採点する (~3 min)

```bash
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.mjs
```

`check.mjs`:

```js
// 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=boundary
```

mint ごとに、公開の 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 min)

```bash
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 1
```

diffPowers は、固定した状態と今の状態を比べる。すべての権限、拡張の組み合わせ、hook のプログラムだ。Token-2022 の mint は初期化したあとに permanent delegate を足せないが、delegate はその権限を別のアドレスに渡せる。ここでは固定側を書き換えてその変化を再現し、実行は終了コード 1 で止まる。これを走らせる CI は、そこで落ちる。一時停止のフラグと scaled-UI の倍率はふだんの運用で動くので、比べない。だから一時停止は、別に確かめる。

### 3. delegate の権限を Kamino の本番のバイナリで再生する (~5 min)

```bash
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)      ok
```

LiteSVM で、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 min)

```bash
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=5aMNNLQJwAEeoemTEMkv5NVjqKwvvefRYCQ5Z67HFvEq
```

Kamino の 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 が許していることで、発行体が実際にしたことではない。 (https://github.com/Kamino-Finance/klend/issues/95)
- 2026-11-14: スロット 469475563 での私たちの調査:同じ 10 のリザーブは slack が 0 のままで、供給は 2,630 万ドルだった。mainnet の klend のバイナリの sha256 は 2026-11-04 と同じで、klend#95 はまだ閉じていなかった。 (https://github.com/psyto/issuer-drill/blob/main/tools/vault_slack.py)

## 組み立てる：部品

### 1. 発行体の権限を採点し、CI で固定する: issuer-powers

https://github.com/psyto/issuer-powers

mint の Token-2022 の拡張を読んで採点する。custodial(permanent delegate)、haltable(凍結、一時停止、凍結状態で始まる口座)、mutable(scaled UI、hook、手数料、発行や閉鎖の権限)、benign。gating は、保有者のあいだの送金がどこで制限されるかを示す。diffPowers は、名前で扱っていない拡張も含めて、すべての権限を比べる。TypeScript、ESM、実行時の依存なし。ネットワークを使うのは readIssuerPowers だけ。Apache-2.0。

```bash
npm i github:psyto/issuer-powers
```

```ts
import { 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 changed
```

### 2. 権限を市場の本番のバイナリで再生する: issuer-drill

https://github.com/psyto/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。

```bash
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
```

## 深く学ぶ（この順で）

1. [Token-2022 の permanent delegate](https://fabrknt.com/ja/dojo/topics/solana-token-2022-permanent-delegate): 何ができるか、どう設定し手放すか、そしてトークンがまとめて置かれる場所で一番効く理由。
2. [Token-2022 の拡張](https://spl.solana.com/token-2022/extensions): issuer-powers が読むほかの権限：凍結、一時停止、transfer hook、scaled UI amount、default account state。
3. [Solana Internals 12 章：金庫のプログラム](https://fabrknt.com/ja/dojo/courses/solana-internals-en/lessons/solana-internals-ch12-vault-en): プログラムが預け入れを 1 つの金庫にまとめ、その横で自分の帳簿をつけるしくみ。
4. [Kamino-Finance/klend#95](https://github.com/Kamino-Finance/klend/issues/95): 報告の本文：通る処理、送金後の検査がオーバーフローする箇所、戻せばリザーブが動く理由。
5. [issuer-drill：本物の部分とそうでない部分](https://github.com/psyto/issuer-drill#what-is-real-and-what-is-not): 再生が置き換えているものの一覧。信じる前、使い回す前に。

## 本番の前に

- 上場前の検査を定期的に、そして上場の設定を変える前に毎回走らせる。一時停止は別に確かめる。diffPowers は、一時停止のフラグをわざと比べない。
- 載せる市場で、リザーブごとの金庫の slack を調べる。金庫が帳簿を下回ったリザーブは、再生で止まった状態そのものだ。再生では、足りない分を戻すとリザーブは動いた。 (https://github.com/psyto/issuer-drill/blob/main/tools/vault_slack.py)
- 市場のバイナリのハッシュが変わったら、再生をもう一度走らせる。直っていれば、panic の行がきちんとしたエラーか ok に変わる。 (https://github.com/Kamino-Finance/klend/issues/95)
- 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 とは提携していない。部品は監査前。
