Function Repository Resource:

MintNFT (1.0.0) current version: 1.2.0 »

Mint a non-fungible token (NFT) on a blockchain

Contributed by: Piero Sanchez and Christian Pasquel

ResourceFunction["MintNFT"][nftSpec, transactionSpec]

mints a non-fungible token (NFT) specified by nftSpec, using the transaction specifications given by transactionSpec.

Details and Options

nftSpec is an association with the following keys:

"Name"

name of the NFT

"Thumbnail"

thumbnail image of the NFT

"Source"

source data of the NFT

"Description"

description of the NFT

"Expression"

Wolfram Language expression associated with the NFT

"Notebook"

Wolfram Notebook associated with the NFT

"NFTID"

whether to create an autogenerated ID for the NFT

"NFTQuantity"

number of NFTs to mint

The maximum string length of "Name" is 32 characters.

The maximum string length of "Description" is 64 characters.

The maximum string length of "Expression" is 64 characters.

"Thumbnail" can be a File containing the path to an image file, or an expression such as Image, Graphics or Graphics3D. Ideally, the image size should be less than 1 MB.

"Source" can be a File containing the path to the source file associated with the NFT, or an expression such as Image, Graphics or Graphics3D.

"Notebook" is a File containing the path to a notebook associated with the NFT.

With "NFTID"→True, an ID will be autogenerated using the current UnixTime and a random integer. Note that this is an accessory metadata ID used for readability when sharing the NFT details. This ID does not identify the NFT on the blockchain.

"NFTQuantity" has a default value of 1. With "NFTQuantity"→n, n copies of the NFT will be minted under the same transaction.

Files associated with the NFT, such as the ones specified by "Thumbnail", "Source" and "Notebook", will be automatically uploaded to IPFS and their content identifiers (CIDs) will be added to the NFT's on-chain metadata.

transactionSpec is an association with the following keys:

"OwnerAddress"

recipient address that will own the NFT

"PrivateKey"

private key used to sign the minting transaction

"Fee"

transaction fee

"OutputAmount"

amount of cryptocurrency to include in the new transaction output

"OwnerAddress" can be any valid address, including the address associated with "PrivateKey".

"PrivateKey" should be a PrivateKey associated with the address with enough balance to mint the NFT.

If "Fee" is not included, it will be automatically computed.

If "OutputAmount" is not included, it will be automatically computed.

If the "OwnerAddress" is the same address associated with the "PrivateKey", "OutputAmount" will not be used.

ResourceFunction["MintNFT"] has the following options:

"Preview"

True

whether to preview a transaction instead of submitting to the blockchain

BlockchainBase

{"Cardano","Testnet"}

blockchain to use

The BlockchainBase option for this function currently supports only "Cardano" (Cardano mainnet) and {"Cardano","Testnet"} (Cardano testnet) as values. $BlockchainBase can also be used to set the default BlockchainBase value.

Examples

Basic Examples (13)

Set the default blockchain to the Cardano testnet:

In[1]:=

Out[1]=

Create an image:

In[2]:=

$image = \!\(\* GraphicsBox[RasterBox[CompressedData[" 1:eJzt2e3NI7kRReEBHIkjcQx2CAb82zE5Q4fgXRj6sYNeTrPF6jqXPA+wgHH9 qkWV+FWav/7z3//4119+/Pjx99/++89v//3+v6/9929/+n/d+rvZ/On7rPr7 KtZnzPqslTruj7fmQzXquKp8e15UjyNl/qSMp6ueb+3/6SiflzZ/qqWP/6Pq vrTLfLA+Y+n1+fl1tDrbN41Zn7H0+uxyz6TMhw/6vp2er5I+b7593ern71LP b59/Wv4r7udrnjuL9n3R9v+nrM+Y9bm2ejyUfWaW586Y9Rmj7QMp98yn7/Pt 39O+r1NR1kHKeknbT6jj0h+5n6+Vsp90O2U+PGV9rnWdR9S62Tc9e59Vf1/F +oyln+OzqPvPXbT5mTKe3ftEipR7e8r+v8t4qtDW76xT9xP6/t/N+oxR7ttp 9aTNE8r3OMv6jJ1WH+o5TpkPH5R7Jm3fpo3nLZR1Q11fqd8zbT6njKfqdVXo +3n3+9Du29Wsz1h6fd6uK/X33irU75FSJ+szRq0P5fld+0n3/kOZnx+U8dD2 h/T5Rh3/Kf8e+kEbl/v5WpTzl1qfWfT9vJv1ubbLfrJK6rmZfg+pZn3GqPsA pT5vofdZ3d8v/R6eYtfxd39f9Htm2npPR/9+u9HXSzfrc23X/Ye2n6efm9Wo 56b1Wfv3FLR9YJf9h4K6XqpV/+5K//emqtdVOeWeWY22r7qf32NfNmZ9xij3 Vdo+QP2+VqHNc8o8nGV9xtLrQ6njLvx+x2jnXVe/6vjX5l1c73tL+X5T1suH 9RlLrw+1rk/Rzrv0eU6dh5Q6WZ8x2vyn1Z82nlXj6N7fKPWhSf+c6eN/ijKf T1vvtP055Xekbul9WTXrc43W96XXsxtlX51lXzlmfcZOuydQ50M12rlMu/dS fk9y/Gv/njqfq9Hqc1fKeLqlr5dq1ufaLvvb22h9+i6/D+zWN3XfK6zP2r/v fu5TKeOh5V1o40+vv+PvRVvXKfXpkn7fS58PH9ZnjH7fOy3XPbR1SllHs6zP GLU+Vc+njGPV61JRvq9ZtPHMcvxrud7voax36vdFu+9Vs28dS68Pta5UtD49 Je9CXUeUOlmfsfT1kvLvWen5KtRzvLovcPxrnu96fydfZdfvq1t6X1bN+lyj 7TMpuWpQzv1Z9pVj1met9Hvaabz3jjn+Z/kqrve1/L7usS8bsz7XqL9bno7W p++ar5baN9lXjqXXJ/0etUs9KfOfsq6ecvy90s9T2vql7p/Vz7cvG7M+Y/Tz 1HxtLgbaPkPZB2ZZnzHavrHr82n17J7/Vc93/DVOH//u6/euXZ+fdk+2bx1L rw+1rqei9enmvaj7AKVO1mds13tUl5TxpOyHjv9Zvkr6+GedNp705z+V3pdV sz7XaH2HuZJV/55fxb5y7LT6vFV3yn2NMo5Vr6NIHX/quH+W/jlcvz3Pp+7/ p/RlH9bnGnU9qhatTzd/lq9G6ZtmndZXzqLWp+r56etx13+/667/2/fAVVI+ b3q+yq7r91codaXNh6fo67cb5T5G28fMn+U6A22fpOxjs6zPmPvYGOW+eCra fEvpm/R/6fOh2qn7v33rWHp9qHVVDVqfbv5O3oW6j1HqZH3WSq/PW3V/+96y +nW0+Xla/+T8efe5375Pdf1p0vuyatbnGu3ebv5OLl1JPTftK8fS67PLv69R +ibaOUKt/9v1PO3zrkKtZ9XzU+q/+nWp9XnK+lyjrl9lo/Xp5sx8NfvKZ++z 6u+r0OYbpS4fu6zfu1LGk1LPWemfN2U8rt+1z0+pz4d96xjlPkO7V5szc2kF 2j5P2YdnWZ8xah9Nqc9T367ft8ex6nVVqut52uddPY5Vr6NIr381+9ax9PpQ 66pMtD7dfI+8C3UfptTptPqk/HsHLV/F+q9F+1zOH2a+ylvnVnpfVs36XKOt O/M9cqkD5fftWaf1lbOo9aE9P5V1X8vPm/X8XVC+h13usfat16jnuzRC69PN z8xXs6989j6r/r4KdX6+fS9a/bqq7zd9vVPvdbTxO3/WPPfp697us7rP91n0 enajr3dz8zdzKQHtnKKcI7Osz1q0fZj6/VY9f9f6p4//6fuscvr8SWPfOpZe H2pdpSu0Pt3c/E7ehXqOUOqUXh9KHT9SxrPrev+gjusuyvhPmz+7jCe9L6tm fa7R7o3m5ndyaUe79UEpfWU12r5H/f08df4/Rb+X0vJfSd0fZrl+nz0/7Z5J 3x+6UOe/1Il2XpubV+Srpd4bvVePpdwzd/8d4JR7KU36/uD6HaPOf/eHMcp5 SrvXmZtX5JJ45yzlHJx1Wn0odX8qpY/oRuvjKPN/Fm0+UOryVPrvwLT58FR6 fah1lTrQ+nRzc0LehXoOUupErU/V89PH/5b0e+ld1PmfPh+qnp++fmnz/6lT 9odZtHuXuTkhlzSv+l5UxXv1WPo+TB2/99JrKeM5bT64ft9Fnw9dqL+rSDuj 9enm5on5aqf3lU/fZ9XfU6SO+4O6vu6i3kv9XS5D+vg/7FvHKOcR7V5kbp6Y S6pHuydQzvFZ6fWh9Evfvo4yHz4o49/lHKfU8ynX75q/p87PWen1odZV2hGt Tzc3PyHvQj3HKXWifb9dz0+ZD9Tx06TXkzb+u3ZZv9VOmQ+zaPcWc/MTckk8 lH+/mJV+r66Wfg+flX5O0c5r69nrtPX7Yd967dTf2aSd0c5rc3Pzerv1lbv2 3dR7OGU+fKT+jkTjfOgZx9vvc0rf+kHfz83NzTm5pHy0ew7lHjKLWh/K82nn 1659x+rXOR/Woqxfan1mpff11LpKmkc7v8zNzb/Pu1DvIZQ6UecDpT5vod2r 73I+1Hh7PqTs5x/pfWsV2rlvbm7+fS7pPN/eW7pQ+wJane6inUennYMp4zkt T2Pfes3fhSTNop1H5ubm7+erpfaV6X03pY67oN6rnQ89UtZ79/4/i3Je0M5l c3Pz93NJ+hXaPY1yj5pF27dp9aeNZ9U40s7xU77frvXV/f3OSu/rqXWVxEPr 083Nzfl5F+o9ilKn0+751PlAQ+tT7koZT7f0vrUK7dw0Nzfn55K0GuXfa2ZR +6yqOqXUvwvtvE4/908dj33rtVN/p5LERTuvzc3N98tXo/SVs6h9d9XzKeNY 9bpT+P2ueT51/5xF2W9p55q5ufl+uSR1o90zKffAWennSNfzzcf5Krt+v92q 9ivqfitJVWjnr7m5uXkX6j2QVqe70vssjfn93pPet1ahnTvm5ubmkpTm23tj l/S+O70P2qWetPGsHsfbz7dvvfZWPSWJgtanm5ubm3ffG6vuydVo9dz1+bR6 0saT/vzu/WcWZb+inQvm5ubmafu5JFWj/fsO5R47a9c+qMtp40l//lNV6526 X0lSKlqfbm5ubr7r74HUe+zb/36U9j7f9ilvj2PV67qfT50/tL61Cm3fNjc3 N9/1fihJVJQ+aBa17656fvq52fX87vpQ6kqbD7Oo9ZekVLQ+3dzc3JyWrzb7 PpR77C71r0Lp96hOnT+U9U7bV83Nzc1puSTpO3f317f2bco9vFp6fdJ/h0md Nz97uz7d612SdI3Wp5ubm5un512o93BKn0WtT9XzafM5Zb6dtt7Nzc3NzSVJ HSh94izaubNrfVLO8V1+x6hC/V1FknSN1qebm5ubn5avNvs+lHs4tY+m1Ocp yu8w1DpS1gttXzI3Nzc/LZcksX3b16w+F+h9RPXz0/NV0n/noa4XSVIP2nlt bm5ubj7Ou+zSR9DqSkOpv+vF3Nzc3PzNXJK0l2/7ji7Uc3D2ddX1f3s83fWv Qv3dRpLUg9anm5ubm5uvzVer6stoaPWnjectlPlGW9fm5ubm5mtzSdLZ7p4P b507VX0Q7RzcZTxvf1/d802StCdan25ubm5u3pt3oY2f2mdRfgegfV+zaOvO 3Nzc3Lw3lyRpBqUvm5XSJ6b9DlCF+ruEJGlPtD7d3Nzc3DwrX232farGld5f +X2Zm5ubm5vfzyVJqnT3/HnrXKs+D7/9vFWvW/38Xb4vSZJ+R+vTzc3Nzc33 zrukf9708c+izVtzc3Nz871zSZJI7p5X6efaqeNP/9ySpD3R+nRzc3Nzc/NK s+9D6dPf6kOrPgdtXpmbm5ubm0uStItv+9auc7Pr+as/r/cLSdIOaH26ubm5 ubn5N3mX9D56Fu17Nzc3Nzc3/yaXJOkkd8/D9D736fO9L0iSTkTr083Nzc3N zd/MV6P2u0+fa25ubm5ufkIuSZL+3N3zk3qOe/5LkvRrtD7d3Nzc3NycnKeg 1c3c3Nzc3JycS5Kkde6et0/PZc9zSZLWo/Xp5ubm5ubmO+Wr0D6Xubm5ubn5 TrkkSXqP57EkSQT/A3ntk+c= "], {{0, 0}, {161, 81}}, {0, 1}], Frame->False, FrameLabel->{None, None}, FrameTicks->{{None, None}, {None, None}}, GridLinesStyle->Directive[ GrayLevel[0.5, 0.4]], ImageSize->250, Method->{"DefaultBoundaryStyle" -> Automatic, "DefaultGraphicsInteraction" -> {"Version" -> 1.2, "TrackMousePosition" -> {True, False}, "Effects" -> {"Highlight" -> {"ratio" -> 2}, "HighlightPoint" -> {"ratio" -> 2}, "Droplines" -> {"freeformCursorMode" -> True, "placement" -> {"x" -> "All", "y" -> "None"}}}}, "DefaultPlotStyle" -> Automatic}, PlotRangePadding->0]\);$

Get your keys and address:

In[3]:=

Out[3]=

In[4]:=

Out[4]=

You need some tADA (the Cardano cryptocurrency) in your address to send transactions. To achieve this, you will use a Cardano Testnet Faucet. This is a website that will send some amount of tADA to your address.

To use it, copy your address to the clipboard and visit the Cardano Testnet Faucet:

In[5]:=

In[6]:=

Paste your address in the Address field (double-check that your address is complete and does not have extra characters such as double quotes). Make sure tAda is selected in the drop-down menu. Click the "I'm not a robot" captcha and then the Request funds button:

Once you request funds, it may take about a minute for the transaction to be added to the blockchain.

Once the transaction has been added to the blockchain, check your address balance (and other details) with the BlockchainAddressData function by running this line:

In[7]:=

Out[7]=

If this line returns an error, that means the transaction has not been added to the blockchain yet. Wait a moment, then try running the line of code again. You will see here the details of your address, including your balance (given in Lovelace units). If you just want to extract your balance, you can evaluate the following:

In[8]:=