feat(oft-solana): create update metadata script

.changeset/shiny-rabbits-cheer.md

@@ -0,0 +1,5 @@
+---
+"@layerzerolabs/oft-solana-example": minor
+---
+
+added script to update metaplex metadata

examples/oft-solana/tasks/index.ts

@@ -6,6 +6,7 @@ import './solana/createOFT'
 import './solana/createOFTAdapter'
 import './solana/sendOFT'
 import './solana/setAuthority'
+import './solana/updateMetadata'
 import './solana/getPrioFees'
 import './solana/base58'
 import './solana/setInboundRateLimit'

examples/oft-solana/tasks/solana/updateMetadata.ts

@@ -0,0 +1,66 @@
+import {
+    UpdateV1InstructionAccounts,
+    UpdateV1InstructionArgs,
+    fetchMetadataFromSeeds,
+    updateV1,
+} from '@metaplex-foundation/mpl-token-metadata'
+import { publicKey, transactionBuilder } from '@metaplex-foundation/umi'
+import bs58 from 'bs58'
+import { task } from 'hardhat/config'
+
+import { types as devtoolsTypes } from '@layerzerolabs/devtools-evm-hardhat'
+import { EndpointId } from '@layerzerolabs/lz-definitions'
+
+import { deriveConnection, getExplorerTxLink } from './index'
+
+interface UpdateMetadataTaskArgs {
+    eid: EndpointId
+    name: string
+    mint: string
+    sellerFeeBasisPoints: number
+    symbol: string
+    uri: string
+}
+
+// note that if URI is specified, then the name and symbol in there would be used and will override the 'outer' name and symbol
+task('lz:oft:solana:update-metadata', 'Updates the metaplex metadata of the SPL Token')
+    .addParam('eid', 'Solana mainnet or testnet', undefined, devtoolsTypes.eid)
+    .addParam('mint', 'The Token mint public key', undefined, devtoolsTypes.string)
+    .addOptionalParam('name', 'Token Name', undefined, devtoolsTypes.string)
+    .addOptionalParam('symbol', 'Token Symbol', undefined, devtoolsTypes.string)
+    .addOptionalParam('sellerFeeBasisPoints', 'Seller fee basis points', undefined, devtoolsTypes.int)
+    .addOptionalParam('uri', 'URI for token metadata', undefined, devtoolsTypes.string)
+    .setAction(async ({ eid, name, mint: mintStr, sellerFeeBasisPoints, symbol, uri }: UpdateMetadataTaskArgs) => {
+        const { umi, umiWalletSigner } = await deriveConnection(eid)
+
+        const mint = publicKey(mintStr)
+
+        const initialMetadata = await fetchMetadataFromSeeds(umi, { mint })
+
+        if (initialMetadata.updateAuthority !== umiWalletSigner.publicKey.toString()) {
+            throw new Error('Only the update authority can update the metadata')
+        }
+
+        if (initialMetadata.isMutable == false) {
+            throw new Error('Metadata is not mutable')
+        }
+
+        const isTestnet = eid == EndpointId.SOLANA_V2_TESTNET
+
+        const updateV1Args: UpdateV1InstructionAccounts & UpdateV1InstructionArgs = {
+            mint,
+            authority: umiWalletSigner,
+            data: {
+                ...initialMetadata,
+                name: name || initialMetadata.name,
+                symbol: symbol || initialMetadata.symbol,
+                uri: uri || initialMetadata.uri,
+                sellerFeeBasisPoints:
+                    sellerFeeBasisPoints != undefined ? sellerFeeBasisPoints : initialMetadata.sellerFeeBasisPoints,
+            },
+        }
+
+        const txBuilder = transactionBuilder().add(updateV1(umi, updateV1Args))
+        const createTokenTx = await txBuilder.sendAndConfirm(umi)
+        console.log(`createTokenTx: ${getExplorerTxLink(bs58.encode(createTokenTx.signature), isTestnet)}`)
+    })