module_nft
nft module
nft moduleIntroduction
NFT provides the ability to digitize assets. The NFT Module described here is meant to be used as a module across chains for managing non-fungible token that represents individual assets with unique features. This standard was developed on Ethereum within the ERC-721 and the subsequent ERC-1155 standard addressed some of the restrictions of Ethereum regarding storage costs and semi-fungible assets. The NFT on the chain is identified by an ID, and the transaction process will also be publicly recorded. NFT metadata is based on a specific JSON schema - it can be stored directly on the chain or the URI of its storage source outside the chain can be stored on the chain.
Fungible tokens are mutually interchangeable, and one most common example of fungible tokens is fiat currencies. Specifically, the $100.50 US dollars in my bank account is equally valuable as the $100.50 US dollars in someone else's bank account. Another example of fungible tokens would be the native cryptocurrency of Ethereum, one of the most popular blockchain networks, i.e. Ether. Ethers are totally fungible, meaning that one ether is equal to one ether, and it's equal to any other ether as well. Particularly, ethers are also highly divisible up to one wei, or 0.000000000000000001 (10-18) ether.
In contrast, non-fungible tokens (NFTs) are special tokens that are unique in the sense that they cannot be split or equally interchanged for other NFTs of the same type. CryptoKitties on Ethereum or Loaded Lions on Cronos POS Chain are both examples of NFTs: each CryptoKitty or Loaded Lion is unique and non-divisible, unlike Bitcoin. Generally speaking, NFTs are unique, non-interchangeable, and non-divisible.
On-chain NFT standards were first developed on Ethereum within the ERC-721 standard and its subsequent Ethereum Improvement Proposals. The subsequent ERC-1155 standard aims to address some restrictions of Ethereum such as storage costs and semi-fungible assets. NFTs on application specific blockchains share some but not all features as their Ethereum brethren, since application specific blockchains are more flexible in how their resources are utilized, such as the ability to use strings as IDs.
The nft module here facilitates managing non-fungible tokens that represent individual assets with unique features on Cronos POS Chain.
You can find the NFT specification doc here.
Overview
Below are key concepts and properties for NFTs on Cronos POS Chain:
Denom
A denom represents a collection of NFTs. It is the globally unique nft category name. Denom ID is the globally unique nft category identifier of Denom. For example, I could issue a denom named "CryptoPuppies" under which my collection of 100 CryptoPuppies NFTs get minted. Each denom has a
denom IDand adenom name, both are unique on chain. Adenom schemashould generally be set when a denom gets issued, which indicates the format of NFT metadata under this denom.Token
An NFT, or simply "token", is a specific instance of NFT minted under a denom. Each token has a
token ID, which is unique under a specific denom. Generally, a token also has itstoken name(name of the NFT),token URI(off-chain information or storage location of the NFT), andtoken metadata(on-chain data that provides information about the NFT).Metadata
The structure containing the specific data of the nft
Metadata Specification
The JSON Schema that nft metadata should follow
Metadata URI
The URI indicates its storage location when metadata is stored off-chain
::: tip Specifications denom ID: a string of lowercase alphanumeric characters with length between 3 and 64 that begins with a letter, unique over the chain;
denom name: a non-empty string, unique over the chain;
denom schema: a JSON metadata format for NFTs under this denom;
token ID: a string that is unique under the denom;
token name: a string;
token URI: a string that directs to the off-chain information or storage location of the NFT;
token metadata: a JSON object that matches the denom schema and represents the on-chain data that provides information about the NFT. :::
Just as each user is uniquely identified by its address, each NFT is uniquely identified by the combination of its denom ID and its token ID (like a UID for the NFT), showing its uniqueness, non-interchangeability, and non-divisibility.
Transactions and Queries
Transactions
In general,
any user may
issuea denom as long as neither the denom ID nor the denom name has been taken;the creator of a denom, also know as the owner of the denom, is the only user who may
mintan NFT under such denom;a user may
editorburnan NFT only if he/she is both the creator and the owner of that NFT;a user may
transferan NFT as long as he/she is the owner of that NFT.
issue:
issue:Every NFT needs to "live" under a denom: an NFT collection. Therefore, the first step is to issue a denom before one can mint NFTs:
tx nft issue [denom_id] --name [denom_name] --schema [denom_schema] --from [user_address]- Issue a denom
Example: Issue a new denom with specified name and schema
NOTE Even though the denom schema is not a compulsory field, it is generally recommended to illustrate the format of NFT metadata as an informative summary of such denom. Moreover, a denom is non-transferable, non-editable, and non-deletable, so be mindful when issuing a denom.
mint:
mint:The specific nft of this type can be created after the nft is issued. The denom ID, token ID, recipient address and URI need to be specified.
tx nft mint [denom_id] [token_id] --name [token_name] --uri [token_uri] --data [token_metadata] --recipient [recipient_address] --from [user_address]- Mint an NFT
Example: Mint an NFT with specified name, URI, data, and recipient
NOTE The token name, URI, and metadata fields are optional but highly recommended fields during the minting process, even though they might also be edited later through edit. In addition, the minter may specify a recipient of the new NFT, where it defaults to be just the minter if not specified.
edit:
edit:Unlike NFTs minted on Ethereum, an NFT minted on Cronos POS Chain may easily be edited, provided that the user editing it is both the owner and creator of such NFT.
tx nft edit [denom_id] [token_id] --name [new_name] --uri [new_uri] --data [new_metadata] --from [user_address]- Edit an NFT
Example: Edit an NFT to change its URI
NOTE There are 3 fields available for NFT editing: name, URI, and the metadata. Any field that is not specified will remain unchanged.
burn:
burn:A user may burn an existing NFT as long as he/she is both the owner and creator of such NFT, similar to editing the NFT.
tx nft burn [denom_id] [token_id] --from [user_address]- Burn an NFT
Example: Burn an NFT
NOTE A token ID is unique under a specific denom, meaning no two existing NFTs can share the same token ID under the same denom. However, when an NFT gets burnt, its token ID is freed and is available for mint again.
transfer:
transfer:Transferring an NFT is easy: one only needs to be the owner of the NFT.
tx nft transfer [recipient_address] [denom_id] [token_id] --from [granter_address] - Transfer an NFT
Example: Transfer an NFT to a recipient
Queries
In the NFT module, queries can be divided into 3 main categories:
denom information;
token information;
owner information.
query denom information:
query nft denom [denom_id] - Query information of a denom by its denom ID
Example: Query information of a denom by its denom ID
Effectively, one may also query information of a denom by its denom name instead of denom id:
query nft denom-by-name [denom_name] - Query information of a denom by its denom name
To check the number of existing NFTs in a denom:
query nft supply [denom_id] - Query the number of existing NFTs in a denom
Example: Query the number of existing NFTs in a denom
In addition, one may query the number of existing NFTs in a denom of a specific owner through the --owner flag:
query nft supply [denom_id] --owner [owner_address] - Query the number of existing NFTs in a denom of a specific owner
Example: Query the number of existing NFTs in a denom of a specific owner
query token information:
One may query information of a specific NFT with its UID (denom ID and token ID):
query nft token [denom_id] [token_id] - Query information of an NFT
Example: Query information of an NFT
One may also query information of all NFTs under a specific denom:
query nft collection [denom_id] - Query information of all NFTs under a specific denom
Example: Query information of all NFTs under a specific denom
query owner information:
Last but not least, information about a specific NFT owner may also be queried.
query nft owner [owner_address] - Query information of all NFTs owned by a specific owner
Example: Query information of all NFTs owned by a specific owner
One may also use the --denom-id flag to query owner NFT information under a specific denom:
query nft owner [owner_address] --denom-id [denom_id] - Query information of all NFTs owned by a specific owner under specified denom
Example: Query information of all NFTs owned by a specific owner under specified denom
Last updated