Initialize Inscriptions

The initialize instruction creates the inscription accounts for you where the data will be stored. There are three types of initializations:

1. initializeFromMint - for Inscriptions attached to NFTs - you probably want this
2. initialize - for Inscriptions as a storage provider
3. initializeAssociatedInscription - Additional Data Accounts

After the initialization has been done you can write Data to the inscriptions.

When initializing you can choose a shard that is used for numbering. Make sure to use a random one to minimize locks. Read more about Sharding here

initializeFromMint

If you want a tradable inscription you want to use this kind of inscription. It is derived from your NFT. When using this function you have to be the update authority of the NFT.

It can be done like this:

import {
  findInscriptionShardPda,
  initializeFromMint,
} from '@metaplex-foundation/mpl-inscription'

const inscriptionShardAccount = await findInscriptionShardPda(umi, {
  shardNumber: 0, //random number between 0 and 31
})
await initializeFromMint(umi, {
  mintAccount: mint.publicKey,
  inscriptionShardAccount,
}).sendAndConfirm(umi)

Initialize

An Inscription has to be initialized before data can written to it. It can be done like so:

import {
  findInscriptionMetadataPda,
  findInscriptionShardPda,
  initialize,
} from '@metaplex-foundation/mpl-inscription'

const inscriptionAccount = generateSigner(umi)

const inscriptionMetadataAccount = await findInscriptionMetadataPda(umi, {
  inscriptionAccount: inscriptionAccount.publicKey,
})
const inscriptionShardAccount = await findInscriptionShardPda(umi, {
  shardNumber: 0, //random number between 0 and 31
})

await initialize(umi, {
  inscriptionAccount,
  inscriptionShardAccount,
}).sendAndConfirm(umi)

initializeAssociatedInscription

One Inscription account can have multiple Associated Inscription Accounts. They are derived based on the associationTag. For example the tag can be the datatype of the file, e.g. image/png.

Pointers to the associated inscriptions are stored in an array in the inscriptionMetadata Account in the field associatedInscriptions.

To initialize a new Associated Inscription you can use the following function:

import {
  findInscriptionMetadataPda,
  initializeAssociatedInscription,
} from '@metaplex-foundation/mpl-inscription'

const inscriptionMetadataAccount = await findInscriptionMetadataPda(umi, {
  inscriptionAccount: inscriptionAccount.publicKey,
})

await initializeAssociatedInscription(umi, {
  inscriptionMetadataAccount,
  associationTag: 'image/png',
}).sendAndConfirm(umi)