auction state

Denom

Denom is the only asset this realm accepts.

MaxFeeBps

MaxFeeBps is the hard protocol-fee cap: 1000 bps = 10%. The fee applies only to the WINNER's payment at close, never to a refund.

AuctionOpen

// accepting bids until endHeight

AuctionSettled

// closed WITH a winner; proceeds credited

AuctionClosed

// closed with NO bids; nothing to settle

AuctionCancelled

// seller cancelled before any bid

MinIncrementBps

MinIncrementBps is the minimum raise over the standing high bid: 500 = 5%. It stops penny-increment griefing without a per-auction knob.

MinBid

Input bounds.

MaxBid

// 1,000,000 GNOT

MinDuration

Input bounds.

MaxDuration

Input bounds.

MaxAntiSnipe

Input bounds.

MaxLotLen

Input bounds.

MaxAuctionsPerSeller

Input bounds.

RenderLimit

Input bounds.

auction

admin

pendingAdmin

feeRecipient

feeBps

// snapshotted into NEW auctions

self

nextID

locked

// Σ current high bids of OPEN auctions (held, not yet claimable)

auctions

// padID(id) -> \*auction

sellerNum

// seller.String() -> \*int64, stored auctions

ledger

init.26

CreateAuction

CreateAuction lists a lot for ascending-bid sale. The caller becomes the seller. \`reserve\` is 0 (no reserve) or a floor in \[MinBid, MaxBid] the first bid must meet; the auction runs for \`durationBlocks\` blocks; a bid landing within \`antiSnipe\` blocks of the end extends the end to now+antiSnipe (0 disables). The current protocol fee is snapshotted in. Returns the id.

Cancel

Cancel withdraws an auction that has not yet received a bid. Seller only. Once any bid stands, the auction can only run to close — a seller cannot pull the lot out from under a committed bidder.

Bid

Bid raises the standing high bid on an open auction. The caller attaches the bid; it must beat the current high bid by at least MinIncrementBps (or meet max(reserve, MinBid) if it is the first bid), and the auction must still be open and before its end. The previous high bidder's escrowed bid becomes a pull-claimable refund. A bid inside the anti-snipe window extends the end.

Close

Close finalizes an auction whose end height has passed. Anyone may call it; no auction's terminal state may depend on a party acting. With a winner, the high bid is credited to the seller (fee split at the ledger) and the auction is Settled; with no bids it is Closed. The winner's escrowed payment moves from \`locked\` into the seller's claimable balance.

Claim

Claim sends amount ugnot of the caller's claimable balance — outbid refunds and, if the caller is a seller of a settled auction, proceeds — to the caller.

ClaimAll

ClaimAll sends the caller's entire claimable balance to the caller.

SetFeeBps

SetFeeRecipient

WithdrawFees

SweepDenom

SweepDenom recovers out-of-band coins to the fee recipient. For the ledger denom the reserve is locked + Liabilities() — escrowed high bids, claimable refunds, seller proceeds and the fee pot are all structurally unreachable.

TransferAdmin

AcceptAdmin

AuctionInfo

AuctionInfo returns an auction's terms and standing state. Lot text is a separate view ([Lot](#Lot)) so this stays a numeric/address tuple.

Lot

Lot returns the auction's free-text lot description.

MinNextBid

MinNextBid is the smallest bid that would be accepted right now: the first bid's floor when there are no bids, else the standing high bid plus the minimum increment.

HighBid

HighBid is the standing high bid (0 if none).

HighBidder

Winner

EndHeight

EndHeight is the current end height (which anti-snipe may have extended).

Reserve

Reserve is the auction's reserve price (0 if none).

Status

Status is the auction's status string.

Seller

IsOpen

IsOpen reports whether the auction is open and still before its end.

IsCloseable

IsCloseable reports whether Close would succeed right now.

BlocksLeft

BlocksLeft is how many blocks until the end (0 once ended).

HasAuction

AuctionsOf

Admin

PendingAdmin

FeeRecipient

FeeBps

NumAuctions

ClaimableOf

FeesAccrued

Liabilities

Locked

Held

Address

Height

minNextBid

minNextBid is the smallest acceptable bid: the first-bid floor when no bid stands, else the high bid plus ceil(highBid·MinIncrementBps/10000). highBid is bounded by MaxBid, so the increment product cannot overflow.

mustAuction

assertNoSend

counter

ceilDiv

ceilDiv returns ceil(a/b) for b>0; a assumed non-negative.

addChecked

padID

itoa

boolStr

hasPrefix

Render

renderHome

renderAuction

highBidderStr