v1 state

MaxPageSize

idWidth

priceWidth

// types.MaxUnitPrice has 16 digits

listing

listings

// padded id -> \*listing

byToken

// cid:tid -> id

byCollection

// cid:paddedPrice:paddedID -> id (floor = first key)

bySeller

// seller:paddedID -> id

nextID

selfPath

// captured in init for read paths without a cur

init.10

List

List offers a token of a Final collection at price (ugnot). The caller must own it and have approved this realm (Approve or SetApprovalForAll in core). A stale listing of the same token is replaced.

UpdatePrice

UpdatePrice changes the price of a live listing; Buy's expectedPrice protects buyers from a change racing their purchase (RA M-10).

Cancel

Cancel removes the caller's listing. Never paused.

CancelStale

CancelStale lets anyone remove a listing that can no longer be bought.

Buy

Buy pays exactly expectedPrice for the listing (excess attached ugnot is refunded). Order: checks, remove the listing, move the token, then pay — protocol fee to the treasury, royalty to the collection's sub-treasury (then distributed to its payees), the rest to the seller. I-4: fee + royalty + seller + refund == attached.

Listing

ListingOf

ListingOf is the live listing of a token as JSON, or "null".

ActiveListing

ActiveListing is the typed read for other realms: the live listing of a token, if any.

ListingsByCollection

ListingsByCollection lists by ascending price. Stale listings are included with "live":false so pages stay stable; frontends hide them.

ListingsBySeller

Floor

Floor is the lowest live price in cid, or -1. It inspects at most MaxPageSize listings from the cheapest, so spam cannot make it unbounded.

Render

live

live: still owned by the seller, not moved since listing, and the approval it was listed under is still in place and untouched since: a per-token listing dies with any later Approve of that token, an approval-for-all listing with any later SetApprovalForAll of the market by the seller — even one that approves again (SA-L3).

approvals

approvals reports whether market is approved for this token, and whether it is approved for all of owner's tokens.

remove

remove deletes a listing and its indexes; closed listings are not kept (RA L-6), the "Cancelled" event (reason sold/cancelled/stale) is the record.

listPrefix

writeListing

writeListingLive

mustListing

assertSeller

assertTradeOpen

assertPrice

received

assertNoDeposit

pay

tokenKey

collectionKey

sellerKey

prefixEnd

prefixEnd is the smallest key greater than every key with this prefix (prefixes here end in ':', so bump it to ';').

parseID

itoa

selfAddress