diff --git a/docs/flashbots-auction/advanced/bundle-cancellations.mdx b/docs/flashbots-auction/advanced/bundle-cancellations.mdx index 2345706b..23716e65 100644 --- a/docs/flashbots-auction/advanced/bundle-cancellations.mdx +++ b/docs/flashbots-auction/advanced/bundle-cancellations.mdx @@ -24,6 +24,7 @@ Bundles can be replaced and canceled using a unique identifier (`replacementUuid maxTimestamp, revertingTxHashes, replacementUuid, // UUIDv4 to uniquely identify submission + builders, } ] } @@ -36,6 +37,7 @@ To replace a bundle, send the new bundle via `eth_sendBundle` with the same `rep ### Canceling bundles Canceling a bundle will prevent Flashbots builders from including it on-chain. To cancel a bundle, call the [`eth_cancelBundle`](/flashbots-auction/advanced/rpc-endpoint#eth_cancelbundle) endpoint, or use the `cancelBundle` function in your preferred [Flashbots library](/flashbots-auction/libraries/bundle-relay). +It is important to use the same set of builders as the original bundle submission to achieve a successful cancellation. ```json { @@ -45,6 +47,7 @@ Canceling a bundle will prevent Flashbots builders from including it on-chain. T "params": [ { replacementUuid, // UUIDv4 to uniquely identify submission + builders, } ] } diff --git a/docs/flashbots-mev-share/searchers/understanding-bundles.mdx b/docs/flashbots-mev-share/searchers/understanding-bundles.mdx index 74469ab8..59e2db54 100644 --- a/docs/flashbots-mev-share/searchers/understanding-bundles.mdx +++ b/docs/flashbots-mev-share/searchers/understanding-bundles.mdx @@ -37,9 +37,16 @@ MEV-Share bundles can share hints with searchers, which can be used to backrun t Searchers can share hints to give other searchers information about their bundle that would allow them to be backrun. If your bundle gets backrun by another searcher, you get paid a cut of the MEV they extract! +## Revert mode +Revert mode field is optional, if set - it is preferred over `canRevert` field. Revert mode `allow` corresponds to `canRevert: true`, `fail` corresponds to `canRevert: false`. +Revert mode `drop` is preferred in most scenarios, since it allows for your tx to be dropped if it can't be included in the block, which is used to merge multiple backruns for the same bundle. + ## Builders MEV-Share bundles can be sent to multiple builders at once. This is done by setting the `builders` field in the `privacy` parameter of `mev_sendBundle`. +### Replacement uuid +If `replacementUuid` is set, only builders that support cancellations will be processed. You can check list of builders [here](https://github.com/flashbots/dowg/blob/main/builder-registrations.json) + ## Bundle composition (backrunning other bundles) With the `privacy` parameter in `mev_sendBundle` you can share select information about your bundle with other searchers, who can then use that to try to extract MEV. Should they succeed, you get paid some of the MEV they extracted! diff --git a/docs/specs/mev-share/_mev_sendBundle.mdx b/docs/specs/mev-share/_mev_sendBundle.mdx index 335f599f..59384490 100644 --- a/docs/specs/mev-share/_mev_sendBundle.mdx +++ b/docs/specs/mev-share/_mev_sendBundle.mdx @@ -13,13 +13,14 @@ method: "mev_sendBundle", params: [{ /* MevSendBundleParams */ version: "v0.1", + replacementUuid?: string, inclusion: { block: string, // hex-encoded number maxBlock?: string, // hex-encoded number }, body: Array< { hash: string } | - { tx: string, canRevert: boolean } | + { tx: string, canRevert: boolean, revertMode?: "allow" | "drop" | "fail" } | { bundle: MevSendBundleParams } >, validity?: {