Skip to content

NFT & Blockchain

Overview

MyGallery lets collectors register their artworks as blockchain tokens — a process commonly known as minting. Minting creates an on-chain record of the artwork that acts as a tamper-proof proof of ownership, complementing the card's provenance history on the platform. Each minted artwork is represented by a unique token linked to its card. Users interact with the blockchain through wallets: a wallet is a blockchain address that holds tokens on the user's behalf. The platform can hold a wallet on behalf of the user, or a token can be transferred to an external wallet the user controls directly.


Wallets

FieldWhat it represents
NameA label for the wallet
AddressThe blockchain address of the wallet

Blockchain Transactions

Every minting or transfer operation produces a blockchain transaction record that tracks the outcome of the operation.

FieldWhat it represents
Card / TransferThe card or transfer this operation relates to
Transaction IDThe identifier assigned by the blockchain
Token IDThe unique token number for the minted artwork
TypeWhether this is a minting operation or a transfer
StatusThe outcome of the operation
MessageAn error description if the operation failed

Relations


Business Rules

Wallets:

  1. A user can create a wallet on the blockchain from within the platform. The platform registers the wallet and stores its address.
  2. A user can delete their wallet. Deleting a wallet removes it from the blockchain and from the platform.

Minting:

  1. A card owner can mint their card as a blockchain token. The card's contract type — physical or digital — determines which type of token is created on the blockchain.
  2. When minting is initiated, a blockchain transaction record is created with a Pending status.
  3. On a successful response from the blockchain, the transaction is marked Accepted and the card's NFT active flag is set. The card type changes to NFT.
  4. If the blockchain operation fails, the transaction is marked Rejected and an error message is recorded.
  5. Minting a card captures the artist name, card description, and artwork image as the token's on-chain metadata.

NFT Transfer:

  1. An NFT can be transferred in two ways: to another MyGallery user (an internal transfer) or to an external wallet address the user provides directly.
  2. NFT transfers are tracked as blockchain transaction records, following the same Pending → Accepted / Rejected lifecycle as minting.
  3. When a card is transferred to another user on the platform, any associated NFT is transferred to the recipient's wallet as part of the same operation.

States

StateWhat it means
PendingThe operation has been sent to the blockchain and is awaiting confirmation
AcceptedThe blockchain confirmed the operation successfully
RejectedThe blockchain operation failed; an error message is recorded

Constraints

  • A wallet must have a name and a valid blockchain address.
  • A minting operation requires a valid card and a contract type (physical or digital).
  • An NFT transfer to an external address requires the user to supply the destination wallet address.