Interface for privileged set registration and upgrade operations All methods operate on the set represented by the calling contract and must be access-controlled

Functions

registerSet

Registers the set represented by the calling contract
function registerSet(bytes32 data) external returns (uint64 id, Descriptor memory desc);
Parameters
NameTypeDescription
databytes32Content hash (e.g., metadata or schema)
Returns
NameTypeDescription
iduint64Newly assigned set ID
descDescriptorDescriptor of the registered set

updateSet

Updates the content hash for the set represented by the calling contract
function updateSet(bytes32 data) external returns (uint64 id, Descriptor memory desc);
Parameters
NameTypeDescription
databytes32New content hash
Returns
NameTypeDescription
iduint64Set ID
descDescriptorUpdated descriptor

upgradeSet

Upgrades the kind or set revision of the set represented by the calling contract Pass 0 to skip updating either revision
function upgradeSet(uint32 kindRev0, uint32 setRev0) external returns (uint64 id, Descriptor memory desc);
Parameters
NameTypeDescription
kindRev0uint32New kind revision (0 = no change)
setRev0uint32New set revision (0 = no change)
Returns
NameTypeDescription
iduint64Set ID
descDescriptorDescriptor after upgrade

touchSet

Increments the revision of the set represented by the calling contract
function touchSet() external returns (uint64 id, Descriptor memory desc);
Returns
NameTypeDescription
iduint64Set ID
descDescriptorDescriptor after revision bump