docs: expand priority updates section (conditional inclusion, best practices, routing against propAMMs) - #100
Conversation
…actices, routing against propAMMs)
|
Someone is attempting to deploy a commit to the Flashbots Team on Vercel. A member of the Team first needs to authorize it. |
| * **Top-of-Block:** to land at the **top of the next block** | ||
| * **Conditional:** to land only on the condition that another transaction reading the update is also included in the same block. Conditional updates are not guaranteed to be at the top of the block. This is an experimental gas savings feature subject to change. | ||
| * **Top-of-Block:** the update lands at the top of the next block, unconditionally. The maker pays gas every block the update lands. | ||
| * **Conditional:** the update lands only if a transaction consuming it is also included in the same block. Conditional updates are not guaranteed to be at the top of the block. The maker pays gas only on fills. This is an experimental gas savings feature subject to change. |
There was a problem hiding this comment.
I think it's not experimental but the main way to use it
There was a problem hiding this comment.
Fixed in 1a8a0c0: conditional listed first as the main way to use priority updates; the experimental line is replaced with a general note that the implementation is new and behaviour may change.
|
|
||
| A taker transaction that touches priority-update state is only eligible for inclusion once the builder has held it for at least 50 ms. This protects makers from takers attempting to snipe stale quotes. | ||
|
|
||
| #### How conditional inclusion works <!-- omit in toc --> |
There was a problem hiding this comment.
We don't use slots to decide if we want to do final inclusion. We only use event since doing this reverting call stack is redundant
There was a problem hiding this comment.
Fixed in 1a8a0c0: consumption is now described as event-only; the slot-read condition is removed.
…mplementation subject to change
2 participants
What
Rewrites the Priority updates section of the API reference (propAMM-related content only; nothing else on the page is touched):
Confirm before merge
🤖 Generated with Claude Code