Skip to content

Latest commit

 

History

History
31 lines (27 loc) · 1.95 KB

CONTRACT_API.md

File metadata and controls

31 lines (27 loc) · 1.95 KB

Contract API reference

Full signatures are in contracts/ticketing/src/lib.rs; this is a quick-reference summary.

Function Caller Effect
initialize(admin, payment_token) admin One-time setup
create_event(organizer, event_id, name, category, max_resale_multiplier_bps, royalty_bps) organizer Registers an event
issue_ticket(organizer, event_id, to, tier, seat, price) organizer Mints a ticket (off-chain payment already settled)
purchase_primary(buyer, event_id, tier, seat, price) buyer On-chain primary sale + mint
transfer_ticket(from, ticket_id, to) owner Direct transfer
verify_ticket(ticket_id) anyone Read-only lookup
check_in(organizer, ticket_id) organizer Marks used, one-way
revoke_ticket(organizer, ticket_id) organizer Permanently voids
revoke_with_refund(organizer, ticket_id, refund) organizer Voids a ticket, optionally paying the original price back to the owner in the event's accepted payment token
set_event_payment_token(organizer, event_id, token) organizer Sets/clears the event's accepted payment token (only before any tickets are issued)
event_payment_token(event_id) anyone Resolves the event's payment token (per-event override or contract-wide token)
token_decimals() anyone Decimals of the active payment token (cached at initialize / token change)
list_for_resale(owner, ticket_id, price) owner Lists under the event's price cap
cancel_resale(owner, ticket_id) owner Pulls a listing
buy_resale(buyer, ticket_id) buyer Buys a listing, splits royalty
get_event(event_id) anyone Read-only event lookup
get_ticket(ticket_id) anyone Read-only ticket lookup

Error codes

See the Error enum in lib.rs for the full list; each variant maps to a specific precondition failure (e.g. AlreadyUsed, NotOwner, ResalePriceExceedsCap).