The on-chain name of the asset, e.g. "My SFT".
The royalties in percent basis point (i.e. 250 is 2.5%) that should be paid to the creators on each secondary sale.
Optional
updateThe authority that will be able to make changes to the created SFT.
This is required as a Signer because creating the metadata account requires the update authority to be part of the creators array as a verified creator.
metaplex.identity()
Optional
mintThe authority allowed to mint new tokens for the mint account that is either explicitly provided or about to be created.
metaplex.identity()
Optional
useThe address of the new mint account as a Signer. This is useful if you already have a generated Keypair for the mint account of the SFT to create.
Keypair.generate()
Optional
useThe address of the existing mint account that should be converted into an SFT. The account at this address should have the right requirements to become an SFT, e.g. it shouldn't already have a metadata account associated with it.
Defaults to creating a new mint account with the right requirements.
Optional
tokenThe owner of a token account associated with the SFT to create.
This is completely optional as creating an SFT does not require the existence of a token account. When provided, an associated token account will be created from the given owner.
You may alternatively pass the tokenAddress
parameter instead.
Defaults to not creating and/or minting any token account.
Optional
tokenAn explicit token account associated with the SFT to create.
This is completely optional as creating an SFT does not require the existence of a token account.
When provided, the token account will be created if and only
if no account exists at the given address. When that's the case,
the tokenAddress
must be provided as a Signer as we're creating
and initializing the account at this address.
You may alternatively pass the tokenOwner
parameter instead.
Defaults to not creating and/or minting any token account.
Optional
tokenThe amount of tokens to mint to the token account initially if a token account is created.
This is only relevant if either the tokenOwner
or tokenAddress
is provided.
Defaults to not minting any tokens.
Optional
decimals?: numberThe number of decimal points used to define token amounts.
0
Optional
tokenDescribes the asset class of the token. It can be one of the following:
TokenStandard.NonFungible
: A traditional NFT (master edition).TokenStandard.FungibleAsset
: A fungible token with metadata that can also have attrributes.TokenStandard.Fungible
: A fungible token with simple metadata.TokenStandard.NonFungibleEdition
: A limited edition NFT "printed" from a master edition.TokenStandard.ProgrammableNonFungible
: A master edition NFT with programmable configuration.TokenStandard.FungibleAsset
Optional
symbol?: stringThe on-chain symbol of the asset, stored in the Metadata account. E.g. "MYSFT".
""
Optional
creators?: CreatorInput[]This object provides a way of providing creator information when needed, e.g. when creating or updating NFTs, candy machines, etc.
It allows us to optionally provide an authority as a Signer so we can both set and verify the creator within the same operation.
Defaults to using the provided updateAuthority
as the only verified creator.
[{
address: updateAuthority.publicKey,
authority: updateAuthority,
share: 100,
}]
Optional
isWhether or not the SFT's metadata is mutable.
When set to false
no one can update the Metadata account,
not even the update authority.
true
Optional
maxThe maximum supply of printed editions for NFTs.
When this is null
, an unlimited amount of editions
can be printed from the original edition.
toBigNumber(0)
Optional
primaryWhether or not selling this asset is considered a primary sale.
Once flipped from false
to true
, this field is immutable and
all subsequent sales of this asset will be considered secondary.
false
Optional
uses?: Option<Uses>When this field is not null
, it indicates that the SFT
can be "used" by its owner or any approved "use authorities".
null
Optional
isWhether the created SFT is a Collection SFT.
When set to true
, the SFT will be created as a
Sized Collection SFT with an initial size of 0.
false
Optional
collection?: Option<PublicKey>The Collection NFT that this new SFT belongs to.
When null
, the created SFT will not be part of a collection.
null
Optional
collectionThe collection authority that should sign the created SFT
to prove that it is part of the provided collection.
When null
, the provided collection
will not be verified.
null
Optional
collectionWhether or not the provided collectionAuthority
is a delegated
collection authority, i.e. it was approved by the update authority
using metaplex.nfts().approveCollectionAuthority()
.
false
Optional
collectionWhether or not the provided collection
is a sized collection
and not a legacy collection.
true
Optional
ruleThe ruleset account that should be used to configure the programmable NFT.
This is only relevant for programmable NFTs, i.e. if the
tokenStandard
is set to TokenStandard.ProgrammableNonFungible
.
null
Generated using TypeDoc
The URI that points to the JSON metadata of the asset.