token-standards_skill

Overview

This skill is an expert reference for Aptos token standards covering fungible tokens (Coin, Fungible Asset) and NFTs (Digital Asset / Token V2). It explains creation, minting, burning, transfers, collections, metadata, royalties, and recommended patterns for production systems. It targets developers building on Aptos who need practical, production-ready guidance.

How this skill works

The skill inspects and explains core Move primitives and Aptos framework modules used to implement tokens: coin, fungible_asset, aptos_token_objects, collection, token, property_map, royalty, and object transfer refs. It summarizes code patterns for initializing modules, generating and storing capability refs, minting/burning, registering accounts, and managing metadata and royalties. It also contrasts legacy Token V1 with current Digital Asset (Token V2) and highlights when to choose Coin vs Fungible Asset.

When to use it

• Start new NFT projects with Digital Asset (Token V2) for composability and metadata features.
• Use Coin framework for simple fungible tokens like APT or straightforward ERC20-like tokens.
• Use Fungible Asset when you need advanced controls: freeze, transfer refs, or configurable supply.
• Implement royalties via the royalty helper when secondary-sale fees are required.
• Prefer object-model tokens when you need on-chain mutable properties or composable assets.

Best practices

• Store mint/burn/transfer capability refs securely inside module-hosted resources.
• Validate metadata and typed properties before minting to avoid immutable mistakes.
• Prefer Digital Asset for new NFTs; avoid Token V1 except for legacy compatibility.
• Design upgrade or migration patterns early; include tests for supply and permission flows.
• Test on devnet/testnet with full lifecycle: create, mint, transfer, freeze, burn, and royalty settlement.

Example use cases

• Create a utility token with Coin for in-platform payments and simple balances.
• Launch a game NFT collection with Digital Asset, using property_map for level and rarity upgrades.
• Issue a capped fungible asset with Fungible Asset for tokenized in-game currency that supports freezes.
• Mint collectibles with per-collection royalties to enforce creator fees on secondary markets.
• Implement soul-bound or composable assets using Token V2 object patterns.