Metaplex

Coreコマンド

Execute

Last updated March 20, 2026

概要

mplx core asset execute infoコマンドは、任意のMPL CoreアセットのサイナーPDAアドレスと現在のSOL残高を表示します。サイナーPDAは、アセットに代わってSOL、トークンを保持し、他のアセットを所有できる決定論的なプログラム派生アドレスです。

  • 任意のCoreアセットのサイナーPDAアドレスを導出・表示
  • 結果を返す前にアセットがオンチェーンに存在することを検証
  • PDAの現在のSOL残高を表示
  • 完全なPDAウォレット機能のためにアセット署名者ウォレットと併用

基本的な使い方

Get execute info for an asset
mplx core asset execute info <assetId>

引数

引数説明
ASSET_IDサイナーPDAを導出するMPL Coreアセットのアドレス

グローバルフラグ

フラグ説明
-c, --config <value>設定ファイルのパス。デフォルトは~/.config/mplx/config.json
-k, --keypair <value>キーペアファイルまたはLedgerへのパス（例：usb://ledger?key=0）
-p, --payer <value>支払者キーペアファイルまたはLedgerへのパス
-r, --rpc <value>クラスターのRPC URL
--commitment <option>コミットメントレベル：processed、confirmed、またはfinalized
--json出力をJSON形式にフォーマット
--log-level <option>ログレベル：debug、warn、error、info、またはtrace（デフォルト：info）

使用例

アセットのPDA情報を表示

Get signer PDA info
mplx core asset execute info 5avjMVza8SuMhgTfzEGNWJskDELMCQk9juAAc8zeQoNa

出力：

execute info output
--------------------------------

  Asset:         5avjMVza8SuMhgTfzEGNWJskDELMCQk9juAAc8zeQoNa

  Signer PDA:    7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU

  SOL Balance:   0.1 SOL

--------------------------------

構造化JSON出力の取得

Execute info with JSON output
mplx core asset execute info <assetId> --json

戻り値：

JSON response
{

  "asset": "<assetId>",

  "signerPda": "<pdaAddress>",

  "balance": 0.1

}

検査後にPDAへ資金を送金

PDAを検査してから資金を送金する一般的なワークフロー：

Inspect and fund the PDA
# 1. PDAアドレスを取得

mplx core asset execute info <assetId>



# 2. PDAにSOLを送信

mplx toolbox sol transfer 0.1 <signerPdaAddress>



# 3. 残高を確認

mplx core asset execute info <assetId>

Executeの仕組み

すべてのMPL Coreアセットには、findAssetSignerPdaを使用してアドレスから導出される決定論的なサイナーPDAがあります。このPDAはウォレットとして機能し、SOLの保持、トークンの所有、オンチェーンのexecuteインストラクションによるインストラクションの署名が可能です。

一般的なワークフローは以下の通りです：

  1. PDAを導出 — mplx core asset execute info <assetId>でPDAアドレスを確認
  2. PDAに資金を送金 — mplx toolbox sol transferでPDAアドレスにSOLを送信
  3. ウォレットとして登録 — mplx config wallets add <name> --asset <assetId>でアセットをアセット署名者ウォレットとして追加
  4. 通常通り使用 — アセット署名者ウォレットがアクティブな場合、すべてのCLIコマンドが自動的にexecuteインストラクションでラップされます

infoは唯一のexecuteサブコマンドです。PDAとして操作を実行するには、アセットをアセット署名者ウォレットとして登録してください。すべての通常のCLIコマンドが自動的にexecuteでラップされます。

クイックリファレンス

項目値
コマンドmplx core asset execute info
対象MPL Coreアセットのみ
関連アセット署名者ウォレット
PDA導出findAssetSignerPda(umi, { asset: assetPubkey })
ソースGitHub — metaplex-foundation/cli

注意事項

  • サイナーPDAは決定論的です — 同じアセットは常に同じPDAアドレスを生成します
  • PDAはSOL、SPLトークンを保持し、他のMPL Coreアセットを所有することもできます
  • アセットの所有者（または承認されたデリゲート）のみが、そのアセットのPDAに対してexecuteインストラクションを呼び出すことができます
  • コマンドはPDAを導出する前にアセットがオンチェーンに存在することを検証します。存在しないアセットはエラーになります
  • 表示される残高はSOL残高のみです — トークン残高を確認するには、アセット署名者ウォレットをアクティブにしてmplx toolbox sol balanceを使用してください
  • これは読み取り専用コマンドです — オンチェーンの状態を作成または変更しません
  • Solana CPIの制約により、一部の操作はexecuteでラップできません — CPI制限事項を参照
Next
概要