From 543b055bc78076f18910ca55cb8e9674c22479d1 Mon Sep 17 00:00:00 2001 From: Shea Ketsdever Date: Fri, 11 Apr 2025 17:56:30 -0400 Subject: [PATCH] Blocks API is deprecated --- .../advanced/bundle-pricing.md | 2 +- .../advanced/troubleshooting.mdx | 10 +++---- docs/flashbots-data/blockapi.md | 26 ------------------- .../additional-documentation/bundle-cache.md | 7 +---- docs/sidebars.js | 1 - 5 files changed, 5 insertions(+), 41 deletions(-) delete mode 100644 docs/flashbots-data/blockapi.md diff --git a/docs/flashbots-auction/advanced/bundle-pricing.md b/docs/flashbots-auction/advanced/bundle-pricing.md index be7503865..e6d2ba8cc 100644 --- a/docs/flashbots-auction/advanced/bundle-pricing.md +++ b/docs/flashbots-auction/advanced/bundle-pricing.md @@ -33,4 +33,4 @@ The Flashbots builder employs a new algorithm aimed at maximizing block profitab There could be two potential reasons why your bundles are not being included. The first reason to consider is that the gas price of your bundles might not be higher than that at the tail end of a block. It's recommended to analyze the gas price your bundles are offering by initially simulating the bundles and observing the difference in the coinbase and the gas consumed. If this value is found to be lower than the tail end of recent blocks, it would be necessary to increase your gas price accordingly. -Alternatively, your bundles may not be included due to competition with other searchers targeting the same opportunities. These competitors might be offering a higher gas price than you. To address this, first simulate your bundles to check the gas price they are offering. Log the amount you are paying for a specific opportunity in a specific block. If your bundle is still not included, refer to the [blocks API](https://blocks.flashbots.net/) to identify the bundle that was included in your target block and the gas price they offered. +Alternatively, your bundles may not be included due to competition with other searchers targeting the same opportunities. These competitors might be offering a higher gas price than you. To address this, first simulate your bundles to check the gas price they are offering. Log the amount you are paying for a specific opportunity in a specific block. diff --git a/docs/flashbots-auction/advanced/troubleshooting.mdx b/docs/flashbots-auction/advanced/troubleshooting.mdx index e05bc350c..ddfcb94dc 100644 --- a/docs/flashbots-auction/advanced/troubleshooting.mdx +++ b/docs/flashbots-auction/advanced/troubleshooting.mdx @@ -90,9 +90,9 @@ Covers: 3. Competitors paying more ``` -[Flashbots bundles adhere to a "blind" auction](/flashbots-auction/overview), where bundle pricing is not released by Flashbots prior to landing on-chain. The winning "bids" are revealed _only_ after the block containing winning bundles is propagated (via the transactions themselves and [blocks-api](https://blocks.flashbots.net/) for recognizing which set of transactions belong to a bundle). +[Flashbots bundles adhere to a "blind" auction](/flashbots-auction/overview), where bundle pricing is not released by Flashbots prior to landing on-chain. The winning "bids" are revealed _only_ after the block containing winning bundles is propagated. -While you cannot see a competitor's bid in real time, it is possible to look AFTER the fact to: +While you cannot see a competitor's bid in real time, it is possible to look onchain AFTER the fact to: 1. Identify the exact bundle (if any) that conflicted with yours 2. Compare the conflicting bundle's `effective priority fee` with your own (to see if you should be bidding more to remain competitive) @@ -256,11 +256,7 @@ Analyze the timestamps above in relation to when you observe the targeted block mev-boost is an opt-in system that runs alongside a validator's consensus client. Unless every validator on Ethereum runs mev-boost, some slots cannot be targeted with Flashbots. Additionally, your builder must be connected to the same relay as the proposer for the target slot. -If no bundles are detected in the blocks-api response, check if other blocks from the same validator ever have Flashbots bundles. If no blocks from a particular validator contain Flashbots bundles, it is possible your bundle was not seen by the validator who proposed the block for the target block height. - -## New Blocks API fields - -New fields have been added to the blocks API to align the API with PoS Ethereum nomenclature. Details can be found in the [Blocks API page](/flashbots-data/blockapi). +If no blocks from a particular validator contain Flashbots bundles, it is possible your bundle was not seen by the validator who proposed the block for the target block height. ## Everything checks out, what's next? diff --git a/docs/flashbots-data/blockapi.md b/docs/flashbots-data/blockapi.md deleted file mode 100644 index a1b7dbeab..000000000 --- a/docs/flashbots-data/blockapi.md +++ /dev/null @@ -1,26 +0,0 @@ ---- -title: MEV-Blocks API ---- -mev-blocks is a a public API for displaying flashbots blocks and transactions. - -Access it here: [blocks.flashbots.net](https://blocks.flashbots.net/) - -## New Blocks API fields - -For the PoS Ethereum merge, we added new fields to the Blocks API response to align the API with PoS Ethereum nomenclature. - -Old fields were left in place for backwards compatibility with clients, and have been retrofitted to populate with data from the Flashbots builder. - -| Parent Type | Old Name | New Name | -| --- | --- | --- | -| _`blocks`_ | `miner` | `fee_recipient` | -| _`blocks`_ | `miner_reward` | `fee_recipient_eth_diff` | -| _`blocks`_ | `coinbase_transfers` | `eth_sent_to_fee_recipient` | -| _`transactions`_ | `total_miner_reward` | `fee_recipient_eth_diff` | -| _`transactions`_ | `coinbase_transfer` | `eth_sent_to_fee_recipient` | - -:::note - -Old names will be removed in a future release. - -::: diff --git a/docs/flashbots-protect/additional-documentation/bundle-cache.md b/docs/flashbots-protect/additional-documentation/bundle-cache.md index 1f62499ad..c1bd5c1a0 100644 --- a/docs/flashbots-protect/additional-documentation/bundle-cache.md +++ b/docs/flashbots-protect/additional-documentation/bundle-cache.md @@ -1,10 +1,5 @@ - - - - - --- -title: bundle cache API +title: Bundle Cache API --- To create a bundle iteratively (e.g. by signing & sending transactions one at a time with Metamask), you can use the bundle cache API to cache signed transactions and retrieve them with a bundle ID. diff --git a/docs/sidebars.js b/docs/sidebars.js index 67786b0b6..3a7fba647 100644 --- a/docs/sidebars.js +++ b/docs/sidebars.js @@ -198,6 +198,5 @@ module.exports = { "flashbots-auction/advanced/rpc-endpoint", "flashbots-protect/additional-documentation/status-api", "flashbots-protect/additional-documentation/bundle-cache", - "flashbots-data/blockapi", ] };