# Auction Mechanism

{% hint style="warning" %}
**Limited Developer Support**

All assets represented in this library are community built, which means limited support from the Agoric OpCo development team. Please use components, APIs, and front-ends with caution.  
{% endhint %}

## **Summary**

This is a smart contract for a modified version of the Baseball Card Store Dapp which uses a first-price auction mechanism. The auction for any individual card starts at the moment the first bid is offered and lasts for a fixed amount of time. At the end of the auction, the highest bidder should win the card and pay the amount of their bid (i.e., first price auction).

## **Details**

This version of the Baseball Card Store features a new user purchase flow:

1. User navigates to dapp-card-store UI
2. User connects wallet
3. User selects a card to purchase
4. User is prompted with information about the card selected
5. User is shown the current bid (if any) for the card, the amount of time remaining on the auction (if applicable), and the history of bids and timestamps for the card
6. If no auction is already in progress, user is notified that an auction will begin at the moment they place a bid and the duration of the auction
7. User may make a bid for the card in IST by selecting the correct purse and providing an amount
8. User is given a visual confirmation of their bid starting or updating the auction
9. At the completion of the auction, winning bidder receives the card in exchange for the IST bid and all other bidders have IST returned

## Explore on GitHub

<https://github.com/Agoric/dapp-card-store/pull/40>

{% hint style="info" %}
Built by [Agoric](https://github.com/Agoric)
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://components.agoric.com/smart-contracts/nfts/auction-mechanism.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.