import { ValidationError } from '../../errors' import { isHex } from '../utils' import { BaseTransaction, GlobalFlags, validateBaseTransaction } from './common' /** * Transaction Flags for an NFTokenMint Transaction. * * @category Transaction Flags */ export enum NFTokenMintFlags { /** * If set, indicates that the minted token may be burned by the issuer even * if the issuer does not currently hold the token. The current holder of * the token may always burn it. */ tfBurnable = 0x00000001, /** * If set, indicates that the token may only be offered or sold for XRP. */ tfOnlyXRP = 0x00000002, /** * If set, indicates that the issuer wants a trustline to be automatically * created. */ tfTrustLine = 0x00000004, /** * If set, indicates that this NFT can be transferred. This flag has no * effect if the token is being transferred from the issuer or to the * issuer. */ tfTransferable = 0x00000008, } /** * Map of flags to boolean values representing {@link NFTokenMint} transaction * flags. * * @category Transaction Flags */ export interface NFTokenMintFlagsInterface extends GlobalFlags { tfBurnable?: boolean tfOnlyXRP?: boolean tfTrustLine?: boolean tfTransferable?: boolean } /** * The NFTokenMint transaction creates an NFToken object and adds it to the * relevant NFTokenPage object of the minter. If the transaction is * successful, the newly minted token will be owned by the minter account * specified by the transaction. */ export interface NFTokenMint extends BaseTransaction { TransactionType: 'NFTokenMint' /** * Indicates the taxon associated with this token. The taxon is generally a * value chosen by the minter of the token and a given taxon may be used for * multiple tokens. The implementation reserves taxon identifiers greater * than or equal to 2147483648 (0x80000000). If you have no use for this * field, set it to 0. */ NFTokenTaxon: number /** * Indicates the account that should be the issuer of this token. This value * is optional and should only be specified if the account executing the * transaction is not the `Issuer` of the `NFToken` object. If it is * present, the `MintAccount` field in the `AccountRoot` of the `Issuer` * field must match the `Account`, otherwise the transaction will fail. */ Issuer?: string /** * Specifies the fee charged by the issuer for secondary sales of the Token, * if such sales are allowed. Valid values for this field are between 0 and * 50000 inclusive, allowing transfer rates between 0.000% and 50.000% in * increments of 0.001%. This field must NOT be present if the * `tfTransferable` flag is not set. */ TransferFee?: number /** * URI that points to the data and/or metadata associated with the NFT. * This field need not be an HTTP or HTTPS URL; it could be an IPFS URI, a * magnet link, immediate data encoded as an RFC2379 "data" URL, or even an * opaque issuer-specific encoding. The URI is NOT checked for validity, but * the field is limited to a maximum length of 256 bytes. * * This field must be hex-encoded. You can use `convertStringToHex` to * convert this field to the proper encoding. * * This field must not be an empty string. Omit it from the transaction or * set to `undefined` value if you do not use it. */ URI?: string | null Flags?: number | NFTokenMintFlagsInterface } /** * Verify the form and type of an NFTokenMint at runtime. * * @param tx - An NFTokenMint Transaction. * @throws When the NFTokenMint is Malformed. */ export function validateNFTokenMint(tx: Record): void { validateBaseTransaction(tx) if (tx.Account === tx.Issuer) { throw new ValidationError( 'NFTokenMint: Issuer must not be equal to Account', ) } if (typeof tx.URI === 'string' && tx.URI === '') { throw new ValidationError('NFTokenMint: URI must not be empty string') } if (typeof tx.URI === 'string' && !isHex(tx.URI)) { throw new ValidationError('NFTokenMint: URI must be in hex format') } if (tx.NFTokenTaxon == null) { throw new ValidationError('NFTokenMint: missing field NFTokenTaxon') } }