Events
The Events Layer adds the ability to attach timestamps to individual Items. Events can be set for any time point and can be used by other features as a method for storing custom time points.
The Events layer also provides the Shared Events table for storing group-wide events. Set the shared flag to true on a given Event Action to specify a shared event.
Table Name:
events
Table Scope:
item.serial
Name | Type | Example | Description |
event_name | name | createtime | The name of the event. |
event_time | time_point_sec | 2020-05-30T10:58:05 | The time of the event. |
locked | bool | false | The locked state of the event. |
Create a new Event with the
newevent()
action.Required Authority:
group.manager
Name | Type | Example | Description |
serial | uint64_t | 5 | The serial number of the Item to assign the event. |
event_name | name | minttime | The name of the event. |
custom_event_time | optional<time_point_sec> | 2020-05-30T10:58:05 | The custom event time to set for the event. |
shared | bool | true | Create shared event if true. |
Cleos
Marble CLI
cleos push action {account} newevent '[ ... ]' -p {account}
marble event ...
Update an event timestamp with the
seteventtime()
action.Required Authority:
group.manager
Name | Type | Example | Description |
serial | uint64_t | 5 | The serial number of the Item to affect. |
event_name | name | cooldown | The name of the event to affect. |
new_event_time | time_point_sec | 2020-05-30T10:58:05 | The new event time to set for the event. |
shared | bool | true | Update shared event if true. |
Cleos
Marble CLI
cleos push action {account} seteventtime '[ ... ]' -p {account}
marble update ...
Lock an event with the
lockevent()
action.Required Authority:
group.manager
Name | Type | Example | Description |
serial | uint64_t | 5 | The serial number of the Item with the event to lock. |
event_name | name | cooldown | The name of the event to lock. |
shared | bool | false | Lock a shared event if true. |
Cleos
Marble CLI
cleos push action {account} lockevent '[ ... ]' -p {account}
marble lock ...
Remove an event with the
rmvevent()
action.Required Authority: group.manager
Name | Type | Example | Description |
serial | uint64_t | 5 | The serial number of the Item with the event to remove. |
event_name | name | cooldown | The name of the event to remove. |
shared | bool | true | Remove a shared event if true. |
Cleos
Marble CLI
cleos push action {account} rmvevent '[ ... ]' -p {account}
marble event ...
Last modified 3yr ago