Features

Locking Assets

As mentioned in the "Delegate Authorities" page, certain delegates can lock and unlock assets, preventing their owners from transferring or burning them. A locked asset also forbids the owner from revoking the delegate's authority. This locking mechanism enables various utility use cases — such as staking — that would otherwise require an escrow account to function.

In the table below, we list all the Token Delegates that support locking assets. You can learn more about each of these delegates and how to approve/revoke them in their respective sections.

DelegateLock/UnlockTransferBurnFor
StandardAll except PNFTs
Locked TransferPNFTs only
UtilityPNFTs only
StakingPNFTs only

Assuming we have an approved Token Delegate on an asset, let's now see how the delegate can lock and unlock it.

Lock an asset

To lock an asset, the delegate may use the Lock instruction of the Token Metadata program. This instruction accepts the following attributes:

  • Mint: The address of the asset's Mint account.
  • Authority: The signer that authorizes the lock. This must be the delegated authority.
  • Token Standard: The standard of the asset being locked. Note that the Token Metadata program does not explicitly require this argument but our SDKs do so they can provide adequate default values for most of the other parameters.

Lock an asset

import { lockV1 } from '@metaplex-foundation/mpl-token-metadata'

await lockV1(umi, {
  mint,
  authority,
  tokenStandard: TokenStandard.NonFungible,
}).sendAndConfirm(umi)

Unlock an asset

Reciprocally, the delegate may use the Unlock instruction of the Token Metadata program to unlock an asset. This instruction accepts the same attributes as the Lock instruction and can be used in the same way.

Unlock an asset

import { unlockV1 } from '@metaplex-foundation/mpl-token-metadata'

await unlockV1(umi, {
  mint,
  authority,
  tokenStandard: TokenStandard.NonFungible,
}).sendAndConfirm(umi)
Previous
Delegated Authorities