The NFTTX Service (token/services/nfttx) provides specialized support for Non-Fungible Tokens (NFTs). It extends the core token transaction capabilities to handle the unique properties and lifecycle requirements of NFTs, such as guaranteed uniqueness and rich metadata handling.
The NFTTX Service is responsible for:
The NFTTX Service is an Application Service that leverages the core Token API and other infrastructure services.
graph TD
User[Application Developer] --> NFTTX[NFTTX Service]
subgraph "NFT Capabilities"
Issue[Issue Unique NFT]
Transfer[Transfer NFT Ownership]
Query[Query NFT State]
end
NFTTX --> Issue
NFTTX --> Transfer
NFTTX --> Query
Issue --> Tokens[Tokens Service]
Transfer --> TTX[TTX Service]
Query --> TokenDB[Token Store - TokenDB]
Unlike fungible tokens, each NFT must be unique. The NFTTX Service often utilizes a specific UniqueID attribute in the token request. The service ensures that this identifier is correctly generated (e.g., using a UUID or a content-based hash) and validated by the token driver to prevent duplicates on the ledger.
NFTs often carry extensive metadata (e.g., links to digital artwork, serial numbers, or physical asset descriptions). The NFTTX Service provides standardized ways to include this metadata in the token request’s metadata fields, ensuring it is properly signed and (if required by the driver) obfuscated on the ledger.
An NFT keeps its state in the token’s type field, as base64. OutputStream.StateAt
decodes it into a value you pass in:
house := &House{}
if err := outputs.StateAt(0, house); err != nil {
return errors.Wrap(err, "failed to get house state")
}
Always check the error. StateAt returns one when:
index is outside the stream,On an error the passed value is useless: it is left empty or half-filled. On success it has really been written to.
To read an NFT already in a wallet, use OwnerWallet.QueryByKey. It finds the NFT by a
field of its state and decodes it the same way. It returns ErrNoResults if nothing
matches.
The service integrates with the Identity Service to manage specialized NFT wallets. These wallets are optimized for tracking ownership of distinct assets rather than aggregate balances, making it easy for applications to display a user’s collection of NFTs.