NFT Standards on Sui by TradePort

Oleg AgafonovOleg Agafonov
Oct 7, 2024|2 min read

Collection Contract Structure

Among the many ways to deploy and trade NFTs on Sui, the best for creator control and usability is the kiosk standard. In short, kiosks are on chain objects that can hold other objects. Kiosks give creators the ability to define requirements when transferring an asset in the NFT type’s TransferPolicy. This creates a safer, more reliable trading process and allows creators to enforce royalties on the NFT level.

NOTE: In this doc, kiosk refers to native Sui kiosks, not to be confused with Origin Byte kiosks. The Origin Byte standard has been deprecated in favor of native kiosks. For reliable trading, creators must use kiosks as described here.

For items to be tradable on TradePort, the following is required:

  • All items MUST be placed into a kiosk.
  • Each kiosk MUST be a shared object. Shared kiosks will have a “shared” flag on an explorer-like Suiscan or SuiVision.
  • Each NFT type MUST have a defined transfer policy.

Within a transfer policy, creators can define the rule by which the policy is used.

  • To ensure permanent tradability, creators MUST define a kiosk_lock_rule. This rule prevents users or marketplaces from removing items from the kiosk which could break trading across a collection.
  • If the creator wishes to enforce royalties, a royalty_rule must be implemented.

To learn more about Sui kiosks, transfer policies, and their implementation, please consult Mysten Lab’s documentation here.

Metadata Requirements

NFTs on Sui have a number of ways to store on-chain data but for an NFT to display correctly on TradePort, all required data but be correctly formatted in the NFT object’s fields.

The Basics

Each object must have the following fields:

  • name field - the name of the individual NFT.
  • image_url - the URL, preferably an IPFS URI, pointing to the NFT’s media file.  All standard image and video formats are supported on TradePort.  If you are unsure about your file format, reach out to the team in Discord before launching your collection.
  • description - the description of the collection.

Attributes

Non-unique and excessive metadata is often stored in the NFT fields. This prevents us from using unknown fields as a reliable source for attributes.  So, all other NFT properties that the creator needs to appear on TradePort MUST be added to the attributes  field on the NFT in one of the following formats:


Join Us on this Exciting Journey

We're excited for you to explore the new possibilities offered by our expansion to Base. Whether you're an avid collector, a passionate creator, or a developer aiming to build the next big thing in NFTs, TradePort is your gateway to endless opportunities.

Get Started Today

Start your TradePort experience by signing up for the Indexer Notification System! Connect one or multiple wallets to receive vital updates about your NFTs, including notifications when NFTs in your wallet sell or receive a bid. Say goodbye to constantly checking the marketplace—these important alerts will be delivered straight to your Discord DMs. Register now using the link below: https://www.tradeport.xyz/discord-bots/alerts/subscribe.