ERC-721-C referência de função de coleção

Upstream library default validator address. Use getTransferValidator for this collection’s actual validator.

Função e argumentos

DEFAULT_TRANSFER_VALIDATOR()

Devoluções/pagamento

address

Maximum copies or unique NFTs in one mint transaction: 20.

Função e argumentos

MAX_BATCH_SIZE()

Devoluções/pagamento

uint256

Maximum royalty setting: 1,000 basis points, or 10%.

Função e argumentos

MAX_ROYALTY_BPS()

Devoluções/pagamento

uint96

Calculates the whitelist proof leaf for a wallet, allocation and individual price, bound to this chain, collection, release and phase.

Função e argumentos

allowlistLeaf(bytes32 dropId, bytes32 phaseId, address wallet, uint256 allowance, uint256 unitPrice)

Devoluções/pagamento

bytes32

Reports whether the validator has automatic operator approval. It is disabled and cannot be enabled after initialization in these builds.

Função e argumentos

autoApproveTransfersFromValidator()

Devoluções/pagamento

bool

Reports whether the first mint automatically enables transfers. It can be changed only before any mint and before trading is enabled.

Função e argumentos

autoEnableTrading()

Devoluções/pagamento

bool

ERC-721: number of NFTs held by a wallet. ERC-1155: number of copies of a specified token ID held by an account.

Função e argumentos

balanceOf(address owner)

Devoluções/pagamento

uint256

Returns this collection’s address. Native minting runs at the collection address itself.

Função e argumentos

collection()

Devoluções/pagamento

address

Returns true for the current mint design: each payer has an independent authorization sequence, so another wallet minting does not invalidate their approval. Real supply, phase, price and expiry checks still apply. Older deployed builds retain their original approval behavior.

Função e argumentos

concurrentPublicMint()

Devoluções/pagamento

bool

Returns collection-level metadata, such as its profile. This is separate from individual token metadata.

Função e argumentos

contractURI()

Devoluções/pagamento

string

Reports whether a release has been permanently ended.

Função e argumentos

dropEnded(bytes32)

Devoluções/pagamento

bool

Identifies a contract with metadata-update functions. It stays true even after ownership is renounced, when nobody can authorize owner-only updates.

Função e argumentos

editableMetadata()

Devoluções/pagamento

bool

Returns the factory bound into this implementation at deployment. It cannot be replaced.

Função e argumentos

factory()

Devoluções/pagamento

address

Aurora folder identity used to create this collection. It is fixed when initialized.

Função e argumentos

galleryId()

Devoluções/pagamento

bytes32

Returns the single address approved to transfer an ERC-721 token, or zero if none. The token must exist.

Função e argumentos

getApproved(uint256 tokenId)

Devoluções/pagamento

address

Returns the release configuration, minted count, version and existence flag. A zero cap means uncapped at that level; collection limits still apply.

Função e argumentos

getDrop(bytes32 dropId)

Devoluções/pagamento

(bytes32 inventoryRoot, uint256 inventorySize, string placeholderURI, uint256 supplyCap, uint256 walletCap, bool paused) config, uint256 minted, uint256 version, bool exists

Returns phase timing, price, caps, allowlist root, pause flag, minted count, version and existence flag.

Função e argumentos

getPhase(bytes32 dropId, bytes32 phaseId)

Devoluções/pagamento

(uint64 startsAt, uint64 endsAt, uint256 unitPrice, uint256 supplyCap, uint256 walletCap, bytes32 allowlistRoot, bool paused) config, uint256 minted, uint256 version, bool exists

Returns the validator function selector and whether the validation call is read-only. ERC-1155 validation includes transfer amount.

Função e argumentos

getTransferValidationFunction()

Devoluções/pagamento

bytes4 functionSignature, bool isViewFunction

Returns the active transfer validator. The zero address means validator checks are disabled. The owner can change this using updateTransferValidator.

Função e argumentos

getTransferValidator()

Devoluções/pagamento

address validator

Reports whether an operator is approved to transfer the holder’s tokens. Approval does not give collection administrator permissions.

Função e argumentos

isApprovedForAll(address owner, address operator)

Devoluções/pagamento

bool isApproved

Returns the most recently published metadata directory. Covered tokens append their decimal token ID and .json.

Função e argumentos

metadataBaseURI()

Devoluções/pagamento

string

Counts published complete metadata snapshots. Expected revision protects against accidentally overwriting a newer snapshot.

Função e argumentos

metadataRevision()

Devoluções/pagamento

uint256

Lifetime minted quantity covered when the last metadata snapshot was published. ERC-1155 counts copies, not token types.

Função e argumentos

metadataSupply()

Devoluções/pagamento

uint256

Returns the immutable artwork catalog bound to this factory or collection implementation. Registered collections use it to store and verify committed inventory before opening a mint, then read artwork during successful mint transactions. The collection owner publishes entries through the catalog’s appendMintCatalog function; this getter does not publish or modify artwork.

Função e argumentos

mintCatalog()

Devoluções/pagamento

address

Returns the number of artwork entries uploaded to this release’s immutable catalog. A release backed by artwork cannot open until this equals its committed inventory size. This is publication progress, not the number already minted.

Função e argumentos

mintCatalogSize(bytes32 dropId)

Devoluções/pagamento

uint256

Returns the immutable factory that validates public-mint fee authorizations. It does not have owner or withdrawal powers.

Função e argumentos

mintFeeAuthority()

Devoluções/pagamento

address

Returns the next authorization sequence for a paying wallet across this collection. A successful public mint increments only that payer’s sequence, consuming their previous approvals; another wallet’s mint does not change it. Failed transactions roll back the increment. This value is used in the legacy-named expectedMinted request field in current builds.

Função e argumentos

mintNonce(address)

Devoluções/pagamento

uint256

Lifetime collection mint ceiling. Zero means uncapped. It includes manual and public mints; ERC-1155 counts all copies.

Função e argumentos

mintSupplyCap()

Devoluções/pagamento

uint256

Total quantity minted by a paying wallet within a release. Sending the NFTs to a different recipient does not move this payer’s allowance.

Função e argumentos

mintedByWallet(bytes32, address)

Devoluções/pagamento

uint256

Whether collection minting has been permanently closed.

Função e argumentos

mintingClosed()

Devoluções/pagamento

bool

Whether collection-level minting is paused. This is separate from the native sale pause and per-release/phase pauses.

Função e argumentos

mintingPaused()

Devoluções/pagamento

bool

Collection name set at deployment. No later name setter is provided.

Função e argumentos

name()

Devoluções/pagamento

string

Returns true for integrated public minting. It does not by itself identify a particular version or payout capability.

Função e argumentos

nativePublicMint()

Devoluções/pagamento

bool

Wallet or contract with collection administrator rights. Zero address means ownership was renounced and owner-only functions cannot be used.

Função e argumentos

owner()

Devoluções/pagamento

address

Returns the current owner of a minted ERC-721 token. This token owner is distinct from the collection administrator.

Função e argumentos

ownerOf(uint256 tokenId)

Devoluções/pagamento

address

Native sale pause flag. It blocks public minting and the owner mintBatch path; it does not stop already-enabled transfers or withdrawals.

Função e argumentos

paused()

Devoluções/pagamento

bool

Payment destination for a release. Zero means retain artwork proceeds; any configured nonzero address receives direct payouts. Different releases can have different destinations.

Função e argumentos

payoutRecipient(bytes32)

Devoluções/pagamento

address

Nominated next collection owner. Control changes only after this address accepts. Renunciation clears any pending nomination.

Função e argumentos

pendingOwner()

Devoluções/pagamento

address

Current reveal commitment, release ID, base/max supply, expected metadata revision, due time and existence flag. There can be one pending reveal across the collection.

Função e argumentos

pendingReveal()

Devoluções/pagamento

bytes32 dropId, bytes32 commitment, uint256 baseSupply, uint256 maxSupply, uint256 expectedRevision, uint64 revealAt, bool exists

Cumulative quantity paid for by one wallet in one release phase. Counts remain when the phase settings change.

Função e argumentos

phaseMintedByWallet(bytes32, bytes32, address)

Devoluções/pagamento

uint256

Creator revenue retained for withdrawal across releases. Excludes direct payouts and platform fees. Forced or unrelated native-currency deposits are not necessarily withdrawable proceeds.

Função e argumentos

proceeds()

Devoluções/pagamento

uint256

Validates a proposed mint against current phase, version, supply, payer nonce and wallet rules and returns artwork unit and total prices. Another payer minting does not change this payer’s nonce. Does not include the platform fee or gas, reserve inventory, validate fee authorization, or guarantee a receiving contract accepts payment.

Função e argumentos

quote((bytes32 dropId, bytes32 phaseId, uint256 dropVersion, uint256 phaseVersion, uint256 quantity, uint256 expectedMinted, uint256 maxUnitPrice, address recipient, uint256 allowance, uint256 allowlistPrice) request, address payer, bytes32[] allowlistProof)

Devoluções/pagamento

uint256 unitPrice, uint256 totalPrice

Computes the hash binding a metadata directory, secret salt, release, supply bounds, revision and due time to this chain and collection.

Função e argumentos

revealCommitment(bytes32 dropId, string baseURI, bytes32 salt, uint256 baseSupply, uint256 maxSupply, uint256 expectedRevision, uint64 revealAt)

Devoluções/pagamento

bytes32

Secondary-sale royalty setting in basis points: 500 means 5%. This is unrelated to primary mint price.

Função e argumentos

royaltyBps()

Devoluções/pagamento

uint96

Returns the royalty receiver and calculated amount for a token and sale price. It is royalty information, not proof that every marketplace enforces payment.

Função e argumentos

royaltyInfo(uint256 tokenId, uint256 salePrice)

Devoluções/pagamento

address, uint256

Receiving wallet for secondary-sale royalties. It does not gain ownership or withdrawal permission.

Função e argumentos

royaltyReceiver()

Devoluções/pagamento

address

Reports support for a given interface identifier. This does not attest to audit status or marketplace compatibility.

Função e argumentos

supportsInterface(bytes4 interfaceId)

Devoluções/pagamento

bool

Collection ticker set during deployment. No later symbol setter is provided.

Função e argumentos

symbol()

Devoluções/pagamento

string

Maps an artwork ID to its minted token ID, or zero if none. ERC-721 IDs are sequential; ERC-1155 uses uint256(artworkId).

Função e argumentos

tokenIdForArtwork(bytes32)

Devoluções/pagamento

uint256

Returns resolved metadata for a minted token. ERC-721 requires the token to exist; the ERC-1155 alias follows uri and returns empty for an unknown token.

Função e argumentos

tokenURI(uint256 tokenId)

Devoluções/pagamento

string

Lifetime minted quantity: unique NFTs for ERC-721, total copies across all editions for ERC-1155. Transfers do not reduce it.

Função e argumentos

totalSupply()

Devoluções/pagamento

uint256

Whether transfers have been permanently enabled. Validator restrictions still apply when true.

Função e argumentos

tradingEnabled()

Devoluções/pagamento

bool

Initial validator bound into the factory/implementation at deployment for provenance. It does not change when a collection replaces or disables its active validator. Read getTransferValidator on the collection for the active setting.

Função e argumentos

validator()

Devoluções/pagamento

address

The nominated pending owner accepts collection control. A pending reveal prevents the handover.

Função e argumentos

acceptOwnership()

Devoluções/pagamento

No return value

Authorizes one address to transfer one ERC-721 token. A zero address clears the approval; transferring the token clears its single-token approval.

Função e argumentos

approve(address to, uint256 tokenId)

Devoluções/pagamento

No return value

Removes the pending reveal commitment. Does not publish artwork or automatically resume paused minting. The owner can prepare a new reveal or metadata update.

Função e argumentos

cancelReveal()

Devoluções/pagamento

No return value

Permanently stops both owner and public minting across the collection. Existing tokens can still trade if trading is enabled; metadata and withdrawal controls remain available until ownership is renounced.

Função e argumentos

closeMinting()

Devoluções/pagamento

No return value

Creates or updates a release. Its inventory root, inventory size and placeholder reference cannot change once registered. A release backed by artwork must have its full verified catalog uploaded before it is unpaused. Supply caps cannot fall below already minted amounts. Changes increment the release version and invalidate old quotes.

Função e argumentos

configureDrop(bytes32 dropId, (bytes32 inventoryRoot, uint256 inventorySize, string placeholderURI, uint256 supplyCap, uint256 walletCap, bool paused) config)

Devoluções/pagamento

No return value

Sets a release’s receiving wallet. Zero address means retain proceeds for withdrawal; a nonzero address receives each artwork payment. Requires an existing paused release that has not been ended. The collection itself cannot be its payout recipient. Changes invalidate old quotes; earlier proceeds stay withdrawable.

Função e argumentos

configurePayout(bytes32 dropId, address recipient)

Devoluções/pagamento

No return value

Creates or edits timing, artwork price, supply/wallet limits, allowlist root and pause state within an open release. End must be zero or after start. Already minted counts remain; changes invalidate old quotes.

Função e argumentos

configurePhase(bytes32 dropId, bytes32 phaseId, (uint64 startsAt, uint64 endsAt, uint256 unitPrice, uint256 supplyCap, uint256 walletCap, bytes32 allowlistRoot, bool paused) config)

Devoluções/pagamento

No return value

Permanently enables transfers, including when minting is paused or closed. Validator policies still apply. Repeated calls after enabling revert.

Função e argumentos

enableTrading()

Devoluções/pagamento

No return value

Permanently ends one release and invalidates its mint quotes. It does not close other releases, cancel its pending reveal or withdraw funds.

Função e argumentos

endDrop(bytes32 dropId)

Devoluções/pagamento

No return value

Publishes the exact committed metadata directory and salt after the reveal time. Supply must match the commitment’s bounds and revision. Clears the pending reveal and leaves public minting paused. This function alone does not end the release: Aurora’s reveal flow adds an owner-approved endDrop call. Force reveal uses separate owner transactions; this function cannot bypass the due time.

Função e argumentos

executeReveal(string baseURI, bytes32 salt)

Devoluções/pagamento

No return value

The factory sets owner, collection identity, name, symbol, royalty settings, lifetime supply cap and initial trading policy while creating the clone. It cannot initialize the same clone again.

Função e argumentos

initialize(address creator, bytes32 galleryId_, string name_, string symbol_, address royaltyReceiver_, uint96 royaltyBps_, uint256 supplyCap_)

Devoluções/pagamento

No return value

Inherited name/symbol initializer, already called by the factory through initialize. Further calls revert; it is not a name-change tool.

Função e argumentos

initializeERC721(string name_, string symbol_)

Devoluções/pagamento

No return value

Legacy unsigned public-mint selector. It always reverts in these fee-authorized builds, including for free mints. Use mintWithFee.

Função e argumentos

mint((bytes32 dropId, bytes32 phaseId, uint256 dropVersion, uint256 phaseVersion, uint256 quantity, uint256 expectedMinted, uint256 maxUnitPrice, address recipient, uint256 allowance, uint256 allowlistPrice) request, bytes32[] allowlistProof, (bytes32 artworkId, string tokenURI, bytes32[] proof)[] inventory)

Devoluções/pagamento

No return value · PAYABLE

Owner mints selected artwork directly, without public-phase pricing or platform mint-fee authorization. ERC-721 artwork IDs must be unique; ERC-1155 includes copy amounts and can reuse an existing edition. Collection supply limits, pause/closure and receiver checks still apply; a pending reveal blocks this path.

Função e argumentos

mintBatch(bytes32[] artworkIds, string[] tokenURIs, address recipient)

Devoluções/pagamento

No return value

Public mint with a whitelist proof when required, exact artwork price plus signed platform fee, quantity/wallet limits and current versions. Current builds use the payer’s mintNonce and assign artwork from the next committed catalog entries when the transaction succeeds; the inventory argument must be empty. A valid authorization is required even for zero fees. Creator payment follows configurePayout. Any failure rolls back the mint and payments; network gas can still be charged.

Função e argumentos

mintWithFee((bytes32 dropId, bytes32 phaseId, uint256 dropVersion, uint256 phaseVersion, uint256 quantity, uint256 expectedMinted, uint256 maxUnitPrice, address recipient, uint256 allowance, uint256 allowlistPrice) request, bytes32[] allowlistProof, (bytes32 artworkId, string tokenURI, bytes32[] proof)[] inventory, uint256 fee, bytes authorization)

Devoluções/pagamento

No return value · PAYABLE

Permanently sets owner and pendingOwner to zero. Requires mintingClosed=true, tradingEnabled=true, proceeds=0 and no pending reveal. Removes metadata, royalty, payout, pause and other owner administration permanently. External validator rules still apply and may change; nobody can recover ownership through this contract.

Função e argumentos

renounceOwnership()

Devoluções/pagamento

No return value

Transfers a token, or ERC-1155 copies, from its holder to a recipient. Requires holder/operator authorization, enabled trading and validator approval. A contract recipient must accept the NFT callback. The ERC-721 overload with bytes passes optional receiver data.

Função e argumentos

safeTransferFrom(address from, address to, uint256 tokenId)

Devoluções/pagamento

No return value

Transfers a token, or ERC-1155 copies, from its holder to a recipient. Requires holder/operator authorization, enabled trading and validator approval. A contract recipient must accept the NFT callback. The ERC-721 overload with bytes passes optional receiver data.

Função e argumentos

safeTransferFrom(address from, address to, uint256 tokenId, bytes data)

Devoluções/pagamento

No return value

Stores a commitment and future due time for one existing release, matching current supply/revision and valid upper supply bounds. Pending reveal restricts other mint paths and ownership changes. Does not schedule an automatic transaction.

Função e argumentos

scheduleReveal(bytes32 dropId, bytes32 commitment, uint256 baseSupply, uint256 maxSupply, uint256 expectedRevision, uint64 revealAt)

Devoluções/pagamento

No return value

Grants or revokes an operator’s ability to transfer all of the caller’s collection tokens. It cannot transfer collection administrator ownership.

Função e argumentos

setApprovalForAll(address operator, bool approved)

Devoluções/pagamento

No return value

Chooses whether the first successful mint enables transfers automatically. Only available before any mint and before trading is enabled. False allows manual enabling later.

Função e argumentos

setAutoEnableTrading(bool enabled)

Devoluções/pagamento

No return value

Inherited upstream setter. Disabled after factory initialization; the collection owner cannot use it to grant automatic validator approval.

Função e argumentos

setAutomaticApprovalOfTransfersFromValidator(bool autoApprove)

Devoluções/pagamento

No return value

Changes the collection-level metadata reference. Accepts URI schemes without a protocol allowlist, subject to syntax and length checks. Does not change individual token metadata.

Função e argumentos

setContractURI(string uri)

Devoluções/pagamento

No return value

Changes the secondary-sale receiver and royalty rate, from 0 to 1,000 basis points. Receiver must be nonzero. Does not change the mint proceeds wallet.

Função e argumentos

setDefaultRoyalty(address receiver, uint96 basisPoints)

Devoluções/pagamento

No return value

Publishes a complete directory for existing tokens using exact current lifetime supply and metadata revision. Requires a nonempty collection and no pending reveal. Directory must end in / and use decimal token-ID .json filenames. Scheme is unrestricted; existing marketplace support is not guaranteed.

Função e argumentos

setMetadataBaseURI(string uri, uint256 expectedSupply, uint256 expectedRevision)

Devoluções/pagamento

No return value

Pauses or resumes collection minting. Once closeMinting has been called, this action cannot reopen it. It does not lock trading.

Função e argumentos

setMintingPaused(bool paused)

Devoluções/pagamento

No return value

Pauses or resumes native sale minting and the guarded owner mint path. Separate collection, release and phase gates can still stop minting. Reveals leave this flag true.

Função e argumentos

setPaused(bool value)

Devoluções/pagamento

No return value

Inherited setter visible in the ABI. Direct calls after initialization are BLOCKED, including owner calls. Use the guarded updateTransferValidator function to replace, disable or restore the active validator.

Função e argumentos

setTransferValidator(address transferValidator_)

Devoluções/pagamento

No return value

ERC-721 transfer with authorization, trading and validator checks but without a safe recipient callback. Tokens can be lost if sent to a contract unable to handle them.

Função e argumentos

transferFrom(address from, address to, uint256 tokenId)

Devoluções/pagamento

No return value

Nominates the next collection owner; that address must acceptOwnership. Zero cancels the nomination without renouncing. Pending reveal blocks the change.

Função e argumentos

transferOwnership(address newOwner)

Devoluções/pagamento

No return value

Replaces the active validator with a compatible deployed contract, or disables it with 0x0000000000000000000000000000000000000000. The owner can restore it later. Disabling stops validator-based royalty enforcement and other validator restrictions, but preserves royaltyInfo, holder approvals, the trading lock and mint fees. Nonzero addresses need deployed code and cannot be this collection. Code presence does not prove safety or compatibility; token-type registration is attempted and policies may need separate setup. Emits TransferValidatorUpdated. Reentrant changes are blocked and automatic validator approval stays disabled. Unavailable after ownership is renounced.

Função e argumentos

updateTransferValidator(address nextValidator)

Devoluções/pagamento

No return value

Sends a positive amount no greater than proceeds to a nonzero chosen recipient. Only the owner authorizes it; the recipient can differ from Aurora’s saved wallet. Available during or after minting. Failed payments revert; reentrant withdrawals are blocked.

Função e argumentos

withdraw(address recipient, uint256 amount)

Devoluções/pagamento

No return value