CW721

Overview

Meaning and scope

CW721 is a CosmWasm contract interface standard for non-fungible tokens, defining ownership, transfer, approval, metadata, and query behavior. Each NFT collection is identified by its chain and contract address. Token IDs are meaningful within that contract, while metadata can be stored directly or referenced externally. Optional extensions mean two CW721-compatible contracts can expose different administrative and metadata behavior.

Mechanism and operation

It defines messages and queries for token ownership, transfers, sends to contracts, operator approvals, token metadata, enumeration, and optional minting or extension fields. Wallets and marketplaces should verify collection contracts, current owner, approvals, transfer hooks, and metadata sources. Receiving contracts must authenticate the sending CW721 contract and token ID. Conformance to CW721 requires more than matching a field name or example. Teams adopting CW721 should track errata, compatibility changes, and the deployed software versions that enforce it. CW721 should be implemented against an exact document revision, status, and activation context. Practical implication: CW721 standardizes CosmWasm NFT interactions, but contract identity, extensions, ownership, approvals, and metadata still require verification.

Practical payment example

A digital-ticket service uses a CW721 contract to issue unique ticket tokens. At admission, it verifies the token ID and current owner against the approved collection contract instead of checking a payment amount alone.

Operational checks

For a CW721 collection, validate the expected contract and exact token identifier, then check the resulting ownership or transfer state. Track contract permissions and approval behavior separately from the purchase invoice. Treat marketplace metadata as supporting information, not an alternative to contract state.

Distinctions and limits

Displayed images or names do not prove provenance, rights, or permanence without additional verification. CW721 standardizes CosmWasm NFT interactions, but contract identity, extensions, ownership, approvals, and metadata still require verification.

Related reading

Related definitions: contract address.