カスタムトークンをSuiウォレットに追加する方法

カスタムトークンの統合について

1.Sui Wallet は、Sui ブロックチェーン上に展開されたすべてのトークンを自動的に検出または表示しません。

2. トークンは、コインタイプのオブジェクト IDとして知られるオンチェーン識別子を使用して、ウォレットのトークン リストに明示的に登録する必要があります。

3. コイン タイプは厳密な形式0x[address]::[module]::[struct]に従います。各セグメントは Move パッケージのデプロイメントから派生します。

4. ユーザーは任意の文字列を追加できません。Sui ネットワークによって認識され、有効で、展開され、検証されたコイン タイプのみが受け入れられます。

5. 大文字と小文字、間隔、またはモジュール パスが正確に一致しない場合、トークンの追加中に拒否されます。

手動追加の前提条件

1. アクティブなアカウントを持つ完全に同期されたSui Wallet拡張機能またはモバイルアプリ。

2. トークンの公式ドキュメントまたはエクスプローラー ページにアクセスして、コイン タイプ IDを確認します。

3. トークン コントラクトが、devnet や testnet だけでなく、メインネットまたはターゲット ネットワーク上で公開されていることの確認。

4. ユーザーのアドレス内のトークン オブジェクトの少なくとも 1 つのインスタンスの所有権。ui client object CLI コマンドによって確認されます。

5. トークンがCoinインターフェースを正しく実装しているかどうかに関する情報。適切な Coin 特性の遵守を欠いたカスタム構造体は残高に表示されません。

ステップバイステップのトークン登録

1.Sui Wallet インターフェースを開き、 「トークン」タブに移動します。

2. 右上隅にある[+ トークンの追加]ボタンをタップまたはクリックします。

3. デフォルトのリストを検索する代わりに、カスタム トークンを選択します。

4. 完全なコイン タイプ文字列を入力フィールドに貼り付けます。切り捨てやエイリアシングは許可されません。

5. ネットワークの互換性を確認します。ウォレットは、現在接続されているネットワーク (メインネットとテストネットなど) に対してタイプを検証します。

6. 検証が成功すると、トークンのシンボル、名前、および小数精度がオンチェーンのメタデータから自動的に取得されます。

7. 「追加」をクリックして登録を完了し、残高同期をトリガーします。

検証と可視性の問題

1. 追加後、 [資産] ビューを確認します。ノードに負荷がかかっている場合、トークンが反映されるまでに最大 30 秒かかる場合があります。

2. トークンが表示されないままの場合は、CLI でsui client events --address [your-address]を使用してオブジェクトの所有権を確認します。

3. 検索バーにオブジェクト ID を貼り付け、パッケージ構造を検査することにより、Sui Explorer とコイン タイプを照合します。

4. 末尾の空白や非表示の Unicode 文字がコイン タイプ文字列と一緒にコピーされていないことを確認します。

5. ウォレットの挿入やスクリプトの実行を妨げるサードパーティのブラウザ拡張機能を無効にします。

よくある質問

Q: トークンを所有していなくても追加できますか? A: いいえ。ウォレットには、残高データを入力するためにコイン オブジェクトの所有インスタンスが少なくとも 1 つ必要です。所有権なしでトークンを追加すると、残高がゼロになり、取引履歴がなくなります。

Q: 私のカスタム トークンの名前が「不明」と表示されるのはなぜですか? A: これは、オンチェーン パッケージにメタデータ公開がない場合、または Move モジュールのCoinMetadata構造体の名前フィールドとシンボルフィールドが空の場合に発生します。

Q: 信頼できないソースからのコイン タイプを貼り付けても安全ですか? A: 本質的に安全ではありません。コインのタイプ自体は不変で公開されていますが、その起源を検証することで、悪意のある名前のクローンや再入可能性のある亜種が誤って追加されることを防ぎます。

Q: ウォレットのバージョンを更新した後、トークンを再度追加する必要がありますか? A: いいえ。トークン構成は、暗号化されたウォレット ストレージにローカルに保存され、手動でクリアされるかウォレット データがリセットされない限り、更新後も保持されます。