# IERC721A *Interface of an ERC721A compliant contract.* ## Methods ### approve ```solidity function approve(address to, uint256 tokenId) external nonpayable ``` *Gives permission to `to` to transfer `tokenId` token to another account. The approval is cleared when the token is transferred. Only a single account can be approved at a time, so approving the zero address clears previous approvals. Requirements: - The caller must own the token or be an approved operator. - `tokenId` must exist. Emits an {Approval} event.* #### Parameters | Name | Type | Description | | ------- | ------- | ----------- | | to | address | undefined | | tokenId | uint256 | undefined | ### balanceOf ```solidity function balanceOf(address owner) external view returns (uint256) ``` *Returns the number of tokens in `owner`'s account.* #### Parameters | Name | Type | Description | | ----- | ------- | ----------- | | owner | address | undefined | #### Returns | Name | Type | Description | | ---- | ------- | ----------- | | \_0 | uint256 | undefined | ### getApproved ```solidity function getApproved(uint256 tokenId) external view returns (address) ``` *Returns the account approved for `tokenId` token. Requirements: - `tokenId` must exist.* #### Parameters | Name | Type | Description | | ------- | ------- | ----------- | | tokenId | uint256 | undefined | #### Returns | Name | Type | Description | | ---- | ------- | ----------- | | \_0 | address | undefined | ### isApprovedForAll ```solidity function isApprovedForAll(address owner, address operator) external view returns (bool) ``` *Returns if the `operator` is allowed to manage all of the assets of `owner`. See {setApprovalForAll}* #### Parameters | Name | Type | Description | | -------- | ------- | ----------- | | owner | address | undefined | | operator | address | undefined | #### Returns | Name | Type | Description | | ---- | ---- | ----------- | | \_0 | bool | undefined | ### name ```solidity function name() external view returns (string) ``` A descriptive name for a collection of NFTs in this contract #### Returns | Name | Type | Description | | ---- | ------ | ----------- | | \_0 | string | undefined | ### ownerOf ```solidity function ownerOf(uint256 tokenId) external view returns (address) ``` *Returns the owner of the `tokenId` token. Requirements: - `tokenId` must exist.* #### Parameters | Name | Type | Description | | ------- | ------- | ----------- | | tokenId | uint256 | undefined | #### Returns | Name | Type | Description | | ---- | ------- | ----------- | | \_0 | address | undefined | ### safeTransferFrom ```solidity function safeTransferFrom(address from, address to, uint256 tokenId) external nonpayable ``` *Safely transfers `tokenId` token from `from` to `to`, checking first that contract recipients are aware of the ERC721 protocol to prevent tokens from being forever locked. Requirements: - `from` cannot be the zero address. - `to` cannot be the zero address. - `tokenId` token must exist and be owned by `from`. - If the caller is not `from`, it must be have been allowed to move this token by either {approve} or {setApprovalForAll}. - If `to` refers to a smart contract, it must implement {IERC721Receiver-onERC721Received}, which is called upon a safe transfer. Emits a {Transfer} event.* #### Parameters | Name | Type | Description | | ------- | ------- | ----------- | | from | address | undefined | | to | address | undefined | | tokenId | uint256 | undefined | ### safeTransferFrom ```solidity function safeTransferFrom(address from, address to, uint256 tokenId, bytes data) external nonpayable ``` *Safely transfers `tokenId` token from `from` to `to`. Requirements: - `from` cannot be the zero address. - `to` cannot be the zero address. - `tokenId` token must exist and be owned by `from`. - If the caller is not `from`, it must be approved to move this token by either {approve} or {setApprovalForAll}. - If `to` refers to a smart contract, it must implement {IERC721Receiver-onERC721Received}, which is called upon a safe transfer. Emits a {Transfer} event.* #### Parameters | Name | Type | Description | | ------- | ------- | ----------- | | from | address | undefined | | to | address | undefined | | tokenId | uint256 | undefined | | data | bytes | undefined | ### setApprovalForAll ```solidity function setApprovalForAll(address operator, bool _approved) external nonpayable ``` *Approve or remove `operator` as an operator for the caller. Operators can call {transferFrom} or {safeTransferFrom} for any token owned by the caller. Requirements: - The `operator` cannot be the caller. Emits an {ApprovalForAll} event.* #### Parameters | Name | Type | Description | | ---------- | ------- | ----------- | | operator | address | undefined | | \_approved | bool | undefined | ### symbol ```solidity function symbol() external view returns (string) ``` An abbreviated name for NFTs in this contract #### Returns | Name | Type | Description | | ---- | ------ | ----------- | | \_0 | string | undefined | ### tokenURI ```solidity function tokenURI(uint256 _tokenId) external view returns (string) ``` A distinct Uniform Resource Identifier (URI) for a given asset. *Throws if `_tokenId` is not a valid NFT. URIs are defined in RFC 3986. The URI may point to a JSON file that conforms to the "ERC721 Metadata JSON Schema".* #### Parameters | Name | Type | Description | | --------- | ------- | ----------- | | \_tokenId | uint256 | undefined | #### Returns | Name | Type | Description | | ---- | ------ | ----------- | | \_0 | string | undefined | ### totalSupply ```solidity function totalSupply() external view returns (uint256) ``` *Returns the total amount of tokens stored by the contract. Burned tokens are calculated here, use `_totalMinted()` if you want to count just minted tokens.* #### Returns | Name | Type | Description | | ---- | ------- | ----------- | | \_0 | uint256 | undefined | ### transferFrom ```solidity function transferFrom(address from, address to, uint256 tokenId) external nonpayable ``` *Transfers `tokenId` token from `from` to `to`. WARNING: Usage of this method is discouraged, use {safeTransferFrom} whenever possible. Requirements: - `from` cannot be the zero address. - `to` cannot be the zero address. - `tokenId` token must be owned by `from`. - If the caller is not `from`, it must be approved to move this token by either {approve} or {setApprovalForAll}. Emits a {Transfer} event.* #### Parameters | Name | Type | Description | | ------- | ------- | ----------- | | from | address | undefined | | to | address | undefined | | tokenId | uint256 | undefined | ## Events ### Approval ```solidity event Approval(address indexed owner, address indexed approved, uint256 indexed tokenId) ``` #### Parameters | Name | Type | Description | | ------------------ | ------- | ----------- | | owner `indexed` | address | undefined | | approved `indexed` | address | undefined | | tokenId `indexed` | uint256 | undefined | ### ApprovalForAll ```solidity event ApprovalForAll(address indexed owner, address indexed operator, bool approved) ``` #### Parameters | Name | Type | Description | | ------------------ | ------- | ----------- | | owner `indexed` | address | undefined | | operator `indexed` | address | undefined | | approved | bool | undefined | ### Transfer ```solidity event Transfer(address indexed from, address indexed to, uint256 indexed tokenId) ``` #### Parameters | Name | Type | Description | | ----------------- | ------- | ----------- | | from `indexed` | address | undefined | | to `indexed` | address | undefined | | tokenId `indexed` | uint256 | undefined | ## Errors ### ApprovalCallerNotOwnerNorApproved ```solidity error ApprovalCallerNotOwnerNorApproved() ``` The caller must own the token or be an approved operator. ### ApprovalQueryForNonexistentToken ```solidity error ApprovalQueryForNonexistentToken() ``` The token does not exist. ### ApprovalToCurrentOwner ```solidity error ApprovalToCurrentOwner() ``` The caller cannot approve to the current owner. ### ApproveToCaller ```solidity error ApproveToCaller() ``` The caller cannot approve to their own address. ### BalanceQueryForZeroAddress ```solidity error BalanceQueryForZeroAddress() ``` Cannot query the balance for the zero address. ### MintToZeroAddress ```solidity error MintToZeroAddress() ``` Cannot mint to the zero address. ### MintZeroQuantity ```solidity error MintZeroQuantity() ``` The quantity of tokens minted must be more than zero. ### OwnerQueryForNonexistentToken ```solidity error OwnerQueryForNonexistentToken() ``` The token does not exist. ### TransferCallerNotOwnerNorApproved ```solidity error TransferCallerNotOwnerNorApproved() ``` The caller must own the token or be an approved operator. ### TransferFromIncorrectOwner ```solidity error TransferFromIncorrectOwner() ``` The token must be owned by `from`. ### TransferToNonERC721ReceiverImplementer ```solidity error TransferToNonERC721ReceiverImplementer() ``` Cannot safely transfer to a contract that does not implement the ERC721Receiver interface. ### TransferToZeroAddress ```solidity error TransferToZeroAddress() ``` Cannot transfer to the zero address. ### URIQueryForNonexistentToken ```solidity error URIQueryForNonexistentToken() ``` The token does not exist. --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://the-artist-xchange.gitbook.io/the-artist-xchange/docs/ierc721a.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.