更新资产

Summary

mplx core asset update 命令可修改 MPL Core 资产的链上名称、URI、图片、链下元数据或集合成员身份。

• 单独更新元数据字段 (--name、--uri) 或从 JSON 文件更新 (--offchain)
• 使用 --image 上传并分配新图片
• 将资产添加到集合、在集合之间移动或从集合中移除
• 调用者必须是资产当前的更新权限（或集合资产的情况下是集合的更新权限）

Basic Usage

mplx core asset update <assetId> [options]

您必须至少提供一个更新标志。可以在单个命令中组合多个标志 — 例如，同时更新名称并添加到集合。

Update Options

以下标志控制 mplx core asset update 命令对资产所做的修改。

Global Flags

这些标志适用于所有 mplx core 命令，用于配置 CLI 运行时。

Update Metadata

更新资产的名称、URI、图片或链下元数据。--offchain 标志读取本地 JSON 文件并从其 name 字段同步链上名称。--image 标志上传文件并更新元数据中的图片 URI。

1# Update name and URI
2mplx core asset update <assetId> --name "Updated Asset" --uri "https://example.com/metadata.json"
3
4# Update with a JSON metadata file
5mplx core asset update <assetId> --offchain ./asset/metadata.json
6
7# Update with a new image
8mplx core asset update <assetId> --image ./asset/image.jpg
9
10# Update with JSON metadata and image
11mplx core asset update <assetId> --offchain ./asset/metadata.json --image ./asset/image.jpg

Manage Collection Membership

--collection 和 --remove-collection 标志控制资产所属的集合。这些标志可以单独使用，也可以与元数据更新标志结合在单个事务中使用。

Add an Asset to a Collection

--collection 标志将独立资产分配给集合。资产的更新权限从地址更改为集合。

1# Add a standalone asset to a collection
2mplx core asset update <assetId> --collection <collectionId>
3
4# Or use the convenience alias
5mplx core collection add <collectionId> <assetId>

Output:

✔ Asset added to collection (Tx: <transactionSignature>)

Move an Asset to a Different Collection

对已经属于集合的资产使用相同的 --collection 标志。CLI 会检测现有集合并将资产移动到新集合。

1# Move an asset from its current collection to a different one
2mplx core asset update <assetId> --collection <newCollectionId>

Output:

✔ Asset moved to new collection (Tx: <transactionSignature>)

Remove an Asset from a Collection

--remove-collection 标志将资产从其当前集合中分离。资产的更新权限从集合恢复为签名者的地址。

1# Remove an asset from its current collection
2mplx core asset update <assetId> --remove-collection

Output:

✔ Asset removed from collection (Tx: <transactionSignature>)

对不在集合中的资产运行 --remove-collection 会产生错误：

✖ Asset is not in a collection
  Error: Cannot remove from collection: asset does not belong to a collection

Output

元数据更新成功后，命令会显示：

--------------------------------
  Asset: <assetId>
  Signature: <transactionSignature>
  Explorer: <explorerUrl>
  Core Explorer: https://core.metaplex.com/explorer/<assetId>
--------------------------------

对于仅集合的操作，输出为单行确认：

✔ Asset added to collection (Tx: <transactionSignature>)

使用 --json 获取结构化输出：

{
  "asset": "<assetId>",
  "signature": "<transactionSignature>",
  "explorer": "<explorerUrl>"
}

Quick Reference

一目了然的 mplx core asset update 命令详情、范围和源位置。

Notes

• 您必须至少提供一个更新标志：--name、--uri、--image、--offchain、--collection 或 --remove-collection
• --name 和 --uri 标志不能与 --offchain 一起使用
• --collection 和 --remove-collection 标志是互斥的
• 使用 --offchain 时，JSON 元数据文件必须包含有效的 name 字段 — 链上名称从该字段同步
• --image 标志自动上传文件并更新元数据中的图片 URI
• 集合操作会更改资产的更新权限：添加到集合会将其设置为集合地址；移除会恢复为签名者的钱包地址
• 调用者必须是资产的更新权限（或集合资产的情况下是集合的更新权限）才能执行任何更新
• 此命令仅适用于 MPL Core Assets — 对于 Token Metadata NFT，请使用不同的更新指令