Aventus Classic
Aventus Classic exists as the protocol was outlined in the original Aventus Protocol Foundation whitepaper. Aventus Classic was built with the intention of solving the same core industry problems but the viability of this working at scale was questioned, which led to fork and the design and development of a Tier 2 Protocol solution that supports the latest version of the whitepaper.
Principally, the Classic protocol was too closely tied to the Ethereum network and hence inherits some of its current flaws; including the ability to scale large transaction volumes in short time periods. Despite this, the Classic protocol is still a viable solution for a grassroots event owner working with low ticket volumes offering the same functionality of an open blockchain ticketing standard.
Find below a high-level overview of the Classic protocol and how to interact with the smart contracts currently deployed on the Ethereum Testnet (Rinkeby).
Contracts
StevenTODO: add Rinkeby contract addresses
StevenTODO: briefly explain how to interact with them
AVT Mechanics
Certain interactions with the Aventus Protocol require a deposit using the Protocol's token AVT in order to penalise improper behaviour within the network
AndyTODO: add Rinkeby AVT contract address link
As the Protocol is currently deployed to Rinkeby we've introduced an AVT Tap (similar to Ethereum's faucet) to release testnet AVTs for use with the Protocol
AndyTODO: add link and docs for Rinkeby AVT Tap
Event Deposit
Every new event requires a deposit of 2000 AVT (1000 AVT if the event is free), which is returned to the owner once the eventTime has passed. If an event is voted to be fraudulent by the community, the event deposit will be shared amongst the voting community.
Member Deposit
Members who wish to create events and tickets must first put up a deposit of 5000 AVT. If a member is voted to be fraudulent by the community, their member deposit will be shared amongst the voting community.
Member Management
Member Registration
Register the given address and member type on the Aventus Protocol, only Primary and Secondary types supported
Requires a deposit to be made. See
getMemberDeposit
Method: registerMember
Method Parameter Descriptions
| Parameter | Type | Description |
|---|---|---|
memberAddress | address | Address of the new member to be registered |
memberType | string | Stipulate if the member is to be registered as a Primary or Secondary |
evidenceUrl | string | External URL to validate the legitimacy of the new member registration |
desc | string | A brief description of the member being registered, ie. company name |
Response: LogMemberRegistered
Log Parameter Descriptions
| Parameter | Type | Description |
|---|---|---|
memberAddress | address | Address of the new member to be registered |
memberType | string | Stipulate if the member is to be registered as a Primary or Secondary |
evidenceUrl | string | External URL to validate the legitimacy of the new member registration |
desc | string | A brief description of the member being registered, ie. company name |
deposit | uint | The amount of AVT required to create the event, expressed in attoavts |
Method: getNewMemberDeposit
Method Parameter Descriptions
| Parameter | Type | Description |
|---|---|---|
memberType | string | Stipulate if the member is to be registered as a Primary or Secondary |
Response
| Parameter | Type | Description |
|---|---|---|
memberDepositInAVT | uint | The amount of AVT required to create the event, expressed in attoavts |
Member Deregistration
Method: getDeregistrationTime
Timestamp of when this member can be deregistered; zero if no restrictions
Method Parameter Descriptions
| Parameter | Type | Description |
|---|---|---|
memberAddress | address | Address of the new member to be registered |
memberType | string | Stipulate if the member is to be registered as a Primary or Secondary |
Response: LogMemberDeregistered
Log Parameter Descriptions
| Parameter | Type | Description |
|---|---|---|
deregistrationTime | unit |
Method: deregisterMember
Primary and Secondary can only be deregistered after a cooling off period since the latest eventTime of the tickets they have sold/resold. This will stop the given member from using the Aventus Protocol and unlock the deposit that was locked when the member was registered.
Method Parameter Descriptions
| Parameter | Type | Description |
|---|---|---|
memberAddress | address | Address of the new member to be registered |
memberType | string | Stipulate if the member is to be registered as a Primary or Secondary |
Response: LogMemberDeregistered
Log Parameter Descriptions
| Parameter | Type | Description |
|---|---|---|
memberAddress | address | Address of the new member to be registered |
memberType | string | Stipulate if the member is to be registered as a Primary or Secondary |
Event Management
Create Event
Events are the bedrock of any ticket interaction on the Protocol and an event must be in place before tickets can be created. This endpoint will create an Aventus event parent object directly on the Ethereum blockchain
We refer to the user calling this endpoint as the eventOwner. Identity on Ethereum is represented by a 20 byte public key address and corresponding private key.
Method: createEvent
Note: Event creation requires a deposit in AVT, and is therefor challengeable by other actors in the network. See Event Challenges
Method Parameter Descriptions
| Parameter | Type | Description |
|---|---|---|
eventDesc | string | A brief, human-readable description of the event you are hosting |
eventTime | uint | Actual Epoch time the event starts IRL |
eventSupportURL | string | A URL referring to data that acts as evidence for the event - eg the addresses used for sale/resale - to help prevent challenges |
onSaleTime | uint | When tickets go on sale: before this time is the "reporting period" so the event can be challenged before ticket sales start |
offSaleTime | uint | The Epoch time that allows for no new tickets to be created or transfers of ownership after this time |
averageTicketPriceInUSCents | uint | Used to calculate the event deposit, the higher the average ticket price, the higher the event deposit |
Response: LogEventCreated
Log Parameter Descriptions
| Parameter | Type | Description |
|---|---|---|
eventId | uint | A unique identifier for the event on the Protocol |
eventOwner | address | Public key of the event owner who is creating this event |
eventDesc | string | A brief, human-readable description of the event you are hosting |
eventTime | uint | Actual Epoch time the event starts IRL |
eventSupportURL | string | A URL referring to data that acts as evidence for the event - eg the addresses used for sale/resale - to help prevent challenges |
onSaleTime | uint | When tickets go on sale: before this time is the "reporting period" so the event can be challenged before ticket sales start |
offSaleTime | uint | The Epoch time that allows for no new tickets to be created or transfers of ownership after this time |
averageTicketPriceInUSCents | uint | Used to calculate the event deposit, the higher the average ticket price, the higher the event deposit |
depositInAVT | uint | The amount of AVT required to create the event |
Register Role on Event
You should now have created an event on the Aventus Protocol, and as the eventOwner, may wish to add third party permissions to the event to manage your tickets. Event-level roles such as Primary and Secondary vendors must be set using this method before they have the rights to interact with tickets for an event.
As before with the eventOwner address, a new role must be registered with a public key address as an identity mechanism.
Method: registerRoleOnEvent
Note: Address must already be registered as a protocol member
Method Parameter Descriptions
| Parameter | Type | Description |
|---|---|---|
eventId | uint | A unique identifier for the event on the Protocol |
roleAddress | address | The address of the role being registered |
role | string | A case insensitive string representing a valid blockchain role (eg. primary, secondary) |
Response: LogEventRoleRegistered
Log Parameter Descriptions
| Parameter | Type | Description |
|---|---|---|
eventId | uint | A unique identifier for the event on the Protocol |
roleAddress | address | The address of the role being registered |
role | string | A case insensitive string representing a valid blockchain role (eg. primary, secondary) |
Get Event Time
Get the time of an event
Method: getEventTime
Method Parameter Descriptions
| Parameter | Type | Description |
|---|---|---|
eventId | uint | A unique identifier for the event on the Protocol |
Response: StevenTODO: what's the log response called?
Log Parameter Descriptions
| Parameter | Type | Description |
|---|---|---|
eventTime | uint | Timestamp of when the event starts; zero if no matching eventId |
Get On Sale Time
Get the on sale time of an event
Method: getOnSaleTime
Method Parameter Descriptions
| Parameter | Type | Description |
|---|---|---|
eventId | uint | A unique identifier for the event on the Protocol |
Response: StevenTODO: what's the log response called?
Log Parameter Descriptions
| Parameter | Type | Description |
|---|---|---|
eventTime | uint | Timestamp of when tickets for the event go on sale; zero if no matching eventId |
Get Off Sale Time
Get the off sale time of an event
Method: getOffSaleTime
Method Parameter Descriptions
| Parameter | Type | Description |
|---|---|---|
eventId | uint | A unique identifier for the event on the Protocol |
Response: StevenTODO: what's the log response called?
Log Parameter Descriptions
| Parameter | Type | Description |
|---|---|---|
eventTime | uint | Timestamp of when tickets for the event go off sale; zero if no matching eventId |
End Ticket Sales
Immediately stops new ticket creations (updates offSaleTime to now), called by the eventOwner
Method: takeEventOffSale
Note: Can only be called in ticket sales period.
Method Parameter Descriptions
| Parameter | Type | Description |
|---|---|---|
eventId | uint | A unique identifier for the event on the Protocol |
Response: LogEventTakenOffSale
Log Parameter Descriptions
| Parameter | Type | Description |
|---|---|---|
eventId | uint | A unique identifier for the event on the Protocol |
End Event
Ends Event before sales start, called by the Event Owner
Method: cancelEvent
Note: Can only be done when event is not under challenge
Method Parameter Descriptions
| Parameter | Type | Description |
|---|---|---|
eventId | uint | A unique identifier for the event on the Protocol |
Response: LogEventCancelled
Log Parameter Descriptions
| Parameter | Type | Description |
|---|---|---|
eventId | uint | A unique identifier for the event on the Protocol |
Method: endEvent
Deregisters event after eventTime has passed (unlocks deposit), can be called by anyone
Method Parameter Descriptions
| Parameter | Type | Description |
|---|---|---|
eventId | uint | A unique identifier for the event on the Protocol |
Response: LogEventEnded
Log Parameter Descriptions
| Parameter | Type | Description |
|---|---|---|
eventId | uint | A unique identifier for the event on the Protocol |
Method: getNewEventDeposit
Given the average ticket price, returns the required deposit, can be called by anyone
Method Parameter Descriptions
| Parameter | Type | Description |
|---|---|---|
averageTicketPriceInUSCents | uint | Average ticket price in US Cents |
Response
| Parameter | Type | Description |
|---|---|---|
depositInAVT | uint | The amount of AVT required to create the event, expressed in attoavts |
Method: getExistingEventDeposit
Get the value of the AVT deposit that was paid for the given event; this must be matched to challenge the event
Method Parameter Descriptions
| Parameter | Type | Description |
|---|---|---|
eventId | uint | A unique identifier for the event on the Protocol |
Response
| Parameter | Type | Description |
|---|---|---|
eventDeposit | uint | The amount of AVT been deposited for the specified event, expressed in attoavts |
Ticket Management
Create Ticket(s)
Method: sellTicket
Uses a single ticket buyer private key for ownership and door access, can only be sent from Event Owner or registered Primary. No doorData
Method Parameter Descriptions
| Parameter | Type | Description |
|---|---|---|
eventId | uint | A unique identifier for the event on the Protocol |
vendorTicketRefHash | bytes32 | Hash of the vendor (event owner or primary) generated unique ticket reference for the event |
ticketMetadata | string | Contextual, non-unique data associated with a ticket used by the wallets UI. includes but not exclusive to: event name, event time, venue location, etc |
buyer | address | Address of the ticket buyer |
Response: LogTicketSold
Log Parameter Descriptions
| Parameter | Type | Description |
|---|---|---|
eventId | uint | A unique identifier for the event on the Protocol |
ticketId | uint | A unique identifier for the ticket on the Protocol |
vendorTicketRefHash | bytes32 | Hash of the vendor (event owner or primary) generated unique ticket reference for the event |
ticketMetadata | string | Contextual, non-unique data associated with a ticket used by the wallets UI. includes but not exclusive to: event name, event time, venue location, etc |
buyer | address | Address of the ticket buyer |
Method: sellMultipleTickets
Primary sale of up to 100 tickets. Supports different ticket ref, metadata, and buyer. Used when metadata is unique to ticket, eg specifies row/seat/etc
Method Parameter Descriptions
| Parameter | Type | Description |
|---|---|---|
eventId | uint | A unique identifier for the event on the Protocol |
tickets | encoded bytes | Encoded vendorTicketRefHash, ticketMetadata and buyer address for each ticket |
Response
Multiple LogTicketSold events
Method: sellMultipleTicketsSameMetaData
Primary sale of up to 100 tickets. Supports different ticket ref and buyer. Used when metadata is the same for a group of tickets, eg “General Admission”
Method Parameter Descriptions
| Parameter | Type | Description |
|---|---|---|
eventId | uint | A unique identifier for the event on the Protocol |
ticketMetadata | string | Contextual, non-unique data associated with a ticket used by the wallets UI. includes but not exclusive to: event name, event time, venue location, etc |
tickets | encoded bytes | Encoded vendorTicketRefHash and buyer address for each ticket |
Response
Multiple LogTicketSold events
Cancel Ticket
Method: cancelTicket
Can only be sent from eventOwner or the original Primary
Method Parameter Descriptions
| Parameter | Type | Description |
|---|---|---|
eventId | uint | A unique identifier for the event on the Protocol |
ticketId | uint | A unique identifier for the ticket on the Protocol |
Response: LogTicketCancelled
Log Parameter Descriptions
| Parameter | Type | Description |
|---|---|---|
eventId | uint | A unique identifier for the event on the Protocol |
ticketId | uint | A unique identifier for the ticket on the Protocol |
Resell Ticket
Method: resellTicket
Can only be sent from eventOwner or registered Secondary
Method Parameter Descriptions
| Parameter | Type | Description |
|---|---|---|
eventId | uint | A unique identifier for the event on the Protocol |
ticketId | uint | A unique identifier for the ticket on the Protocol |
ticketOwnerPermission | bytes | A hash of eventId/ticketRef/TicketOwner Address, signed with the ticket owner key |
newBuyer | address | Address of the new buyer of the ticket |
Response: LogTicketResold
Log Parameter Descriptions
| Parameter | Type | Description |
|---|---|---|
eventId | uint | A unique identifier for the event on the Protocol |
ticketId | uint | A unique identifier for the ticket on the Protocol |
newBuyer | address | Address of the new buyer of the ticket |
Proposals
Governance
StevenTODO: find methods
Community Proposals
StevenTODO: find methods
Challenges
ethanTODO: what are challenges and how to vote, claim winnings
Event Challenges
Create a challenge for the specified event, locks a deposit and starts voting process, can be called by anyone
Method: challengeEvent
Note: Requires a deposit to be made. See
getExistingEventDeposit
Method Parameter Descriptions
| Parameter | Type | Description |
|---|---|---|
eventId | uint | A unique identifier for the event on the Protocol |
Response: LogEventChallenged
Log Parameter Descriptions
| Parameter | Type | Description |
|---|---|---|
eventId | uint | A unique identifier for the event on the Protocol |
proposalId | uint | A unique identifier for the challenge on the Protocol |
lobbyingStart | uint | UNIX epoch timestamp for the start of the vote lobbying period |
votingStart | uint | UNIX epoch timestamp for the start of the voting period |
revealingStart | uint | UNIX epoch timestamp for the start of the vote revealing period |
revealingEnd | uint | UNIX epoch timestamp for the end of the vote revealing period |
Method: endEventChallenge
Ends a challenge on the specified event
Method Parameter Descriptions
| Parameter | Type | Description |
|---|---|---|
eventId | uint | A unique identifier for the event on the Protocol |
Response: LogEventChallengeEnded
Log Parameter Descriptions
| Parameter | Type | Description |
|---|---|---|
eventId | uint | A unique identifier for the event on the Protocol |
proposalId | uint | A unique identifier for the challenge on the Protocol |
votesFor | uint | Total number of votes for a challenge |
votesAgainst | uint | Total number of votes against a challenge |
Method: claimVoterWinnings
Claim winnings from a proposal if caller voted on the winning side. Results in the caller's share of any proposal winnings being put into their AVT account.
Method Parameter Descriptions
| Parameter | Type | Description |
|---|---|---|
proposalId | uint | A unique identifier for the challenge on the Protocol |
Response: LogVoterWinningsClaimed
Log Parameter Descriptions
| Parameter | Type | Description |
|---|---|---|
proposalId | uint | A unique identifier for the challenge on the Protocol |
Member Challenges
Method: challengeMember
Create a challenge for the specified member
Method Parameter Descriptions
| Parameter | Type | Description |
|---|---|---|
memberAddress | address | address of member to be challenged |
memberType | string calldata | type of member to be challenged |
Response: LogMemberChallenged
Log Parameter Descriptions
| Parameter | Type | Indexed | Description |
|---|---|---|---|
memberAddress | address | ✔ | Address of the new member to be registered |
memberType | string | ✘ | Stipulate if the member is to be registered as a Primary or Secondary |
proposalId | uint | ✔ | |
lobbyingStart | uint | ✘ | |
votingStart | uint | ✘ | |
revealingStart | uint | ✘ | |
revealingEnd | uint | ✘ |
Method: endMemberChallenge
Ends a challenge on the specified member
Method Parameter Descriptions
| Parameter | Type | Description |
|---|---|---|
memberAddress | address | address of member to be challenged |
memberType | string calldata | type of member to be challenged |
Response: LogMemberChallengeEnded
Log Parameter Descriptions
| Parameter | Type | Indexed | Description |
|---|---|---|---|
memberAddress | address | ✔ | Address of the new member to be registered |
memberType | string | ✘ | Stipulate if the member is to be registered as a Primary or Secondary |
proposalId | uint | ✔ | |
votesFor | uint | ✘ | |
votesAgainst | uint | ✘ |
Method: memberIsActive
Returns true if the given member is allowed to use the Aventus Protocol (ie. registered AND not fraudulent)
Method Parameter Descriptions
| Parameter | Type | Description |
|---|---|---|
memberAddress | address | address of member to be challenged |
memberType | string calldata | type of member to be challenged |
Response: StevenTODO what's this called?
Log Parameter Descriptions
| Parameter | Type | Indexed | Description |
|---|---|---|---|
isActive | bool | ✘ |
Method: getExistingMemberDeposit
Gets the deposit paid for the specified member
Method Parameter Descriptions
| Parameter | Type | Description |
|---|---|---|
memberAddress | address | address of member to be challenged |
memberType | string calldata | type of member to be challenged |
Response: StevenTODO what's this called?
Log Parameter Descriptions
| Parameter | Type | Indexed | Description |
|---|---|---|---|
memberDepositInAVT | uint | ✘ |
Voting
StevenTODO: find methods