Legacy Collectibles V1 (ERC-1155-C) 收藏功能参考

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

功能和论据

DEFAULT_TRANSFER_VALIDATOR()

返回/付款

address

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

功能和论据

MAX_BATCH_SIZE()

返回/付款

uint256

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

功能和论据

MAX_ROYALTY_BPS()

返回/付款

uint96

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

功能和论据

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

返回/付款

bytes32

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

功能和论据

autoApproveTransfersFromValidator()

返回/付款

bool

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

功能和论据

autoEnableTrading()

返回/付款

bool

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

功能和论据

balanceOf(address account, uint256 id)

返回/付款

uint256

Returns ERC-1155 balances for matching account and token-ID arrays. The arrays must have equal length.

功能和论据

balanceOfBatch(address[] accounts, uint256[] ids)

返回/付款

uint256[]

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

功能和论据

collection()

返回/付款

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.

功能和论据

concurrentPublicMint()

返回/付款

bool

Identifies this immutable collection as the independent Aurora Collectibles family; its token interface is ERC-1155.

功能和论据

contractFamily()

返回/付款

string

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

功能和论据

contractURI()

返回/付款

string

Reports whether a release has been permanently ended.

功能和论据

dropEnded(bytes32)

返回/付款

bool

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

功能和论据

editableMetadata()

返回/付款

bool

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

功能和论据

factory()

返回/付款

address

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

功能和论据

galleryId()

返回/付款

bytes32

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

功能和论据

getDrop(bytes32 dropId)

返回/付款

(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.

功能和论据

getPhase(bytes32 dropId, bytes32 phaseId)

返回/付款

(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.

功能和论据

getTransferValidationFunction()

返回/付款

bytes4 functionSignature, bool isViewFunction

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

功能和论据

getTransferValidator()

返回/付款

address validator

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

功能和论据

isApprovedForAll(address owner, address operator)

返回/付款

bool isApproved

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

功能和论据

metadataBaseURI()

返回/付款

string

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

功能和论据

metadataRevision()

返回/付款

uint256

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

功能和论据

metadataSupply()

返回/付款

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.

功能和论据

mintCatalog()

返回/付款

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.

功能和论据

mintCatalogSize(bytes32 dropId)

返回/付款

uint256

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

功能和论据

mintFeeAuthority()

返回/付款

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.

功能和论据

mintNonce(address)

返回/付款

uint256

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

功能和论据

mintSupplyCap()

返回/付款

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.

功能和论据

mintedByWallet(bytes32, address)

返回/付款

uint256

Whether collection minting has been permanently closed.

功能和论据

mintingClosed()

返回/付款

bool

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

功能和论据

mintingPaused()

返回/付款

bool

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

功能和论据

name()

返回/付款

string

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

功能和论据

nativePublicMint()

返回/付款

bool

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

功能和论据

owner()

返回/付款

address

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

功能和论据

paused()

返回/付款

bool

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

功能和论据

payoutRecipient(bytes32)

返回/付款

address

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

功能和论据

pendingOwner()

返回/付款

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.

功能和论据

pendingReveal()

返回/付款

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.

功能和论据

phaseMintedByWallet(bytes32, bytes32, address)

返回/付款

uint256

Returns the stable ERC-1155 artwork ID for placeholder mints in a release. All copies in that placeholder release share the same token ID.

功能和论据

placeholderArtworkId(bytes32 dropId)

返回/付款

bytes32

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

功能和论据

proceeds()

返回/付款

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.

功能和论据

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)

返回/付款

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.

功能和论据

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

返回/付款

bytes32

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

功能和论据

royaltyBps()

返回/付款

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.

功能和论据

royaltyInfo(uint256 tokenId, uint256 salePrice)

返回/付款

address, uint256

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

功能和论据

royaltyReceiver()

返回/付款

address

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

功能和论据

supportsInterface(bytes4 interfaceId)

返回/付款

bool

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

功能和论据

symbol()

返回/付款

string

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

功能和论据

tokenIdForArtwork(bytes32)

返回/付款

uint256

Returns ERC1155 for edition contracts.

功能和论据

tokenStandard()

返回/付款

string

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.

功能和论据

tokenURI(uint256 tokenId)

返回/付款

string

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

功能和论据

totalSupply()

返回/付款

uint256

Lifetime copies minted for one ERC-1155 token ID. This is not a wallet balance.

功能和论据

totalSupplyOf(uint256)

返回/付款

uint256

Number of distinct minted ERC-1155 artwork/token IDs, independent of how many copies exist.

功能和论据

totalTokenTypes()

返回/付款

uint256

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

功能和论据

tradingEnabled()

返回/付款

bool

ERC-1155 metadata reference for a token ID, empty if unknown. Snapshot updates affect every copy of a covered edition. Filenames use decimal IDs, not the standard {id} substitution pattern.

功能和论据

uri(uint256 tokenId)

返回/付款

string

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.

功能和论据

validator()

返回/付款

address

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

功能和论据

acceptOwnership()

返回/付款

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.

功能和论据

cancelReveal()

返回/付款

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.

功能和论据

closeMinting()

返回/付款

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.

功能和论据

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

返回/付款

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.

功能和论据

configurePayout(bytes32 dropId, address recipient)

返回/付款

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.

功能和论据

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

返回/付款

No return value

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

功能和论据

enableTrading()

返回/付款

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.

功能和论据

endDrop(bytes32 dropId)

返回/付款

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.

功能和论据

executeReveal(string baseURI, bytes32 salt)

返回/付款

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.

功能和论据

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

返回/付款

No return value

Inherited ERC-1155 initialization hook, already called during clone creation. Further calls revert; it is not a metadata-update tool.

功能和论据

initializeERC1155(string uri_)

返回/付款

No return value

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

功能和论据

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)

返回/付款

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.

功能和论据

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

返回/付款

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.

功能和论据

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)

返回/付款

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.

功能和论据

renounceOwnership()

返回/付款

No return value

Transfers several ERC-1155 IDs and amounts with matching arrays. Applies holder/operator authorization, trading and validator rules and contract receiver checks.

功能和论据

safeBatchTransferFrom(address from, address to, uint256[] ids, uint256[] amounts, bytes data)

返回/付款

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.

功能和论据

safeTransferFrom(address from, address to, uint256 id, uint256 amount, bytes data)

返回/付款

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.

功能和论据

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

返回/付款

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.

功能和论据

setApprovalForAll(address operator, bool approved)

返回/付款

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.

功能和论据

setAutoEnableTrading(bool enabled)

返回/付款

No return value

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

功能和论据

setAutomaticApprovalOfTransfersFromValidator(bool autoApprove)

返回/付款

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.

功能和论据

setContractURI(string newURI)

返回/付款

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.

功能和论据

setDefaultRoyalty(address receiver, uint96 basisPoints)

返回/付款

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.

功能和论据

setMetadataBaseURI(string newURI, uint256 expectedSupply, uint256 expectedRevision)

返回/付款

No return value

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

功能和论据

setMintingPaused(bool value)

返回/付款

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.

功能和论据

setPaused(bool value)

返回/付款

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.

功能和论据

setTransferValidator(address transferValidator_)

返回/付款

No return value

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

功能和论据

transferOwnership(address newOwner)

返回/付款

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.

功能和论据

updateTransferValidator(address nextValidator)

返回/付款

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.

功能和论据

withdraw(address recipient, uint256 amount)

返回/付款

No return value