如何将自定义代币添加到 Sui 钱包

了解自定义令牌集成

1. Sui钱包不会自动检测或显示Sui区块链上部署的所有代币。

2. 代币必须使用其链上标识符（称为代币类型的对象 ID）显式注册在钱包的代币列表中。

3. 币类型遵循严格的格式： 0x[address]::[module]::[struct] ，其中每个段均源自 Move 包部署。

4. 用户不能添加任意字符串——仅接受 Sui 网络识别的有效、已部署和已验证的币种。

5. 未能匹配确切的大小写、间距或模块路径会导致在令牌添加过程中被拒绝。

手动添加的先决条件

1. 与活动帐户完全同步的 Sui Wallet 扩展程序或移动应用程序。

2. 访问代币的官方文档或浏览器页面，确认其代币类型 ID 。

3. 确认代币合约已发布在主网或目标网络上，而不仅仅是开发网或测试网。

4. 用户地址中至少一个令牌对象实例的所有权，通过sui client object CLI 命令进行验证。

5. 了解代币是否正确实现Coin接口 - 缺乏适当 Coin 特征遵守的自定义结构不会出现在余额中。

分步令牌注册

1. 打开 Sui Wallet 界面并导航至“Tokens”选项卡。

2. 点击或单击右上角的+ 添加令牌按钮。

3. 选择自定义令牌而不是搜索默认列表。

4. 将完整的硬币类型字符串粘贴到输入字段中 - 不允许截断或别名。

5、确认网络兼容性；钱包将根据当前连接的网络（例如，主网与测试网）验证类型。

6. 验证成功后，将从链上元数据中自动获取代币符号、名称和小数精度。

7. 点击添加完成注册并触发余额同步。

验证和可见性问题

1. 添加后，检查资产视图 - 令牌可能需要长达 30 秒的时间才能反映节点是否处于负载状态。

2. 如果令牌仍然不可见，请在 CLI 中使用sui client objects --address [your-address]验证对象所有权。

3. 通过将对象 ID 粘贴到搜索栏中并检查包结构，对照 Sui Explorer 交叉检查硬币类型。

4. 确保没有尾部空格或不可见的 Unicode 字符与硬币类型字符串一起复制。

5. 禁用任何干扰钱包注入或脚本执行的第三方浏览器扩展。

常见问题解答

问：我可以在不拥有任何代币的情况下添加代币吗？答：不需要。钱包需要至少一个拥有的硬币对象实例来填充余额数据。添加没有所有权的代币会导致余额为零且没有交易历史记录。

问：为什么我的自定义令牌名称显示为“未知”？答：当链上包缺少元数据发布或 Move 模块的CoinMetadata结构中的名称和符号字段为空时，就会出现这种情况。

问：粘贴来自不受信任来源的硬币类型是否安全？答：并不是本质上不安全——硬币类型本身是不可变的和公开的——但验证其来源可以防止意外添加恶意命名的克隆或容易重入的变体。

Q：钱包版本更新后需要重新添加Token吗？答：不会。代币配置本地存储在加密钱包存储中，并在更新后持续存在，除非手动清除或重置钱包数据。