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

**URL:** https://collective.flashbots.net/t/notice-to-relay-flashbots-net-users-json-rpc-compatible-errors-coming-january-9-2025/4233
**Category:** The Flashbots Ship
**Tags:** announcement, relay
**Created:** [December 12, 2024, 2:40pm UTC](https://collective.flashbots.net/t/notice-to-relay-flashbots-net-users-json-rpc-compatible-errors-coming-january-9-2025/4233 "2024-12-12T14:40:38Z")
**Posts on this page:** 2
**Page:** 1

<div class="post-metadata">

### Author: ![Tymur](https://collective.flashbots.net/letter_avatar_proxy/v4/letter/t/eb9ed0/32.png) [@Tymur](https://collective.flashbots.net/u/Tymur)
#### Post date: [December 12, 2024, 2:40pm UTC](https://collective.flashbots.net/t/notice-to-relay-flashbots-net-users-json-rpc-compatible-errors-coming-january-9-2025/4233/1 "2024-12-12T14:40:38Z")

</div>

**We are going to upgrade [`relay.flashbots.net`](http://relay.flashbots.net) to [JSON-RPC compatible errors](https://docs.trafficserver.apache.org/en/latest/developer-guide/jsonrpc/jsonrpc-node-errors.en.html) on January 9th, 2025.**

**Context**

Due to historic reasons, the Flashbots bundle-relay ([`relay.flashbots.net`](http://relay.flashbots.net)) returns errors in a non-standard way.

Sometimes errors are returned like this:

```json
{
	"error": "example error"
}

```

Under rare circumstances, errors are returned like this:

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

```

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

```json
{
	"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.

---

<div class="post-metadata">

### Author: ![metachris](https://collective.flashbots.net/user_avatar/collective.flashbots.net/metachris/32/6_2.png) [@metachris](https://collective.flashbots.net/u/metachris)
#### Post date: [December 12, 2024, 6:40pm UTC](https://collective.flashbots.net/t/notice-to-relay-flashbots-net-users-json-rpc-compatible-errors-coming-january-9-2025/4233/3 "2024-12-12T18:40:57Z")

</div>

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