# ERC721A *Implementation of ] Non-Fungible Token Standard, including the Metadata extension. Built to optimize for lower gas during batch mints. Assumes serials are sequentially minted starting at \_startTokenId() (defaults to 0, e.g. 0, 1, 2, 3..). Assumes that an owner cannot have more than 2**64 - 1 (max value of uint64) of supply. Assumes that the maximum token id cannot exceed 2**256 - 1 (max value of uint256).* ## Methods ### approve ```solidity function approve(address to, uint256 tokenId) external nonpayable ``` *See {IERC721-approve}.* #### Parameters | Name | Type | Description | | ------- | ------- | ----------- | | to | address | undefined | | tokenId | uint256 | undefined | ### balanceOf ```solidity function balanceOf(address owner) external view returns (uint256) ``` *See {IERC721-balanceOf}.* #### Parameters | Name | Type | Description | | ----- | ------- | ----------- | | owner | address | undefined | #### Returns | Name | Type | Description | | ---- | ------- | ----------- | | \_0 | uint256 | undefined | ### getApproved ```solidity function getApproved(uint256 tokenId) external view returns (address) ``` *See {IERC721-getApproved}.* #### 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) ``` *See {IERC721-isApprovedForAll}.* #### 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) ``` *See {IERC721Metadata-name}.* #### Returns | Name | Type | Description | | ---- | ------ | ----------- | | \_0 | string | undefined | ### ownerOf ```solidity function ownerOf(uint256 tokenId) external view returns (address) ``` *See {IERC721-ownerOf}.* #### 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 ``` *See {IERC721-safeTransferFrom}.* #### 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 ``` *See {IERC721-safeTransferFrom}.* #### 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 ``` *See {IERC721-setApprovalForAll}.* #### Parameters | Name | Type | Description | | -------- | ------- | ----------- | | operator | address | undefined | | approved | bool | undefined | ### supportsInterface ```solidity function supportsInterface(bytes4 interfaceId) external view returns (bool) ``` *See {IERC165-supportsInterface}.* #### Parameters | Name | Type | Description | | ----------- | ------ | ----------- | | interfaceId | bytes4 | undefined | #### Returns | Name | Type | Description | | ---- | ---- | ----------- | | \_0 | bool | undefined | ### symbol ```solidity function symbol() external view returns (string) ``` *See {IERC721Metadata-symbol}.* #### Returns | Name | Type | Description | | ---- | ------ | ----------- | | \_0 | string | undefined | ### tokenURI ```solidity function tokenURI(uint256 tokenId) external view returns (string) ``` *See {IERC721Metadata-tokenURI}.* #### Parameters | Name | Type | Description | | ------- | ------- | ----------- | | tokenId | uint256 | undefined | #### Returns | Name | Type | Description | | ---- | ------ | ----------- | | \_0 | string | undefined | ### totalSupply ```solidity function totalSupply() external view returns (uint256) ``` *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 ``` *See {IERC721-transferFrom}.* #### 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/erc721a.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.