Skip to content

SeriesEmitterLib

string IPFS_BASE_URI
event URI(string value, uint256 id)
error NoPendingEvents()

No pending batch events to emit.

error InvalidLimit()

Limit parameter is zero or exceeds maximum.

event PermanentURI(string uri, uint256 tokenId)

Token-level metadata permanently frozen (OpenSea compliant).

https://docs.opensea.io/docs/metadata-standards#freezing-metadata

NameTypeDescription
uristringFull metadata URI.
tokenIduint256Token identifier.
function emitURIs(uint256[] seriesTokens, uint256 cursor, uint256 limit, string cid) external returns (uint256 newCursor)

Emit URI events for a series of tokens.

Intended for both freezing and updating series metadata.

NameTypeDescription
seriesTokensuint256[]Array of token IDs in the series.
cursoruint256Current processing cursor.
limituint256Max tokens to process this call.
cidstringNew base URI for the series.
NameTypeDescription
newCursoruint256Updated processing cursor.
function emitPermanentURIs(uint256[] seriesTokens, uint256 cursor, uint256 limit, string cid) external returns (uint256 newCursor)

Emit PermanentURI events for a series of tokens.

Emits a {PermanentURI} for each token, marking it as frozen.

NameTypeDescription
seriesTokensuint256[]Array of token IDs in the series.
cursoruint256Current processing cursor.
limituint256Max tokens to process this call.
cidstringFrozen base URI for the series.
NameTypeDescription
newCursoruint256Updated processing cursor.
function cidToUri(string cid) public pure returns (string)

Compose the base URI from a raw IPFS CID.

NameTypeDescription
cidstringRaw IPFS content identifier (CID)
NameTypeDescription
[0]stringFull base URI (e.g. “ipfs://“)
function cidIdToUri(string cid, uint256 id) public pure returns (string)