Skip to content

docs: tw571-bid-behavior #2883

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
pete-vielhaber merged 3 commits into from
Nov 19, 2025
Merged

docs: tw571-bid-behavior #2883

Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
f7f898e
tw571
pete-vielhaber Nov 19, 2025
573ed9b
Update docs/how-arbitrum-works/timeboost/gentle-introduction.mdx
pete-vielhaber Nov 19, 2025
e193aae
Merge branch 'master' into tw571
pete-vielhaber Nov 19, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 6 additions & 2 deletions docs/how-arbitrum-works/timeboost/gentle-introduction.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -82,6 +82,12 @@ Determining control of the express lane in each round (default: 60 seconds) happ

The auction for a round has a closing time that is `auctionClosingSeconds` (default: 15) seconds before the beginning of the round. This closing time means that, in the default parameters, parties have 45 seconds to submit bids before the auction will no longer accept bids. In the 15 seconds between when bidding is over and when the new round begins, the autonomous auctioneer will verify all bids, determine the winner, and make a call to the on-chain auction contract to formally resolve the auction.

:::info Bid behavior

The autonomous auctioneer will consider only an address’s most recent bid, meaning that if you have placed a bid and wish to change it, you may resubmit a bid to “update it.” To cancel a bid, place a new bid that is significantly lower than your original bid or bid below the minimum reserve price. Remember that there is a maximum of five bids per round per address to mitigate DDoS risks.

:::

### Auction contract

Before placing a bid in the auction, a party must deposit funds into the `Auction` Contract. At any time, you can make a deposit or add additional funds to an existing deposit. These deposits are fully withdrawable, with a nominal delay (two rounds or two minutes by default), to prevent impacting the outcome of an existing round. There is no minimum deposit amount, but a starting minimum bid of 0.001 `WETH` (the default amount and token) is required, known as the "minimum reserve price".
Expand All @@ -90,8 +96,6 @@ The chain owner sets the minimum reserve price, which can be updated at any time

Once the autonomous auctioneer determines an auction winner, the `Auction` contract will deduct the second-highest bid amount from the account of the highest bidder and transfer those funds to a `beneficiary` account designated by the chain owner by default. The `expressLaneControllerAddress` specified in the highest bid will become the express lane controller for the round.

|

## FAQs

#### Who is Timeboost for, and how do I use it?
Expand Down