Files
pezkuwi-subxt/substrate/frame/uniques
Dcompoze 002d9260f9 Fix spelling mistakes across the whole repository (#3808)
**Update:** Pushed additional changes based on the review comments.

**This pull request fixes various spelling mistakes in this
repository.**

Most of the changes are contained in the first **3** commits:

- `Fix spelling mistakes in comments and docs`

- `Fix spelling mistakes in test names`

- `Fix spelling mistakes in error messages, panic messages, logs and
tracing`

Other source code spelling mistakes are separated into individual
commits for easier reviewing:

- `Fix the spelling of 'authority'`

- `Fix the spelling of 'REASONABLE_HEADERS_IN_JUSTIFICATION_ANCESTRY'`

- `Fix the spelling of 'prev_enqueud_messages'`

- `Fix the spelling of 'endpoint'`

- `Fix the spelling of 'children'`

- `Fix the spelling of 'PenpalSiblingSovereignAccount'`

- `Fix the spelling of 'PenpalSudoAccount'`

- `Fix the spelling of 'insufficient'`

- `Fix the spelling of 'PalletXcmExtrinsicsBenchmark'`

- `Fix the spelling of 'subtracted'`

- `Fix the spelling of 'CandidatePendingAvailability'`

- `Fix the spelling of 'exclusive'`

- `Fix the spelling of 'until'`

- `Fix the spelling of 'discriminator'`

- `Fix the spelling of 'nonexistent'`

- `Fix the spelling of 'subsystem'`

- `Fix the spelling of 'indices'`

- `Fix the spelling of 'committed'`

- `Fix the spelling of 'topology'`

- `Fix the spelling of 'response'`

- `Fix the spelling of 'beneficiary'`

- `Fix the spelling of 'formatted'`

- `Fix the spelling of 'UNKNOWN_PROOF_REQUEST'`

- `Fix the spelling of 'succeeded'`

- `Fix the spelling of 'reopened'`

- `Fix the spelling of 'proposer'`

- `Fix the spelling of 'InstantiationNonce'`

- `Fix the spelling of 'depositor'`

- `Fix the spelling of 'expiration'`

- `Fix the spelling of 'phantom'`

- `Fix the spelling of 'AggregatedKeyValue'`

- `Fix the spelling of 'randomness'`

- `Fix the spelling of 'defendant'`

- `Fix the spelling of 'AquaticMammal'`

- `Fix the spelling of 'transactions'`

- `Fix the spelling of 'PassingTracingSubscriber'`

- `Fix the spelling of 'TxSignaturePayload'`

- `Fix the spelling of 'versioning'`

- `Fix the spelling of 'descendant'`

- `Fix the spelling of 'overridden'`

- `Fix the spelling of 'network'`

Let me know if this structure is adequate.

**Note:** The usage of the words `Merkle`, `Merkelize`, `Merklization`,
`Merkelization`, `Merkleization`, is somewhat inconsistent but I left it
as it is.

~~**Note:** In some places the term `Receival` is used to refer to
message reception, IMO `Reception` is the correct word here, but I left
it as it is.~~

~~**Note:** In some places the term `Overlayed` is used instead of the
more acceptable version `Overlaid` but I also left it as it is.~~

~~**Note:** In some places the term `Applyable` is used instead of the
correct version `Applicable` but I also left it as it is.~~

**Note:** Some usage of British vs American english e.g. `judgement` vs
`judgment`, `initialise` vs `initialize`, `optimise` vs `optimize` etc.
are both present in different places, but I suppose that's
understandable given the number of contributors.

~~**Note:** There is a spelling mistake in `.github/CODEOWNERS` but it
triggers errors in CI when I make changes to it, so I left it as it
is.~~
2024-03-26 13:57:57 +00:00
..
2023-09-04 12:02:32 +03:00

Uniques Module

A simple, secure module for dealing with non-fungible assets.

Overview

The Uniques module provides functionality for non-fungible tokens' management, including:

  • Collection Creation
  • Item Minting
  • Item Transfers
  • Item Trading methods
  • Attributes Management
  • Item Burning

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

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

Terminology

  • Collection creation: The creation of a new collection.
  • Item minting: The action of creating a new item within a collection.
  • Item transfer: The action of sending an item from one account to another.
  • Item 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.

Goals

The Uniques 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 unique 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.

Interface

Permissionless dispatchables

  • create: Create a new collection by placing a deposit.
  • transfer: Transfer an item to a new owner.
  • redeposit: Update the deposit amount of an item, potentially freeing funds.
  • approve_transfer: Name a delegate who may authorise a transfer.
  • cancel_approval: Revert the effects of a previous approve_transfer.

Permissioned dispatchables

  • destroy: Destroy a collection.
  • mint: Mint a new item within a collection.
  • burn: Burn an item within a collection.
  • freeze: Prevent an individual item from being transferred.
  • thaw: Revert the effects of a previous freeze.
  • freeze_collection: Prevent all items within a collection from being transferred.
  • thaw_collection: Revert the effects of a previous freeze_collection.
  • transfer_ownership: Alter the owner of a collection, moving all associated deposits.
  • set_team: Alter the permissioned accounts of a collection.

Metadata (permissioned) dispatchables

  • set_attribute: Set an attribute of an item or collection.
  • clear_attribute: Remove an attribute of an item or collection.
  • set_metadata: Set general metadata of an item.
  • 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.
  • force_asset_status: Alter the underlying characteristics of a collection.

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

License: Apache-2.0