Documentation Index
Fetch the complete documentation index at: https://docs.cultura.xyz/llms.txt
Use this file to discover all available pages before exploring further.
Solidity API
Contract: ICRS
External Functions
registerRoyaltyDue
function registerRoyaltyDuefunction registerRoyaltyDue(uint256 tokenId, uint256 amountDue, uint256 startDate, uint256 endDate, uint256 royaltyInfoIndex) external
Parameters
| Name | Description |
|---|
tokenId | The ID of the token. |
amountDue | The amount of royalty due for the period. |
startDate | The start date of the royalty period (Unix timestamp). |
endDate | The end date of the royalty period (Unix timestamp). |
royaltyInfoIndex | The index for the royalty period (0-based). |
payRoyalty
function payRoyaltyfunction payRoyalty(uint256 tokenId, uint256 amountPaid, uint256 periodIndex, address culturaBoundAccount, bytes signature) external
Parameters
| Name | Description |
|---|
tokenId | The ID of the token. |
amountPaid | The amount being paid on-chain. |
periodIndex | The index of the royalty period being paid. |
culturaBoundAccount | The address of the associated Cultura Rights Bound Account. |
signature | Signature required by the CulturaRightsBoundAccount’s setPaymentInfo function. |
reportOffChainPayment
function reportOffChainPaymentfunction reportOffChainPayment(uint256 tokenId, uint256 periodIndex, uint256 amount, string metadata) external
Parameters
| Name | Description |
|---|
tokenId | The ID of the VR token. |
periodIndex | The index of the royalty period. |
amount | The amount reported as paid off-chain. |
metadata | Optional metadata about the payment (e.g., transaction ID). |
acceptOffChainPayment
function acceptOffChainPaymentfunction acceptOffChainPayment(uint256 tokenId, uint256 periodIndex, address culturaBoundAccount, bytes signature) external
Parameters
| Name | Description |
|---|
tokenId | The ID of the VR token. |
periodIndex | The index of the royalty period. |
culturaBoundAccount | The address of the associated Cultura Rights Bound Account. |
signature | The VR owner’s EIP712 signature confirming acceptance. |
denyOffChainPayment
function denyOffChainPaymentfunction denyOffChainPayment(uint256 tokenId, uint256 periodIndex, bytes signature) external
Parameters
| Name | Description |
|---|
tokenId | The ID of the VR token. |
periodIndex | The index of the royalty period. |
signature | The VR owner’s EIP712 signature confirming denial. |
getFullRoyaltyInfo
function getFullRoyaltyInfofunction getFullRoyaltyInfo(uint256 tokenId) external view returns (struct ICRS.RoyaltyInfoView[])
Parameters
| Name | Description |
|---|
tokenId | The ID of the token. |
Return Values
| Description |
|---|
| An array of RoyaltyInfoView structs. |
getRoyaltyInfoPeriod
function getRoyaltyInfoPeriodfunction getRoyaltyInfoPeriod(uint256 tokenId, uint256 periodIndex) external view returns (uint256 periodStart, uint256 periodEnd, uint256 amountDue, uint256 amountPaid, uint256[] parentPendingClaims)
Parameters
| Name | Description |
|---|
tokenId | The ID of the token. |
periodIndex | The index of the royalty period. |
Return Values
| Description |
|---|
| The start of the royalty period. |
| The end of the royalty period. |
| The amount currently due for the period. |
| The amount already paid for the period. |
| Empty array (placeholder for signature compatibility). |
getRoyaltyInfoCount
function getRoyaltyInfoCountfunction getRoyaltyInfoCount(uint256 tokenId) external view returns (uint256)
Parameters
| Name | Description |
|---|
tokenId | The ID of the token. |
Return Values
| Description |
|---|
| The number of royalty periods. |
Events
RoyaltyDueRegistered
event RoyaltyDueRegisteredevent RoyaltyDueRegistered(uint256 tokenId, address creator, uint256 startDate, uint256 endDate, uint256 amountDue, uint256 periodIndex)
RoyaltyPaid
event RoyaltyPaidevent RoyaltyPaid(uint256 tokenId, address payer, uint256 periodStart, uint256 periodEnd, uint256 amountPaid)
OffChainPaymentReported
event OffChainPaymentReportedevent OffChainPaymentReported(uint256 tokenId, uint256 periodIndex, address reporter, uint256 reportedAmount, string metadata)
OffChainPaymentAccepted
event OffChainPaymentAcceptedevent OffChainPaymentAccepted(uint256 tokenId, uint256 periodIndex, address acceptor, uint256 acceptedAmount, bytes signature)
OffChainPaymentDenied
event OffChainPaymentDeniedevent OffChainPaymentDenied(uint256 tokenId, uint256 periodIndex, address denier, bytes signature)
