Solanaトークンのメタデータ更新：名前・シンボル・ロゴ

トークンメタデータの書き換えは一つの作業に見えて、実は二つあります。メタデータはトークンの名刺で、名前、シンボル、ロゴ、説明、リンクが入ります。ただし一か所にはありません。

二か所に分かれていて、別々に更新されます。

公開後にいちばん多く届く連絡もここから生まれます。ロゴは一週間前に差し替えたのに、Solscanはまだ古い名前を出している、というものです。

• 名前とシンボルとウェブアドレスはチェーン上にあります。変更には手数料がかかります。
• ロゴと説明とSNSのリンクはファイルの中にあります。変更は無料です。
• 片方の層を直しても、もう片方は決して動きません。
• ロックだけは取り消せない唯一の判断です。

トークンメタデータの二つの層

トークンが作られるとき、その情報はMetaplex Token Metadataを通って入ります。Solanaのほぼすべてのトークンが従う規格です。これが一つ目の層を作ります。その口座がミントにどう結びつくかはSolanaのMetaplex Metadataの解説に書かれています。

一層目はチェーン上です。入っているのはちょうど三つで、名前、シンボル、そしてファイルを指すウェブアドレスです。ウォレットもエクスプローラーもまずここを読みます。この三つのどれかに触れることはチェーンへの書き込みであり、費用がかかります。

二層目はそのアドレスにあるファイルです。中にはロゴ、説明、ウェブサイト、SNSのリンクが入っています。どれかを変えるということは、同じアドレスに同じファイルを上げ直すだけです。取引も手数料もありません。

だからロゴを差し替えて名前が動かなくても、壊れてはいません。ロゴはファイルに、名前はチェーンにあり、片方を直しても、もう片方は動かないだけです。

項目	層	変え方	費用
トークン名	チェーン上	更新ツール	0.2 SOL
シンボル	チェーン上	更新ツール	0.2 SOL
ウェブアドレス	チェーン上	更新ツール	0.2 SOL
ロゴ	ファイル	同じアドレスに上げ直す	無料
説明	ファイル	同じアドレスに上げ直す	無料
サイトとSNS	ファイル	同じアドレスに上げ直す	無料

メタデータに触る必要があるとき

• 新しいロゴにしたい。デザインからよくなった版が届いた場合です。ロゴはファイルの中なので、同じアドレスに上げ直せば終わりです。無料です。
• リンクが変わった。Discordが移った、Xのアカウントが変わった、サイトが別のドメインになった。これも同じくファイルだけです。
• 名前かシンボルが間違っている。仮の名前で公開した、あるいはシンボルに打ち間違いがある場合です。ここは封をされた面なので、更新ツールを通ります。
• ファイルを恒久ストレージへ移す。アドレス自体が変わるので、これもチェーンへの書き込みです。この手順は必ずロックより先に来ます。

前の二つはチェーンに一切触れず、費用もかからず、何度でも繰り返せます。後の二つは名前でもシンボルでもアドレスでも同じフォームを通ります。つまり、見た目に関わる部分は無料で、値が付くのは封をされた三項目だけです。

トークンメタデータを更新する手順

ロゴやリンクだけなら、以下の手順は要りません。名前、シンボル、アドレスを変えるなら四つの手順です。

• まず状態を見ます。トークンの状態を読むツールを開いてトークンのアドレスを貼ります。いまの値を読み、編集権限がまだどこかのウォレットにあるかを教えてくれます。無料で、権限が既に手放されているなら手数料を払う意味はありません。
• 正しいウォレットをつなぎます。その権限を持つウォレットだけが署名できます。別のウォレットでは変更は単に通りません。
• 新しい値を入れて署名します。メタデータ更新ツールにアドレスを貼り、変える値を書いてウォレットで承認します。その時点の手数料は確定前にページ上に出ます。
• あとで確認します。状態をもう一度読みます。ロゴは少し待ちが要ります。ウォレットは画像を10分から30分ほどキャッシュに置きます。

ロックの前に、ファイルは恒久的な場所になければなりません。繰り返される事故はこうです。公開時に無料のホストへファイルを置き、数週間後にメタデータをロックし、数か月後にそのホストが期限切れになります。アドレスは404を返すようになります。名前はチェーン上に封をされているので見えたままですが、ロゴと説明は消え、編集権限がもうないので、誰も新しいファイルへ向け直せません。

ロックするか、開けておくか

いずれ誰かがメタデータをロックしろと言います。ロックとは編集権限を永久に手放すことで、運営自身も含め誰も何も変えられなくなります。買う側はこれを見たがりますし、上場のチェックリストが求めることもあります。

決めるのは順番です。まずファイルをArweaveかピン留めしたIPFSへ移し、次にチェーン上のアドレスを新しいリンクへ向け、それから数日かけて別々の二台で開けることを確かめ、そこでようやくロックします。

ロックの深さは選べます。更新権限を取り消すツールは名前とシンボルとアドレスへの権利だけを外します。イミュータブル化ツールは更新と発行とフリーズの権限を一度に手放します。三つを並べた比較はトークンの権限を放棄する解説にあります。

実務的な目安はこうです。ブランドが定まり、半年ほど改名なしで動いていて、ファイルが恒久ストレージにあるか、取引所が明確に求めているならロックします。まだリブランドがありうる、ホストを失うかもしれない、第二版が話に上がっている、そのあいだは待ちます。この流れの中で一方向にしか開かない扉はこれだけです。

メタデータの変更が通らない理由

二つの理由でほぼ全部が説明できます。一つは編集権限が既に取り消されている場合で、多くは作成時にそうなっています。そのときは名前もシンボルもアドレスも永久に封をされています。もう一つは、つないだウォレットが権限を持つウォレットではない場合です。

二つ目はツールの不具合に見えますが違います。状態の読み取りがどのウォレットに権限があるかを示すので、そのウォレットをつなげば済みます。権限が本当に消えているなら戻る道はなく、残るのは新しいトークンを作ることだけです。

よく似ていて無害な三つ目もあります。変更はとうに通っているのに、ウォレットが古い画像を出し続けている場合です。トークンが正しく出ない、あるいは出てこない理由はSolanaのトークンがPhantomで表示されないにまとめました。エクスプローラーの検索に出すことは条件の異なる別の手続きで、Solanaのトークン検証の案内に書かれています。

いちばん繰り返される失敗

• ファイルを直して名前も追随したと思い込む。ロゴはファイル、名前はチェーンです。それぞれ別に確かめてください。
• ファイルが一時的なホストにあるままロックする。この一覧で最も高くつく失敗で、あとから直せません。
• キャッシュを待たない。10分から30分は普通です。やり直す前に状態を読んでください。
• ファイルから名前を変えようとする。ファイル内の名前欄はウォレットが無視します。本当の改名は必ずツールを通ります。
• 違うウォレットで署名する。手数料はかかりませんが、毎回数分の混乱を生みます。

トークンメタデータのよくある質問

公開後にトークン名を変えられますか

編集権限がまだどこかのウォレットにあるなら変えられます。状態の読み取りが無料で教えてくれ、変更は0.2 SOLでそのウォレットが署名します。

なぜ古いロゴのままなのですか

違う層を直したか、ウォレットがまだ画像をキャッシュしているかです。同じアドレスにロゴを上げ直し、状態を読み、キャッシュが切れるのを待ってください。

更新の費用はいくらですか

ファイルを直すのは無料です。名前とシンボルとアドレスは0.2 SOLに少額のネットワーク手数料が加わり、金額は確定前にページに出ます。

イミュータブルにすべきですか

ブランドが固まり、トークンに履歴があり、ファイルが恒久ストレージにあるならそうします。リブランドの余地がある間は待つほうが無難です。

更新権限とは何ですか

特定のウォレットが持つ、チェーン上のメタデータをあとから編集できる権利です。手放した時点で、その記録は永久に封をされます。

Token-2022でも同じですか

一部だけです。Token-2022はメタデータをトークン自体に持てて、別の道を通ります。この記事は多くが使うSPLとMetaplexの流れを扱っています。

メタデータを直す前に

更新は安く、何度でもやり直せるので、初日から完璧である必要はありません。名前は直せますし、ロゴは差し替えられますし、リンクは必要なだけ移せます。取り消せないのはロックだけです。ファイルを恒久ストレージへ移し、アドレスをそこへ向け、開けることを確かめ、そのあとで権限を手放してください。