本文へ移動
← 市場レシピ

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

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

今すぐ動かす(約 11 分) ↓AI エージェント向けに、同じレシピを Markdown で: /llms/ja/recipes/stock-lending-listing.md

完成図

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

Solana mainnetToken-2022 の株の mint発行体:permanent delegate凍結・一時停止・hook・scaled UI貸付市場(Kamino)リザーブごとに 1 つの共有の金庫金庫と帳簿が合っている必要トークンを動かせる金庫からもmint を読むバイナリ・スナップショット・金庫手元と CI(mainnet は読むだけ)issuer-powers採点:custodial・haltable・…権限を固定するdiffPowers:変われば exit 1issuer-drillLiteSVM:mainnet の klend と Token-2022権限ごとに再生し、止まる操作を見るvault_slack.py:全リザーブどの権限が何を止めるか
上場前の検査:TSLAx は custodial(permanent delegate がある)、Ondo の mint と USDC は haltable。固定した delegate を書き換えると、次の実行は DRIFT を出して終了コード 1 で止まる。
上場前の検査:TSLAx は custodial(permanent delegate がある)、Ondo の mint と USDC は haltable。固定した delegate を書き換えると、次の実行は DRIFT を出して終了コード 1 で止まる。
LiteSVM で動かした Kamino の本番のバイナリ。TSLAx の金庫から 1 raw unit 抜くと、4 つの操作が panic する(lending_checks.rs:442)。1 raw unit 戻すと、すべて動く。
LiteSVM で動かした Kamino の本番のバイナリ。TSLAx の金庫から 1 raw unit 抜くと、4 つの操作が panic する(lending_checks.rs:442)。1 raw unit 戻すと、すべて動く。
2026-11-14 の Kamino の xStocks 市場:10 の xStocks のリザーブが同じ permanent delegate を持ち、どの金庫も余り(slack)が 0。
2026-11-14 の Kamino の xStocks 市場:10 の xStocks のリザーブが同じ permanent delegate を持ち、どの金庫も余り(slack)が 0。

動かしてみる (約 11 分)

  1. 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.mjs

    check.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=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. 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 1

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

  3. 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)      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. 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=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 を書き換える。

なぜ必要か:実際に起きたこと(実測)

組み立てる:部品

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-powers
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 (新しいタブで開きます)

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

深く学ぶ(この順で)

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

本番の前に

通した記録

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 とは提携していない。部品は監査前。