ツールボックス

トークンにメタデータを追加

mplx toolbox token add-metadataコマンドは、メタデータアカウントなしで作成された既存のトークンにメタデータを追加します。これはspl-token CLIや、Token Metadataアカウントを自動的に作成しない他のツールで作成されたトークンに便利です。

基本的な使い方

mplx toolbox token add-metadata <mint> --name "My Token" --symbol "MTK" --image ./logo.png

引数

引数説明
MINTトークンのミントアドレス

オプション

オプション説明
--name <value>トークンの名前(必須)
--symbol <value>トークンシンボル、2-6文字(必須)
--uri <value>メタデータJSONを指すURI(--image、--descriptionと排他的)
--description <value>トークンの説明(メタデータアップロード時に使用)
--image <value>トークン画像ファイルのパス(メタデータアップロード時に使用)
--is-mutableメタデータを後で更新可能にするかどうか(デフォルト: true)

グローバルフラグ

フラグ説明
-c, --config <value>設定ファイルのパス。デフォルトは~/.config/mplx/config.json
-k, --keypair <value>キーペアファイルまたはレジャーへのパス(例: usb://ledger?key=0
-r, --rpc <value>クラスターのRPC URL

  1. 画像と説明でメタデータを追加(自動的にアップロード):
mplx toolbox token add-metadata <mintAddress> \
--name "My Token" \
--symbol "MTK" \
--description "素晴らしいトークン" \
--image ./logo.png
  1. 既存のURIでメタデータを追加:
mplx toolbox token add-metadata <mintAddress> --name "My Token" --symbol "MTK" --uri "https://example.com/metadata.json"
  1. 不変のメタデータを追加。これは元に戻せないので注意!
mplx toolbox token add-metadata <mintAddress> --name "My Token" --symbol "MTK" --is-mutable false

出力

--------------------------------
Add Token Metadata
--------------------------------
Checking for existing metadata... ✓
No existing metadata found
Verifying mint authority... ✓
Mint authority verified
Uploading image... ✓
Uploading metadata JSON... ✓
Creating metadata account... ✓
--------------------------------
Metadata created successfully!
Token Details:
Name: My Token
Symbol: MTK
Mint Address: <mintAddress>
Explorer: https://solscan.io/account/<mintAddress>
Transaction Signature: <signature>
Explorer: https://solscan.io/tx/<signature>
--------------------------------

要件

  • ミント権限が必要: メタデータを追加するには、トークンのミント権限を持っている必要があります
  • 既存のメタデータがないこと: トークンにはまだメタデータアカウントがない必要があります。既存のメタデータを変更するにはmplx toolbox token updateを使用してください

注意事項

  • トークンに既にメタデータがある場合、コマンドは既存のメタデータを表示し、updateコマンドの使用を提案します
  • ミント権限が取り消されている場合、メタデータを追加できません
  • --uriなしで--image--descriptionを指定すると、CLIは自動的にメタデータをストレージにアップロードします
  • --uriフラグは--imageおよび--descriptionと排他的です
  • --is-mutable falseフラグには注意してください。元に戻すことができません