Assign an Authorized Minter Using JavaScript

You can assign another account permission to mint NFTs for you.

This example shows how to:

Authorize an account to create NFTs for your account.
Mint an NFT for another account, when authorized.

Usage

You can download the Quickstart Samples archive to try the sample in your own browser.

Get Accounts

Open 6.authorized-minter.html in a browser.
Choose your ledger instance (Testnet or Devnet).
1. If you have existing test account seeds:
  1. Paste the account seeds in the Seeds field.
  2. Click Get Accounts from Seeds.
2. If you do not have existing test accounts:
  1. Click Get New Standby Account.
  2. Click Get New Operational Account.

Authorize an Account to Create NFTs

To authorize another account to create NFTs for your account:

Copy the Operational Account value.
Paste the Operational Account value in the Authorized Minter field.
Click Set Minter.

Mint an NFT for Another Account

This example uses the Operational account, which was authorized in the previous step, to mint a token on behalf of the Standby account.

To mint a non-fungible token for another account:

Set the Flags field. For testing purposes, we recommend setting the value to 8.
Enter the NFT URL. This is a URI that points to the data or metadata associated with the NFT object. You can use the sample URI provided if you do not have one of your own.
Enter the Transfer Fee, a percentage of the proceeds that the original creator receives from future sales of the NFT. This is a value of 0-50000 inclusive, allowing transfer rates between 0.000% and 50.000% in increments of 0.001%. If you do not set the Flags field to allow the NFT to be transferrable, set this field to 0.
Copy the Standby Account value.
Paste the Standby Account value in the Operational account Issuer field.
Click the Operational account Mint Other button.

Once the item is minted, the authorized minter can sell the NFT normally. The proceeds go to the authorized minter, less the transfer fee. The minter and the issuer can settle up on a division of the price separately.

Create a Sell Offer

To create an NFT sell offer:

On the Operational account side, enter the Amount of the sell offer in drops (millionths of an XRP), for example 100000000 (100 XRP
Set the Flags field to 1.
Enter the NFT ID of the minted NFT you want to sell.
Optionally, enter a number of days until Expiration.
Click Create Sell Offer.

The important piece of information in the response is the NFT Offer Index, labeled as nft_offer_index, which is used to accept the sell offer.

Accept Sell Offer

Once a sell offer is available, you can create a new account to accept the offer and buy the NFT.

To accept an available sell offer:

Click Get New Standby Account.
Enter the NFT Offer Index (labeled as nft_offer_index in the NFT offer results. This is different from the nft_id).
Click Accept Sell Offer.

The results show that the Issuer account has been credited 25 XRP. The Buyer account was debited the 100 XRP price plus 12 drops as the transaction cost. The Seller (Authorized Minter) account is credited 75 XRP. the Issuer and the Seller can divide the proceeds per their agreement in a separate transaction.

Code Walkthrough

You can download the Quickstart Samples archive to try each of the samples in your own browser.

Set Minter

This function sets the authorized minter for an account. Each account can have 0 or 1 authorized minter that can mint NFTs in its stead.

// *******************************************************
// ****************  Set Minter  *************************
// *******************************************************

async function setMinter() {

Connect to the ledger and get the account.

  let net = getNet()
  const client = new xrpl.Client(net)
  results = 'Connecting to ' + getNet() + '....'
  standbyResultField.value = results    
  await client.connect()
  results += '\nConnected, finding wallet.'
  standbyResultField.value = results    
  my_wallet = xrpl.Wallet.fromSeed(standbySeedField.value)
  standbyResultField.value = results    ```

Define the AccountSet transaction, setting the `NFTokenMinter` account and the `asfAuthorizedNFTokenMinter` flag.

```javascript
  tx_json = {
    "TransactionType": "AccountSet",
    "Account": my_wallet.address,

Set NFTokenMinter to the account number of the authorized minter.

    "NFTokenMinter": standbyMinterField.value,

Set the asfAuthorizedNFTokenMinter flag (the numeric value is 10).

    "SetFlag": xrpl.AccountSetAsfFlags.asfAuthorizedNFTokenMinter
    }

Report progress.

  results += '\nSet Minter.' 
  standbyResultField.value = results

Prepare and send the transaction, then wait for results

  const prepared = await client.autofill(tx_json)
  const signed = my_wallet.sign(prepared)
  const result = await client.submitAndWait(signed.tx_blob)

If the transaction succeeds, show the results. If not, report that the transaction failed.

  if (result.result.meta.TransactionResult == "tesSUCCESS") {
    results += '\nAccount setting succeeded.\n'
    results += JSON.stringify(result,null,2)
    standbyResultField.value = results    
  } else {
    throw 'Error sending transaction: ${result}'
    results += '\nAccount setting failed.'
  standbyResultField.value = results    
  }

Disconnect from the XRP Ledger.

  client.disconnect()
} // End of configureAccount()

Mint Other

This revised mint function allows one account to mint for another issuer.


// *******************************************************
// ****************  Mint Other  *************************
// *******************************************************

async function mintOther() {

Connect to the ledger and get the account.

  results = 'Connecting to ' + getNet() + '....'
  standbyResultField.value = results    
  let net = getNet()
  const standby_wallet = xrpl.Wallet.fromSeed(standbySeedField.value)
  const client = new xrpl.Client(net)
  await client.connect()

Report success

  results += '\nConnected. Minting NFT.'
  standbyResultField.value = results

This transaction blob is the same as the one used for the previous mintToken() function, with the addition of the Issuer field.

  const tx_json = {
    "TransactionType": "NFTokenMint",
    "Account": standby_wallet.classicAddress,

The URI is a link to a data file represented by the NFT.

    "URI": xrpl.convertStringToHex(standbyTokenUrlField.value),

At a minimum, we recommend that you set the tfTransferable flag (8) to enable accounts to sell and resell the NFT for testing purposes.

    "Flags": parseInt(standbyFlagsField.value),

Transfer fee is a value 0-50000 representing .001% of the price for a resale to be returned to the original issuer. For example, 25000 translates to 25% of the price to be sent to the issuer on resale.

    "TransferFee": parseInt(standbyTransferFeeField.value),

The Issuer is the original creator of the object represented by the NFT.

    "Issuer": standbyIssuerField.value,

The NFTokenTaxon is an optional number field the issuer can use for their own purposes. The same taxon can be used for multiple tokens. Set it to 0 if you have no use for it.

    "NFTokenTaxon": 0 //Required, but if you have no use for it, set to zero.
  }

Submit the transaction and wait for the results.

  const tx = await client.submitAndWait(tx_json, { wallet: standby_wallet} )
  const nfts = await client.request({
    method: "account_nfts",
    account: standby_wallet.classicAddress
  })

Report the results.

  results += '\n\nTransaction result: '+ tx.result.meta.TransactionResult
  results += '\n\nnfts: ' + JSON.stringify(nfts, null, 2)
  standbyResultField.value = results  + (await
    client.getXrpBalance(standby_wallet.address))
  standbyResultField.value = results