Notice to `relay.flashbots.net` users: JSON-RPC Compatible Errors Coming January 9, 2025

We are going to upgrade relay.flashbots.net to JSON-RPC compatible errors on January 9th, 2025.

Context

Due to historic reasons, the Flashbots bundle-relay (relay.flashbots.net) returns errors in a non-standard way.

Sometimes errors are returned like this:

{
	"error": "example error"
}

Under rare circumstances, errors are returned like this:

{
  "code": -32603,
  "message": "example error"
}

The proper way to respond with error (according to JSON-RPC spec) is:

{
	"jsonrpc":"2.0",
	"id": 123,
	"error": {
		"code": -32603, 
		"message": "example error"
	}
}

Impact

Depending on the implementation in Flashbots relay clients, errors will be returned in a different format, as regular JSON-RPC errors would be.

Most tooling won’t need any update because JSON-RPC compatible errors are already handled. It might only impact any Flashbots-specific error handling logic, and we recommend client developers to double-check the code, and update if needed.

2 Likes

Fwuw, the github.com/metachris/flashbotsrpc Golang package is already compatible to these changes, no further actions needed for projects using that.

1 Like