当您在Solana上创建代币时，基础的SPL Token程序仅存储原始的代币余额和精度（Decimals）。它原生并不存储人类可读的代币名称、Ticker符号、描述、官网或Logo图片。
为了在各类钱包（如Phantom和Solflare）以及DEX界面（如Raydium和DexScreener）中展示丰富的代币品牌信息，Solana采用了 Metaplex代币元数据标准（Metaplex Token Metadata Standard）。
理解链上元数据账户如何与链下JSON文件建立关联，能够确保您的代币Logo和详细信息稳定显示，避免出现图片损坏或渲染异常。
链上指针账户 vs 链下元数据
Metaplex元数据标准将代币信息清晰地划分为两个独立层级：
直接存储在Solana验证者内存中的专用账户，由代币Mint地址派生而来（即PDA账户）。它存储固定的可查询字符串字段：
- 名称（Name）： 代币名称（最高32个字符）。
- 符号（Symbol）： Ticker符号（最高10个字符）。
- URI： 指向链下JSON文件的URL字符串（最高200个字符）。
- 更新权限（Update Authority）： 允许更新元数据的公钥地址。
2. 链下 JSON 元数据文件（Off-Chain）
托管在永久去中心化存储（如Arweave或IPFS）上的结构化JSON文件。该文件包含项目的扩展详细信息：
image: 指向PNG、JPEG或SVG格式Logo图片的直接URL。description: 项目的详细介绍。external_url: 官方网站链接。properties.files: 媒体资产与内容类型数组。
官方规范在Metaplex开发者文档中保持更新。
代币Logo显示损坏的常见原因
代币创建者经常发现，他们的代币Logo可以在Phantom钱包中显示，但却无法在Solscan上加载（或者反之）。这通常是由以下规格不匹配导致的：
- 非直接图片URL： 链接到了包含图片的网页，而非以
.png 或 .svg 结尾的直接图片URL。
- CORS跨域限制： 将图片托管在阻止钱包和DEX前端进行跨域资源共享（CORS）请求的中心化服务器上。
- 图片比例非正方形： 上传了长方形图片。钱包界面通常要求正方形比例（例如 512x512 像素）。
- 临时托管服务商： 将图片托管在会在30天后自动删除文件的临时上传网站上。
推荐的元数据格式化标准
为确保在所有Solana钱包和DEX聚合器上获得一致的渲染效果，请遵循以下规范：
- 图片格式： PNG 或 SVG（推荐透明背景）。
- 图片尺寸： 512x512 像素正方形（文件大小小于 1 MB）。
- JSON托管： 永久去中心化存储（Arweave或IPFS网关）。
- HTTPS规范： 所有 URI 均须使用安全的
https:// 或 ar:// 协议前缀。
PumpBolt 如何实现元数据创建自动化
手动创建、固定和链接 Metaplex JSON 文件需要配置 Arweave 钱包和命令行开发工具。
PumpBolt Solana代币创建器在一一步中实现了全流程自动化：
- 您直接在网页表单中上传正方形Logo图片。
- PumpBolt 自动优化图片并将其上传至永久去中心化存储。
- PumpBolt 生成符合规范的 Metaplex JSON 元数据文件并将其固定至 Arweave。
- 铸造代币时，PumpBolt 在同一笔交易中将 Arweave URI 绑定至您的链上 Metaplex 元数据账户。
遵循 Metaplex 标准并采用永久存储，能确保您的代币品牌在整个Solana生态系统中保持清晰可见且不可篡改。