v1 source realm

AudiusLicense is the license id of tracks streamed from Audius.

NumGenres is the size of the fixed genre list; genre ids are 1..NumGenres.

ActivityJSON returns the activity feed, newest first (limit <= 64).

AlbumsJSON returns visible albums with ids offset+1..offset+limit (at most 100).

AllowHost adds or removes an https host that audio and covers may use.

ArtistBrief returns what a link to an artist needs, without the bio or the id lists; ok is false for an unknown artist.

ArtistByName looks a profile up by its (case-insensitive) name.

ArtistByRef looks a pointer artist up by its platform id ("audius-user:12").

ArtistTrackCount is the number of tracks an artist published.

ArtistTrackPage lists an artist's track ids in publishing order, paginated.

ArtistVerified reports whether an artist proved who they are (tips and paid tickets need it).

ArtistsJSON returns visible artists with ids offset+1..offset+limit (at most 100).

AssignArtist hands an unclaimed artist to the wallet that proved it owns the profile (claim checked off-chain). Their tracks then receive tips.

CancelClaim drops a pending claim (e.g. the proof page was hijacked). Admin only.

Claim starts the verification of artistID for the caller with the robot's certificate (ClaimMessage signed, hex). It replaces any pending claim for the artist and restarts the delay. The artist pays its gas.

ClaimJSON is the verification state of an artist for the app: {"verified":b,"proof":"…","pending":b,"to":"…","pendingProof":"…","readyAt":n,"bot":"…"}.

ClaimMessage is what the robot signs: the chain, the GnoRadio deployment (its data realm, so a staging deployment on the same chain cannot reuse a certificate), the profile, the wallet, where the proof was found and until when the certificate holds.

CreateAlbum groups tracks of one artist. The artist (or the admin for an unclaimed artist) creates it; trackIDs is "12,13,14" in play order.

CreateArtist adds an unclaimed artist. Admin only. A curated artist has a name and its page at the source (https), shown for attribution. An Audius or Jamendo artist is a pointer: no name or bio, and source is its platform id ("audius-user:<id>", "jamendo-artist:<id>"), which also keeps it unique; the app reads its name live from the platform.

EditFor fixes a track's details. Its artist only (the admin while the artist is unclaimed): caller is who signed.

FinalizeClaim applies a pending claim once claimDelay has passed. Anyone can call it, usually the artist from the app.

Follow and Unfollow an artist.

FollowsPage lists the artist ids a listener follows, paginated.

FundPromo adds the attached ugnot to the caller's sponsored-pick budget in the vault. A new budget pays defaultPickPay per aired pick (SetPromoPay changes it). If the profile changed hands since the last funding, the previous funder gets their whole balance back first, reservations included, and the budget starts a new funding generation. The caller's budget must then hold at least one refund, or no pick could ever use it.

GenreCount is the number of tracks filed under a genre.

GenrePage lists the track ids of a genre (hidden ones included), newest first.

HiddenNote says why a track, album, artist or playlist is hidden, for its page: "Removed by moderation: <reason>", "Hidden by the artist.", or "".

HideOwn hides or shows again the caller's own track, album or artist profile ("artist", with the profile's id). The artist can show again only what they hid themselves: what the moderator hid stays hidden.

HideSource hides every artist read from a platform ("audius" or "jamendo"), and so all their tracks, for a platform that ends GnoRadio's API access. It walks artist ids from `from`, count (1-50) at a time, and returns where to go on (0 once past the last artist). One artist opting out is a HideArtist. Admin only.

Hide or restore content. Admin only; hiding takes a public reason (4-200 characters) and restoring works on anything, whoever hid it. Hidden content stays on-chain (and on IPFS); it is no longer listed, played or tippable. Radio stations drop a hidden track on their next Refresh (radio.RefreshArtist for a whole artist).

ImportFor adds a curated (CC0 / CC BY / CC BY-SA / CC BY-NC / CC BY-NC-SA) track, or a pointer to an Audius or Jamendo track, to an unclaimed artist. by must be the admin. A pointer keeps only what the radio needs (audio "audius:<id>" or "jamendo:<id>", genre, duration, licence): title, credits, cover, source and attribution stay empty and the app reads them live from the platform, whose API terms allow session caching only.

Info is the catalog's summary for the app: counts, the admin and the realm that writes the catalog now ("current", this one unless retired).

Like records a public like. The first listeners to like a track earn its early-listener badge. (Saving a track privately is done in the app, free.)

LikedPage lists a listener's liked track ids, newest tracks first, paginated. Likes are keyed by track id, so this is the newest music the listener liked, not the order of their likes (that needs an index per like, which would add to every like's storage deposit).

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.

PlayableTitle is a track's title, "" unless it is playable (TrackBrief).

PlaylistBrief returns a playlist's header without its track ids.

PlaylistsJSON returns visible playlists with ids offset+1..offset+limit (at most 100).

PromoClaim pays picker a reservation of funding generation gen once their sponsored pick ending at end has aired; the radio realm checks the slot. A lapsed or cancelled reservation (the budget was refunded since) pays nothing.

PromoClaimable reports whether PromoClaim would pay a sponsored pick's refund: reserved for end in generation gen, neither lapsed nor cancelled.

PromoJSON is an artist's sponsored-pick budget: {"artist","funder","balance","reserved","free","pay","perDay","today","funded","paid","picks","offer"}. The funder withdraws "free" with data.VaultWithdraw(acct) where acct is "catalog/" and the artist id on 8 digits.

PromoOffer is what a sponsored pick of the artist's tracks refunds right now (0: none). Picker-specific limits are checked when picking.

PromoRelease returns a reservation to its budget: the slot was dropped or cut before it aired in full. A reservation of an earlier funding generation than gen's budget was refunded with it: nothing to release. A pick that never aired, reserved at reserved (unix; 0 when it partly aired), also gives back the daily counts it took, the artist's and picker's, if that was today. Radio realm only.

PromoReserve reserves the refund of a sponsored pick of trackID by picker whose slot ends at end. Only the radio realm may call it (radio.QueueSponsored); it panics with the reason when the pick cannot be sponsored. It returns the amount reserved and the budget's funding generation, which the radio passes back to PromoClaim, PromoClaimable and PromoRelease.

PromoShare returns an artist's promo percent.

ProofHost is where a verified artist's proof was found: a host they control, not proof of who they are, so show it next to the ✓. It is "" when the artist is not verified, or a moderator verified it (Verify, AssignArtist).

PublishFor adds a track by caller's own artist profile. duration is "m:ss"; cmo is "none" or "sacem-nc"; splits is optional, "g1...:30,g1...:15" in percent (the artist keeps at least 10%); rights must be "yes" (the caller accepts RightsTerms). audio and cover are ipfs://, ar:// or https:// links (an allowed host, with the file's sha256).

PublishPlaylist makes a public playlist in one signature; trackIDs is "12,40,7". Private playlists live in the app and cost nothing.

RadioTip pays a tip the radio realm received for the listener tipper (radio.TipOnAir): the radio has already forwarded total ugnot to this realm and names the picker of the slot on air. Only the radio writer may call it. It returns what the picker and the referrer received.

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

RegisterArtist creates or updates the caller's artist profile. Names use Latin letters so look-alike names in other scripts cannot impersonate.

ReleaseName frees a reserved name no visible artist is using. Admin only.

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

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

Report flags a track, album, artist or playlist for the moderators (e.g. "broken link", "not the real artist", "copyright").

ReportCount is the number of open (unresolved) reports.

ReportPage lists open report ids, newest first.

ResetOwner undoes a wrong claim on an imported profile (e.g. a hijacked proof page found too late): the profile is unclaimed again. Self-registered profiles keep their owner. Admin only.

ResolveReport closes a report once handled. Admin only.

ResolveReports closes the open reports with ids from..from+count-1 (count 1-50) in one transaction, e.g. a run of spam reports; ids already closed are skipped. There is no global cap on open reports, so spam never blocks an honest reporter: each wallet keeps at most 5 open. Admin only.

SetBot sets the robot's Ed25519 public key, hex ("" disables it). Every pending claim started with the previous key is voided: its artist claims again with a fresh certificate. Admin only.

SetMonthlyGoal sets the monthly support goal shown in the app (ugnot). Admin only.

SetPromoPay sets what each aired sponsored pick of the caller's tracks refunds (10 000..500 000 ugnot, 0 pauses) and the daily limit (1 to 100, 0 = the default, 10).

SetPromoShare sets the percent of each tip on the caller's tracks that goes to the picker and the referrer (0..20).

SetTreasury changes where GnoRadio's support goes; "" (the default) takes none. Admin only.

SupportGnoRadio sends the attached ugnot to the GnoRadio treasury.

SupportJSON returns GnoRadio's public funding state.

Tip forwards the attached ugnot to the track's artist and collaborators, split as declared at publish time, in this same transaction. Only verified artists receive tips (verify.gno). Verification proves control of a web host or an Audius account, not who the artist is: the proof host is public next to every ✓ (ProofHost), and the 72 h claim window (PendingClaims) is there to catch an impersonator before tips open.

TipWithSupport is Tip plus an optional contribution to GnoRadio: of the attached total T, the artist side receives T*100/(100+supportPct) (split as in Tip) and the rest goes to the GnoRadio treasury. supportPct is 0..50.

TrackBrief is what the radio needs; playable is false for an unknown or hidden track, or one whose artist is hidden.

TrackBriefFor is TrackBrief and whether addr ("" for nobody) is the track's artist or one of its collaborators, from the same reads.

TrackJSON returns one playable track.

TrackPage lists track ids, newest first when newest is true. Ids are dense (1..count), so these pages are arithmetic.

TracksJSON pages through playable tracks (newest first), at most 100. Chunks and artist heads are read once per page.

Unlike takes a like back, and its early-listener badge with it.

UpdatePlaylist replaces a playlist's title and tracks. Owner only.

UserJSON returns a listener's public counters (likes are paged with LikesJSON).

UserStats returns a listener's public counters and playlists. The like count reads the listener's own like ranges, one page.

Verify marks an artist whose identity was checked off-chain.

Activities returns up to limit entries, newest first.

PendingClaims lists up to limit (1-100) verifications pending with the current robot key, by artist id from offset, and how many claims are stored (stale ones included, so offset+limit < total means more). A claim stays public for 72 hours before it counts: this is where anyone watches them.

GetTrack returns a copy of a track; ok is false if unknown. A pointer's empty title reads as its platform ("Audius track").

Activity is one entry of the public activity feed.

PendingClaim is a verification on its way: the artist, the wallet it goes to, the proof link and when FinalizeClaim may apply it.

User is what a listener writes, so a follow only touches that listener's own record. Follows are a sorted packed list (9 bytes each); likes and the tipped tracks live apart, per range of 512 track ids.