Files
pezkuwi-subxt/substrate/frame/nfts
Gilt0 b78c72cf9c [FRAME Core] remove unnecessary overrides while using derive_impl for frame_system (#3317)
# Description

This PR removes redundant type definition from test definition config
implementations like
```
#[derive_impl(frame_system::config_preludes::TestDefaultConfig as frame_system::DefaultConfig)]
impl frame_system::Config for Test {
    type A = A;
    ...
}
```

This changes avoid redundancies in the code as the macro `derive_impl`
defines the relevant types. To implement the changes, it was a simple
fact of running tests and making sure that the tests would still run
while the definition would be removed.

Closes #3237

As a note, here is a brief account of things done from the Issue's
description statement
```
alliance migrate alliance, fast-unstake and bags list to use derive-impl #1636
asset-conversion                                                                                            DONE
asset-rate                                                                                                  DONE
assets                                                                                                      DONE
atomic-swap                                                                                                 DONE
aura                                                                                                        DONE
authority-discovery                                                                                         DONE                                                                     
authorship  migrate babe and authorship to use derive-impl #1790
babe  migrate babe and authorship to use derive-impl #1790
bags-list migrate alliance, fast-unstake and bags list to use derive-impl #1636
balances                                                                                                    DONE
beefy                                                                                                       NOTHING TO DO --- also noted this error without failing tests Feb 13 13:49:08.941 ERROR runtime::timestamp: `pallet_timestamp::UnixTime::now` is called at genesis, invalid value returned: 0
beefy-mmr                                                                                                   NOTHING TO DO
bounties                                                                                                    DONE
child-bounties                                                                                              DONE
collective                                                                                                  DONE
contracts                                                                                                   DONE
conviction-voting                                                                                           DONE
core-fellowship                                                                                             NOTHING TO DO
democracy                                                                                                   DONE
election-provider-multi-phase                                                                               NOTHING TO DO
elections-phragmen                                                                                          DONE
executive                                                                                                   NOTHING TO DO
fast-unstake migrate alliance, fast-unstake and bags list to use derive-impl #1636
glutton                                                                                                     DONE
grandpa                                                                                                     DONE
identity                                                                                                    DONE
im-online                                                                                                   NOTHING TO DO
indices Refactor indices pallet #1789
insecure-randomness-collective-flip                                                                         DONE
lottery                                                                                                     DONE
membership                                                                                                  DONE
merkle-mountain-range                                                                                       NOTHING TO DO
message-queue                                                                                               DONE
multisig add frame_system::DefaultConfig to individual pallet DefaultConfigs substrate#14453
nft-fractionalization                                                                                       DONE
nfts                                                                                                        DONE
nicks Refactor pallet-state-trie-migration to fungible::* traits #1801                                      NOT IN REPO
nis                                                                                                         DONE
node-authorization                                                                                          DONE
nomination-pools                                                                                            NOTHING TO DO -- ONLY impl for Runtime
offences                                                                                                    DELETED EVERYTHING -- IS THAT CORRECT??
preimage                                                                                                    DONE
proxy add frame_system::DefaultConfig to individual pallet DefaultConfigs substrate#14453
ranked-collective                                                                                           NOTHING TO DO
recovery                                                                                                    DONE
referenda                                                                                                   DONE
remark                                                                                                      DONE
root-offences                                                                                               DONE
root-testing                                                                                                NOTHING TO DO
salary                                                                                                      NOTHING TO DO
scheduler                                                                                                   DONE
scored-pool                                                                                                 DONE
session                                                                                                     DONE -- substrate/frame/session/benchmarking/src/mock.rs untouched
society                                                                                                     NOTHING TO DO
staking                                                                                                     DONE
staking-bags-benchmarks                                                                                     NOT IN REPO
state-trie-migration                                                                                        NOTHING TO DO
statement                                                                                                   DONE
sudo                                                                                                        DONE
system                                                                                                      DONE
timestamp                                                                                                   DONE
tips                                                                                                        DONE
transaction-payment                                                                                         NOTHING TO DO
transaction-storage                                                                                         NOTHING TO DO
treasury                                                                                                    DONE
try-runtime                                                                                                 NOTHING TO DO -- no specific mention of 'for Test'
uniques                                                                                                     DONE
utility                                                                                                     DONE
vesting                                                                                                     DONE
whitelist                                                                                                   DONE
```

---------

Co-authored-by: command-bot <>
Co-authored-by: gupnik <nikhilgupta.iitk@gmail.com>
2024-02-19 12:07:10 +00:00
..
2023-09-04 12:02:32 +03:00

NFTs pallet

A pallet for dealing with non-fungible assets.

Overview

The NFTs pallet provides functionality for non-fungible tokens' management, including:

  • Collection Creation
  • NFT Minting
  • NFT Transfers and Atomic Swaps
  • NFT Trading methods
  • Attributes Management
  • NFT Burning

To use it in your runtime, you need to implement nfts::Config.

The supported dispatchable functions are documented in the nfts::Call enum.

Terminology

  • Collection creation: The creation of a new collection.
  • NFT minting: The action of creating a new item within a collection.
  • NFT transfer: The action of sending an item from one account to another.
  • Atomic swap: The action of exchanging items between accounts without needing a 3rd party service.
  • NFT burning: The destruction of an item.
  • Non-fungible token (NFT): An item for which each unit has unique characteristics. There is exactly one instance of such an item in existence and there is exactly one owning account (though that owning account could be a proxy account or multi-sig account).
  • Soul Bound NFT: An item that is non-transferable from the account which it is minted into.

Goals

The NFTs pallet in Substrate is designed to make the following possible:

  • Allow accounts to permissionlessly create nft collections.
  • Allow a named (permissioned) account to mint and burn unique items within a collection.
  • Move items between accounts permissionlessly.
  • Allow a named (permissioned) account to freeze and unfreeze items within a collection or the entire collection.
  • Allow the owner of an item to delegate the ability to transfer the item to some named third-party.
  • Allow third-parties to store information in an NFT without owning it (Eg. save game state).

Interface

Permissionless dispatchables

  • create: Create a new collection by placing a deposit.
  • mint: Mint a new item within a collection (when the minting is public).
  • transfer: Send an item to a new owner.
  • redeposit: Update the deposit amount of an item, potentially freeing funds.
  • approve_transfer: Name a delegate who may authorize a transfer.
  • cancel_approval: Revert the effects of a previous approve_transfer.
  • approve_item_attributes: Name a delegate who may change item's attributes within a namespace.
  • cancel_item_attributes_approval: Revert the effects of a previous approve_item_attributes.
  • set_price: Set the price for an item.
  • buy_item: Buy an item.
  • pay_tips: Pay tips, could be used for paying the creator royalties.
  • create_swap: Create an offer to swap an NFT for another NFT and optionally some fungibles.
  • cancel_swap: Cancel previously created swap offer.
  • claim_swap: Swap items in an atomic way.

Permissioned dispatchables

  • destroy: Destroy a collection. This destroys all the items inside the collection and refunds the deposit.
  • force_mint: Mint a new item within a collection.
  • burn: Destroy an item within a collection.
  • lock_item_transfer: Prevent an individual item from being transferred.
  • unlock_item_transfer: Revert the effects of a previous lock_item_transfer.
  • clear_all_transfer_approvals: Clears all transfer approvals set by calling the approve_transfer.
  • lock_collection: Prevent all items within a collection from being transferred (making them all soul bound).
  • lock_item_properties: Lock item's metadata or attributes.
  • transfer_ownership: Alter the owner of a collection, moving all associated deposits. (Ownership of individual items will not be affected.)
  • set_team: Alter the permissioned accounts of a collection.
  • set_collection_max_supply: Change the max supply of a collection.
  • update_mint_settings: Update the minting settings for collection.

Metadata (permissioned) dispatchables

  • set_attribute: Set a metadata attribute of an item or collection.
  • clear_attribute: Remove a metadata attribute of an item or collection.
  • set_metadata: Set general metadata of an item (E.g. an IPFS address of an image url).
  • clear_metadata: Remove general metadata of an item.
  • set_collection_metadata: Set general metadata of a collection.
  • clear_collection_metadata: Remove general metadata of a collection.

Force (i.e. governance) dispatchables

  • force_create: Create a new collection (the collection id can not be chosen).
  • force_collection_owner: Change collection's owner.
  • force_collection_config: Change collection's config.
  • force_set_attribute: Set an attribute.

Please refer to the Call enum and its associated variants for documentation on each function.

License: Apache-2.0