CW721 Reference

Stargaze NFT collections use CW721 contracts on the Cosmos Hub.

Instantiate

Create a new collection:

{
  "name": "Collection Name",
  "symbol": "SYMBOL",
  "minter": "cosmos1...",
  "creator": "cosmos1...",
  "collection_info_extension": {
    "description": "Collection description",
    "image": "ipfs://...",
    "external_link": "https://...",
    "royalty_info": {
      "payment_address": "cosmos1...",
      "share": "0.05"
    }
  }
}

Execute Messages

Transfer NFT

{
  "transfer_nft": {
    "recipient": "cosmos1...",
    "token_id": "1"
  }
}

Send NFT (to contract)

{
  "send_nft": {
    "contract": "cosmos1...",
    "token_id": "1",
    "msg": "<base64-encoded-message>"
  }
}

Approve

{
  "approve": {
    "spender": "cosmos1...",
    "token_id": "1",
    "expires": { "at_height": 12345678 }
  }
}

Revoke

{
  "revoke": {
    "spender": "cosmos1...",
    "token_id": "1"
  }
}

Approve All

{
  "approve_all": {
    "operator": "cosmos1...",
    "expires": { "at_time": "1234567890000000000" }
  }
}

Revoke All

{
  "revoke_all": {
    "operator": "cosmos1..."
  }
}

Burn

{
  "burn": {
    "token_id": "1"
  }
}

Update Collection Info

{
  "update_collection_info": {
    "collection_info": {
      "name": "New Name",
      "symbol": "NEW",
      "extension": {
        "description": "Updated description",
        "royalty_info": {
          "payment_address": "cosmos1...",
          "share": "0.10"
        }
      }
    }
  }
}

Query Messages

Owner Of

Get the owner of a token:

{
  "owner_of": {
    "token_id": "1",
    "include_expired": false
  }
}

NFT Info

Get token metadata:

{
  "nft_info": {
    "token_id": "1"
  }
}

Response:

{
  "token_uri": "ipfs://...",
  "extension": {}
}

All NFT Info

Get owner and metadata:

{
  "all_nft_info": {
    "token_id": "1",
    "include_expired": false
  }
}

Tokens (by owner)

List tokens owned by an address:

{
  "tokens": {
    "owner": "cosmos1...",
    "start_after": "0",
    "limit": 100
  }
}

All Tokens

List all tokens in collection:

{
  "all_tokens": {
    "start_after": "0",
    "limit": 100
  }
}

Num Tokens

Get total supply:

{
  "num_tokens": {}
}

Collection Info

Get collection metadata:

{
  "get_collection_info_and_extension": {}
}

Approvals

Get approvals for a token:

{
  "approvals": {
    "token_id": "1",
    "include_expired": false
  }
}

All Operators

Get all operators for an owner:

{
  "all_operators": {
    "owner": "cosmos1...",
    "include_expired": false,
    "start_after": null,
    "limit": 100
  }
}

Royalties

Royalties are set in the collection extension:

{
  "royalty_info": {
    "payment_address": "cosmos1...",
    "share": "0.05"
  }
}

• share is a decimal (0.05 = 5%)

• Maximum royalty: 10% (0.10)

• Royalties are enforced by the marketplace contract

Expiration Types

Used for approvals:

// Block height
{ "at_height": 12345678 }

// Timestamp (nanoseconds)
{ "at_time": "1234567890000000000" }

// Never expires
{ "never": {} }

External Resources

• CW721 Spec

• CosmWasm Documentation

• Cosmos Hub Documentation