v1 state

cEvents

// P(id) -> event record

cTickets

// P((id-1)/16) -> 16 ticket records

cByArtist

// P(artist)/P(event) -> ""

cUpcoming

// T(start)/P(event) -> "" (not cancelled, not hidden)

cAhead

// P(artist)/T(start)/P(event) -> "" (not cancelled)

cOwned

// address -> packed ticket ids held

cBuyers

// P(event)/address -> tickets bought

cAttended

// address -> concerts checked in at

cMeta

// "n" -> Rec(events, tickets)

cConfig

// admin, fee

cPresent

// P(ticket) -> Rec(holder, unix time, door code) of its last Present

collections

setup

setup makes the collections and the first settings, once: a later release finds them made (it is not the writer in its init).

save

save writes ops in one call: data.Set or data.Remove for one op, else one data.Batch.

get

upKey

aheadKey

idOf

idOf reads the event id at the end of an index key.

count

count is the number of keys of c with start \<= key \< end.

mEvents

mTickets

meta

metaCount

decode

decode reads an event record ("" gives nil).

record

record encodes an event in the order of nft.E\*.

getEvent

visible

visible: not hidden by moderation, and its artist profile is visible.

mustEvent

chunks

chunks reads ticket records, each chunk once per call.

getTicket

mustTicket

ticketRecord

own

own adds id to addr's list (remove: takes it out) as an op.

TicketOwner

EventInfo

EventInfo returns a copy of a visible concert; ok is false otherwise.

HiddenNote

HiddenNote says why a concert is hidden: "Removed by moderation: \<reason>", or "".

TicketInfo

TicketInfo returns a copy of a ticket.

EventCount

TicketCount

Attended

Attended returns how many concerts a holder checked in at.

PresentedAt

PresentedAt is when the ticket's current holder last presented it at the door (Present) with this door code, unix seconds; 0 when they did not, or it changed hands since, or it was checked in. CheckIn takes it for 10 minutes.

ServiceFee

ServiceFee returns the per-ticket service fee in ugnot (0 while no treasury is set).

Admin

PendingAdmin

TicketsOf

TicketsOf returns up to limit ticket ids held by owner, newest first.

ArtistEvents

ArtistEvents returns up to limit visible concert ids of an artist, newest first.

Upcoming

Upcoming returns up to n visible, not cancelled future concerts, soonest first.

PastEvents

PastEvents returns up to limit (1-100) ids of the concerts that have started, were not cancelled and are not hidden, latest first from offset, and how many there are. The start-time index pages them: cancelled or hidden concerts take no room, however many there are.

eachUpcoming

eachUpcoming walks the visible future concerts, soonest first, until fn returns true or maxScan index entries were read; want sizes the first page. Past entries are skipped by starting the walk at now.

EventSVG

EventSVG returns the specimen ticket of a visible concert as a markdown image, or "" when the concert is not visible.

TicketSVG

TicketSVG returns a ticket as a markdown image, or "" if unknown.

eventJSON

EventsJSON

EventsJSON pages through concerts, newest first (limit \<= 50): offset and limit count stored concerts, hidden ones are left out of the page, and "next" gives the offset of the following page (0 at the end). upcoming=true lists future, not cancelled, visible concerts instead, soonest first, with offset and limit counting listed concerts ("next" is then a listed-concert offset, 0 when the scan ended).

TicketsOfJSON

TicketsOfJSON lists the tickets held by owner, newest first (\<= 50).

FeesJSON

FeesJSON returns the ticket service fee and where it goes.

denom

ugnot

minPrice

// 0.1 GNOT

maxTicketPrice

maxCapacity

maxPerBuyer

maxPerArtist

// concerts ever created

maxOpenAhead

// future, not cancelled concerts per artist

checkInWindow

// check-in opens 12h before the concert

checkInClose

// and closes 12h after its start

presentFor

// a Present admits its ticket for 10 minutes

maxServiceFee

maxOwned

// tickets one wallet holds

maxGifted

// a wallet takes gifts while it holds fewer: gifts never block buying

maxScan

// upcoming index entries one read walks

nftPath

Event

Event is a concert.

Ticket

Ticket is one NFT ticket.

self

// this realm's path

admin

// the moderator; nil when a release before renounced it

init.75

CreateEvent

CreateEvent announces a concert by the caller's artist profile. start is "YYYY-MM-DD HH:MM" in UTC; price is in GNOT ("0" for free, "2.5"); link is an optional https URL (stream or venue page, public).

CancelEvent

CancelEvent stops ticket sales. GnoRadio never held the payments: they went straight to the artist, who handles refunds directly. Artist owner only.

BuyTicket

BuyTicket mints a ticket to the caller. A paid ticket needs the exact price plus the service fee attached: the price goes straight to the artist, the fee to the GnoRadio treasury.

TransferTicket

TransferTicket gives one of the caller's tickets to someone else. There is no built-in resale market.

Present

Present shows a ticket at the door: its holder signs from their own wallet, with the door code the staff's screen shows after scanning the ticket's QR. A QR built from public data (the ticket id and its holder) cannot do that for them, and a stranger with a copied QR gets another code: the holder's Present does not admit them. CheckIn then admits the ticket with that code for 10 minutes. Only while the door is open: from 12h before the concert to 12h after its start.

CheckIn

CheckIn marks a ticket as used at the door; its holder earns the "I was there" stamp. The concert's artist owner only, while the door is open, and only for a ticket its current holder presented (Present) with this door code in the last 10 minutes.

mustDoorCode

mustDoorCode refuses a door code that is not 4 to 8 digits.

mustDoorOpen

mustDoorOpen refuses a ticket the door cannot take now.

HideEvent

HideEvent hides or restores a concert. Admin only; hiding takes a public reason (4-200 characters). Tickets stay with their holders.

RefreshArtist

RefreshArtist re-reads an artist's visibility in the catalog and updates the Upcoming index for its future concerts (at most maxOpenAhead): once moderators hide a profile, its concerts stop taking places in the Upcoming scan; a restored artist's come back. Anyone may call it.

RefreshArtistPast

RefreshArtistPast does the same for up to 50 of an artist's past concerts from offset (oldest first; the 500 an artist may have take ten calls), so a hidden profile's past concerts leave the past-concerts index too. Anyone may call it.

reindex

reindex re-files an artist's concerts (their cAhead keys) in the Upcoming index by visibility.

SetServiceFee

SetServiceFee sets the per-ticket service fee in ugnot (0..10 GNOT), paid by buyers of paid tickets on top of the price and forwarded to the GnoRadio treasury. Admin only.

Ready

Ready tells the data realm that this release is on chain (see data.Propose). Anyone may call it.

OfferAdmin

OfferAdmin offers the admin role to an address (offering it to the admin cancels the offer); AcceptAdmin takes it. Each change is mirrored to the data realm, so the next release keeps the admin.

AcceptAdmin

RenounceAdmin

RenounceAdmin gives the admin role up for good, for this release and the next ones.

Render

Render points gnoweb visitors to the GnoRadio site; a retired release says which realm took over.

now

userCaller

adminAddr

syncAdmin

syncAdmin adopts the mirror when the previous release changed it after this one's init (during the release's delay).

onlyAdmin

noPayment

paid

paid returns the ugnot attached to the call; anything else is refused.

serviceFee

serviceFee is the stored fee, 0 while no treasury is set: the fee has nowhere to go, so buyers never pay it.

mustArtistOf

mustText

parseGNOT

parseGNOT parses a decimal GNOT amount ("10", "2.5") into ugnot.