取引所にSolanaを追加する

このガイドでは、SolanaのネイティブトークンであるSOLを暗号資産取引所に追加する方法について説明します。

ノードのセットアップ

高性能なコンピューター/クラウドインスタンスに少なくとも2つのノードをセットアップし、新しいバージョンへのアップグレードを迅速に行い、付属の監視ツールでサービスの運用状況を常に把握することを強くお勧めします。

このセットアップにより、以下が可能になります：

データの取得および出金トランザクションの送信を行うための、Solana メインネットクラスターへの自己管理ゲートウェイを持つこと
保持する過去のブロックデータ量を完全に制御すること
一方のノードに障害が発生してもサービスの可用性を維持すること

Solanaノードは、高速なブロック処理と高いTPSに対応するため、比較的高い演算能力を必要とします。具体的な要件については、ハードウェア推奨事項をご参照ください。

APIノードを実行するには：

Solana コマンドラインツールスイートのインストール
少なくとも以下のパラメーターを指定してvalidatorを起動します：

solana-validator \
  --ledger <LEDGER_PATH> \
  --identity <VALIDATOR_IDENTITY_KEYPAIR> \
  --entrypoint <CLUSTER_ENTRYPOINT> \
  --expected-genesis-hash <EXPECTED_GENESIS_HASH> \
  --rpc-port 8899 \
  --no-voting \
  --enable-rpc-transaction-history \
  --limit-ledger-size \
  --known-validator <VALIDATOR_ADDRESS> \
  --only-known-rpc

--ledger を希望するレジャーの保存場所に、--rpc-port を公開するポートに合わせてカスタマイズしてください。

--entrypoint および --expected-genesis-hash パラメーターは、参加するクラスターに固有のものです。メインネットの現在のパラメーター

--limit-ledger-size パラメーターを使用すると、ノードがディスクに保持するレジャーshredsの数を指定できます。このパラメーターを指定しない場合、validatorはディスク容量が不足するまでレジャー全体を保持し続けます。デフォルト値では、レジャーのディスク使用量を500GB未満に抑えるよう設定されています。必要に応じて --limit-ledger-size に引数を追加することで、ディスク使用量を増減させることができます。--limit-ledger-size が使用するデフォルトの制限値については solana-validator --help を確認してください。カスタム制限値の選択に関する詳細はこちらをご覧ください。

1つ以上の --known-validator パラメーターを指定することで、悪意のあるスナップショットからの起動を防ぐことができます。既知のvalidatorでの起動の価値についての詳細

検討すべきオプションのパラメーター：

--private-rpc はRPCポートが他のノードによる使用のために公開されるのを防ぎます
--rpc-bind-address ではRPCポートをバインドする別のIPアドレスを指定できます

自動再起動と監視

データの欠落を最小限に抑えるために、各ノードを終了時に自動的に再起動するよう設定することをお勧めします。solanaソフトウェアをsystemdサービスとして実行することは、優れた選択肢の一つです。

監視ツールとして、solana-watchtowerを提供しています。これはvalidatorを監視し、solana-validator プロセスが正常でない状態を検出することができます。Slack、Telegram、Discord、またはTwilioを通じてアラートを送信するよう直接設定できます。詳細は solana-watchtower --help を実行してください。

solana-watchtower --validator-identity <YOUR VALIDATOR IDENTITY>

ドキュメントのこちらで、 Solana Watchtowerのベストプラクティスに関する詳細情報をご覧いただけます。

新しいソフトウェアリリースのアナウンス

新しいソフトウェアは頻繁にリリースされます（約1回/週）。新しいバージョンには互換性のないプロトコル変更が含まれる場合があり、ブロック処理のエラーを避けるためにタイムリーなソフトウェアアップデートが必要になることがあります。

通常リリースおよびセキュリティリリースを含むすべての種類のリリースに関する公式アナウンスは、#mb-announcement という名前のdiscordチャンネルで伝達されます（mb は mainnet-beta の略です）。

ステークを持つvalidatorと同様に、取引所が運営するvalidatorについても、通常のリリースアナウンス後1〜2営業日以内に更新されることを期待しています。セキュリティ関連のリリースについては、より迅速な対応が必要になる場合があります。

レジャーの継続性

デフォルトでは、各ノードは既知のvalidatorの1つから提供されるスナップショットから起動します。このスナップショットはチェーンの現在の状態を反映していますが、完全な過去のレジャーは含まれていません。ノードが終了して新しいスナップショットから起動した場合、そのノードのレジャーにギャップが生じる可能性があります。この問題を防ぐには、スナップショットの代わりに過去のレジャーデータを受信するために、solana-validator コマンドに --no-snapshot-fetch パラメーターを追加してください。

初回起動時には --no-snapshot-fetch パラメーターを使用しないでください。ジェネシスブロックからノードを完全に起動することはできないためです。まずスナップショットから起動し、その後の再起動時に --no-snapshot-fetch パラメーターを追加してください。

ネットワーク上の他のノードからお使いのノードが利用できる過去のレジャーの量は、常に制限されていることに注意することが重要です。運用開始後にvalidatorが長時間ダウンした場合、ネットワークに追いつけなくなり、既知のvalidatorから新しいスナップショットをダウンロードする必要が生じる可能性があります。その場合、validatorの過去のレジャーデータにギャップが生じ、そのギャップは埋められなくなります。

Validatorのポート公開を最小化する

validatorは、他のすべてのSolana validatorからのインバウンドトラフィックのために、様々なUDPおよびTCPポートが開放されている必要があります。これは最も効率的な運用モードであり、強く推奨されますが、validatorを1つの他のSolana validatorからのインバウンドトラフィックのみを必要とするよう制限することも可能です。

まず --restricted-repair-only-mode 引数を追加します。これにより、validatorは制限モードで動作し、他のvalidatorからのプッシュを受信せず、代わりにブロックを求めて他のvalidatorを継続的にポーリングする必要があります。validatorは Gossip ポートと ServeR（"serve repair"）ポートを使用して他のvalidatorへのUDPパケットの送信のみを行い、 Gossip ポートと Repair ポートでのみUDPパケットを受信します。

Gossip ポートは双方向であり、validatorがクラスターの他のノードと接続を維持できるようにします。Turbineが無効になったため、validatorは ServeR を通じて送信し、ネットワークの他のノードから新しいブロックを取得するための修復リクエストを行います。その後、validatorは他のvalidatorから Repair ポートで修復レスポンスを受信します。

validatorを1つ以上のvalidatorからのみブロックを要求するようにさらに制限するには、まず対象のvalidatorのidentity pubkeyを確認し、各PUBKEYに対して --gossip-pull-validator PUBKEY --repair-validator PUBKEY 引数を追加します。これにより、追加した各validatorにリソースの負担をかけることになるため、対象のvalidatorに事前に相談した上で、慎重に使用してください。

これで、お使いのvalidatorは明示的にリストされたvalidatorとのみ、Gossip、Repair、ServeR ポートでのみ通信するようになります。

入金アカウントの設定

Solanaのアカウントはオンチェーンでの初期化を必要としません。SOLが含まれた時点で存在します。取引所の入金アカウントを設定するには、ウォレットツールのいずれかを使用してSolana keypairを生成するだけです。

ユーザーごとに固有の入金アカウントを使用することをお勧めします。

Solanaアカウントは、2年分のrentに相当するSOLを保有することでrent免除にする必要があります。入金アカウントのrent免除に必要な最低残高を確認するには、getMinimumBalanceForRentExemption エンドポイントにクエリを送信してください：

curl https://api.devnet.solana.com -X POST -H "Content-Type: application/json" -d '{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "getMinimumBalanceForRentExemption",
  "params": [0]
}'

結果

{ "jsonrpc": "2.0", "result": 890880, "id": 1 }

オフラインアカウント

セキュリティ強化のために、1つ以上のコレクションアカウントの鍵をオフラインで保管することを希望される場合があります。その場合は、オフラインメソッドを使用してホットアカウントにSOLを移動する必要があります。

入金の監視

ユーザーが取引所にSOLを入金する場合は、適切な入金アドレスへ送金するよう案内してください。

バージョン管理トランザクションへの移行

メインネットがバージョン管理トランザクションの処理を開始した場合、取引所は必ず変更を加える必要があります。変更が行われない場合、バージョン管理トランザクションまたはバージョン管理トランザクションを含むブロックの取得時にエラーが返されるため、入金検知が正常に機能しなくなります。

{"maxSupportedTransactionVersion": 0}

maxSupportedTransactionVersion パラメーターは、入金検知の中断を避けるために getBlock および getTransaction リクエストに追加する必要があります。最新のトランザクションバージョンは 0 であり、サポートされる最大トランザクションバージョン値として指定する必要があります。

バージョン管理トランザクションを使用すると、ユーザーはオンチェーンのアドレスルックアップテーブルから読み込まれた別のアカウントキーセットを使用するトランザクションを作成できることを理解することが重要です。

{"encoding": "jsonParsed"}

ブロックおよびトランザクションを取得する際には、"jsonParsed" エンコーディングの使用が推奨されます。これは、メッセージの "accountKeys" リストにすべてのトランザクションアカウントキー（ルックアップテーブルのものを含む）が含まれるためです。これにより、preBalances / postBalances および preTokenBalances / postTokenBalances に記載された残高変化の解決が容易になります。

"json" エンコーディングを使用した場合、preBalances / postBalances および preTokenBalances / postTokenBalances のエントリが "accountKeys" リストに含まれないアカウントキーを参照する可能性があり、トランザクションメタデータの "loadedAddresses" エントリを使用して解決する必要があります。

ブロックのポーリング

取引所のすべての入金アカウントを追跡するには、確認済みの各ブロックをポーリングし、SolanaのAPIノードのJSON-RPCサービスを使用して対象のアドレスを検索します。

利用可能なブロックを特定するには、getBlocksリクエストを送信し、既に処理した最後のブロックをstart-slotパラメーターとして渡します：

curl https://api.devnet.solana.com -X POST -H "Content-Type: application/json" -d '{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "getBlocks",
  "params": [160017005, 160017015]
}'

結果

{
  "jsonrpc": "2.0",
  "result": [
    160017005, 160017006, 160017007, 160017012, 160017013, 160017014, 160017015
  ],
  "id": 1
}

すべてのslotがブロックを生成するわけではないため、整数のシーケンスにギャップが生じる場合があります。

各ブロックについて、getBlockリクエストでその内容を取得します：

ブロック取得のヒント

{"rewards": false}

デフォルトでは、取得したブロックは各ブロックのvalidator手数料とepoch境界のステーキング報酬に関する情報を返します。この情報が不要な場合は、"rewards" パラメーターで無効にしてください。

{"transactionDetails": "accounts"}

デフォルトでは、取得したブロックはアカウント残高の追跡に不要なトランザクション情報やメタデータを大量に返します。"transactionDetails" パラメーターを設定することでブロック取得を高速化できます。

curl https://api.devnet.solana.com -X POST -H 'Content-Type: application/json' -d '{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "getBlock",
  "params": [
    166974442,
    {
      "encoding": "jsonParsed",
      "maxSupportedTransactionVersion": 0,
      "transactionDetails": "accounts",
      "rewards": false
    }
  ]
}'

結果

{
  "jsonrpc": "2.0",
  "result": {
    "blockHeight": 157201607,
    "blockTime": 1665070281,
    "blockhash": "HKhao674uvFc4wMK1Cm3UyuuGbKExdgPFjXQ5xtvsG3o",
    "parentSlot": 166974441,
    "previousBlockhash": "98CNLU4rsYa2HDUyp7PubU4DhwYJJhSX9v6pvE7SWsAo",
    "transactions": [
      ... (omit)
      {
        "meta": {
          "err": null,
          "fee": 5000,
          "postBalances": [
            1110663066,
            1,
            1040000000
          ],
          "postTokenBalances": [],
          "preBalances": [
            1120668066,
            1,
            1030000000
          ],
          "preTokenBalances": [],
          "status": {
            "Ok": null
          }
        },
        "transaction": {
          "accountKeys": [
            {
              "pubkey": "9aE476sH92Vz7DMPyq5WLPkrKWivxeuTKEFKd2sZZcde",
              "signer": true,
              "source": "transaction",
              "writable": true
            },
            {
              "pubkey": "11111111111111111111111111111111",
              "signer": false,
              "source": "transaction",
              "writable": false
            },
            {
              "pubkey": "G1wZ113tiUHdSpQEBcid8n1x8BAvcWZoZgxPKxgE5B7o",
              "signer": false,
              "source": "lookupTable",
              "writable": true
            }
          ],
          "signatures": [
            "2CxNRsyRT7y88GBwvAB3hRg8wijMSZh3VNYXAdUesGSyvbRJbRR2q9G1KSEpQENmXHmmMLHiXumw4dp8CvzQMjrM"
          ]
        },
        "version": 0
      },
      ... (omit)
    ]
  },
  "id": 1
}

preBalancesとpostBalancesフィールドを使用すると、トランザクション全体を解析することなく、すべてのアカウントの残高変化を追跡できます。これらはaccountKeysリストにインデックスされた各アカウントの開始残高と終了残高をlamport単位でリストします。例えば、対象の入金アドレスがG1wZ113tiUHdSpQEBcid8n1x8BAvcWZoZgxPKxgE5B7oである場合、このトランザクションは1040000000 - 1030000000 = 10,000,000 lamport = 0.01 SOLの送金を表します。

トランザクションの種類やその他の詳細情報が必要な場合は、RPCからブロックをバイナリ形式でリクエストし、Rust SDKまたはJavascript SDKを使用して解析できます。

アドレス履歴

特定のアドレスのトランザクション履歴を照会することもできます。これは、すべてのslotにわたるすべての入金アドレスを追跡する方法としては一般的に_適していません_が、特定の期間における少数のアカウントを調べる際には役立つ場合があります。

APIノードにgetSignaturesForAddressリクエストを送信します：

curl https://api.devnet.solana.com -X POST -H "Content-Type: application/json" -d '{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "getSignaturesForAddress",
  "params": [
    "3M2b3tLji7rvscqrLAHMukYxDK2nB96Q9hwfV6QkdzBN",
    {
      "limit": 3
    }
  ]
}'

結果

{
  "jsonrpc": "2.0",
  "result": [
    {
      "blockTime": 1662064640,
      "confirmationStatus": "finalized",
      "err": null,
      "memo": null,
      "signature": "3EDRvnD5TbbMS2mCusop6oyHLD8CgnjncaYQd5RXpgnjYUXRCYwiNPmXb6ZG5KdTK4zAaygEhfdLoP7TDzwKBVQp",
      "slot": 148697216
    },
    {
      "blockTime": 1662064434,
      "confirmationStatus": "finalized",
      "err": null,
      "memo": null,
      "signature": "4rPQ5wthgSP1kLdLqcRgQnkYkPAZqjv5vm59LijrQDSKuL2HLmZHoHjdSLDXXWFwWdaKXUuryRBGwEvSxn3TQckY",
      "slot": 148696843
    },
    {
      "blockTime": 1662064341,
      "confirmationStatus": "finalized",
      "err": null,
      "memo": null,
      "signature": "36Q383JMiqiobuPV9qBqy41xjMsVnQBm9rdZSdpbrLTGhSQDTGZJnocM4TQTVfUGfV2vEX9ZB3sex6wUBUWzjEvs",
      "slot": 148696677
    }
  ],
  "id": 1
}

返された各署名について、getTransactionリクエストを送信してトランザクションの詳細を取得します：

curl https://api.devnet.solana.com -X POST -H 'Content-Type: application/json' -d '{
  "jsonrpc":"2.0",
  "id":1,
  "method":"getTransaction",
  "params":[
    "2CxNRsyRT7y88GBwvAB3hRg8wijMSZh3VNYXAdUesGSyvbRJbRR2q9G1KSEpQENmXHmmMLHiXumw4dp8CvzQMjrM",
    {
      "encoding":"jsonParsed",
      "maxSupportedTransactionVersion":0
    }
  ]
}'

結果

{
  "jsonrpc": "2.0",
  "result": {
    "blockTime": 1665070281,
    "meta": {
      "err": null,
      "fee": 5000,
      "innerInstructions": [],
      "logMessages": [
        "Program 11111111111111111111111111111111 invoke [1]",
        "Program 11111111111111111111111111111111 success"
      ],
      "postBalances": [1110663066, 1, 1040000000],
      "postTokenBalances": [],
      "preBalances": [1120668066, 1, 1030000000],
      "preTokenBalances": [],
      "rewards": [],
      "status": {
        "Ok": null
      }
    },
    "slot": 166974442,
    "transaction": {
      "message": {
        "accountKeys": [
          {
            "pubkey": "9aE476sH92Vz7DMPyq5WLPkrKWivxeuTKEFKd2sZZcde",
            "signer": true,
            "source": "transaction",
            "writable": true
          },
          {
            "pubkey": "11111111111111111111111111111111",
            "signer": false,
            "source": "transaction",
            "writable": false
          },
          {
            "pubkey": "G1wZ113tiUHdSpQEBcid8n1x8BAvcWZoZgxPKxgE5B7o",
            "signer": false,
            "source": "lookupTable",
            "writable": true
          }
        ],
        "addressTableLookups": [
          {
            "accountKey": "4syr5pBaboZy4cZyF6sys82uGD7jEvoAP2ZMaoich4fZ",
            "readonlyIndexes": [],
            "writableIndexes": [3]
          }
        ],
        "instructions": [
          {
            "parsed": {
              "info": {
                "destination": "G1wZ113tiUHdSpQEBcid8n1x8BAvcWZoZgxPKxgE5B7o",
                "lamports": 10000000,
                "source": "9aE476sH92Vz7DMPyq5WLPkrKWivxeuTKEFKd2sZZcde"
              },
              "type": "transfer"
            },
            "program": "system",
            "programId": "11111111111111111111111111111111"
          }
        ],
        "recentBlockhash": "BhhivDNgoy4L5tLtHb1s3TP19uUXqKiy4FfUR34d93eT"
      },
      "signatures": [
        "2CxNRsyRT7y88GBwvAB3hRg8wijMSZh3VNYXAdUesGSyvbRJbRR2q9G1KSEpQENmXHmmMLHiXumw4dp8CvzQMjrM"
      ]
    },
    "version": 0
  },
  "id": 1
}

出金の送信

ユーザーのSOL出金リクエストに対応するには、Solanaの送金トランザクションを生成し、クラスターに転送するためにAPIノードへ送信する必要があります。

同期

Solanaクラスターへ同期送金を行うことで、送金が成功しクラスターによってファイナライズされたことを簡単に確認できます。

SolanaのコマンドラインツールはシンプルなコマンドとしてTの生成、送信、確認を行うsolana transferを提供しています。デフォルトでは、このメソッドはトランザクションがクラスターによってファイナライズされるまで、stderrで進行状況を待機して追跡します。トランザクションが失敗した場合は、トランザクションエラーが報告されます。

solana transfer <USER_ADDRESS> <AMOUNT> --allow-unfunded-recipient --keypair <KEYPAIR> --url http://localhost:8899

Solana Javascript SDKはJSエコシステム向けに同様のアプローチを提供しています。SystemProgramを使用して送金トランザクションを構築し、sendAndConfirmTransactionメソッドを使用して送信してください。

非同期

より柔軟に対応するために、出金送金を非同期で送信することができます。この場合、トランザクションが成功し、クラスターによってファイナライズされたことを確認するのはお客様の責任となります。

注意： 各トランザクションには、その有効性を示す最新のブロックハッシュが含まれています。クラスターによって確認またはファイナライズされていないように見える出金送金を再試行する前に、このブロックハッシュが期限切れになるまで待つことが重要です。そうしないと、二重支払いのリスクがあります。ブロックハッシュの有効期限については以下を参照してください。

まず、getFeesエンドポイントまたはCLIコマンドを使用して最新のブロックハッシュを取得します：

solana fees --url http://localhost:8899

コマンドラインツールでは、--no-wait引数を渡して送金を非同期で送信し、--blockhash引数で最新のブロックハッシュを指定します：

solana transfer <USER_ADDRESS> <AMOUNT> --no-wait --allow-unfunded-recipient --blockhash <RECENT_BLOCKHASH> --keypair <KEYPAIR> --url http://localhost:8899

また、トランザクションを手動で構築、署名、シリアライズし、JSON-RPCのsendTransactionエンドポイントを使用してクラスターに送信することもできます。

トランザクションの確認とファイナリティ

getSignatureStatuses JSON-RPCエンドポイントを使用して、複数のトランザクションのステータスを一括取得します。confirmationsフィールドは、トランザクションが処理されてから経過した確認済みブロックの数を示します。confirmations: nullの場合は、ファイナライズ済みです。

curl https://api.devnet.solana.com -X POST -H "Content-Type: application/json" -d '{
  "jsonrpc":"2.0",
  "id":1,
  "method":"getSignatureStatuses",
  "params":[
    [
      "4cdd1oX7cfVALfr26tP52BZ6cSzrgnNGtYD7BFhm6FFeZV5sPTnRvg6NRn8yC6DbEikXcrNChBM5vVJnTgKhGhVu",
      "5j7s6NiJS3JAkvgkoc18WVAsiSaci2pxB2A6ueCJP4tprA2TFg9wSyTLeYouxPBJEMzJinENTkpA52YStRW5Dia7"
    ]
  ]
}'

結果

{
  "jsonrpc": "2.0",
  "result": {
    "context": {
      "slot": 82
    },
    "value": [
      {
        "slot": 72,
        "confirmations": 10,
        "err": null,
        "status": {
          "Ok": null
        }
      },
      {
        "slot": 48,
        "confirmations": null,
        "err": null,
        "status": {
          "Ok": null
        }
      }
    ]
  },
  "id": 1
}

ブロックハッシュの有効期限

getFeeCalculatorForBlockhashリクエストにブロックハッシュをパラメーターとして送信することで、特定のブロックハッシュがまだ有効かどうかを確認できます。レスポンスの値がnullの場合、ブロックハッシュは期限切れであり、そのブロックハッシュを使用した出金トランザクションは成功しません。

出金のためのユーザー指定アカウントアドレスの検証

出金は取り消しができないため、ユーザーの資金が誤って失われることを防ぐために、出金を承認する前にユーザーが指定したアカウントアドレスを検証することが推奨されます。

基本的な検証

Solanaのアドレスは32バイトの配列で、ビットコインのbase58アルファベットでエンコードされています。これにより、以下の正規表現に一致するASCIIテキスト文字列が生成されます：

[1-9A-HJ-NP-Za-km-z]{32,44}

SolanaのアドレスはチェックサムされていないためTypoを検出できないので、この検証だけでは不十分です。ユーザーの入力をさらに検証するには、文字列をデコードし、結果のバイト配列の長さが32であることを確認します。ただし、1文字の欠落、文字の逆転、大文字小文字の無視などのTypoがあっても32バイトにデコードできるアドレスが存在します。

高度な検証

上記のTypoへの脆弱性のため、出金候補アドレスの残高を照会し、ゼロ以外の残高が見つかった場合はユーザーに意図を確認するよう促すことが推奨されます。

有効なed25519 pubkeyチェック

Solanaの通常アカウントのアドレスは、256ビットのed25519公開鍵をBase58エンコードした文字列です。すべてのビットパターンがed25519曲線の有効な公開鍵であるわけではないため、ユーザーが指定したアカウントアドレスが少なくとも正しいed25519公開鍵であることを確認することが可能です。

Java

以下は、ユーザーが指定したアドレスを有効なed25519公開鍵として検証するJavaの例です：

以下のコードサンプルはMavenを使用していることを前提としています。

pom.xml：

<repositories>
  ...
  <repository>
    <id>spring</id>
    <url>https://repo.spring.io/libs-release/</url>
  </repository>
</repositories>

...

<dependencies>
  ...
  <dependency>
      <groupId>io.github.novacrypto</groupId>
      <artifactId>Base58</artifactId>
      <version>0.1.3</version>
  </dependency>
  <dependency>
      <groupId>cafe.cryptography</groupId>
      <artifactId>curve25519-elisabeth</artifactId>
      <version>0.1.0</version>
  </dependency>
<dependencies>

import io.github.novacrypto.base58.Base58;
import cafe.cryptography.curve25519.CompressedEdwardsY;

public class PubkeyValidator
{
    public static boolean verifyPubkey(String userProvidedPubkey)
    {
        try {
            return _verifyPubkeyInternal(userProvidedPubkey);
        } catch (Exception e) {
            return false;
        }
    }

    public static boolean _verifyPubkeyInternal(String maybePubkey) throws Exception
    {
        byte[] bytes = Base58.base58Decode(maybePubkey);
        return !(new CompressedEdwardsY(bytes)).decompress().isSmallOrder();
    }
}

最小入出金額

SOLの入出金はいずれも、ウォレットアドレスのアカウント（データを保持しない基本的なSOLアカウント）のレント免除最小残高以上である必要があります。現在の値：0.000890880 SOL

同様に、すべての入金アカウントは少なくともこの残高を保持している必要があります。

curl https://api.devnet.solana.com -X POST -H "Content-Type: application/json" -d '{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "getMinimumBalanceForRentExemption",
  "params": [0]
}'

結果

{ "jsonrpc": "2.0", "result": 890880, "id": 1 }

優先手数料とコンピュートユニット

需要が高い時期には、validatorがより高い経済的価値を持つ他のトランザクションを選択した結果、validatorがブロックにトランザクションを含める前にトランザクションが期限切れになる可能性があります。優先手数料が適切に実装されていない場合、Solana上の有効なトランザクションが遅延またはドロップされる可能性があります。

優先手数料は、ブロック内でのトランザクション確実な取り込みを保証し、このような状況での配信を確保するために、基本トランザクション手数料に上乗せして追加できる追加手数料です。

これらの優先手数料は、支払う優先手数料を設定する特別なCompute Budgetのinstructionsをトランザクションに追加することで、トランザクションに付加されます。

重要なお知らせ

これらのinstructionsの実装を怠ると、ネットワークの障害やトランザクションのドロップが発生する可能性があります。Solanaをサポートするすべての取引所は、障害を避けるために優先手数料を活用することを強くお勧めします。

優先手数料とは何ですか？

優先手数料は、ネットワーク上のブロックにトランザクションを含めることをvalidatorノードにとって経済的に魅力的にするために、トランザクションの先頭に付加されるコンピュートユニット（CU）あたりのマイクロlamport（SOLの少額）で価格設定されています。

優先手数料はいくらに設定すべきですか？

優先手数料の設定方法としては、最近の優先手数料を照会してネットワークにとって魅力的な手数料を設定することが考えられます。getRecentPrioritizationFees RPCメソッドを使用すると、最近のブロックにトランザクションを取り込むために必要な優先手数料を照会できます。

優先手数料の価格戦略はユースケースによって異なります。標準的な方法は存在しません。優先手数料を設定する一つの戦略として、トランザクションの成功率を計算し、最近のトランザクション手数料APIへの照会に基づいて優先手数料を引き上げ、適宜調整する方法があります。優先手数料の価格はネットワークのアクティビティや他の参加者による入札に基づいて動的に変化し、事後にのみ把握可能です。

getRecentPrioritizationFees APIコールを使用する際の課題の一つは、各ブロックの最低手数料のみを返す場合があることです。これはしばしばゼロになりますが、validatorノードに拒否されないようにするための優先手数料として使用するには十分な近似値ではありません。

getRecentPrioritizationFees APIはアカウントのpubkeyをパラメーターとして受け取り、これらのアカウントの最小優先手数料の中で最も高い値を返します。アカウントが指定されていない場合、APIはブロックに取り込まれるための最低手数料を返します（ブロックが満杯でない限り、通常はゼロです）。

取引所およびアプリケーションは、トランザクションが書き込みロックするアカウントを指定してRPCエンドポイントに照会する必要があります。RPCエンドポイントはmax(account_1_min_fee, account_2_min_fee, ... account_n_min_fee)を返します。これをそのトランザクションの優先手数料を設定する際の基準値とすべきです。

優先手数料の設定にはさまざまなアプローチがあり、最適な手数料を決定するためのサードパーティAPIも利用可能です。ネットワークの動的な性質を考えると、優先手数料の価格設定に"完璧な"方法は存在せず、進め方を選択する前に慎重な分析を行う必要があります。

優先手数料の実装方法

トランザクションに優先手数料を追加するには、対象トランザクションの先頭に2つのCompute Budgetのinstructionsを付加します：

一つはコンピュートユニット価格を設定するため、
もう一つはコンピュートユニット上限を設定するため

ここでは、優先手数料の使用方法に関するより詳細な開発者向けガイドも参照できます。優先手数料の実装に関するより詳しい情報が含まれています。

基本トランザクション手数料（5,000 lamport）に上乗せして優先手数料を追加するために、setComputeUnitPriceinstructionsを作成します。

// import { ComputeBudgetProgram } from "@solana/web3.js"
ComputeBudgetProgram.setComputeUnitPrice({ microLamports: number });

マイクロlamportで指定された値はコンピュートユニット（CU）バジェットと乗算され、lamport単位の優先手数料が決定されます。例えば、CUバジェットが1M CUで1 microLamport/CUを追加した場合、優先手数料は1 lamport（1M * 0.000001）になります。合計手数料は5001 lamportになります。

トランザクションの新しいコンピュートユニットバジェットを設定するには、setComputeUnitLimitinstructionsを作成します。

// import { ComputeBudgetProgram } from "@solana/web3.js"
ComputeBudgetProgram.setComputeUnitLimit({ units: number });

指定されたunitsの値はSolanaランタイムのデフォルトのコンピュートバジェット値を置き換えます。

トランザクションに必要な最小CUを設定する

トランザクションはスループットを最大化し、全体的な手数料を最小化するために、実行に必要な最小限のコンピュートユニット（CU）をリクエストする必要があります。

トランザクションが消費するCUは、devnetなど別のSolanaクラスターでトランザクションを送信することで確認できます。例えば、シンプルなトークン送金は300 CUを消費します。

// import { ... } from "@solana/web3.js"

const modifyComputeUnits = ComputeBudgetProgram.setComputeUnitLimit({
  // note: set this to be the lowest actual CU consumed by the transaction
  units: 300
});

const addPriorityFee = ComputeBudgetProgram.setComputeUnitPrice({
  microLamports: 1
});

const transaction = new Transaction()
  .add(modifyComputeUnits)
  .add(addPriorityFee)
  .add(
    SystemProgram.transfer({
      fromPubkey: payer.publicKey,
      toPubkey: toAccount,
      lamports: 10000000
    })
  );

優先手数料と持続可能なNonce

セットアップでDurable Nonce Transactionsを使用している場合、トランザクションを確実に成功させるために、Prioritization FeesとDurable Transaction Noncesを適切に組み合わせて実装することが重要です。これを怠ると、意図したDurable Nonceトランザクションが正しく検出されなくなります。

Durable Transaction Noncesを使用している場合、AdvanceNonceAccount instructionはinstructionsリストの先頭に指定する必要があります。これは、優先手数料を指定するためにコンピュートバジェットのinstructionsを使用する場合でも同様です。

このデベロッパーガイドでは、Durable NoncesとPriority Feesを組み合わせて使用する具体的なコード例を参照できます。

SPL Tokenスタンダードのサポート

SPL Tokenは、Solanaブロックチェーン上でラップ済み／合成トークンを作成・交換するための標準規格です。

SPL Tokenのワークフローはネイティブ SOL トークンと似ていますが、このセクションで説明するいくつかの違いがあります。

Token Mints

SPL Tokenの各_タイプ_は、mint accountを作成することで定義されます。このアカウントには、供給量、小数点以下の桁数、mintを管理するさまざまな権限など、トークンの特性を表すメタデータが格納されます。各SPL Token accountは関連するmintを参照しており、そのタイプのSPL Tokenとのみやり取りできます。

`spl-token` CLIツールのインストール

SPL Token accountの照会と変更には、spl-tokenコマンドラインユーティリティを使用します。このセクションで提供されるサンプルは、ローカルシステムにインストールされていることを前提としています。

spl-tokenはRustのcrates.ioからRustのcargoコマンドラインユーティリティ経由で配布されています。cargoの最新バージョンは、rustup.rsにあるプラットフォーム向けのワンライナーを使用してインストールできます。cargoがインストールされたら、以下のコマンドでspl-tokenを取得できます：

cargo install spl-token-cli

インストール済みのバージョンを確認するには

spl-token --version

次のような結果が表示されるはずです

spl-token-cli 2.0.1

アカウントの作成

SPL Token accountには、ネイティブのSystem Programアカウントにはない追加要件があります：

SPL Token accountは、トークンを入金する前に作成しておく必要があります。token accountは、spl-token create-accountコマンドで明示的に、またはspl-token transfer --fund-recipient ...コマンドで暗黙的に作成できます。
SPL Token accountは、存在する間は家賃免除（rent-exempt）の状態を維持する必要があるため、アカウント作成時に少量のネイティブ SOL トークンの入金が必要です。SPL Token accountの場合、この金額は0.00203928 SOL（2,039,280 lamports）です。

コマンドライン

以下のプロパティを持つSPL Token accountを作成するには：

指定されたmintに関連付けられている
資金提供アカウントのkeypairが所有者

spl-token create-account <TOKEN_MINT_ADDRESS>

例

spl-token create-account AkUFCWTXb3w9nY2n6SFJvBV6VwvFUCe4KBMCcgLsa2ir

次のような出力が得られます：

Creating account 6VzWGL51jLebvnDifvcuEDec17sK6Wupi4gYhm5RzfkV
Signature: 4JsqZEPra2eDTHtHpB4FMWSfk3UgcCVmkKkP7zESZeMrKmFFkDkNd91pKP3vPVVZZPiu5XxyJwS73Vi5WsZL88D7

または、特定のkeypairでSPL Token accountを作成するには：

solana-keygen new -o token-account.json

spl-token create-account AkUFCWTXb3w9nY2n6SFJvBV6VwvFUCe4KBMCcgLsa2ir token-account.json

次のような出力が得られます：

Creating account 6VzWGL51jLebvnDifvcuEDec17sK6Wupi4gYhm5RzfkV
Signature: 4JsqZEPra2eDTHtHpB4FMWSfk3UgcCVmkKkP7zESZeMrKmFFkDkNd91pKP3vPVVZZPiu5XxyJwS73Vi5WsZL88D7

アカウント残高の確認

コマンドライン

spl-token balance <TOKEN_ACCOUNT_ADDRESS>

例

solana balance 6VzWGL51jLebvnDifvcuEDec17sK6Wupi4gYhm5RzfkV

次のような出力が得られます：

トークンの転送

転送のソースアカウントは、実際の金額が含まれているtoken accountです。

ただし、送金先アドレスは通常のウォレットアカウントでも構いません。そのウォレットに対して指定されたmintのassociated token accountがまだ存在しない場合、--fund-recipient引数が指定されていれば、転送時に自動的に作成されます。

コマンドライン

spl-token transfer <SENDER_ACCOUNT_ADDRESS> <AMOUNT> <RECIPIENT_WALLET_ADDRESS> --fund-recipient

例

spl-token transfer 6B199xxzw3PkAm25hGJpjj3Wj3WNYNHzDAnt1tEqg5BN 1

次のような出力が得られます：

6VzWGL51jLebvnDifvcuEDec17sK6Wupi4gYhm5RzfkV
Transfer 1 tokens
  Sender: 6B199xxzw3PkAm25hGJpjj3Wj3WNYNHzDAnt1tEqg5BN
  Recipient: 6VzWGL51jLebvnDifvcuEDec17sK6Wupi4gYhm5RzfkV
Signature: 3R6tsog17QM8KfzbcbdP4aoMfwgo6hBggJDVy7dZPVmH2xbCWjEj31JKD53NzMrf25ChFjY7Uv2dfCDq4mGFFyAj

入金

各(ウォレット, mint)ペアはオンチェーンで個別のアカウントを必要とするため、これらのアカウントのアドレスはAssociated Token Account（ATA）スキームを使用してSOL入金ウォレットから導出し、ATAアドレスからの入金のみを受け付けることを推奨します。

入金トランザクションの監視は、上記で説明したブロックポーリング方式に従う必要があります。新しいブロックごとに、ユーザーと取引所のtoken accountアドレスを含む成功したトランザクションをスキャンする必要があります。

トランザクションのメタデータにあるpreTokenBalancesとpostTokenBalancesフィールドを使用して、実際の残高変化を確認する必要があります。これらのフィールドには、トークンのmint、token accountの所有者（ウォレットアドレス）、およびトランザクション前後のtoken accountの残高が含まれています。

token accountがトランザクションの一部として作成された場合（初めてトークンを受け取る場合など）、そのアカウントはトランザクション前に存在しなかったため、preTokenBalances配列には表示されません。このシナリオでは、入金額を計算する際に初期残高をゼロとして扱う必要があります。新しく作成されたアカウントは、トランザクション完了後の最終残高とともにpostTokenBalances配列にのみ表示されます。

例1：単一トークン転送

以下のトランザクション詳細は、単一のトークン転送instructionを含むトランザクションの例を示しています。

このトランザクションはトークンの100基本単位（mintの小数点未調整）を転送し、以下のアカウントが含まれます：

送信者（所有者）: 4fvXFPXSL9i7VbiRzoizuW4bhn1dMvRgQzQ6VevssYxw
送信者 Token Account: 6zhjktfYBRUp7fgXLoWU7GFFrCuZa9iQkYTQzDzuvsAS
受信者 Token Account: G5nNekUhhWFqJAiCMpKHootZ5Bfa7MXwuQ5vvKcvuxKM
Token Extension Program ID: TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb

なお、受信者（所有者）アカウントとmint accountはトークン転送instructionには必須ではありません。参考として、解析済みトランザクションメタデータにアドレスが含まれているため、ここに記載しています。

受信者（所有者）: 8fjS2shNWY8xniiEMLNk1Aek4MAu8Qp2LCXJckVwTD4n
Mint: Fx1JZFeYbCxLrMv7422YSxpr7YzcsAgpU1MkjZTyCKi2

Transaction Metadata

{
  "blockTime": "1741240211",
  "meta": {
    "computeUnitsConsumed": "1551",
    "err": null,
    "fee": "5000",
    "innerInstructions": [],
    "loadedAddresses": {
      "readonly": [],
      "writable": []
    },
    "logMessages": [
      "Program TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb invoke [1]",
      "Program log: Instruction: Transfer",
      "Program TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb consumed 1551 of 200000 compute units",
      "Program TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb success"
    ],
    "postBalances": ["994375240", "2074080", "2074080", "1141440"],
    "postTokenBalances": [
      {
        "accountIndex": 1,
        "mint": "Fx1JZFeYbCxLrMv7422YSxpr7YzcsAgpU1MkjZTyCKi2",
        "owner": "4fvXFPXSL9i7VbiRzoizuW4bhn1dMvRgQzQ6VevssYxw",
        "programId": "TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb",
        "uiTokenAmount": {
          "amount": "0",
          "decimals": 2,
          "uiAmount": null,
          "uiAmountString": "0"
        }
      },
      {
        "accountIndex": 2,
        "mint": "Fx1JZFeYbCxLrMv7422YSxpr7YzcsAgpU1MkjZTyCKi2",
        "owner": "8fjS2shNWY8xniiEMLNk1Aek4MAu8Qp2LCXJckVwTD4n",
        "programId": "TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb",
        "uiTokenAmount": {
          "amount": "100",
          "decimals": 2,
          "uiAmount": "1",
          "uiAmountString": "1"
        }
      }
    ],
    "preBalances": ["994380240", "2074080", "2074080", "1141440"],
    "preTokenBalances": [
      {
        "accountIndex": 1,
        "mint": "Fx1JZFeYbCxLrMv7422YSxpr7YzcsAgpU1MkjZTyCKi2",
        "owner": "4fvXFPXSL9i7VbiRzoizuW4bhn1dMvRgQzQ6VevssYxw",
        "programId": "TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb",
        "uiTokenAmount": {
          "amount": "100",
          "decimals": 2,
          "uiAmount": "1",
          "uiAmountString": "1"
        }
      },
      {
        "accountIndex": 2,
        "mint": "Fx1JZFeYbCxLrMv7422YSxpr7YzcsAgpU1MkjZTyCKi2",
        "owner": "8fjS2shNWY8xniiEMLNk1Aek4MAu8Qp2LCXJckVwTD4n",
        "programId": "TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb",
        "uiTokenAmount": {
          "amount": "0",
          "decimals": 2,
          "uiAmount": null,
          "uiAmountString": "0"
        }
      }
    ],
    "rewards": [],
    "status": {
      "Ok": null
    }
  },
  "slot": "3916",
  "transaction": {
    "message": {
      "accountKeys": [
        "4fvXFPXSL9i7VbiRzoizuW4bhn1dMvRgQzQ6VevssYxw",
        "6zhjktfYBRUp7fgXLoWU7GFFrCuZa9iQkYTQzDzuvsAS",
        "G5nNekUhhWFqJAiCMpKHootZ5Bfa7MXwuQ5vvKcvuxKM",
        "TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb"
      ],
      "addressTableLookups": [],
      "header": {
        "numReadonlySignedAccounts": 0,
        "numReadonlyUnsignedAccounts": 1,
        "numRequiredSignatures": 1
      },
      "instructions": [
        {
          "accounts": [1, 2, 0],
          "data": "3WBgs5fm8oDy",
          "programIdIndex": 3,
          "stackHeight": null
        }
      ],
      "recentBlockhash": "8soh8j2dkEniZW6Jpx9cJaWtnvrGoGUqpbaUVwUkX5R3"
    },
    "signatures": [
      "3vr6Gj3GnBQmsZW1TtBJ3hvfFMi3h9BxLs2oaZkV41LRWeGWPVmeo16JTN8MdP3ypU5VgWAziYUjybhyZoisryQ6"
    ]
  },
  "version": "0"
}

例2：Token Accountの作成と転送

以下のトランザクション詳細は、受信者のtoken accountがトークン転送と同じトランザクション内で作成されるトランザクションの例を示しています。

preTokenBalances配列には、トランザクション前に存在しなかった受信者のtoken accountが含まれていないことに注意してください。受信者のtoken accountは、トランザクション完了後の最終残高とともにpostTokenBalances配列にのみ表示されます。

Transaction Metadata

{
  "blockTime": "1740541705",
  "meta": {
    "computeUnitsConsumed": "17416",
    "err": null,
    "fee": "5000",
    "innerInstructions": [
      {
        "index": 0,
        "instructions": [
          {
            "accounts": [4],
            "data": "84eT",
            "programIdIndex": 7,
            "stackHeight": 2
          },
          {
            "accounts": [0, 1],
            "data": "11119ExAoTptm6xKUTUcw2V69MKmyEdDmRins3j3bK43o9nHeiYUtSiaT9pc292PhNQvxj",
            "programIdIndex": 3,
            "stackHeight": 2
          },
          {
            "accounts": [1],
            "data": "P",
            "programIdIndex": 7,
            "stackHeight": 2
          },
          {
            "accounts": [1, 4],
            "data": "6b8ZSccu4ezujyhGG8KNmg75iCWbQRyjxeSfi38u8ED8N",
            "programIdIndex": 7,
            "stackHeight": 2
          }
        ]
      }
    ],
    "loadedAddresses": {
      "readonly": [],
      "writable": []
    },
    "logMessages": [
      "Program ATokenGPvbdGVxr1b2hvZbsiqW5xWH25efTNsLJA8knL invoke [1]",
      "Program log: Create",
      "Program TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb invoke [2]",
      "Program log: Instruction: GetAccountDataSize",
      "Program TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb consumed 928 of 394613 compute units",
      "Program return: TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb qgAAAAAAAAA=",
      "Program TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb success",
      "Program 11111111111111111111111111111111 invoke [2]",
      "Program 11111111111111111111111111111111 success",
      "Program log: Initialize the associated token account",
      "Program TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb invoke [2]",
      "Program log: Instruction: InitializeImmutableOwner",
      "Program TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb consumed 487 of 388755 compute units",
      "Program TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb success",
      "Program TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb invoke [2]",
      "Program log: Instruction: InitializeAccount3",
      "Program TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb consumed 1440 of 385879 compute units",
      "Program TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb success",
      "Program ATokenGPvbdGVxr1b2hvZbsiqW5xWH25efTNsLJA8knL consumed 15865 of 400000 compute units",
      "Program ATokenGPvbdGVxr1b2hvZbsiqW5xWH25efTNsLJA8knL success",
      "Program TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb invoke [1]",
      "Program log: Instruction: Transfer",
      "Program TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb consumed 1551 of 384135 compute units",
      "Program TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb success"
    ],
    "postBalances": [
      "994375240",
      "2074080",
      "2074080",
      "1",
      "1461600",
      "731913600",
      "0",
      "1141440"
    ],
    "postTokenBalances": [
      {
        "accountIndex": 1,
        "mint": "3RPRXBsdwyHhs2UnTWXoHp6Frwv4eWEbA55qCzbs9nxK",
        "owner": "EzrmgRNGN9duiDAk3ABSC8eKhd1b2EUFwXVrYZDJw4hQ",
        "programId": "TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb",
        "uiTokenAmount": {
          "amount": "100",
          "decimals": 2,
          "uiAmount": "1",
          "uiAmountString": "1"
        }
      },
      {
        "accountIndex": 2,
        "mint": "3RPRXBsdwyHhs2UnTWXoHp6Frwv4eWEbA55qCzbs9nxK",
        "owner": "CbJNxBnU9ZWnQq12aVHhbze9nubbDVDV5rYVEqz9qFaS",
        "programId": "TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb",
        "uiTokenAmount": {
          "amount": "0",
          "decimals": 2,
          "uiAmount": null,
          "uiAmountString": "0"
        }
      }
    ],
    "preBalances": [
      "996454320",
      "0",
      "2074080",
      "1",
      "1461600",
      "731913600",
      "0",
      "1141440"
    ],
    "preTokenBalances": [
      {
        "accountIndex": 2,
        "mint": "3RPRXBsdwyHhs2UnTWXoHp6Frwv4eWEbA55qCzbs9nxK",
        "owner": "CbJNxBnU9ZWnQq12aVHhbze9nubbDVDV5rYVEqz9qFaS",
        "programId": "TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb",
        "uiTokenAmount": {
          "amount": "100",
          "decimals": 2,
          "uiAmount": "1",
          "uiAmountString": "1"
        }
      }
    ],
    "rewards": [],
    "status": {
      "Ok": null
    }
  },
  "slot": "81051",
  "transaction": {
    "message": {
      "accountKeys": [
        "CbJNxBnU9ZWnQq12aVHhbze9nubbDVDV5rYVEqz9qFaS",
        "571u96hRRmxbRCTmp5oqC5WpJfvZhPaSXEbihLVCR5wQ",
        "8y8KjtZN9tyGeAeKwr8doSpbBVVgfsZMtMjCGUDH7mmU",
        "11111111111111111111111111111111",
        "3RPRXBsdwyHhs2UnTWXoHp6Frwv4eWEbA55qCzbs9nxK",
        "ATokenGPvbdGVxr1b2hvZbsiqW5xWH25efTNsLJA8knL",
        "EzrmgRNGN9duiDAk3ABSC8eKhd1b2EUFwXVrYZDJw4hQ",
        "TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb"
      ],
      "addressTableLookups": [],
      "header": {
        "numReadonlySignedAccounts": 0,
        "numReadonlyUnsignedAccounts": 5,
        "numRequiredSignatures": 1
      },
      "instructions": [
        {
          "accounts": [0, 1, 6, 4, 3, 7],
          "data": "1",
          "programIdIndex": 5,
          "stackHeight": null
        },
        {
          "accounts": [2, 1, 0],
          "data": "3WBgs5fm8oDy",
          "programIdIndex": 7,
          "stackHeight": null
        }
      ],
      "recentBlockhash": "77QC38Q2hKFYZzUXk8JWmsAqGNKhw4k2Lm2XVUme9uqP"
    },
    "signatures": [
      "4kuGhMeZxBHgEtej4Uv4n2arhe3jqT2GdTDPFri4JLFXYgcAtbeeXdBdzvG98HENe1tZSZqyFkm3SEvB6CfCMaM9"
    ]
  },
  "version": "0"
}

例3：Token Account所有者の変更

以下のトランザクション詳細は、token accountのownerフィールドが変更されるトランザクションの例を示しています。

token accountの所有権を移転させる（ownerフィールドを変更する）方法で入金を受け付けることは強く推奨されません。

これを入金方法としてサポートする場合は、postTokenBalances内の新しいownerフィールドが、取引所が管理し秘密鍵を保有するウォレットアドレスと一致することを確認する必要があります。

入金者がtoken accountのownerをウォレット以外のアドレス（別のtoken accountアドレスなど）に変更した場合、資金に永久にアクセスできなくなる可能性があります。

Transaction Metadata

{
  "blockTime": "1740598556",
  "meta": {
    "computeUnitsConsumed": "1167",
    "err": null,
    "fee": "5000",
    "innerInstructions": [],
    "loadedAddresses": {
      "readonly": [],
      "writable": []
    },
    "logMessages": [
      "Program TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb invoke [1]",
      "Program log: Instruction: SetAuthority",
      "Program TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb consumed 1167 of 200000 compute units",
      "Program TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb success"
    ],
    "postBalances": ["996479120", "2039280", "1141440"],
    "postTokenBalances": [
      {
        "accountIndex": 1,
        "mint": "ELRBdV4gcuxqYb6jHkV4ySJ7dwYx9344cgFNzUSww1ra",
        "owner": "A9FK8XxT2Hfefz8H3vQJHLwvbibGQJWErBsqMumgUYeP",
        "programId": "TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb",
        "uiTokenAmount": {
          "amount": "100",
          "decimals": 2,
          "uiAmount": "1",
          "uiAmountString": "1"
        }
      }
    ],
    "preBalances": ["996484120", "2039280", "1141440"],
    "preTokenBalances": [
      {
        "accountIndex": 1,
        "mint": "ELRBdV4gcuxqYb6jHkV4ySJ7dwYx9344cgFNzUSww1ra",
        "owner": "DLvpDgEABKfEaRDz5Qh9tSrJhuZzsiiZMcYXmvdek1zV",
        "programId": "TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb",
        "uiTokenAmount": {
          "amount": "100",
          "decimals": 2,
          "uiAmount": "1",
          "uiAmountString": "1"
        }
      }
    ],
    "rewards": [],
    "status": {
      "Ok": null
    }
  },
  "slot": "137902",
  "transaction": {
    "message": {
      "accountKeys": [
        "DLvpDgEABKfEaRDz5Qh9tSrJhuZzsiiZMcYXmvdek1zV",
        "5Qj4uNGuAEBdryPg8k2UTewpnNfYAc9Ux9fCcDrNAjGs",
        "TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb"
      ],
      "addressTableLookups": [],
      "header": {
        "numReadonlySignedAccounts": 0,
        "numReadonlyUnsignedAccounts": 1,
        "numRequiredSignatures": 1
      },
      "instructions": [
        {
          "accounts": [1, 0],
          "data": "bmb6sys4wqZErNeiV7hrM4vQVHF8AVBhi3XeR5TgbQM68MH",
          "programIdIndex": 2,
          "stackHeight": null
        }
      ],
      "recentBlockhash": "CvTdX9MSYkqFMkALUHeGPMQN5yBeUdJptRdce2qMEkPr"
    },
    "signatures": [
      "3rHUaKMh4KDDfdaATAL4J5WDEV7oFm7ykkNaMf1Eo5EwvDUjLE6dWsbxNDmyENrhb2w5gE4KqRxZ3ZwQxuM18SVR"
    ]
  },
  "version": "0"
}

トークン入金額の計算

トークンの入金を正確に追跡するには、トランザクションメタデータのpreTokenBalancesとpostTokenBalanceフィールドを比較する必要があります。これらのフィールドはトランザクション前後のトークン残高とtoken accountの所有者を示しており、転送されたトークンの正確な量を計算することができます。このアプローチにより、実際の残高変化を確実に把握できます。

preTokenBalancesとpostTokenBalancesのownerフィールドが同じ場合は、amountフィールドの差分を計算します。
token accountの所有権が変更された場合（preTokenBalancesとpostTokenBalancesのownerフィールドが異なる場合）、かつpostTokenBalanceの新しい所有者が取引所の期待するownerアドレスと一致する場合は、postTokenBalancesのamountフィールドに表示されている残高全体を入金額とみなします。

Transaction Metadata

"meta": {
    // --snip--
    "postBalances": ["994375240", "2074080", "2074080", "1141440"],
    "postTokenBalances": [
      {
        "accountIndex": 1,
        "mint": "Fx1JZFeYbCxLrMv7422YSxpr7YzcsAgpU1MkjZTyCKi2",
        "owner": "4fvXFPXSL9i7VbiRzoizuW4bhn1dMvRgQzQ6VevssYxw",
        "programId": "TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb",
        "uiTokenAmount": {
          "amount": "0",
          "decimals": 2,
          "uiAmount": null,
          "uiAmountString": "0"
        }
      },
      {
        "accountIndex": 2,
        "mint": "Fx1JZFeYbCxLrMv7422YSxpr7YzcsAgpU1MkjZTyCKi2",
        "owner": "8fjS2shNWY8xniiEMLNk1Aek4MAu8Qp2LCXJckVwTD4n",
        "programId": "TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb",
        "uiTokenAmount": {
          "amount": "100",
          "decimals": 2,
          "uiAmount": "1",
          "uiAmountString": "1"
        }
      }
    ],
    "preBalances": ["994380240", "2074080", "2074080", "1141440"],
    "preTokenBalances": [
      {
        "accountIndex": 1,
        "mint": "Fx1JZFeYbCxLrMv7422YSxpr7YzcsAgpU1MkjZTyCKi2",
        "owner": "4fvXFPXSL9i7VbiRzoizuW4bhn1dMvRgQzQ6VevssYxw",
        "programId": "TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb",
        "uiTokenAmount": {
          "amount": "100",
          "decimals": 2,
          "uiAmount": "1",
          "uiAmountString": "1"
        }
      },
      {
        "accountIndex": 2,
        "mint": "Fx1JZFeYbCxLrMv7422YSxpr7YzcsAgpU1MkjZTyCKi2",
        "owner": "8fjS2shNWY8xniiEMLNk1Aek4MAu8Qp2LCXJckVwTD4n",
        "programId": "TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb",
        "uiTokenAmount": {
          "amount": "0",
          "decimals": 2,
          "uiAmount": null,
          "uiAmountString": "0"
        }
      }
    ],
    // --snip--
  }

出金

ユーザーが提供する出金アドレスは、そのユーザーのSOLウォレットのアドレスでなければなりません。

出金の転送を実行する前に、取引所は上記の説明に従ってアドレスを確認する必要があります。また、このアドレスはSystem Programによって所有されており、アカウントデータを持たないことが必要です。アドレスにSOL残高がない場合は、出金を進める前にユーザーの確認を取る必要があります。その他すべての出金アドレスは拒否しなければなりません。

出金アドレスから、正しいミントに対応するAssociated Token Account（ATA）が導出され、TransferChecked instructionsを通じてそのアカウントへ転送が発行されます。ATAアドレスがまだ存在しない場合があり、その際は取引所がユーザーに代わってアカウントに資金を提供する必要があります。SPL Tokenのtoken accountへの資金提供には、0.00203928 SOL（2,039,280 lamports）が必要です。

出金用のspl-token transferコマンドのテンプレート：

spl-token transfer --fund-recipient <exchange token account> <withdrawal amount> <withdrawal address>

その他の考慮事項

フリーズ権限

規制遵守上の理由から、SPLトークンを発行するエンティティは、そのミントに関連して作成されたすべてのアカウントに対して「フリーズ権限」を任意で保持することができます。これにより、特定のアカウントの資産を任意で凍結し、解除されるまでそのアカウントを使用不能にすることができます。この機能が使用されている場合、フリーズ権限のpubkeyはSPLトークンのミントアカウントに登録されます。

SPL Token-2022（Token Extensions）標準の基本サポート

SPL Token-2022は、Solanaブロックチェーン上でのラップ/合成トークンの作成と交換に関する最新の標準です。

「Token Extensions」とも呼ばれるこの標準には、トークン作成者およびアカウント保有者が任意で有効化できる多くの新機能が含まれています。これらの機能には、コンフィデンシャル転送、転送手数料、ミントのクローズ、メタデータ、パーマネントデリゲート、イミュータブルオーナーシップなどが含まれます。詳細については、拡張機能ガイドをご参照ください。

取引所がSPL Tokenをサポートしている場合、SPL Token-2022をサポートするために必要な追加作業はそれほど多くありません：

CLIツールはバージョン3.0.0以降、両方のプログラムとシームレスに動作します。
preTokenBalancesとpostTokenBalancesにSPL Token-2022の残高が含まれます
RPCはSPL Token-2022アカウントをインデックス化しますが、プログラムID TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb を使用して個別にクエリする必要があります

Associated Token Accountは同じ方法で機能し、新しいアカウントに必要なSOLのデポジット額を正しく計算します。

ただし、拡張機能によってアカウントが165バイトを超える場合があるため、資金提供に0.00203928 SOL以上が必要になる場合があります。

例えば、Associated Token Accountプログラムは常に「immutable owner」拡張機能を含むため、アカウントは最低170バイトを占有し、0.00207408 SOLが必要となります。

拡張機能固有の考慮事項

前のセクションでは、SPL Token-2022の最も基本的なサポートについて概説しました。拡張機能はトークンの動作を変更するため、取引所はトークンの処理方法を変更する必要がある場合があります。

ミントまたはtoken account上のすべての拡張機能を確認することができます：

spl-token display <account address>

転送手数料

トークンには転送手数料を設定することができ、転送されたトークンの一部が将来の回収のために送金先で差し引かれます。

取引所がこれらのトークンを転送する場合、差し引かれる金額によりすべてが送金先に届かない可能性があることに注意してください。

予期しない事態を避けるために、転送時に期待される手数料を指定することができます：

spl-token transfer --expected-fee <fee amount> --fund-recipient <exchange token account> <withdrawal amount> <withdrawal address>

ミントクローズ権限

この拡張機能により、トークン作成者はトークンの供給量がゼロである場合にミントをクローズすることができます。

ミントがクローズされた場合、空のtoken accountが存在し続ける可能性があり、それらは有効なミントに関連付けられなくなります。

これらのtoken accountは単純にクローズすることで安全に処理できます：

spl-token close --address <account address>

コンフィデンシャル転送

ミントはコンフィデンシャル転送用に設定することができ、トークン量は暗号化されますが、アカウント所有者は引き続き公開されます。

取引所はtoken accountをコンフィデンシャル転送の送受信用に設定して、ユーザーの金額を非公開にすることができます。token accountでコンフィデンシャル転送を有効にすることは必須ではないため、取引所はユーザーに非コンフィデンシャルでトークンを送信するよう強制することができます。

コンフィデンシャル転送を有効にするには、アカウントを次のように設定する必要があります：

spl-token configure-confidential-transfer-account --address <account address>

転送するには：

spl-token transfer --confidential <exchange token account> <withdrawal amount> <withdrawal address>

コンフィデンシャル転送中、preTokenBalanceおよびpostTokenBalanceフィールドには変化が表示されません。デポジットアカウントをスイープするには、新しい残高を復号化してトークンを出金する必要があります：

spl-token apply-pending-balance --address <account address>
spl-token withdraw-confidential-tokens --address <account address> <amount or ALL>

デフォルトアカウント状態

ミントにはデフォルトのアカウント状態を設定することができ、すべての新しいtoken accountがデフォルトで凍結されます。これらのトークン作成者は、アカウントを解除するための別のプロセスをユーザーに要求する場合があります。

転送不可

一部のトークンは転送不可ですが、バーンすることは可能であり、アカウントをクローズすることもできます。

パーマネントデリゲート

トークン作成者は、すべてのトークンに対してパーマネントデリゲートを指定することができます。パーマネントデリゲートは任意のアカウントからトークンを転送またはバーンすることができ、資金を窃取する可能性があります。

これは特定の法域におけるステーブルコインの法的要件であるか、またはトークン没収スキームに使用される可能性があります。

これらのトークンは取引所の知らないうちに転送される可能性があることに注意してください。

転送フック

トークンには追加のプログラムを設定することができ、転送を検証したりその他のロジックを実行したりするために、転送中に呼び出す必要があります。

Solanaランタイムはすべてのアカウントをプログラムに明示的に渡す必要があり、転送フックには追加のアカウントが必要なため、取引所はこれらのトークンに対して異なる方法で転送instructionsを作成する必要があります。

CLIおよびcreateTransferCheckedWithTransferHookInstructionなどのinstruction作成ツールは追加アカウントを自動的に追加しますが、追加アカウントを明示的に指定することもできます：

spl-token transfer --transfer-hook-account <pubkey:role> --transfer-hook-account <pubkey:role> ...

転送時のメモ必須

ユーザーはtoken accountを転送時にメモを必須とするように設定することができます。

取引所はユーザーへのトークン返送前にメモinstructionsを先頭に追加する必要がある場合があります。または、取引所への送信前にユーザーがメモinstructionsを先頭に追加するよう求めることもできます：

spl-token transfer --with-memo <memo text> <exchange token account> <withdrawal amount> <withdrawal address>

インテグレーションのテスト

メインネットの本番環境に移行する前に、Solana devnetおよびtestnetのクラスター上で完全なワークフローをテストしてください。Devnetは最もオープンで柔軟性が高く、初期開発に最適です。一方、testnetはより現実的なクラスター設定を提供します。devnetとtestnetの両方がフォーセットをサポートしており、開発およびテスト用のdevnetまたはtestnet SOLを取得するにはsolana airdrop 1を実行してください。

目次