Search Apps Documentation Source Content File Folder Download Copy Actions Download State String Boolean Number Struct Map Slice Pointer Function Closure Reference Nil Package Type Interface Unknown

v0 source realm

Package englishauction is an idiomatic gno.land port of the classic Solidity English (ascending-bid) auction. Anyone ...

Readme View source

English Auction

⚠️ Experimental — generated with no human supervision by the daily MCP pipeline (Solidity→Gno port). Not audited. See r/moul/x/daily.


An idiomatic gno.land port of the classic Solidity English (ascending-bid) auction. It ports the core mechanics — a seller opens an auction, bidders submit strictly increasing bids, the displaced top bid becomes refundable, and after a block deadline anyone can settle it — into a single realm that hosts many concurrent auctions.

Solidity's msg.sender maps to unsafe.PreviousRealm().Address(), block.number to runtime.ChainHeight(), require to panic, and events to chain.Emit. There is no real coin transfer: bid amounts and refunds are tracked as plain uint64 accounting in ordered avl.Trees (mirroring Solidity's pendingReturns withdraw pattern). Auctions and pending refunds are keyed so Render can iterate deterministically.

Transactions

  • Start(cur, item string, durationBlocks int64) int64 — open an auction (caller becomes the seller); ends at ChainHeight() + durationBlocks. Returns the id.
  • Bid(cur, id int64, amount uint64) — bid; must strictly exceed the current highest. The prior top bid becomes refundable.
  • Withdraw(cur, id int64) uint64 — reclaim your displaced bids for an auction.
  • End(cur, id int64) — after the deadline, award the item to the top bidder.

Example calls

# open a 100-block auction for a painting -> returns id 1
Start("Vintage painting", 100)

# two bidders compete (amounts are accounting units, not real coins)
Bid(1, 500)     # alice
Bid(1, 750)     # bob outbids -> alice's 500 is now refundable
Withdraw(1)     # alice reclaims 500

# once ChainHeight() >= endHeight, anyone settles it
End(1)          # item awarded to bob at 750

Visit the realm to see the live table of auctions: item, highest bid + bidder, blocks remaining or ended, and the winner.


Part of moul/gno-contracts — moul's versioned gno.land contracts. See the repository for the full catalog, build/test tooling, and usage.

Dependency graph:

gno.land/r/moul/x/daily/englishauction/v0 dependency graph

🧪 Highly experimental — potentially vibe-coded. Not audited; may break, change, or be removed at any time. Do not use with anything of value. Full disclaimer: DISCLAIMER.

Overview

Package englishauction is an idiomatic gno.land port of the classic Solidity English (ascending-bid) auction. Anyone can Start an auction for a named item with a duration in blocks; bidders call Bid with a strictly increasing amount. The previous highest bid becomes refundable (claim it with Withdraw). After the auction's end height anyone may call End, awarding the item to the highest bidder. Auctions and pending refunds live in ordered avl trees so Render can iterate deterministically.

Functions 5

func Bid

crossing Action
1func Bid(cur realm, id int64, amount uint64)
source

Bid places a bid of `amount` on auction `id`. It must strictly exceed the current highest bid. The displaced highest bid becomes refundable to its bidder via Withdraw.

func End

crossing Action
1func End(cur realm, id int64)
source

End closes auction `id` once its end height is reached, awarding the item to the highest bidder (if any). Anyone may call it.

func Render

1func Render(path string) string
source

Render lists every auction with item, top bid + bidder, time left, and winner.

func Start

crossing Action
1func Start(cur realm, item string, durationBlocks int64) int64
source

Start opens a new auction for `item` running for `durationBlocks` blocks from the current height. The caller becomes the seller. Returns the auction id.

func Withdraw

crossing Action
1func Withdraw(cur realm, id int64) uint64
source

Withdraw refunds the caller's accumulated displaced bids for auction `id`. Returns the amount refunded (0 if nothing pending).

Types 1

type Auction

struct
1type Auction struct {
2	ID            int64
3	Seller        address
4	Item          string
5	EndHeight     int64
6	HighestBid    uint64
7	HighestBidder address
8	Ended         bool
9}
source

Auction is a single ascending-bid auction.

Imports 5

Source Files 3