From b2e4557eb0cfe0429c4c7a7194f1bc973d1c6f45 Mon Sep 17 00:00:00 2001 From: Filippo Date: Tue, 14 Feb 2023 10:09:08 +0100 Subject: [PATCH 01/18] added info banner uniques --- docs/learn/learn-nft-pallets.md | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/docs/learn/learn-nft-pallets.md b/docs/learn/learn-nft-pallets.md index 0d804b535f0f..61880c3a80f1 100644 --- a/docs/learn/learn-nft-pallets.md +++ b/docs/learn/learn-nft-pallets.md @@ -153,6 +153,13 @@ Creating an item usually involves setting some attributes specific to that item. ## Uniques Pallet +:::info + +The Uniques Pallet is being decommissioned. Everything related to NFTs will be covered by the the +[NFTs Pallet](#nfts-pallet). + +::: + Uniques is a [FRAME pallet](https://github.com/paritytech/substrate/tree/master/frame/uniques) deployed on the Statemint and Statemine system parachains. It implements the most basic kind of NFT -- a data record referencing some metadata. This metadata reference is mutable until frozen, so NFTs From d9a6b73528c13f51cb49799d1a47375600648421 Mon Sep 17 00:00:00 2001 From: Filippo Date: Tue, 14 Feb 2023 10:13:11 +0100 Subject: [PATCH 02/18] Added old Radha's corrections --- docs/learn/learn-nft-pallets.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/learn/learn-nft-pallets.md b/docs/learn/learn-nft-pallets.md index 61880c3a80f1..58ed070f4635 100644 --- a/docs/learn/learn-nft-pallets.md +++ b/docs/learn/learn-nft-pallets.md @@ -40,7 +40,7 @@ specifying different settings: :::info -Note that currently Polkadot-JS does not support bitflags. Leave the settings field as it is. +Note that currently, Polkadot-JS UI does not support bitflags. Leave the settings field as it is. Everything is unlocked by default (bitflag value `0`). ::: From 453487c0ec3c8ac63a105b60099eca0b564b211c Mon Sep 17 00:00:00 2001 From: Filippo Date: Tue, 14 Feb 2023 10:16:33 +0100 Subject: [PATCH 03/18] added info for developers --- docs/learn/learn-nft-pallets.md | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/docs/learn/learn-nft-pallets.md b/docs/learn/learn-nft-pallets.md index 58ed070f4635..19361932cb26 100644 --- a/docs/learn/learn-nft-pallets.md +++ b/docs/learn/learn-nft-pallets.md @@ -12,6 +12,13 @@ NFT-related actions within their dApp. ## NFTs Pallet +:::info For Developers Only + +The information presented here below is for developers. A user-friendly portal for NFTs, DEX and +Assets is under construction. + +::: + NFTs is a [FRAME pallet](https://polkadot.js.org/docs/substrate/extrinsics#nfts) currently deployed on Westmint, which provides a multitude of functions to interact with NFTs. From fefd0490896f1d7731153f8839c54d892e2b3e14 Mon Sep 17 00:00:00 2001 From: Filippo Date: Tue, 14 Feb 2023 10:35:16 +0100 Subject: [PATCH 04/18] Added steps to upload files --- docs/learn/learn-nft-pallets.md | 30 ++++++++++++++++++++++++++++++ 1 file changed, 30 insertions(+) diff --git a/docs/learn/learn-nft-pallets.md b/docs/learn/learn-nft-pallets.md index 19361932cb26..501e530da478 100644 --- a/docs/learn/learn-nft-pallets.md +++ b/docs/learn/learn-nft-pallets.md @@ -124,6 +124,36 @@ You can mint an NFT using the `nfts.mint` extrinsic. You must then specify the f Creating an item usually involves setting some attributes specific to that item. +### Uploading Files + +When you have a collection ID and an item ID you need to upload + +- Open an account on [Pinata](https://www.pinata.cloud/). +- Follow + [these steps](https://docs.pinata.cloud/what-can-i-learn-here/pinning-your-first-file-with-pinata) + to upload the file you want to mint. +- After uploading your file get the Content Identifier (CID). This is a unique string of letters and + numbers proving that the NFT is yours. +- Prepare the metadata file and add your CID (see below): + +``` +{ + "name":"Your Collection Name", + "description":"Collection's Description", + "image":"Your Collection CID" +} +``` + +- Upload the metadata file to Pinata and get the updated CID. +- You can add the CID when minting your NFT on the Polkadot-JS UI. + +:::info NFT/DEX/Asset Portal + +With the new NFT/DEX/Asset portal all the above steps will be executed "under-the-hood" and the user +will not have to worry about all technicalities. + +::: + ### Other Actions - Buying an item up for sale. From cafdd5bcb6466ceb825830b04717ca55042f5388 Mon Sep 17 00:00:00 2001 From: Filippo Date: Tue, 14 Feb 2023 10:47:24 +0100 Subject: [PATCH 05/18] add info mass minting --- docs/learn/learn-nft-pallets.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/docs/learn/learn-nft-pallets.md b/docs/learn/learn-nft-pallets.md index 501e530da478..3b802878fd38 100644 --- a/docs/learn/learn-nft-pallets.md +++ b/docs/learn/learn-nft-pallets.md @@ -187,6 +187,8 @@ will not have to worry about all technicalities. - Take ownership of an NFT from the [pallet-nfts](#nfts-pallet) - Create a new asset in [pallet-assets](https://polkadot.js.org/docs/substrate/extrinsics#assets) - Mint the input amount to the previous owner of the NFT as the beneficiary +- Mass minting: Minting multiple items in one single transaction. Ths will require the user to + provide a .csv file with two columns: NFT ID and CID if metadata. ## Uniques Pallet From a1df438556100ebf4c0489bb7d5a06d69b947e50 Mon Sep 17 00:00:00 2001 From: Filippo Date: Tue, 14 Feb 2023 10:49:51 +0100 Subject: [PATCH 06/18] Grammar check --- docs/learn/learn-nft-pallets.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/learn/learn-nft-pallets.md b/docs/learn/learn-nft-pallets.md index 3b802878fd38..116b938e4848 100644 --- a/docs/learn/learn-nft-pallets.md +++ b/docs/learn/learn-nft-pallets.md @@ -132,8 +132,8 @@ When you have a collection ID and an item ID you need to upload - Follow [these steps](https://docs.pinata.cloud/what-can-i-learn-here/pinning-your-first-file-with-pinata) to upload the file you want to mint. -- After uploading your file get the Content Identifier (CID). This is a unique string of letters and - numbers proving that the NFT is yours. +- After uploading your file, get the Content Identifier (CID). This is a unique string of letters + and numbers proving that the NFT is yours. - Prepare the metadata file and add your CID (see below): ``` @@ -149,8 +149,8 @@ When you have a collection ID and an item ID you need to upload :::info NFT/DEX/Asset Portal -With the new NFT/DEX/Asset portal all the above steps will be executed "under-the-hood" and the user -will not have to worry about all technicalities. +With the new NFT/DEX/Asset portal, all the above steps will be executed "under-the-hood" and the +user will not have to worry about all technicalities. ::: From deebfe2174c8c96fdeb7a906eb9c3a8b21b68782 Mon Sep 17 00:00:00 2001 From: Filippo Date: Tue, 14 Feb 2023 14:27:24 +0100 Subject: [PATCH 07/18] Added more info about metadata --- docs/learn/learn-nft-pallets.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/docs/learn/learn-nft-pallets.md b/docs/learn/learn-nft-pallets.md index 116b938e4848..22ba787d3a48 100644 --- a/docs/learn/learn-nft-pallets.md +++ b/docs/learn/learn-nft-pallets.md @@ -145,7 +145,9 @@ When you have a collection ID and an item ID you need to upload ``` - Upload the metadata file to Pinata and get the updated CID. -- You can add the CID when minting your NFT on the Polkadot-JS UI. +- You can add the CID when minting your NFT on the Polkadot-JS UI. Go to Developer > Extrinsics and + select the `nfts.setCollectionMetadata` (for collections) or `nfts.setMetadata` (for single NFTs) + extrinsic. Under the `data: Bytes` field you can enter the CID or upload the metadata file. :::info NFT/DEX/Asset Portal From 68f23e9b633dffb3978513fd96674ed92def3a2f Mon Sep 17 00:00:00 2001 From: Filippo Date: Tue, 14 Feb 2023 14:29:39 +0100 Subject: [PATCH 08/18] Minor edits --- docs/learn/learn-nft-pallets.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/learn/learn-nft-pallets.md b/docs/learn/learn-nft-pallets.md index 22ba787d3a48..d476bad202ee 100644 --- a/docs/learn/learn-nft-pallets.md +++ b/docs/learn/learn-nft-pallets.md @@ -124,7 +124,7 @@ You can mint an NFT using the `nfts.mint` extrinsic. You must then specify the f Creating an item usually involves setting some attributes specific to that item. -### Uploading Files +### Uploading Files and Metadata When you have a collection ID and an item ID you need to upload From fc2c7c0f8efbf13561825501e773b1f1b6ac774c Mon Sep 17 00:00:00 2001 From: Filippo Date: Tue, 14 Feb 2023 14:37:35 +0100 Subject: [PATCH 09/18] Added info about minting --- docs/learn/learn-nft-pallets.md | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/docs/learn/learn-nft-pallets.md b/docs/learn/learn-nft-pallets.md index d476bad202ee..427fab3f51b2 100644 --- a/docs/learn/learn-nft-pallets.md +++ b/docs/learn/learn-nft-pallets.md @@ -149,6 +149,11 @@ When you have a collection ID and an item ID you need to upload select the `nfts.setCollectionMetadata` (for collections) or `nfts.setMetadata` (for single NFTs) extrinsic. Under the `data: Bytes` field you can enter the CID or upload the metadata file. +The collection can be created and its item minted before uploading the NFT file and related +metadata. The minting process on chain will just assign a collection ID and item ID to your account. +Those IDs will be populated with NFT file, metadata, attributes later on. Once you uploaded the NFT +files and related data, the above-mentioned extrinsics can be used to update a collection or item. + :::info NFT/DEX/Asset Portal With the new NFT/DEX/Asset portal, all the above steps will be executed "under-the-hood" and the From a6e0360672d68649694b24f4b32168a05eec07a6 Mon Sep 17 00:00:00 2001 From: Filippo Date: Tue, 14 Feb 2023 14:38:28 +0100 Subject: [PATCH 10/18] grammar check on new paragraph --- docs/learn/learn-nft-pallets.md | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/docs/learn/learn-nft-pallets.md b/docs/learn/learn-nft-pallets.md index 427fab3f51b2..8b289d341f57 100644 --- a/docs/learn/learn-nft-pallets.md +++ b/docs/learn/learn-nft-pallets.md @@ -151,8 +151,9 @@ When you have a collection ID and an item ID you need to upload The collection can be created and its item minted before uploading the NFT file and related metadata. The minting process on chain will just assign a collection ID and item ID to your account. -Those IDs will be populated with NFT file, metadata, attributes later on. Once you uploaded the NFT -files and related data, the above-mentioned extrinsics can be used to update a collection or item. +Those IDs will be populated with NFT files, metadata, and attributes later on. Once you uploaded the +NFT files and related data, the above-mentioned extrinsics can be used to update a collection or +item. :::info NFT/DEX/Asset Portal From 36ed594bd0f7c1837b2f67cf1aea84b9ec680be3 Mon Sep 17 00:00:00 2001 From: Filippo Date: Tue, 14 Feb 2023 15:00:00 +0100 Subject: [PATCH 11/18] Addressed Vadim's feedback --- docs/learn/learn-nft-pallets.md | 11 ++++++----- 1 file changed, 6 insertions(+), 5 deletions(-) diff --git a/docs/learn/learn-nft-pallets.md b/docs/learn/learn-nft-pallets.md index 8b289d341f57..31bf9d29cbf0 100644 --- a/docs/learn/learn-nft-pallets.md +++ b/docs/learn/learn-nft-pallets.md @@ -133,7 +133,8 @@ When you have a collection ID and an item ID you need to upload [these steps](https://docs.pinata.cloud/what-can-i-learn-here/pinning-your-first-file-with-pinata) to upload the file you want to mint. - After uploading your file, get the Content Identifier (CID). This is a unique string of letters - and numbers proving that the NFT is yours. + and numbers that will act as a marker to link the data uploaded onto IPFS to the collection or + item ID you own. - Prepare the metadata file and add your CID (see below): ``` @@ -145,7 +146,7 @@ When you have a collection ID and an item ID you need to upload ``` - Upload the metadata file to Pinata and get the updated CID. -- You can add the CID when minting your NFT on the Polkadot-JS UI. Go to Developer > Extrinsics and +- You can add the CID after minting your NFT on the Polkadot-JS UI. Go to Developer > Extrinsics and select the `nfts.setCollectionMetadata` (for collections) or `nfts.setMetadata` (for single NFTs) extrinsic. Under the `data: Bytes` field you can enter the CID or upload the metadata file. @@ -195,14 +196,14 @@ user will not have to worry about all technicalities. - Take ownership of an NFT from the [pallet-nfts](#nfts-pallet) - Create a new asset in [pallet-assets](https://polkadot.js.org/docs/substrate/extrinsics#assets) - Mint the input amount to the previous owner of the NFT as the beneficiary -- Mass minting: Minting multiple items in one single transaction. Ths will require the user to - provide a .csv file with two columns: NFT ID and CID if metadata. +- Mass minting: Minting multiple items in one single transaction. This will require the user to + provide a .csv file with two columns: NFT ID and CID of metadata. ## Uniques Pallet :::info -The Uniques Pallet is being decommissioned. Everything related to NFTs will be covered by the the +The Uniques Pallet is deprecated. Everything related to NFTs will be covered by the the [NFTs Pallet](#nfts-pallet). ::: From b0d6eaa1327cb58525daa08c615899ba3145d374 Mon Sep 17 00:00:00 2001 From: Filippo Date: Tue, 14 Feb 2023 15:05:30 +0100 Subject: [PATCH 12/18] grammar check --- docs/learn/learn-nft-pallets.md | 7 +++---- 1 file changed, 3 insertions(+), 4 deletions(-) diff --git a/docs/learn/learn-nft-pallets.md b/docs/learn/learn-nft-pallets.md index 31bf9d29cbf0..b4ba73ab31cb 100644 --- a/docs/learn/learn-nft-pallets.md +++ b/docs/learn/learn-nft-pallets.md @@ -151,10 +151,9 @@ When you have a collection ID and an item ID you need to upload extrinsic. Under the `data: Bytes` field you can enter the CID or upload the metadata file. The collection can be created and its item minted before uploading the NFT file and related -metadata. The minting process on chain will just assign a collection ID and item ID to your account. -Those IDs will be populated with NFT files, metadata, and attributes later on. Once you uploaded the -NFT files and related data, the above-mentioned extrinsics can be used to update a collection or -item. +metadata. The minting process on chain will assign a collection and item ID to your account. Those +IDs will later be populated with NFT files, metadata, and attributes. Once you uploaded the NFT +files and related data, the above-mentioned extrinsics can be used to update a collection or item. :::info NFT/DEX/Asset Portal From d15a8207cc2f6c968a639ac4692363b334ac5240 Mon Sep 17 00:00:00 2001 From: Filippo Date: Tue, 14 Feb 2023 16:15:00 +0100 Subject: [PATCH 13/18] added link CID --- docs/learn/learn-nft-pallets.md | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/docs/learn/learn-nft-pallets.md b/docs/learn/learn-nft-pallets.md index b4ba73ab31cb..e01d83a0faa3 100644 --- a/docs/learn/learn-nft-pallets.md +++ b/docs/learn/learn-nft-pallets.md @@ -132,9 +132,10 @@ When you have a collection ID and an item ID you need to upload - Follow [these steps](https://docs.pinata.cloud/what-can-i-learn-here/pinning-your-first-file-with-pinata) to upload the file you want to mint. -- After uploading your file, get the Content Identifier (CID). This is a unique string of letters - and numbers that will act as a marker to link the data uploaded onto IPFS to the collection or - item ID you own. +- After uploading your file, get the + [Content Identifier (CID)](https://docs.ipfs.tech/concepts/content-addressing/#what-is-a-cid). + This is a unique string of letters and numbers that will act as a marker to link the data uploaded + onto IPFS to the collection or item ID you own. - Prepare the metadata file and add your CID (see below): ``` From 63e4e30fc09b34ee0dcd77b7e74b2a6f4f10e02e Mon Sep 17 00:00:00 2001 From: Filippo Date: Tue, 14 Feb 2023 16:15:50 +0100 Subject: [PATCH 14/18] added link to IPFS --- docs/learn/learn-nft-pallets.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/learn/learn-nft-pallets.md b/docs/learn/learn-nft-pallets.md index e01d83a0faa3..be708ff02762 100644 --- a/docs/learn/learn-nft-pallets.md +++ b/docs/learn/learn-nft-pallets.md @@ -135,7 +135,7 @@ When you have a collection ID and an item ID you need to upload - After uploading your file, get the [Content Identifier (CID)](https://docs.ipfs.tech/concepts/content-addressing/#what-is-a-cid). This is a unique string of letters and numbers that will act as a marker to link the data uploaded - onto IPFS to the collection or item ID you own. + onto [IPFS](https://ipfs.tech/#how) to the collection or item ID you own. - Prepare the metadata file and add your CID (see below): ``` From 5e02fe5e2f23dd27e7b2addf0330322dbb7c919c Mon Sep 17 00:00:00 2001 From: Filippo <110459737+filippoweb3@users.noreply.github.com> Date: Wed, 15 Feb 2023 14:00:37 +0100 Subject: [PATCH 15/18] Update docs/learn/learn-nft-pallets.md Co-authored-by: Radha <86818441+DrW3RK@users.noreply.github.com> --- docs/learn/learn-nft-pallets.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/learn/learn-nft-pallets.md b/docs/learn/learn-nft-pallets.md index be708ff02762..02e7f4326113 100644 --- a/docs/learn/learn-nft-pallets.md +++ b/docs/learn/learn-nft-pallets.md @@ -126,7 +126,7 @@ Creating an item usually involves setting some attributes specific to that item. ### Uploading Files and Metadata -When you have a collection ID and an item ID you need to upload +When you have a collection ID and an item ID you need to - Open an account on [Pinata](https://www.pinata.cloud/). - Follow From e8e91bb822e7b70302229e8f15234e7e95e10757 Mon Sep 17 00:00:00 2001 From: Filippo <110459737+filippoweb3@users.noreply.github.com> Date: Wed, 15 Feb 2023 14:00:47 +0100 Subject: [PATCH 16/18] Update docs/learn/learn-nft-pallets.md Co-authored-by: Radha <86818441+DrW3RK@users.noreply.github.com> --- docs/learn/learn-nft-pallets.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/learn/learn-nft-pallets.md b/docs/learn/learn-nft-pallets.md index 02e7f4326113..8b2955741153 100644 --- a/docs/learn/learn-nft-pallets.md +++ b/docs/learn/learn-nft-pallets.md @@ -152,9 +152,9 @@ When you have a collection ID and an item ID you need to extrinsic. Under the `data: Bytes` field you can enter the CID or upload the metadata file. The collection can be created and its item minted before uploading the NFT file and related -metadata. The minting process on chain will assign a collection and item ID to your account. Those -IDs will later be populated with NFT files, metadata, and attributes. Once you uploaded the NFT -files and related data, the above-mentioned extrinsics can be used to update a collection or item. +metadata. The minting process on-chain will assign a collection and item ID to your account. Those +IDs will later be populated with NFT files, metadata, and attributes. Once you upload the NFT +files and related data, the extrinsics mentioned above can be used to update a collection or item. :::info NFT/DEX/Asset Portal From 26dfafd3a55e61da8412d9a90e05fd89917c726f Mon Sep 17 00:00:00 2001 From: Filippo <110459737+filippoweb3@users.noreply.github.com> Date: Wed, 15 Feb 2023 14:00:54 +0100 Subject: [PATCH 17/18] Update docs/learn/learn-nft-pallets.md Co-authored-by: Radha <86818441+DrW3RK@users.noreply.github.com> --- docs/learn/learn-nft-pallets.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/learn/learn-nft-pallets.md b/docs/learn/learn-nft-pallets.md index 8b2955741153..7f472f394b4b 100644 --- a/docs/learn/learn-nft-pallets.md +++ b/docs/learn/learn-nft-pallets.md @@ -158,7 +158,7 @@ files and related data, the extrinsics mentioned above can be used to update a c :::info NFT/DEX/Asset Portal -With the new NFT/DEX/Asset portal, all the above steps will be executed "under-the-hood" and the +With the new NFT/DEX/Asset portal, all the above steps will be executed "under the hood" and the user will not have to worry about all technicalities. ::: From 48144754ed9e60de420d9423194034b50f531490 Mon Sep 17 00:00:00 2001 From: Filippo Date: Wed, 15 Feb 2023 14:04:53 +0100 Subject: [PATCH 18/18] tiny edit, run grammarly --- docs/learn/learn-nft-pallets.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/learn/learn-nft-pallets.md b/docs/learn/learn-nft-pallets.md index 7f472f394b4b..cac6414ff0f7 100644 --- a/docs/learn/learn-nft-pallets.md +++ b/docs/learn/learn-nft-pallets.md @@ -126,7 +126,7 @@ Creating an item usually involves setting some attributes specific to that item. ### Uploading Files and Metadata -When you have a collection ID and an item ID you need to +When you have a collection ID and an item ID you need to: - Open an account on [Pinata](https://www.pinata.cloud/). - Follow @@ -153,8 +153,8 @@ When you have a collection ID and an item ID you need to The collection can be created and its item minted before uploading the NFT file and related metadata. The minting process on-chain will assign a collection and item ID to your account. Those -IDs will later be populated with NFT files, metadata, and attributes. Once you upload the NFT -files and related data, the extrinsics mentioned above can be used to update a collection or item. +IDs will later be populated with NFT files, metadata, and attributes. Once you upload the NFT files +and related data, the extrinsics mentioned above can be used to update a collection or item. :::info NFT/DEX/Asset Portal