更新 Asset

本指南展示如何使用 Metaplex Core SDK 在 Solana 上更新 Core Asset 元数据。修改您控制的 Asset 的名称、URI 或集合成员资格。

概要

使用 update 指令更新 Core Asset 的元数据。只有更新权限（或授权的代理）可以修改 Asset。

• 更改 name 和 uri 以更新元数据
• 使用 newCollection 在 Collection 之间移动 Asset
• 将 updateAuthority 设置为 None 以使其不可变
• 更新是免费的（无租金成本），除非更改账户大小

超出范围

更新 Token Metadata NFT（使用 mpl-token-metadata）、插件修改（参见插件）和所有权转移（参见转移 Asset）。

快速开始

跳转至： 更新 Asset · 更改 Collection · 使其不可变

1. 安装：npm install @metaplex-foundation/mpl-core @metaplex-foundation/umi
2. 获取 Asset 以获取当前状态
3. 使用新值调用 update(umi, { asset, name, uri })
4. 使用 fetchAsset() 验证更改

前置条件

• 配置了作为 Asset 更新权限的签名者的 Umi
• 要更新的 Asset 的 Asset 地址
• 上传到 Arweave/IPFS 的新元数据（如果更改 URI） Core Asset 的更新权限或代理有能力更改 Asset 的某些数据。

更新 Core Asset

以下是如何使用我们的 SDK 更新 MPL Core Asset。

1import { createUmi } from '@metaplex-foundation/umi-bundle-defaults'
2import { update } from '@metaplex-foundation/mpl-core'
3import { mplCore } from '@metaplex-foundation/mpl-core'
4import { publicKey } from '@metaplex-foundation/umi'
5
6const umi = createUmi('https://api.devnet.solana.com').use(mplCore())
7const assetAddress = publicKey('AssetAddressHere...')
8
9// Update an existing NFT asset's metadata
10const result = await update(umi, {
11  asset: assetAddress,
12  name: 'Updated NFT Name',
13  uri: 'https://updated-example.com/metadata.json',
14}).sendAndConfirm(umi)
15
16console.log('Asset updated successfully')

更改 Core Asset 的 Collection

以下是如何使用我们的 SDK 更改 Core Asset 的集合。

import { publicKey } from "@metaplex-foundation/umi";
import {
  update,
  fetchAsset,
  fetchCollection,
  collectionAddress,
  updateAuthority
} from "@metaplex-foundation/mpl-core";
const assetId = publicKey("11111111111111111111111111111111");
const asset = await fetchAsset(umi, assetId);
const collectionId = collectionAddress(asset)
if (!collectionId) {
  console.log("Collection not found");
  return;
}
const collection = await fetchCollection(umi, collectionId);
const newCollectionId = publicKey("22222222222222222222222222222222")
const updateTx = await update(umi, {
  asset,
  collection,
  newCollection: newCollectionId,
  newUpdateAuthority: updateAuthority('Collection', [newCollectionId]),
}).sendAndConfirm(umi);

使 Core Asset 数据不可变

以下是如何使用我们的 SDK 使 Core Asset 完全不可变。请注意，不可变性指南中描述了不同级别的不可变性。

import { publicKey } from '@metaplex-foundation/umi'
import { update, fetchAsset } from '@metaplex-foundation/mpl-core'
const assetId = publicKey('11111111111111111111111111111111')
const asset = await fetchAsset(umi, asset)
await update(umi, {
  asset: asset,
  newUpdateAuthority: updateAuthority('None'),
}).sendAndConfirm(umi)

常见错误

Authority mismatch

您不是 Asset 的更新权限。检查：

const asset = await fetchAsset(umi, assetAddress)
console.log(asset.updateAuthority) // 必须与您的签名者匹配

Collection authority required

更改 Collection 时，您需要同时拥有 Asset 和目标 Collection 的权限。

Asset is immutable

Asset 的更新权限设置为 None。这无法撤销。

注意事项

• 更新前获取 Asset 以确保您拥有当前状态
• 只有更新权限（或代理）可以更新 Asset
• 使 Asset 不可变是永久且不可逆的
• 更改 Collection 可能会影响继承的插件（版税等）
• 更新不会更改 Asset 的所有者

快速参考

更新参数

权限类型

常见问题

我可以撤销使 Asset 不可变吗？

不可以。将更新权限设置为 None 是永久性的。Asset 的名称、URI 和集合成员资格将永久冻结。只有在您确定时才这样做。

如何只更新名称而不更改 URI？

只传递您想要更改的字段。省略 uri 以保持当前值：

await update(umi, { asset, name: 'New Name' }).sendAndConfirm(umi)

更新和转移有什么区别？

更新更改 Asset 的元数据（名称、URI）。转移更改所有权。它们是具有不同权限要求的独立操作。

代理可以更新 Asset 吗？

可以，如果他们已通过 Update Delegate 插件被指定为 Update Delegate。

更新需要花费 SOL 吗？

更新是免费的，除非新数据大于当前账户大小（罕见）。交易费用（约 0.000005 SOL）仍然适用。

术语表