MPLX CLI - 上传资产命令

mplx cm upload 命令将资产上传到去中心化存储,并生成包含上传 URI 和元数据的 asset-cache.json 文件。此命令提供智能缓存、进度跟踪和全面验证。

用法

# 从当前 candy machine 目录上传资产
mplx cm upload

# 从特定 candy machine 目录上传资产
mplx cm upload <directory>

目录结构

my-candy-machine/
├── assets/
│   ├── 0.png              # 图像文件 (PNG, JPG)
│   ├── 0.json             # 元数据文件
│   ├── 1.png
│   ├── 1.json
│   ├── ...
│   ├── collection.png      # 集合图像
│   └── collection.json     # 集合元数据
└── asset-cache.json        # 上传后生成

上传过程

资产发现: 命令自动扫描 assets/ 目录并识别图像、元数据和集合文件。
验证阶段: 验证文件的完整性,例如所有图像文件是否都有匹配的元数据文件以及元数据是否为有效的 json。
缓存检查: 为了识别哪些文件已经上传,验证 asset-cache.json 文件。
上传: 实际上传完成。
缓存生成: 生成 asset-cache.json 文件

生成的资产缓存

asset-cache.json 文件包含有关上传资产的详细信息。仅建议高级用户手动检查和使用它。

示例:

{
  "candyMachineId": null,
  "collection": null,
  "assetItems": {
    "0": {
      "name": "Asset #0",
      "image": "0.png",
      "imageUri": "https://gateway.irys.xyz/ABC123...",
      "imageType": "image/png",
      "json": "0.json",
      "jsonUri": "https://gateway.irys.xyz/DEF456...",
      "loaded": false
    },
    "1": {
      "name": "Asset #1",
      "image": "1.png",
      "imageUri": "https://gateway.irys.xyz/GHI789...",
      "imageType": "image/png",
      "json": "1.json",
      "jsonUri": "https://gateway.irys.xyz/JKL012...",
      "loaded": false
    }
  }
}

下一步

验证您的上传 确保一切都正确上传
创建您的 candy machine 使用上传的资产
插入项目 将资产加载到 candy machine
监控您的设置 验证一切正常工作

用法

目录结构

上传过程

生成的资产缓存

相关命令

下一步