Add how to use timeboost

[TucksonDev]

This PR adds a guide on "How to use timeboost".

TODO:

• Add how to withdraw funds
• Find a place for it in the sidebar
• Merge Timeboost gentle intro #1749

Preview

[vercel]

The latest updates on your projects. Learn more about Vercel for Git ↗︎

Name	Status	Preview	Updated (UTC)
arbitrum-docs	✅ Ready (Inspect)	Visit Preview	Jan 10, 2025 11:13am

[CLAassistant]

All committers have signed the CLA.

[pete-vielhaber]

Suggested change

	Auctions are held in an auction contract, and bids are submitted to an autonomous auctioneer, that also communicates with the contract. Let's take a look at the process of submitting bids and finding out the winner of an auction.
	Auctions are in an auction contract, and bids get submitted to an autonomous auctioneer who communicates with the contract. Let's look at the process of submitting bids and finding out the winner of an auction.

[TucksonDev]

I kept held here. It seems to me that the sentence is not completed by just saying "Auctions are in an auction contract".

[pete-vielhaber]

Suggested change

	Before bidding on an auction, we need to deposit funds in the auction contract. These funds are deposited in the form of the ERC-20 token used to bid, also known as, the `bidding token`. We will be able to bid for an amount that is equal to or less than the tokens we have deposited in the auction contract.
	Before bidding on an auction, we need to deposit funds in the auction contract. These deposited funds are the ERC-20 token used to bid, also known as the `bidding token`. We will be able to bid for an amount that is equal to or less than the tokens we have deposited in the auction contract.

[TucksonDev]

I'd like to be a bit more explicit with what I'm referring to with "funds", since it can mean different things. I've kept the sentence as it was, but happy to change it to something that keeps my intention

[pete-vielhaber]

Suggested change

	After the auction closes, and before the round starts, the autonomous auctioneer will call the auction contract with the two highest bids received, so the contract can declare the winner and subtract the second-highest bid from the winner's deposited funds. After this, the contract will emit an event with the new express lane controller address.
	After the auction closes, and before the round starts the autonomous auctioneer will call the auction contract with the two highest bids received so the contract can declare the winner and subtract the second-highest bid from the winner's deposited funds. After this, the contract will emit an event with the new express lane controller address.

[TucksonDev]

Why not keeping the first comma? I don't know the right term in english, but that bit seems to be a clarification of what I'm trying to explain, which is usually surrounded by commas.

Or maybe the intention was to remove the one after closes? (that might sound better now that I look at it). I'll remove that one and we can discuss further changes.

[pete-vielhaber]

Suggested change

	Notice that, while the express lane controller needs to sign the `timeboost_sendExpressLaneTransaction` request, the actual transaction to be executed can be signed by any party. In other words, the express lane controller can receive transactions signed by other parties and sign them to apply the time advantage offered by the express lane to those transactions.
	Notice that while the express lane controller must sign the `timeboost_sendExpressLaneTransaction` request, any party can sign the transaction to execute it. In other words, the express lane controller can receive transactions signed by other parties and sign them to apply the time advantage offered by the express lane to those transactions.

[TucksonDev]

The second bit of the correction might lead to some misconceptions, so I prefer to be a bit more clear with it. For context, what's happening here is that the express lane controller (ELC) will sign and send the request to the sequencer, but within that request there's a transaction signed by whoever wishes their transaction to be sent through the express lane (might be the ELC or a third party). That signer must collaborate with the ELC though, since the ELC is the one sending the transaction to the sequencer.

I'm not completely happy with my description either, but the correction might lead to thinking that anyone (regardless of them collaborating with the ELC) can sign the transaction.

I'll keep the original text (with your first correction), but happy to hear other alternatives:

Notice that while the express lane controller must sign the timeboost_sendExpressLaneTransaction request, the actual transaction to be executed can be signed by any party. In other words, the express lane controller can receive transactions signed by other parties and sign them to apply the time advantage offered by the express lane to those transactions.

[pete-vielhaber]

Minor changes throughout for readability.