eth_notifyRawTransaction

Notify nexroute of a single user-signed transaction that you dispatch yourself. nexroute acknowledges synchronously with the deterministic transaction hash, evaluates the transaction for backrun opportunity, and optimistically races a backrun targeting inclusion directly behind it. nexroute does not dispatch the notified transaction; delivery remains with the partner. The notification is fire-and-forget by design: send it in parallel with your own dispatch and never block on the response.

Request

POST to your Cashback endpoint with a JSON-RPC 2.0 envelope.

Params

params is a single-element array containing the request object.

Field	Type	Required	Description
`tx`	`string`	yes	Hex-encoded raw signed transaction (`0x`-prefixed).

Example

curl -X POST https://your-cashback-endpoint \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "eth_notifyRawTransaction",
    "params": [{ "tx": "0x02f8..." }]
  }'

const response = await fetch('https://your-cashback-endpoint', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    jsonrpc: '2.0',
    id: 1,
    method: 'eth_notifyRawTransaction',
    params: [{ tx: '0x02f8...' }],
  }),
});

const data = await response.json();
console.log(data.result); // 0x... tx hash

Response

A JSON-RPC envelope echoing the request id. result is the 32-byte transaction hash. It confirms the notification was accepted for backrun analysis; it carries no delivery commitment.

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0x6b6f1c8f5d2c4a9d3e1f8b7c6a5d4e3f2c1b0a9d8e7f6a5b4c3d2e1f0a9b8c7d"
}

Errors

Code	Cause
`-32601`	Method not supported on this endpoint
`-32000`	Malformed transaction (RLP decode failure, invalid signature)
`-32603`	Internal error (rare; the notification is dropped and your transaction is unaffected)

Getting started

Dispatch mode

Async mode

Embedded mode

API reference

eth_notifyRawTransaction

Request

Params

Example

Response

Errors

​Request

​Params

​Example

​Response

​Errors

Request

Params

Example

Response

Errors